openapi: 3.1.0
info:
title: Mist API
description: >-
> Version: **2607.1.1**
>
> Date: **August 17, 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/)
---
contact:
name: Thomas Munzer
email: tmunzer@juniper.net
version: '2607.1.1'
jsonSchemaDialect: https://json-schema.org/draft/2020-12/schema
servers:
- url: https://api.mist.com
variables: {}
- url: https://api.gc1.mist.com
variables: {}
- url: https://api.ac2.mist.com
variables: {}
- url: https://api.gc2.mist.com
variables: {}
- url: https://api.gc4.mist.com
variables: {}
- url: https://api.eu.mist.com
variables: {}
- url: https://api.gc3.mist.com
variables: {}
- url: https://api.ac6.mist.com
variables: {}
- url: https://api.gc6.mist.com
variables: {}
- url: https://api.ac5.mist.com
variables: {}
- url: https://api.gc5.mist.com
variables: {}
- url: https://api.gc7.mist.com
variables: {}
paths:
/api/v1/invite/verify/{token}:
post:
tags:
- Admins
summary: verifyAdminInvite
description: Accept an administrator invite using the invite verification token from the invite email. This public endpoint does not require authentication. After a successful verification, call [Get Self]($e/Self%20Account/getSelf) to refresh the authenticated admin profile and retrieve the newly granted privileges.
operationId: verifyAdminInvite
parameters:
- name: token
in: path
description: ''
required: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not Found
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_detail_string'
- description: Response containing a human-readable detail message
examples:
- '{"detail":"invalid secret"}'
- '{"detail":"invite created by self"}'
contentMediaType: application/json
examples:
Invalid Secret:
value:
detail: invalid secret
Invite Created By Self:
value:
detail: invite created by self
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_detail_string'
- description: Response containing a human-readable detail message
examples:
- '{"detail":"invalid secret"}'
- '{"detail":"invite created by self"}'
contentMediaType: application/vnd.api+json
examples:
Invalid Secret:
value:
detail: invalid secret
Invite Created By Self:
value:
detail: invite created by self
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
security: []
parameters: []
/api/v1/register:
post:
tags:
- Admins
summary: registerNewAdmin
description: >-
Register a new administrator account and initial organization. This public endpoint does not require authentication. Mist sends a verification email containing a link such as `/verify/register?token={token}`; use [Verify Registration]($e/Admins/verifyRegistration) to complete registration with that token.
Use [Get Registration Information]($e/Admins/getAdminRegistrationInfo) before submitting this request to determine whether CAPTCHA is required, which CAPTCHA provider to render, and which public site key to use. If CAPTCHA is required, include the provider response token in `recaptcha` and the provider name in `recaptcha_flavor`.
operationId: registerNewAdmin
parameters: []
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/admin_invite'
- description: Request Body
examples:
- account_only: false
allow_mist: false
city: Cupertino
country: United States
email: test@mistsys.com
first_name: John
invite_code: MISTROCKS
last_name: Smith
org_name: Smith LLC
password: foryoureyesonly
recaptcha: string
recaptcha_flavor: hcaptcha
referer_invite_token: Dm2gtT8dwMeM4Bc2E8FLIaA96VHOjPat
return_to: https://mist.zendesk.com/hc/quickstart.pdf
state: California
street_address: 1601 S De Anza Blvd Ste 248
street_address 2: 1601 S De Anza Blvd Ste 248
zipcode: '95014'
contentMediaType: application/json
examples:
Example:
value:
account_only: false
allow_mist: false
city: Cupertino
country: United States
email: test@mistsys.com
first_name: John
invite_code: MISTROCKS
last_name: Smith
org_name: Smith LLC
password: foryoureyesonly
recaptcha: string
recaptcha_flavor: hcaptcha
referer_invite_token: Dm2gtT8dwMeM4Bc2E8FLIaA96VHOjPat
return_to: https://mist.zendesk.com/hc/quickstart.pdf
state: California
street_address: 1601 S De Anza Blvd Ste 248
street_address 2: 1601 S De Anza Blvd Ste 248
zipcode: '95014'
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
security: []
parameters: []
/api/v1/register/recaptcha:
get:
tags:
- Admins
summary: getAdminRegistrationInfo
description: Return the public CAPTCHA settings required for administrator registration. This public endpoint does not require authentication. Use the returned `flavor`, `required`, and `sitekey` values to render the correct CAPTCHA challenge before calling [Register New Admin]($e/Admins/registerNewAdmin).
operationId: getAdminRegistrationInfo
parameters:
- name: recaptcha_flavor
in: query
description: 'Filter login settings by reCAPTCHA flavor. enum: `google`, `hcaptcha`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/recaptcha_flavor'
- description: 'Filter login settings by reCAPTCHA flavor. enum: `google`, `hcaptcha`'
examples:
- hcaptcha
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/recaptcha'
- description: CAPTCHA settings returned for admin registration
examples:
- '{"flavor":"google","required":true,"sitekey":"6LdAewsTAAAAAE25XKQhPEQ2FiMTft-WrZXQ5NUd"}'
- '{"flavor":"hcaptcha","required":true,"sitekey":"6LdAewsTAAAAAE25XKQhPEQ2FiMTft-WrZXQ5NUd"}'
contentMediaType: application/json
examples:
Google:
value:
flavor: google
required: true
sitekey: '6LdAewsTAAAAAE25XKQhPEQ2FiMTft-WrZXQ5NUd'
Hcaptcha:
value:
flavor: hcaptcha
required: true
sitekey: '6LdAewsTAAAAAE25XKQhPEQ2FiMTft-WrZXQ5NUd'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/recaptcha'
- description: CAPTCHA settings returned for admin registration
examples:
- '{"flavor":"google","required":true,"sitekey":"6LdAewsTAAAAAE25XKQhPEQ2FiMTft-WrZXQ5NUd"}'
- '{"flavor":"hcaptcha","required":true,"sitekey":"6LdAewsTAAAAAE25XKQhPEQ2FiMTft-WrZXQ5NUd"}'
contentMediaType: application/vnd.api+json
examples:
Google:
value:
flavor: google
required: true
sitekey: '6LdAewsTAAAAAE25XKQhPEQ2FiMTft-WrZXQ5NUd'
Hcaptcha:
value:
flavor: hcaptcha
required: true
sitekey: '6LdAewsTAAAAAE25XKQhPEQ2FiMTft-WrZXQ5NUd'
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
security: []
parameters: []
/api/v1/register/verify/{token}:
post:
tags:
- Admins
summary: verifyRegistration
description: Verify a new administrator registration using the token from the registration email. This public endpoint does not require authentication. A successful verification creates a login session and may also apply a pending invitation; the response indicates whether an invitation could not be applied automatically.
operationId: verifyRegistration
parameters:
- name: token
in: path
description: ''
required: true
schema:
type: string
responses:
'200':
description: OK
headers:
Set-Cookie:
content:
text/plain:
schema:
type: string
examples:
- csrftoken=vwvBuq9qkqaKh7lu8tNc0gkvBfEaLAmx; expires=Tue, 15-Mar-2016 19:47:20 GMT; Max-Age=31449600; Path=/
contentMediaType: text/plain
example: csrftoken=vwvBuq9qkqaKh7lu8tNc0gkvBfEaLAmx; expires=Tue, 15-Mar-2016 19:47:20 GMT; Max-Age=31449600; Path=/
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_verify_token_success'
- description: Successful registration token verification response
examples:
- '{"return_to":"https://mist.zendesk.com/hc/quickstart.pdf"}'
- '{"detail":"password policy not met","invite_not_applied":true,"min_length":8}'
contentMediaType: application/json
examples:
Success:
value:
return_to: https://mist.zendesk.com/hc/quickstart.pdf
success-but-failed-to-apply_the-invitation-automatically:
value:
detail: password policy not met
invite_not_applied: true
min_length: 8
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_verify_token_success'
- description: Successful registration token verification response
examples:
- '{"return_to":"https://mist.zendesk.com/hc/quickstart.pdf"}'
- '{"detail":"password policy not met","invite_not_applied":true,"min_length":8}'
contentMediaType: application/vnd.api+json
examples:
Success:
value:
return_to: https://mist.zendesk.com/hc/quickstart.pdf
success-but-failed-to-apply_the-invitation-automatically:
value:
detail: password policy not met
invite_not_applied: true
min_length: 8
'400':
description: Response if verification expired or already registered
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_detail_string'
- description: Response containing a human-readable detail message
examples:
- '{"detail":"already registered"}'
- '{"detail":"expired"}'
contentMediaType: application/json
examples:
Already Registered:
value:
detail: already registered
Verification Expired:
value:
detail: expired
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_detail_string'
- description: Response containing a human-readable detail message
examples:
- '{"detail":"already registered"}'
- '{"detail":"expired"}'
contentMediaType: application/vnd.api+json
examples:
Already Registered:
value:
detail: already registered
Verification Expired:
value:
detail: expired
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Response if secret is invalid
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_detail_string'
- description: Response containing a human-readable detail message
examples:
- detail: Not found.
contentMediaType: application/json
examples:
Not Found:
value:
detail: Not found.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_detail_string'
- description: Response containing a human-readable detail message
examples:
- detail: Not found.
contentMediaType: application/vnd.api+json
examples:
Not Found:
value:
detail: Not found.
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
security: []
parameters: []
/api/v1/login:
post:
tags:
- Admins Login
summary: login
description: >-
Authenticate an administrator with email and password. A successful login creates the browser session cookies, including the `csrftoken` value used with the `X-CSRFToken` header on later API requests.
When 2FA is enabled, either include the `two_factor` code in this request or submit the first factor here and complete the login with [Two Factor]($e/Admins%20Login/twoFactor).
operationId: login
parameters: []
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/login'
- examples:
- '{"email":"test@mistsys.com","password":"foryoureyesonly","two_factor":"123456"}'
- '{"email":"test@mistsys.com","password":"foryoureyesonly"}'
contentMediaType: application/json
examples:
with-2FA:
value:
email: test@mistsys.com
password: foryoureyesonly
two_factor: '123456'
without-2FA:
value:
email: test@mistsys.com
password: foryoureyesonly
required: false
responses:
'200':
description: Login Success
headers:
Set-Cookie:
description: Session Cookie if login/password authentication is successful
content:
text/plain:
schema:
type: string
description: Session Cookie if login/password authentication is successful
examples:
- csrftoken=vwvBuq9qkqaKh7lu8tNc0gkvBfEaLAmx; expires=Tue, 15-Mar-2016 19:47:20 GMT; Max-Age=31449600; Path=/
contentMediaType: text/plain
example: csrftoken=vwvBuq9qkqaKh7lu8tNc0gkvBfEaLAmx; expires=Tue, 15-Mar-2016 19:47:20 GMT; Max-Age=31449600; Path=/
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_login_success'
- description: Login response body, empty on normal success or populated with two-factor state
examples:
- '{"email":"test@mistsys.com","two_factor_passed":false,"two_factor_required":true}'
- '{}'
contentMediaType: application/json
examples:
2FA-required:
value:
email: test@mistsys.com
two_factor_passed: false
two_factor_required: true
OK:
value: {}
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_login_success'
- description: Login response body, empty on normal success or populated with two-factor state
examples:
- '{"email":"test@mistsys.com","two_factor_passed":false,"two_factor_required":true}'
- '{}'
contentMediaType: application/vnd.api+json
examples:
2FA-required:
value:
email: test@mistsys.com
two_factor_passed: false
two_factor_required: true
OK:
value: {}
'400':
description: Login Failed
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_login_failure'
- description: Login failure response returned when authentication cannot continue locally
examples:
- detail: sso admin login needs to be initiated by IdP
forward_url: https://my.sso/idp_sso_url
contentMediaType: application/json
examples:
Example:
value:
detail: sso admin login needs to be initiated by IdP
forward_url: https://my.sso/idp_sso_url
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_login_failure'
- description: Login failure response returned when authentication cannot continue locally
examples:
- detail: sso admin login needs to be initiated by IdP
forward_url: https://my.sso/idp_sso_url
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: sso admin login needs to be initiated by IdP
forward_url: https://my.sso/idp_sso_url
deprecated: false
security: []
parameters: []
/api/v1/login/two_factor:
post:
tags:
- Admins Login
summary: twoFactor
description: Complete a two-factor login by submitting the 2FA code after the initial email/password step has created a pending login session.
operationId: twoFactor
parameters: []
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/two_factor_string'
- examples:
- two_factor: '123456'
contentMediaType: application/json
examples:
Example:
value:
two_factor: '123456'
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: two_factor code is incorrect or the user hasn't login yet
headers: {}
content: {}
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: The user doesn't have 2FA enabled
headers: {}
content: {}
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
security: []
parameters: []
/api/v1/logout:
post:
tags:
- Admins Logout
summary: logout
description: End the current authenticated administrator session and invalidate the related login cookies.
operationId: logout
parameters: []
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_logout'
- description: Logout response with optional SSO forwarding URL
examples:
- forward_url: https://my.sso/custom_logout_url
contentMediaType: application/json
examples:
Example:
value:
forward_url: https://my.sso/custom_logout_url
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_logout'
- description: Logout response with optional SSO forwarding URL
examples:
- forward_url: https://my.sso/custom_logout_url
contentMediaType: application/vnd.api+json
examples:
Example:
value:
forward_url: https://my.sso/custom_logout_url
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/recover:
post:
tags:
- Admins Recover Password
summary: recoverPassword
description: Start password recovery for an administrator account. This public endpoint does not require authentication. When the request is accepted, Mist sends an email containing a recovery link such as `https://manage.mist.com/verify/recover?token=:token`. If CAPTCHA is required, include the CAPTCHA response token and provider flavor in the request body.
operationId: recoverPassword
parameters: []
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/recover'
- examples:
- email: test@mistsys.com
recaptcha: string
recaptcha_flavor: hcaptcha
contentMediaType: application/json
examples:
Example:
value:
email: test@mistsys.com
recaptcha: string
recaptcha_flavor: hcaptcha
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
security: []
parameters: []
/api/v1/recover/verify/{token}:
post:
tags:
- Admins Recover Password
summary: verifyRecoverPassword
description: Verify a password recovery token from the recovery email. This public endpoint does not require authentication. When the token is valid, the user is authenticated for the recovery flow so the client can prompt for and submit a new password.
operationId: verifyRecoverPassword
parameters:
- name: token
in: path
description: ''
required: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
security: []
parameters: []
/api/v1/login/lookup:
post:
tags:
- Admins Lookup
summary: lookup
description: Check the login method for an administrator email address. This public lookup is mainly used by UI clients to determine whether the user should continue with local login or be redirected to SSO.
operationId: lookup
parameters: []
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/email_string'
- description: Request Body
examples:
- email: test@mistsys.com
contentMediaType: application/json
examples:
Example:
value:
email: test@mistsys.com
required: false
responses:
'200':
description: Account exists
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_login_lookup'
- description: Login lookup response indicating whether SSO is available for the account
examples:
- '{"sso_url":"https://my.sso/idp_sso_url"}'
- '{}'
contentMediaType: application/json
examples:
SSO_user_exists:
value:
sso_url: https://my.sso/idp_sso_url
local_user_exists:
value: {}
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_login_lookup'
- description: Login lookup response indicating whether SSO is available for the account
examples:
- '{"sso_url":"https://my.sso/idp_sso_url"}'
- '{}'
contentMediaType: application/vnd.api+json
examples:
SSO_user_exists:
value:
sso_url: https://my.sso/idp_sso_url
local_user_exists:
value: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: User does not exist
headers: {}
content: {}
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
security: []
parameters: []
/api/v1/login/oauth/{provider}:
delete:
tags:
- Admins Login - OAuth2
summary: unlinkOauth2Provider
description: Unlink the specified OAuth2 provider from the authenticated administrator account so it can no longer be used for that account's OAuth login.
operationId: unlinkOauth2Provider
parameters:
- name: provider
in: path
description: Oauth2 provider name
required: true
schema:
type: string
examples:
- google
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Admins Login - OAuth2
summary: getOauth2AuthorizationUrlForLogin
description: Return the provider authorization URL used to start an OAuth2 login or account-linking flow. When `forward` is provided, the provider redirects back to that callback URL after authorization.
operationId: getOauth2AuthorizationUrlForLogin
parameters:
- name: provider
in: path
description: Oauth2 provider name
required: true
schema:
type: string
examples:
- google
- name: forward
in: query
description: Callback URL used after completing the OAuth login flow
style: form
explode: true
schema:
type: string
examples:
- https://manage.mist.com/oauth/callback.html
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_login_oauth_url'
- description: OAuth2 authorization URL response for login
examples:
- authorization_url: https://accounts.google.com/o/oauth2/v2/auth?.....
client_id: 173131512-mpbnju32.apps.googleusercontent.com
contentMediaType: application/json
examples:
Example:
value:
authorization_url: https://accounts.google.com/o/oauth2/v2/auth?.....
client_id: 173131512-mpbnju32.apps.googleusercontent.com
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_login_oauth_url'
- description: OAuth2 authorization URL response for login
examples:
- authorization_url: https://accounts.google.com/o/oauth2/v2/auth?.....
client_id: 173131512-mpbnju32.apps.googleusercontent.com
contentMediaType: application/vnd.api+json
examples:
Example:
value:
authorization_url: https://accounts.google.com/o/oauth2/v2/auth?.....
client_id: 173131512-mpbnju32.apps.googleusercontent.com
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
security: []
post:
tags:
- Admins Login - OAuth2
summary: loginOauth2
description: Complete an OAuth2 login by exchanging the provider authorization code for a Mist administrator session.
operationId: loginOauth2
parameters:
- name: provider
in: path
description: Oauth2 provider name
required: true
schema:
type: string
examples:
- google
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/code_string'
- description: Request Body
examples:
- code: 4/S9tegDeLkrYg0L9pWNXV4cgMVbbr3SR9t693A2kSHzw
contentMediaType: application/json
examples:
Example:
value:
code: 4/S9tegDeLkrYg0L9pWNXV4cgMVbbr3SR9t693A2kSHzw
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
security: []
parameters: []
/api/v1/installer/orgs/{org_id}/alarmtemplates:
get:
tags:
- Installer
summary: listInstallerAlarmTemplates
description: Return alarm templates available to installer workflows in the organization.
operationId: listInstallerAlarmTemplates
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: Installer List of Alarm Templates
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/installers_item'
description: Installer access entries returned by list responses
examples:
- - id: 684dfc5c-fe77-2290-eb1d-ef3d677fe168
name: AlarmTemplate 1
contentMediaType: application/json
examples:
Example:
value:
- id: 684dfc5c-fe77-2290-eb1d-ef3d677fe168
name: AlarmTemplate 1
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/installers_item'
description: Installer access entries returned by list responses
examples:
- - id: 684dfc5c-fe77-2290-eb1d-ef3d677fe168
name: AlarmTemplate 1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- id: 684dfc5c-fe77-2290-eb1d-ef3d677fe168
name: AlarmTemplate 1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/installer/orgs/{org_id}/deviceprofiles:
get:
tags:
- Installer
summary: listInstallerDeviceProfiles
description: Return device profiles that installers can use when provisioning recently claimed devices, optionally filtered by device type.
operationId: listInstallerDeviceProfiles
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: type
in: query
description: 'Filter results by type. enum: `ap`, `gateway`, `switch`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/device_type_default_ap'
- description: 'Filter results by type. enum: `ap`, `gateway`, `switch`'
responses:
'200':
description: Installer List of Device Profiles
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/installers_item'
description: Installer access entries returned by list responses
examples:
- - id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
name: DeviceProfile 1
contentMediaType: application/json
examples:
Example:
value:
- id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
name: DeviceProfile 1
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/installers_item'
description: Installer access entries returned by list responses
examples:
- - id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
name: DeviceProfile 1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
name: DeviceProfile 1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/installer/orgs/{org_id}/devices:
get:
tags:
- Installer
summary: listInstallerListOfRecentlyClaimedDevices
description: Return recently claimed devices visible to installer workflows, with optional filters for model, site name, or site identifier.
operationId: listInstallerListOfRecentlyClaimedDevices
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: model
in: query
description: Filter results by device model
style: form
explode: true
schema:
type: string
examples:
- AP43
- name: site_name
in: query
description: Filter results by site name
style: form
explode: true
schema:
type: string
examples:
- SJ1
- name: site_id
in: query
description: Filter results by site identifier
style: form
explode: true
schema:
type: string
contentEncoding: uuid
examples:
- 72771e6a-6f5e-4de4-a5b9-1266c4197811
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: List of Devices Recently Claimed
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/installer_device'
description: Recently claimed devices available to installer workflows
examples:
- - connected: true
deviceprofile_name: SJ1
height: 2.7
mac: 5c5b35000018
map_id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
model: AP41
name: hallway
orientation: 90
serial: FXLH2015150025
site_name: SJ1
x: 150
y: 300
contentMediaType: application/json
examples:
Example:
value:
- connected: true
deviceprofile_name: SJ1
height: 2.7
mac: 5c5b35000018
map_id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
model: AP41
name: hallway
orientation: 90
serial: FXLH2015150025
site_name: SJ1
x: 150
y: 300
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/installer_device'
description: Recently claimed devices available to installer workflows
examples:
- - connected: true
deviceprofile_name: SJ1
height: 2.7
mac: 5c5b35000018
map_id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
model: AP41
name: hallway
orientation: 90
serial: FXLH2015150025
site_name: SJ1
x: 150
y: 300
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- connected: true
deviceprofile_name: SJ1
height: 2.7
mac: 5c5b35000018
map_id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
model: AP41
name: hallway
orientation: 90
serial: FXLH2015150025
site_name: SJ1
x: 150
y: 300
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Installer
summary: claimInstallerDevices
description: Claim devices into the organization inventory by activation code through the installer workflow.
operationId: claimInstallerDevices
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
uniqueItems: true
type: array
items:
type: string
description: Request Body
examples:
- - 6JG8E-PTFV2-A9Z2N
- DVH4V-SNMSZ-PDXBR
contentMediaType: application/json
examples:
Example:
value:
- 6JG8E-PTFV2-A9Z2N
- DVH4V-SNMSZ-PDXBR
required: false
responses:
'200':
description: OK - if any of entries are valid or there’s no errors
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_inventory'
- description: Result of adding device claim codes to organization inventory
examples:
- added:
- 6JG8E-PTFV2-A9Z2N
duplicated:
- DVH4V-SNMSZ-PDXBR
error:
- PO1025335ohoh
inventory_added:
- mac: 5c5b35000018
magic: 6JG8EPTFV2A9Z2N
model: AP41
serial: FXLH2015150025
type: ap
inventory_duplicated:
- mac: 5c5b35000012
magic: DVH4VSNMSZPDXBR
model: AP41
serial: FXLH2015150027
type: ap
reason:
- belongs to another org ('e2f543f7-d6e1-409f-a565-e77a1f098d3b' (other) != '0de5d6fc-219a-414d-a840-67d6b919ad8f' (you))
contentMediaType: application/json
examples:
Example:
value:
added:
- 6JG8E-PTFV2-A9Z2N
duplicated:
- DVH4V-SNMSZ-PDXBR
error:
- PO1025335ohoh
inventory_added:
- mac: 5c5b35000018
magic: 6JG8EPTFV2A9Z2N
model: AP41
serial: FXLH2015150025
type: ap
inventory_duplicated:
- mac: 5c5b35000012
magic: DVH4VSNMSZPDXBR
model: AP41
serial: FXLH2015150027
type: ap
reason:
- belongs to another org ('e2f543f7-d6e1-409f-a565-e77a1f098d3b' (other) != '0de5d6fc-219a-414d-a840-67d6b919ad8f' (you))
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_inventory'
- description: Result of adding device claim codes to organization inventory
examples:
- added:
- 6JG8E-PTFV2-A9Z2N
duplicated:
- DVH4V-SNMSZ-PDXBR
error:
- PO1025335ohoh
inventory_added:
- mac: 5c5b35000018
magic: 6JG8EPTFV2A9Z2N
model: AP41
serial: FXLH2015150025
type: ap
inventory_duplicated:
- mac: 5c5b35000012
magic: DVH4VSNMSZPDXBR
model: AP41
serial: FXLH2015150027
type: ap
reason:
- belongs to another org ('e2f543f7-d6e1-409f-a565-e77a1f098d3b' (other) != '0de5d6fc-219a-414d-a840-67d6b919ad8f' (you))
contentMediaType: application/vnd.api+json
examples:
Example:
value:
added:
- 6JG8E-PTFV2-A9Z2N
duplicated:
- DVH4V-SNMSZ-PDXBR
error:
- PO1025335ohoh
inventory_added:
- mac: 5c5b35000018
magic: 6JG8EPTFV2A9Z2N
model: AP41
serial: FXLH2015150025
type: ap
inventory_duplicated:
- mac: 5c5b35000012
magic: DVH4VSNMSZPDXBR
model: AP41
serial: FXLH2015150027
type: ap
reason:
- belongs to another org ('e2f543f7-d6e1-409f-a565-e77a1f098d3b' (other) != '0de5d6fc-219a-414d-a840-67d6b919ad8f' (you))
'400':
description: OK - if any of entries are valid or there’s no errors
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_inventory'
- description: Result of adding device claim codes to organization inventory
examples:
- added:
- 6JG8E-PTFV2-A9Z2N
duplicated:
- DVH4V-SNMSZ-PDXBR
error:
- PO1025335ohoh
inventory_added:
- mac: 5c5b35000018
magic: 6JG8EPTFV2A9Z2N
model: AP41
serial: FXLH2015150025
type: ap
inventory_duplicated:
- mac: 5c5b35000012
magic: DVH4VSNMSZPDXBR
model: AP41
serial: FXLH2015150027
type: ap
reason:
- belongs to another org ('e2f543f7-d6e1-409f-a565-e77a1f098d3b' (other) != '0de5d6fc-219a-414d-a840-67d6b919ad8f' (you))
contentMediaType: application/json
examples:
Example:
value:
added:
- 6JG8E-PTFV2-A9Z2N
duplicated:
- DVH4V-SNMSZ-PDXBR
error:
- PO1025335ohoh
inventory_added:
- mac: 5c5b35000018
magic: 6JG8EPTFV2A9Z2N
model: AP41
serial: FXLH2015150025
type: ap
inventory_duplicated:
- mac: 5c5b35000012
magic: DVH4VSNMSZPDXBR
model: AP41
serial: FXLH2015150027
type: ap
reason:
- belongs to another org ('e2f543f7-d6e1-409f-a565-e77a1f098d3b' (other) != '0de5d6fc-219a-414d-a840-67d6b919ad8f' (you))
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_inventory'
- description: Result of adding device claim codes to organization inventory
examples:
- added:
- 6JG8E-PTFV2-A9Z2N
duplicated:
- DVH4V-SNMSZ-PDXBR
error:
- PO1025335ohoh
inventory_added:
- mac: 5c5b35000018
magic: 6JG8EPTFV2A9Z2N
model: AP41
serial: FXLH2015150025
type: ap
inventory_duplicated:
- mac: 5c5b35000012
magic: DVH4VSNMSZPDXBR
model: AP41
serial: FXLH2015150027
type: ap
reason:
- belongs to another org ('e2f543f7-d6e1-409f-a565-e77a1f098d3b' (other) != '0de5d6fc-219a-414d-a840-67d6b919ad8f' (you))
contentMediaType: application/vnd.api+json
examples:
Example:
value:
added:
- 6JG8E-PTFV2-A9Z2N
duplicated:
- DVH4V-SNMSZ-PDXBR
error:
- PO1025335ohoh
inventory_added:
- mac: 5c5b35000018
magic: 6JG8EPTFV2A9Z2N
model: AP41
serial: FXLH2015150025
type: ap
inventory_duplicated:
- mac: 5c5b35000012
magic: DVH4VSNMSZPDXBR
model: AP41
serial: FXLH2015150027
type: ap
reason:
- belongs to another org ('e2f543f7-d6e1-409f-a565-e77a1f098d3b' (other) != '0de5d6fc-219a-414d-a840-67d6b919ad8f' (you))
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/installer/orgs/{org_id}/devices/{device_mac}:
delete:
tags:
- Installer
summary: unassignInstallerRecentlyClaimedDevice
description: Unassign a recently claimed device from its current site so it can be provisioned again through the installer workflow.
operationId: unassignInstallerRecentlyClaimedDevice
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_mac
in: path
description: ''
required: true
schema:
pattern: ^[0-9a-fA-F]{12}$
type: string
examples:
- 0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Installer
summary: provisionInstallerDevices
description: "Provision or replace an installer-managed device. \n\nIf replacing_mac is in the request payload, other attributes are ignored, we attempt to replace existing device (with MAC address `replacing_mac`) with the inventory device being configured. The replacement device must be in the inventory but not assigned, and the replacing_mac device must be assigned to a site, and satisfy grace period requirements. The Device replaced will become unassigned."
operationId: provisionInstallerDevices
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_mac
in: path
description: ''
required: true
schema:
pattern: ^[0-9a-fA-F]{12}$
type: string
examples:
- 0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/installer_provision_device'
- description: Request Body
examples:
- deviceprofile_name: SJ1
height: 2.7
name: SJ1-AP1
orientation: 90
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
site_name: SJ1
x: 150
y: 300
contentMediaType: application/json
examples:
Example:
value:
deviceprofile_name: SJ1
height: 2.7
name: SJ1-AP1
orientation: 90
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
site_name: SJ1
x: 150
y: 300
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Request
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_detail_string'
- description: Response containing a human-readable detail message
examples:
- '{"detail":"invalid replacing_mac"}'
- '{"detail":"device already assigned"}'
- '{"detail":"outside of grace period"}'
- '{"detail":"replacing_mac device is unassigned"}'
- '{"detail":"replacing_mac device outside of grace period"}'
contentMediaType: application/json
examples:
Invalid Mac Given For Replacing Mac:
value:
detail: invalid replacing_mac
Inventory Device Is Already Assigned:
value:
detail: device already assigned
Outside Of Grace Period:
value:
detail: outside of grace period
Replacing Mac Device Is Not Assigned To A Site:
value:
detail: replacing_mac device is unassigned
Replacing Mac Device Last Modified Outside Of Grace Period:
value:
detail: replacing_mac device outside of grace period
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_detail_string'
- description: Response containing a human-readable detail message
examples:
- '{"detail":"invalid replacing_mac"}'
- '{"detail":"device already assigned"}'
- '{"detail":"outside of grace period"}'
- '{"detail":"replacing_mac device is unassigned"}'
- '{"detail":"replacing_mac device outside of grace period"}'
contentMediaType: application/vnd.api+json
examples:
Invalid Mac Given For Replacing Mac:
value:
detail: invalid replacing_mac
Inventory Device Is Already Assigned:
value:
detail: device already assigned
Outside Of Grace Period:
value:
detail: outside of grace period
Replacing Mac Device Is Not Assigned To A Site:
value:
detail: replacing_mac device is unassigned
Replacing Mac Device Last Modified Outside Of Grace Period:
value:
detail: replacing_mac device outside of grace period
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not Found
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_detail_string'
- description: Response containing a human-readable detail message
examples:
- '{"detail":"replacing_mac inventory not found"}'
- '{"detail":"replacing_mac device not found"}'
contentMediaType: application/json
examples:
Replacing Mac Device Is Not In Org Inventory:
value:
detail: replacing_mac inventory not found
Replacing Mac Device Not Found:
value:
detail: replacing_mac device not found
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_detail_string'
- description: Response containing a human-readable detail message
examples:
- '{"detail":"replacing_mac inventory not found"}'
- '{"detail":"replacing_mac device not found"}'
contentMediaType: application/vnd.api+json
examples:
Replacing Mac Device Is Not In Org Inventory:
value:
detail: replacing_mac inventory not found
Replacing Mac Device Not Found:
value:
detail: replacing_mac device not found
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/installer/orgs/{org_id}/devices/{device_mac}/locate:
post:
tags:
- Installer
summary: startInstallerLocateDevice
description: Start locating an installer-managed device by blinking its LED. The locate state persists until [Stop Locating Installer Device]($e/Installer/stopInstallerLocateDevice) is called.
operationId: startInstallerLocateDevice
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_mac
in: path
description: ''
required: true
schema:
pattern: ^[0-9a-fA-F]{12}$
type: string
examples:
- 0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/installer/orgs/{org_id}/devices/{device_mac}/unlocate:
post:
tags:
- Installer
summary: stopInstallerLocateDevice
description: Stop the locate LED state for an installer-managed device.
operationId: stopInstallerLocateDevice
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_mac
in: path
description: ''
required: true
schema:
pattern: ^[0-9a-fA-F]{12}$
type: string
examples:
- 0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/installer/orgs/{org_id}/devices/{device_mac}/{image_name}:
delete:
tags:
- Installer
summary: deleteInstallerDeviceImage
description: Remove a previously uploaded image associated with an installer-managed device, such as an installation photo or device placement image.
operationId: deleteInstallerDeviceImage
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: image_name
in: path
description: ''
required: true
schema:
type: string
- name: device_mac
in: path
description: ''
required: true
schema:
pattern: ^[0-9a-fA-F]{12}$
type: string
examples:
- 0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Installer
summary: addInstallerDeviceImage
description: Upload an image associated with an installer-managed device using `multipart/form-data`.
operationId: addInstallerDeviceImage
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: image_name
in: path
description: ''
required: true
schema:
type: string
- name: device_mac
in: path
description: ''
required: true
schema:
pattern: ^[0-9a-fA-F]{12}$
type: string
examples:
- 0000000000ab
requestBody:
content:
multipart/form-data:
encoding: {}
schema:
type: object
properties:
auto_deviceprofile_assignment:
type: boolean
description: Whether to auto assign device to deviceprofile by name
examples:
- true
csv:
type: string
description: Optional AP name-mapping CSV file
contentEncoding: base64
file:
type: string
description: Ekahau or iBwave floorplan file to import
contentEncoding: base64
json:
allOf:
- $ref: '#/components/schemas/map_import_json1'
- description: Import options for the site map file
contentMediaType: multipart/form-data
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/installer/orgs/{org_id}/devices/{fpc0_mac}/vc:
get:
tags:
- Installer
summary: getInstallerDeviceVirtualChassis
description: >-
Return Virtual Chassis status for an installer-managed switch, including topology and member statistics.
The response is a combined view of the Virtual Chassis state.
operationId: getInstallerDeviceVirtualChassis
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: fpc0_mac
in: path
description: FPC0 MAC address
required: true
schema:
type: string
examples:
- aff827549235
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_virtual_chassis_config'
- description: Combined virtual chassis status, topology, and member statistics
examples:
- config_type: nonprovisioned
id: 00000000-0000-0000-1000-52d9107af289
mac: 52d9107af289
members:
- boot_partition: junos
cpld_version: '6'
cpu_stat:
idle: 69
interrupt: 1
load_avg:
- 0.8
- 1.09
- 1.07
system: 11
user: 19
fans:
- airflow: out
name: Fan Tray 0 Fan 0
rpm: 0
status: ok
- airflow: out
name: Fan Tray 1 Fan 0
rpm: 0
status: ok
fpc_idx: 0
mac: 52d9107af289
memory_stat:
usage: 42
model: EX2300-48P
pics:
- index: 0
model_number: EX2300-48P
port_groups:
- count: 48
type: GE
- index: 1
model_number: EX2300-48P
port_groups:
- count: 4
type: SFP/SFP+
poe:
max_power: 750
power_draw: 40.4
status: AT_MODE
poe_version: 2.1.1.19.3 (type1)
psus:
- name: Power Supply 0
status: ok
recovery_version: 21.4R3-S4.18
serial: JW0000000000
temperatures:
- celsius: 33
name: CPU Sensor
status: ok
- celsius: 29
name: PSU Sensor
status: ok
type: fpc
uboot_version: U-Boot 2016.01-rc1 (Nov 11 2016 - 14:26:00 -0800) 1.3.2
uptime: 27636720
vc_links:
- neighbor_module_idx: 1
neighbor_port_id: vcp-1/1/0
port_id: vcp-0/1/0
vc_mode: HiGiG
vc_role: master
vc_state: present
version: 21.4R3-S4.18
- boot_partition: junos
cpld_version: '6'
cpu_stat:
idle: 76
interrupt: 0
load_avg:
- 0.96
- 0.87
- 0.76
system: 6
user: 17
fans:
- airflow: out
name: Fan Tray 0 Fan 0
rpm: 0
status: ok
- airflow: out
name: Fan Tray 1 Fan 0
rpm: 0
status: ok
fpc_idx: 1
mac: d0dd4991652d
memory_stat:
usage: 18
model: EX2300-48P
pics:
- index: 0
model_number: EX2300-48P
port_groups:
- count: 48
type: GE
- index: 1
model_number: EX2300-48P
port_groups:
- count: 4
type: SFP/SFP+
poe:
max_power: 750
power_draw: 21.2
status: AT_MODE
poe_version: 2.1.1.19.3 (type1)
psus:
- name: Power Supply 0
status: ok
recovery_version: 21.4R3-S4.18
serial: JW3619300922
temperatures:
- celsius: 32
name: CPU Sensor
status: ok
- celsius: 29
name: PSU Sensor
status: ok
type: fpc
uboot_version: U-Boot 2016.01-rc1 (Nov 11 2016 - 14:26:00 -0800) 1.3.2
uptime: 27636720
vc_links:
- neighbor_module_idx: 0
neighbor_port_id: vcp-0/1/0
port_id: vcp-1/1/0
vc_mode: HiGiG
vc_role: backup
vc_state: present
version: 21.4R3-S4.18
model: EX2300-48P
num_routing_engines: 1
org_id: 1e9a61a9-bc42-42ca-bf67-1ad87443d9b8
serial: JW3619300157
site_id: ab0aca7a-d45c-469b-b3bb-4fe240642d0b
status: connected
type: switch
vc_mac: 52d9107af289
contentMediaType: application/json
examples:
Example:
value:
config_type: nonprovisioned
id: 00000000-0000-0000-1000-52d9107af289
mac: 52d9107af289
members:
- boot_partition: junos
cpld_version: '6'
cpu_stat:
idle: 69
interrupt: 1
load_avg:
- 0.8
- 1.09
- 1.07
system: 11
user: 19
fans:
- airflow: out
name: Fan Tray 0 Fan 0
rpm: 0
status: ok
- airflow: out
name: Fan Tray 1 Fan 0
rpm: 0
status: ok
fpc_idx: 0
mac: 52d9107af289
memory_stat:
usage: 42
model: EX2300-48P
pics:
- index: 0
model_number: EX2300-48P
port_groups:
- count: 48
type: GE
- index: 1
model_number: EX2300-48P
port_groups:
- count: 4
type: SFP/SFP+
poe:
max_power: 750
power_draw: 40.4
status: AT_MODE
poe_version: 2.1.1.19.3 (type1)
psus:
- name: Power Supply 0
status: ok
recovery_version: 21.4R3-S4.18
serial: JW0000000000
temperatures:
- celsius: 33
name: CPU Sensor
status: ok
- celsius: 29
name: PSU Sensor
status: ok
type: fpc
uboot_version: U-Boot 2016.01-rc1 (Nov 11 2016 - 14:26:00 -0800) 1.3.2
uptime: 27636720
vc_links:
- neighbor_module_idx: 1
neighbor_port_id: vcp-1/1/0
port_id: vcp-0/1/0
vc_mode: HiGiG
vc_role: master
vc_state: present
version: 21.4R3-S4.18
- boot_partition: junos
cpld_version: '6'
cpu_stat:
idle: 76
interrupt: 0
load_avg:
- 0.96
- 0.87
- 0.76
system: 6
user: 17
fans:
- airflow: out
name: Fan Tray 0 Fan 0
rpm: 0
status: ok
- airflow: out
name: Fan Tray 1 Fan 0
rpm: 0
status: ok
fpc_idx: 1
mac: d0dd4991652d
memory_stat:
usage: 18
model: EX2300-48P
pics:
- index: 0
model_number: EX2300-48P
port_groups:
- count: 48
type: GE
- index: 1
model_number: EX2300-48P
port_groups:
- count: 4
type: SFP/SFP+
poe:
max_power: 750
power_draw: 21.2
status: AT_MODE
poe_version: 2.1.1.19.3 (type1)
psus:
- name: Power Supply 0
status: ok
recovery_version: 21.4R3-S4.18
serial: JW3619300922
temperatures:
- celsius: 32
name: CPU Sensor
status: ok
- celsius: 29
name: PSU Sensor
status: ok
type: fpc
uboot_version: U-Boot 2016.01-rc1 (Nov 11 2016 - 14:26:00 -0800) 1.3.2
uptime: 27636720
vc_links:
- neighbor_module_idx: 0
neighbor_port_id: vcp-0/1/0
port_id: vcp-1/1/0
vc_mode: HiGiG
vc_role: backup
vc_state: present
version: 21.4R3-S4.18
model: EX2300-48P
num_routing_engines: 1
org_id: 1e9a61a9-bc42-42ca-bf67-1ad87443d9b8
serial: JW3619300157
site_id: ab0aca7a-d45c-469b-b3bb-4fe240642d0b
status: connected
type: switch
vc_mac: 52d9107af289
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_virtual_chassis_config'
- description: Combined virtual chassis status, topology, and member statistics
examples:
- config_type: nonprovisioned
id: 00000000-0000-0000-1000-52d9107af289
mac: 52d9107af289
members:
- boot_partition: junos
cpld_version: '6'
cpu_stat:
idle: 69
interrupt: 1
load_avg:
- 0.8
- 1.09
- 1.07
system: 11
user: 19
fans:
- airflow: out
name: Fan Tray 0 Fan 0
rpm: 0
status: ok
- airflow: out
name: Fan Tray 1 Fan 0
rpm: 0
status: ok
fpc_idx: 0
mac: 52d9107af289
memory_stat:
usage: 42
model: EX2300-48P
pics:
- index: 0
model_number: EX2300-48P
port_groups:
- count: 48
type: GE
- index: 1
model_number: EX2300-48P
port_groups:
- count: 4
type: SFP/SFP+
poe:
max_power: 750
power_draw: 40.4
status: AT_MODE
poe_version: 2.1.1.19.3 (type1)
psus:
- name: Power Supply 0
status: ok
recovery_version: 21.4R3-S4.18
serial: JW0000000000
temperatures:
- celsius: 33
name: CPU Sensor
status: ok
- celsius: 29
name: PSU Sensor
status: ok
type: fpc
uboot_version: U-Boot 2016.01-rc1 (Nov 11 2016 - 14:26:00 -0800) 1.3.2
uptime: 27636720
vc_links:
- neighbor_module_idx: 1
neighbor_port_id: vcp-1/1/0
port_id: vcp-0/1/0
vc_mode: HiGiG
vc_role: master
vc_state: present
version: 21.4R3-S4.18
- boot_partition: junos
cpld_version: '6'
cpu_stat:
idle: 76
interrupt: 0
load_avg:
- 0.96
- 0.87
- 0.76
system: 6
user: 17
fans:
- airflow: out
name: Fan Tray 0 Fan 0
rpm: 0
status: ok
- airflow: out
name: Fan Tray 1 Fan 0
rpm: 0
status: ok
fpc_idx: 1
mac: d0dd4991652d
memory_stat:
usage: 18
model: EX2300-48P
pics:
- index: 0
model_number: EX2300-48P
port_groups:
- count: 48
type: GE
- index: 1
model_number: EX2300-48P
port_groups:
- count: 4
type: SFP/SFP+
poe:
max_power: 750
power_draw: 21.2
status: AT_MODE
poe_version: 2.1.1.19.3 (type1)
psus:
- name: Power Supply 0
status: ok
recovery_version: 21.4R3-S4.18
serial: JW3619300922
temperatures:
- celsius: 32
name: CPU Sensor
status: ok
- celsius: 29
name: PSU Sensor
status: ok
type: fpc
uboot_version: U-Boot 2016.01-rc1 (Nov 11 2016 - 14:26:00 -0800) 1.3.2
uptime: 27636720
vc_links:
- neighbor_module_idx: 0
neighbor_port_id: vcp-0/1/0
port_id: vcp-1/1/0
vc_mode: HiGiG
vc_role: backup
vc_state: present
version: 21.4R3-S4.18
model: EX2300-48P
num_routing_engines: 1
org_id: 1e9a61a9-bc42-42ca-bf67-1ad87443d9b8
serial: JW3619300157
site_id: ab0aca7a-d45c-469b-b3bb-4fe240642d0b
status: connected
type: switch
vc_mac: 52d9107af289
contentMediaType: application/vnd.api+json
examples:
Example:
value:
config_type: nonprovisioned
id: 00000000-0000-0000-1000-52d9107af289
mac: 52d9107af289
members:
- boot_partition: junos
cpld_version: '6'
cpu_stat:
idle: 69
interrupt: 1
load_avg:
- 0.8
- 1.09
- 1.07
system: 11
user: 19
fans:
- airflow: out
name: Fan Tray 0 Fan 0
rpm: 0
status: ok
- airflow: out
name: Fan Tray 1 Fan 0
rpm: 0
status: ok
fpc_idx: 0
mac: 52d9107af289
memory_stat:
usage: 42
model: EX2300-48P
pics:
- index: 0
model_number: EX2300-48P
port_groups:
- count: 48
type: GE
- index: 1
model_number: EX2300-48P
port_groups:
- count: 4
type: SFP/SFP+
poe:
max_power: 750
power_draw: 40.4
status: AT_MODE
poe_version: 2.1.1.19.3 (type1)
psus:
- name: Power Supply 0
status: ok
recovery_version: 21.4R3-S4.18
serial: JW0000000000
temperatures:
- celsius: 33
name: CPU Sensor
status: ok
- celsius: 29
name: PSU Sensor
status: ok
type: fpc
uboot_version: U-Boot 2016.01-rc1 (Nov 11 2016 - 14:26:00 -0800) 1.3.2
uptime: 27636720
vc_links:
- neighbor_module_idx: 1
neighbor_port_id: vcp-1/1/0
port_id: vcp-0/1/0
vc_mode: HiGiG
vc_role: master
vc_state: present
version: 21.4R3-S4.18
- boot_partition: junos
cpld_version: '6'
cpu_stat:
idle: 76
interrupt: 0
load_avg:
- 0.96
- 0.87
- 0.76
system: 6
user: 17
fans:
- airflow: out
name: Fan Tray 0 Fan 0
rpm: 0
status: ok
- airflow: out
name: Fan Tray 1 Fan 0
rpm: 0
status: ok
fpc_idx: 1
mac: d0dd4991652d
memory_stat:
usage: 18
model: EX2300-48P
pics:
- index: 0
model_number: EX2300-48P
port_groups:
- count: 48
type: GE
- index: 1
model_number: EX2300-48P
port_groups:
- count: 4
type: SFP/SFP+
poe:
max_power: 750
power_draw: 21.2
status: AT_MODE
poe_version: 2.1.1.19.3 (type1)
psus:
- name: Power Supply 0
status: ok
recovery_version: 21.4R3-S4.18
serial: JW3619300922
temperatures:
- celsius: 32
name: CPU Sensor
status: ok
- celsius: 29
name: PSU Sensor
status: ok
type: fpc
uboot_version: U-Boot 2016.01-rc1 (Nov 11 2016 - 14:26:00 -0800) 1.3.2
uptime: 27636720
vc_links:
- neighbor_module_idx: 0
neighbor_port_id: vcp-0/1/0
port_id: vcp-1/1/0
vc_mode: HiGiG
vc_role: backup
vc_state: present
version: 21.4R3-S4.18
model: EX2300-48P
num_routing_engines: 1
org_id: 1e9a61a9-bc42-42ca-bf67-1ad87443d9b8
serial: JW3619300157
site_id: ab0aca7a-d45c-469b-b3bb-4fe240642d0b
status: connected
type: switch
vc_mac: 52d9107af289
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Installer
summary: createInstallerVirtualChassis
description: >-
For models (e.g. EX3400 and up) having dedicated VC ports, it is easier to form a VC by just connecting cables with the dedicated VC ports. Cloud will detect the new VC and update the inventory.
In case that the user would like to choose the dedicated switch as a VC master or for EX2300-C-12P and EX2300-C-12T which doesn't have dedicated VC ports, below are procedures to automate the VC creation:
1. Power on the switch that is chosen as the VC master first. And then powering on the other member switches.
2. Claim or adopt all these switches under the same organization’s Inventory
3. Assign these switches into the same Site
4. Invoke vc command on the switch chosen to be the VC master. For EX2300-C-12P, VC ports will be created automatically.
5. Connect the cables to the VC ports for these switches
6. Wait for the VC to be formed. The Org’s inventory will be updated for the new VC.
operationId: createInstallerVirtualChassis
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: fpc0_mac
in: path
description: FPC0 MAC address
required: true
schema:
type: string
examples:
- aff827549235
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/virtual_chassis_config'
- description: Request Body
examples:
- '{"members":[{"mac":"aff827549235","vc_ports":["xe-0/1/0","xe-0/1/1"],"vc_role":"master"},{"mac":"8396cd006c8c","vc_ports":["xe-0/1/0","xe-0/1/1"],"vc_role":"backup"},{"mac":"8396cd00888c","vc_ports":["xe-0/1/0","xe-0/1/1"],"vc_role":"linecard"}]}'
- '{"members":[{"mac":"aff827549235","member_id":0,"vc_ports":["xe-0/1/0","xe-0/1/1"],"vc_role":"master"},{"mac":"8396cd006c8c","member_id":1,"vc_ports":["xe-0/1/0","xe-0/1/1"],"vc_role":"linecard"},{"mac":"8396cd00888c","member_id":2,"vc_ports":["xe-0/1/0","xe-0/1/1"],"vc_role":"backup"}],"preprovisioned":true}'
contentMediaType: application/json
examples:
create-a-VC-with-three-members:
value:
members:
- mac: aff827549235
vc_ports:
- xe-0/1/0
- xe-0/1/1
vc_role: master
- mac: 8396cd006c8c
vc_ports:
- xe-0/1/0
- xe-0/1/1
vc_role: backup
- mac: 8396cd00888c
vc_ports:
- xe-0/1/0
- xe-0/1/1
vc_role: linecard
create-a-pre-provisioned-VC-with-three-members:
value:
members:
- mac: aff827549235
member_id: 0
vc_ports:
- xe-0/1/0
- xe-0/1/1
vc_role: master
- mac: 8396cd006c8c
member_id: 1
vc_ports:
- xe-0/1/0
- xe-0/1/1
vc_role: linecard
- mac: 8396cd00888c
member_id: 2
vc_ports:
- xe-0/1/0
- xe-0/1/1
vc_role: backup
preprovisioned: true
required: false
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_virtual_chassis_config'
- description: Combined virtual chassis status, topology, and member statistics
examples:
- config_type: nonprovisioned
id: 00000000-0000-0000-1000-52d9107af289
mac: 52d9107af289
members:
- boot_partition: junos
cpld_version: '6'
cpu_stat:
idle: 69
interrupt: 1
load_avg:
- 0.8
- 1.09
- 1.07
system: 11
user: 19
fans:
- airflow: out
name: Fan Tray 0 Fan 0
rpm: 0
status: ok
- airflow: out
name: Fan Tray 1 Fan 0
rpm: 0
status: ok
fpc_idx: 0
mac: 52d9107af289
memory_stat:
usage: 42
model: EX2300-48P
pics:
- index: 0
model_number: EX2300-48P
port_groups:
- count: 48
type: GE
- index: 1
model_number: EX2300-48P
port_groups:
- count: 4
type: SFP/SFP+
poe:
max_power: 750
power_draw: 40.4
status: AT_MODE
poe_version: 2.1.1.19.3 (type1)
psus:
- name: Power Supply 0
status: ok
recovery_version: 21.4R3-S4.18
serial: JW0000000000
temperatures:
- celsius: 33
name: CPU Sensor
status: ok
- celsius: 29
name: PSU Sensor
status: ok
type: fpc
uboot_version: U-Boot 2016.01-rc1 (Nov 11 2016 - 14:26:00 -0800) 1.3.2
uptime: 27636720
vc_links:
- neighbor_module_idx: 1
neighbor_port_id: vcp-1/1/0
port_id: vcp-0/1/0
vc_mode: HiGiG
vc_role: master
vc_state: present
version: 21.4R3-S4.18
- boot_partition: junos
cpld_version: '6'
cpu_stat:
idle: 76
interrupt: 0
load_avg:
- 0.96
- 0.87
- 0.76
system: 6
user: 17
fans:
- airflow: out
name: Fan Tray 0 Fan 0
rpm: 0
status: ok
- airflow: out
name: Fan Tray 1 Fan 0
rpm: 0
status: ok
fpc_idx: 1
mac: d0dd4991652d
memory_stat:
usage: 18
model: EX2300-48P
pics:
- index: 0
model_number: EX2300-48P
port_groups:
- count: 48
type: GE
- index: 1
model_number: EX2300-48P
port_groups:
- count: 4
type: SFP/SFP+
poe:
max_power: 750
power_draw: 21.2
status: AT_MODE
poe_version: 2.1.1.19.3 (type1)
psus:
- name: Power Supply 0
status: ok
recovery_version: 21.4R3-S4.18
serial: JW3619300922
temperatures:
- celsius: 32
name: CPU Sensor
status: ok
- celsius: 29
name: PSU Sensor
status: ok
type: fpc
uboot_version: U-Boot 2016.01-rc1 (Nov 11 2016 - 14:26:00 -0800) 1.3.2
uptime: 27636720
vc_links:
- neighbor_module_idx: 0
neighbor_port_id: vcp-0/1/0
port_id: vcp-1/1/0
vc_mode: HiGiG
vc_role: backup
vc_state: present
version: 21.4R3-S4.18
model: EX2300-48P
num_routing_engines: 1
org_id: 1e9a61a9-bc42-42ca-bf67-1ad87443d9b8
serial: JW3619300157
site_id: ab0aca7a-d45c-469b-b3bb-4fe240642d0b
status: connected
type: switch
vc_mac: 52d9107af289
contentMediaType: application/json
examples:
Example:
value:
config_type: nonprovisioned
id: 00000000-0000-0000-1000-52d9107af289
mac: 52d9107af289
members:
- boot_partition: junos
cpld_version: '6'
cpu_stat:
idle: 69
interrupt: 1
load_avg:
- 0.8
- 1.09
- 1.07
system: 11
user: 19
fans:
- airflow: out
name: Fan Tray 0 Fan 0
rpm: 0
status: ok
- airflow: out
name: Fan Tray 1 Fan 0
rpm: 0
status: ok
fpc_idx: 0
mac: 52d9107af289
memory_stat:
usage: 42
model: EX2300-48P
pics:
- index: 0
model_number: EX2300-48P
port_groups:
- count: 48
type: GE
- index: 1
model_number: EX2300-48P
port_groups:
- count: 4
type: SFP/SFP+
poe:
max_power: 750
power_draw: 40.4
status: AT_MODE
poe_version: 2.1.1.19.3 (type1)
psus:
- name: Power Supply 0
status: ok
recovery_version: 21.4R3-S4.18
serial: JW0000000000
temperatures:
- celsius: 33
name: CPU Sensor
status: ok
- celsius: 29
name: PSU Sensor
status: ok
type: fpc
uboot_version: U-Boot 2016.01-rc1 (Nov 11 2016 - 14:26:00 -0800) 1.3.2
uptime: 27636720
vc_links:
- neighbor_module_idx: 1
neighbor_port_id: vcp-1/1/0
port_id: vcp-0/1/0
vc_mode: HiGiG
vc_role: master
vc_state: present
version: 21.4R3-S4.18
- boot_partition: junos
cpld_version: '6'
cpu_stat:
idle: 76
interrupt: 0
load_avg:
- 0.96
- 0.87
- 0.76
system: 6
user: 17
fans:
- airflow: out
name: Fan Tray 0 Fan 0
rpm: 0
status: ok
- airflow: out
name: Fan Tray 1 Fan 0
rpm: 0
status: ok
fpc_idx: 1
mac: d0dd4991652d
memory_stat:
usage: 18
model: EX2300-48P
pics:
- index: 0
model_number: EX2300-48P
port_groups:
- count: 48
type: GE
- index: 1
model_number: EX2300-48P
port_groups:
- count: 4
type: SFP/SFP+
poe:
max_power: 750
power_draw: 21.2
status: AT_MODE
poe_version: 2.1.1.19.3 (type1)
psus:
- name: Power Supply 0
status: ok
recovery_version: 21.4R3-S4.18
serial: JW3619300922
temperatures:
- celsius: 32
name: CPU Sensor
status: ok
- celsius: 29
name: PSU Sensor
status: ok
type: fpc
uboot_version: U-Boot 2016.01-rc1 (Nov 11 2016 - 14:26:00 -0800) 1.3.2
uptime: 27636720
vc_links:
- neighbor_module_idx: 0
neighbor_port_id: vcp-0/1/0
port_id: vcp-1/1/0
vc_mode: HiGiG
vc_role: backup
vc_state: present
version: 21.4R3-S4.18
model: EX2300-48P
num_routing_engines: 1
org_id: 1e9a61a9-bc42-42ca-bf67-1ad87443d9b8
serial: JW3619300157
site_id: ab0aca7a-d45c-469b-b3bb-4fe240642d0b
status: connected
type: switch
vc_mac: 52d9107af289
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_virtual_chassis_config'
- description: Combined virtual chassis status, topology, and member statistics
examples:
- config_type: nonprovisioned
id: 00000000-0000-0000-1000-52d9107af289
mac: 52d9107af289
members:
- boot_partition: junos
cpld_version: '6'
cpu_stat:
idle: 69
interrupt: 1
load_avg:
- 0.8
- 1.09
- 1.07
system: 11
user: 19
fans:
- airflow: out
name: Fan Tray 0 Fan 0
rpm: 0
status: ok
- airflow: out
name: Fan Tray 1 Fan 0
rpm: 0
status: ok
fpc_idx: 0
mac: 52d9107af289
memory_stat:
usage: 42
model: EX2300-48P
pics:
- index: 0
model_number: EX2300-48P
port_groups:
- count: 48
type: GE
- index: 1
model_number: EX2300-48P
port_groups:
- count: 4
type: SFP/SFP+
poe:
max_power: 750
power_draw: 40.4
status: AT_MODE
poe_version: 2.1.1.19.3 (type1)
psus:
- name: Power Supply 0
status: ok
recovery_version: 21.4R3-S4.18
serial: JW0000000000
temperatures:
- celsius: 33
name: CPU Sensor
status: ok
- celsius: 29
name: PSU Sensor
status: ok
type: fpc
uboot_version: U-Boot 2016.01-rc1 (Nov 11 2016 - 14:26:00 -0800) 1.3.2
uptime: 27636720
vc_links:
- neighbor_module_idx: 1
neighbor_port_id: vcp-1/1/0
port_id: vcp-0/1/0
vc_mode: HiGiG
vc_role: master
vc_state: present
version: 21.4R3-S4.18
- boot_partition: junos
cpld_version: '6'
cpu_stat:
idle: 76
interrupt: 0
load_avg:
- 0.96
- 0.87
- 0.76
system: 6
user: 17
fans:
- airflow: out
name: Fan Tray 0 Fan 0
rpm: 0
status: ok
- airflow: out
name: Fan Tray 1 Fan 0
rpm: 0
status: ok
fpc_idx: 1
mac: d0dd4991652d
memory_stat:
usage: 18
model: EX2300-48P
pics:
- index: 0
model_number: EX2300-48P
port_groups:
- count: 48
type: GE
- index: 1
model_number: EX2300-48P
port_groups:
- count: 4
type: SFP/SFP+
poe:
max_power: 750
power_draw: 21.2
status: AT_MODE
poe_version: 2.1.1.19.3 (type1)
psus:
- name: Power Supply 0
status: ok
recovery_version: 21.4R3-S4.18
serial: JW3619300922
temperatures:
- celsius: 32
name: CPU Sensor
status: ok
- celsius: 29
name: PSU Sensor
status: ok
type: fpc
uboot_version: U-Boot 2016.01-rc1 (Nov 11 2016 - 14:26:00 -0800) 1.3.2
uptime: 27636720
vc_links:
- neighbor_module_idx: 0
neighbor_port_id: vcp-0/1/0
port_id: vcp-1/1/0
vc_mode: HiGiG
vc_role: backup
vc_state: present
version: 21.4R3-S4.18
model: EX2300-48P
num_routing_engines: 1
org_id: 1e9a61a9-bc42-42ca-bf67-1ad87443d9b8
serial: JW3619300157
site_id: ab0aca7a-d45c-469b-b3bb-4fe240642d0b
status: connected
type: switch
vc_mac: 52d9107af289
contentMediaType: application/vnd.api+json
examples:
Example:
value:
config_type: nonprovisioned
id: 00000000-0000-0000-1000-52d9107af289
mac: 52d9107af289
members:
- boot_partition: junos
cpld_version: '6'
cpu_stat:
idle: 69
interrupt: 1
load_avg:
- 0.8
- 1.09
- 1.07
system: 11
user: 19
fans:
- airflow: out
name: Fan Tray 0 Fan 0
rpm: 0
status: ok
- airflow: out
name: Fan Tray 1 Fan 0
rpm: 0
status: ok
fpc_idx: 0
mac: 52d9107af289
memory_stat:
usage: 42
model: EX2300-48P
pics:
- index: 0
model_number: EX2300-48P
port_groups:
- count: 48
type: GE
- index: 1
model_number: EX2300-48P
port_groups:
- count: 4
type: SFP/SFP+
poe:
max_power: 750
power_draw: 40.4
status: AT_MODE
poe_version: 2.1.1.19.3 (type1)
psus:
- name: Power Supply 0
status: ok
recovery_version: 21.4R3-S4.18
serial: JW0000000000
temperatures:
- celsius: 33
name: CPU Sensor
status: ok
- celsius: 29
name: PSU Sensor
status: ok
type: fpc
uboot_version: U-Boot 2016.01-rc1 (Nov 11 2016 - 14:26:00 -0800) 1.3.2
uptime: 27636720
vc_links:
- neighbor_module_idx: 1
neighbor_port_id: vcp-1/1/0
port_id: vcp-0/1/0
vc_mode: HiGiG
vc_role: master
vc_state: present
version: 21.4R3-S4.18
- boot_partition: junos
cpld_version: '6'
cpu_stat:
idle: 76
interrupt: 0
load_avg:
- 0.96
- 0.87
- 0.76
system: 6
user: 17
fans:
- airflow: out
name: Fan Tray 0 Fan 0
rpm: 0
status: ok
- airflow: out
name: Fan Tray 1 Fan 0
rpm: 0
status: ok
fpc_idx: 1
mac: d0dd4991652d
memory_stat:
usage: 18
model: EX2300-48P
pics:
- index: 0
model_number: EX2300-48P
port_groups:
- count: 48
type: GE
- index: 1
model_number: EX2300-48P
port_groups:
- count: 4
type: SFP/SFP+
poe:
max_power: 750
power_draw: 21.2
status: AT_MODE
poe_version: 2.1.1.19.3 (type1)
psus:
- name: Power Supply 0
status: ok
recovery_version: 21.4R3-S4.18
serial: JW3619300922
temperatures:
- celsius: 32
name: CPU Sensor
status: ok
- celsius: 29
name: PSU Sensor
status: ok
type: fpc
uboot_version: U-Boot 2016.01-rc1 (Nov 11 2016 - 14:26:00 -0800) 1.3.2
uptime: 27636720
vc_links:
- neighbor_module_idx: 0
neighbor_port_id: vcp-0/1/0
port_id: vcp-1/1/0
vc_mode: HiGiG
vc_role: backup
vc_state: present
version: 21.4R3-S4.18
model: EX2300-48P
num_routing_engines: 1
org_id: 1e9a61a9-bc42-42ca-bf67-1ad87443d9b8
serial: JW3619300157
site_id: ab0aca7a-d45c-469b-b3bb-4fe240642d0b
status: connected
type: switch
vc_mac: 52d9107af289
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Installer
summary: updateInstallerVirtualChassisMember
description: "The VC creation and adding member switch API will update the device’ s virtual chassis config which is applied after VC is formed to create JUNOS pre-provisioned virtual chassis configuration.\n\n## Change to use preprovisioned VC\nTo switch the VC to use preprovisioned VC, enable preprovisioned in virtual_chassis config. Both vc_role master and backup will be matched to routing-engine role in Junos preprovisioned VC config.\n\nIn this config, fpc0 has to be the same as the mac of device_id. Use renumber if you want to replace fpc0 which involves device_id change.\n\nNotice: to configure preprovisioned VC, every member of the VC must be in the inventory.\n\n## Add new members\nFor models (e.g. EX4300 and up) having dedicated VC ports, it is easier to add new member switches into a VC by just connecting cables with the dedicated VC ports. Cloud will detect the new members and update the inventory.\n\nFor EX2300 VC, adding new members requires to follow the procedures below:\n1. Powering on the new member switches and ensuring cables are not connected to any VC ports.\n2. Claim or adopt all new member switches under the VC’s organization Inventory\n3. Assign all new member switches to the same Site as the VC\n4. Invoke vc command to add switches to the VC.\n5. Connect the cables to the VC ports for these switches\n6. After a while, the Org’s Inventory shows this new switches has been added into the VC.\n\n## Removing member switch\nTo remove a member switch from the VC, following the procedures below:\n\n1. Ensuring the VC is connected to the cloud first\n2. Unplug the cable from the VC port of the switch\n3. Waiting for the VC state (vc_state) of this switch is changed to not-present\n4. Invoke update_vc with remove to remove this switch from the VC\n5. The Org’s Inventory shows the switch is removed.\n\nPlease notice that member ID 0 (fpc0) cannot be removed. When a VC has two switches left, unplugging the cable may result in the situation that fpc0 becomes a line card (LC). When this situation is happening, please re-plug in the cable, wait for both switches becoming present (show virtual-chassis) and then removing the cable again.\n\n## Renumber a member switch\nWhen a member switch doesn't' work properly and needed to be replaced, the renumber API could be used. The following two types of renumber are supported:\n\n1. Replace a non-fpc0 member switch\n2. Replace fpc0. When fpc0 is replaced, PAPI device config and JUNOS config will be both updated.\n\nFor renumber to work, the following procedures are needed: \n1. Ensuring the VC is connected to the cloud and the state of the member switch to be replaced must be non present. \n2. Adding the new member switch to the VC \n3. Waiting for the VC state (vc_state) of this VC to be updated to API server \n4. Invoke vc with renumber to replace the new member switch from fpc X to\n\n## Perprovision VC members\nBy specifying \"preprovision\" op, you can convert the current VC to pre-provisioned mode, update VC members as well as specify vc_ports when adding new members for device models without dedicated vc ports. Use renumber for fpc0 replacement which involves device_id change.\n\nNote: \n1. vc_ports is used for adding new members and not needed if * the device model has dedicated vc ports, or * no new member is added \n2. New VC members to be added should exist in the same Site as the VC\n\nUpdate Device’s VC config can achieve similar purpose by directly modifying current virtual_chassis config. However, it cannot fulfill requests to enabling vc_ports on new members that are yet to belong to current VC."
operationId: updateInstallerVirtualChassisMember
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: fpc0_mac
in: path
description: FPC0 MAC address
required: true
schema:
type: string
examples:
- aff827549235
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/virtual_chassis_update'
- description: Request Body
examples:
- '{"members":[{"mac":"aff827549235","member_id":2,"vc_ports":["xe-0/1/0","xe-0/1/1"],"vc_role":"linecard"},{"mac":"8396cd00777c","member_id":3,"vc_ports":["xe-0/1/0","xe-0/1/1"],"vc_role":"linecard"}],"op":"add"}'
- '{"member":0,"members":[{"mac":"string","member_id":0,"vc_ports":["xe-0/1/0","xe-0/1/1"],"vc_role":"master"}],"new-member":0,"op":"add"}'
- '{"members":[{"member":2},{"member":3}],"op":"remove"}'
- '{"member":3,"new-member":2,"op":"renumber"}'
contentMediaType: application/json
examples:
adding-two-new-switches-as-line-cards-into-the-VC:
value:
members:
- mac: aff827549235
member_id: 2
vc_ports:
- xe-0/1/0
- xe-0/1/1
vc_role: linecard
- mac: 8396cd00777c
member_id: 3
vc_ports:
- xe-0/1/0
- xe-0/1/1
vc_role: linecard
op: add
convert-to-pre-provisioned-VC:
value:
member: 0
members:
- mac: string
member_id: 0
vc_ports:
- xe-0/1/0
- xe-0/1/1
vc_role: master
new-member: 0
op: add
removing-two-switches-from-VC:
value:
members:
- member: 2
- member: 3
op: remove
renumber-member-ID-3-to-member-ID-2:
value:
member: 3
new-member: 2
op: renumber
required: false
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_virtual_chassis_config'
- description: Combined virtual chassis status, topology, and member statistics
examples:
- config_type: nonprovisioned
id: 00000000-0000-0000-1000-52d9107af289
mac: 52d9107af289
members:
- boot_partition: junos
cpld_version: '6'
cpu_stat:
idle: 69
interrupt: 1
load_avg:
- 0.8
- 1.09
- 1.07
system: 11
user: 19
fans:
- airflow: out
name: Fan Tray 0 Fan 0
rpm: 0
status: ok
- airflow: out
name: Fan Tray 1 Fan 0
rpm: 0
status: ok
fpc_idx: 0
mac: 52d9107af289
memory_stat:
usage: 42
model: EX2300-48P
pics:
- index: 0
model_number: EX2300-48P
port_groups:
- count: 48
type: GE
- index: 1
model_number: EX2300-48P
port_groups:
- count: 4
type: SFP/SFP+
poe:
max_power: 750
power_draw: 40.4
status: AT_MODE
poe_version: 2.1.1.19.3 (type1)
psus:
- name: Power Supply 0
status: ok
recovery_version: 21.4R3-S4.18
serial: JW0000000000
temperatures:
- celsius: 33
name: CPU Sensor
status: ok
- celsius: 29
name: PSU Sensor
status: ok
type: fpc
uboot_version: U-Boot 2016.01-rc1 (Nov 11 2016 - 14:26:00 -0800) 1.3.2
uptime: 27636720
vc_links:
- neighbor_module_idx: 1
neighbor_port_id: vcp-1/1/0
port_id: vcp-0/1/0
vc_mode: HiGiG
vc_role: master
vc_state: present
version: 21.4R3-S4.18
- boot_partition: junos
cpld_version: '6'
cpu_stat:
idle: 76
interrupt: 0
load_avg:
- 0.96
- 0.87
- 0.76
system: 6
user: 17
fans:
- airflow: out
name: Fan Tray 0 Fan 0
rpm: 0
status: ok
- airflow: out
name: Fan Tray 1 Fan 0
rpm: 0
status: ok
fpc_idx: 1
mac: d0dd4991652d
memory_stat:
usage: 18
model: EX2300-48P
pics:
- index: 0
model_number: EX2300-48P
port_groups:
- count: 48
type: GE
- index: 1
model_number: EX2300-48P
port_groups:
- count: 4
type: SFP/SFP+
poe:
max_power: 750
power_draw: 21.2
status: AT_MODE
poe_version: 2.1.1.19.3 (type1)
psus:
- name: Power Supply 0
status: ok
recovery_version: 21.4R3-S4.18
serial: JW3619300922
temperatures:
- celsius: 32
name: CPU Sensor
status: ok
- celsius: 29
name: PSU Sensor
status: ok
type: fpc
uboot_version: U-Boot 2016.01-rc1 (Nov 11 2016 - 14:26:00 -0800) 1.3.2
uptime: 27636720
vc_links:
- neighbor_module_idx: 0
neighbor_port_id: vcp-0/1/0
port_id: vcp-1/1/0
vc_mode: HiGiG
vc_role: backup
vc_state: present
version: 21.4R3-S4.18
model: EX2300-48P
num_routing_engines: 1
org_id: 1e9a61a9-bc42-42ca-bf67-1ad87443d9b8
serial: JW3619300157
site_id: ab0aca7a-d45c-469b-b3bb-4fe240642d0b
status: connected
type: switch
vc_mac: 52d9107af289
contentMediaType: application/json
examples:
Example:
value:
config_type: nonprovisioned
id: 00000000-0000-0000-1000-52d9107af289
mac: 52d9107af289
members:
- boot_partition: junos
cpld_version: '6'
cpu_stat:
idle: 69
interrupt: 1
load_avg:
- 0.8
- 1.09
- 1.07
system: 11
user: 19
fans:
- airflow: out
name: Fan Tray 0 Fan 0
rpm: 0
status: ok
- airflow: out
name: Fan Tray 1 Fan 0
rpm: 0
status: ok
fpc_idx: 0
mac: 52d9107af289
memory_stat:
usage: 42
model: EX2300-48P
pics:
- index: 0
model_number: EX2300-48P
port_groups:
- count: 48
type: GE
- index: 1
model_number: EX2300-48P
port_groups:
- count: 4
type: SFP/SFP+
poe:
max_power: 750
power_draw: 40.4
status: AT_MODE
poe_version: 2.1.1.19.3 (type1)
psus:
- name: Power Supply 0
status: ok
recovery_version: 21.4R3-S4.18
serial: JW0000000000
temperatures:
- celsius: 33
name: CPU Sensor
status: ok
- celsius: 29
name: PSU Sensor
status: ok
type: fpc
uboot_version: U-Boot 2016.01-rc1 (Nov 11 2016 - 14:26:00 -0800) 1.3.2
uptime: 27636720
vc_links:
- neighbor_module_idx: 1
neighbor_port_id: vcp-1/1/0
port_id: vcp-0/1/0
vc_mode: HiGiG
vc_role: master
vc_state: present
version: 21.4R3-S4.18
- boot_partition: junos
cpld_version: '6'
cpu_stat:
idle: 76
interrupt: 0
load_avg:
- 0.96
- 0.87
- 0.76
system: 6
user: 17
fans:
- airflow: out
name: Fan Tray 0 Fan 0
rpm: 0
status: ok
- airflow: out
name: Fan Tray 1 Fan 0
rpm: 0
status: ok
fpc_idx: 1
mac: d0dd4991652d
memory_stat:
usage: 18
model: EX2300-48P
pics:
- index: 0
model_number: EX2300-48P
port_groups:
- count: 48
type: GE
- index: 1
model_number: EX2300-48P
port_groups:
- count: 4
type: SFP/SFP+
poe:
max_power: 750
power_draw: 21.2
status: AT_MODE
poe_version: 2.1.1.19.3 (type1)
psus:
- name: Power Supply 0
status: ok
recovery_version: 21.4R3-S4.18
serial: JW3619300922
temperatures:
- celsius: 32
name: CPU Sensor
status: ok
- celsius: 29
name: PSU Sensor
status: ok
type: fpc
uboot_version: U-Boot 2016.01-rc1 (Nov 11 2016 - 14:26:00 -0800) 1.3.2
uptime: 27636720
vc_links:
- neighbor_module_idx: 0
neighbor_port_id: vcp-0/1/0
port_id: vcp-1/1/0
vc_mode: HiGiG
vc_role: backup
vc_state: present
version: 21.4R3-S4.18
model: EX2300-48P
num_routing_engines: 1
org_id: 1e9a61a9-bc42-42ca-bf67-1ad87443d9b8
serial: JW3619300157
site_id: ab0aca7a-d45c-469b-b3bb-4fe240642d0b
status: connected
type: switch
vc_mac: 52d9107af289
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_virtual_chassis_config'
- description: Combined virtual chassis status, topology, and member statistics
examples:
- config_type: nonprovisioned
id: 00000000-0000-0000-1000-52d9107af289
mac: 52d9107af289
members:
- boot_partition: junos
cpld_version: '6'
cpu_stat:
idle: 69
interrupt: 1
load_avg:
- 0.8
- 1.09
- 1.07
system: 11
user: 19
fans:
- airflow: out
name: Fan Tray 0 Fan 0
rpm: 0
status: ok
- airflow: out
name: Fan Tray 1 Fan 0
rpm: 0
status: ok
fpc_idx: 0
mac: 52d9107af289
memory_stat:
usage: 42
model: EX2300-48P
pics:
- index: 0
model_number: EX2300-48P
port_groups:
- count: 48
type: GE
- index: 1
model_number: EX2300-48P
port_groups:
- count: 4
type: SFP/SFP+
poe:
max_power: 750
power_draw: 40.4
status: AT_MODE
poe_version: 2.1.1.19.3 (type1)
psus:
- name: Power Supply 0
status: ok
recovery_version: 21.4R3-S4.18
serial: JW0000000000
temperatures:
- celsius: 33
name: CPU Sensor
status: ok
- celsius: 29
name: PSU Sensor
status: ok
type: fpc
uboot_version: U-Boot 2016.01-rc1 (Nov 11 2016 - 14:26:00 -0800) 1.3.2
uptime: 27636720
vc_links:
- neighbor_module_idx: 1
neighbor_port_id: vcp-1/1/0
port_id: vcp-0/1/0
vc_mode: HiGiG
vc_role: master
vc_state: present
version: 21.4R3-S4.18
- boot_partition: junos
cpld_version: '6'
cpu_stat:
idle: 76
interrupt: 0
load_avg:
- 0.96
- 0.87
- 0.76
system: 6
user: 17
fans:
- airflow: out
name: Fan Tray 0 Fan 0
rpm: 0
status: ok
- airflow: out
name: Fan Tray 1 Fan 0
rpm: 0
status: ok
fpc_idx: 1
mac: d0dd4991652d
memory_stat:
usage: 18
model: EX2300-48P
pics:
- index: 0
model_number: EX2300-48P
port_groups:
- count: 48
type: GE
- index: 1
model_number: EX2300-48P
port_groups:
- count: 4
type: SFP/SFP+
poe:
max_power: 750
power_draw: 21.2
status: AT_MODE
poe_version: 2.1.1.19.3 (type1)
psus:
- name: Power Supply 0
status: ok
recovery_version: 21.4R3-S4.18
serial: JW3619300922
temperatures:
- celsius: 32
name: CPU Sensor
status: ok
- celsius: 29
name: PSU Sensor
status: ok
type: fpc
uboot_version: U-Boot 2016.01-rc1 (Nov 11 2016 - 14:26:00 -0800) 1.3.2
uptime: 27636720
vc_links:
- neighbor_module_idx: 0
neighbor_port_id: vcp-0/1/0
port_id: vcp-1/1/0
vc_mode: HiGiG
vc_role: backup
vc_state: present
version: 21.4R3-S4.18
model: EX2300-48P
num_routing_engines: 1
org_id: 1e9a61a9-bc42-42ca-bf67-1ad87443d9b8
serial: JW3619300157
site_id: ab0aca7a-d45c-469b-b3bb-4fe240642d0b
status: connected
type: switch
vc_mac: 52d9107af289
contentMediaType: application/vnd.api+json
examples:
Example:
value:
config_type: nonprovisioned
id: 00000000-0000-0000-1000-52d9107af289
mac: 52d9107af289
members:
- boot_partition: junos
cpld_version: '6'
cpu_stat:
idle: 69
interrupt: 1
load_avg:
- 0.8
- 1.09
- 1.07
system: 11
user: 19
fans:
- airflow: out
name: Fan Tray 0 Fan 0
rpm: 0
status: ok
- airflow: out
name: Fan Tray 1 Fan 0
rpm: 0
status: ok
fpc_idx: 0
mac: 52d9107af289
memory_stat:
usage: 42
model: EX2300-48P
pics:
- index: 0
model_number: EX2300-48P
port_groups:
- count: 48
type: GE
- index: 1
model_number: EX2300-48P
port_groups:
- count: 4
type: SFP/SFP+
poe:
max_power: 750
power_draw: 40.4
status: AT_MODE
poe_version: 2.1.1.19.3 (type1)
psus:
- name: Power Supply 0
status: ok
recovery_version: 21.4R3-S4.18
serial: JW0000000000
temperatures:
- celsius: 33
name: CPU Sensor
status: ok
- celsius: 29
name: PSU Sensor
status: ok
type: fpc
uboot_version: U-Boot 2016.01-rc1 (Nov 11 2016 - 14:26:00 -0800) 1.3.2
uptime: 27636720
vc_links:
- neighbor_module_idx: 1
neighbor_port_id: vcp-1/1/0
port_id: vcp-0/1/0
vc_mode: HiGiG
vc_role: master
vc_state: present
version: 21.4R3-S4.18
- boot_partition: junos
cpld_version: '6'
cpu_stat:
idle: 76
interrupt: 0
load_avg:
- 0.96
- 0.87
- 0.76
system: 6
user: 17
fans:
- airflow: out
name: Fan Tray 0 Fan 0
rpm: 0
status: ok
- airflow: out
name: Fan Tray 1 Fan 0
rpm: 0
status: ok
fpc_idx: 1
mac: d0dd4991652d
memory_stat:
usage: 18
model: EX2300-48P
pics:
- index: 0
model_number: EX2300-48P
port_groups:
- count: 48
type: GE
- index: 1
model_number: EX2300-48P
port_groups:
- count: 4
type: SFP/SFP+
poe:
max_power: 750
power_draw: 21.2
status: AT_MODE
poe_version: 2.1.1.19.3 (type1)
psus:
- name: Power Supply 0
status: ok
recovery_version: 21.4R3-S4.18
serial: JW3619300922
temperatures:
- celsius: 32
name: CPU Sensor
status: ok
- celsius: 29
name: PSU Sensor
status: ok
type: fpc
uboot_version: U-Boot 2016.01-rc1 (Nov 11 2016 - 14:26:00 -0800) 1.3.2
uptime: 27636720
vc_links:
- neighbor_module_idx: 0
neighbor_port_id: vcp-0/1/0
port_id: vcp-1/1/0
vc_mode: HiGiG
vc_role: backup
vc_state: present
version: 21.4R3-S4.18
model: EX2300-48P
num_routing_engines: 1
org_id: 1e9a61a9-bc42-42ca-bf67-1ad87443d9b8
serial: JW3619300157
site_id: ab0aca7a-d45c-469b-b3bb-4fe240642d0b
status: connected
type: switch
vc_mac: 52d9107af289
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/installer/orgs/{org_id}/rftemplates:
get:
tags:
- Installer
summary: listInstallerRfTemplatesNames
description: Return RF template names available to installer workflows for site creation or updates.
operationId: listInstallerRfTemplatesNames
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: Installer List of RF Templates
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/installers_item'
description: Installer access entries returned by list responses
examples:
- - id: bb8a9017-1e36-5d6c-6f2b-551abe8a76a2
name: RFTemplate 1
contentMediaType: application/json
examples:
Example:
value:
- id: bb8a9017-1e36-5d6c-6f2b-551abe8a76a2
name: RFTemplate 1
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/installers_item'
description: Installer access entries returned by list responses
examples:
- - id: bb8a9017-1e36-5d6c-6f2b-551abe8a76a2
name: RFTemplate 1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- id: bb8a9017-1e36-5d6c-6f2b-551abe8a76a2
name: RFTemplate 1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/installer/orgs/{org_id}/sitegroups:
get:
tags:
- Installer
summary: listInstallerSiteGroups
description: Return site groups that installers can assign when creating or updating sites.
operationId: listInstallerSiteGroups
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: Installer List of Site Groups
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/installers_item'
description: Installer access entries returned by list responses
examples:
- - id: 581328b6-e382-f54e-c9dc-999983183a34
name: SiteGroup 1
contentMediaType: application/json
examples:
Example:
value:
- id: 581328b6-e382-f54e-c9dc-999983183a34
name: SiteGroup 1
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/installers_item'
description: Installer access entries returned by list responses
examples:
- - id: 581328b6-e382-f54e-c9dc-999983183a34
name: SiteGroup 1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- id: 581328b6-e382-f54e-c9dc-999983183a34
name: SiteGroup 1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/installer/orgs/{org_id}/sites:
get:
tags:
- Installer
summary: listInstallerSites
description: Return sites visible to installer workflows for device assignment and map operations.
operationId: listInstallerSites
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: List of Sites
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/installer_site'
description: Sites available to installer workflows
examples:
- - address: 1601 S. Deanza Blvd., Cupertino, CA, 95014
country_code: US
id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
latlng:
lat: 37.295833
lng: -122.032946
name: Mist Office
rftemplate_name: rftemplate1
sitegroup_names:
- sg1
- sg2
timezone: America/Los_Angeles
contentMediaType: application/json
examples:
Example:
value:
- address: 1601 S. Deanza Blvd., Cupertino, CA, 95014
country_code: US
id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
latlng:
lat: 37.295833
lng: -122.032946
name: Mist Office
rftemplate_name: rftemplate1
sitegroup_names:
- sg1
- sg2
timezone: America/Los_Angeles
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/installer_site'
description: Sites available to installer workflows
examples:
- - address: 1601 S. Deanza Blvd., Cupertino, CA, 95014
country_code: US
id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
latlng:
lat: 37.295833
lng: -122.032946
name: Mist Office
rftemplate_name: rftemplate1
sitegroup_names:
- sg1
- sg2
timezone: America/Los_Angeles
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- address: 1601 S. Deanza Blvd., Cupertino, CA, 95014
country_code: US
id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
latlng:
lat: 37.295833
lng: -122.032946
name: Mist Office
rftemplate_name: rftemplate1
sitegroup_names:
- sg1
- sg2
timezone: America/Los_Angeles
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/installer/orgs/{org_id}/sites/{site_name}:
put:
tags:
- Installer
summary: createOrUpdateInstallerSites
description: Use `site_name` to create a site when it does not exist, or to update installer-editable fields on an existing site. Installers use these sites for device assignment, and grace-period rules also apply when updating an existing site.
operationId: createOrUpdateInstallerSites
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: site_name
in: path
description: ''
required: true
schema:
type: string
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/installer_site'
- description: Request Body
examples:
- address: 1601 S. Deanza Blvd., Cupertino, CA, 95014
country_code: US
latlng:
lat: 37.295833
lng: -122.032946
name: string
rftemplate_name: rftemplate1
sitegroup_names:
- sg1
- sg2
timezone: America/Los_Angeles
contentMediaType: application/json
examples:
Example:
value:
address: 1601 S. Deanza Blvd., Cupertino, CA, 95014
country_code: US
latlng:
lat: 37.295833
lng: -122.032946
name: string
rftemplate_name: rftemplate1
sitegroup_names:
- sg1
- sg2
timezone: America/Los_Angeles
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/installer/orgs/{org_id}/sites/{site_name}/maps:
get:
tags:
- Installer
summary: listInstallerMaps
description: Return maps for an installer-managed site, used for floorplan selection and AP placement during provisioning.
operationId: listInstallerMaps
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: site_name
in: path
description: ''
required: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/map'
description: Maps or floorplans returned by the API
examples:
- - created_time: 0
flags: {}
group_idx: 1
group_name: East Wing
height: 0
height_m: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
latlng_br:
lat: string
lng: string
latlng_tl:
lat: string
lng: string
locked: true
modified_time: 0
name: string
occupancy_limit: 0
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
orientation: 0
origin_x: 0
origin_y: 0
ppm: 0
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitesurvey_path:
- coordinate: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
nodes:
- edges:
N2: string
name: string
position:
x: 0
y: 0
thumbnail_url: string
type: image
url: string
view: roadmap
wall_path:
coordinate: string
nodes:
- edges:
N2: string
name: string
position:
x: 0
y: 0
wayfinding:
micello:
account_key: string
default_level_id: 0
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
snap_to_path: true
wayfinding_path:
coordinate: string
nodes:
- edges:
N2: string
name: string
position:
x: 0
y: 0
width: 0
width_m: 0
contentMediaType: application/json
examples:
Example:
value:
- created_time: 0
flags: {}
group_idx: 1
group_name: East Wing
height: 0
height_m: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
latlng_br:
lat: string
lng: string
latlng_tl:
lat: string
lng: string
locked: true
modified_time: 0
name: string
occupancy_limit: 0
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
orientation: 0
origin_x: 0
origin_y: 0
ppm: 0
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitesurvey_path:
- coordinate: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
nodes:
- edges:
N2: string
name: string
position:
x: 0
y: 0
thumbnail_url: string
type: image
url: string
view: roadmap
wall_path:
coordinate: string
nodes:
- edges:
N2: string
name: string
position:
x: 0
y: 0
wayfinding:
micello:
account_key: string
default_level_id: 0
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
snap_to_path: true
wayfinding_path:
coordinate: string
nodes:
- edges:
N2: string
name: string
position:
x: 0
y: 0
width: 0
width_m: 0
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/map'
description: Maps or floorplans returned by the API
examples:
- - created_time: 0
flags: {}
group_idx: 1
group_name: East Wing
height: 0
height_m: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
latlng_br:
lat: string
lng: string
latlng_tl:
lat: string
lng: string
locked: true
modified_time: 0
name: string
occupancy_limit: 0
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
orientation: 0
origin_x: 0
origin_y: 0
ppm: 0
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitesurvey_path:
- coordinate: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
nodes:
- edges:
N2: string
name: string
position:
x: 0
y: 0
thumbnail_url: string
type: image
url: string
view: roadmap
wall_path:
coordinate: string
nodes:
- edges:
N2: string
name: string
position:
x: 0
y: 0
wayfinding:
micello:
account_key: string
default_level_id: 0
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
snap_to_path: true
wayfinding_path:
coordinate: string
nodes:
- edges:
N2: string
name: string
position:
x: 0
y: 0
width: 0
width_m: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- created_time: 0
flags: {}
group_idx: 1
group_name: East Wing
height: 0
height_m: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
latlng_br:
lat: string
lng: string
latlng_tl:
lat: string
lng: string
locked: true
modified_time: 0
name: string
occupancy_limit: 0
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
orientation: 0
origin_x: 0
origin_y: 0
ppm: 0
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitesurvey_path:
- coordinate: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
nodes:
- edges:
N2: string
name: string
position:
x: 0
y: 0
thumbnail_url: string
type: image
url: string
view: roadmap
wall_path:
coordinate: string
nodes:
- edges:
N2: string
name: string
position:
x: 0
y: 0
wayfinding:
micello:
account_key: string
default_level_id: 0
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
snap_to_path: true
wayfinding_path:
coordinate: string
nodes:
- edges:
N2: string
name: string
position:
x: 0
y: 0
width: 0
width_m: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/installer/orgs/{org_id}/sites/{site_name}/maps/import:
post:
tags:
- Installer
summary: importInstallerMap
description: Import a site floorplan and optional placement data from multipart files. The request can include an image file, optional JSON, and optional CSV data to create the map and assign or place APs when names or MAC addresses match.
operationId: importInstallerMap
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: site_name
in: path
description: ''
required: true
schema:
type: string
requestBody:
content:
multipart/form-data:
encoding: {}
schema:
type: object
properties:
auto_deviceprofile_assignment:
type: boolean
description: Whether to auto assign device to deviceprofile by name
examples:
- true
csv:
type: string
description: Optional AP name-mapping CSV file
contentEncoding: base64
file:
type: string
description: Ekahau or iBwave floorplan file to import
contentEncoding: base64
json:
allOf:
- $ref: '#/components/schemas/map_import_json1'
- description: Import options for the site map file
contentMediaType: multipart/form-data
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_map_import'
- description: Result of importing map files and matching AP placements
examples:
- '{"aps":[{"action":"assigned-placed","floorplan_id":"6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9","height":3,"mac":"5c5b35000001","map_id":"845a23bf-bed9-e43c-4c86-6fa474be7ae5","orientation":45}],"floorplans":[{"action":"imported","id":"cbdb7f0b-3be0-4872-88f9-58790b509c23","map_id":"845a23bf-bed9-e43c-4c86-6fa474be7ae5","name":"map1"}],"site_id":"4ac1dcf4-9d8b-7211-65c4-057819f0862b","summary":{"num_ap_assigned":1,"num_inv_assigned":1,"num_map_assigned":1}}'
- '{"aps":[{"action":"assigned-named-placed","floorplan_id":"6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9","mac":"5c5b35000001","map_id":"845a23bf-bed9-e43c-4c86-6fa474be7ae5","orientation":45}],"floorplans":[{"action":"imported","id":"cbdb7f0b-3be0-4872-88f9-58790b509c23","map_id":"845a23bf-bed9-e43c-4c86-6fa474be7ae5","name":"map1"}],"site_id":"4ac1dcf4-9d8b-7211-65c4-057819f0862b","summary":{"num_ap_assigned":1,"num_inv_assigned":1,"num_map_assigned":1}}'
- '{"aps":[{"action":"placed","floorplan_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","height":3,"mac":"5c5b35000001","map_id":"845a23bf-bed9-e43c-4c86-6fa474be7ae5","orientation":45}],"floorplans":[{"action":"imported","id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","map_id":"845a23bf-bed9-e43c-4c86-6fa474be7ae5","name":"map1"}],"site_id":"4ac1dcf4-9d8b-7211-65c4-057819f0862b","summary":{"num_ap_assigned":1,"num_inv_assigned":1,"num_map_assigned":1}}'
contentMediaType: application/json
examples:
Assigned And Placed:
value:
aps:
- action: assigned-placed
floorplan_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
height: 3
mac: 5c5b35000001
map_id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
orientation: 45
floorplans:
- action: imported
id: cbdb7f0b-3be0-4872-88f9-58790b509c23
map_id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
name: map1
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
summary:
num_ap_assigned: 1
num_inv_assigned: 1
num_map_assigned: 1
Assigned Named And Placed:
value:
aps:
- action: assigned-named-placed
floorplan_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
mac: 5c5b35000001
map_id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
orientation: 45
floorplans:
- action: imported
id: cbdb7f0b-3be0-4872-88f9-58790b509c23
map_id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
name: map1
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
summary:
num_ap_assigned: 1
num_inv_assigned: 1
num_map_assigned: 1
Placed:
value:
aps:
- action: placed
floorplan_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
height: 3
mac: 5c5b35000001
map_id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
orientation: 45
floorplans:
- action: imported
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
map_id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
name: map1
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
summary:
num_ap_assigned: 1
num_inv_assigned: 1
num_map_assigned: 1
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_map_import'
- description: Result of importing map files and matching AP placements
examples:
- '{"aps":[{"action":"assigned-placed","floorplan_id":"6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9","height":3,"mac":"5c5b35000001","map_id":"845a23bf-bed9-e43c-4c86-6fa474be7ae5","orientation":45}],"floorplans":[{"action":"imported","id":"cbdb7f0b-3be0-4872-88f9-58790b509c23","map_id":"845a23bf-bed9-e43c-4c86-6fa474be7ae5","name":"map1"}],"site_id":"4ac1dcf4-9d8b-7211-65c4-057819f0862b","summary":{"num_ap_assigned":1,"num_inv_assigned":1,"num_map_assigned":1}}'
- '{"aps":[{"action":"assigned-named-placed","floorplan_id":"6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9","mac":"5c5b35000001","map_id":"845a23bf-bed9-e43c-4c86-6fa474be7ae5","orientation":45}],"floorplans":[{"action":"imported","id":"cbdb7f0b-3be0-4872-88f9-58790b509c23","map_id":"845a23bf-bed9-e43c-4c86-6fa474be7ae5","name":"map1"}],"site_id":"4ac1dcf4-9d8b-7211-65c4-057819f0862b","summary":{"num_ap_assigned":1,"num_inv_assigned":1,"num_map_assigned":1}}'
- '{"aps":[{"action":"placed","floorplan_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","height":3,"mac":"5c5b35000001","map_id":"845a23bf-bed9-e43c-4c86-6fa474be7ae5","orientation":45}],"floorplans":[{"action":"imported","id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","map_id":"845a23bf-bed9-e43c-4c86-6fa474be7ae5","name":"map1"}],"site_id":"4ac1dcf4-9d8b-7211-65c4-057819f0862b","summary":{"num_ap_assigned":1,"num_inv_assigned":1,"num_map_assigned":1}}'
contentMediaType: application/vnd.api+json
examples:
Assigned And Placed:
value:
aps:
- action: assigned-placed
floorplan_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
height: 3
mac: 5c5b35000001
map_id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
orientation: 45
floorplans:
- action: imported
id: cbdb7f0b-3be0-4872-88f9-58790b509c23
map_id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
name: map1
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
summary:
num_ap_assigned: 1
num_inv_assigned: 1
num_map_assigned: 1
Assigned Named And Placed:
value:
aps:
- action: assigned-named-placed
floorplan_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
mac: 5c5b35000001
map_id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
orientation: 45
floorplans:
- action: imported
id: cbdb7f0b-3be0-4872-88f9-58790b509c23
map_id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
name: map1
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
summary:
num_ap_assigned: 1
num_inv_assigned: 1
num_map_assigned: 1
Placed:
value:
aps:
- action: placed
floorplan_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
height: 3
mac: 5c5b35000001
map_id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
orientation: 45
floorplans:
- action: imported
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
map_id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
name: map1
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
summary:
num_ap_assigned: 1
num_inv_assigned: 1
num_map_assigned: 1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/installer/orgs/{org_id}/sites/{site_name}/maps/{map_id}:
delete:
tags:
- Installer
summary: deleteInstallerMap
description: Remove a map or floorplan from an installer-managed site. This removes the map used for AP placement, but does not delete the site.
operationId: deleteInstallerMap
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: site_name
in: path
description: ''
required: true
schema:
type: string
- name: map_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Installer
summary: createInstallerMap
description: Define a map or floorplan for an installer-managed site, including metadata used for AP placement and site visualization.
operationId: createInstallerMap
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: site_name
in: path
description: ''
required: true
schema:
type: string
- name: map_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/map'
- description: Request Body
examples:
- height: 0
latlng_br:
lat: string
lng: string
latlng_tl:
lat: string
lng: string
locked: true
name: string
orientation: 0
origin_x: 0
origin_y: 0
ppm: 0
sitesurvey_path:
- coordinate: string
name: string
nodes:
- edges:
N2: string
name: string
position:
x: 0
y: 0
type: image
view: roadmap
wall_path:
coordinate: string
nodes:
- edges:
N2: string
name: string
position:
x: 0
y: 0
wayfinding:
micello:
account_key: string
default_level_id: 0
snap_to_path: true
wayfinding_path:
coordinate: string
nodes:
- edges:
N2: string
name: string
position:
x: 0
y: 0
width: 0
contentMediaType: application/json
examples:
Example:
value:
height: 0
latlng_br:
lat: string
lng: string
latlng_tl:
lat: string
lng: string
locked: true
name: string
orientation: 0
origin_x: 0
origin_y: 0
ppm: 0
sitesurvey_path:
- coordinate: string
name: string
nodes:
- edges:
N2: string
name: string
position:
x: 0
y: 0
type: image
view: roadmap
wall_path:
coordinate: string
nodes:
- edges:
N2: string
name: string
position:
x: 0
y: 0
wayfinding:
micello:
account_key: string
default_level_id: 0
snap_to_path: true
wayfinding_path:
coordinate: string
nodes:
- edges:
N2: string
name: string
position:
x: 0
y: 0
width: 0
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/map'
- description: Map or floorplan metadata for a site or organization
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/map'
- description: Map or floorplan metadata for a site or organization
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Installer
summary: updateInstallerMap
description: Modify map or floorplan metadata for an installer-managed site, including dimensions, orientation, and placement-related settings.
operationId: updateInstallerMap
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: site_name
in: path
description: ''
required: true
schema:
type: string
- name: map_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/map'
- description: Request Body
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/map'
- description: Map or floorplan metadata for a site or organization
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/map'
- description: Map or floorplan metadata for a site or organization
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/installer/sites/{site_name}/optimize:
get:
tags:
- Installer
summary: optimizeInstallerRrm
description: Trigger RF optimization after installation is complete, such as after APs have been placed on maps and powered on. This starts RRM before the next automatic optimization schedule.
operationId: optimizeInstallerRrm
parameters:
- name: site_name
in: path
description: ''
required: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/msps:
post:
tags:
- MSPs
summary: createMsp
description: Create a managed service provider account that can own organizations, organization groups, admins, licenses, and MSP-level settings.
operationId: createMsp
parameters: []
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/msp'
- description: Request Body
examples:
- name: MSP
contentMediaType: application/json
examples:
Example:
value:
name: MSP
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/msp'
- description: Managed service provider account
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/msp'
- description: Managed service provider account
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/msps/{msp_id}:
delete:
tags:
- MSPs
summary: deleteMsp
description: Delete the MSP account and its MSP-level organization groups and privileges. This does not delete any organizations or administrator accounts.
operationId: deleteMsp
parameters:
- name: msp_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- MSPs
summary: getMspDetails
description: Return MSP account details, including the display name, service tier, support-access setting, logo URL, custom URL, and timestamps.
operationId: getMspDetails
parameters:
- name: msp_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/msp'
- description: Managed service provider account
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/msp'
- description: Managed service provider account
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- MSPs
summary: updateMsp
description: Update editable MSP account settings such as the display name, support-access setting, logo URL, or custom URL.
operationId: updateMsp
parameters:
- name: msp_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/msp'
- description: Request Body
examples:
- name: MSP
contentMediaType: application/json
examples:
Example:
value:
name: MSP
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/msp'
- description: Managed service provider account
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/msp'
- description: Managed service provider account
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/msps/{msp_id}/search:
get:
tags:
- MSPs
summary: searchMspOrgGroup
description: Search MSP resources by query string. Currently `type=orgs` returns matching organizations in this MSP.
operationId: searchMspOrgGroup
parameters:
- name: msp_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: type
in: query
description: 'MSP search result type to return. enum: `orgs`'
required: true
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/msp_search_type'
- description: 'MSP search result type to return. enum: `orgs`'
examples:
- orgs
- name: q
in: query
description: Filter results by search string
required: true
style: form
explode: true
schema:
type: string
examples:
- live
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_search'
- description: Paginated response for MSP organization search results
examples:
- limit: 0
page: 0
results:
- id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
text: string
type: string
total: 0
contentMediaType: application/json
examples:
Example:
value:
limit: 0
page: 0
results:
- id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
text: string
type: string
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_search'
- description: Paginated response for MSP organization search results
examples:
- limit: 0
page: 0
results:
- id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
text: string
type: string
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
limit: 0
page: 0
results:
- id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
text: string
type: string
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/msps/{msp_id}/admins:
get:
tags:
- MSPs Admins
summary: listMspAdmins
description: List administrators that have privileges in this MSP hierarchy, including MSP, organization, organization group, site, or site group scopes.
operationId: listMspAdmins
parameters:
- name: msp_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/admin'
description: List of Mist administrator accounts
examples:
- '[{"admin_id":"456b7016-a916-a4b1-78dd-72b947c152b7","email":"jsmith@mycorp.org","first_name":"Joe","last_name":"Smith","privileges":[{"role":"admin","scope":"msp"},{"org_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","role":"admin","scope":"org"},{"orggroup_ids":["507f1bab-13ba-73e2-f291-2bcb8d1362b0"],"role":"read","scope":"orggroup"}]}]'
- '[{"admin_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","email":"user@example.com","first_name":"string","last_name":"string","privileges":[{"msp_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","msp_name":"string","name":"string","org_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","org_name":"string","orggroup_ids":["b069b358-4c97-5319-1f8c-7c5ca64d6ab1"],"role":"admin","scope":"org","site_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","sitegroup_ids":["6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9"]}]}]'
contentMediaType: application/json
examples:
Example:
value:
- admin_id: 456b7016-a916-a4b1-78dd-72b947c152b7
email: jsmith@mycorp.org
first_name: Joe
last_name: Smith
privileges:
- role: admin
scope: msp
- org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
role: admin
scope: org
- orggroup_ids:
- 507f1bab-13ba-73e2-f291-2bcb8d1362b0
role: read
scope: orggroup
Example2:
value:
- admin_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
email: user@example.com
first_name: string
last_name: string
privileges:
- msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
msp_name: string
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
org_name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
role: admin
scope: org
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
application/vnd.api+json:
schema:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/admin'
description: List of Mist administrator accounts
examples:
- '[{"admin_id":"456b7016-a916-a4b1-78dd-72b947c152b7","email":"jsmith@mycorp.org","first_name":"Joe","last_name":"Smith","privileges":[{"role":"admin","scope":"msp"},{"org_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","role":"admin","scope":"org"},{"orggroup_ids":["507f1bab-13ba-73e2-f291-2bcb8d1362b0"],"role":"read","scope":"orggroup"}]}]'
- '[{"admin_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","email":"user@example.com","first_name":"string","last_name":"string","privileges":[{"msp_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","msp_name":"string","name":"string","org_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","org_name":"string","orggroup_ids":["b069b358-4c97-5319-1f8c-7c5ca64d6ab1"],"role":"admin","scope":"org","site_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","sitegroup_ids":["6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9"]}]}]'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- admin_id: 456b7016-a916-a4b1-78dd-72b947c152b7
email: jsmith@mycorp.org
first_name: Joe
last_name: Smith
privileges:
- role: admin
scope: msp
- org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
role: admin
scope: org
- orggroup_ids:
- 507f1bab-13ba-73e2-f291-2bcb8d1362b0
role: read
scope: orggroup
Example2:
value:
- admin_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
email: user@example.com
first_name: string
last_name: string
privileges:
- msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
msp_name: string
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
org_name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
role: admin
scope: org
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/msps/{msp_id}/admins/{admin_id}:
delete:
tags:
- MSPs Admins
summary: revokeMspAdmin
description: Remove all privileges this administrator has through the MSP hierarchy, including inherited organization and site access. This does not delete the administrator account.
operationId: revokeMspAdmin
parameters:
- name: msp_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: admin_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- MSPs Admins
summary: getMspAdmin
description: Return administrator details and privilege assignments for one administrator under this MSP.
operationId: getMspAdmin
parameters:
- name: msp_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: admin_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/admin'
- description: Mist administrator account or organization API token details
examples:
- admin_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
email: user@example.com
first_name: string
last_name: string
password_modified_time: 1656353525
privileges:
- msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
msp_name: string
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
org_name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
role: admin
scope: org
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
contentMediaType: application/json
examples:
Example:
value:
admin_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
email: user@example.com
first_name: string
last_name: string
password_modified_time: 1656353525
privileges:
- msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
msp_name: string
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
org_name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
role: admin
scope: org
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/admin'
- description: Mist administrator account or organization API token details
examples:
- admin_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
email: user@example.com
first_name: string
last_name: string
password_modified_time: 1656353525
privileges:
- msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
msp_name: string
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
org_name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
role: admin
scope: org
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
contentMediaType: application/vnd.api+json
examples:
Example:
value:
admin_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
email: user@example.com
first_name: string
last_name: string
password_modified_time: 1656353525
privileges:
- msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
msp_name: string
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
org_name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
role: admin
scope: org
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- MSPs Admins
summary: updateMspAdmin
description: Update identity fields and privilege assignments for an existing administrator under this MSP.
operationId: updateMspAdmin
parameters:
- name: msp_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: admin_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/admin'
- description: Request Body
examples:
- email: jsnow@abc.com
first_name: string
last_name: string
privileges:
- org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
role: admin
scope: org
sitegroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
- role: admin
scope: site
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/json
examples:
Example:
value:
email: jsnow@abc.com
first_name: string
last_name: string
privileges:
- org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
role: admin
scope: org
sitegroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
- role: admin
scope: site
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/admin'
- description: Mist administrator account or organization API token details
examples:
- admin_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
email: user@example.com
first_name: string
last_name: string
password_modified_time: 1656353525
privileges:
- msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
msp_name: string
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
org_name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
role: admin
scope: org
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
contentMediaType: application/json
examples:
Example:
value:
admin_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
email: user@example.com
first_name: string
last_name: string
password_modified_time: 1656353525
privileges:
- msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
msp_name: string
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
org_name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
role: admin
scope: org
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/admin'
- description: Mist administrator account or organization API token details
examples:
- admin_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
email: user@example.com
first_name: string
last_name: string
password_modified_time: 1656353525
privileges:
- msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
msp_name: string
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
org_name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
role: admin
scope: org
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
contentMediaType: application/vnd.api+json
examples:
Example:
value:
admin_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
email: user@example.com
first_name: string
last_name: string
password_modified_time: 1656353525
privileges:
- msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
msp_name: string
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
org_name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
role: admin
scope: org
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/msps/{msp_id}/invites:
post:
tags:
- MSPs Admins
summary: inviteMspAdmin
description: >-
Send an MSP administrator invitation with the requested identity fields and privilege assignments.
**Note**: An email will also be sent to the user with a link to https://manage.mist.com/verify/invite?token=:token
operationId: inviteMspAdmin
parameters:
- name: msp_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/admin'
- description: Request Body
examples:
- '{"email":"user@example.com","first_name":"string","last_name":"string","privileges":[{"msp_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","msp_name":"string","name":"string","org_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","org_name":"string","orggroup_ids":["b069b358-4c97-5319-1f8c-7c5ca64d6ab1"],"role":"admin","scope":"org","site_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","sitegroup_ids":["b069b358-4c97-5319-1f8c-7c5ca64d6ab1"]}]}'
contentMediaType: application/json
examples:
Example:
value:
email: user@example.com
first_name: string
last_name: string
privileges:
- msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
msp_name: string
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
org_name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
role: admin
scope: org
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/admin'
- description: Mist administrator account or organization API token details
examples:
- admin_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
email: user@example.com
first_name: string
last_name: string
password_modified_time: 1656353525
privileges:
- msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
msp_name: string
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
org_name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
role: admin
scope: org
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
contentMediaType: application/json
examples:
Example:
value:
admin_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
email: user@example.com
first_name: string
last_name: string
password_modified_time: 1656353525
privileges:
- msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
msp_name: string
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
org_name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
role: admin
scope: org
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/admin'
- description: Mist administrator account or organization API token details
examples:
- admin_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
email: user@example.com
first_name: string
last_name: string
password_modified_time: 1656353525
privileges:
- msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
msp_name: string
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
org_name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
role: admin
scope: org
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
contentMediaType: application/vnd.api+json
examples:
Example:
value:
admin_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
email: user@example.com
first_name: string
last_name: string
password_modified_time: 1656353525
privileges:
- msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
msp_name: string
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
org_name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
role: admin
scope: org
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/msps/{msp_id}/invites/{invite_id}:
delete:
tags:
- MSPs Admins
summary: uninviteMspAdmin
description: Cancel a pending MSP administrator invitation before the invitee accepts it.
operationId: uninviteMspAdmin
parameters:
- name: msp_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: invite_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- MSPs Admins
summary: updateMspAdminInvite
description: Update the identity fields or privilege assignments on a pending MSP administrator invitation.
operationId: updateMspAdminInvite
parameters:
- name: msp_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: invite_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/admin'
- description: Request Body
examples:
- '{"email":"user@example.com","first_name":"string","last_name":"string","privileges":[{"msp_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","msp_name":"string","name":"string","org_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","org_name":"string","orggroup_ids":["b069b358-4c97-5319-1f8c-7c5ca64d6ab1"],"role":"admin","scope":"org","site_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","sitegroup_ids":["b069b358-4c97-5319-1f8c-7c5ca64d6ab1"]}]}'
contentMediaType: application/json
examples:
Example:
value:
email: user@example.com
first_name: string
last_name: string
privileges:
- msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
msp_name: string
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
org_name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
role: admin
scope: org
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/admin'
- description: Mist administrator account or organization API token details
examples:
- admin_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
email: user@example.com
first_name: string
last_name: string
password_modified_time: 1656353525
privileges:
- msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
msp_name: string
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
org_name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
role: admin
scope: org
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
contentMediaType: application/json
examples:
Example:
value:
admin_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
email: user@example.com
first_name: string
last_name: string
password_modified_time: 1656353525
privileges:
- msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
msp_name: string
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
org_name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
role: admin
scope: org
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/admin'
- description: Mist administrator account or organization API token details
examples:
- admin_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
email: user@example.com
first_name: string
last_name: string
password_modified_time: 1656353525
privileges:
- msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
msp_name: string
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
org_name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
role: admin
scope: org
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
contentMediaType: application/vnd.api+json
examples:
Example:
value:
admin_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
email: user@example.com
first_name: string
last_name: string
password_modified_time: 1656353525
privileges:
- msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
msp_name: string
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
org_name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
role: admin
scope: org
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/secintelprofiles:
get:
tags:
- Orgs SecIntel Profiles
summary: listOrgSecIntelProfiles
description: List organization SecIntel profiles. These profiles define protection levels for SecIntel feed categories such as command-and-control, infected host, and DNS.
operationId: listOrgSecIntelProfiles
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/secintel_profile'
description: SecIntel profiles returned by list operations
examples:
- - name: secintel-custom
profiles:
- action: default
category: CC
contentMediaType: application/json
examples:
Example:
value:
- name: secintel-custom
profiles:
- action: default
category: CC
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/secintel_profile'
description: SecIntel profiles returned by list operations
examples:
- - name: secintel-custom
profiles:
- action: default
category: CC
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- name: secintel-custom
profiles:
- action: default
category: CC
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs SecIntel Profiles
summary: createOrgSecIntelProfile
description: Create an organization SecIntel profile with category-specific protection levels for threat intelligence feeds.
operationId: createOrgSecIntelProfile
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/secintel_profile'
- description: Request Body
examples:
- name: secintel-custom
profiles:
- action: default
category: CC
contentMediaType: application/json
examples:
Example:
value:
name: secintel-custom
profiles:
- action: default
category: CC
required: false
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/secintel_profile'
- description: SecIntel profile containing category-specific threat intelligence actions
examples:
- name: secintel-custom
profiles:
- action: default
category: CC
contentMediaType: application/json
examples:
Example:
value:
name: secintel-custom
profiles:
- action: default
category: CC
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/secintel_profile'
- description: SecIntel profile containing category-specific threat intelligence actions
examples:
- name: secintel-custom
profiles:
- action: default
category: CC
contentMediaType: application/vnd.api+json
examples:
Example:
value:
name: secintel-custom
profiles:
- action: default
category: CC
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/secintelprofiles/{secintelprofile_id}:
delete:
tags:
- Orgs SecIntel Profiles
summary: deleteOrgSecIntelProfile
description: Remove an organization SecIntel profile from the organization's available threat intelligence profile set.
operationId: deleteOrgSecIntelProfile
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: secintelprofile_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Orgs SecIntel Profiles
summary: getOrgSecIntelProfile
description: Return an organization SecIntel profile, including the protection level configured for each SecIntel feed category.
operationId: getOrgSecIntelProfile
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: secintelprofile_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/secintel_profile'
- description: SecIntel profile containing category-specific threat intelligence actions
examples:
- name: secintel-custom
profiles:
- action: default
category: CC
contentMediaType: application/json
examples:
Example:
value:
name: secintel-custom
profiles:
- action: default
category: CC
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/secintel_profile'
- description: SecIntel profile containing category-specific threat intelligence actions
examples:
- name: secintel-custom
profiles:
- action: default
category: CC
contentMediaType: application/vnd.api+json
examples:
Example:
value:
name: secintel-custom
profiles:
- action: default
category: CC
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Orgs SecIntel Profiles
summary: updateOrgSecIntelProfile
description: Update an organization SecIntel profile, including its display name and category-specific threat intelligence protection levels.
operationId: updateOrgSecIntelProfile
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: secintelprofile_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/secintel_profile'
- description: Request Body
examples:
- name: secintel-custom
profiles:
- action: default
category: CC
contentMediaType: application/json
examples:
Example:
value:
name: secintel-custom
profiles:
- action: default
category: CC
required: false
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/secintel_profile'
- description: SecIntel profile containing category-specific threat intelligence actions
examples:
- name: secintel-custom
profiles:
- action: default
category: CC
contentMediaType: application/json
examples:
Example:
value:
name: secintel-custom
profiles:
- action: default
category: CC
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/secintel_profile'
- description: SecIntel profile containing category-specific threat intelligence actions
examples:
- name: secintel-custom
profiles:
- action: default
category: CC
contentMediaType: application/vnd.api+json
examples:
Example:
value:
name: secintel-custom
profiles:
- action: default
category: CC
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/secintelprofiles/derived:
get:
tags:
- Sites SecIntel Profiles
summary: listSiteSecIntelProfilesDerived
description: Get the list of derived Sky-ATP secintel profiles a Site
operationId: listSiteSecIntelProfilesDerived
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: resolve
in: query
description: Whether resolve the site variables
style: form
explode: true
schema:
type: boolean
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/secintel_profile'
description: SecIntel profiles returned by list operations
examples:
- - name: secintel-custom
profiles:
- action: default
category: CC
contentMediaType: application/json
examples:
Example:
value:
- name: secintel-custom
profiles:
- action: default
category: CC
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/secintel_profile'
description: SecIntel profiles returned by list operations
examples:
- - name: secintel-custom
profiles:
- action: default
category: CC
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- name: secintel-custom
profiles:
- action: default
category: CC
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/msps/{msp_id}/inventory/{device_mac}:
get:
tags:
- MSPs Inventory
summary: getMspInventoryByMac
description: Return the inventory record for a device MAC address owned by an organization under this MSP, including the owning organization and site when available.
operationId: getMspInventoryByMac
parameters:
- name: msp_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_mac
in: path
description: ''
required: true
schema:
pattern: ^[0-9a-fA-F]{12}$
type: string
examples:
- 0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_msp_inventory_device'
- description: Inventory device record returned by MSP device MAC lookup
examples:
- mac: 5c5b35000018
model: AP200
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
serial: FXLH2015150025
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
type: ap
contentMediaType: application/json
examples:
Example:
value:
mac: 5c5b35000018
model: AP200
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
serial: FXLH2015150025
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
type: ap
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_msp_inventory_device'
- description: Inventory device record returned by MSP device MAC lookup
examples:
- mac: 5c5b35000018
model: AP200
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
serial: FXLH2015150025
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
type: ap
contentMediaType: application/vnd.api+json
examples:
Example:
value:
mac: 5c5b35000018
model: AP200
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
serial: FXLH2015150025
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
type: ap
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/msps/{msp_id}/logo:
delete:
tags:
- MSPs Logo
summary: deleteMspLogo
description: Remove the logo configured for an advanced-tier MSP account.
operationId: deleteMspLogo
parameters:
- name: msp_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- MSPs Logo
summary: postMspLogo
description: Upload or update the public logo URL for an advanced-tier MSP account.
operationId: postMspLogo
parameters:
- name: msp_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/msp_logo'
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/msps/{msp_id}/logs:
get:
tags:
- MSPs Logs
summary: listMspAuditLogs
description: List audit log entries for configuration and administrative changes within this MSP, with optional filters by site, administrator, message text, and time range.
operationId: listMspAuditLogs
parameters:
- name: msp_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: site_id
in: query
description: Filter results by site identifier
style: form
explode: true
schema:
type: string
examples:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
- name: admin_name
in: query
description: Admin name or email
style: form
explode: true
schema:
type: string
examples:
- jsnow
- name: message
in: query
description: Filter results by message text
style: form
explode: true
schema:
type: string
examples:
- Added new site
- name: sort
in: query
description: 'Field used to sort results; a leading `-` indicates descending order. enum: `-timestamp`, `admin_id`, `site_id`, `timestamp`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/list_msp_logs_sort'
- description: 'Field used to sort results; a leading `-` indicates descending order. enum: `-timestamp`, `admin_id`, `site_id`, `timestamp`'
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_log_search'
- description: Paginated response for audit log search results
examples:
- end: 1428954000
limit: 100
results:
- admin_id: 72bfa2bd-e58a-4670-9d20-a1468f7a6f58
admin_name: test@mistsys.com
id: c6f9347b-b0a4-4a23-b927-fa9249f2ffb2
message: TEST AUDIT
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
timestamp: 1431382121
start: 1428939600
total: 135
contentMediaType: application/json
examples:
Example:
value:
end: 1428954000
limit: 100
results:
- admin_id: 72bfa2bd-e58a-4670-9d20-a1468f7a6f58
admin_name: test@mistsys.com
id: c6f9347b-b0a4-4a23-b927-fa9249f2ffb2
message: TEST AUDIT
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
timestamp: 1431382121
start: 1428939600
total: 135
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_log_search'
- description: Paginated response for audit log search results
examples:
- end: 1428954000
limit: 100
results:
- admin_id: 72bfa2bd-e58a-4670-9d20-a1468f7a6f58
admin_name: test@mistsys.com
id: c6f9347b-b0a4-4a23-b927-fa9249f2ffb2
message: TEST AUDIT
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
timestamp: 1431382121
start: 1428939600
total: 135
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 1428954000
limit: 100
results:
- admin_id: 72bfa2bd-e58a-4670-9d20-a1468f7a6f58
admin_name: test@mistsys.com
id: c6f9347b-b0a4-4a23-b927-fa9249f2ffb2
message: TEST AUDIT
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
timestamp: 1431382121
start: 1428939600
total: 135
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/msps/{msp_id}/logs/count:
get:
tags:
- MSPs Logs
summary: countMspAuditLogs
description: Return distinct counts of MSP audit log entries grouped by the requested field, such as administrator, message, or organization.
operationId: countMspAuditLogs
parameters:
- name: msp_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field used to group this count response. enum: `admin_id`, `admin_name`, `message`, `org_id`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/msp_logs_count_distinct'
- description: 'Field used to group this count response. enum: `admin_id`, `admin_name`, `message`, `org_id`'
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/msps/{msp_id}/claim:
post:
tags:
- MSPs Licenses
summary: claimMspLicense
description: Claim a license order for this MSP by submitting the activation code from the order.
operationId: claimMspLicense
parameters:
- name: msp_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/code_string'
- examples:
- code: ZHT3K-H36DT-MG85D-M61AC
contentMediaType: application/json
examples:
Example:
value:
code: ZHT3K-H36DT-MG85D-M61AC
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_claim_license'
- description: Result of claiming licenses or activation codes
examples:
- inventory_added:
- mac: 5c5b35000018
magic: 6JG8EPTFV2A9Z2N
model: AP41
serial: FXLH2015150025
type: ap
inventory_duplicated:
- mac: 5c5b35000012
magic: DVH4VSNMSZPDXBR
model: AP41
serial: FXLH2015150027
type: ap
inventory_pending:
- mac: 5c5b35000012
license_added:
- end: 1520380800
quantity: 180
start: 1504828800
type: SUB-MAN
- end: 1520380800
quantity: 120
start: 1504828800
type: SUB-LOC
license_duplicated:
- end: 1520380800
quantity: 180
start: 1504828800
type: SUB-MAN
license_error:
- order: '00000464'
reason: ''
contentMediaType: application/json
examples:
Licenses Successfully Claimed And Applied:
value:
inventory_added:
- mac: 5c5b35000018
magic: 6JG8EPTFV2A9Z2N
model: AP41
serial: FXLH2015150025
type: ap
inventory_duplicated:
- mac: 5c5b35000012
magic: DVH4VSNMSZPDXBR
model: AP41
serial: FXLH2015150027
type: ap
inventory_pending:
- mac: 5c5b35000012
license_added:
- end: 1520380800
quantity: 180
start: 1504828800
type: SUB-MAN
- end: 1520380800
quantity: 120
start: 1504828800
type: SUB-LOC
license_duplicated:
- end: 1520380800
quantity: 180
start: 1504828800
type: SUB-MAN
license_error:
- order: '00000464'
reason: ''
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_claim_license'
- description: Result of claiming licenses or activation codes
examples:
- inventory_added:
- mac: 5c5b35000018
magic: 6JG8EPTFV2A9Z2N
model: AP41
serial: FXLH2015150025
type: ap
inventory_duplicated:
- mac: 5c5b35000012
magic: DVH4VSNMSZPDXBR
model: AP41
serial: FXLH2015150027
type: ap
inventory_pending:
- mac: 5c5b35000012
license_added:
- end: 1520380800
quantity: 180
start: 1504828800
type: SUB-MAN
- end: 1520380800
quantity: 120
start: 1504828800
type: SUB-LOC
license_duplicated:
- end: 1520380800
quantity: 180
start: 1504828800
type: SUB-MAN
license_error:
- order: '00000464'
reason: ''
contentMediaType: application/vnd.api+json
examples:
Licenses Successfully Claimed And Applied:
value:
inventory_added:
- mac: 5c5b35000018
magic: 6JG8EPTFV2A9Z2N
model: AP41
serial: FXLH2015150025
type: ap
inventory_duplicated:
- mac: 5c5b35000012
magic: DVH4VSNMSZPDXBR
model: AP41
serial: FXLH2015150027
type: ap
inventory_pending:
- mac: 5c5b35000012
license_added:
- end: 1520380800
quantity: 180
start: 1504828800
type: SUB-MAN
- end: 1520380800
quantity: 120
start: 1504828800
type: SUB-LOC
license_duplicated:
- end: 1520380800
quantity: 180
start: 1504828800
type: SUB-MAN
license_error:
- order: '00000464'
reason: ''
'400':
description: Response when the key is invalid (or already used)
headers: {}
content: {}
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/msps/{msp_id}/licenses:
get:
tags:
- MSPs Licenses
summary: listMspLicenses
description: Return MSP license entitlement, subscription, amendment, and usage summary information.
operationId: listMspLicenses
parameters:
- name: msp_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/license'
- description: Organization license entitlement, subscription, and usage summary
examples:
- amendments:
- created_time: 1644684842
end_time: 1744156799
id: ff0a14f6-1234-5678-90ab-c8e64d4bc6c6
modified_time: 1644684842
quantity: -1
start_time: 1632873600
subscription_id: VNA-000000af
type: SUB-VNA
- created_time: 1644684842
end_time: 1744156799
id: c1c28812-1234-5678-90ab-dc95680da61e
modified_time: 1644684842
quantity: -1
start_time: 1632873600
subscription_id: MAN-000008be
type: SUB-MAN
- created_time: 1644684842
end_time: 1744243199
id: 96c0a41f-1234-5678-90ab-afe74817e9fd
modified_time: 1644684842
quantity: -1
start_time: 1586476800
subscription_id: EX24-000000bc
type: SUB-EX24
entitled:
SUB-ENG: 26
SUB-EX24: 9
SUB-MAN: 26
SUB-VNA: 26
licenses:
- created_time: 1555353534
end_time: 1586822399
id: 693a41a6-1234-5678-90ab-f53dbd3a31c0
modified_time: 1555353534
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 2
remaining_quantity: 0
start_time: 1555286400
subscription_id: VNA-000000aa
type: SUB-VNA
- created_time: 1576132516
end_time: 1586822399
id: 656607cf-1234-5678-90ab-fc9035614ea5
modified_time: 1576132516
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 8
remaining_quantity: 0
start_time: 1576022400
subscription_id: VNA-000000ab
type: SUB-VNA
- created_time: 1579204568
end_time: 1730764800
id: db50d0bc-1234-5678-90ab-e439958cb06b
modified_time: 1579204568
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 2
remaining_quantity: 2
start_time: 1572998400
subscription_id: MAN-000000ac
type: SUB-MAN
- created_time: 1579204568
end_time: 1730764800
id: 2ff9e84a-1234-5678-90ab-fb9ec0726e01
modified_time: 1579204568
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 2
remaining_quantity: 2
start_time: 1572998400
subscription_id: ENG-000000ad
type: SUB-ENG
- created_time: 1579204568
end_time: 1730764800
id: 16df7ea6-1234-5678-90ab-78018cd4024d
modified_time: 1579204568
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 2
remaining_quantity: 2
start_time: 1572998400
subscription_id: VNA-000000ae
type: SUB-VNA
- created_time: 1586237081
end_time: 1744243199
id: 1b6f68d5-1234-5678-90ab-70d3e6d18c73
modified_time: 1586237081
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 14
remaining_quantity: 14
start_time: 1586563200
subscription_id: VNA-000000af
type: SUB-VNA
- created_time: 1586237097
end_time: 1744243199
id: 1375c9bf-1234-5678-90ab-9c636708c89e
modified_time: 1586237097
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 14
remaining_quantity: 14
start_time: 1586563200
subscription_id: MAN-000000ba
type: SUB-MAN
- created_time: 1586237137
end_time: 1744243199
id: 5974e979-1234-5678-90ab-438f833ec1c9
modified_time: 1586237137
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 14
remaining_quantity: 14
start_time: 1586563200
subscription_id: ENG-000000bb
type: SUB-ENG
- created_time: 1629947267
end_time: 1744243199
id: 340a9cb3-1234-5678-90ab-b009344dbf3c
modified_time: 1629947267
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 10
remaining_quantity: 9
start_time: 1586476800
subscription_id: EX24-000000bc
type: SUB-EX24
- created_time: 1632941870
end_time: 1744156799
id: 9b599b0f-1234-5678-90ab-406081b58e7f
modified_time: 1632941870
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 10
remaining_quantity: 10
start_time: 1632873600
subscription_id: ENG-000000bd
type: SUB-ENG
- created_time: 1632941882
end_time: 1744156799
id: d6d8ead3-1234-5678-90ab-98badeac7287
modified_time: 1632941882
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 11
remaining_quantity: 9
start_time: 1632873600
subscription_id: MAN-000008be
type: SUB-MAN
summary:
SUB-ENG: 18
SUB-EX24: 3
SUB-MAN: 22
SUB-VNA: 20
contentMediaType: application/json
examples:
Example:
value:
amendments:
- created_time: 1644684842
end_time: 1744156799
id: ff0a14f6-1234-5678-90ab-c8e64d4bc6c6
modified_time: 1644684842
quantity: -1
start_time: 1632873600
subscription_id: VNA-000000af
type: SUB-VNA
- created_time: 1644684842
end_time: 1744156799
id: c1c28812-1234-5678-90ab-dc95680da61e
modified_time: 1644684842
quantity: -1
start_time: 1632873600
subscription_id: MAN-000008be
type: SUB-MAN
- created_time: 1644684842
end_time: 1744243199
id: 96c0a41f-1234-5678-90ab-afe74817e9fd
modified_time: 1644684842
quantity: -1
start_time: 1586476800
subscription_id: EX24-000000bc
type: SUB-EX24
entitled:
SUB-ENG: 26
SUB-EX24: 9
SUB-MAN: 26
SUB-VNA: 26
licenses:
- created_time: 1555353534
end_time: 1586822399
id: 693a41a6-1234-5678-90ab-f53dbd3a31c0
modified_time: 1555353534
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 2
remaining_quantity: 0
start_time: 1555286400
subscription_id: VNA-000000aa
type: SUB-VNA
- created_time: 1576132516
end_time: 1586822399
id: 656607cf-1234-5678-90ab-fc9035614ea5
modified_time: 1576132516
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 8
remaining_quantity: 0
start_time: 1576022400
subscription_id: VNA-000000ab
type: SUB-VNA
- created_time: 1579204568
end_time: 1730764800
id: db50d0bc-1234-5678-90ab-e439958cb06b
modified_time: 1579204568
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 2
remaining_quantity: 2
start_time: 1572998400
subscription_id: MAN-000000ac
type: SUB-MAN
- created_time: 1579204568
end_time: 1730764800
id: 2ff9e84a-1234-5678-90ab-fb9ec0726e01
modified_time: 1579204568
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 2
remaining_quantity: 2
start_time: 1572998400
subscription_id: ENG-000000ad
type: SUB-ENG
- created_time: 1579204568
end_time: 1730764800
id: 16df7ea6-1234-5678-90ab-78018cd4024d
modified_time: 1579204568
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 2
remaining_quantity: 2
start_time: 1572998400
subscription_id: VNA-000000ae
type: SUB-VNA
- created_time: 1586237081
end_time: 1744243199
id: 1b6f68d5-1234-5678-90ab-70d3e6d18c73
modified_time: 1586237081
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 14
remaining_quantity: 14
start_time: 1586563200
subscription_id: VNA-000000af
type: SUB-VNA
- created_time: 1586237097
end_time: 1744243199
id: 1375c9bf-1234-5678-90ab-9c636708c89e
modified_time: 1586237097
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 14
remaining_quantity: 14
start_time: 1586563200
subscription_id: MAN-000000ba
type: SUB-MAN
- created_time: 1586237137
end_time: 1744243199
id: 5974e979-1234-5678-90ab-438f833ec1c9
modified_time: 1586237137
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 14
remaining_quantity: 14
start_time: 1586563200
subscription_id: ENG-000000bb
type: SUB-ENG
- created_time: 1629947267
end_time: 1744243199
id: 340a9cb3-1234-5678-90ab-b009344dbf3c
modified_time: 1629947267
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 10
remaining_quantity: 9
start_time: 1586476800
subscription_id: EX24-000000bc
type: SUB-EX24
- created_time: 1632941870
end_time: 1744156799
id: 9b599b0f-1234-5678-90ab-406081b58e7f
modified_time: 1632941870
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 10
remaining_quantity: 10
start_time: 1632873600
subscription_id: ENG-000000bd
type: SUB-ENG
- created_time: 1632941882
end_time: 1744156799
id: d6d8ead3-1234-5678-90ab-98badeac7287
modified_time: 1632941882
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 11
remaining_quantity: 9
start_time: 1632873600
subscription_id: MAN-000008be
type: SUB-MAN
summary:
SUB-ENG: 18
SUB-EX24: 3
SUB-MAN: 22
SUB-VNA: 20
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/license'
- description: Organization license entitlement, subscription, and usage summary
examples:
- amendments:
- created_time: 1644684842
end_time: 1744156799
id: ff0a14f6-1234-5678-90ab-c8e64d4bc6c6
modified_time: 1644684842
quantity: -1
start_time: 1632873600
subscription_id: VNA-000000af
type: SUB-VNA
- created_time: 1644684842
end_time: 1744156799
id: c1c28812-1234-5678-90ab-dc95680da61e
modified_time: 1644684842
quantity: -1
start_time: 1632873600
subscription_id: MAN-000008be
type: SUB-MAN
- created_time: 1644684842
end_time: 1744243199
id: 96c0a41f-1234-5678-90ab-afe74817e9fd
modified_time: 1644684842
quantity: -1
start_time: 1586476800
subscription_id: EX24-000000bc
type: SUB-EX24
entitled:
SUB-ENG: 26
SUB-EX24: 9
SUB-MAN: 26
SUB-VNA: 26
licenses:
- created_time: 1555353534
end_time: 1586822399
id: 693a41a6-1234-5678-90ab-f53dbd3a31c0
modified_time: 1555353534
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 2
remaining_quantity: 0
start_time: 1555286400
subscription_id: VNA-000000aa
type: SUB-VNA
- created_time: 1576132516
end_time: 1586822399
id: 656607cf-1234-5678-90ab-fc9035614ea5
modified_time: 1576132516
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 8
remaining_quantity: 0
start_time: 1576022400
subscription_id: VNA-000000ab
type: SUB-VNA
- created_time: 1579204568
end_time: 1730764800
id: db50d0bc-1234-5678-90ab-e439958cb06b
modified_time: 1579204568
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 2
remaining_quantity: 2
start_time: 1572998400
subscription_id: MAN-000000ac
type: SUB-MAN
- created_time: 1579204568
end_time: 1730764800
id: 2ff9e84a-1234-5678-90ab-fb9ec0726e01
modified_time: 1579204568
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 2
remaining_quantity: 2
start_time: 1572998400
subscription_id: ENG-000000ad
type: SUB-ENG
- created_time: 1579204568
end_time: 1730764800
id: 16df7ea6-1234-5678-90ab-78018cd4024d
modified_time: 1579204568
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 2
remaining_quantity: 2
start_time: 1572998400
subscription_id: VNA-000000ae
type: SUB-VNA
- created_time: 1586237081
end_time: 1744243199
id: 1b6f68d5-1234-5678-90ab-70d3e6d18c73
modified_time: 1586237081
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 14
remaining_quantity: 14
start_time: 1586563200
subscription_id: VNA-000000af
type: SUB-VNA
- created_time: 1586237097
end_time: 1744243199
id: 1375c9bf-1234-5678-90ab-9c636708c89e
modified_time: 1586237097
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 14
remaining_quantity: 14
start_time: 1586563200
subscription_id: MAN-000000ba
type: SUB-MAN
- created_time: 1586237137
end_time: 1744243199
id: 5974e979-1234-5678-90ab-438f833ec1c9
modified_time: 1586237137
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 14
remaining_quantity: 14
start_time: 1586563200
subscription_id: ENG-000000bb
type: SUB-ENG
- created_time: 1629947267
end_time: 1744243199
id: 340a9cb3-1234-5678-90ab-b009344dbf3c
modified_time: 1629947267
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 10
remaining_quantity: 9
start_time: 1586476800
subscription_id: EX24-000000bc
type: SUB-EX24
- created_time: 1632941870
end_time: 1744156799
id: 9b599b0f-1234-5678-90ab-406081b58e7f
modified_time: 1632941870
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 10
remaining_quantity: 10
start_time: 1632873600
subscription_id: ENG-000000bd
type: SUB-ENG
- created_time: 1632941882
end_time: 1744156799
id: d6d8ead3-1234-5678-90ab-98badeac7287
modified_time: 1632941882
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 11
remaining_quantity: 9
start_time: 1632873600
subscription_id: MAN-000008be
type: SUB-MAN
summary:
SUB-ENG: 18
SUB-EX24: 3
SUB-MAN: 22
SUB-VNA: 20
contentMediaType: application/vnd.api+json
examples:
Example:
value:
amendments:
- created_time: 1644684842
end_time: 1744156799
id: ff0a14f6-1234-5678-90ab-c8e64d4bc6c6
modified_time: 1644684842
quantity: -1
start_time: 1632873600
subscription_id: VNA-000000af
type: SUB-VNA
- created_time: 1644684842
end_time: 1744156799
id: c1c28812-1234-5678-90ab-dc95680da61e
modified_time: 1644684842
quantity: -1
start_time: 1632873600
subscription_id: MAN-000008be
type: SUB-MAN
- created_time: 1644684842
end_time: 1744243199
id: 96c0a41f-1234-5678-90ab-afe74817e9fd
modified_time: 1644684842
quantity: -1
start_time: 1586476800
subscription_id: EX24-000000bc
type: SUB-EX24
entitled:
SUB-ENG: 26
SUB-EX24: 9
SUB-MAN: 26
SUB-VNA: 26
licenses:
- created_time: 1555353534
end_time: 1586822399
id: 693a41a6-1234-5678-90ab-f53dbd3a31c0
modified_time: 1555353534
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 2
remaining_quantity: 0
start_time: 1555286400
subscription_id: VNA-000000aa
type: SUB-VNA
- created_time: 1576132516
end_time: 1586822399
id: 656607cf-1234-5678-90ab-fc9035614ea5
modified_time: 1576132516
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 8
remaining_quantity: 0
start_time: 1576022400
subscription_id: VNA-000000ab
type: SUB-VNA
- created_time: 1579204568
end_time: 1730764800
id: db50d0bc-1234-5678-90ab-e439958cb06b
modified_time: 1579204568
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 2
remaining_quantity: 2
start_time: 1572998400
subscription_id: MAN-000000ac
type: SUB-MAN
- created_time: 1579204568
end_time: 1730764800
id: 2ff9e84a-1234-5678-90ab-fb9ec0726e01
modified_time: 1579204568
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 2
remaining_quantity: 2
start_time: 1572998400
subscription_id: ENG-000000ad
type: SUB-ENG
- created_time: 1579204568
end_time: 1730764800
id: 16df7ea6-1234-5678-90ab-78018cd4024d
modified_time: 1579204568
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 2
remaining_quantity: 2
start_time: 1572998400
subscription_id: VNA-000000ae
type: SUB-VNA
- created_time: 1586237081
end_time: 1744243199
id: 1b6f68d5-1234-5678-90ab-70d3e6d18c73
modified_time: 1586237081
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 14
remaining_quantity: 14
start_time: 1586563200
subscription_id: VNA-000000af
type: SUB-VNA
- created_time: 1586237097
end_time: 1744243199
id: 1375c9bf-1234-5678-90ab-9c636708c89e
modified_time: 1586237097
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 14
remaining_quantity: 14
start_time: 1586563200
subscription_id: MAN-000000ba
type: SUB-MAN
- created_time: 1586237137
end_time: 1744243199
id: 5974e979-1234-5678-90ab-438f833ec1c9
modified_time: 1586237137
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 14
remaining_quantity: 14
start_time: 1586563200
subscription_id: ENG-000000bb
type: SUB-ENG
- created_time: 1629947267
end_time: 1744243199
id: 340a9cb3-1234-5678-90ab-b009344dbf3c
modified_time: 1629947267
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 10
remaining_quantity: 9
start_time: 1586476800
subscription_id: EX24-000000bc
type: SUB-EX24
- created_time: 1632941870
end_time: 1744156799
id: 9b599b0f-1234-5678-90ab-406081b58e7f
modified_time: 1632941870
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 10
remaining_quantity: 10
start_time: 1632873600
subscription_id: ENG-000000bd
type: SUB-ENG
- created_time: 1632941882
end_time: 1744156799
id: d6d8ead3-1234-5678-90ab-98badeac7287
modified_time: 1632941882
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 11
remaining_quantity: 9
start_time: 1632873600
subscription_id: MAN-000008be
type: SUB-MAN
summary:
SUB-ENG: 18
SUB-EX24: 3
SUB-MAN: 22
SUB-VNA: 20
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- MSPs Licenses
summary: moveOrDeleteMspLicenseToAnotherOrg
description: Perform an MSP license action, such as amending license quantity to an organization, deleting a subscription, undoing an amendment, or annotating a subscription.
operationId: moveOrDeleteMspLicenseToAnotherOrg
parameters:
- name: msp_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/msp_license_action'
- examples:
- '{"op":"delete","subscription_id":"SUB-0000144"}'
- '{"dst_org_id":"3eff35f7-c218-894e-bca2-24e5325601cc","op":"amend","quantity":10,"subscription_id":"SUB-0000144"}'
- '{"amendment_id":"2b9116ab-cd1e-e897-6e08-31fccd88e792","op":"unamend"}'
contentMediaType: application/json
examples:
delete-license:
value:
op: delete
subscription_id: SUB-0000144
move-license:
value:
dst_org_id: 3eff35f7-c218-894e-bca2-24e5325601cc
op: amend
quantity: 10
subscription_id: SUB-0000144
undo-the_license_move:
value:
amendment_id: 2b9116ab-cd1e-e897-6e08-31fccd88e792
op: unamend
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/msps/{msp_id}/stats/licenses:
get:
tags:
- MSPs Licenses
summary: listMspOrgLicenses
description: Return license entitlement, subscription, amendment, and usage statistics for organizations managed by this MSP.
operationId: listMspOrgLicenses
parameters:
- name: msp_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/license'
- description: Organization license entitlement, subscription, and usage summary
examples:
- amendments:
- created_time: 1644684842
end_time: 1744156799
id: ff0a14f6-1234-5678-90ab-c8e64d4bc6c6
modified_time: 1644684842
quantity: -1
start_time: 1632873600
subscription_id: VNA-000000af
type: SUB-VNA
- created_time: 1644684842
end_time: 1744156799
id: c1c28812-1234-5678-90ab-dc95680da61e
modified_time: 1644684842
quantity: -1
start_time: 1632873600
subscription_id: MAN-000008be
type: SUB-MAN
- created_time: 1644684842
end_time: 1744243199
id: 96c0a41f-1234-5678-90ab-afe74817e9fd
modified_time: 1644684842
quantity: -1
start_time: 1586476800
subscription_id: EX24-000000bc
type: SUB-EX24
entitled:
SUB-ENG: 26
SUB-EX24: 9
SUB-MAN: 26
SUB-VNA: 26
licenses:
- created_time: 1555353534
end_time: 1586822399
id: 693a41a6-1234-5678-90ab-f53dbd3a31c0
modified_time: 1555353534
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 2
remaining_quantity: 0
start_time: 1555286400
subscription_id: VNA-000000aa
type: SUB-VNA
- created_time: 1576132516
end_time: 1586822399
id: 656607cf-1234-5678-90ab-fc9035614ea5
modified_time: 1576132516
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 8
remaining_quantity: 0
start_time: 1576022400
subscription_id: VNA-000000ab
type: SUB-VNA
- created_time: 1579204568
end_time: 1730764800
id: db50d0bc-1234-5678-90ab-e439958cb06b
modified_time: 1579204568
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 2
remaining_quantity: 2
start_time: 1572998400
subscription_id: MAN-000000ac
type: SUB-MAN
- created_time: 1579204568
end_time: 1730764800
id: 2ff9e84a-1234-5678-90ab-fb9ec0726e01
modified_time: 1579204568
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 2
remaining_quantity: 2
start_time: 1572998400
subscription_id: ENG-000000ad
type: SUB-ENG
- created_time: 1579204568
end_time: 1730764800
id: 16df7ea6-1234-5678-90ab-78018cd4024d
modified_time: 1579204568
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 2
remaining_quantity: 2
start_time: 1572998400
subscription_id: VNA-000000ae
type: SUB-VNA
- created_time: 1586237081
end_time: 1744243199
id: 1b6f68d5-1234-5678-90ab-70d3e6d18c73
modified_time: 1586237081
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 14
remaining_quantity: 14
start_time: 1586563200
subscription_id: VNA-000000af
type: SUB-VNA
- created_time: 1586237097
end_time: 1744243199
id: 1375c9bf-1234-5678-90ab-9c636708c89e
modified_time: 1586237097
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 14
remaining_quantity: 14
start_time: 1586563200
subscription_id: MAN-000000ba
type: SUB-MAN
- created_time: 1586237137
end_time: 1744243199
id: 5974e979-1234-5678-90ab-438f833ec1c9
modified_time: 1586237137
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 14
remaining_quantity: 14
start_time: 1586563200
subscription_id: ENG-000000bb
type: SUB-ENG
- created_time: 1629947267
end_time: 1744243199
id: 340a9cb3-1234-5678-90ab-b009344dbf3c
modified_time: 1629947267
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 10
remaining_quantity: 9
start_time: 1586476800
subscription_id: EX24-000000bc
type: SUB-EX24
- created_time: 1632941870
end_time: 1744156799
id: 9b599b0f-1234-5678-90ab-406081b58e7f
modified_time: 1632941870
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 10
remaining_quantity: 10
start_time: 1632873600
subscription_id: ENG-000000bd
type: SUB-ENG
- created_time: 1632941882
end_time: 1744156799
id: d6d8ead3-1234-5678-90ab-98badeac7287
modified_time: 1632941882
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 11
remaining_quantity: 9
start_time: 1632873600
subscription_id: MAN-000008be
type: SUB-MAN
summary:
SUB-ENG: 18
SUB-EX24: 3
SUB-MAN: 22
SUB-VNA: 20
contentMediaType: application/json
examples:
Example:
value:
amendments:
- created_time: 1644684842
end_time: 1744156799
id: ff0a14f6-1234-5678-90ab-c8e64d4bc6c6
modified_time: 1644684842
quantity: -1
start_time: 1632873600
subscription_id: VNA-000000af
type: SUB-VNA
- created_time: 1644684842
end_time: 1744156799
id: c1c28812-1234-5678-90ab-dc95680da61e
modified_time: 1644684842
quantity: -1
start_time: 1632873600
subscription_id: MAN-000008be
type: SUB-MAN
- created_time: 1644684842
end_time: 1744243199
id: 96c0a41f-1234-5678-90ab-afe74817e9fd
modified_time: 1644684842
quantity: -1
start_time: 1586476800
subscription_id: EX24-000000bc
type: SUB-EX24
entitled:
SUB-ENG: 26
SUB-EX24: 9
SUB-MAN: 26
SUB-VNA: 26
licenses:
- created_time: 1555353534
end_time: 1586822399
id: 693a41a6-1234-5678-90ab-f53dbd3a31c0
modified_time: 1555353534
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 2
remaining_quantity: 0
start_time: 1555286400
subscription_id: VNA-000000aa
type: SUB-VNA
- created_time: 1576132516
end_time: 1586822399
id: 656607cf-1234-5678-90ab-fc9035614ea5
modified_time: 1576132516
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 8
remaining_quantity: 0
start_time: 1576022400
subscription_id: VNA-000000ab
type: SUB-VNA
- created_time: 1579204568
end_time: 1730764800
id: db50d0bc-1234-5678-90ab-e439958cb06b
modified_time: 1579204568
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 2
remaining_quantity: 2
start_time: 1572998400
subscription_id: MAN-000000ac
type: SUB-MAN
- created_time: 1579204568
end_time: 1730764800
id: 2ff9e84a-1234-5678-90ab-fb9ec0726e01
modified_time: 1579204568
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 2
remaining_quantity: 2
start_time: 1572998400
subscription_id: ENG-000000ad
type: SUB-ENG
- created_time: 1579204568
end_time: 1730764800
id: 16df7ea6-1234-5678-90ab-78018cd4024d
modified_time: 1579204568
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 2
remaining_quantity: 2
start_time: 1572998400
subscription_id: VNA-000000ae
type: SUB-VNA
- created_time: 1586237081
end_time: 1744243199
id: 1b6f68d5-1234-5678-90ab-70d3e6d18c73
modified_time: 1586237081
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 14
remaining_quantity: 14
start_time: 1586563200
subscription_id: VNA-000000af
type: SUB-VNA
- created_time: 1586237097
end_time: 1744243199
id: 1375c9bf-1234-5678-90ab-9c636708c89e
modified_time: 1586237097
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 14
remaining_quantity: 14
start_time: 1586563200
subscription_id: MAN-000000ba
type: SUB-MAN
- created_time: 1586237137
end_time: 1744243199
id: 5974e979-1234-5678-90ab-438f833ec1c9
modified_time: 1586237137
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 14
remaining_quantity: 14
start_time: 1586563200
subscription_id: ENG-000000bb
type: SUB-ENG
- created_time: 1629947267
end_time: 1744243199
id: 340a9cb3-1234-5678-90ab-b009344dbf3c
modified_time: 1629947267
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 10
remaining_quantity: 9
start_time: 1586476800
subscription_id: EX24-000000bc
type: SUB-EX24
- created_time: 1632941870
end_time: 1744156799
id: 9b599b0f-1234-5678-90ab-406081b58e7f
modified_time: 1632941870
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 10
remaining_quantity: 10
start_time: 1632873600
subscription_id: ENG-000000bd
type: SUB-ENG
- created_time: 1632941882
end_time: 1744156799
id: d6d8ead3-1234-5678-90ab-98badeac7287
modified_time: 1632941882
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 11
remaining_quantity: 9
start_time: 1632873600
subscription_id: MAN-000008be
type: SUB-MAN
summary:
SUB-ENG: 18
SUB-EX24: 3
SUB-MAN: 22
SUB-VNA: 20
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/license'
- description: Organization license entitlement, subscription, and usage summary
examples:
- amendments:
- created_time: 1644684842
end_time: 1744156799
id: ff0a14f6-1234-5678-90ab-c8e64d4bc6c6
modified_time: 1644684842
quantity: -1
start_time: 1632873600
subscription_id: VNA-000000af
type: SUB-VNA
- created_time: 1644684842
end_time: 1744156799
id: c1c28812-1234-5678-90ab-dc95680da61e
modified_time: 1644684842
quantity: -1
start_time: 1632873600
subscription_id: MAN-000008be
type: SUB-MAN
- created_time: 1644684842
end_time: 1744243199
id: 96c0a41f-1234-5678-90ab-afe74817e9fd
modified_time: 1644684842
quantity: -1
start_time: 1586476800
subscription_id: EX24-000000bc
type: SUB-EX24
entitled:
SUB-ENG: 26
SUB-EX24: 9
SUB-MAN: 26
SUB-VNA: 26
licenses:
- created_time: 1555353534
end_time: 1586822399
id: 693a41a6-1234-5678-90ab-f53dbd3a31c0
modified_time: 1555353534
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 2
remaining_quantity: 0
start_time: 1555286400
subscription_id: VNA-000000aa
type: SUB-VNA
- created_time: 1576132516
end_time: 1586822399
id: 656607cf-1234-5678-90ab-fc9035614ea5
modified_time: 1576132516
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 8
remaining_quantity: 0
start_time: 1576022400
subscription_id: VNA-000000ab
type: SUB-VNA
- created_time: 1579204568
end_time: 1730764800
id: db50d0bc-1234-5678-90ab-e439958cb06b
modified_time: 1579204568
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 2
remaining_quantity: 2
start_time: 1572998400
subscription_id: MAN-000000ac
type: SUB-MAN
- created_time: 1579204568
end_time: 1730764800
id: 2ff9e84a-1234-5678-90ab-fb9ec0726e01
modified_time: 1579204568
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 2
remaining_quantity: 2
start_time: 1572998400
subscription_id: ENG-000000ad
type: SUB-ENG
- created_time: 1579204568
end_time: 1730764800
id: 16df7ea6-1234-5678-90ab-78018cd4024d
modified_time: 1579204568
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 2
remaining_quantity: 2
start_time: 1572998400
subscription_id: VNA-000000ae
type: SUB-VNA
- created_time: 1586237081
end_time: 1744243199
id: 1b6f68d5-1234-5678-90ab-70d3e6d18c73
modified_time: 1586237081
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 14
remaining_quantity: 14
start_time: 1586563200
subscription_id: VNA-000000af
type: SUB-VNA
- created_time: 1586237097
end_time: 1744243199
id: 1375c9bf-1234-5678-90ab-9c636708c89e
modified_time: 1586237097
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 14
remaining_quantity: 14
start_time: 1586563200
subscription_id: MAN-000000ba
type: SUB-MAN
- created_time: 1586237137
end_time: 1744243199
id: 5974e979-1234-5678-90ab-438f833ec1c9
modified_time: 1586237137
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 14
remaining_quantity: 14
start_time: 1586563200
subscription_id: ENG-000000bb
type: SUB-ENG
- created_time: 1629947267
end_time: 1744243199
id: 340a9cb3-1234-5678-90ab-b009344dbf3c
modified_time: 1629947267
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 10
remaining_quantity: 9
start_time: 1586476800
subscription_id: EX24-000000bc
type: SUB-EX24
- created_time: 1632941870
end_time: 1744156799
id: 9b599b0f-1234-5678-90ab-406081b58e7f
modified_time: 1632941870
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 10
remaining_quantity: 10
start_time: 1632873600
subscription_id: ENG-000000bd
type: SUB-ENG
- created_time: 1632941882
end_time: 1744156799
id: d6d8ead3-1234-5678-90ab-98badeac7287
modified_time: 1632941882
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 11
remaining_quantity: 9
start_time: 1632873600
subscription_id: MAN-000008be
type: SUB-MAN
summary:
SUB-ENG: 18
SUB-EX24: 3
SUB-MAN: 22
SUB-VNA: 20
contentMediaType: application/vnd.api+json
examples:
Example:
value:
amendments:
- created_time: 1644684842
end_time: 1744156799
id: ff0a14f6-1234-5678-90ab-c8e64d4bc6c6
modified_time: 1644684842
quantity: -1
start_time: 1632873600
subscription_id: VNA-000000af
type: SUB-VNA
- created_time: 1644684842
end_time: 1744156799
id: c1c28812-1234-5678-90ab-dc95680da61e
modified_time: 1644684842
quantity: -1
start_time: 1632873600
subscription_id: MAN-000008be
type: SUB-MAN
- created_time: 1644684842
end_time: 1744243199
id: 96c0a41f-1234-5678-90ab-afe74817e9fd
modified_time: 1644684842
quantity: -1
start_time: 1586476800
subscription_id: EX24-000000bc
type: SUB-EX24
entitled:
SUB-ENG: 26
SUB-EX24: 9
SUB-MAN: 26
SUB-VNA: 26
licenses:
- created_time: 1555353534
end_time: 1586822399
id: 693a41a6-1234-5678-90ab-f53dbd3a31c0
modified_time: 1555353534
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 2
remaining_quantity: 0
start_time: 1555286400
subscription_id: VNA-000000aa
type: SUB-VNA
- created_time: 1576132516
end_time: 1586822399
id: 656607cf-1234-5678-90ab-fc9035614ea5
modified_time: 1576132516
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 8
remaining_quantity: 0
start_time: 1576022400
subscription_id: VNA-000000ab
type: SUB-VNA
- created_time: 1579204568
end_time: 1730764800
id: db50d0bc-1234-5678-90ab-e439958cb06b
modified_time: 1579204568
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 2
remaining_quantity: 2
start_time: 1572998400
subscription_id: MAN-000000ac
type: SUB-MAN
- created_time: 1579204568
end_time: 1730764800
id: 2ff9e84a-1234-5678-90ab-fb9ec0726e01
modified_time: 1579204568
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 2
remaining_quantity: 2
start_time: 1572998400
subscription_id: ENG-000000ad
type: SUB-ENG
- created_time: 1579204568
end_time: 1730764800
id: 16df7ea6-1234-5678-90ab-78018cd4024d
modified_time: 1579204568
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 2
remaining_quantity: 2
start_time: 1572998400
subscription_id: VNA-000000ae
type: SUB-VNA
- created_time: 1586237081
end_time: 1744243199
id: 1b6f68d5-1234-5678-90ab-70d3e6d18c73
modified_time: 1586237081
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 14
remaining_quantity: 14
start_time: 1586563200
subscription_id: VNA-000000af
type: SUB-VNA
- created_time: 1586237097
end_time: 1744243199
id: 1375c9bf-1234-5678-90ab-9c636708c89e
modified_time: 1586237097
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 14
remaining_quantity: 14
start_time: 1586563200
subscription_id: MAN-000000ba
type: SUB-MAN
- created_time: 1586237137
end_time: 1744243199
id: 5974e979-1234-5678-90ab-438f833ec1c9
modified_time: 1586237137
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 14
remaining_quantity: 14
start_time: 1586563200
subscription_id: ENG-000000bb
type: SUB-ENG
- created_time: 1629947267
end_time: 1744243199
id: 340a9cb3-1234-5678-90ab-b009344dbf3c
modified_time: 1629947267
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 10
remaining_quantity: 9
start_time: 1586476800
subscription_id: EX24-000000bc
type: SUB-EX24
- created_time: 1632941870
end_time: 1744156799
id: 9b599b0f-1234-5678-90ab-406081b58e7f
modified_time: 1632941870
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 10
remaining_quantity: 10
start_time: 1632873600
subscription_id: ENG-000000bd
type: SUB-ENG
- created_time: 1632941882
end_time: 1744156799
id: d6d8ead3-1234-5678-90ab-98badeac7287
modified_time: 1632941882
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 11
remaining_quantity: 9
start_time: 1632873600
subscription_id: MAN-000008be
type: SUB-MAN
summary:
SUB-ENG: 18
SUB-EX24: 3
SUB-MAN: 22
SUB-VNA: 20
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/msps/{msp_id}/suggestion/count:
get:
tags:
- MSPs Marvis
summary: countMspsMarvisActions
description: Return distinct counts of Marvis actions for this MSP grouped by the requested field, such as organization or status.
operationId: countMspsMarvisActions
parameters:
- name: msp_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field used to group this count response. enum: `org_id`, `status`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/msp_marvis_suggestions_count_distinct'
- description: 'Field used to group this count response. enum: `org_id`, `status`'
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Marvis Actions Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count_marvis_actions'
- description: Distinct count response for Marvis action suggestions
examples:
- distinct: status
limit: 1000
results:
- count: 24
status: 002e176a-0000-000-1111-002e208b20e1
- count: 12
status: 2d3f176a-0000-000-2222-002e208f176a
- count: 15
status: 08b2176a-0000-000-3333-002e208b2d3f
total: 3
contentMediaType: application/json
examples:
Example:
value:
distinct: status
limit: 1000
results:
- count: 24
status: 002e176a-0000-000-1111-002e208b20e1
- count: 12
status: 2d3f176a-0000-000-2222-002e208f176a
- count: 15
status: 08b2176a-0000-000-3333-002e208b2d3f
total: 3
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count_marvis_actions'
- description: Distinct count response for Marvis action suggestions
examples:
- distinct: status
limit: 1000
results:
- count: 24
status: 002e176a-0000-000-1111-002e208b20e1
- count: 12
status: 2d3f176a-0000-000-2222-002e208f176a
- count: 15
status: 08b2176a-0000-000-3333-002e208b2d3f
total: 3
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: status
limit: 1000
results:
- count: 24
status: 002e176a-0000-000-1111-002e208b20e1
- count: 12
status: 2d3f176a-0000-000-2222-002e208f176a
- count: 15
status: 08b2176a-0000-000-3333-002e208b2d3f
total: 3
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/msps/{msp_id}/orggroups:
get:
tags:
- MSPs Org Groups
summary: listMspOrgGroups
description: List organization groups defined under this MSP. Organization groups contain related organization IDs and can be used in MSP privilege assignments.
operationId: listMspOrgGroups
parameters:
- name: msp_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/orggroup'
description: List of MSP organization groups
examples:
- - created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
org_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/json
examples:
Example:
value:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
org_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/orggroup'
description: List of MSP organization groups
examples:
- - created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
org_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
org_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- MSPs Org Groups
summary: createMspOrgGroup
description: Create an organization group under this MSP with a display name and optional list of member organization IDs.
operationId: createMspOrgGroup
parameters:
- name: msp_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/orggroup'
- description: Request Body
examples:
- name: string
org_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/json
examples:
Example:
value:
name: string
org_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/orggroup'
- description: MSP organization group containing related organizations
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
org_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
org_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/orggroup'
- description: MSP organization group containing related organizations
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
org_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
org_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/msps/{msp_id}/orggroups/{orggroup_id}:
delete:
tags:
- MSPs Org Groups
summary: deleteMspOrgGroup
description: Delete an MSP organization group. This removes the grouping object without deleting the organizations it referenced.
operationId: deleteMspOrgGroup
parameters:
- name: msp_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: orggroup_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- MSPs Org Groups
summary: getMspOrgGroup
description: Return the organization group details, including its name and member organization IDs.
operationId: getMspOrgGroup
parameters:
- name: msp_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: orggroup_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/orggroup'
- description: MSP organization group containing related organizations
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
org_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
org_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/orggroup'
- description: MSP organization group containing related organizations
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
org_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
org_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- MSPs Org Groups
summary: updateMspOrgGroup
description: Update an MSP organization group's display name or member organization IDs.
operationId: updateMspOrgGroup
parameters:
- name: msp_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: orggroup_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/orggroup'
- description: Request Body
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/orggroup'
- description: MSP organization group containing related organizations
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
org_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
org_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/orggroup'
- description: MSP organization group containing related organizations
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
org_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
org_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/msps/{msp_id}/orgs:
get:
tags:
- MSPs Orgs
summary: listMspOrgs
description: List organizations managed by this MSP account, including MSP ownership and organization-group membership metadata.
operationId: listMspOrgs
parameters:
- name: msp_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/org'
description: Organization records returned by a list response
examples:
- - alarmtemplate_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
allow_mist: true
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
session_expiry: 1440
contentMediaType: application/json
examples:
Example:
value:
- alarmtemplate_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
allow_mist: true
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
session_expiry: 1440
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/org'
description: Organization records returned by a list response
examples:
- - alarmtemplate_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
allow_mist: true
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
session_expiry: 1440
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- alarmtemplate_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
allow_mist: true
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
session_expiry: 1440
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- MSPs Orgs
summary: createMspOrg
description: Create an organization under this MSP, optionally assigning it to organization groups and setting organization-level defaults.
operationId: createMspOrg
parameters:
- name: msp_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/org'
- description: Request Body
examples:
- alarmtemplate_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
allow_mist: true
name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
session_expiry: 10
contentMediaType: application/json
examples:
Example:
value:
alarmtemplate_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
allow_mist: true
name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
session_expiry: 10
required: false
responses:
'200':
description: Org Infos
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/org'
- description: Mist organization containing sites, devices, users, and organization-level settings
examples:
- alarmtemplate_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
allow_mist: true
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
session_expiry: 1440
contentMediaType: application/json
examples:
Example:
value:
alarmtemplate_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
allow_mist: true
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
session_expiry: 1440
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/org'
- description: Mist organization containing sites, devices, users, and organization-level settings
examples:
- alarmtemplate_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
allow_mist: true
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
session_expiry: 1440
contentMediaType: application/vnd.api+json
examples:
Example:
value:
alarmtemplate_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
allow_mist: true
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
session_expiry: 1440
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- MSPs Orgs
summary: manageMspOrgs
description: Assign existing organizations to this MSP account or unassign organizations from it by providing the desired operation and org IDs.
operationId: manageMspOrgs
parameters:
- name: msp_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/msp_org_change'
- description: Request Body
examples:
- op: assign
org_ids:
- 2b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/json
examples:
Example:
value:
op: assign
org_ids:
- 2b069b358-4c97-5319-1f8c-7c5ca64d6ab1
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/msps/{msp_id}/orgs/search:
get:
tags:
- MSPs Orgs
summary: searchMspOrgs
description: Search organizations under this MSP using organization identifiers, names, subscription state, trial state, usage types, and time-based filters.
operationId: searchMspOrgs
parameters:
- name: msp_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: name
in: query
description: Filter results by name
style: form
explode: true
schema:
type: string
- name: org_id
in: query
description: Filter results by organization identifier
style: form
explode: true
schema:
type: string
contentEncoding: uuid
examples:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
- name: sub_insufficient
in: query
description: If this org has sufficient subscription
style: form
explode: true
schema:
type: boolean
examples:
- false
- name: trial_enabled
in: query
description: If this org is under trial period
style: form
explode: true
schema:
type: boolean
examples:
- false
- name: usage_types
in: query
description: List of types that enabled by usage
style: form
explode: true
schema:
uniqueItems: true
type: array
items:
type: string
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_org_search'
- description: Paginated response for MSP organization search results
examples:
- end: 1614383378.4365287
limit: 10
next: /api/v1/msps/43e96c5a-6ef6-11e6-9909-9596d1d1534f/orgs/search?end=1760601621&limit=1&search_after=%5B1760599794477%5D&start=1759996821
results:
- msp_id: d287e62f-0000-0000-0000-f2b9ba0a531f
name: Test Org
num_aps: 9
num_sites: 5
num_switches: 1
num_unassigned_aps: 1
org_id: bb1a8bf6-0000-0000-0000-8053a663cf65
sub_ana_required: 9
sub_ast_entitled: 5
sub_ast_required: 3
sub_eng_required: 3
sub_ex12_required: 1
sub_insufficient: true
sub_man_required: 9
sub_vna_entitled: 1
timestamp: 1614322563.513937
trial_enabled: false
usage_types:
- sub_eng
- msp_id: d287e62f-0000-0000-0000-f2b9ba0a531f
name: Rogue Test1
num_aps: 1
num_sites: 1
org_id: 0fb81690-0000-0000-0000-9596d1d1534f
sub_ana_entitled: 1
sub_ana_required: 1
sub_insufficient: false
sub_man_entitled: 1
sub_man_required: 1
timestamp: 1614309876.500955
start: 1613778578.4365668
total: 2
contentMediaType: application/json
examples:
Example:
value:
end: 1614383378.4365287
limit: 10
next: /api/v1/msps/43e96c5a-6ef6-11e6-9909-9596d1d1534f/orgs/search?end=1760601621&limit=1&search_after=%5B1760599794477%5D&start=1759996821
results:
- msp_id: d287e62f-0000-0000-0000-f2b9ba0a531f
name: Test Org
num_aps: 9
num_sites: 5
num_switches: 1
num_unassigned_aps: 1
org_id: bb1a8bf6-0000-0000-0000-8053a663cf65
sub_ana_required: 9
sub_ast_entitled: 5
sub_ast_required: 3
sub_eng_required: 3
sub_ex12_required: 1
sub_insufficient: true
sub_man_required: 9
sub_vna_entitled: 1
timestamp: 1614322563.513937
trial_enabled: false
usage_types:
- sub_eng
- msp_id: d287e62f-0000-0000-0000-f2b9ba0a531f
name: Rogue Test1
num_aps: 1
num_sites: 1
org_id: 0fb81690-0000-0000-0000-9596d1d1534f
sub_ana_entitled: 1
sub_ana_required: 1
sub_insufficient: false
sub_man_entitled: 1
sub_man_required: 1
timestamp: 1614309876.500955
start: 1613778578.4365668
total: 2
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_org_search'
- description: Paginated response for MSP organization search results
examples:
- end: 1614383378.4365287
limit: 10
next: /api/v1/msps/43e96c5a-6ef6-11e6-9909-9596d1d1534f/orgs/search?end=1760601621&limit=1&search_after=%5B1760599794477%5D&start=1759996821
results:
- msp_id: d287e62f-0000-0000-0000-f2b9ba0a531f
name: Test Org
num_aps: 9
num_sites: 5
num_switches: 1
num_unassigned_aps: 1
org_id: bb1a8bf6-0000-0000-0000-8053a663cf65
sub_ana_required: 9
sub_ast_entitled: 5
sub_ast_required: 3
sub_eng_required: 3
sub_ex12_required: 1
sub_insufficient: true
sub_man_required: 9
sub_vna_entitled: 1
timestamp: 1614322563.513937
trial_enabled: false
usage_types:
- sub_eng
- msp_id: d287e62f-0000-0000-0000-f2b9ba0a531f
name: Rogue Test1
num_aps: 1
num_sites: 1
org_id: 0fb81690-0000-0000-0000-9596d1d1534f
sub_ana_entitled: 1
sub_ana_required: 1
sub_insufficient: false
sub_man_entitled: 1
sub_man_required: 1
timestamp: 1614309876.500955
start: 1613778578.4365668
total: 2
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 1614383378.4365287
limit: 10
next: /api/v1/msps/43e96c5a-6ef6-11e6-9909-9596d1d1534f/orgs/search?end=1760601621&limit=1&search_after=%5B1760599794477%5D&start=1759996821
results:
- msp_id: d287e62f-0000-0000-0000-f2b9ba0a531f
name: Test Org
num_aps: 9
num_sites: 5
num_switches: 1
num_unassigned_aps: 1
org_id: bb1a8bf6-0000-0000-0000-8053a663cf65
sub_ana_required: 9
sub_ast_entitled: 5
sub_ast_required: 3
sub_eng_required: 3
sub_ex12_required: 1
sub_insufficient: true
sub_man_required: 9
sub_vna_entitled: 1
timestamp: 1614322563.513937
trial_enabled: false
usage_types:
- sub_eng
- msp_id: d287e62f-0000-0000-0000-f2b9ba0a531f
name: Rogue Test1
num_aps: 1
num_sites: 1
org_id: 0fb81690-0000-0000-0000-9596d1d1534f
sub_ana_entitled: 1
sub_ana_required: 1
sub_insufficient: false
sub_man_entitled: 1
sub_man_required: 1
timestamp: 1614309876.500955
start: 1613778578.4365668
total: 2
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/msps/{msp_id}/orgs/{org_id}:
delete:
tags:
- MSPs Orgs
summary: deleteMspOrg
description: Delete an organization managed by this MSP. Use the MSP organization assignment endpoint when only assigning or unassigning organizations from the MSP account.
operationId: deleteMspOrg
parameters:
- name: msp_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- MSPs Orgs
summary: getMspOrg
description: Return details for one organization managed by this MSP, including MSP ownership, organization groups, support access, and session settings.
operationId: getMspOrg
parameters:
- name: msp_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: Org Infos
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/org'
- description: Mist organization containing sites, devices, users, and organization-level settings
examples:
- alarmtemplate_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
allow_mist: true
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
session_expiry: 1440
contentMediaType: application/json
examples:
Example:
value:
alarmtemplate_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
allow_mist: true
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
session_expiry: 1440
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/org'
- description: Mist organization containing sites, devices, users, and organization-level settings
examples:
- alarmtemplate_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
allow_mist: true
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
session_expiry: 1440
contentMediaType: application/vnd.api+json
examples:
Example:
value:
alarmtemplate_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
allow_mist: true
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
session_expiry: 1440
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- MSPs Orgs
summary: updateMspOrg
description: Update organization settings for an organization managed by this MSP.
operationId: updateMspOrg
parameters:
- name: msp_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/org'
required: false
responses:
'200':
description: Org Infos
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/org'
- description: Mist organization containing sites, devices, users, and organization-level settings
examples:
- alarmtemplate_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
allow_mist: true
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
session_expiry: 1440
contentMediaType: application/json
examples:
Example:
value:
alarmtemplate_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
allow_mist: true
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
session_expiry: 1440
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/org'
- description: Mist organization containing sites, devices, users, and organization-level settings
examples:
- alarmtemplate_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
allow_mist: true
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
session_expiry: 1440
contentMediaType: application/vnd.api+json
examples:
Example:
value:
alarmtemplate_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
allow_mist: true
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
session_expiry: 1440
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/msps/{msp_id}/stats/orgs:
get:
tags:
- MSPs Orgs
summary: listMspOrgStats
description: List organization statistics for organizations managed by this MSP, including device, inventory, site, and SLE summary fields.
operationId: listMspOrgStats
parameters:
- name: msp_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/stats_org'
description: Organization statistics summaries returned by stats APIs
contentMediaType: application/json
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/stats_org'
description: Organization statistics summaries returned by stats APIs
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/msps/{msp_id}/insights/{metric}:
get:
tags:
- MSPs SLEs
summary: getMspSle
description: Return MSP-level SLE insight metrics for the selected metric and time range. Depending on the metric, the response can include all organizations or the worst-performing organizations in the MSP.
operationId: getMspSle
parameters:
- name: msp_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: metric
in: path
description: See [List Insight Metrics]($e/Constants%20Definitions/listInsightMetrics) for available metrics
required: true
schema:
type: string
- name: sle
in: query
description: See [List Insight Metrics]($e/Constants%20Definitions/listInsightMetrics) for more details
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: interval
in: query
description: Aggregation works by giving a time range plus interval (e.g. 1d, 1h, 10m) where aggregation function would be applied to.
style: form
explode: true
schema:
type: string
examples:
- 10m
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/insight_metrics'
- description: Insight metric response for a requested time range and aggregation interval
examples:
- end: 1643706000
interval: 3600
limit: 100
results:
- ap-availability: 0.9919400860511628
ap-health: 0.967607512909879
capacity: 0.7484652273070254
coverage: 0.91217567374857
num_aps: 13
num_clients: 12
org_id: ab0aca7a-d45c-469b-b3bb-4fe240642d0b
roaming: 0.991735537682683
roaming-exp: 0.991735537682683
successful-connect: 0.46052632135780236
throughput: 0.6775702123846302
time-to-connect: 0.9349112447196916
- ap-availability: 0.9990384613092129
ap-health: 0.48201754375507955
capacity: 0.9702673450306101
coverage: 0.8335392334930375
num_aps: 1
num_clients: 6
org_id: 49ff76e0-a283-4e7d-b38d-041f1e9aff3c
roaming: 1
roaming-exp: 1
successful-connect: 1
throughput: 0
time-to-connect: 1
- ap-availability: 1
ap-health: 0.982456140612301
capacity: 1
coverage: 0.9276041182442488
num_aps: 2
num_clients: 3
org_id: 9b9b48f1-15a4-459e-86cc-9cbec9005983
roaming: 1
roaming-exp: 1
successful-connect: 1
throughput: 1
time-to-connect: 0.8125
- ap-availability: 0.9981132070973234
ap-health: 0.9991228068084047
capacity: 1
coverage: 1
num_aps: 1
num_clients: 0
org_id: eb0e1671-7a6b-472b-94c3-c187dafe5274
roaming: 1
roaming-exp: 1
successful-connect: 1
throughput: 0
time-to-connect: 0.5
start: 1643670000
contentMediaType: application/json
examples:
Orgs Sle:
value:
end: 1643706000
interval: 3600
limit: 100
results:
- ap-availability: 0.9919400860511628
ap-health: 0.967607512909879
capacity: 0.7484652273070254
coverage: 0.91217567374857
num_aps: 13
num_clients: 12
org_id: ab0aca7a-d45c-469b-b3bb-4fe240642d0b
roaming: 0.991735537682683
roaming-exp: 0.991735537682683
successful-connect: 0.46052632135780236
throughput: 0.6775702123846302
time-to-connect: 0.9349112447196916
- ap-availability: 0.9990384613092129
ap-health: 0.48201754375507955
capacity: 0.9702673450306101
coverage: 0.8335392334930375
num_aps: 1
num_clients: 6
org_id: 49ff76e0-a283-4e7d-b38d-041f1e9aff3c
roaming: 1
roaming-exp: 1
successful-connect: 1
throughput: 0
time-to-connect: 1
- ap-availability: 1
ap-health: 0.982456140612301
capacity: 1
coverage: 0.9276041182442488
num_aps: 2
num_clients: 3
org_id: 9b9b48f1-15a4-459e-86cc-9cbec9005983
roaming: 1
roaming-exp: 1
successful-connect: 1
throughput: 1
time-to-connect: 0.8125
- ap-availability: 0.9981132070973234
ap-health: 0.9991228068084047
capacity: 1
coverage: 1
num_aps: 1
num_clients: 0
org_id: eb0e1671-7a6b-472b-94c3-c187dafe5274
roaming: 1
roaming-exp: 1
successful-connect: 1
throughput: 0
time-to-connect: 0.5
start: 1643670000
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/insight_metrics'
- description: Insight metric response for a requested time range and aggregation interval
examples:
- end: 1643706000
interval: 3600
limit: 100
results:
- ap-availability: 0.9919400860511628
ap-health: 0.967607512909879
capacity: 0.7484652273070254
coverage: 0.91217567374857
num_aps: 13
num_clients: 12
org_id: ab0aca7a-d45c-469b-b3bb-4fe240642d0b
roaming: 0.991735537682683
roaming-exp: 0.991735537682683
successful-connect: 0.46052632135780236
throughput: 0.6775702123846302
time-to-connect: 0.9349112447196916
- ap-availability: 0.9990384613092129
ap-health: 0.48201754375507955
capacity: 0.9702673450306101
coverage: 0.8335392334930375
num_aps: 1
num_clients: 6
org_id: 49ff76e0-a283-4e7d-b38d-041f1e9aff3c
roaming: 1
roaming-exp: 1
successful-connect: 1
throughput: 0
time-to-connect: 1
- ap-availability: 1
ap-health: 0.982456140612301
capacity: 1
coverage: 0.9276041182442488
num_aps: 2
num_clients: 3
org_id: 9b9b48f1-15a4-459e-86cc-9cbec9005983
roaming: 1
roaming-exp: 1
successful-connect: 1
throughput: 1
time-to-connect: 0.8125
- ap-availability: 0.9981132070973234
ap-health: 0.9991228068084047
capacity: 1
coverage: 1
num_aps: 1
num_clients: 0
org_id: eb0e1671-7a6b-472b-94c3-c187dafe5274
roaming: 1
roaming-exp: 1
successful-connect: 1
throughput: 0
time-to-connect: 0.5
start: 1643670000
contentMediaType: application/vnd.api+json
examples:
Orgs Sle:
value:
end: 1643706000
interval: 3600
limit: 100
results:
- ap-availability: 0.9919400860511628
ap-health: 0.967607512909879
capacity: 0.7484652273070254
coverage: 0.91217567374857
num_aps: 13
num_clients: 12
org_id: ab0aca7a-d45c-469b-b3bb-4fe240642d0b
roaming: 0.991735537682683
roaming-exp: 0.991735537682683
successful-connect: 0.46052632135780236
throughput: 0.6775702123846302
time-to-connect: 0.9349112447196916
- ap-availability: 0.9990384613092129
ap-health: 0.48201754375507955
capacity: 0.9702673450306101
coverage: 0.8335392334930375
num_aps: 1
num_clients: 6
org_id: 49ff76e0-a283-4e7d-b38d-041f1e9aff3c
roaming: 1
roaming-exp: 1
successful-connect: 1
throughput: 0
time-to-connect: 1
- ap-availability: 1
ap-health: 0.982456140612301
capacity: 1
coverage: 0.9276041182442488
num_aps: 2
num_clients: 3
org_id: 9b9b48f1-15a4-459e-86cc-9cbec9005983
roaming: 1
roaming-exp: 1
successful-connect: 1
throughput: 1
time-to-connect: 0.8125
- ap-availability: 0.9981132070973234
ap-health: 0.9991228068084047
capacity: 1
coverage: 1
num_aps: 1
num_clients: 0
org_id: eb0e1671-7a6b-472b-94c3-c187dafe5274
roaming: 1
roaming-exp: 1
successful-connect: 1
throughput: 0
time-to-connect: 0.5
start: 1643670000
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/msps/{msp_id}/ssoroles:
get:
tags:
- MSPs SSO Roles
summary: listMspSsoRoles
description: List MSP SSO role definitions that map identity-provider role assertions to MSP privilege scopes.
operationId: listMspSsoRoles
parameters:
- name: msp_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/sso_role_msp'
description: MSP SSO roles returned by the request
contentMediaType: application/json
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/sso_role_msp'
description: MSP SSO roles returned by the request
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- MSPs SSO Roles
summary: createMspSsoRole
description: Create an MSP SSO role definition with a display name and the MSP privileges granted when the role is matched during SSO.
operationId: createMspSsoRole
parameters:
- name: msp_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sso_role_msp'
- description: Request Body
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sso_role_msp'
- description: MSP SSO role definition
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
privileges:
- orggroup_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
role: read
scope: orggroup
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
privileges:
- orggroup_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
role: read
scope: orggroup
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/sso_role_msp'
- description: MSP SSO role definition
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
privileges:
- orggroup_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
role: read
scope: orggroup
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
privileges:
- orggroup_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
role: read
scope: orggroup
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/msps/{msp_id}/ssoroles/{ssorole_id}:
delete:
tags:
- MSPs SSO Roles
summary: deleteMspSsoRole
description: Delete an MSP SSO role definition so it can no longer grant MSP privileges during SSO.
operationId: deleteMspSsoRole
parameters:
- name: msp_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: ssorole_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- MSPs SSO Roles
summary: updateMspSsoRole
description: Update an MSP SSO role definition, including its display name and granted MSP privileges.
operationId: updateMspSsoRole
parameters:
- name: msp_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: ssorole_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sso_role_msp'
- description: Request Body
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sso_role_msp'
- description: MSP SSO role definition
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
privileges:
- orggroup_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
role: read
scope: orggroup
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
privileges:
- orggroup_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
role: read
scope: orggroup
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/sso_role_msp'
- description: MSP SSO role definition
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
privileges:
- orggroup_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
role: read
scope: orggroup
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
privileges:
- orggroup_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
role: read
scope: orggroup
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/msps/{msp_id}/ssos:
get:
tags:
- MSPs SSO
summary: listMspSsos
description: List SSO identity provider configurations defined for this MSP.
operationId: listMspSsos
parameters:
- name: msp_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/sso'
description: List of SSO configurations
examples:
- - created_time: 0
custom_logout_url: string
default_role: string
domain: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
idp_cert: string
idp_sign_algo: sha256
idp_sso_url: string
ignore_unmatched_roles: true
issuer: string
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
nameid_format: email
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
type: string
contentMediaType: application/json
examples:
Example:
value:
- created_time: 0
custom_logout_url: string
default_role: string
domain: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
idp_cert: string
idp_sign_algo: sha256
idp_sso_url: string
ignore_unmatched_roles: true
issuer: string
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
nameid_format: email
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
type: string
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/sso'
description: List of SSO configurations
examples:
- - created_time: 0
custom_logout_url: string
default_role: string
domain: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
idp_cert: string
idp_sign_algo: sha256
idp_sso_url: string
ignore_unmatched_roles: true
issuer: string
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
nameid_format: email
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
type: string
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- created_time: 0
custom_logout_url: string
default_role: string
domain: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
idp_cert: string
idp_sign_algo: sha256
idp_sso_url: string
ignore_unmatched_roles: true
issuer: string
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
nameid_format: email
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
type: string
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- MSPs SSO
summary: createMspSso
description: Create an MSP SSO identity provider configuration, including provider settings and role-handling behavior.
operationId: createMspSso
parameters:
- name: msp_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sso'
- description: Request Body
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sso'
- description: Single sign-on identity provider configuration
examples:
- created_time: 0
custom_logout_url: string
default_role: string
domain: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
idp_cert: string
idp_sign_algo: sha256
idp_sso_url: string
ignore_unmatched_roles: true
issuer: string
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
nameid_format: email
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
type: string
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
custom_logout_url: string
default_role: string
domain: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
idp_cert: string
idp_sign_algo: sha256
idp_sso_url: string
ignore_unmatched_roles: true
issuer: string
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
nameid_format: email
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
type: string
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/sso'
- description: Single sign-on identity provider configuration
examples:
- created_time: 0
custom_logout_url: string
default_role: string
domain: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
idp_cert: string
idp_sign_algo: sha256
idp_sso_url: string
ignore_unmatched_roles: true
issuer: string
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
nameid_format: email
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
type: string
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
custom_logout_url: string
default_role: string
domain: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
idp_cert: string
idp_sign_algo: sha256
idp_sso_url: string
ignore_unmatched_roles: true
issuer: string
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
nameid_format: email
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
type: string
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/msps/{msp_id}/ssos/{sso_id}:
delete:
tags:
- MSPs SSO
summary: deleteMspSso
description: Delete an MSP SSO identity provider configuration so it can no longer be used for administrator login.
operationId: deleteMspSso
parameters:
- name: msp_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: sso_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- MSPs SSO
summary: getMspSso
description: Return one MSP SSO identity provider configuration, including provider settings and generated SSO URLs.
operationId: getMspSso
parameters:
- name: msp_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: sso_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sso'
- description: Single sign-on identity provider configuration
examples:
- created_time: 0
custom_logout_url: string
default_role: string
domain: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
idp_cert: string
idp_sign_algo: sha256
idp_sso_url: string
ignore_unmatched_roles: true
issuer: string
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
nameid_format: email
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
type: string
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
custom_logout_url: string
default_role: string
domain: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
idp_cert: string
idp_sign_algo: sha256
idp_sso_url: string
ignore_unmatched_roles: true
issuer: string
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
nameid_format: email
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
type: string
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/sso'
- description: Single sign-on identity provider configuration
examples:
- created_time: 0
custom_logout_url: string
default_role: string
domain: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
idp_cert: string
idp_sign_algo: sha256
idp_sso_url: string
ignore_unmatched_roles: true
issuer: string
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
nameid_format: email
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
type: string
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
custom_logout_url: string
default_role: string
domain: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
idp_cert: string
idp_sign_algo: sha256
idp_sso_url: string
ignore_unmatched_roles: true
issuer: string
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
nameid_format: email
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
type: string
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- MSPs SSO
summary: updateMspSso
description: Update an MSP SSO identity provider configuration, such as IdP URLs, certificates, issuer, NameID format, and unmatched-role handling.
operationId: updateMspSso
parameters:
- name: msp_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: sso_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sso'
- description: Request Body
examples:
- custom_logout_url: string
idp_cert: string
idp_sign_algo: sha256
idp_sso_url: string
ignore_unmatched_roles: true
issuer: string
name: string
nameid_format: email
contentMediaType: application/json
examples:
Example:
value:
custom_logout_url: string
idp_cert: string
idp_sign_algo: sha256
idp_sso_url: string
ignore_unmatched_roles: true
issuer: string
name: string
nameid_format: email
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sso'
- description: Single sign-on identity provider configuration
examples:
- created_time: 0
custom_logout_url: string
default_role: string
domain: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
idp_cert: string
idp_sign_algo: sha256
idp_sso_url: string
ignore_unmatched_roles: true
issuer: string
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
nameid_format: email
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
type: string
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
custom_logout_url: string
default_role: string
domain: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
idp_cert: string
idp_sign_algo: sha256
idp_sso_url: string
ignore_unmatched_roles: true
issuer: string
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
nameid_format: email
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
type: string
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/sso'
- description: Single sign-on identity provider configuration
examples:
- created_time: 0
custom_logout_url: string
default_role: string
domain: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
idp_cert: string
idp_sign_algo: sha256
idp_sso_url: string
ignore_unmatched_roles: true
issuer: string
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
nameid_format: email
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
type: string
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
custom_logout_url: string
default_role: string
domain: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
idp_cert: string
idp_sign_algo: sha256
idp_sso_url: string
ignore_unmatched_roles: true
issuer: string
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
nameid_format: email
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
type: string
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/msps/{msp_id}/ssos/{sso_id}/delete_admins:
post:
tags:
- MSPs SSO
summary: deleteMspSsoAdmins
description: Remove SSO-linked MSP administrator accounts by email for this SSO profile.
operationId: deleteMspSsoAdmins
parameters:
- name: msp_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: sso_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sso_delete_admins'
- description: Request Body
examples:
- emails:
- john@abc.com
- may@abc.com
contentMediaType: application/json
examples:
Example:
value:
emails:
- john@abc.com
- may@abc.com
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sso_delete_admins_response'
- description: Result of deleting SSO admin accounts
contentMediaType: application/json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/msps/{msp_id}/ssos/{sso_id}/failures:
get:
tags:
- MSPs SSO
summary: listMspSsoLatestFailures
description: List recent authentication failures for this MSP SSO configuration, including failure details and captured SAML assertion data when available.
operationId: listMspSsoLatestFailures
parameters:
- name: msp_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: sso_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_sso_failure_search'
- description: Response containing recent SSO authentication failure records
examples:
- results:
- detail: string
saml_assertion_xml: string
timestamp: 0
contentMediaType: application/json
examples:
Example:
value:
results:
- detail: string
saml_assertion_xml: string
timestamp: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_sso_failure_search'
- description: Response containing recent SSO authentication failure records
examples:
- results:
- detail: string
saml_assertion_xml: string
timestamp: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
results:
- detail: string
saml_assertion_xml: string
timestamp: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/msps/{msp_id}/ssos/{sso_id}/metadata:
get:
tags:
- MSPs SSO
summary: getMspSamlMetadata
description: Return generated SAML service provider metadata for this MSP SSO configuration as JSON.
operationId: getMspSamlMetadata
parameters:
- name: msp_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: sso_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/saml_metadata'
- description: Read-only SAML and SCIM metadata generated for an SSO configuration
examples:
- acs_url: https://api.mist.com/api/v1/saml/llDfa13f/login
entity_id: https://api.mist.com/api/v1/saml/llDfa13f/login
logout_url: https://api.mist.com/api/v1/saml/llDfa13f/logout
metadata: urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified
contentMediaType: application/json
examples:
Example:
value:
acs_url: https://api.mist.com/api/v1/saml/llDfa13f/login
entity_id: https://api.mist.com/api/v1/saml/llDfa13f/login
logout_url: https://api.mist.com/api/v1/saml/llDfa13f/logout
metadata: urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/saml_metadata'
- description: Read-only SAML and SCIM metadata generated for an SSO configuration
examples:
- acs_url: https://api.mist.com/api/v1/saml/llDfa13f/login
entity_id: https://api.mist.com/api/v1/saml/llDfa13f/login
logout_url: https://api.mist.com/api/v1/saml/llDfa13f/logout
metadata: urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified
contentMediaType: application/vnd.api+json
examples:
Example:
value:
acs_url: https://api.mist.com/api/v1/saml/llDfa13f/login
entity_id: https://api.mist.com/api/v1/saml/llDfa13f/login
logout_url: https://api.mist.com/api/v1/saml/llDfa13f/logout
metadata: urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/msps/{msp_id}/ssos/{sso_id}/metadata.xml:
get:
tags:
- MSPs SSO
summary: downloadMspSamlMetadata
description: >-
Download generated SAML service provider metadata XML for this MSP SSO configuration.
Example of metadata.xml:
```xml
urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified
Mist
```
operationId: downloadMspSamlMetadata
parameters:
- name: msp_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: sso_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: string
description: File
contentEncoding: base64
contentMediaType: application/json
application/vnd.api+json:
schema:
type: string
description: File
contentEncoding: base64
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/msps/{msp_id}/tickets:
get:
tags:
- MSPs Tickets
summary: listMspTickets
description: List support tickets associated with this MSP for the requested time range.
operationId: listMspTickets
parameters:
- name: msp_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/ticket'
description: Support ticket records returned by a ticket list response
examples:
- - comments:
- attachments:
- content_type: string
content_url: string
author: string
comment: string
created_at: 0
created_at: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
requester: string
status: open
subject: string
type: string
updated_at: 0
contentMediaType: application/json
examples:
Example:
value:
- comments:
- attachments:
- content_type: string
content_url: string
author: string
comment: string
created_at: 0
created_at: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
requester: string
status: open
subject: string
type: string
updated_at: 0
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/ticket'
description: Support ticket records returned by a ticket list response
examples:
- - comments:
- attachments:
- content_type: string
content_url: string
author: string
comment: string
created_at: 0
created_at: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
requester: string
status: open
subject: string
type: string
updated_at: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- comments:
- attachments:
- content_type: string
content_url: string
author: string
comment: string
created_at: 0
created_at: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
requester: string
status: open
subject: string
type: string
updated_at: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/msps/{msp_id}/tickets/count:
get:
tags:
- MSPs Tickets
summary: countMspTickets
description: Return distinct counts of MSP support tickets grouped by the requested field, such as organization, status, or ticket type.
operationId: countMspTickets
parameters:
- name: msp_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field used to group this count response. enum: `org_id`, `status`, `type`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/msp_tickets_count_distinct'
- description: 'Field used to group this count response. enum: `org_id`, `status`, `type`'
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs:
post:
tags:
- Orgs
summary: createOrg
description: Create a Mist organization with organization-level defaults such as display name, support-access setting, default alarm template, and admin session lifetime.
operationId: createOrg
parameters: []
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/org'
- examples:
- alarmtemplate_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
allow_mist: true
name: string
session_expiry: 1440
contentMediaType: application/json
examples:
Example:
value:
alarmtemplate_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
allow_mist: true
name: string
session_expiry: 1440
required: false
responses:
'200':
description: Org Infos
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/org'
- description: Mist organization containing sites, devices, users, and organization-level settings
examples:
- alarmtemplate_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
allow_mist: true
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
session_expiry: 1440
contentMediaType: application/json
examples:
Example:
value:
alarmtemplate_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
allow_mist: true
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
session_expiry: 1440
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/org'
- description: Mist organization containing sites, devices, users, and organization-level settings
examples:
- alarmtemplate_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
allow_mist: true
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
session_expiry: 1440
contentMediaType: application/vnd.api+json
examples:
Example:
value:
alarmtemplate_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
allow_mist: true
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
session_expiry: 1440
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}:
delete:
tags:
- Orgs
summary: deleteOrg
description: Delete an organization and its organization-level resources. Use MSP organization assignment endpoints when only changing MSP ownership or association. This action is only allowed when the Organization Inventory is empty.
operationId: deleteOrg
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Orgs
summary: getOrg
description: Return organization details, including name, MSP ownership, organization group membership, support-access setting, and session settings.
operationId: getOrg
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: Org Infos
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/org'
- description: Mist organization containing sites, devices, users, and organization-level settings
examples:
- alarmtemplate_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
allow_mist: true
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
session_expiry: 1440
contentMediaType: application/json
examples:
Example:
value:
alarmtemplate_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
allow_mist: true
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
session_expiry: 1440
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/org'
- description: Mist organization containing sites, devices, users, and organization-level settings
examples:
- alarmtemplate_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
allow_mist: true
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
session_expiry: 1440
contentMediaType: application/vnd.api+json
examples:
Example:
value:
alarmtemplate_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
allow_mist: true
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
session_expiry: 1440
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Orgs
summary: updateOrg
description: Update organization-level settings such as display name, support-access setting, organization groups, default alarm template, or admin session lifetime.
operationId: updateOrg
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/org'
- description: Request Body
examples:
- alarmtemplate_id: 1984805d-2be2-4aec-a8d4-3ddf67fab0df
allow_mist: true
name: string
orggroup_ids: []
session_expiry: 1440
contentMediaType: application/json
examples:
Example:
value:
alarmtemplate_id: 1984805d-2be2-4aec-a8d4-3ddf67fab0df
allow_mist: true
name: string
orggroup_ids: []
session_expiry: 1440
required: false
responses:
'200':
description: Org Infos
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/org'
- description: Mist organization containing sites, devices, users, and organization-level settings
examples:
- alarmtemplate_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
allow_mist: true
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
session_expiry: 1440
contentMediaType: application/json
examples:
Example:
value:
alarmtemplate_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
allow_mist: true
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
session_expiry: 1440
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/org'
- description: Mist organization containing sites, devices, users, and organization-level settings
examples:
- alarmtemplate_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
allow_mist: true
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
session_expiry: 1440
contentMediaType: application/vnd.api+json
examples:
Example:
value:
alarmtemplate_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
allow_mist: true
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
session_expiry: 1440
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/clone:
post:
tags:
- Orgs
summary: cloneOrg
description: Create an Org by cloning from another one. Org Settings, Templates, Wxlan Tags, Wxlan Tunnels, Wxlan Rules, Org Wlans will be copied. Sites and Site Groups will not be copied, and therefore, the copied template will not be applied to any site/sitegroups.
operationId: cloneOrg
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/name_string'
- description: Request Body
examples:
- name: New Org
contentMediaType: application/json
examples:
Example:
value:
name: New Org
required: false
responses:
'200':
description: Org Infos
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/org'
- description: Mist organization containing sites, devices, users, and organization-level settings
examples:
- alarmtemplate_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
allow_mist: true
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
session_expiry: 1440
contentMediaType: application/json
examples:
Example:
value:
alarmtemplate_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
allow_mist: true
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
session_expiry: 1440
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/org'
- description: Mist organization containing sites, devices, users, and organization-level settings
examples:
- alarmtemplate_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
allow_mist: true
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
session_expiry: 1440
contentMediaType: application/vnd.api+json
examples:
Example:
value:
alarmtemplate_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
allow_mist: true
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
session_expiry: 1440
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/admins:
get:
tags:
- Orgs Admins
summary: listOrgAdmins
description: List administrators that have privileges in this organization hierarchy, including organization, site, or site group scopes.
operationId: listOrgAdmins
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/admin'
description: List of Mist administrator accounts
examples:
- '[{"admin_id":"456b7016-a916-a4b1-78dd-72b947c152b7","email":"jsmith@mycorp.org","first_name":"Joe","last_name":"Smith","privileges":[{"role":"admin","scope":"msp"},{"org_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","role":"admin","scope":"org"},{"orggroup_ids":["507f1bab-13ba-73e2-f291-2bcb8d1362b0"],"role":"read","scope":"orggroup"}]}]'
- '[{"admin_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","email":"user@example.com","first_name":"string","last_name":"string","privileges":[{"msp_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","msp_name":"string","name":"string","org_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","org_name":"string","orggroup_ids":["b069b358-4c97-5319-1f8c-7c5ca64d6ab1"],"role":"admin","scope":"org","site_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","sitegroup_ids":["6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9"]}]}]'
contentMediaType: application/json
examples:
Example:
value:
- admin_id: 456b7016-a916-a4b1-78dd-72b947c152b7
email: jsmith@mycorp.org
first_name: Joe
last_name: Smith
privileges:
- role: admin
scope: msp
- org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
role: admin
scope: org
- orggroup_ids:
- 507f1bab-13ba-73e2-f291-2bcb8d1362b0
role: read
scope: orggroup
Example2:
value:
- admin_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
email: user@example.com
first_name: string
last_name: string
privileges:
- msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
msp_name: string
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
org_name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
role: admin
scope: org
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
application/vnd.api+json:
schema:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/admin'
description: List of Mist administrator accounts
examples:
- '[{"admin_id":"456b7016-a916-a4b1-78dd-72b947c152b7","email":"jsmith@mycorp.org","first_name":"Joe","last_name":"Smith","privileges":[{"role":"admin","scope":"msp"},{"org_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","role":"admin","scope":"org"},{"orggroup_ids":["507f1bab-13ba-73e2-f291-2bcb8d1362b0"],"role":"read","scope":"orggroup"}]}]'
- '[{"admin_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","email":"user@example.com","first_name":"string","last_name":"string","privileges":[{"msp_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","msp_name":"string","name":"string","org_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","org_name":"string","orggroup_ids":["b069b358-4c97-5319-1f8c-7c5ca64d6ab1"],"role":"admin","scope":"org","site_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","sitegroup_ids":["6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9"]}]}]'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- admin_id: 456b7016-a916-a4b1-78dd-72b947c152b7
email: jsmith@mycorp.org
first_name: Joe
last_name: Smith
privileges:
- role: admin
scope: msp
- org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
role: admin
scope: org
- orggroup_ids:
- 507f1bab-13ba-73e2-f291-2bcb8d1362b0
role: read
scope: orggroup
Example2:
value:
- admin_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
email: user@example.com
first_name: string
last_name: string
privileges:
- msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
msp_name: string
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
org_name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
role: admin
scope: org
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/admins/{admin_id}:
delete:
tags:
- Orgs Admins
summary: revokeOrgAdmin
description: Remove all privileges this administrator has in the organization hierarchy. This does not delete the administrator account.
operationId: revokeOrgAdmin
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: admin_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Orgs Admins
summary: updateOrgAdmin
description: Update identity fields and privilege assignments for an existing administrator under this organization.
operationId: updateOrgAdmin
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: admin_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/admin'
- description: Request Body
examples:
- '{"email":"jsnow@abc.com","expire_time":0,"first_name":"John","hours":24,"last_name":"Sno","phone":"string","phone2":"string","privileges":[{"msp_id":"c0cf23fc-d82f-4219-988c-82fb61d8c875","name":"string","org_id":"a40f5d1f-d889-42e9-94ea-b9b33585fc6b","org_name":"string","orggroup_ids":["497f6eca-6276-4993-bfeb-53d5bbba6f08"],"role":"admin","scope":"org","site_id":"72771e6a-6f5e-4de4-a5b9-1266c4197811","sitegroup_ids":["497f6eca-6276-4993-bfeb-53d6bbba6f08"],"views":["switch_admin"]}]}'
contentMediaType: application/json
examples:
Example:
value:
email: jsnow@abc.com
expire_time: 0
first_name: John
hours: 24
last_name: Sno
phone: string
phone2: string
privileges:
- msp_id: c0cf23fc-d82f-4219-988c-82fb61d8c875
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
org_name: string
orggroup_ids:
- 497f6eca-6276-4993-bfeb-53d5bbba6f08
role: admin
scope: org
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
sitegroup_ids:
- 497f6eca-6276-4993-bfeb-53d6bbba6f08
views:
- switch_admin
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/admin'
- description: Mist administrator account or organization API token details
examples:
- admin_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
email: user@example.com
first_name: string
last_name: string
password_modified_time: 1656353525
privileges:
- msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
msp_name: string
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
org_name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
role: admin
scope: org
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
contentMediaType: application/json
examples:
Example:
value:
admin_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
email: user@example.com
first_name: string
last_name: string
password_modified_time: 1656353525
privileges:
- msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
msp_name: string
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
org_name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
role: admin
scope: org
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/admin'
- description: Mist administrator account or organization API token details
examples:
- admin_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
email: user@example.com
first_name: string
last_name: string
password_modified_time: 1656353525
privileges:
- msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
msp_name: string
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
org_name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
role: admin
scope: org
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
contentMediaType: application/vnd.api+json
examples:
Example:
value:
admin_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
email: user@example.com
first_name: string
last_name: string
password_modified_time: 1656353525
privileges:
- msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
msp_name: string
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
org_name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
role: admin
scope: org
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/invites:
post:
tags:
- Orgs Admins
summary: inviteOrgAdmin
description: If the request is successful, an email will also be sent to the user with a link to ```https://manage.mist.com/verify/invite?token=:token&expire=1459632743&org=OrgName```
operationId: inviteOrgAdmin
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/admin'
- description: Request Body
examples:
- '{"email":"user@example.com","first_name":"string","last_name":"string","privileges":[{"msp_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","msp_name":"string","name":"string","org_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","org_name":"string","orggroup_ids":["b069b358-4c97-5319-1f8c-7c5ca64d6ab1"],"role":"admin","scope":"org","site_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","sitegroup_ids":["b069b358-4c97-5319-1f8c-7c5ca64d6ab1"]}]}'
contentMediaType: application/json
examples:
Example:
value:
email: user@example.com
first_name: string
last_name: string
privileges:
- msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
msp_name: string
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
org_name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
role: admin
scope: org
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/invites/{invite_id}:
delete:
tags:
- Orgs Admins
summary: uninviteOrgAdmin
description: Cancel a pending organization admin invite by invite ID.
operationId: uninviteOrgAdmin
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: invite_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Orgs Admins
summary: updateOrgAdminInvite
description: Update a pending organization admin invite, including invitee identity and requested privileges.
operationId: updateOrgAdminInvite
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: invite_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/admin'
- description: Request Body
examples:
- '{"email":"user@example.com","first_name":"string","last_name":"string","privileges":[{"msp_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","msp_name":"string","name":"string","org_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","org_name":"string","orggroup_ids":["b069b358-4c97-5319-1f8c-7c5ca64d6ab1"],"role":"admin","scope":"org","site_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","sitegroup_ids":["b069b358-4c97-5319-1f8c-7c5ca64d6ab1"]}]}'
contentMediaType: application/json
examples:
Example:
value:
email: user@example.com
first_name: string
last_name: string
privileges:
- msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
msp_name: string
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
org_name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
role: admin
scope: org
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/alarms/ack:
post:
tags:
- Orgs Alarms
summary: ackOrgMultipleAlarms
description: Acknowledge multiple organization alarms by alarm ID and optionally attach a note to the acknowledgement.
operationId: ackOrgMultipleAlarms
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/alarms'
- description: Request Body
examples:
- alarm_ids:
- ccb8c94d-ca56-4075-932f-1f2ab444ff2c
- 98ff4a3d-ec9b-4138-a42e-54fc3335179d
note: maintenance window
contentMediaType: application/json
examples:
Example:
value:
alarm_ids:
- ccb8c94d-ca56-4075-932f-1f2ab444ff2c
- 98ff4a3d-ec9b-4138-a42e-54fc3335179d
note: maintenance window
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/alarms/ack_all:
post:
tags:
- Orgs Alarms
summary: ackOrgAllAlarms
description: Acknowledge all alarms in the organization and optionally attach a note. For targeted bulk updates, use [Ack Org Multiple Alarms]($e/Orgs%20Alarms/ackOrgMultipleAlarms) with up to 1000 alarm IDs per request.
operationId: ackOrgAllAlarms
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/note_string'
- examples:
- note: string
contentMediaType: application/json
examples:
Example:
value:
note: string
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/alarms/count:
get:
tags:
- Orgs Alarms
summary: countOrgAlarms
description: Count alarms across the organization, optionally grouped by the `distinct` field and filtered by time range.
operationId: countOrgAlarms
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: Field used to group this count response
style: form
explode: true
schema:
type: string
examples:
- site_id
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/alarms/search:
get:
tags:
- Orgs Alarms
summary: searchOrgAlarms
description: Search alarms across the organization with filters for site, alarm group, severity, type, acknowledgement state, acknowledgement admin, and time range.
operationId: searchOrgAlarms
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: site_id
in: query
description: Filter results by site identifier. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- 00000000-0000-0000-0000-000000000001,00000000-0000-0000-0000-000000000002
- 72771e6a-6f5e-4de4-a5b9-1266c4197811
examples:
Untitled Example1:
value: 00000000-0000-0000-0000-000000000001,00000000-0000-0000-0000-000000000002
Untitled Example2:
value: 72771e6a-6f5e-4de4-a5b9-1266c4197811
- name: group
in: query
description: 'Alarm group used to filter alarm results. enum: `certificate_expiry`, `infrastructure`, `marvis`, `security`. The `marvis` group is used to retrieve AI-driven network issue detections. Known Marvis alarm types include: `bad_cable`, `bad_wan_uplink`, `dns_failure`, `arp_failure`, `auth_failure`, `dhcp_failure`, `missing_vlan`, `negotiation_mismatch`, `port_flap`. Results include resolution status (`status`, `resolved_time`) and affected entity details. Accepts multiple comma-separated values.'
style: form
explode: true
schema:
type: string
examples:
- security,infrastructure
- name: severity
in: query
description: 'Alarm severity used to filter results. enum: `critical`, `info`, `warn`. Accepts multiple comma-separated values.'
style: form
explode: true
schema:
type: string
examples:
- warn,critical
- name: type
in: query
description: Filter alarms by alarm type. Accepts multiple values separated by comma. Use [List Alarm Definitions](/#operations/listAlarmDefinitions) to get the list of possible alarm types
style: form
explode: true
schema:
type: string
examples:
- infra_dhcp_failure,missing_vlan
- name: ack_admin_name
in: query
description: Name of the admins who have acked the alarms; accepts multiple values separated by comma
style: form
explode: true
schema:
type: string
- name: acked
in: query
description: Filter alarm results by whether the alarm has been acknowledged
style: form
explode: true
schema:
type: boolean
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/alarm_search_result'
- description: Paginated response returned by an alarm search
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/alarm_search_result'
- description: Paginated response returned by an alarm search
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/alarms/unack:
post:
tags:
- Orgs Alarms
summary: unackOrgMultipleAlarms
description: Remove acknowledgement from multiple organization alarms by alarm ID and optionally attach a note.
operationId: unackOrgMultipleAlarms
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/alarms'
- description: Request Body
examples:
- alarm_ids:
- ccb8c94d-ca56-4075-932f-1f2ab444ff2c
- 98ff4a3d-ec9b-4138-a42e-54fc3335179d
note: maintenance window
contentMediaType: application/json
examples:
Example:
value:
alarm_ids:
- ccb8c94d-ca56-4075-932f-1f2ab444ff2c
- 98ff4a3d-ec9b-4138-a42e-54fc3335179d
note: maintenance window
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/alarms/unack_all:
post:
tags:
- Orgs Alarms
summary: unackOrgAllAlarms
description: Remove acknowledgement from all alarms in the organization and optionally attach a note. For targeted bulk updates, use [Unack Org Multiple Alarms]($e/Orgs%20Alarms/unackOrgMultipleAlarms) with up to 1000 alarm IDs per request.
operationId: unackOrgAllAlarms
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/note_string'
- description: Request Body
examples:
- note: maintenance window
contentMediaType: application/json
examples:
Example:
value:
note: maintenance window
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/alarms/{alarm_id}/ack:
post:
tags:
- Orgs Alarms
summary: ackOrgAlarm
description: Acknowledge a single organization alarm and optionally attach a note to the acknowledgement.
operationId: ackOrgAlarm
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: alarm_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/note_string'
- description: Request Body
examples:
- note: maintenance window
contentMediaType: application/json
examples:
Example:
value:
note: maintenance window
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/subscriptions:
delete:
tags:
- Orgs Alarms
summary: unsubscribeOrgAlarmsReports
description: >-
Unsubscribe from Org Alarms/Reports
Subscriptions define how Org Alarms/Reports are delivered to whom
operationId: unsubscribeOrgAlarmsReports
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs Alarms
summary: subscribeOrgAlarmsReports
description: >-
Subscribe to Org Alarms/Reports
Subscriptions define how Org Alarms/Reports are delivered to whom
operationId: subscribeOrgAlarmsReports
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/alarmtemplates:
get:
tags:
- Orgs Alarm Templates
summary: listOrgAlarmTemplates
description: List alarm templates defined for the organization, including default delivery settings and per-alarm rule configuration.
operationId: listOrgAlarmTemplates
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/alarm_template'
description: List of alarm templates
contentMediaType: application/json
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/alarm_template'
description: List of alarm templates
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs Alarm Templates
summary: createOrgAlarmTemplate
description: >-
Create an organization alarm template that defines default delivery settings and per-alarm rule overrides.
Available rules can be found in [List Alarm Definitions]($e/Constants%20Events/listAlarmDefinitions)
The `delivery` object is only required when it differs from the template delivery settings.
To assign an Alarm template to a site, use the [Update Site]($e/Sites/updateSiteInfo) endpoint and specify the Alarm template ID in the `alarmtemplate_id` field of the request body.
operationId: createOrgAlarmTemplate
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/alarm_template'
- description: Request Body
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/alarm_template'
- description: Alarm template defining default delivery and per-alarm rules
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/alarm_template'
- description: Alarm template defining default delivery and per-alarm rules
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/alarmtemplates/suppress:
delete:
tags:
- Orgs Alarm Templates
summary: unsuppressOrgSuppressedAlarms
description: Remove alarm suppression entries currently configured for this organization.
operationId: unsuppressOrgSuppressedAlarms
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Orgs Alarm Templates
summary: listOrgSuppressedAlarms
description: List alarm suppression entries currently configured for this organization, optionally filtered by organization-wide or site-specific scope.
operationId: listOrgSuppressedAlarms
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: scope
in: query
description: 'Filter results by scope. enum: `org`, `site`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/suppressed_alarm_scope'
- description: 'Filter results by scope. enum: `org`, `site`'
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_org_suppress_alarm'
- description: Response containing currently suppressed organization alarm entries
examples:
- results:
- duration: 48
expire_time: 1678233080
scheduled_time: 1678232900
scope: site
site_id: 581328b6-e382-f54e-c9dc-9c998d183a34
- duration: 48
expire_time: 1678233080
scheduled_time: 1678232900
scope: org
site_id: 581328b6-e382-f54e-c9dc-9c998d183a35
contentMediaType: application/json
examples:
Example:
value:
results:
- duration: 48
expire_time: 1678233080
scheduled_time: 1678232900
scope: site
site_id: 581328b6-e382-f54e-c9dc-9c998d183a34
- duration: 48
expire_time: 1678233080
scheduled_time: 1678232900
scope: org
site_id: 581328b6-e382-f54e-c9dc-9c998d183a35
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_org_suppress_alarm'
- description: Response containing currently suppressed organization alarm entries
examples:
- results:
- duration: 48
expire_time: 1678233080
scheduled_time: 1678232900
scope: site
site_id: 581328b6-e382-f54e-c9dc-9c998d183a34
- duration: 48
expire_time: 1678233080
scheduled_time: 1678232900
scope: org
site_id: 581328b6-e382-f54e-c9dc-9c998d183a35
contentMediaType: application/vnd.api+json
examples:
Example:
value:
results:
- duration: 48
expire_time: 1678233080
scheduled_time: 1678232900
scope: site
site_id: 581328b6-e382-f54e-c9dc-9c998d183a34
- duration: 48
expire_time: 1678233080
scheduled_time: 1678232900
scope: org
site_id: 581328b6-e382-f54e-c9dc-9c998d183a35
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs Alarm Templates
summary: suppressOrgAlarm
description: Create or schedule an alarm suppression window for the organization or selected sites, for example during planned maintenance.
operationId: suppressOrgAlarm
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/suppressed_alarm'
- examples:
- '{"duration":3600,"scheduled_time":1678232980,"scope":"org"}'
- '{"applies":{"org_id":"2818e386-8dec-2562-9ede-5b8a0fbbdc71","site_ids":["4ac1dcf4-9d8b-7211-65c4-057819f0862b"],"sitegroup_ids":["581328b6-e382-f54e-c9dc-999983183a34","f57096b9-0c2f-4df6-c77b-ae6ae87a3d43"]},"duration":3600,"scheduled_time":1678232980,"scope":"site"}'
contentMediaType: application/json
examples:
org_suppression:
value:
duration: 3600
scheduled_time: 1678232980
scope: org
site_suppression:
value:
applies:
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
site_ids:
- 4ac1dcf4-9d8b-7211-65c4-057819f0862b
sitegroup_ids:
- 581328b6-e382-f54e-c9dc-999983183a34
- f57096b9-0c2f-4df6-c77b-ae6ae87a3d43
duration: 3600
scheduled_time: 1678232980
scope: site
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/alarmtemplates/{alarmtemplate_id}:
delete:
tags:
- Orgs Alarm Templates
summary: deleteOrgAlarmTemplate
description: Delete an organization alarm template by template ID from this organization.
operationId: deleteOrgAlarmTemplate
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: alarmtemplate_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Orgs Alarm Templates
summary: getOrgAlarmTemplate
description: Return one organization alarm template, including default delivery settings and per-alarm rule overrides.
operationId: getOrgAlarmTemplate
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: alarmtemplate_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/alarm_template'
- description: Alarm template defining default delivery and per-alarm rules
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/alarm_template'
- description: Alarm template defining default delivery and per-alarm rules
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Orgs Alarm Templates
summary: updateOrgAlarmTemplate
description: Update an organization alarm template's default delivery settings or per-alarm rule overrides.
operationId: updateOrgAlarmTemplate
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: alarmtemplate_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/alarm_template'
- description: Request Body
examples:
- delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
name: string
rules:
adhoc_network:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
air_magnet_scan:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
ap_offline:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
bad_cable:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
beacon_flood:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
bssid_spoofing:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
device_down:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
device_restarted:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
dhcp_failure:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
disassociation_flood:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
dot1x_failure:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
eap_dictionary_attack:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
eap_failure_injection:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
eap_handshake_flood:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
eap_spoofed_success:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
eapol_logoff_attack:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
essid_jack:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
excessive_client:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
excessive_eapol_start:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
gateway_down:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
gw_bad_cable:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
gw_negotiation_mismatch:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
honeypot_ssid:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
krack_attack:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
missing_vlan:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
monkey_jack:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
negotiation_mismatch:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
non_compliant:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
out_of_sequence:
enabled: true
psk_failure:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
repeated_auth_failures:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
rogue_ap:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
rogue_client:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
secpolicy_violation:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
ssid_injection:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
switch_down:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
tkip_icv_attack:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
vendor_ie_missing:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
watched_station:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
zero_ssid_association:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
contentMediaType: application/json
examples:
Example:
value:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
name: string
rules:
adhoc_network:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
air_magnet_scan:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
ap_offline:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
bad_cable:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
beacon_flood:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
bssid_spoofing:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
device_down:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
device_restarted:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
dhcp_failure:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
disassociation_flood:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
dot1x_failure:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
eap_dictionary_attack:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
eap_failure_injection:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
eap_handshake_flood:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
eap_spoofed_success:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
eapol_logoff_attack:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
essid_jack:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
excessive_client:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
excessive_eapol_start:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
gateway_down:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
gw_bad_cable:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
gw_negotiation_mismatch:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
honeypot_ssid:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
krack_attack:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
missing_vlan:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
monkey_jack:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
negotiation_mismatch:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
non_compliant:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
out_of_sequence:
enabled: true
psk_failure:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
repeated_auth_failures:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
rogue_ap:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
rogue_client:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
secpolicy_violation:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
ssid_injection:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
switch_down:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
tkip_icv_attack:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
vendor_ie_missing:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
watched_station:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
zero_ssid_association:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/alarm_template'
- description: Alarm template defining default delivery and per-alarm rules
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/alarm_template'
- description: Alarm template defining default delivery and per-alarm rules
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/aptemplates:
get:
tags:
- Orgs AP Templates
summary: listOrgAptemplates
description: List organization AP templates that define AP matching rules, port configuration, Wi-Fi, and mesh settings for assignment to sites.
operationId: listOrgAptemplates
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/ap_template'
description: List of AP templates
examples:
- - ap_matching:
enabled: true
rules:
- match_model: string
name: string
port_config:
eth1,eth2:
disabled: true
dynamic_vlan:
default_vlan_id: 999
enabled: true
port_vlan_id: 1
vlan_id: 9
vlan_ids: 1, 10, 50
created_time: 0
for_site: true
id: 497f6eca-6276-4993-bfeb-53cbbbba9f08
modified_time: 0
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
wifi:
cisco_enabled: true
disable_11k: false
disable_radios_when_power_constrained: true
enable_arp_spoof: true
enable_shared_radio_scanning: false
enabled: true
locate_connected: false
locate_unconnected: false
mesh_allow_dfs: false
mesh_enable_crm: true
mesh_enabled: true
proxy_arp: false
contentMediaType: application/json
examples:
Example:
value:
- ap_matching:
enabled: true
rules:
- match_model: string
name: string
port_config:
eth1,eth2:
disabled: true
dynamic_vlan:
default_vlan_id: 999
enabled: true
port_vlan_id: 1
vlan_id: 9
vlan_ids: 1, 10, 50
created_time: 0
for_site: true
id: 497f6eca-6276-4993-bfeb-53cbbbba9f08
modified_time: 0
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
wifi:
cisco_enabled: true
disable_11k: false
disable_radios_when_power_constrained: true
enable_arp_spoof: true
enable_shared_radio_scanning: false
enabled: true
locate_connected: false
locate_unconnected: false
mesh_allow_dfs: false
mesh_enable_crm: true
mesh_enabled: true
proxy_arp: false
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/ap_template'
description: List of AP templates
examples:
- - ap_matching:
enabled: true
rules:
- match_model: string
name: string
port_config:
eth1,eth2:
disabled: true
dynamic_vlan:
default_vlan_id: 999
enabled: true
port_vlan_id: 1
vlan_id: 9
vlan_ids: 1, 10, 50
created_time: 0
for_site: true
id: 497f6eca-6276-4993-bfeb-53cbbbba9f08
modified_time: 0
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
wifi:
cisco_enabled: true
disable_11k: false
disable_radios_when_power_constrained: true
enable_arp_spoof: true
enable_shared_radio_scanning: false
enabled: true
locate_connected: false
locate_unconnected: false
mesh_allow_dfs: false
mesh_enable_crm: true
mesh_enabled: true
proxy_arp: false
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- ap_matching:
enabled: true
rules:
- match_model: string
name: string
port_config:
eth1,eth2:
disabled: true
dynamic_vlan:
default_vlan_id: 999
enabled: true
port_vlan_id: 1
vlan_id: 9
vlan_ids: 1, 10, 50
created_time: 0
for_site: true
id: 497f6eca-6276-4993-bfeb-53cbbbba9f08
modified_time: 0
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
wifi:
cisco_enabled: true
disable_11k: false
disable_radios_when_power_constrained: true
enable_arp_spoof: true
enable_shared_radio_scanning: false
enabled: true
locate_connected: false
locate_unconnected: false
mesh_allow_dfs: false
mesh_enable_crm: true
mesh_enabled: true
proxy_arp: false
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs AP Templates
summary: createOrgAptemplate
description: Create an organization AP template with AP matching rules, port configuration, Wi-Fi settings, and mesh settings.
operationId: createOrgAptemplate
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/ap_template'
required: false
responses:
'200':
description: AP Template
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ap_template'
- description: Access point template configuration
examples:
- ap_matching:
enabled: true
rules:
- match_model: string
name: string
port_config:
eth1,eth2:
disabled: true
dynamic_vlan:
default_vlan_id: 999
enabled: true
port_vlan_id: 1
vlan_id: 9
vlan_ids: 1, 10, 50
created_time: 0
for_site: true
id: 497f6eca-6276-4993-bfeb-53cbbbba8f08
modified_time: 0
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
wifi:
cisco_enabled: true
disable_11k: false
disable_radios_when_power_constrained: true
enable_arp_spoof: true
enable_shared_radio_scanning: false
enabled: true
locate_connected: false
locate_unconnected: false
mesh_allow_dfs: false
mesh_enable_crm: true
mesh_enabled: true
proxy_arp: false
contentMediaType: application/json
examples:
Example:
value:
ap_matching:
enabled: true
rules:
- match_model: string
name: string
port_config:
eth1,eth2:
disabled: true
dynamic_vlan:
default_vlan_id: 999
enabled: true
port_vlan_id: 1
vlan_id: 9
vlan_ids: 1, 10, 50
created_time: 0
for_site: true
id: 497f6eca-6276-4993-bfeb-53cbbbba8f08
modified_time: 0
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
wifi:
cisco_enabled: true
disable_11k: false
disable_radios_when_power_constrained: true
enable_arp_spoof: true
enable_shared_radio_scanning: false
enabled: true
locate_connected: false
locate_unconnected: false
mesh_allow_dfs: false
mesh_enable_crm: true
mesh_enabled: true
proxy_arp: false
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/ap_template'
- description: Access point template configuration
examples:
- ap_matching:
enabled: true
rules:
- match_model: string
name: string
port_config:
eth1,eth2:
disabled: true
dynamic_vlan:
default_vlan_id: 999
enabled: true
port_vlan_id: 1
vlan_id: 9
vlan_ids: 1, 10, 50
created_time: 0
for_site: true
id: 497f6eca-6276-4993-bfeb-53cbbbba8f08
modified_time: 0
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
wifi:
cisco_enabled: true
disable_11k: false
disable_radios_when_power_constrained: true
enable_arp_spoof: true
enable_shared_radio_scanning: false
enabled: true
locate_connected: false
locate_unconnected: false
mesh_allow_dfs: false
mesh_enable_crm: true
mesh_enabled: true
proxy_arp: false
contentMediaType: application/vnd.api+json
examples:
Example:
value:
ap_matching:
enabled: true
rules:
- match_model: string
name: string
port_config:
eth1,eth2:
disabled: true
dynamic_vlan:
default_vlan_id: 999
enabled: true
port_vlan_id: 1
vlan_id: 9
vlan_ids: 1, 10, 50
created_time: 0
for_site: true
id: 497f6eca-6276-4993-bfeb-53cbbbba8f08
modified_time: 0
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
wifi:
cisco_enabled: true
disable_11k: false
disable_radios_when_power_constrained: true
enable_arp_spoof: true
enable_shared_radio_scanning: false
enabled: true
locate_connected: false
locate_unconnected: false
mesh_allow_dfs: false
mesh_enable_crm: true
mesh_enabled: true
proxy_arp: false
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/aptemplates/{aptemplate_id}:
delete:
tags:
- Orgs AP Templates
summary: deleteOrgAptemplate
description: Delete an organization AP template by template ID from this organization.
operationId: deleteOrgAptemplate
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: aptemplate_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Orgs AP Templates
summary: getOrgAptemplate
description: Return one organization AP template, including AP matching rules, port configuration, Wi-Fi settings, and mesh settings.
operationId: getOrgAptemplate
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: aptemplate_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
responses:
'200':
description: AP Template
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ap_template'
- description: Access point template configuration
examples:
- ap_matching:
enabled: true
rules:
- match_model: string
name: string
port_config:
eth1,eth2:
disabled: true
dynamic_vlan:
default_vlan_id: 999
enabled: true
port_vlan_id: 1
vlan_id: 9
vlan_ids: 1, 10, 50
created_time: 0
for_site: true
id: 497f6eca-6276-4993-bfeb-53cbbbba8f08
modified_time: 0
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
wifi:
cisco_enabled: true
disable_11k: false
disable_radios_when_power_constrained: true
enable_arp_spoof: true
enable_shared_radio_scanning: false
enabled: true
locate_connected: false
locate_unconnected: false
mesh_allow_dfs: false
mesh_enable_crm: true
mesh_enabled: true
proxy_arp: false
contentMediaType: application/json
examples:
Example:
value:
ap_matching:
enabled: true
rules:
- match_model: string
name: string
port_config:
eth1,eth2:
disabled: true
dynamic_vlan:
default_vlan_id: 999
enabled: true
port_vlan_id: 1
vlan_id: 9
vlan_ids: 1, 10, 50
created_time: 0
for_site: true
id: 497f6eca-6276-4993-bfeb-53cbbbba8f08
modified_time: 0
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
wifi:
cisco_enabled: true
disable_11k: false
disable_radios_when_power_constrained: true
enable_arp_spoof: true
enable_shared_radio_scanning: false
enabled: true
locate_connected: false
locate_unconnected: false
mesh_allow_dfs: false
mesh_enable_crm: true
mesh_enabled: true
proxy_arp: false
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/ap_template'
- description: Access point template configuration
examples:
- ap_matching:
enabled: true
rules:
- match_model: string
name: string
port_config:
eth1,eth2:
disabled: true
dynamic_vlan:
default_vlan_id: 999
enabled: true
port_vlan_id: 1
vlan_id: 9
vlan_ids: 1, 10, 50
created_time: 0
for_site: true
id: 497f6eca-6276-4993-bfeb-53cbbbba8f08
modified_time: 0
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
wifi:
cisco_enabled: true
disable_11k: false
disable_radios_when_power_constrained: true
enable_arp_spoof: true
enable_shared_radio_scanning: false
enabled: true
locate_connected: false
locate_unconnected: false
mesh_allow_dfs: false
mesh_enable_crm: true
mesh_enabled: true
proxy_arp: false
contentMediaType: application/vnd.api+json
examples:
Example:
value:
ap_matching:
enabled: true
rules:
- match_model: string
name: string
port_config:
eth1,eth2:
disabled: true
dynamic_vlan:
default_vlan_id: 999
enabled: true
port_vlan_id: 1
vlan_id: 9
vlan_ids: 1, 10, 50
created_time: 0
for_site: true
id: 497f6eca-6276-4993-bfeb-53cbbbba8f08
modified_time: 0
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
wifi:
cisco_enabled: true
disable_11k: false
disable_radios_when_power_constrained: true
enable_arp_spoof: true
enable_shared_radio_scanning: false
enabled: true
locate_connected: false
locate_unconnected: false
mesh_allow_dfs: false
mesh_enable_crm: true
mesh_enabled: true
proxy_arp: false
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Orgs AP Templates
summary: updateOrgAptemplate
description: Update an organization AP template's AP matching rules, port configuration, Wi-Fi settings, or mesh settings.
operationId: updateOrgAptemplate
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: aptemplate_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ap_template'
- examples:
- ap_matching:
enabled: true
rules:
- match_model: string
name: string
port_config:
eth1,eth2:
disabled: true
dynamic_vlan:
default_vlan_id: 999
enabled: true
port_vlan_id: 1
vlan_id: 9
vlan_ids: 1, 10, 50
wifi:
cisco_enabled: true
disable_11k: false
disable_radios_when_power_constrained: true
enable_arp_spoof: true
enable_shared_radio_scanning: false
enabled: true
locate_connected: false
locate_unconnected: false
mesh_allow_dfs: false
mesh_enable_crm: true
mesh_enabled: true
proxy_arp: false
contentMediaType: application/json
examples:
Example:
value:
ap_matching:
enabled: true
rules:
- match_model: string
name: string
port_config:
eth1,eth2:
disabled: true
dynamic_vlan:
default_vlan_id: 999
enabled: true
port_vlan_id: 1
vlan_id: 9
vlan_ids: 1, 10, 50
wifi:
cisco_enabled: true
disable_11k: false
disable_radios_when_power_constrained: true
enable_arp_spoof: true
enable_shared_radio_scanning: false
enabled: true
locate_connected: false
locate_unconnected: false
mesh_allow_dfs: false
mesh_enable_crm: true
mesh_enabled: true
proxy_arp: false
required: false
responses:
'200':
description: AP Template
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ap_template'
- description: Access point template configuration
examples:
- ap_matching:
enabled: true
rules:
- match_model: string
name: string
port_config:
eth1,eth2:
disabled: true
dynamic_vlan:
default_vlan_id: 999
enabled: true
port_vlan_id: 1
vlan_id: 9
vlan_ids: 1, 10, 50
created_time: 0
for_site: true
id: 497f6eca-6276-4993-bfeb-53cbbbba8f08
modified_time: 0
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
wifi:
cisco_enabled: true
disable_11k: false
disable_radios_when_power_constrained: true
enable_arp_spoof: true
enable_shared_radio_scanning: false
enabled: true
locate_connected: false
locate_unconnected: false
mesh_allow_dfs: false
mesh_enable_crm: true
mesh_enabled: true
proxy_arp: false
contentMediaType: application/json
examples:
Example:
value:
ap_matching:
enabled: true
rules:
- match_model: string
name: string
port_config:
eth1,eth2:
disabled: true
dynamic_vlan:
default_vlan_id: 999
enabled: true
port_vlan_id: 1
vlan_id: 9
vlan_ids: 1, 10, 50
created_time: 0
for_site: true
id: 497f6eca-6276-4993-bfeb-53cbbbba8f08
modified_time: 0
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
wifi:
cisco_enabled: true
disable_11k: false
disable_radios_when_power_constrained: true
enable_arp_spoof: true
enable_shared_radio_scanning: false
enabled: true
locate_connected: false
locate_unconnected: false
mesh_allow_dfs: false
mesh_enable_crm: true
mesh_enabled: true
proxy_arp: false
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/ap_template'
- description: Access point template configuration
examples:
- ap_matching:
enabled: true
rules:
- match_model: string
name: string
port_config:
eth1,eth2:
disabled: true
dynamic_vlan:
default_vlan_id: 999
enabled: true
port_vlan_id: 1
vlan_id: 9
vlan_ids: 1, 10, 50
created_time: 0
for_site: true
id: 497f6eca-6276-4993-bfeb-53cbbbba8f08
modified_time: 0
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
wifi:
cisco_enabled: true
disable_11k: false
disable_radios_when_power_constrained: true
enable_arp_spoof: true
enable_shared_radio_scanning: false
enabled: true
locate_connected: false
locate_unconnected: false
mesh_allow_dfs: false
mesh_enable_crm: true
mesh_enabled: true
proxy_arp: false
contentMediaType: application/vnd.api+json
examples:
Example:
value:
ap_matching:
enabled: true
rules:
- match_model: string
name: string
port_config:
eth1,eth2:
disabled: true
dynamic_vlan:
default_vlan_id: 999
enabled: true
port_vlan_id: 1
vlan_id: 9
vlan_ids: 1, 10, 50
created_time: 0
for_site: true
id: 497f6eca-6276-4993-bfeb-53cbbbba8f08
modified_time: 0
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
wifi:
cisco_enabled: true
disable_11k: false
disable_radios_when_power_constrained: true
enable_arp_spoof: true
enable_shared_radio_scanning: false
enabled: true
locate_connected: false
locate_unconnected: false
mesh_allow_dfs: false
mesh_enable_crm: true
mesh_enabled: true
proxy_arp: false
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/apitokens:
get:
tags:
- Orgs API Tokens
summary: listOrgApiTokens
description: List organization API tokens, including display names, scoped privileges, allowed source IPs, creator, and last-use metadata.
operationId: listOrgApiTokens
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/org_apitoken'
description: List of organization API tokens
examples:
- - created_by: user@mycorp.com
created_time: 1626875902
id: 497f6eca-6276-4993-bfeb-53f0bbba6f08
key: 1qkb...QQCL
last_used: 1690115110
name: org_token_xyz
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
privileges:
- org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
role: admin
scope: org
contentMediaType: application/json
examples:
Example:
value:
- created_by: user@mycorp.com
created_time: 1626875902
id: 497f6eca-6276-4993-bfeb-53f0bbba6f08
key: 1qkb...QQCL
last_used: 1690115110
name: org_token_xyz
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
privileges:
- org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
role: admin
scope: org
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/org_apitoken'
description: List of organization API tokens
examples:
- - created_by: user@mycorp.com
created_time: 1626875902
id: 497f6eca-6276-4993-bfeb-53f0bbba6f08
key: 1qkb...QQCL
last_used: 1690115110
name: org_token_xyz
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
privileges:
- org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
role: admin
scope: org
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- created_by: user@mycorp.com
created_time: 1626875902
id: 497f6eca-6276-4993-bfeb-53f0bbba6f08
key: 1qkb...QQCL
last_used: 1690115110
name: org_token_xyz
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
privileges:
- org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
role: admin
scope: org
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs API Tokens
summary: createOrgApiToken
description: >-
Create an organization API token with a display name, scoped privileges, and optional source IP restrictions.
Note that the full token key is only available at creation time.
operationId: createOrgApiToken
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/org_apitoken'
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/org_apitoken'
- description: >-
Organization API token with scoped privileges
**Note:**
`privileges` is required to create the object, but may not be returned in the POST API response. Retrieve the token afterward to inspect it.
examples:
- created_by: user@mycorp.com
created_time: 1626875902
id: 497f6eca-6276-4993-bfeb-53efbbba6f08
key: 1qkb...QQCL
last_used: 1690115110
name: org_token_xyz
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
privileges:
- org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
role: admin
scope: org
contentMediaType: application/json
examples:
Example:
value:
created_by: user@mycorp.com
created_time: 1626875902
id: 497f6eca-6276-4993-bfeb-53efbbba6f08
key: 1qkb...QQCL
last_used: 1690115110
name: org_token_xyz
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
privileges:
- org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
role: admin
scope: org
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/org_apitoken'
- description: >-
Organization API token with scoped privileges
**Note:**
`privileges` is required to create the object, but may not be returned in the POST API response. Retrieve the token afterward to inspect it.
examples:
- created_by: user@mycorp.com
created_time: 1626875902
id: 497f6eca-6276-4993-bfeb-53efbbba6f08
key: 1qkb...QQCL
last_used: 1690115110
name: org_token_xyz
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
privileges:
- org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
role: admin
scope: org
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_by: user@mycorp.com
created_time: 1626875902
id: 497f6eca-6276-4993-bfeb-53efbbba6f08
key: 1qkb...QQCL
last_used: 1690115110
name: org_token_xyz
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
privileges:
- org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
role: admin
scope: org
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/apitokens/{apitoken_id}:
delete:
tags:
- Orgs API Tokens
summary: deleteOrgApiToken
description: Delete an organization API token so it can no longer authenticate API requests.
operationId: deleteOrgApiToken
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: apitoken_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Orgs API Tokens
summary: getOrgApiToken
description: Return metadata for one organization API token. The full token key is only available at creation time and may only be partially shown afterward.
operationId: getOrgApiToken
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: apitoken_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/org_apitoken'
- description: >-
Organization API token with scoped privileges
**Note:**
`privileges` is required to create the object, but may not be returned in the POST API response. Retrieve the token afterward to inspect it.
examples:
- created_by: user@mycorp.com
created_time: 1626875902
id: 497f6eca-6276-4993-bfeb-53efbbba6f08
key: 1qkb...QQCL
last_used: 1690115110
name: org_token_xyz
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
privileges:
- org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
role: admin
scope: org
contentMediaType: application/json
examples:
Example:
value:
created_by: user@mycorp.com
created_time: 1626875902
id: 497f6eca-6276-4993-bfeb-53efbbba6f08
key: 1qkb...QQCL
last_used: 1690115110
name: org_token_xyz
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
privileges:
- org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
role: admin
scope: org
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/org_apitoken'
- description: >-
Organization API token with scoped privileges
**Note:**
`privileges` is required to create the object, but may not be returned in the POST API response. Retrieve the token afterward to inspect it.
examples:
- created_by: user@mycorp.com
created_time: 1626875902
id: 497f6eca-6276-4993-bfeb-53efbbba6f08
key: 1qkb...QQCL
last_used: 1690115110
name: org_token_xyz
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
privileges:
- org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
role: admin
scope: org
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_by: user@mycorp.com
created_time: 1626875902
id: 497f6eca-6276-4993-bfeb-53efbbba6f08
key: 1qkb...QQCL
last_used: 1690115110
name: org_token_xyz
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
privileges:
- org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
role: admin
scope: org
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Orgs API Tokens
summary: updateOrgApiToken
description: Update an organization API token's display name or scoped privileges. Source IP restrictions are defined when the token is created.
operationId: updateOrgApiToken
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: apitoken_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/org_apitoken'
- description: Request Body
examples:
- '{"name":"org_token_xyz","privileges":[{"org_id":"a40f5d1f-d889-42e9-94ea-b9b33585fc6b","role":"admin","scope":"org"}]}'
contentMediaType: application/json
examples:
Example:
value:
name: org_token_xyz
privileges:
- org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
role: admin
scope: org
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/assets:
get:
tags:
- Orgs Assets
summary: listOrgAssets
description: List named BLE asset records in this organization, including Bluetooth MAC addresses and optional site, map, or tag metadata.
operationId: listOrgAssets
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/asset'
description: List of named BLE asset records
contentMediaType: application/json
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/asset'
description: List of named BLE asset records
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs Assets
summary: createOrgAsset
description: Create a named BLE asset record with a Bluetooth MAC address and optional site, map, or tag metadata.
operationId: createOrgAsset
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/asset'
- description: Request Body
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/asset'
- description: Named Bluetooth Low Energy asset record
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
tag_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
tag_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/asset'
- description: Named Bluetooth Low Energy asset record
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
tag_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
tag_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/assets/import:
post:
tags:
- Orgs Assets
summary: importOrgAssets
description: >-
Import named BLE assets from a JSON payload or CSV file upload. Each asset record includes at least a name and Bluetooth MAC address.
#### CSV File Format
```csv
name,mac
"asset_name",5c5b53010101
```
operationId: importOrgAssets
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
content:
multipart/form-data:
encoding: {}
schema:
type: object
properties:
file:
type: string
description: CSV file containing asset records to import
contentEncoding: base64
contentMediaType: multipart/form-data
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/assets/{asset_id}:
delete:
tags:
- Orgs Assets
summary: deleteOrgAsset
description: Delete a named BLE asset record from this organization by asset ID.
operationId: deleteOrgAsset
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: asset_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'201':
description: Created
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Orgs Assets
summary: getOrgAsset
description: Return one named BLE asset record, including its Bluetooth MAC address and optional site, map, or tag metadata.
operationId: getOrgAsset
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: asset_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/asset'
- description: Named Bluetooth Low Energy asset record
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
tag_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
tag_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/asset'
- description: Named Bluetooth Low Energy asset record
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
tag_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
tag_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Orgs Assets
summary: updateOrgAsset
description: Update a named BLE asset record's name, Bluetooth MAC address, or optional site, map, or tag metadata.
operationId: updateOrgAsset
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: asset_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/asset'
- description: Request Body
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/asset'
- description: Named Bluetooth Low Energy asset record
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
tag_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
tag_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/asset'
- description: Named Bluetooth Low Energy asset record
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
tag_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
tag_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/assetfilters:
get:
tags:
- Orgs Asset Filters
summary: listOrgAssetFilters
description: List organization-level BLE asset filters. Each filter operates independently, and an asset must match all specified filter properties for that filter to apply.
operationId: listOrgAssetFilters
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/asset_filter'
description: List of BLE asset filters
contentMediaType: application/json
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/asset_filter'
description: List of BLE asset filters
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs Asset Filters
summary: createOrgAssetFilter
description: Create an organization-level BLE asset filter. Any subset of filter properties can be included, and a matching asset must meet all specified conditions.
operationId: createOrgAssetFilter
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/asset_filter'
- examples:
- disabled: true
eddystone_uid_namespace: string
eddystone_url: string
ibeacon_major: 1
ibeacon_uuid: 1f89bc00-d0af-481b-82fe-a6629259a39f
mfg_company_id: 0
name: string
contentMediaType: application/json
examples:
Example:
value:
disabled: true
eddystone_uid_namespace: string
eddystone_url: string
ibeacon_major: 1
ibeacon_uuid: 1f89bc00-d0af-481b-82fe-a6629259a39f
mfg_company_id: 0
name: string
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/asset_filter'
- description: BLE asset filter definition; all specified criteria must match
examples:
- created_time: 0
disabled: true
eddystone_uid_namespace: string
eddystone_url: string
for_site: true
ibeacon_major: 1
ibeacon_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mfg_company_id: 0
modified_time: 0
mqtt_topic: xxxxx
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
disabled: true
eddystone_uid_namespace: string
eddystone_url: string
for_site: true
ibeacon_major: 1
ibeacon_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mfg_company_id: 0
modified_time: 0
mqtt_topic: xxxxx
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/asset_filter'
- description: BLE asset filter definition; all specified criteria must match
examples:
- created_time: 0
disabled: true
eddystone_uid_namespace: string
eddystone_url: string
for_site: true
ibeacon_major: 1
ibeacon_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mfg_company_id: 0
modified_time: 0
mqtt_topic: xxxxx
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
disabled: true
eddystone_uid_namespace: string
eddystone_url: string
for_site: true
ibeacon_major: 1
ibeacon_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mfg_company_id: 0
modified_time: 0
mqtt_topic: xxxxx
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/assetfilters/{assetfilter_id}:
delete:
tags:
- Orgs Asset Filters
summary: deleteOrgAssetFilter
description: Delete an organization-level BLE asset filter by filter ID.
operationId: deleteOrgAssetFilter
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: assetfilter_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Orgs Asset Filters
summary: getOrgAssetFilter
description: Return one organization-level BLE asset filter, including its name, disabled state, and matching criteria.
operationId: getOrgAssetFilter
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: assetfilter_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/asset_filter'
- description: BLE asset filter definition; all specified criteria must match
examples:
- created_time: 0
disabled: true
eddystone_uid_namespace: string
eddystone_url: string
for_site: true
ibeacon_major: 1
ibeacon_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mfg_company_id: 0
modified_time: 0
mqtt_topic: xxxxx
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
disabled: true
eddystone_uid_namespace: string
eddystone_url: string
for_site: true
ibeacon_major: 1
ibeacon_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mfg_company_id: 0
modified_time: 0
mqtt_topic: xxxxx
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/asset_filter'
- description: BLE asset filter definition; all specified criteria must match
examples:
- created_time: 0
disabled: true
eddystone_uid_namespace: string
eddystone_url: string
for_site: true
ibeacon_major: 1
ibeacon_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mfg_company_id: 0
modified_time: 0
mqtt_topic: xxxxx
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
disabled: true
eddystone_uid_namespace: string
eddystone_url: string
for_site: true
ibeacon_major: 1
ibeacon_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mfg_company_id: 0
modified_time: 0
mqtt_topic: xxxxx
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Orgs Asset Filters
summary: updateOrgAssetFilter
description: Update an organization-level BLE asset filter's name, disabled state, or matching criteria.
operationId: updateOrgAssetFilter
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: assetfilter_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/asset_filter'
- description: Request Body
examples:
- disabled: true
eddystone_uid_namespace: string
eddystone_url: string
ibeacon_major: 1
ibeacon_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab2
mfg_company_id: 0
name: string
contentMediaType: application/json
examples:
Example:
value:
disabled: true
eddystone_uid_namespace: string
eddystone_url: string
ibeacon_major: 1
ibeacon_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab2
mfg_company_id: 0
name: string
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/asset_filter'
- description: BLE asset filter definition; all specified criteria must match
examples:
- created_time: 0
disabled: true
eddystone_uid_namespace: string
eddystone_url: string
for_site: true
ibeacon_major: 1
ibeacon_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mfg_company_id: 0
modified_time: 0
mqtt_topic: xxxxx
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
disabled: true
eddystone_uid_namespace: string
eddystone_url: string
for_site: true
ibeacon_major: 1
ibeacon_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mfg_company_id: 0
modified_time: 0
mqtt_topic: xxxxx
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/asset_filter'
- description: BLE asset filter definition; all specified criteria must match
examples:
- created_time: 0
disabled: true
eddystone_uid_namespace: string
eddystone_url: string
for_site: true
ibeacon_major: 1
ibeacon_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mfg_company_id: 0
modified_time: 0
mqtt_topic: xxxxx
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
disabled: true
eddystone_uid_namespace: string
eddystone_url: string
for_site: true
ibeacon_major: 1
ibeacon_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mfg_company_id: 0
modified_time: 0
mqtt_topic: xxxxx
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/cert:
get:
tags:
- Orgs Cert
summary: listOrgCertificates
description: Return the current organization CA certificate and, when available, the pending auto-renewed certificate scheduled to replace it.
operationId: listOrgCertificates
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_certificate'
- description: If the current Org CA certificate is set to expire within 30 days, a pending certificate will be returned along with the expected auto-renewal timestamp.
examples:
- cert: >-
-----BEGIN CERTIFICATE-----
MIIowDQYJKoZIhvcNAQELBQE
-----END CERTIFICATE-----
contentMediaType: application/json
examples:
Example:
value:
cert: >-
-----BEGIN CERTIFICATE-----
MIIowDQYJKoZIhvcNAQELBQE
-----END CERTIFICATE-----
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_certificate'
- description: If the current Org CA certificate is set to expire within 30 days, a pending certificate will be returned along with the expected auto-renewal timestamp.
examples:
- cert: >-
-----BEGIN CERTIFICATE-----
MIIowDQYJKoZIhvcNAQELBQE
-----END CERTIFICATE-----
contentMediaType: application/vnd.api+json
examples:
Example:
value:
cert: >-
-----BEGIN CERTIFICATE-----
MIIowDQYJKoZIhvcNAQELBQE
-----END CERTIFICATE-----
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/cert/apply_pending:
post:
tags:
- Orgs Cert
summary: rotateOrgCertificate
description: Replace the current organization CA certificate with the pending certificate generated previously.
operationId: rotateOrgCertificate
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/cert/regenerate:
post:
tags:
- Orgs Cert
summary: clearOrgCertificates
description: Clear existing organization certificates and trigger certificate regeneration for the organization.
operationId: clearOrgCertificates
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/crl/truncate:
post:
tags:
- Orgs Cert
summary: truncateOrgCrlFile
description: By default, all certs used by recently unclaimed devices within 9 month will be included in CRL. If the list grows too big, you can truncate it
operationId: truncateOrgCrlFile
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/days_number'
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/ssl_proxy_cert:
get:
tags:
- Orgs Cert
summary: getOrgSslProxyCert
description: Return the PEM-encoded SSL proxy certificate for the organization, used by SSL proxy inspection.
operationId: getOrgSslProxyCert
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/org_ssl_proxy_cert'
- description: SSL proxy certificate returned for the organization
examples:
- cert: '-----BEGIN CERTIFICATE-----\nMIIowDQYJKoZIhvcNAQELBQE\n-----END CERTIFICATE-----'
contentMediaType: application/json
examples:
Example:
value:
cert: '-----BEGIN CERTIFICATE-----\nMIIowDQYJKoZIhvcNAQELBQE\n-----END CERTIFICATE-----'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/org_ssl_proxy_cert'
- description: SSL proxy certificate returned for the organization
examples:
- cert: '-----BEGIN CERTIFICATE-----\nMIIowDQYJKoZIhvcNAQELBQE\n-----END CERTIFICATE-----'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
cert: '-----BEGIN CERTIFICATE-----\nMIIowDQYJKoZIhvcNAQELBQE\n-----END CERTIFICATE-----'
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/avprofiles:
get:
tags:
- Orgs Antivirus Profiles
summary: listOrgAntivirusProfiles
description: List organization antivirus scanning profiles, including inspected protocols, scan limits, whitelist settings, and fallback actions.
operationId: listOrgAntivirusProfiles
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/avprofile'
description: List of antivirus scanning profiles
examples:
- - fallback_action: permit
max_filesize: 10000
mime_whitelist: []
name: av-custom
protocols:
- http
url_whitelist: []
contentMediaType: application/json
examples:
Example:
value:
- fallback_action: permit
max_filesize: 10000
mime_whitelist: []
name: av-custom
protocols:
- http
url_whitelist: []
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/avprofile'
description: List of antivirus scanning profiles
examples:
- - fallback_action: permit
max_filesize: 10000
mime_whitelist: []
name: av-custom
protocols:
- http
url_whitelist: []
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- fallback_action: permit
max_filesize: 10000
mime_whitelist: []
name: av-custom
protocols:
- http
url_whitelist: []
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs Antivirus Profiles
summary: createOrgAntivirusProfile
description: Create an organization antivirus scanning profile with inspected protocols, maximum file size, whitelist settings, and fallback action.
operationId: createOrgAntivirusProfile
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/avprofile'
- examples:
- fallback_action: permit
max_filesize: 10000
mime_whitelist: []
name: av-custom
protocols:
- http
url_whitelist: []
contentMediaType: application/json
examples:
Example:
value:
fallback_action: permit
max_filesize: 10000
mime_whitelist: []
name: av-custom
protocols:
- http
url_whitelist: []
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/avprofile'
- description: Antivirus scanning profile with protocols, limits, and whitelist settings
examples:
- fallback_action: permit
max_filesize: 10000
mime_whitelist: []
name: av-custom
protocols:
- http
url_whitelist: []
contentMediaType: application/json
examples:
Example:
value:
fallback_action: permit
max_filesize: 10000
mime_whitelist: []
name: av-custom
protocols:
- http
url_whitelist: []
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/avprofile'
- description: Antivirus scanning profile with protocols, limits, and whitelist settings
examples:
- fallback_action: permit
max_filesize: 10000
mime_whitelist: []
name: av-custom
protocols:
- http
url_whitelist: []
contentMediaType: application/vnd.api+json
examples:
Example:
value:
fallback_action: permit
max_filesize: 10000
mime_whitelist: []
name: av-custom
protocols:
- http
url_whitelist: []
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/avprofiles/{avprofile_id}:
delete:
tags:
- Orgs Antivirus Profiles
summary: deleteOrgAntivirusProfile
description: Delete an organization antivirus scanning profile by profile ID.
operationId: deleteOrgAntivirusProfile
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: avprofile_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Orgs Antivirus Profiles
summary: getOrgAntivirusProfile
description: Return one organization antivirus scanning profile, including inspected protocols, scan limits, whitelist settings, and fallback action.
operationId: getOrgAntivirusProfile
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: avprofile_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/avprofile'
- description: Antivirus scanning profile with protocols, limits, and whitelist settings
examples:
- fallback_action: permit
max_filesize: 10000
mime_whitelist: []
name: av-custom
protocols:
- http
url_whitelist: []
contentMediaType: application/json
examples:
Example:
value:
fallback_action: permit
max_filesize: 10000
mime_whitelist: []
name: av-custom
protocols:
- http
url_whitelist: []
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/avprofile'
- description: Antivirus scanning profile with protocols, limits, and whitelist settings
examples:
- fallback_action: permit
max_filesize: 10000
mime_whitelist: []
name: av-custom
protocols:
- http
url_whitelist: []
contentMediaType: application/vnd.api+json
examples:
Example:
value:
fallback_action: permit
max_filesize: 10000
mime_whitelist: []
name: av-custom
protocols:
- http
url_whitelist: []
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Orgs Antivirus Profiles
summary: updateOrgAntivirusProfile
description: Update an organization antivirus scanning profile's inspected protocols, maximum file size, whitelist settings, or fallback action.
operationId: updateOrgAntivirusProfile
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: avprofile_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/avprofile'
- examples:
- fallback_action: permit
max_filesize: 10000
mime_whitelist: []
name: av-custom
protocols:
- http
url_whitelist: []
contentMediaType: application/json
examples:
Example:
value:
fallback_action: permit
max_filesize: 10000
mime_whitelist: []
name: av-custom
protocols:
- http
url_whitelist: []
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/avprofile'
- description: Antivirus scanning profile with protocols, limits, and whitelist settings
examples:
- fallback_action: permit
max_filesize: 10000
mime_whitelist: []
name: av-custom
protocols:
- http
url_whitelist: []
contentMediaType: application/json
examples:
Example:
value:
fallback_action: permit
max_filesize: 10000
mime_whitelist: []
name: av-custom
protocols:
- http
url_whitelist: []
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/avprofile'
- description: Antivirus scanning profile with protocols, limits, and whitelist settings
examples:
- fallback_action: permit
max_filesize: 10000
mime_whitelist: []
name: av-custom
protocols:
- http
url_whitelist: []
contentMediaType: application/vnd.api+json
examples:
Example:
value:
fallback_action: permit
max_filesize: 10000
mime_whitelist: []
name: av-custom
protocols:
- http
url_whitelist: []
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/insights/marvisclient/{marvisclient_id}/marvisclient-metrics:
get:
tags:
- Orgs Clients - Marvis
summary: getOrgMarvisClientInsights
description: Return time-series metrics for a specific Marvis Client device. For the full list of supported metric field names and example values, refer to [List Insight Metrics]($e/Constants%20Definitions/listInsightMetrics) under `/api/v1/const/insight_metrics`.
operationId: getOrgMarvisClientInsights
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: marvisclient_id
in: path
description: Marvis Client device UUID
required: true
schema:
type: string
contentEncoding: uuid
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: interval
in: query
description: Aggregation works by giving a time range plus interval (e.g. 1d, 1h, 10m) where aggregation function would be applied to.
style: form
explode: true
schema:
type: string
examples:
- 10m
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: Marvis Client time-series metrics
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/marvis_client_insights'
- description: Time-series performance metrics for a Marvis Client device
examples:
- avg_battery:
- 82
- 79
avg_cellular_rssi:
- -95
- -92
avg_cpu:
- 12.5
- 15.2
avg_memory:
- 43.1
- 44.8
avg_wifi_rssi:
- -62
- -60
end: 1717113600
interval: 3600
limit: 100
page: 1
rt:
- 2026-05-30T16:00:00Z
- 2026-05-30T17:00:00Z
start: 1717027200
contentMediaType: application/json
examples:
Example:
value:
avg_battery:
- 82
- 79
avg_cellular_rssi:
- -95
- -92
avg_cpu:
- 12.5
- 15.2
avg_memory:
- 43.1
- 44.8
avg_wifi_rssi:
- -62
- -60
end: 1717113600
interval: 3600
limit: 100
page: 1
rt:
- 2026-05-30T16:00:00Z
- 2026-05-30T17:00:00Z
start: 1717027200
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/marvis_client_insights'
- description: Time-series performance metrics for a Marvis Client device
examples:
- avg_battery:
- 82
- 79
avg_cellular_rssi:
- -95
- -92
avg_cpu:
- 12.5
- 15.2
avg_memory:
- 43.1
- 44.8
avg_wifi_rssi:
- -62
- -60
end: 1717113600
interval: 3600
limit: 100
page: 1
rt:
- 2026-05-30T16:00:00Z
- 2026-05-30T17:00:00Z
start: 1717027200
contentMediaType: application/vnd.api+json
examples:
Example:
value:
avg_battery:
- 82
- 79
avg_cellular_rssi:
- -95
- -92
avg_cpu:
- 12.5
- 15.2
avg_memory:
- 43.1
- 44.8
avg_wifi_rssi:
- -62
- -60
end: 1717113600
interval: 3600
limit: 100
page: 1
rt:
- 2026-05-30T16:00:00Z
- 2026-05-30T17:00:00Z
start: 1717027200
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/marvisclients/events/count:
get:
tags:
- Orgs Clients - Marvis
summary: countOrgMarvisClientEvents
description: Count Marvis Client events by a distinct field.
operationId: countOrgMarvisClientEvents
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field to count by. enum: `type`, `device_id`, `wifi_mac`, `wifi_ip`, `hostname`, `ssid`, `bssid`, `channel`, `pre_bssid`, `pre_channel`'
style: form
explode: true
schema:
type: string
default: type
- name: type
in: query
description: Filter by event type
style: form
explode: true
schema:
type: string
- name: device_id
in: query
description: Filter by Marvis Client installation device UUID
style: form
explode: true
schema:
type: string
- name: wifi_mac
in: query
description: Filter by device Wi-Fi MAC address
style: form
explode: true
schema:
type: string
- name: wifi_ip
in: query
description: Filter by device Wi-Fi IP address
style: form
explode: true
schema:
type: string
- name: hostname
in: query
description: Filter by device hostname
style: form
explode: true
schema:
type: string
- name: ssid
in: query
description: Filter by SSID involved in roam events
style: form
explode: true
schema:
type: string
- name: bssid
in: query
description: Filter by BSSID the client roamed to
style: form
explode: true
schema:
type: string
- name: channel
in: query
description: Filter by channel the client roamed to
style: form
explode: true
schema:
type: string
- name: pre_bssid
in: query
description: Filter by BSSID the client roamed from
style: form
explode: true
schema:
type: string
- name: pre_channel
in: query
description: Filter by channel the client roamed from
style: form
explode: true
schema:
type: string
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
responses:
'200':
description: Count result
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/marvisclients/events/search:
get:
tags:
- Orgs Clients - Marvis
summary: searchOrgMarvisClientEvents
description: Search Marvis Client events across the organization.
operationId: searchOrgMarvisClientEvents
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: type
in: query
description: Filter by event type
style: form
explode: true
schema:
type: string
- name: device_id
in: query
description: Filter by Marvis Client installation device UUID
style: form
explode: true
schema:
type: string
- name: wifi_mac
in: query
description: Filter by device Wi-Fi MAC address
style: form
explode: true
schema:
type: string
- name: wifi_ip
in: query
description: Filter by device Wi-Fi IP address
style: form
explode: true
schema:
type: string
- name: hostname
in: query
description: Filter by device hostname
style: form
explode: true
schema:
type: string
- name: ssid
in: query
description: Filter by SSID involved in roam events
style: form
explode: true
schema:
type: string
- name: bssid
in: query
description: Filter by BSSID the client roamed to
style: form
explode: true
schema:
type: string
- name: channel
in: query
description: Filter by channel the client roamed to
style: form
explode: true
schema:
type: string
- name: pre_bssid
in: query
description: Filter by BSSID the client roamed from
style: form
explode: true
schema:
type: string
- name: pre_channel
in: query
description: Filter by channel the client roamed from
style: form
explode: true
schema:
type: string
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
responses:
'200':
description: Paginated Marvis Client events search results
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/marvis_client_events_search'
- description: Paginated list of Marvis Client events
examples:
- limit: 1000
results:
- bssid: 5c5b35000002
channel: 11
device_id: da088609-8e8d-6d8b-0e40-fe1dc94b9218
hostname: jdoe123-dell
location:
map_id: 7735ef91-83b4-6116-1c1a-57819af48867
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
timestamp: 1678377926
x: 12.5
y: 45
neighbor_ap_report:
- band: '5'
bssid: 5c5b35000003
channel: 44
rssi: -55
- band: '5'
bssid: 5c5b35000004
channel: 36
rssi: -70
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
pre_bssid: 5c5b35000001
pre_channel: 7
pre_rssi: -76
rssi: -53
ssid: Corp
timestamp: 1678377926
type: MARVISCLIENT_ROAMED
wifi_ip: 10.10.20.1
wifi_mac: f01c2df166e0
- device_id: da088609-8e8d-6d8b-0e40-fe1dc94b9218
hostname: jdoe123-dell
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
percent: 9
timestamp: 1678378040
type: MARVISCLIENT_LOW_BATTERY
wifi_ip: 10.10.20.1
wifi_mac: f01c2df166e0
total: 1
contentMediaType: application/json
examples:
Example:
value:
limit: 1000
results:
- bssid: 5c5b35000002
channel: 11
device_id: da088609-8e8d-6d8b-0e40-fe1dc94b9218
hostname: jdoe123-dell
location:
map_id: 7735ef91-83b4-6116-1c1a-57819af48867
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
timestamp: 1678377926
x: 12.5
y: 45
neighbor_ap_report:
- band: '5'
bssid: 5c5b35000003
channel: 44
rssi: -55
- band: '5'
bssid: 5c5b35000004
channel: 36
rssi: -70
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
pre_bssid: 5c5b35000001
pre_channel: 7
pre_rssi: -76
rssi: -53
ssid: Corp
timestamp: 1678377926
type: MARVISCLIENT_ROAMED
wifi_ip: 10.10.20.1
wifi_mac: f01c2df166e0
- device_id: da088609-8e8d-6d8b-0e40-fe1dc94b9218
hostname: jdoe123-dell
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
percent: 9
timestamp: 1678378040
type: MARVISCLIENT_LOW_BATTERY
wifi_ip: 10.10.20.1
wifi_mac: f01c2df166e0
total: 1
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/marvis_client_events_search'
- description: Paginated list of Marvis Client events
examples:
- limit: 1000
results:
- bssid: 5c5b35000002
channel: 11
device_id: da088609-8e8d-6d8b-0e40-fe1dc94b9218
hostname: jdoe123-dell
location:
map_id: 7735ef91-83b4-6116-1c1a-57819af48867
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
timestamp: 1678377926
x: 12.5
y: 45
neighbor_ap_report:
- band: '5'
bssid: 5c5b35000003
channel: 44
rssi: -55
- band: '5'
bssid: 5c5b35000004
channel: 36
rssi: -70
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
pre_bssid: 5c5b35000001
pre_channel: 7
pre_rssi: -76
rssi: -53
ssid: Corp
timestamp: 1678377926
type: MARVISCLIENT_ROAMED
wifi_ip: 10.10.20.1
wifi_mac: f01c2df166e0
- device_id: da088609-8e8d-6d8b-0e40-fe1dc94b9218
hostname: jdoe123-dell
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
percent: 9
timestamp: 1678378040
type: MARVISCLIENT_LOW_BATTERY
wifi_ip: 10.10.20.1
wifi_mac: f01c2df166e0
total: 1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
limit: 1000
results:
- bssid: 5c5b35000002
channel: 11
device_id: da088609-8e8d-6d8b-0e40-fe1dc94b9218
hostname: jdoe123-dell
location:
map_id: 7735ef91-83b4-6116-1c1a-57819af48867
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
timestamp: 1678377926
x: 12.5
y: 45
neighbor_ap_report:
- band: '5'
bssid: 5c5b35000003
channel: 44
rssi: -55
- band: '5'
bssid: 5c5b35000004
channel: 36
rssi: -70
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
pre_bssid: 5c5b35000001
pre_channel: 7
pre_rssi: -76
rssi: -53
ssid: Corp
timestamp: 1678377926
type: MARVISCLIENT_ROAMED
wifi_ip: 10.10.20.1
wifi_mac: f01c2df166e0
- device_id: da088609-8e8d-6d8b-0e40-fe1dc94b9218
hostname: jdoe123-dell
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
percent: 9
timestamp: 1678378040
type: MARVISCLIENT_LOW_BATTERY
wifi_ip: 10.10.20.1
wifi_mac: f01c2df166e0
total: 1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/stats/marvisclients:
delete:
tags:
- Orgs Clients - Marvis
summary: deleteOrgMarvisClient
description: Delete Marvis Client
operationId: deleteOrgMarvisClient
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/marvisinvites:
get:
tags:
- Orgs Marvis Invites
summary: listOrgMarvisClientInvites
description: List Marvis Client onboarding invite profiles for the organization, including enrollment URLs and enabled telemetry, location, and synthetic-test capabilities.
operationId: listOrgMarvisClientInvites
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/marvis_client'
description: Marvis Client profiles returned by the API
examples:
- - enrollment_url: marvisclient://api.mist.com/path/to/url
id: 3a14098f-b995-7552-b0a4-b8ee39b337a6
name: Handhelds
contentMediaType: application/json
examples:
Example:
value:
- enrollment_url: marvisclient://api.mist.com/path/to/url
id: 3a14098f-b995-7552-b0a4-b8ee39b337a6
name: Handhelds
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/marvis_client'
description: Marvis Client profiles returned by the API
examples:
- - enrollment_url: marvisclient://api.mist.com/path/to/url
id: 3a14098f-b995-7552-b0a4-b8ee39b337a6
name: Handhelds
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- enrollment_url: marvisclient://api.mist.com/path/to/url
id: 3a14098f-b995-7552-b0a4-b8ee39b337a6
name: Handhelds
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs Marvis Invites
summary: createOrgMarvisClientInvite
description: Create a Marvis Client onboarding invite profile for the organization, defining the enabled telemetry, location, and synthetic-test capabilities.
operationId: createOrgMarvisClientInvite
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/marvis_client'
- examples:
- location:
enabled: true
name: Handhelds
synthetic_test:
enabled: true
telemetry:
enabled: true
contentMediaType: application/json
examples:
Example:
value:
location:
enabled: true
name: Handhelds
synthetic_test:
enabled: true
telemetry:
enabled: true
required: false
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/marvis_client'
- description: Marvis Client configuration profile
examples:
- enrollment_url: marvisclient://api.mist.com/path/to/url
id: 3a14098f-b995-7552-b0a4-b8ee39b337a6
name: Handhelds
contentMediaType: application/json
examples:
Example:
value:
enrollment_url: marvisclient://api.mist.com/path/to/url
id: 3a14098f-b995-7552-b0a4-b8ee39b337a6
name: Handhelds
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/marvis_client'
- description: Marvis Client configuration profile
examples:
- enrollment_url: marvisclient://api.mist.com/path/to/url
id: 3a14098f-b995-7552-b0a4-b8ee39b337a6
name: Handhelds
contentMediaType: application/vnd.api+json
examples:
Example:
value:
enrollment_url: marvisclient://api.mist.com/path/to/url
id: 3a14098f-b995-7552-b0a4-b8ee39b337a6
name: Handhelds
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/marvisinvites/{marvisinvite_id}:
delete:
tags:
- Orgs Marvis Invites
summary: deleteOrgMarvisClientInvite
description: Delete a Marvis Client onboarding invite profile by ID.
operationId: deleteOrgMarvisClientInvite
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: marvisinvite_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Orgs Marvis Invites
summary: getOrgMarvisClientInvite
description: Retrieve a Marvis Client onboarding invite profile, including enrollment URL and enabled client capabilities.
operationId: getOrgMarvisClientInvite
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: marvisinvite_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/marvis_client'
- description: Marvis Client configuration profile
examples:
- enrollment_url: marvisclient://api.mist.com/path/to/url
id: 3a14098f-b995-7552-b0a4-b8ee39b337a6
name: Handhelds
contentMediaType: application/json
examples:
Example:
value:
enrollment_url: marvisclient://api.mist.com/path/to/url
id: 3a14098f-b995-7552-b0a4-b8ee39b337a6
name: Handhelds
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/marvis_client'
- description: Marvis Client configuration profile
examples:
- enrollment_url: marvisclient://api.mist.com/path/to/url
id: 3a14098f-b995-7552-b0a4-b8ee39b337a6
name: Handhelds
contentMediaType: application/vnd.api+json
examples:
Example:
value:
enrollment_url: marvisclient://api.mist.com/path/to/url
id: 3a14098f-b995-7552-b0a4-b8ee39b337a6
name: Handhelds
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Orgs Marvis Invites
summary: updateOrgMarvisClientInvite
description: Update a Marvis Client onboarding invite profile, including enabled telemetry, location, and synthetic-test capabilities.
operationId: updateOrgMarvisClientInvite
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: marvisinvite_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/marvis_client'
- examples:
- location:
enabled: true
name: Handhelds
synthetic_test:
enabled: true
telemetry:
enabled: true
contentMediaType: application/json
examples:
Example:
value:
location:
enabled: true
name: Handhelds
synthetic_test:
enabled: true
telemetry:
enabled: true
required: false
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/marvis_client'
- description: Marvis Client configuration profile
examples:
- enrollment_url: marvisclient://api.mist.com/path/to/url
id: 3a14098f-b995-7552-b0a4-b8ee39b337a6
name: Handhelds
contentMediaType: application/json
examples:
Example:
value:
enrollment_url: marvisclient://api.mist.com/path/to/url
id: 3a14098f-b995-7552-b0a4-b8ee39b337a6
name: Handhelds
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/marvis_client'
- description: Marvis Client configuration profile
examples:
- enrollment_url: marvisclient://api.mist.com/path/to/url
id: 3a14098f-b995-7552-b0a4-b8ee39b337a6
name: Handhelds
contentMediaType: application/vnd.api+json
examples:
Example:
value:
enrollment_url: marvisclient://api.mist.com/path/to/url
id: 3a14098f-b995-7552-b0a4-b8ee39b337a6
name: Handhelds
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/nac_clients/count:
get:
tags:
- Orgs Clients - NAC
summary: countOrgNacClients
description: Count NAC clients across the organization, optionally grouped by `distinct` and filtered by authentication, identity, endpoint, network, site, and time attributes.
operationId: countOrgNacClients
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field used to group this count response. enum: `ap`, `auth_type`, `device_mac`, `edr_managed`, `edr_providers`, `edr_status`, `family`, `hostname`, `idp_id`, `mfg`, `mdm_compliance`, `mdm_managed`, `mdm_provider`, `model`, `mxedge_id`, `nacrule_matched`, `nacrule_name`, `nacrule_id`, `nas_ip`, `nas_vendor`, `os`, `site_id`, `ssid`, `status`, `type`, `usermac_label`, `username`, `vlan`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/org_nac_clients_count_distinct'
- description: 'Field used to group this count response. enum: `ap`, `auth_type`, `device_mac`, `edr_managed`, `edr_providers`, `edr_status`, `family`, `hostname`, `idp_id`, `mfg`, `mdm_compliance`, `mdm_managed`, `mdm_provider`, `model`, `mxedge_id`, `nacrule_matched`, `nacrule_name`, `nacrule_id`, `nas_ip`, `nas_vendor`, `os`, `site_id`, `ssid`, `status`, `type`, `usermac_label`, `username`, `vlan`'
- name: last_nacrule_id
in: query
description: NAC Policy Rule ID, if matched
style: form
explode: true
schema:
type: string
- name: nacrule_matched
in: query
description: NAC Policy Rule Matched
style: form
explode: true
schema:
type: boolean
- name: auth_type
in: query
description: Authentication type, e.g. "eap-tls", "eap-peap", "eap-ttls", "eap-teap", "mab", "psk", "device-auth"
style: form
explode: true
schema:
type: string
- name: last_vlan_id
in: query
description: Filter results by last VLAN ID
style: form
explode: true
schema:
type: string
- name: last_nas_vendor
in: query
description: Vendor of NAS device
style: form
explode: true
schema:
type: string
- name: idp_id
in: query
description: SSO ID, if present and used
style: form
explode: true
schema:
type: string
- name: last_ssid
in: query
description: Filter results by last SSID
style: form
explode: true
schema:
type: string
- name: last_username
in: query
description: Username presented by the client
style: form
explode: true
schema:
type: string
- name: site_id
in: query
description: Filter results by site identifier
style: form
explode: true
schema:
type: string
- name: last_ap
in: query
description: AP MAC connected to by client
style: form
explode: true
schema:
type: string
- name: mac
in: query
description: Filter results by MAC address
style: form
explode: true
schema:
type: string
- name: last_status
in: query
description: Connection status of client i.e "permitted", "denied, "session_ended"
style: form
explode: true
schema:
type: string
- name: type
in: query
description: Client type i.e. "wireless", "wired" etc. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- wired,wireless
- name: mdm_compliance_status
in: query
description: MDM compliance of client i.e "compliant", "not compliant"
style: form
explode: true
schema:
type: string
- name: mdm_provider
in: query
description: MDM provider of client’s organization eg "intune", "jamf"
style: form
explode: true
schema:
type: string
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/nac_clients/events/count:
get:
tags:
- Orgs Clients - NAC
summary: countOrgNacClientEvents
description: Count NAC client events across the organization, optionally grouped by `distinct` and filtered by event type and time range.
operationId: countOrgNacClientEvents
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field used to group this count response. enum: `ap`, `auth_type`, `dryrun_nacrule_id`, `mac`, `nacrule_id`, `nas_vendor`, `ssid`, `type`, `username`, `vlan`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/org_nac_client_events_count_distinct'
- description: 'Field used to group this count response. enum: `ap`, `auth_type`, `dryrun_nacrule_id`, `mac`, `nacrule_id`, `nas_vendor`, `ssid`, `type`, `username`, `vlan`'
- name: type
in: query
description: See [List Device Events Definitions]($e/Constants%20Events/listNacEventsDefinitions). Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- NAC_CLIENT_PERMIT,NAC_SESSION_STARTED
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/nac_clients/events/search:
get:
tags:
- Orgs Clients - NAC
summary: searchOrgNacClientEvents
description: Search NAC client authentication event records across the organization with filters for authentication, NAC rule, identity provider, RADIUS, network, endpoint, site, and time attributes.
operationId: searchOrgNacClientEvents
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: type
in: query
description: See [List Device Events Definitions]($e/Constants%20Events/listNacEventsDefinitions). Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- NAC_CLIENT_PERMIT,NAC_SESSION_STARTED
- name: nacrule_id
in: query
description: NAC Policy Rule ID, if matched. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
contentEncoding: uuid
- name: nacrule_matched
in: query
description: NAC Policy Rule Matched
style: form
explode: true
schema:
type: boolean
- name: dryrun_nacrule_id
in: query
description: NAC Policy Dry Run Rule ID, if present and matched
style: form
explode: true
schema:
type: string
- name: dryrun_nacrule_matched
in: query
description: True - if dryrun rule present and matched with priority, False - if not matched or not present
style: form
explode: true
schema:
type: boolean
- name: auth_type
in: query
description: Authentication type, e.g. "eap-tls", "eap-peap", "eap-ttls", "eap-teap", "mab", "psk", "device-auth". Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- mab,eap-tls
- name: vlan
in: query
description: Filter results by VLAN ID. Accepts multiple comma-separated integer values.
style: form
explode: true
schema:
type: integer
contentEncoding: int32
- name: nas_vendor
in: query
description: Vendor of NAS device
style: form
explode: true
schema:
type: string
- name: bssid
in: query
description: Filter results by BSSID
style: form
explode: true
schema:
type: string
- name: idp_id
in: query
description: SSO ID, if present and used
style: form
explode: true
schema:
type: string
contentEncoding: uuid
- name: idp_role
in: query
description: IDP returned roles/groups for the user
style: form
explode: true
schema:
type: string
- name: idp_username
in: query
description: Username presented to the Identity Provider
style: form
explode: true
schema:
type: string
- name: resp_attrs
in: query
description: RADIUS attributes returned by NAC to NAS derive
style: form
explode: true
schema:
uniqueItems: true
type: array
items:
type: string
examples:
- - Tunnel-Type=VLAN
- Tunnel-Medium-Type=IEEE-802
- Tunnel-Private-Group-Id=750
- User-Name=anonymous
- name: ssid
in: query
description: Filter results by SSID
style: form
explode: true
schema:
type: string
- name: username
in: query
description: Filter results by username. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- john.doe,jane.doe
- name: site_id
in: query
description: Filter results by one site identifier. Use a single value; comma-separated values are not supported
style: form
explode: true
schema:
type: string
- name: ap
in: query
description: Filter results by AP MAC address
style: form
explode: true
schema:
type: string
- name: random_mac
in: query
description: Filter results by whether the client is using a randomized MAC address. Accepts multiple comma-separated boolean values.
style: form
explode: true
schema:
type: boolean
- name: mac
in: query
description: Filter results by one MAC address. Use a single value; comma-separated values are not supported
style: form
explode: true
schema:
type: string
- name: usermac_label
in: query
description: Labels derived from usermac entry
style: form
explode: true
schema:
type: string
- name: text
in: query
description: Partial / full MAC address, username, device_mac or ap
style: form
explode: true
schema:
type: string
- name: nas_ip
in: query
description: IP address of NAS device. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- 192.0.2.10,192.0.2.11
- name: ingress_vlan
in: query
description: Vendor specific VLAN ID in RADIUS requests
style: form
explode: true
schema:
type: string
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order.
style: form
explode: true
schema:
type: string
default: wxid
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: NAC Client Events
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_events_nac_client_search'
- description: Paginated response for NAC client event search results
examples:
- end: 1513176951
limit: 10
results:
- ap: 5c5b35513227
auth_type: eap-ttls
bssid: 5c5b355fafcc
dryrun_nacrule_id: 32f27e7d-ff26-4a9b-b3d1-ff9bcb264012
dryrun_nacrule_matched: true
idp_id: 912ef72e-2239-4996-b81e-469e87a27cd6
idp_role:
- itsuperusers
- vip
mac: ac3eb179e535
nacrule_id: 32f27e7d-ff26-4a9b-b3d1-ff9bcb264c62
nacrule_matched: true
nas_vendor: juniper-mist
org_id: 27547ac2-d114-4e04-beb1-f3f1e6e81ec6
random_mac: 'false'
resp_attrs:
- Tunnel-Type=VLAN
- Tunnel-Medium-Type=IEEE-802
- Tunnel-Private-Group-Id=750
- User-Name=anonymous
site_id: 441a1214-6928-442a-8e92-e1d34b8ec6a6
ssid: mist_nac
timestamp: 1691512031.358188
type: NAC_CLIENT_PERMIT
username: user@deaflyz.net
vlan: '750'
start: 1512572151
total: 1
contentMediaType: application/json
examples:
NAC-client_events:
value:
end: 1513176951
limit: 10
results:
- ap: 5c5b35513227
auth_type: eap-ttls
bssid: 5c5b355fafcc
dryrun_nacrule_id: 32f27e7d-ff26-4a9b-b3d1-ff9bcb264012
dryrun_nacrule_matched: true
idp_id: 912ef72e-2239-4996-b81e-469e87a27cd6
idp_role:
- itsuperusers
- vip
mac: ac3eb179e535
nacrule_id: 32f27e7d-ff26-4a9b-b3d1-ff9bcb264c62
nacrule_matched: true
nas_vendor: juniper-mist
org_id: 27547ac2-d114-4e04-beb1-f3f1e6e81ec6
random_mac: 'false'
resp_attrs:
- Tunnel-Type=VLAN
- Tunnel-Medium-Type=IEEE-802
- Tunnel-Private-Group-Id=750
- User-Name=anonymous
site_id: 441a1214-6928-442a-8e92-e1d34b8ec6a6
ssid: mist_nac
timestamp: 1691512031.358188
type: NAC_CLIENT_PERMIT
username: user@deaflyz.net
vlan: '750'
start: 1512572151
total: 1
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_events_nac_client_search'
- description: Paginated response for NAC client event search results
examples:
- end: 1513176951
limit: 10
results:
- ap: 5c5b35513227
auth_type: eap-ttls
bssid: 5c5b355fafcc
dryrun_nacrule_id: 32f27e7d-ff26-4a9b-b3d1-ff9bcb264012
dryrun_nacrule_matched: true
idp_id: 912ef72e-2239-4996-b81e-469e87a27cd6
idp_role:
- itsuperusers
- vip
mac: ac3eb179e535
nacrule_id: 32f27e7d-ff26-4a9b-b3d1-ff9bcb264c62
nacrule_matched: true
nas_vendor: juniper-mist
org_id: 27547ac2-d114-4e04-beb1-f3f1e6e81ec6
random_mac: 'false'
resp_attrs:
- Tunnel-Type=VLAN
- Tunnel-Medium-Type=IEEE-802
- Tunnel-Private-Group-Id=750
- User-Name=anonymous
site_id: 441a1214-6928-442a-8e92-e1d34b8ec6a6
ssid: mist_nac
timestamp: 1691512031.358188
type: NAC_CLIENT_PERMIT
username: user@deaflyz.net
vlan: '750'
start: 1512572151
total: 1
contentMediaType: application/vnd.api+json
examples:
NAC-client_events:
value:
end: 1513176951
limit: 10
results:
- ap: 5c5b35513227
auth_type: eap-ttls
bssid: 5c5b355fafcc
dryrun_nacrule_id: 32f27e7d-ff26-4a9b-b3d1-ff9bcb264012
dryrun_nacrule_matched: true
idp_id: 912ef72e-2239-4996-b81e-469e87a27cd6
idp_role:
- itsuperusers
- vip
mac: ac3eb179e535
nacrule_id: 32f27e7d-ff26-4a9b-b3d1-ff9bcb264c62
nacrule_matched: true
nas_vendor: juniper-mist
org_id: 27547ac2-d114-4e04-beb1-f3f1e6e81ec6
random_mac: 'false'
resp_attrs:
- Tunnel-Type=VLAN
- Tunnel-Medium-Type=IEEE-802
- Tunnel-Private-Group-Id=750
- User-Name=anonymous
site_id: 441a1214-6928-442a-8e92-e1d34b8ec6a6
ssid: mist_nac
timestamp: 1691512031.358188
type: NAC_CLIENT_PERMIT
username: user@deaflyz.net
vlan: '750'
start: 1512572151
total: 1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/nac_clients/search:
get:
tags:
- Orgs Clients - NAC
summary: searchOrgNacClients
description: Search NAC client records across the organization with filters for authentication, endpoint posture, identity, network, NAC rule, site, and time attributes.
operationId: searchOrgNacClients
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: ap
in: query
description: MAC address of the AP the client is/was connected to
style: form
explode: true
schema:
type: string
- name: auth_type
in: query
description: Authentication type, e.g. "eap-tls", "eap-peap", "eap-ttls", "eap-teap", "mab", "psk", "device-auth". Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- mab,eap-tls
- name: cert_expiry_duration
in: query
description: Filter by certificate expiry within a specific duration from now (e.g., "7d" for 7 days, "1m" for 1 month). Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- 7d,1m
- 7d
- 1m
examples:
Untitled Example1:
value: 7d,1m
Untitled Example2:
value: 7d
Untitled Example3:
value: 1m
- name: edr_managed
in: query
description: Filters NAC clients that are integrated with EDR providers
style: form
explode: true
schema:
type: boolean
- name: edr_providers
in: query
description: "EDR provider of the client's organization. enum: `crowdstrike`, `sentinelone`"
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/edr_provider'
- description: "EDR provider of the client's organization. enum: `crowdstrike`, `sentinelone`"
- name: edr_status
in: query
description: 'EDR status used to filter NAC clients. enum: `sentinelone_healthy`, `sentinelone_infected`, `crowdstrike_low`, `crowdstrike_medium`, `crowdstrike_high`, `crowdstrike_critical`, `crowdstrike_informational`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/edr_status'
- description: 'EDR status used to filter NAC clients. enum: `sentinelone_healthy`, `sentinelone_infected`, `crowdstrike_low`, `crowdstrike_medium`, `crowdstrike_high`, `crowdstrike_critical`, `crowdstrike_informational`'
- name: family
in: query
description: Partial / full Client family (e.g. "Phone/Tablet/Wearable", "Access Point"). Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `Surveillance*` and `*urveillance*` match `Surveillance Camera`). Suffix-only wildcards (e.g. `*Camera`) are not supported. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- Surveillance Camera,Surveillance*
- Surveillance Camera
- Surveillance*
- '*urveillance*'
examples:
Untitled Example1:
value: Surveillance Camera,Surveillance*
Untitled Example2:
value: Surveillance Camera
Untitled Example3:
value: Surveillance*
Untitled Example4:
value: '*urveillance*'
- name: hostname
in: query
description: Partial / full Client hostname. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `everest*` and `*rest*` match `my-everest-client`). Suffix-only wildcards (e.g. `*everest`) are not supported. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- my-everest-client,my-everest*
- my-everest-client
- my-everest*
- '*everest*'
examples:
Untitled Example1:
value: my-everest-client,my-everest*
Untitled Example2:
value: my-everest-client
Untitled Example3:
value: my-everest*
Untitled Example4:
value: '*everest*'
- name: idp_id
in: query
description: SSO ID, if present and used
style: form
explode: true
schema:
type: string
- name: mac
in: query
description: Partial / full Client MAC address. Use a single value; comma-separated values are not supported. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `aabbcc*` and `*bbcc*` match `aabbccddeeff`). Suffix-only wildcards (e.g. `*bccddeeff`) are not supported
style: form
explode: true
schema:
type: string
examples:
- aabbccddeeff
- aabbcc*
- '*bbcc*'
examples:
Untitled Example1:
value: aabbccddeeff
Untitled Example2:
value: aabbcc*
Untitled Example3:
value: '*bbcc*'
- name: mdm_compliance
in: query
description: MDM compliance of client i.e "compliant", "not compliant"
style: form
explode: true
schema:
type: string
- name: mdm_provider
in: query
description: MDM provider of client’s organization eg "intune", "jamf"
style: form
explode: true
schema:
type: string
- name: mdm_managed
in: query
description: Filters NAC clients that are managed by MDM providers
style: form
explode: true
schema:
type: boolean
- name: mfg
in: query
description: Partial / full Client manufacturer (e.g. "apple", "cisco", "juniper"). Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `Raspberry Pi*` and `*Pi*` match `Raspberry Pi Trading Ltd`). Suffix-only wildcards (e.g. `*Ltd`) are not supported. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- Raspberry Pi Trading Ltd,Raspberry Pi*
- Raspberry Pi Trading Ltd
- Raspberry Pi*
- '*Pi*'
examples:
Untitled Example1:
value: Raspberry Pi Trading Ltd,Raspberry Pi*
Untitled Example2:
value: Raspberry Pi Trading Ltd
Untitled Example3:
value: Raspberry Pi*
Untitled Example4:
value: '*Pi*'
- name: model
in: query
description: Client model, e.g. "iPhone 12", "MX100"
style: form
explode: true
schema:
type: string
- name: nacrule_name
in: query
description: NAC Policy Rule Name matched
style: form
explode: true
schema:
type: string
- name: nacrule_id
in: query
description: NAC Policy Rule ID, if matched
style: form
explode: true
schema:
type: string
- name: nacrule_matched
in: query
description: NAC Policy Rule Matched
style: form
explode: true
schema:
type: boolean
- name: nas_vendor
in: query
description: Vendor of NAS device
style: form
explode: true
schema:
type: string
- name: nas_ip
in: query
description: IP address of NAS device. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- 192.0.2.10,192.0.2.11
- name: ingress_vlan
in: query
description: Vendor specific VLAN ID in RADIUS requests
style: form
explode: true
schema:
type: string
- name: os
in: query
description: Client OS, e.g. "iOS 18.1", "Android", "Windows", "Linux"
style: form
explode: true
schema:
type: string
- name: ssid
in: query
description: Filter results by SSID
style: form
explode: true
schema:
type: string
- name: status
in: query
description: 'Client connection status used to filter results. enum: `permitted`, `session_started`, `session_stopped`, `denied`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/nac_client_last_status'
- description: 'Client connection status used to filter results. enum: `permitted`, `session_started`, `session_stopped`, `denied`'
examples:
- permitted
- name: text
in: query
description: partial / full MAC address, last_username, device_mac, nas_ip or last_ap
style: form
explode: true
schema:
type: string
- name: type
in: query
description: Client type i.e. "wireless", "wired" etc. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- wired,wireless
- name: usermac_label
in: query
description: Labels derived from usermac entry
style: form
explode: true
schema:
uniqueItems: true
type: array
items:
type: string
- name: username
in: query
description: Filter results by username
style: form
explode: true
schema:
type: string
- name: vlan
in: query
description: Filter results by VLAN ID
style: form
explode: true
schema:
type: string
- name: site_id
in: query
description: Filter results by one site identifier. Use a single value; comma-separated values are not supported
style: form
explode: true
schema:
type: string
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order.
style: form
explode: true
schema:
type: string
default: wxid
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_client_nac_search'
- description: Paginated NAC client search response
examples:
- end: 1513362753
limit: 3
results:
- ap:
- 5c5b35bf16bb
- d4dc090041b4
auth_type: eap-tls
cert_cn:
- john@mycorp.net
cert_issuer:
- /C=US/ST=CA/CN=MyCorp
client_ip:
- 10.7.51.74
edr_managed: true
edr_providers:
- sentinelone
edr_status:
- sentinelone_healthy
idp_id: string
idp_role:
- string
last_ap: string
last_cert_cn: john@mycorp.net
last_cert_expiry: 1746711240
last_cert_issuer: /C=US/ST=CA/CN=MyCorp
last_cert_serial: 2c63510123456789
last_cert_subject: /C=US/O=MyCorp/CN=john@mycorp.net/emailAddress=john@mycorp.net
last_client_ip: 10.7.51.74
last_nacrule_id: 603b62db-d839-4152-9f7f-f2578443de8d
last_nacrule_name: Wireless Cert Auth
last_nas_vendor: juniper-mist
last_ssid: string
last_status: permitted
mac: string
nacrule_id:
- 603b62db-d839-4152-9f7f-f2578443de8d
nacrule_matched: true
nacrule_name:
- Wireless Cert Auth
nas_vendor:
- juniper-mist
org_id: 31f27122-68a9-47a4-b526-8fb8a62a8acb
random_mac: 'true'
site_id: 832b1d74-9531-409b-ae37-4d7f3edbde92
ssid:
- string
timestamp: 1694689718.612
type: wireless
usermac_label:
- non-compliant
- building26
- floor52
start: 1513276353
total: 2
contentMediaType: application/json
examples:
Example:
value:
end: 1513362753
limit: 3
results:
- ap:
- 5c5b35bf16bb
- d4dc090041b4
auth_type: eap-tls
cert_cn:
- john@mycorp.net
cert_issuer:
- /C=US/ST=CA/CN=MyCorp
client_ip:
- 10.7.51.74
edr_managed: true
edr_providers:
- sentinelone
edr_status:
- sentinelone_healthy
idp_id: string
idp_role:
- string
last_ap: string
last_cert_cn: john@mycorp.net
last_cert_expiry: 1746711240
last_cert_issuer: /C=US/ST=CA/CN=MyCorp
last_cert_serial: 2c63510123456789
last_cert_subject: /C=US/O=MyCorp/CN=john@mycorp.net/emailAddress=john@mycorp.net
last_client_ip: 10.7.51.74
last_nacrule_id: 603b62db-d839-4152-9f7f-f2578443de8d
last_nacrule_name: Wireless Cert Auth
last_nas_vendor: juniper-mist
last_ssid: string
last_status: permitted
mac: string
nacrule_id:
- 603b62db-d839-4152-9f7f-f2578443de8d
nacrule_matched: true
nacrule_name:
- Wireless Cert Auth
nas_vendor:
- juniper-mist
org_id: 31f27122-68a9-47a4-b526-8fb8a62a8acb
random_mac: 'true'
site_id: 832b1d74-9531-409b-ae37-4d7f3edbde92
ssid:
- string
timestamp: 1694689718.612
type: wireless
usermac_label:
- non-compliant
- building26
- floor52
start: 1513276353
total: 2
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_client_nac_search'
- description: Paginated NAC client search response
examples:
- end: 1513362753
limit: 3
results:
- ap:
- 5c5b35bf16bb
- d4dc090041b4
auth_type: eap-tls
cert_cn:
- john@mycorp.net
cert_issuer:
- /C=US/ST=CA/CN=MyCorp
client_ip:
- 10.7.51.74
edr_managed: true
edr_providers:
- sentinelone
edr_status:
- sentinelone_healthy
idp_id: string
idp_role:
- string
last_ap: string
last_cert_cn: john@mycorp.net
last_cert_expiry: 1746711240
last_cert_issuer: /C=US/ST=CA/CN=MyCorp
last_cert_serial: 2c63510123456789
last_cert_subject: /C=US/O=MyCorp/CN=john@mycorp.net/emailAddress=john@mycorp.net
last_client_ip: 10.7.51.74
last_nacrule_id: 603b62db-d839-4152-9f7f-f2578443de8d
last_nacrule_name: Wireless Cert Auth
last_nas_vendor: juniper-mist
last_ssid: string
last_status: permitted
mac: string
nacrule_id:
- 603b62db-d839-4152-9f7f-f2578443de8d
nacrule_matched: true
nacrule_name:
- Wireless Cert Auth
nas_vendor:
- juniper-mist
org_id: 31f27122-68a9-47a4-b526-8fb8a62a8acb
random_mac: 'true'
site_id: 832b1d74-9531-409b-ae37-4d7f3edbde92
ssid:
- string
timestamp: 1694689718.612
type: wireless
usermac_label:
- non-compliant
- building26
- floor52
start: 1513276353
total: 2
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 1513362753
limit: 3
results:
- ap:
- 5c5b35bf16bb
- d4dc090041b4
auth_type: eap-tls
cert_cn:
- john@mycorp.net
cert_issuer:
- /C=US/ST=CA/CN=MyCorp
client_ip:
- 10.7.51.74
edr_managed: true
edr_providers:
- sentinelone
edr_status:
- sentinelone_healthy
idp_id: string
idp_role:
- string
last_ap: string
last_cert_cn: john@mycorp.net
last_cert_expiry: 1746711240
last_cert_issuer: /C=US/ST=CA/CN=MyCorp
last_cert_serial: 2c63510123456789
last_cert_subject: /C=US/O=MyCorp/CN=john@mycorp.net/emailAddress=john@mycorp.net
last_client_ip: 10.7.51.74
last_nacrule_id: 603b62db-d839-4152-9f7f-f2578443de8d
last_nacrule_name: Wireless Cert Auth
last_nas_vendor: juniper-mist
last_ssid: string
last_status: permitted
mac: string
nacrule_id:
- 603b62db-d839-4152-9f7f-f2578443de8d
nacrule_matched: true
nacrule_name:
- Wireless Cert Auth
nas_vendor:
- juniper-mist
org_id: 31f27122-68a9-47a4-b526-8fb8a62a8acb
random_mac: 'true'
site_id: 832b1d74-9531-409b-ae37-4d7f3edbde92
ssid:
- string
timestamp: 1694689718.612
type: wireless
usermac_label:
- non-compliant
- building26
- floor52
start: 1513276353
total: 2
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/nac_clients/{client_mac}/coa:
post:
tags:
- Orgs Clients - NAC
summary: sendOrgNacClientCoA
description: Sends CoA (Change of Authorization) command to a NAC client.
operationId: sendOrgNacClientCoA
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: client_mac
in: path
description: ''
required: true
schema:
pattern: ^[0-9a-fA-F]{12}$
type: string
examples:
- 0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/nac_client_coa'
- description: Request Body
contentMediaType: application/json
required: false
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/nac_client_coa_response'
- description: Response returned after sending a NAC client CoA command
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/nac_client_coa_response'
- description: Response returned after sending a NAC client CoA command
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/wan_client/events/count:
get:
tags:
- Orgs Clients - Wan
summary: countOrgWanClientEvents
description: Count by Distinct Attributes of Org WAN Client-Events
operationId: countOrgWanClientEvents
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field used to group this count response. enum: `hostname`, `ip`, `mac`, `mfg`, `type`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/org_wan_clients_events_count_distinct'
- description: 'Field used to group this count response. enum: `hostname`, `ip`, `mac`, `mfg`, `type`'
- name: type
in: query
description: See [List Device Events Definitions]($e/Constants%20Events/listDeviceEventsDefinitions)
style: form
explode: true
schema:
type: string
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/wan_clients/count:
get:
tags:
- Orgs Clients - Wan
summary: countOrgWanClients
description: Count by Distinct Attributes of Org WAN Clients
operationId: countOrgWanClients
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field used to group this count response. enum: `hostname`, `ip`, `mac`, `mfg`, `network`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/org_wan_clients_count_distinct'
- description: 'Field used to group this count response. enum: `hostname`, `ip`, `mac`, `mfg`, `network`'
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/wan_clients/events/search:
get:
tags:
- Orgs Clients - Wan
summary: searchOrgWanClientEvents
description: Search Org WAN Client Events
operationId: searchOrgWanClientEvents
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: type
in: query
description: See [List Device Events Definitions]($e/Constants%20Events/listDeviceEventsDefinitions)
style: form
explode: true
schema:
type: string
- name: mac
in: query
description: Partial / full Client MAC address. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `aabbcc*` and `*bbcc*` match `aabbccddeeff`). Suffix-only wildcards (e.g. `*bccddeeff`) are not supported
style: form
explode: true
schema:
type: string
examples:
- aabbccddeeff
- aabbcc*
- '*bbcc*'
examples:
Untitled Example1:
value: aabbccddeeff
Untitled Example2:
value: aabbcc*
Untitled Example3:
value: '*bbcc*'
- name: hostname
in: query
description: Partial / full Client hostname. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `everest*` and `*rest*` match `my-everest-client`). Suffix-only wildcards (e.g. `*everest`) are not supported
style: form
explode: true
schema:
type: string
examples:
- my-everest-client
- my-everest*
- '*everest*'
examples:
Untitled Example1:
value: my-everest-client
Untitled Example2:
value: my-everest*
Untitled Example3:
value: '*everest*'
- name: ip
in: query
description: Partial / full Client IP address. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `10.100.10.*` and `*100.10.*` match `10.100.10.54`). Suffix-only wildcards (e.g. `*.54`) are not supported
style: form
explode: true
schema:
type: string
examples:
- 10.100.10.54
- 10.100.10.*
- '*100.10.*'
examples:
Untitled Example1:
value: 10.100.10.54
Untitled Example2:
value: 10.100.10.*
Untitled Example3:
value: '*100.10.*'
- name: mfg
in: query
description: Partial / full Client manufacturer (e.g. "apple", "cisco", "juniper"). Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `Raspberry Pi*` and `*Pi*` match `Raspberry Pi Trading Ltd`). Suffix-only wildcards (e.g. `*Ltd`) are not supported
style: form
explode: true
schema:
type: string
examples:
- Raspberry Pi Trading Ltd
- Raspberry Pi*
- '*Pi*'
examples:
Untitled Example1:
value: Raspberry Pi Trading Ltd
Untitled Example2:
value: Raspberry Pi*
Untitled Example3:
value: '*Pi*'
- name: nacrule_id
in: query
description: Filter results by NAC rule identifier
style: form
explode: true
schema:
type: string
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/search_events_wan_client'
- description: Paginated response for WAN client event searches
examples:
- end: 0
limit: 0
results:
- When: 2022-12-31 23:59:59.293000+00:00
ev_type: CLIENT_IP_ASSIGNED
metadata: {}
org_id: b0b9f142-aaba-11e6-aafc-0242ac110002
random_mac: true
site_id: fc656275-b157-43fd-b922-5f4f341c19bf
text: DHCP Ack IP 192.168.88.216
wcid: 62bbfb75-10d8-49d1-dec7-d2df91624287
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
end: 0
limit: 0
results:
- When: 2022-12-31 23:59:59.293000+00:00
ev_type: CLIENT_IP_ASSIGNED
metadata: {}
org_id: b0b9f142-aaba-11e6-aafc-0242ac110002
random_mac: true
site_id: fc656275-b157-43fd-b922-5f4f341c19bf
text: DHCP Ack IP 192.168.88.216
wcid: 62bbfb75-10d8-49d1-dec7-d2df91624287
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/search_events_wan_client'
- description: Paginated response for WAN client event searches
examples:
- end: 0
limit: 0
results:
- When: 2022-12-31 23:59:59.293000+00:00
ev_type: CLIENT_IP_ASSIGNED
metadata: {}
org_id: b0b9f142-aaba-11e6-aafc-0242ac110002
random_mac: true
site_id: fc656275-b157-43fd-b922-5f4f341c19bf
text: DHCP Ack IP 192.168.88.216
wcid: 62bbfb75-10d8-49d1-dec7-d2df91624287
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 0
limit: 0
results:
- When: 2022-12-31 23:59:59.293000+00:00
ev_type: CLIENT_IP_ASSIGNED
metadata: {}
org_id: b0b9f142-aaba-11e6-aafc-0242ac110002
random_mac: true
site_id: fc656275-b157-43fd-b922-5f4f341c19bf
text: DHCP Ack IP 192.168.88.216
wcid: 62bbfb75-10d8-49d1-dec7-d2df91624287
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/wan_clients/search:
get:
tags:
- Orgs Clients - Wan
summary: searchOrgWanClients
description: Search Org WAN Clients
operationId: searchOrgWanClients
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: site_id
in: query
description: Filter results by site identifier
style: form
explode: true
schema:
type: string
contentEncoding: uuid
examples:
- 72771e6a-6f5e-4de4-a5b9-1266c4197811
- name: hostname
in: query
description: Partial / full Client hostname. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `everest*` and `*rest*` match `my-everest-client`). Suffix-only wildcards (e.g. `*everest`) are not supported. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- my-everest-client,my-everest*
- my-everest-client
- my-everest*
- '*everest*'
examples:
Untitled Example1:
value: my-everest-client,my-everest*
Untitled Example2:
value: my-everest-client
Untitled Example3:
value: my-everest*
Untitled Example4:
value: '*everest*'
- name: ip
in: query
description: Partial / full Client IP address. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `10.100.10.*` and `*100.10.*` match `10.100.10.54`). Suffix-only wildcards (e.g. `*.54`) are not supported. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- 10.100.10.54,10.100.10.*
- 10.100.10.54
- 10.100.10.*
- '*100.10.*'
examples:
Untitled Example1:
value: 10.100.10.54,10.100.10.*
Untitled Example2:
value: 10.100.10.54
Untitled Example3:
value: 10.100.10.*
Untitled Example4:
value: '*100.10.*'
- name: ip_src
in: query
description: Filter results by source IP address
style: form
explode: true
schema:
type: string
examples:
- dhcp
- name: mac
in: query
description: Filter results by MAC address. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- 5c5b53010101,5c5b53020202
- 5c5b53010101
examples:
Untitled Example1:
value: 5c5b53010101,5c5b53020202
Untitled Example2:
value: 5c5b53010101
- name: mfg
in: query
description: Filter results by manufacturer. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- Unknown,Juniper Networks
- name: network
in: query
description: Partial / full Name of the network the client is/was connected to. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `my-corp*` and `*corp*` match `my-corp-network`). Suffix-only wildcards (e.g. `*corp`) are not supported. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- my-corp-network,my-corp*
- my-corp-network
- my-corp*
- '*corp*'
examples:
Untitled Example1:
value: my-corp-network,my-corp*
Untitled Example2:
value: my-corp-network
Untitled Example3:
value: my-corp*
Untitled Example4:
value: '*corp*'
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/search_wan_client'
- description: Paginated response for WAN client searches
examples:
- end: 0
limit: 0
results:
- hostname:
- sonoszp
ip:
- 192.168.1.139
last_hostname: sonoszp
last_ip: 192.168.1.139
mfg: Sonos
org_id: b4e16c72-d50e-4c03-a952-a3217e231e2c
site_id: f688779c-e335-4f88-8d7c-9c5e9964528b
wcid: 8bbe7389-212b-c65d-2208-00fab2017936
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
end: 0
limit: 0
results:
- hostname:
- sonoszp
ip:
- 192.168.1.139
last_hostname: sonoszp
last_ip: 192.168.1.139
mfg: Sonos
org_id: b4e16c72-d50e-4c03-a952-a3217e231e2c
site_id: f688779c-e335-4f88-8d7c-9c5e9964528b
wcid: 8bbe7389-212b-c65d-2208-00fab2017936
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/search_wan_client'
- description: Paginated response for WAN client searches
examples:
- end: 0
limit: 0
results:
- hostname:
- sonoszp
ip:
- 192.168.1.139
last_hostname: sonoszp
last_ip: 192.168.1.139
mfg: Sonos
org_id: b4e16c72-d50e-4c03-a952-a3217e231e2c
site_id: f688779c-e335-4f88-8d7c-9c5e9964528b
wcid: 8bbe7389-212b-c65d-2208-00fab2017936
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 0
limit: 0
results:
- hostname:
- sonoszp
ip:
- 192.168.1.139
last_hostname: sonoszp
last_ip: 192.168.1.139
mfg: Sonos
org_id: b4e16c72-d50e-4c03-a952-a3217e231e2c
site_id: f688779c-e335-4f88-8d7c-9c5e9964528b
wcid: 8bbe7389-212b-c65d-2208-00fab2017936
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/wired_clients/count:
get:
tags:
- Orgs Clients - Wired
summary: countOrgWiredClients
description: >-
Count by Distinct Attributes of Clients
Note: For list of available `type` values, please refer to [List Client Events Definitions]($e/Constants%20Events/listClientEventsDefinitions)
operationId: countOrgWiredClients
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field used to group this count response. enum: `device_mac`, `mac`, `port_id`, `site_id`, `type`, `vlan`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/org_wired_clients_count_distinct'
- description: 'Field used to group this count response. enum: `device_mac`, `mac`, `port_id`, `site_id`, `type`, `vlan`'
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/wired_clients/search:
get:
tags:
- Orgs Clients - Wired
summary: searchOrgWiredClients
description: >-
Search for Wired Clients in org
Note: For list of available `type` values, please refer to [List Client Events Definitions]($e/Constants%20Events/listClientEventsDefinitions)
operationId: searchOrgWiredClients
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: auth_state
in: query
description: Filter results by auth state
style: form
explode: true
schema:
type: string
- name: auth_method
in: query
description: Filter results by authentication method. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- server_reject,mac_auth
- name: source
in: query
description: 'Filter results by client learning source. enum: `lldp`, `mac`. Accepts multiple comma-separated values.'
style: form
explode: true
schema:
type: string
examples:
- lldp,mac
- name: site_id
in: query
description: Filter results by site identifier
style: form
explode: true
schema:
type: string
- name: device_mac
in: query
description: Filter results by one or more gateway or switch MAC addresses where the client has connected. Supports comma-separated values
style: form
explode: true
schema:
type: string
- name: mac
in: query
description: Partial / full Client MAC address. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `aabbcc*` and `*bbcc*` match `aabbccddeeff`). Suffix-only wildcards (e.g. `*bccddeeff`) are not supported. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- aabbccddeeff,aabbcc*
- aabbccddeeff
- aabbcc*
- '*bbcc*'
examples:
Untitled Example1:
value: aabbccddeeff,aabbcc*
Untitled Example2:
value: aabbccddeeff
Untitled Example3:
value: aabbcc*
Untitled Example4:
value: '*bbcc*'
- name: port_id
in: query
description: Filter results by one or more port identifiers where the client has connected. Supports comma-separated values
style: form
explode: true
schema:
type: string
- name: vlan
in: query
description: Filter results by one or more VLAN IDs. Supports comma-separated values
style: form
explode: true
schema:
type: string
examples:
- '1'
- 1,2
examples:
Untitled Example1:
value: '1'
Untitled Example2:
value: 1,2
- name: ip
in: query
description: Filter results by one or more IPv4 addresses. Supports comma-separated values
style: form
explode: true
schema:
type: string
examples:
- 192.168.1.1
- 192.168.1.1,192.168.1.2
examples:
Untitled Example1:
value: 192.168.1.1
Untitled Example2:
value: 192.168.1.1,192.168.1.2
- name: manufacture
in: query
description: Filter results by manufacturer. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- Unknown,GIFA
- name: text
in: query
description: Partial / full Client MAC address, hostname or username. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `aabbcc*` and `*bbcc*` match `aabbccddeeff`). Suffix-only wildcards (e.g. `*ddeeff`) are not supported
style: form
explode: true
schema:
type: string
- name: nacrule_id
in: query
description: Filter results by NAC rule identifier
style: form
explode: true
schema:
type: string
- name: dhcp_hostname
in: query
description: Filter results by DHCP hostname. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- client-a,client-b
- name: dhcp_fqdn
in: query
description: Filter results by DHCP FQDN
style: form
explode: true
schema:
type: string
- name: dhcp_client_identifier
in: query
description: Filter results by DHCP client identifier. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- MAC address a8f7d982288f,MAC address 5c5b351e120c
- name: dhcp_vendor_class_identifier
in: query
description: DHCP Vendor Class Identifier. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- Mist AP34-WW,Mist BT11-WW
- name: dhcp_request_params
in: query
description: Filter results by DHCP request parameters. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- 1 121 3 6 12 15 28 42 43 180,1 3 6 12 15 28 42 43 180
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/search_wired_client'
- description: Paginated response for wired client searches
examples:
- end: 1648529800.8221116
limit: 1000
results:
- auth_method: mac_auth
auth_state: authenticated
device_mac:
- '001122334455'
dhcp_client_identifier: MAC address 00155df6d500
dhcp_client_options:
- code: DHO_DHCP_MESSAGE_TYPE(53)
data: DHCPREQUEST
- code: DHO_DHCP_CLIENT_IDENTIFIER(61)
data: MAC address 00155df6d500
- code: DHO_DHCP_REQUESTED_ADDRESS(50)
data: 172.17.10.255
- code: DHO_DHCP_SERVER_IDENTIFIER(54)
data: 172.17.8.1
- code: DHO_DHCP_MAX_MESSAGE_SIZE(57)
data: '1280'
- code: DHO_DHCP_PARAMETER_REQUEST_LIST(55)
data: ' 1 3 6 12 15 28 43 180'
- code: DHO_VENDOR_CLASS_IDENTIFIER(60)
data: MSFT 5.0
- code: DHO_HOST_NAME(12)
data: ITS-VMMT0-D1N02
dhcp_fqdn: ITS-VMMT0-D1N02.mgthub.local
dhcp_hostname: ITS-VMMT0-D1N02
dhcp_request_params: 1 3 6 15 31 33 43 44 46 47 119 121 249 252
dhcp_vendor_class_identifier: MSFT 5.0
mac: '112233445566'
org_id: c168ddee-c14c-11e5-8e81-1258369c38a9
port_id:
- et-0/0/1
site_id: c168ddee-c14c-11e5-8e81-1258369c38a9
timestamp: 1571174567.807
vlan:
- 0
- 1001
start: 1648443400.8221116
total: 1
contentMediaType: application/json
examples:
Example:
value:
end: 1648529800.8221116
limit: 1000
results:
- auth_method: mac_auth
auth_state: authenticated
device_mac:
- '001122334455'
dhcp_client_identifier: MAC address 00155df6d500
dhcp_client_options:
- code: DHO_DHCP_MESSAGE_TYPE(53)
data: DHCPREQUEST
- code: DHO_DHCP_CLIENT_IDENTIFIER(61)
data: MAC address 00155df6d500
- code: DHO_DHCP_REQUESTED_ADDRESS(50)
data: 172.17.10.255
- code: DHO_DHCP_SERVER_IDENTIFIER(54)
data: 172.17.8.1
- code: DHO_DHCP_MAX_MESSAGE_SIZE(57)
data: '1280'
- code: DHO_DHCP_PARAMETER_REQUEST_LIST(55)
data: ' 1 3 6 12 15 28 43 180'
- code: DHO_VENDOR_CLASS_IDENTIFIER(60)
data: MSFT 5.0
- code: DHO_HOST_NAME(12)
data: ITS-VMMT0-D1N02
dhcp_fqdn: ITS-VMMT0-D1N02.mgthub.local
dhcp_hostname: ITS-VMMT0-D1N02
dhcp_request_params: 1 3 6 15 31 33 43 44 46 47 119 121 249 252
dhcp_vendor_class_identifier: MSFT 5.0
mac: '112233445566'
org_id: c168ddee-c14c-11e5-8e81-1258369c38a9
port_id:
- et-0/0/1
site_id: c168ddee-c14c-11e5-8e81-1258369c38a9
timestamp: 1571174567.807
vlan:
- 0
- 1001
start: 1648443400.8221116
total: 1
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/search_wired_client'
- description: Paginated response for wired client searches
examples:
- end: 1648529800.8221116
limit: 1000
results:
- auth_method: mac_auth
auth_state: authenticated
device_mac:
- '001122334455'
dhcp_client_identifier: MAC address 00155df6d500
dhcp_client_options:
- code: DHO_DHCP_MESSAGE_TYPE(53)
data: DHCPREQUEST
- code: DHO_DHCP_CLIENT_IDENTIFIER(61)
data: MAC address 00155df6d500
- code: DHO_DHCP_REQUESTED_ADDRESS(50)
data: 172.17.10.255
- code: DHO_DHCP_SERVER_IDENTIFIER(54)
data: 172.17.8.1
- code: DHO_DHCP_MAX_MESSAGE_SIZE(57)
data: '1280'
- code: DHO_DHCP_PARAMETER_REQUEST_LIST(55)
data: ' 1 3 6 12 15 28 43 180'
- code: DHO_VENDOR_CLASS_IDENTIFIER(60)
data: MSFT 5.0
- code: DHO_HOST_NAME(12)
data: ITS-VMMT0-D1N02
dhcp_fqdn: ITS-VMMT0-D1N02.mgthub.local
dhcp_hostname: ITS-VMMT0-D1N02
dhcp_request_params: 1 3 6 15 31 33 43 44 46 47 119 121 249 252
dhcp_vendor_class_identifier: MSFT 5.0
mac: '112233445566'
org_id: c168ddee-c14c-11e5-8e81-1258369c38a9
port_id:
- et-0/0/1
site_id: c168ddee-c14c-11e5-8e81-1258369c38a9
timestamp: 1571174567.807
vlan:
- 0
- 1001
start: 1648443400.8221116
total: 1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 1648529800.8221116
limit: 1000
results:
- auth_method: mac_auth
auth_state: authenticated
device_mac:
- '001122334455'
dhcp_client_identifier: MAC address 00155df6d500
dhcp_client_options:
- code: DHO_DHCP_MESSAGE_TYPE(53)
data: DHCPREQUEST
- code: DHO_DHCP_CLIENT_IDENTIFIER(61)
data: MAC address 00155df6d500
- code: DHO_DHCP_REQUESTED_ADDRESS(50)
data: 172.17.10.255
- code: DHO_DHCP_SERVER_IDENTIFIER(54)
data: 172.17.8.1
- code: DHO_DHCP_MAX_MESSAGE_SIZE(57)
data: '1280'
- code: DHO_DHCP_PARAMETER_REQUEST_LIST(55)
data: ' 1 3 6 12 15 28 43 180'
- code: DHO_VENDOR_CLASS_IDENTIFIER(60)
data: MSFT 5.0
- code: DHO_HOST_NAME(12)
data: ITS-VMMT0-D1N02
dhcp_fqdn: ITS-VMMT0-D1N02.mgthub.local
dhcp_hostname: ITS-VMMT0-D1N02
dhcp_request_params: 1 3 6 15 31 33 43 44 46 47 119 121 249 252
dhcp_vendor_class_identifier: MSFT 5.0
mac: '112233445566'
org_id: c168ddee-c14c-11e5-8e81-1258369c38a9
port_id:
- et-0/0/1
site_id: c168ddee-c14c-11e5-8e81-1258369c38a9
timestamp: 1571174567.807
vlan:
- 0
- 1001
start: 1648443400.8221116
total: 1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/clients/count:
get:
tags:
- Orgs Clients - Wireless
summary: countOrgWirelessClients
description: Count wireless client records across the organization, optionally grouped by `distinct` and filtered by client identity, AP, SSID, VLAN, IP, and time range.
operationId: countOrgWirelessClients
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field used to group this count response. enum: `ap`, `device`, `hostname`, `ip`, `mac`, `model`, `os`, `ssid`, `vlan`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/org_clients_count_distinct'
- description: 'Field used to group this count response. enum: `ap`, `device`, `hostname`, `ip`, `mac`, `model`, `os`, `ssid`, `vlan`'
- name: mac
in: query
description: Partial / full Client MAC address. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `aabbcc*` and `*bbcc*` match `aabbccddeeff`). Suffix-only wildcards (e.g. `*bccddeeff`) are not supported. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- aabbccddeeff,aabbcc*
- aabbccddeeff
- aabbcc*
- '*bbcc*'
examples:
Untitled Example1:
value: aabbccddeeff,aabbcc*
Untitled Example2:
value: aabbccddeeff
Untitled Example3:
value: aabbcc*
Untitled Example4:
value: '*bbcc*'
- name: hostname
in: query
description: Partial / full Client hostname. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `everest*` and `*rest*` match `my-everest-client`). Suffix-only wildcards (e.g. `*everest`) are not supported. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- my-everest-client,my-everest*
- my-everest-client
- my-everest*
- '*everest*'
examples:
Untitled Example1:
value: my-everest-client,my-everest*
Untitled Example2:
value: my-everest-client
Untitled Example3:
value: my-everest*
Untitled Example4:
value: '*everest*'
- name: device
in: query
description: Filter results by device type
style: form
explode: true
schema:
type: string
examples:
- iPhone
- name: os
in: query
description: Filter results by operating system
style: form
explode: true
schema:
type: string
examples:
- Windows 10
- name: model
in: query
description: Filter results by device model
style: form
explode: true
schema:
type: string
examples:
- iPhone 8
- name: ap
in: query
description: Filter results by AP MAC address
style: form
explode: true
schema:
type: string
examples:
- 5c5b53010101
- name: vlan
in: query
description: Filter results by VLAN ID
style: form
explode: true
schema:
type: string
examples:
- '10'
- name: ssid
in: query
description: Filter results by SSID
style: form
explode: true
schema:
type: string
examples:
- MySSID
- name: ip
in: query
description: Filter results by IPv4 address
style: form
explode: true
schema:
type: string
contentEncoding: ipv4
examples:
- 192.168.1.1
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/clients/events/count:
get:
tags:
- Orgs Clients - Wireless
summary: countOrgWirelessClientEvents
description: Count wireless client event records across the organization, optionally grouped by event attributes and filtered by event type, WLAN, radio, site, and time range.
operationId: countOrgWirelessClientEvents
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field used to group this count response. enum: `band`, `channel`, `proto`, `ssid`, `type`, `wlan_id`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/site_client_events_count_distinct'
- description: 'Field used to group this count response. enum: `band`, `channel`, `proto`, `ssid`, `type`, `wlan_id`'
examples:
- type
- name: type
in: query
description: See [List Device Events Definitions]($e/Constants%20Events/listDeviceEventsDefinitions). Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- MARVIS_EVENT_CLIENT_AUTH_FAILURE,CLIENT_DEAUTHENTICATION
- name: reason_code
in: query
description: Reason code filter for association and disassociation events
style: form
explode: true
schema:
type: integer
contentEncoding: int32
- name: ssid
in: query
description: Filter results by SSID
style: form
explode: true
schema:
type: string
- name: ap
in: query
description: Filter results by AP MAC address
style: form
explode: true
schema:
type: string
- name: proto
in: query
description: '802.11 protocol used to filter results. enum: `a`, `ac`, `ax`, `b`, `be`, `g`, `n`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/dot11_proto'
- description: '802.11 protocol used to filter results. enum: `a`, `ac`, `ax`, `b`, `be`, `g`, `n`'
- name: band
in: query
description: '802.11 band used to filter radio results. enum: `24`, `5`, `5-dedicated`, `5-selectable`, `6`, `6-dedicated`, `6-selectable`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/dot11_band'
- description: '802.11 band used to filter radio results. enum: `24`, `5`, `5-dedicated`, `5-selectable`, `6`, `6-dedicated`, `6-selectable`'
- name: wlan_id
in: query
description: Filter results by WLAN identifier
style: form
explode: true
schema:
type: string
- name: site_id
in: query
description: Filter results by site identifier
style: form
explode: true
schema:
type: string
contentEncoding: uuid
examples:
- 72771e6a-6f5e-4de4-a5b9-1266c4197811
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/clients/events/search:
get:
tags:
- Orgs Clients - Wireless
summary: searchOrgWirelessClientEvents
description: Search wireless client event records across the organization with filters for event type, reason code, SSID, AP, key management, protocol, band, WLAN, NAC rule, and time range.
operationId: searchOrgWirelessClientEvents
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: type
in: query
description: See [List Device Events Definitions]($e/Constants%20Events/listDeviceEventsDefinitions). Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- CLIENT_IP_ASSIGNED,CLIENT_DEAUTHENTICATION
- name: reason_code
in: query
description: Reason code filter for association and disassociation events. Accepts multiple comma-separated integer values.
style: form
explode: true
schema:
type: string
examples:
- 0,14
- '7'
examples:
Untitled Example1:
value: 0,14
Untitled Example2:
value: '7'
- name: ssid
in: query
description: Filter results by SSID. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- Corp,Guest
- MySSID
examples:
Untitled Example1:
value: Corp,Guest
Untitled Example2:
value: MySSID
- name: ap
in: query
description: Filter results by AP MAC address. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- 5c5b53010101,5c5b53020202
- 5c5b53010101
examples:
Untitled Example1:
value: 5c5b53010101,5c5b53020202
Untitled Example2:
value: 5c5b53010101
- name: key_mgmt
in: query
description: 'Key management protocol used to filter client events. enum: `WPA2-PSK`, `WPA2-PSK/CCMP`, `WPA2-PSK-FT`, `WPA2-PSK-SHA256`, `WPA3-EAP-SHA256`, `WPA3-EAP-SHA256/CCMP`, `WPA3-EAP-FT/GCMP256`, `WPA3-SAE-FT`, `WPA3-SAE-PSK`. Accepts multiple comma-separated values.'
style: form
explode: true
schema:
type: string
examples:
- WPA2-PSK,WPA2-PSK/CCMP
- name: proto
in: query
description: '802.11 protocol used to filter results. enum: `a`, `ac`, `ax`, `b`, `be`, `g`, `n`. Accepts multiple comma-separated values.'
style: form
explode: true
schema:
type: string
examples:
- ax,ac
- name: band
in: query
description: '802.11 band used to filter radio results. enum: `24`, `5`, `5-dedicated`, `5-selectable`, `6`, `6-dedicated`, `6-selectable`. Accepts multiple comma-separated values.'
style: form
explode: true
schema:
type: string
examples:
- 6,5
- name: wlan_id
in: query
description: Filter results by WLAN identifier
style: form
explode: true
schema:
type: string
contentEncoding: uuid
examples:
- 7dae216d-7c98-a51b-e068-dd7d477b7216
- name: nacrule_id
in: query
description: Filter results by NAC rule identifier. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
contentEncoding: uuid
examples:
- 7dae216d-7c98-a51b-e068-dd7d477b7216
examples:
Untitled Example2:
value: 7dae216d-7c98-a51b-e068-dd7d477b7216
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_events_search'
- description: Paginated response for wireless client event search results
examples:
- end: 0
limit: 0
results:
- ap: string
band: '24'
bssid: string
channel: 0
proto: a
ssid: string
text: string
timestamp: 0
type: string
type_code: 0
wlan_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
end: 0
limit: 0
results:
- ap: string
band: '24'
bssid: string
channel: 0
proto: a
ssid: string
text: string
timestamp: 0
type: string
type_code: 0
wlan_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_events_search'
- description: Paginated response for wireless client event search results
examples:
- end: 0
limit: 0
results:
- ap: string
band: '24'
bssid: string
channel: 0
proto: a
ssid: string
text: string
timestamp: 0
type: string
type_code: 0
wlan_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 0
limit: 0
results:
- ap: string
band: '24'
bssid: string
channel: 0
proto: a
ssid: string
text: string
timestamp: 0
type: string
type_code: 0
wlan_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/clients/search:
get:
tags:
- Orgs Clients - Wireless
summary: searchOrgWirelessClients
description: Search wireless client records across the organization with filters for site, AP, band, device identity, hostname, IP, MAC address, username, SSID, PPSK, VLAN, and time range.
operationId: searchOrgWirelessClients
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: site_id
in: query
description: Filter results by site identifier
style: form
explode: true
schema:
type: string
contentEncoding: uuid
examples:
- 7dae216d-7c98-a51b-e068-dd7d477b7216
- name: ap
in: query
description: Filter results by AP MAC address
style: form
explode: true
schema:
type: string
examples:
- 5c5b53010101
- name: band
in: query
description: 'Comma separated list of Radio band (e.g. `24,5`). enum: `24`, `5`, `6`'
style: form
explode: true
schema:
type: string
examples:
- 5,6
- '5'
examples:
Untitled Example1:
value: 5,6
Untitled Example2:
value: '5'
- name: device
in: query
description: Comma separated list of Device type (e.g. `Mac,iPhone`). Case sensitive
style: form
explode: true
schema:
type: string
examples:
- iPhone
- name: hostname
in: query
description: Partial / full Client hostname. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `everest*` and `*rest*` match `my-everest-client`). Suffix-only wildcards (e.g. `*everest`) are not supported. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- my-everest-client,my-everest*
- my-everest-client
- my-everest*
- '*everest*'
examples:
Untitled Example1:
value: my-everest-client,my-everest*
Untitled Example2:
value: my-everest-client
Untitled Example3:
value: my-everest*
Untitled Example4:
value: '*everest*'
- name: ip
in: query
description: Partial / full Client IP address. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `10.100.10.*` and `*100.10.*` match `10.100.10.54`). Suffix-only wildcards (e.g. `*.54`) are not supported. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- 10.100.10.54,10.100.10.*
- 10.100.10.54
- 10.100.10.*
- '*100.10.*'
examples:
Untitled Example1:
value: 10.100.10.54,10.100.10.*
Untitled Example2:
value: 10.100.10.54
Untitled Example3:
value: 10.100.10.*
Untitled Example4:
value: '*100.10.*'
- name: mac
in: query
description: Partial / full Client MAC address. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `aabbcc*` and `*bbcc*` match `aabbccddeeff`). Suffix-only wildcards (e.g. `*bccddeeff`) are not supported. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- aabbccddeeff,aabbcc*
- aabbccddeeff
- aabbcc*
- '*bbcc*'
examples:
Untitled Example1:
value: aabbccddeeff,aabbcc*
Untitled Example2:
value: aabbccddeeff
Untitled Example3:
value: aabbcc*
Untitled Example4:
value: '*bbcc*'
- name: model
in: query
description: Only available for clients running the Marvis Client app, model, e.g. "MBP 15 late 2013", 6, 6s, "8+ GSM"
style: form
explode: true
schema:
type: string
examples:
- iPhone 8
- name: os
in: query
description: Only available for clients running the Marvis Client app, os, e.g. Sierra, Yosemite, Windows 10
style: form
explode: true
schema:
type: string
examples:
- Windows 10
- name: psk_id
in: query
description: PSK identifier used to filter the results
style: form
explode: true
schema:
type: string
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: psk_name
in: query
description: Only available for clients using PPSK authentication, the Name of the PSK
style: form
explode: true
schema:
type: string
examples:
- MyPPSK
- name: ssid
in: query
description: Filter results by SSID
style: form
explode: true
schema:
type: string
examples:
- MySSID
- name: text
in: query
description: Partial / full MAC address, hostname, username, psk_name or ip. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `everest*` and `*rest*` match `my-everest-client`). Suffix-only wildcards (e.g. `*everest`) are not supported
style: form
explode: true
schema:
type: string
examples:
- 5c5b530
- name: username
in: query
description: Partial / full username. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `johndoe*` and `*mycorp*` match `johndoe@mycorp.com`). Suffix-only wildcards (e.g. `*mycorp.com`) are not supported. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- johndoe,johnd*
- johndoe
- johnd*
- '*ohnd*'
examples:
Untitled Example1:
value: johndoe,johnd*
Untitled Example2:
value: johndoe
Untitled Example3:
value: johnd*
Untitled Example4:
value: '*ohnd*'
- name: vlan
in: query
description: Filter results by VLAN ID
style: form
explode: true
schema:
type: string
examples:
- '10'
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_client_search'
- description: Paginated wireless client search response
examples:
- end: 17141231418.812
limit: 118
next: next8
results:
- ap:
- a83a79a947ee
- 003e73170b4c
app_version:
- 0.100.3
band: '5'
device:
- Mac
ftc: false
hardware: Apple Wi-Fi adapter
hostname:
- hostname-a
- hostname-b
ip:
- 10.5.23.43
- 192.168.0.2
last_ap: a83a79a947ee
last_device: Mac
last_firmware: 'wl0: Jan 20 2024 04:08:41 version 20.103.12.0.8.7.171 FWID 01-e09d2675'
last_hostname: hostname-a
last_ip: 10.5.23.43
last_model: MBP 16\" M1 2021
last_os: Sonoma
last_os_version: 14.4.1 (Build 23E224)
last_psk_id: abf7dc5c-bb51-4bb7-93b6-5547400ffe11
last_psk_name: iot
last_ssid: IoT SSID
last_username: user@corp.com
last_vlan: 10
last_wlan_id: e5d67b07-aae8-494b-8584-cbc20c8110aa
mac: bcd074000000
mfg: Apple
model: MBP 16\" M1 2021
org_id: 1abff1aa-4571-4c1f-a409-153a1e7a7a24
os:
- Sonoma
os_version:
- 14.4.1 (Build 23E224)
protocol: ax
psk_id:
- abf7dc5c-bb51-4bb7-93b6-5547400ffe11
psk_name:
- iot
sdk_version:
- 0.100.3
site_id: 25ff5219-9be7-4db9-907d-0c9b60445147
site_ids:
- 25ff5219-9be7-4db9-907d-0c9b60445147
ssid:
- IoT SSID
timestamp: 1714124722.113
username:
- user@corp.com
vlan:
- 10
start: 10
total: 44
contentMediaType: application/json
examples:
Example:
value:
end: 17141231418.812
limit: 118
next: next8
results:
- ap:
- a83a79a947ee
- 003e73170b4c
app_version:
- 0.100.3
band: '5'
device:
- Mac
ftc: false
hardware: Apple Wi-Fi adapter
hostname:
- hostname-a
- hostname-b
ip:
- 10.5.23.43
- 192.168.0.2
last_ap: a83a79a947ee
last_device: Mac
last_firmware: 'wl0: Jan 20 2024 04:08:41 version 20.103.12.0.8.7.171 FWID 01-e09d2675'
last_hostname: hostname-a
last_ip: 10.5.23.43
last_model: MBP 16\" M1 2021
last_os: Sonoma
last_os_version: 14.4.1 (Build 23E224)
last_psk_id: abf7dc5c-bb51-4bb7-93b6-5547400ffe11
last_psk_name: iot
last_ssid: IoT SSID
last_username: user@corp.com
last_vlan: 10
last_wlan_id: e5d67b07-aae8-494b-8584-cbc20c8110aa
mac: bcd074000000
mfg: Apple
model: MBP 16\" M1 2021
org_id: 1abff1aa-4571-4c1f-a409-153a1e7a7a24
os:
- Sonoma
os_version:
- 14.4.1 (Build 23E224)
protocol: ax
psk_id:
- abf7dc5c-bb51-4bb7-93b6-5547400ffe11
psk_name:
- iot
sdk_version:
- 0.100.3
site_id: 25ff5219-9be7-4db9-907d-0c9b60445147
site_ids:
- 25ff5219-9be7-4db9-907d-0c9b60445147
ssid:
- IoT SSID
timestamp: 1714124722.113
username:
- user@corp.com
vlan:
- 10
start: 10
total: 44
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_client_search'
- description: Paginated wireless client search response
examples:
- end: 17141231418.812
limit: 118
next: next8
results:
- ap:
- a83a79a947ee
- 003e73170b4c
app_version:
- 0.100.3
band: '5'
device:
- Mac
ftc: false
hardware: Apple Wi-Fi adapter
hostname:
- hostname-a
- hostname-b
ip:
- 10.5.23.43
- 192.168.0.2
last_ap: a83a79a947ee
last_device: Mac
last_firmware: 'wl0: Jan 20 2024 04:08:41 version 20.103.12.0.8.7.171 FWID 01-e09d2675'
last_hostname: hostname-a
last_ip: 10.5.23.43
last_model: MBP 16\" M1 2021
last_os: Sonoma
last_os_version: 14.4.1 (Build 23E224)
last_psk_id: abf7dc5c-bb51-4bb7-93b6-5547400ffe11
last_psk_name: iot
last_ssid: IoT SSID
last_username: user@corp.com
last_vlan: 10
last_wlan_id: e5d67b07-aae8-494b-8584-cbc20c8110aa
mac: bcd074000000
mfg: Apple
model: MBP 16\" M1 2021
org_id: 1abff1aa-4571-4c1f-a409-153a1e7a7a24
os:
- Sonoma
os_version:
- 14.4.1 (Build 23E224)
protocol: ax
psk_id:
- abf7dc5c-bb51-4bb7-93b6-5547400ffe11
psk_name:
- iot
sdk_version:
- 0.100.3
site_id: 25ff5219-9be7-4db9-907d-0c9b60445147
site_ids:
- 25ff5219-9be7-4db9-907d-0c9b60445147
ssid:
- IoT SSID
timestamp: 1714124722.113
username:
- user@corp.com
vlan:
- 10
start: 10
total: 44
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 17141231418.812
limit: 118
next: next8
results:
- ap:
- a83a79a947ee
- 003e73170b4c
app_version:
- 0.100.3
band: '5'
device:
- Mac
ftc: false
hardware: Apple Wi-Fi adapter
hostname:
- hostname-a
- hostname-b
ip:
- 10.5.23.43
- 192.168.0.2
last_ap: a83a79a947ee
last_device: Mac
last_firmware: 'wl0: Jan 20 2024 04:08:41 version 20.103.12.0.8.7.171 FWID 01-e09d2675'
last_hostname: hostname-a
last_ip: 10.5.23.43
last_model: MBP 16\" M1 2021
last_os: Sonoma
last_os_version: 14.4.1 (Build 23E224)
last_psk_id: abf7dc5c-bb51-4bb7-93b6-5547400ffe11
last_psk_name: iot
last_ssid: IoT SSID
last_username: user@corp.com
last_vlan: 10
last_wlan_id: e5d67b07-aae8-494b-8584-cbc20c8110aa
mac: bcd074000000
mfg: Apple
model: MBP 16\" M1 2021
org_id: 1abff1aa-4571-4c1f-a409-153a1e7a7a24
os:
- Sonoma
os_version:
- 14.4.1 (Build 23E224)
protocol: ax
psk_id:
- abf7dc5c-bb51-4bb7-93b6-5547400ffe11
psk_name:
- iot
sdk_version:
- 0.100.3
site_id: 25ff5219-9be7-4db9-907d-0c9b60445147
site_ids:
- 25ff5219-9be7-4db9-907d-0c9b60445147
ssid:
- IoT SSID
timestamp: 1714124722.113
username:
- user@corp.com
vlan:
- 10
start: 10
total: 44
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/clients/sessions/count:
get:
tags:
- Orgs Clients - Wireless
summary: countOrgWirelessClientsSessions
description: Count historical wireless client sessions across the organization, optionally grouped by `distinct` and filtered by AP, band, client attributes, SSID, WLAN, and time range.
operationId: countOrgWirelessClientsSessions
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field used to group this count response. enum: `ap`, `device`, `hostname`, `ip`, `model`, `os`, `ssid`, `vlan`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/org_client_sessions_count_distinct'
- description: 'Field used to group this count response. enum: `ap`, `device`, `hostname`, `ip`, `model`, `os`, `ssid`, `vlan`'
- name: ap
in: query
description: Filter results by AP MAC address
style: form
explode: true
schema:
type: string
examples:
- 5c5b53010101
- name: band
in: query
description: '802.11 band used to filter radio results. enum: `24`, `5`, `5-dedicated`, `5-selectable`, `6`, `6-dedicated`, `6-selectable`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/dot11_band'
- description: '802.11 band used to filter radio results. enum: `24`, `5`, `5-dedicated`, `5-selectable`, `6`, `6-dedicated`, `6-selectable`'
- name: client_family
in: query
description: E.g. "Mac", "iPhone", "Apple watch"
style: form
explode: true
schema:
type: string
examples:
- iPhone
- name: client_manufacture
in: query
description: Filter results by client manufacturer, e.g. "Apple"
style: form
explode: true
schema:
type: string
examples:
- Apple
- name: client_model
in: query
description: Filter results by client model, e.g. "8+", "XS"
style: form
explode: true
schema:
type: string
examples:
- iPhone 8
- name: client_os
in: query
description: E.g. "Mojave", "Windows 10", "Linux"
style: form
explode: true
schema:
type: string
examples:
- Windows 10
- name: ssid
in: query
description: Filter results by SSID
style: form
explode: true
schema:
type: string
examples:
- MySSID
- name: wlan_id
in: query
description: Filter results by WLAN identifier
style: form
explode: true
schema:
type: string
contentEncoding: uuid
examples:
- 7dae216d-7c98-a51b-e068-dd7d477b7216
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/clients/sessions/search:
get:
tags:
- Orgs Clients - Wireless
summary: searchOrgWirelessClientSessions
description: Search historical wireless client sessions across the organization with filters for AP, band, client family, manufacturer, model, OS, username, SSID, WLAN, PPSK, and time range.
operationId: searchOrgWirelessClientSessions
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: ap
in: query
description: Filter results by AP MAC address
style: form
explode: true
schema:
type: string
examples:
- 5c5b53010101
- name: band
in: query
description: '802.11 band used to filter radio results. enum: `24`, `5`, `5-dedicated`, `5-selectable`, `6`, `6-dedicated`, `6-selectable`. Accepts multiple comma-separated values.'
style: form
explode: true
schema:
type: string
examples:
- 5,6
- name: client_family
in: query
description: E.g. "Mac", "iPhone", "Apple watch". Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- Phone/Tablet/Wearable,Monitoring Device
- iPhone
examples:
Untitled Example1:
value: Phone/Tablet/Wearable,Monitoring Device
Untitled Example2:
value: iPhone
- name: client_manufacture
in: query
description: Filter results by client manufacturer, e.g. "Apple". Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- Hewlett Packard Enterprise,Unknown
- Apple
examples:
Untitled Example1:
value: Hewlett Packard Enterprise,Unknown
Untitled Example2:
value: Apple
- name: client_model
in: query
description: Filter results by client model, e.g. "8+", "XS". Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- iPhone 8,Aruba S0U52A
- iPhone 8
examples:
Untitled Example1:
value: iPhone 8,Aruba S0U52A
Untitled Example2:
value: iPhone 8
- name: client_username
in: query
description: Filter results by client username. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- john.doe,jane.doe
- john.doe
examples:
Untitled Example1:
value: john.doe,jane.doe
Untitled Example2:
value: john.doe
- name: client_os
in: query
description: E.g. "Mojave", "Windows 10", "Linux". Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- iOS 16.7.16,Unknown
- Windows 10
examples:
Untitled Example1:
value: iOS 16.7.16,Unknown
Untitled Example2:
value: Windows 10
- name: ssid
in: query
description: Filter results by SSID. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- Corp,Guest
- MySSID
examples:
Untitled Example1:
value: Corp,Guest
Untitled Example2:
value: MySSID
- name: wlan_id
in: query
description: Filter results by WLAN identifier
style: form
explode: true
schema:
type: string
contentEncoding: uuid
examples:
- 7dae216d-7c98-a51b-e068-dd7d477b7216
- name: psk_id
in: query
description: PSK identifier used to filter the results
style: form
explode: true
schema:
type: string
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: psk_name
in: query
description: Filter results by PSK name. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- psk-a,psk-b
- MyPPSK
examples:
Untitled Example1:
value: psk-a,psk-b
Untitled Example2:
value: MyPPSK
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/search_wireless_client_session'
- description: Paginated response for wireless client session searches
examples:
- end: 1513177200
limit: 10
results:
- ap: 5c5b350e0262
band: '5'
client_manufacture: Apple
connect: 1565208388
disconnect: 1565208448
duration: 60.09423865
mac: b019c66c8348
org_id: 3139f2c2-fac6-11e5-8156-0242ac110006
site_id: 70e0f468-fc13-11e5-85ad-0242ac110008
ssid: Dummy WLAN 2
tags:
- disassociate
timestamp: 1565208448.662
wlan_id: 99bb4c74-f954-4f36-b844-6b030faffabc
start: 1511967600
total: 100
contentMediaType: application/json
examples:
Example:
value:
end: 1513177200
limit: 10
results:
- ap: 5c5b350e0262
band: '5'
client_manufacture: Apple
connect: 1565208388
disconnect: 1565208448
duration: 60.09423865
mac: b019c66c8348
org_id: 3139f2c2-fac6-11e5-8156-0242ac110006
site_id: 70e0f468-fc13-11e5-85ad-0242ac110008
ssid: Dummy WLAN 2
tags:
- disassociate
timestamp: 1565208448.662
wlan_id: 99bb4c74-f954-4f36-b844-6b030faffabc
start: 1511967600
total: 100
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/search_wireless_client_session'
- description: Paginated response for wireless client session searches
examples:
- end: 1513177200
limit: 10
results:
- ap: 5c5b350e0262
band: '5'
client_manufacture: Apple
connect: 1565208388
disconnect: 1565208448
duration: 60.09423865
mac: b019c66c8348
org_id: 3139f2c2-fac6-11e5-8156-0242ac110006
site_id: 70e0f468-fc13-11e5-85ad-0242ac110008
ssid: Dummy WLAN 2
tags:
- disassociate
timestamp: 1565208448.662
wlan_id: 99bb4c74-f954-4f36-b844-6b030faffabc
start: 1511967600
total: 100
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 1513177200
limit: 10
results:
- ap: 5c5b350e0262
band: '5'
client_manufacture: Apple
connect: 1565208388
disconnect: 1565208448
duration: 60.09423865
mac: b019c66c8348
org_id: 3139f2c2-fac6-11e5-8156-0242ac110006
site_id: 70e0f468-fc13-11e5-85ad-0242ac110008
ssid: Dummy WLAN 2
tags:
- disassociate
timestamp: 1565208448.662
wlan_id: 99bb4c74-f954-4f36-b844-6b030faffabc
start: 1511967600
total: 100
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/sdkclients/{sdkclient_id}:
put:
tags:
- Orgs Clients - SDK
summary: updateSdkClient
description: Update the display name of an SDK client registered in the organization.
operationId: updateSdkClient
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: sdkclient_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/name_string'
- description: Request Body
examples:
- name: John Smith
contentMediaType: application/json
examples:
Example:
value:
name: John Smith
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/setting/cradlepoint/setup:
delete:
tags:
- Orgs Integration Cradlepoint
summary: deleteOrgCradlepointConnection
description: Remove the Cradlepoint integration configuration from the organization.
operationId: deleteOrgCradlepointConnection
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Orgs Integration Cradlepoint
summary: testOrgCradlepointConnection
description: Test the current Cradlepoint integration configuration and return whether the most recent integration status is active or inactive.
operationId: testOrgCradlepointConnection
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/test_cradlepoint'
- description: Cradlepoint integration connectivity test result
examples:
- alert_config_id: 8b7e06ac-0yu5-11f1-88h2-42628k552c3d
cp_api_id: '********'
cp_api_key: '********'
destination_config_id: 8ad364de-0yu5-13r1-9abc-263675be6074
ecm_api_id: '********'
ecm_api_key: '********'
enable_lldp: false
error: Cradlepoint API keys are no longer valid, please verify and update the keys under organization settings.
last_status: inactive
shared_secret: '********'
contentMediaType: application/json
examples:
Crowdstrike:
value:
alert_config_id: 8b7e06ac-0yu5-11f1-88h2-42628k552c3d
cp_api_id: '********'
cp_api_key: '********'
destination_config_id: 8ad364de-0yu5-13r1-9abc-263675be6074
ecm_api_id: '********'
ecm_api_key: '********'
enable_lldp: false
error: Cradlepoint API keys are no longer valid, please verify and update the keys under organization settings.
last_status: inactive
shared_secret: '********'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/test_cradlepoint'
- description: Cradlepoint integration connectivity test result
examples:
- alert_config_id: 8b7e06ac-0yu5-11f1-88h2-42628k552c3d
cp_api_id: '********'
cp_api_key: '********'
destination_config_id: 8ad364de-0yu5-13r1-9abc-263675be6074
ecm_api_id: '********'
ecm_api_key: '********'
enable_lldp: false
error: Cradlepoint API keys are no longer valid, please verify and update the keys under organization settings.
last_status: inactive
shared_secret: '********'
contentMediaType: application/vnd.api+json
examples:
Crowdstrike:
value:
alert_config_id: 8b7e06ac-0yu5-11f1-88h2-42628k552c3d
cp_api_id: '********'
cp_api_key: '********'
destination_config_id: 8ad364de-0yu5-13r1-9abc-263675be6074
ecm_api_id: '********'
ecm_api_key: '********'
enable_lldp: false
error: Cradlepoint API keys are no longer valid, please verify and update the keys under organization settings.
last_status: inactive
shared_secret: '********'
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs Integration Cradlepoint
summary: setupOrgCradlepointConnectionToMist
description: Configure the Cradlepoint integration by storing Cradlepoint API and ECM credentials and setting up Cradlepoint webhooks to send events to Mist.
operationId: setupOrgCradlepointConnectionToMist
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/account_cradlepoint_config'
- examples:
- cp_api_id: 84446d61-2206-4ea5-855a-0043f980be54
cp_api_key: 79c329da9893e34099c7d8ad5cb9c941
ecm_api_id: 73446d61-2206-4ea5-855a-0043f980be62
ecm_api_key: 68b329da9893e34099c7d8ad5cb9c9405
enable_lldp: true
contentMediaType: application/json
examples:
Example:
value:
cp_api_id: 84446d61-2206-4ea5-855a-0043f980be54
cp_api_key: 79c329da9893e34099c7d8ad5cb9c941
ecm_api_id: 73446d61-2206-4ea5-855a-0043f980be62
ecm_api_key: 68b329da9893e34099c7d8ad5cb9c9405
enable_lldp: true
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Orgs Integration Cradlepoint
summary: updateOrgCradlepointConnectionToMist
description: Update the stored Cradlepoint API and ECM credentials and the LLDP-based device linking option used by Mist.
operationId: updateOrgCradlepointConnectionToMist
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/account_cradlepoint_config'
- examples:
- cp_api_id: 84446d61-2206-4ea5-855a-0043f980be54
cp_api_key: 79c329da9893e34099c7d8ad5cb9c941
ecm_api_id: 73446d61-2206-4ea5-855a-0043f980be62
ecm_api_key: 68b329da9893e34099c7d8ad5cb9c9405
enable_lldp: true
contentMediaType: application/json
examples:
Example:
value:
cp_api_id: 84446d61-2206-4ea5-855a-0043f980be54
cp_api_key: 79c329da9893e34099c7d8ad5cb9c941
ecm_api_id: 73446d61-2206-4ea5-855a-0043f980be62
ecm_api_key: 68b329da9893e34099c7d8ad5cb9c9405
enable_lldp: true
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/setting/cradlepoint/sync:
post:
tags:
- Orgs Integration Cradlepoint
summary: syncOrgCradlepointRouters
description: Trigger a Cradlepoint device synchronization with Mist. When LLDP linking is enabled, Mist also uses Cradlepoint LLDP data to associate routers with Mist sites and devices.
operationId: syncOrgCradlepointRouters
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/crl:
get:
tags:
- Orgs CRL
summary: getOrgCrlFile
description: Download the organization certificate revocation list (CRL) file used to identify certificates that should no longer be trusted.
operationId: getOrgCrlFile
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: string
description: File
contentEncoding: base64
contentMediaType: application/json
application/vnd.api+json:
schema:
type: string
description: File
contentEncoding: base64
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/deviceprofiles:
get:
tags:
- Orgs Device Profiles
summary: listOrgDeviceProfiles
description: List org-level device profiles, which define reusable AP, switch, or gateway configuration subsets that can be applied to matching devices.
operationId: listOrgDeviceProfiles
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: type
in: query
description: 'Filter results by one device profile type. Use a single value; comma-separated values are not supported. enum: `ap`, `gateway`, `switch`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/device_type_default_ap'
- description: 'Filter results by one device profile type. Use a single value; comma-separated values are not supported. enum: `ap`, `gateway`, `switch`'
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/deviceprofile'
description: List of device profile configurations
examples:
- '[{"aeroscout":{"enabled":true,"host":"string"},"created_time":0,"disable_eth1":true,"disable_module":true,"id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","ip_config":{"dns":["string"],"dns_suffix":["string"],"gateway":"192.168.0.1","gateway6":"2001:0db8:85a3:0000:0000:8a2e:0370:7334","ip":"192.168.0.1","ip6":"2001:0db8:85a3:0000:0000:8a2e:0370:7334","mtu":1500,"netmask":"192.168.0.1","netmask6":"2001:0db8:85a3:0000:0000:8a2e:0370:7334","type":"static","type6":"static","vlan_id":1},"mesh":{"enabled":true,"group":1,"role":"base"},"modified_time":0,"name":"string","org_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","poe_passthrough":true,"switch_config":{"enabled":true,"eth0":{"port_vlan_id":1,"vlan_ids":[1,10]},"eth1":{"port_vlan_id":1,"vlan_ids":[10]},"eth2":{"port_vlan_id":1,"vlan_ids":[10]},"eth3":{"port_vlan_id":1,"vlan_ids":[10]},"module":{"port_vlan_id":1,"vlan_ids":[10]},"wds":{"port_vlan_id":1,"vlan_ids":[10]}},"type":"ap","usb_config":{"cacert":"string","enabled":true,"host":"string","type":"imagotag","verify_cert":true}}]'
- '[{"created_time":1680762730,"dhcpd_config":{"Corp-Mgmt":{"dns_servers":["8.8.8.8"],"dns_suffix":["stag.one"],"gateway":"10.3.172.9","ip_end":"10.3.172.99","ip_start":"10.3.172.50","type":"local"},"Corp-lan":{"dns_servers":["8.8.8.8"],"dns_suffix":["stag.one"],"gateway":"10.3.171.9","ip_end":"10.3.171.99","ip_start":"10.3.171.50","type":"local"}},"dnsOverride":true,"dns_servers":["10.3.20.201","10.3.51.222","1.1.1.1"],"dns_suffix":["example.com"],"extra_routes":{"10.101.0.0/16":{"via":"10.3.100.10"}},"id":"4ea55b5d-7313-4a81-a292-7ee125fd4ebb","ip_configs":{"Corp-Core":{"ip":"10.3.100.9","netmask":"/24","type":"static"},"Corp-Mgmt":{"ip":"10.3.172.9","netmask":"/24","type":"static"},"Corp-lan":{"ip":"10.3.171.9","netmask":"/24","type":"static"}},"modified_time":1680762890,"name":"ITParis","ntpOverride":true,"ntp_servers":["10.3.51.222"],"org_id":"93986f10-773b-42be-9438-8d3e6d127f1a","path_preferences":{"core":{"paths":[{"networks":["Corp-Core"],"type":"local"}],"strategy":"ordered"},"lab":{"paths":[{"networks":["Corp-lan"],"type":"local"}],"strategy":"ordered"},"mgmt":{"paths":[{"networks":["Corp-Mgmt"],"type":"local"}],"strategy":"ordered"},"untrust":{"paths":[{"name":"wan","type":"wan"}],"strategy":"ordered"}},"port_config":{"ge-0/0/0":{"aggregated":false,"ip_config":{"gateway":"192.168.1.1","ip":"192.168.1.9","netmask":"/24","type":"static"},"name":"wan","redundant":false,"traffic_shaping":{"enabled":false},"usage":"wan","wan_type":"broadband"},"ge-0/0/6-7":{"ae_disable_lacp":false,"ae_idx":"0","ae_lacp_force_up":true,"aggregated":true,"networks":["Corp-lan","Corp-Mgmt","Corp-Core"],"usage":"lan"}},"service_policies":[{"action":"allow","idp":{"enabled":false},"name":"ITParis-Internal","path_preference":"core","services":["internal_dns","drive"],"tenants":["ITParis"]},{"action":"deny","idp":{"enabled":false},"name":"ITParis-internet","path_preference":"untrust","services":["internet_any"],"tenants":["ITParis"]}],"type":"gateway"}]'
contentMediaType: application/json
examples:
Deviceprofile Ap:
value:
- aeroscout:
enabled: true
host: string
created_time: 0
disable_eth1: true
disable_module: true
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ip_config:
dns:
- string
dns_suffix:
- string
gateway: 192.168.0.1
gateway6: 2001:0db8:85a3:0000:0000:8a2e:0370:7334
ip: 192.168.0.1
ip6: 2001:0db8:85a3:0000:0000:8a2e:0370:7334
mtu: 1500
netmask: 192.168.0.1
netmask6: 2001:0db8:85a3:0000:0000:8a2e:0370:7334
type: static
type6: static
vlan_id: 1
mesh:
enabled: true
group: 1
role: base
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
poe_passthrough: true
switch_config:
enabled: true
eth0:
port_vlan_id: 1
vlan_ids:
- 1
- 10
eth1:
port_vlan_id: 1
vlan_ids:
- 10
eth2:
port_vlan_id: 1
vlan_ids:
- 10
eth3:
port_vlan_id: 1
vlan_ids:
- 10
module:
port_vlan_id: 1
vlan_ids:
- 10
wds:
port_vlan_id: 1
vlan_ids:
- 10
type: ap
usb_config:
cacert: string
enabled: true
host: string
type: imagotag
verify_cert: true
Deviceprofile Hub:
value:
- created_time: 1680762730
dhcpd_config:
Corp-Mgmt:
dns_servers:
- 8.8.8.8
dns_suffix:
- stag.one
gateway: 10.3.172.9
ip_end: 10.3.172.99
ip_start: 10.3.172.50
type: local
Corp-lan:
dns_servers:
- 8.8.8.8
dns_suffix:
- stag.one
gateway: 10.3.171.9
ip_end: 10.3.171.99
ip_start: 10.3.171.50
type: local
dnsOverride: true
dns_servers:
- 10.3.20.201
- 10.3.51.222
- 1.1.1.1
dns_suffix:
- example.com
extra_routes:
10.101.0.0/16:
via: 10.3.100.10
id: 4ea55b5d-7313-4a81-a292-7ee125fd4ebb
ip_configs:
Corp-Core:
ip: 10.3.100.9
netmask: /24
type: static
Corp-Mgmt:
ip: 10.3.172.9
netmask: /24
type: static
Corp-lan:
ip: 10.3.171.9
netmask: /24
type: static
modified_time: 1680762890
name: ITParis
ntpOverride: true
ntp_servers:
- 10.3.51.222
org_id: 93986f10-773b-42be-9438-8d3e6d127f1a
path_preferences:
core:
paths:
- networks:
- Corp-Core
type: local
strategy: ordered
lab:
paths:
- networks:
- Corp-lan
type: local
strategy: ordered
mgmt:
paths:
- networks:
- Corp-Mgmt
type: local
strategy: ordered
untrust:
paths:
- name: wan
type: wan
strategy: ordered
port_config:
ge-0/0/0:
aggregated: false
ip_config:
gateway: 192.168.1.1
ip: 192.168.1.9
netmask: /24
type: static
name: wan
redundant: false
traffic_shaping:
enabled: false
usage: wan
wan_type: broadband
ge-0/0/6-7:
ae_disable_lacp: false
ae_idx: '0'
ae_lacp_force_up: true
aggregated: true
networks:
- Corp-lan
- Corp-Mgmt
- Corp-Core
usage: lan
service_policies:
- action: allow
idp:
enabled: false
name: ITParis-Internal
path_preference: core
services:
- internal_dns
- drive
tenants:
- ITParis
- action: deny
idp:
enabled: false
name: ITParis-internet
path_preference: untrust
services:
- internet_any
tenants:
- ITParis
type: gateway
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/deviceprofile'
description: List of device profile configurations
examples:
- '[{"aeroscout":{"enabled":true,"host":"string"},"created_time":0,"disable_eth1":true,"disable_module":true,"id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","ip_config":{"dns":["string"],"dns_suffix":["string"],"gateway":"192.168.0.1","gateway6":"2001:0db8:85a3:0000:0000:8a2e:0370:7334","ip":"192.168.0.1","ip6":"2001:0db8:85a3:0000:0000:8a2e:0370:7334","mtu":1500,"netmask":"192.168.0.1","netmask6":"2001:0db8:85a3:0000:0000:8a2e:0370:7334","type":"static","type6":"static","vlan_id":1},"mesh":{"enabled":true,"group":1,"role":"base"},"modified_time":0,"name":"string","org_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","poe_passthrough":true,"switch_config":{"enabled":true,"eth0":{"port_vlan_id":1,"vlan_ids":[1,10]},"eth1":{"port_vlan_id":1,"vlan_ids":[10]},"eth2":{"port_vlan_id":1,"vlan_ids":[10]},"eth3":{"port_vlan_id":1,"vlan_ids":[10]},"module":{"port_vlan_id":1,"vlan_ids":[10]},"wds":{"port_vlan_id":1,"vlan_ids":[10]}},"type":"ap","usb_config":{"cacert":"string","enabled":true,"host":"string","type":"imagotag","verify_cert":true}}]'
- '[{"created_time":1680762730,"dhcpd_config":{"Corp-Mgmt":{"dns_servers":["8.8.8.8"],"dns_suffix":["stag.one"],"gateway":"10.3.172.9","ip_end":"10.3.172.99","ip_start":"10.3.172.50","type":"local"},"Corp-lan":{"dns_servers":["8.8.8.8"],"dns_suffix":["stag.one"],"gateway":"10.3.171.9","ip_end":"10.3.171.99","ip_start":"10.3.171.50","type":"local"}},"dnsOverride":true,"dns_servers":["10.3.20.201","10.3.51.222","1.1.1.1"],"dns_suffix":["example.com"],"extra_routes":{"10.101.0.0/16":{"via":"10.3.100.10"}},"id":"4ea55b5d-7313-4a81-a292-7ee125fd4ebb","ip_configs":{"Corp-Core":{"ip":"10.3.100.9","netmask":"/24","type":"static"},"Corp-Mgmt":{"ip":"10.3.172.9","netmask":"/24","type":"static"},"Corp-lan":{"ip":"10.3.171.9","netmask":"/24","type":"static"}},"modified_time":1680762890,"name":"ITParis","ntpOverride":true,"ntp_servers":["10.3.51.222"],"org_id":"93986f10-773b-42be-9438-8d3e6d127f1a","path_preferences":{"core":{"paths":[{"networks":["Corp-Core"],"type":"local"}],"strategy":"ordered"},"lab":{"paths":[{"networks":["Corp-lan"],"type":"local"}],"strategy":"ordered"},"mgmt":{"paths":[{"networks":["Corp-Mgmt"],"type":"local"}],"strategy":"ordered"},"untrust":{"paths":[{"name":"wan","type":"wan"}],"strategy":"ordered"}},"port_config":{"ge-0/0/0":{"aggregated":false,"ip_config":{"gateway":"192.168.1.1","ip":"192.168.1.9","netmask":"/24","type":"static"},"name":"wan","redundant":false,"traffic_shaping":{"enabled":false},"usage":"wan","wan_type":"broadband"},"ge-0/0/6-7":{"ae_disable_lacp":false,"ae_idx":"0","ae_lacp_force_up":true,"aggregated":true,"networks":["Corp-lan","Corp-Mgmt","Corp-Core"],"usage":"lan"}},"service_policies":[{"action":"allow","idp":{"enabled":false},"name":"ITParis-Internal","path_preference":"core","services":["internal_dns","drive"],"tenants":["ITParis"]},{"action":"deny","idp":{"enabled":false},"name":"ITParis-internet","path_preference":"untrust","services":["internet_any"],"tenants":["ITParis"]}],"type":"gateway"}]'
contentMediaType: application/vnd.api+json
examples:
Deviceprofile Ap:
value:
- aeroscout:
enabled: true
host: string
created_time: 0
disable_eth1: true
disable_module: true
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ip_config:
dns:
- string
dns_suffix:
- string
gateway: 192.168.0.1
gateway6: 2001:0db8:85a3:0000:0000:8a2e:0370:7334
ip: 192.168.0.1
ip6: 2001:0db8:85a3:0000:0000:8a2e:0370:7334
mtu: 1500
netmask: 192.168.0.1
netmask6: 2001:0db8:85a3:0000:0000:8a2e:0370:7334
type: static
type6: static
vlan_id: 1
mesh:
enabled: true
group: 1
role: base
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
poe_passthrough: true
switch_config:
enabled: true
eth0:
port_vlan_id: 1
vlan_ids:
- 1
- 10
eth1:
port_vlan_id: 1
vlan_ids:
- 10
eth2:
port_vlan_id: 1
vlan_ids:
- 10
eth3:
port_vlan_id: 1
vlan_ids:
- 10
module:
port_vlan_id: 1
vlan_ids:
- 10
wds:
port_vlan_id: 1
vlan_ids:
- 10
type: ap
usb_config:
cacert: string
enabled: true
host: string
type: imagotag
verify_cert: true
Deviceprofile Hub:
value:
- created_time: 1680762730
dhcpd_config:
Corp-Mgmt:
dns_servers:
- 8.8.8.8
dns_suffix:
- stag.one
gateway: 10.3.172.9
ip_end: 10.3.172.99
ip_start: 10.3.172.50
type: local
Corp-lan:
dns_servers:
- 8.8.8.8
dns_suffix:
- stag.one
gateway: 10.3.171.9
ip_end: 10.3.171.99
ip_start: 10.3.171.50
type: local
dnsOverride: true
dns_servers:
- 10.3.20.201
- 10.3.51.222
- 1.1.1.1
dns_suffix:
- example.com
extra_routes:
10.101.0.0/16:
via: 10.3.100.10
id: 4ea55b5d-7313-4a81-a292-7ee125fd4ebb
ip_configs:
Corp-Core:
ip: 10.3.100.9
netmask: /24
type: static
Corp-Mgmt:
ip: 10.3.172.9
netmask: /24
type: static
Corp-lan:
ip: 10.3.171.9
netmask: /24
type: static
modified_time: 1680762890
name: ITParis
ntpOverride: true
ntp_servers:
- 10.3.51.222
org_id: 93986f10-773b-42be-9438-8d3e6d127f1a
path_preferences:
core:
paths:
- networks:
- Corp-Core
type: local
strategy: ordered
lab:
paths:
- networks:
- Corp-lan
type: local
strategy: ordered
mgmt:
paths:
- networks:
- Corp-Mgmt
type: local
strategy: ordered
untrust:
paths:
- name: wan
type: wan
strategy: ordered
port_config:
ge-0/0/0:
aggregated: false
ip_config:
gateway: 192.168.1.1
ip: 192.168.1.9
netmask: /24
type: static
name: wan
redundant: false
traffic_shaping:
enabled: false
usage: wan
wan_type: broadband
ge-0/0/6-7:
ae_disable_lacp: false
ae_idx: '0'
ae_lacp_force_up: true
aggregated: true
networks:
- Corp-lan
- Corp-Mgmt
- Corp-Core
usage: lan
service_policies:
- action: allow
idp:
enabled: false
name: ITParis-Internal
path_preference: core
services:
- internal_dns
- drive
tenants:
- ITParis
- action: deny
idp:
enabled: false
name: ITParis-internet
path_preference: untrust
services:
- internet_any
tenants:
- ITParis
type: gateway
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs Device Profiles
summary: createOrgDeviceProfile
description: Create an org-level device profile containing reusable AP, switch, or gateway configuration.
operationId: createOrgDeviceProfile
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/deviceprofile'
- description: Request Body
examples:
- '{"aeroscout":{"enabled":false,"host":"aero.pvt.net","locate_connected":true},"led":{"brightness":255,"enabled":true},"name":"string","ntp_servers":["10.10.10.10"],"type":"ap","usb_config":{"cacert":"string","channel":3,"enabled":true,"host":"1.1.1.1","port":0,"type":"imagotag","verify_cert":true,"vlan_id":1}}'
- '{"dhcpd_config":{"Corp-Mgmt":{"dns_servers":["8.8.8.8"],"dns_suffix":["stag.one"],"gateway":"10.3.172.9","ip_end":"10.3.172.99","ip_start":"10.3.172.50","type":"local"},"Corp-lan":{"dns_servers":["8.8.8.8"],"dns_suffix":["stag.one"],"gateway":"10.3.171.9","ip_end":"10.3.171.99","ip_start":"10.3.171.50","type":"local"}},"dnsOverride":true,"dns_servers":["10.3.20.201","10.3.51.222","1.1.1.1"],"dns_suffix":["example.com"],"extra_routes":{"10.101.0.0/16":{"via":"10.3.100.10"}},"ip_configs":{"Corp-Core":{"ip":"10.3.100.9","netmask":"/24","type":"static"},"Corp-Mgmt":{"ip":"10.3.172.9","netmask":"/24","type":"static"},"Corp-lan":{"ip":"10.3.171.9","netmask":"/24","type":"static"}},"name":"Demo","ntpOverride":true,"ntp_servers":["10.3.51.222"],"path_preferences":{"core":{"paths":[{"networks":["Corp-Core"],"type":"local"}],"strategy":"ordered"},"lab":{"paths":[{"networks":["Corp-lan"],"type":"local"}],"strategy":"ordered"},"mgmt":{"paths":[{"networks":["Corp-Mgmt"],"type":"local"}],"strategy":"ordered"},"untrust":{"paths":[{"name":"wan","type":"wan"}],"strategy":"ordered"}},"port_config":{"ge-0/0/0":{"aggregated":false,"ip_config":{"gateway":"192.168.1.1","ip":"192.168.1.9","netmask":"/24","type":"static"},"name":"wan","redundant":false,"usage":"wan","wan_type":"broadband"},"ge-0/0/6-7":{"ae_disable_lacp":false,"ae_idx":"0","ae_lacp_force_up":true,"aggregated":true,"networks":["Corp-lan","Corp-Mgmt","Corp-Core"],"usage":"lan"}},"service_policies":[{"action":"allow","idp":{"enabled":false},"name":"ITParis-Internal","path_preference":"core","services":["internal_dns","drive"],"tenants":["ITParis"]}],"type":"gateway"}'
contentMediaType: application/json
examples:
deviceprofile_ap:
value:
aeroscout:
enabled: false
host: aero.pvt.net
locate_connected: true
led:
brightness: 255
enabled: true
name: string
ntp_servers:
- 10.10.10.10
type: ap
usb_config:
cacert: string
channel: 3
enabled: true
host: 1.1.1.1
port: 0
type: imagotag
verify_cert: true
vlan_id: 1
deviceprofile_hub:
value:
dhcpd_config:
Corp-Mgmt:
dns_servers:
- 8.8.8.8
dns_suffix:
- stag.one
gateway: 10.3.172.9
ip_end: 10.3.172.99
ip_start: 10.3.172.50
type: local
Corp-lan:
dns_servers:
- 8.8.8.8
dns_suffix:
- stag.one
gateway: 10.3.171.9
ip_end: 10.3.171.99
ip_start: 10.3.171.50
type: local
dnsOverride: true
dns_servers:
- 10.3.20.201
- 10.3.51.222
- 1.1.1.1
dns_suffix:
- example.com
extra_routes:
10.101.0.0/16:
via: 10.3.100.10
ip_configs:
Corp-Core:
ip: 10.3.100.9
netmask: /24
type: static
Corp-Mgmt:
ip: 10.3.172.9
netmask: /24
type: static
Corp-lan:
ip: 10.3.171.9
netmask: /24
type: static
name: Demo
ntpOverride: true
ntp_servers:
- 10.3.51.222
path_preferences:
core:
paths:
- networks:
- Corp-Core
type: local
strategy: ordered
lab:
paths:
- networks:
- Corp-lan
type: local
strategy: ordered
mgmt:
paths:
- networks:
- Corp-Mgmt
type: local
strategy: ordered
untrust:
paths:
- name: wan
type: wan
strategy: ordered
port_config:
ge-0/0/0:
aggregated: false
ip_config:
gateway: 192.168.1.1
ip: 192.168.1.9
netmask: /24
type: static
name: wan
redundant: false
usage: wan
wan_type: broadband
ge-0/0/6-7:
ae_disable_lacp: false
ae_idx: '0'
ae_lacp_force_up: true
aggregated: true
networks:
- Corp-lan
- Corp-Mgmt
- Corp-Core
usage: lan
service_policies:
- action: allow
idp:
enabled: false
name: ITParis-Internal
path_preference: core
services:
- internal_dns
- drive
tenants:
- ITParis
type: gateway
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/deviceprofile'
- description: Device profile configuration for an AP, switch, or gateway
examples:
- '{"aeroscout":{"enabled":true,"host":"string"},"created_time":0,"disable_eth1":true,"disable_module":true,"id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","ip_config":{"dns":["string"],"dns_suffix":["string"],"gateway":"192.168.0.1","gateway6":"2001:0db8:85a3:0000:0000:8a2e:0370:7334","ip":"192.168.0.1","ip6":"2001:0db8:85a3:0000:0000:8a2e:0370:7334","mtu":1500,"netmask":"192.168.0.1","netmask6":"2001:0db8:85a3:0000:0000:8a2e:0370:7334","type":"static","type6":"static","vlan_id":1},"mesh":{"enabled":true,"group":1,"role":"base"},"modified_time":0,"name":"string","org_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","poe_passthrough":true,"switch_config":{"enabled":true,"eth0":{"port_vlan_id":1,"vlan_ids":[1,10]},"eth1":{"port_vlan_id":1,"vlan_ids":[10]},"eth2":{"port_vlan_id":1,"vlan_ids":[10]},"eth3":{"port_vlan_id":1,"vlan_ids":[10]},"module":{"port_vlan_id":1,"vlan_ids":[10]},"wds":{"port_vlan_id":1,"vlan_ids":[10]}},"type":"ap","usb_config":{"cacert":"string","enabled":true,"host":"string","type":"imagotag","verify_cert":true}}'
- '{"created_time":1680762730,"dhcpd_config":{"Corp-Mgmt":{"dns_servers":["8.8.8.8"],"dns_suffix":["stag.one"],"gateway":"10.3.172.9","ip_end":"10.3.172.99","ip_start":"10.3.172.50","type":"local"},"Corp-lan":{"dns_servers":["8.8.8.8"],"dns_suffix":["stag.one"],"gateway":"10.3.171.9","ip_end":"10.3.171.99","ip_start":"10.3.171.50","type":"local"}},"dnsOverride":true,"dns_servers":["10.3.20.201","10.3.51.222","1.1.1.1"],"dns_suffix":["example.com"],"extra_routes":{"10.101.0.0/16":{"via":"10.3.100.10"}},"id":"4ea55b5d-7313-4a81-a292-7ee125fd4ebb","ip_configs":{"Corp-Core":{"ip":"10.3.100.9","netmask":"/24","type":"static"},"Corp-Mgmt":{"ip":"10.3.172.9","netmask":"/24","type":"static"},"Corp-lan":{"ip":"10.3.171.9","netmask":"/24","type":"static"}},"modified_time":1680762890,"name":"ITParis","ntpOverride":true,"ntp_servers":["10.3.51.222"],"org_id":"93986f10-773b-42be-9438-8d3e6d127f1a","path_preferences":{"core":{"paths":[{"networks":["Corp-Core"],"type":"local"}],"strategy":"ordered"},"lab":{"paths":[{"networks":["Corp-lan"],"type":"local"}],"strategy":"ordered"},"mgmt":{"paths":[{"networks":["Corp-Mgmt"],"type":"local"}],"strategy":"ordered"},"untrust":{"paths":[{"name":"wan","type":"wan"}],"strategy":"ordered"}},"port_config":{"ge-0/0/0":{"aggregated":false,"ip_config":{"gateway":"192.168.1.1","ip":"192.168.1.9","netmask":"/24","type":"static"},"name":"wan","redundant":false,"traffic_shaping":{"enabled":false},"usage":"wan","wan_type":"broadband"},"ge-0/0/6-7":{"ae_disable_lacp":false,"ae_idx":"0","ae_lacp_force_up":true,"aggregated":true,"networks":["Corp-lan","Corp-Mgmt","Corp-Core"],"usage":"lan"}},"service_policies":[{"action":"allow","idp":{"enabled":false},"name":"ITParis-Internal","path_preference":"core","services":["internal_dns","drive"],"tenants":["ITParis"]},{"action":"deny","idp":{"enabled":false},"name":"ITParis-internet","path_preference":"untrust","services":["internet_any"],"tenants":["ITParis"]}],"type":"gateway"}'
contentMediaType: application/json
examples:
Deviceprofile Ap:
value:
aeroscout:
enabled: true
host: string
created_time: 0
disable_eth1: true
disable_module: true
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ip_config:
dns:
- string
dns_suffix:
- string
gateway: 192.168.0.1
gateway6: 2001:0db8:85a3:0000:0000:8a2e:0370:7334
ip: 192.168.0.1
ip6: 2001:0db8:85a3:0000:0000:8a2e:0370:7334
mtu: 1500
netmask: 192.168.0.1
netmask6: 2001:0db8:85a3:0000:0000:8a2e:0370:7334
type: static
type6: static
vlan_id: 1
mesh:
enabled: true
group: 1
role: base
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
poe_passthrough: true
switch_config:
enabled: true
eth0:
port_vlan_id: 1
vlan_ids:
- 1
- 10
eth1:
port_vlan_id: 1
vlan_ids:
- 10
eth2:
port_vlan_id: 1
vlan_ids:
- 10
eth3:
port_vlan_id: 1
vlan_ids:
- 10
module:
port_vlan_id: 1
vlan_ids:
- 10
wds:
port_vlan_id: 1
vlan_ids:
- 10
type: ap
usb_config:
cacert: string
enabled: true
host: string
type: imagotag
verify_cert: true
Deviceprofile Hub:
value:
created_time: 1680762730
dhcpd_config:
Corp-Mgmt:
dns_servers:
- 8.8.8.8
dns_suffix:
- stag.one
gateway: 10.3.172.9
ip_end: 10.3.172.99
ip_start: 10.3.172.50
type: local
Corp-lan:
dns_servers:
- 8.8.8.8
dns_suffix:
- stag.one
gateway: 10.3.171.9
ip_end: 10.3.171.99
ip_start: 10.3.171.50
type: local
dnsOverride: true
dns_servers:
- 10.3.20.201
- 10.3.51.222
- 1.1.1.1
dns_suffix:
- example.com
extra_routes:
10.101.0.0/16:
via: 10.3.100.10
id: 4ea55b5d-7313-4a81-a292-7ee125fd4ebb
ip_configs:
Corp-Core:
ip: 10.3.100.9
netmask: /24
type: static
Corp-Mgmt:
ip: 10.3.172.9
netmask: /24
type: static
Corp-lan:
ip: 10.3.171.9
netmask: /24
type: static
modified_time: 1680762890
name: ITParis
ntpOverride: true
ntp_servers:
- 10.3.51.222
org_id: 93986f10-773b-42be-9438-8d3e6d127f1a
path_preferences:
core:
paths:
- networks:
- Corp-Core
type: local
strategy: ordered
lab:
paths:
- networks:
- Corp-lan
type: local
strategy: ordered
mgmt:
paths:
- networks:
- Corp-Mgmt
type: local
strategy: ordered
untrust:
paths:
- name: wan
type: wan
strategy: ordered
port_config:
ge-0/0/0:
aggregated: false
ip_config:
gateway: 192.168.1.1
ip: 192.168.1.9
netmask: /24
type: static
name: wan
redundant: false
traffic_shaping:
enabled: false
usage: wan
wan_type: broadband
ge-0/0/6-7:
ae_disable_lacp: false
ae_idx: '0'
ae_lacp_force_up: true
aggregated: true
networks:
- Corp-lan
- Corp-Mgmt
- Corp-Core
usage: lan
service_policies:
- action: allow
idp:
enabled: false
name: ITParis-Internal
path_preference: core
services:
- internal_dns
- drive
tenants:
- ITParis
- action: deny
idp:
enabled: false
name: ITParis-internet
path_preference: untrust
services:
- internet_any
tenants:
- ITParis
type: gateway
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/deviceprofile'
- description: Device profile configuration for an AP, switch, or gateway
examples:
- '{"aeroscout":{"enabled":true,"host":"string"},"created_time":0,"disable_eth1":true,"disable_module":true,"id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","ip_config":{"dns":["string"],"dns_suffix":["string"],"gateway":"192.168.0.1","gateway6":"2001:0db8:85a3:0000:0000:8a2e:0370:7334","ip":"192.168.0.1","ip6":"2001:0db8:85a3:0000:0000:8a2e:0370:7334","mtu":1500,"netmask":"192.168.0.1","netmask6":"2001:0db8:85a3:0000:0000:8a2e:0370:7334","type":"static","type6":"static","vlan_id":1},"mesh":{"enabled":true,"group":1,"role":"base"},"modified_time":0,"name":"string","org_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","poe_passthrough":true,"switch_config":{"enabled":true,"eth0":{"port_vlan_id":1,"vlan_ids":[1,10]},"eth1":{"port_vlan_id":1,"vlan_ids":[10]},"eth2":{"port_vlan_id":1,"vlan_ids":[10]},"eth3":{"port_vlan_id":1,"vlan_ids":[10]},"module":{"port_vlan_id":1,"vlan_ids":[10]},"wds":{"port_vlan_id":1,"vlan_ids":[10]}},"type":"ap","usb_config":{"cacert":"string","enabled":true,"host":"string","type":"imagotag","verify_cert":true}}'
- '{"created_time":1680762730,"dhcpd_config":{"Corp-Mgmt":{"dns_servers":["8.8.8.8"],"dns_suffix":["stag.one"],"gateway":"10.3.172.9","ip_end":"10.3.172.99","ip_start":"10.3.172.50","type":"local"},"Corp-lan":{"dns_servers":["8.8.8.8"],"dns_suffix":["stag.one"],"gateway":"10.3.171.9","ip_end":"10.3.171.99","ip_start":"10.3.171.50","type":"local"}},"dnsOverride":true,"dns_servers":["10.3.20.201","10.3.51.222","1.1.1.1"],"dns_suffix":["example.com"],"extra_routes":{"10.101.0.0/16":{"via":"10.3.100.10"}},"id":"4ea55b5d-7313-4a81-a292-7ee125fd4ebb","ip_configs":{"Corp-Core":{"ip":"10.3.100.9","netmask":"/24","type":"static"},"Corp-Mgmt":{"ip":"10.3.172.9","netmask":"/24","type":"static"},"Corp-lan":{"ip":"10.3.171.9","netmask":"/24","type":"static"}},"modified_time":1680762890,"name":"ITParis","ntpOverride":true,"ntp_servers":["10.3.51.222"],"org_id":"93986f10-773b-42be-9438-8d3e6d127f1a","path_preferences":{"core":{"paths":[{"networks":["Corp-Core"],"type":"local"}],"strategy":"ordered"},"lab":{"paths":[{"networks":["Corp-lan"],"type":"local"}],"strategy":"ordered"},"mgmt":{"paths":[{"networks":["Corp-Mgmt"],"type":"local"}],"strategy":"ordered"},"untrust":{"paths":[{"name":"wan","type":"wan"}],"strategy":"ordered"}},"port_config":{"ge-0/0/0":{"aggregated":false,"ip_config":{"gateway":"192.168.1.1","ip":"192.168.1.9","netmask":"/24","type":"static"},"name":"wan","redundant":false,"traffic_shaping":{"enabled":false},"usage":"wan","wan_type":"broadband"},"ge-0/0/6-7":{"ae_disable_lacp":false,"ae_idx":"0","ae_lacp_force_up":true,"aggregated":true,"networks":["Corp-lan","Corp-Mgmt","Corp-Core"],"usage":"lan"}},"service_policies":[{"action":"allow","idp":{"enabled":false},"name":"ITParis-Internal","path_preference":"core","services":["internal_dns","drive"],"tenants":["ITParis"]},{"action":"deny","idp":{"enabled":false},"name":"ITParis-internet","path_preference":"untrust","services":["internet_any"],"tenants":["ITParis"]}],"type":"gateway"}'
contentMediaType: application/vnd.api+json
examples:
Deviceprofile Ap:
value:
aeroscout:
enabled: true
host: string
created_time: 0
disable_eth1: true
disable_module: true
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ip_config:
dns:
- string
dns_suffix:
- string
gateway: 192.168.0.1
gateway6: 2001:0db8:85a3:0000:0000:8a2e:0370:7334
ip: 192.168.0.1
ip6: 2001:0db8:85a3:0000:0000:8a2e:0370:7334
mtu: 1500
netmask: 192.168.0.1
netmask6: 2001:0db8:85a3:0000:0000:8a2e:0370:7334
type: static
type6: static
vlan_id: 1
mesh:
enabled: true
group: 1
role: base
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
poe_passthrough: true
switch_config:
enabled: true
eth0:
port_vlan_id: 1
vlan_ids:
- 1
- 10
eth1:
port_vlan_id: 1
vlan_ids:
- 10
eth2:
port_vlan_id: 1
vlan_ids:
- 10
eth3:
port_vlan_id: 1
vlan_ids:
- 10
module:
port_vlan_id: 1
vlan_ids:
- 10
wds:
port_vlan_id: 1
vlan_ids:
- 10
type: ap
usb_config:
cacert: string
enabled: true
host: string
type: imagotag
verify_cert: true
Deviceprofile Hub:
value:
created_time: 1680762730
dhcpd_config:
Corp-Mgmt:
dns_servers:
- 8.8.8.8
dns_suffix:
- stag.one
gateway: 10.3.172.9
ip_end: 10.3.172.99
ip_start: 10.3.172.50
type: local
Corp-lan:
dns_servers:
- 8.8.8.8
dns_suffix:
- stag.one
gateway: 10.3.171.9
ip_end: 10.3.171.99
ip_start: 10.3.171.50
type: local
dnsOverride: true
dns_servers:
- 10.3.20.201
- 10.3.51.222
- 1.1.1.1
dns_suffix:
- example.com
extra_routes:
10.101.0.0/16:
via: 10.3.100.10
id: 4ea55b5d-7313-4a81-a292-7ee125fd4ebb
ip_configs:
Corp-Core:
ip: 10.3.100.9
netmask: /24
type: static
Corp-Mgmt:
ip: 10.3.172.9
netmask: /24
type: static
Corp-lan:
ip: 10.3.171.9
netmask: /24
type: static
modified_time: 1680762890
name: ITParis
ntpOverride: true
ntp_servers:
- 10.3.51.222
org_id: 93986f10-773b-42be-9438-8d3e6d127f1a
path_preferences:
core:
paths:
- networks:
- Corp-Core
type: local
strategy: ordered
lab:
paths:
- networks:
- Corp-lan
type: local
strategy: ordered
mgmt:
paths:
- networks:
- Corp-Mgmt
type: local
strategy: ordered
untrust:
paths:
- name: wan
type: wan
strategy: ordered
port_config:
ge-0/0/0:
aggregated: false
ip_config:
gateway: 192.168.1.1
ip: 192.168.1.9
netmask: /24
type: static
name: wan
redundant: false
traffic_shaping:
enabled: false
usage: wan
wan_type: broadband
ge-0/0/6-7:
ae_disable_lacp: false
ae_idx: '0'
ae_lacp_force_up: true
aggregated: true
networks:
- Corp-lan
- Corp-Mgmt
- Corp-Core
usage: lan
service_policies:
- action: allow
idp:
enabled: false
name: ITParis-Internal
path_preference: core
services:
- internal_dns
- drive
tenants:
- ITParis
- action: deny
idp:
enabled: false
name: ITParis-internet
path_preference: untrust
services:
- internet_any
tenants:
- ITParis
type: gateway
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/deviceprofiles/{deviceprofile_id}:
delete:
tags:
- Orgs Device Profiles
summary: deleteOrgDeviceProfile
description: Delete an org-level device profile and remove that reusable device configuration object from the organization.
operationId: deleteOrgDeviceProfile
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: deviceprofile_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Orgs Device Profiles
summary: getOrgDeviceProfile
description: Retrieve the AP, switch, or gateway configuration stored in a specific org-level device profile.
operationId: getOrgDeviceProfile
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: deviceprofile_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/deviceprofile'
- description: Device profile configuration for an AP, switch, or gateway
examples:
- '{"aeroscout":{"enabled":true,"host":"string"},"created_time":0,"disable_eth1":true,"disable_module":true,"id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","ip_config":{"dns":["string"],"dns_suffix":["string"],"gateway":"192.168.0.1","gateway6":"2001:0db8:85a3:0000:0000:8a2e:0370:7334","ip":"192.168.0.1","ip6":"2001:0db8:85a3:0000:0000:8a2e:0370:7334","mtu":1500,"netmask":"192.168.0.1","netmask6":"2001:0db8:85a3:0000:0000:8a2e:0370:7334","type":"static","type6":"static","vlan_id":1},"mesh":{"enabled":true,"group":1,"role":"base"},"modified_time":0,"name":"string","org_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","poe_passthrough":true,"switch_config":{"enabled":true,"eth0":{"port_vlan_id":1,"vlan_ids":[1,10]},"eth1":{"port_vlan_id":1,"vlan_ids":[10]},"eth2":{"port_vlan_id":1,"vlan_ids":[10]},"eth3":{"port_vlan_id":1,"vlan_ids":[10]},"module":{"port_vlan_id":1,"vlan_ids":[10]},"wds":{"port_vlan_id":1,"vlan_ids":[10]}},"type":"ap","usb_config":{"cacert":"string","enabled":true,"host":"string","type":"imagotag","verify_cert":true}}'
- '{"created_time":1680762730,"dhcpd_config":{"Corp-Mgmt":{"dns_servers":["8.8.8.8"],"dns_suffix":["stag.one"],"gateway":"10.3.172.9","ip_end":"10.3.172.99","ip_start":"10.3.172.50","type":"local"},"Corp-lan":{"dns_servers":["8.8.8.8"],"dns_suffix":["stag.one"],"gateway":"10.3.171.9","ip_end":"10.3.171.99","ip_start":"10.3.171.50","type":"local"}},"dnsOverride":true,"dns_servers":["10.3.20.201","10.3.51.222","1.1.1.1"],"dns_suffix":["example.com"],"extra_routes":{"10.101.0.0/16":{"via":"10.3.100.10"}},"id":"4ea55b5d-7313-4a81-a292-7ee125fd4ebb","ip_configs":{"Corp-Core":{"ip":"10.3.100.9","netmask":"/24","type":"static"},"Corp-Mgmt":{"ip":"10.3.172.9","netmask":"/24","type":"static"},"Corp-lan":{"ip":"10.3.171.9","netmask":"/24","type":"static"}},"modified_time":1680762890,"name":"ITParis","ntpOverride":true,"ntp_servers":["10.3.51.222"],"org_id":"93986f10-773b-42be-9438-8d3e6d127f1a","path_preferences":{"core":{"paths":[{"networks":["Corp-Core"],"type":"local"}],"strategy":"ordered"},"lab":{"paths":[{"networks":["Corp-lan"],"type":"local"}],"strategy":"ordered"},"mgmt":{"paths":[{"networks":["Corp-Mgmt"],"type":"local"}],"strategy":"ordered"},"untrust":{"paths":[{"name":"wan","type":"wan"}],"strategy":"ordered"}},"port_config":{"ge-0/0/0":{"aggregated":false,"ip_config":{"gateway":"192.168.1.1","ip":"192.168.1.9","netmask":"/24","type":"static"},"name":"wan","redundant":false,"traffic_shaping":{"enabled":false},"usage":"wan","wan_type":"broadband"},"ge-0/0/6-7":{"ae_disable_lacp":false,"ae_idx":"0","ae_lacp_force_up":true,"aggregated":true,"networks":["Corp-lan","Corp-Mgmt","Corp-Core"],"usage":"lan"}},"service_policies":[{"action":"allow","idp":{"enabled":false},"name":"ITParis-Internal","path_preference":"core","services":["internal_dns","drive"],"tenants":["ITParis"]},{"action":"deny","idp":{"enabled":false},"name":"ITParis-internet","path_preference":"untrust","services":["internet_any"],"tenants":["ITParis"]}],"type":"gateway"}'
contentMediaType: application/json
examples:
Deviceprofile Ap:
value:
aeroscout:
enabled: true
host: string
created_time: 0
disable_eth1: true
disable_module: true
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ip_config:
dns:
- string
dns_suffix:
- string
gateway: 192.168.0.1
gateway6: 2001:0db8:85a3:0000:0000:8a2e:0370:7334
ip: 192.168.0.1
ip6: 2001:0db8:85a3:0000:0000:8a2e:0370:7334
mtu: 1500
netmask: 192.168.0.1
netmask6: 2001:0db8:85a3:0000:0000:8a2e:0370:7334
type: static
type6: static
vlan_id: 1
mesh:
enabled: true
group: 1
role: base
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
poe_passthrough: true
switch_config:
enabled: true
eth0:
port_vlan_id: 1
vlan_ids:
- 1
- 10
eth1:
port_vlan_id: 1
vlan_ids:
- 10
eth2:
port_vlan_id: 1
vlan_ids:
- 10
eth3:
port_vlan_id: 1
vlan_ids:
- 10
module:
port_vlan_id: 1
vlan_ids:
- 10
wds:
port_vlan_id: 1
vlan_ids:
- 10
type: ap
usb_config:
cacert: string
enabled: true
host: string
type: imagotag
verify_cert: true
Deviceprofile Hub:
value:
created_time: 1680762730
dhcpd_config:
Corp-Mgmt:
dns_servers:
- 8.8.8.8
dns_suffix:
- stag.one
gateway: 10.3.172.9
ip_end: 10.3.172.99
ip_start: 10.3.172.50
type: local
Corp-lan:
dns_servers:
- 8.8.8.8
dns_suffix:
- stag.one
gateway: 10.3.171.9
ip_end: 10.3.171.99
ip_start: 10.3.171.50
type: local
dnsOverride: true
dns_servers:
- 10.3.20.201
- 10.3.51.222
- 1.1.1.1
dns_suffix:
- example.com
extra_routes:
10.101.0.0/16:
via: 10.3.100.10
id: 4ea55b5d-7313-4a81-a292-7ee125fd4ebb
ip_configs:
Corp-Core:
ip: 10.3.100.9
netmask: /24
type: static
Corp-Mgmt:
ip: 10.3.172.9
netmask: /24
type: static
Corp-lan:
ip: 10.3.171.9
netmask: /24
type: static
modified_time: 1680762890
name: ITParis
ntpOverride: true
ntp_servers:
- 10.3.51.222
org_id: 93986f10-773b-42be-9438-8d3e6d127f1a
path_preferences:
core:
paths:
- networks:
- Corp-Core
type: local
strategy: ordered
lab:
paths:
- networks:
- Corp-lan
type: local
strategy: ordered
mgmt:
paths:
- networks:
- Corp-Mgmt
type: local
strategy: ordered
untrust:
paths:
- name: wan
type: wan
strategy: ordered
port_config:
ge-0/0/0:
aggregated: false
ip_config:
gateway: 192.168.1.1
ip: 192.168.1.9
netmask: /24
type: static
name: wan
redundant: false
traffic_shaping:
enabled: false
usage: wan
wan_type: broadband
ge-0/0/6-7:
ae_disable_lacp: false
ae_idx: '0'
ae_lacp_force_up: true
aggregated: true
networks:
- Corp-lan
- Corp-Mgmt
- Corp-Core
usage: lan
service_policies:
- action: allow
idp:
enabled: false
name: ITParis-Internal
path_preference: core
services:
- internal_dns
- drive
tenants:
- ITParis
- action: deny
idp:
enabled: false
name: ITParis-internet
path_preference: untrust
services:
- internet_any
tenants:
- ITParis
type: gateway
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/deviceprofile'
- description: Device profile configuration for an AP, switch, or gateway
examples:
- '{"aeroscout":{"enabled":true,"host":"string"},"created_time":0,"disable_eth1":true,"disable_module":true,"id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","ip_config":{"dns":["string"],"dns_suffix":["string"],"gateway":"192.168.0.1","gateway6":"2001:0db8:85a3:0000:0000:8a2e:0370:7334","ip":"192.168.0.1","ip6":"2001:0db8:85a3:0000:0000:8a2e:0370:7334","mtu":1500,"netmask":"192.168.0.1","netmask6":"2001:0db8:85a3:0000:0000:8a2e:0370:7334","type":"static","type6":"static","vlan_id":1},"mesh":{"enabled":true,"group":1,"role":"base"},"modified_time":0,"name":"string","org_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","poe_passthrough":true,"switch_config":{"enabled":true,"eth0":{"port_vlan_id":1,"vlan_ids":[1,10]},"eth1":{"port_vlan_id":1,"vlan_ids":[10]},"eth2":{"port_vlan_id":1,"vlan_ids":[10]},"eth3":{"port_vlan_id":1,"vlan_ids":[10]},"module":{"port_vlan_id":1,"vlan_ids":[10]},"wds":{"port_vlan_id":1,"vlan_ids":[10]}},"type":"ap","usb_config":{"cacert":"string","enabled":true,"host":"string","type":"imagotag","verify_cert":true}}'
- '{"created_time":1680762730,"dhcpd_config":{"Corp-Mgmt":{"dns_servers":["8.8.8.8"],"dns_suffix":["stag.one"],"gateway":"10.3.172.9","ip_end":"10.3.172.99","ip_start":"10.3.172.50","type":"local"},"Corp-lan":{"dns_servers":["8.8.8.8"],"dns_suffix":["stag.one"],"gateway":"10.3.171.9","ip_end":"10.3.171.99","ip_start":"10.3.171.50","type":"local"}},"dnsOverride":true,"dns_servers":["10.3.20.201","10.3.51.222","1.1.1.1"],"dns_suffix":["example.com"],"extra_routes":{"10.101.0.0/16":{"via":"10.3.100.10"}},"id":"4ea55b5d-7313-4a81-a292-7ee125fd4ebb","ip_configs":{"Corp-Core":{"ip":"10.3.100.9","netmask":"/24","type":"static"},"Corp-Mgmt":{"ip":"10.3.172.9","netmask":"/24","type":"static"},"Corp-lan":{"ip":"10.3.171.9","netmask":"/24","type":"static"}},"modified_time":1680762890,"name":"ITParis","ntpOverride":true,"ntp_servers":["10.3.51.222"],"org_id":"93986f10-773b-42be-9438-8d3e6d127f1a","path_preferences":{"core":{"paths":[{"networks":["Corp-Core"],"type":"local"}],"strategy":"ordered"},"lab":{"paths":[{"networks":["Corp-lan"],"type":"local"}],"strategy":"ordered"},"mgmt":{"paths":[{"networks":["Corp-Mgmt"],"type":"local"}],"strategy":"ordered"},"untrust":{"paths":[{"name":"wan","type":"wan"}],"strategy":"ordered"}},"port_config":{"ge-0/0/0":{"aggregated":false,"ip_config":{"gateway":"192.168.1.1","ip":"192.168.1.9","netmask":"/24","type":"static"},"name":"wan","redundant":false,"traffic_shaping":{"enabled":false},"usage":"wan","wan_type":"broadband"},"ge-0/0/6-7":{"ae_disable_lacp":false,"ae_idx":"0","ae_lacp_force_up":true,"aggregated":true,"networks":["Corp-lan","Corp-Mgmt","Corp-Core"],"usage":"lan"}},"service_policies":[{"action":"allow","idp":{"enabled":false},"name":"ITParis-Internal","path_preference":"core","services":["internal_dns","drive"],"tenants":["ITParis"]},{"action":"deny","idp":{"enabled":false},"name":"ITParis-internet","path_preference":"untrust","services":["internet_any"],"tenants":["ITParis"]}],"type":"gateway"}'
contentMediaType: application/vnd.api+json
examples:
Deviceprofile Ap:
value:
aeroscout:
enabled: true
host: string
created_time: 0
disable_eth1: true
disable_module: true
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ip_config:
dns:
- string
dns_suffix:
- string
gateway: 192.168.0.1
gateway6: 2001:0db8:85a3:0000:0000:8a2e:0370:7334
ip: 192.168.0.1
ip6: 2001:0db8:85a3:0000:0000:8a2e:0370:7334
mtu: 1500
netmask: 192.168.0.1
netmask6: 2001:0db8:85a3:0000:0000:8a2e:0370:7334
type: static
type6: static
vlan_id: 1
mesh:
enabled: true
group: 1
role: base
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
poe_passthrough: true
switch_config:
enabled: true
eth0:
port_vlan_id: 1
vlan_ids:
- 1
- 10
eth1:
port_vlan_id: 1
vlan_ids:
- 10
eth2:
port_vlan_id: 1
vlan_ids:
- 10
eth3:
port_vlan_id: 1
vlan_ids:
- 10
module:
port_vlan_id: 1
vlan_ids:
- 10
wds:
port_vlan_id: 1
vlan_ids:
- 10
type: ap
usb_config:
cacert: string
enabled: true
host: string
type: imagotag
verify_cert: true
Deviceprofile Hub:
value:
created_time: 1680762730
dhcpd_config:
Corp-Mgmt:
dns_servers:
- 8.8.8.8
dns_suffix:
- stag.one
gateway: 10.3.172.9
ip_end: 10.3.172.99
ip_start: 10.3.172.50
type: local
Corp-lan:
dns_servers:
- 8.8.8.8
dns_suffix:
- stag.one
gateway: 10.3.171.9
ip_end: 10.3.171.99
ip_start: 10.3.171.50
type: local
dnsOverride: true
dns_servers:
- 10.3.20.201
- 10.3.51.222
- 1.1.1.1
dns_suffix:
- example.com
extra_routes:
10.101.0.0/16:
via: 10.3.100.10
id: 4ea55b5d-7313-4a81-a292-7ee125fd4ebb
ip_configs:
Corp-Core:
ip: 10.3.100.9
netmask: /24
type: static
Corp-Mgmt:
ip: 10.3.172.9
netmask: /24
type: static
Corp-lan:
ip: 10.3.171.9
netmask: /24
type: static
modified_time: 1680762890
name: ITParis
ntpOverride: true
ntp_servers:
- 10.3.51.222
org_id: 93986f10-773b-42be-9438-8d3e6d127f1a
path_preferences:
core:
paths:
- networks:
- Corp-Core
type: local
strategy: ordered
lab:
paths:
- networks:
- Corp-lan
type: local
strategy: ordered
mgmt:
paths:
- networks:
- Corp-Mgmt
type: local
strategy: ordered
untrust:
paths:
- name: wan
type: wan
strategy: ordered
port_config:
ge-0/0/0:
aggregated: false
ip_config:
gateway: 192.168.1.1
ip: 192.168.1.9
netmask: /24
type: static
name: wan
redundant: false
traffic_shaping:
enabled: false
usage: wan
wan_type: broadband
ge-0/0/6-7:
ae_disable_lacp: false
ae_idx: '0'
ae_lacp_force_up: true
aggregated: true
networks:
- Corp-lan
- Corp-Mgmt
- Corp-Core
usage: lan
service_policies:
- action: allow
idp:
enabled: false
name: ITParis-Internal
path_preference: core
services:
- internal_dns
- drive
tenants:
- ITParis
- action: deny
idp:
enabled: false
name: ITParis-internet
path_preference: untrust
services:
- internet_any
tenants:
- ITParis
type: gateway
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Orgs Device Profiles
summary: updateOrgDeviceProfile
description: Update the AP, switch, or gateway configuration stored in an org-level device profile.
operationId: updateOrgDeviceProfile
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: deviceprofile_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/deviceprofile'
- description: Request Body
examples:
- '{"aeroscout":{"enabled":true,"host":"aero.pvt.net"},"disable_eth1":true,"disable_module":true,"mesh":{"enabled":true,"group":1,"role":"base"},"name":"string","poe_passthrough":true,"radio_config":{"ant_gain_24":0,"ant_gain_5":0,"band_24":{"allow_rrm_disable":true,"antenna_mode":"default","bandwidth":20,"channel":6,"disabled":true,"power":8,"preamble":"auto"},"band_24_usage":"24","band_5":{"allow_rrm_disable":true,"antenna_mode":"default","bandwidth":20,"channel":50,"disabled":true,"power_max":8,"power_min":15,"preamble":"auto"},"scanning_enabled":true},"type":"ap"}'
- '{"dhcpd_config":{"Corp-Mgmt":{"dns_servers":["8.8.8.8"],"dns_suffix":["stag.one"],"gateway":"10.3.172.9","ip_end":"10.3.172.99","ip_start":"10.3.172.50","type":"local"},"Corp-lan":{"dns_servers":["8.8.8.8"],"dns_suffix":["stag.one"],"gateway":"10.3.171.9","ip_end":"10.3.171.99","ip_start":"10.3.171.50","type":"local"}},"dnsOverride":true,"dns_servers":["10.3.20.201","10.3.51.222","1.1.1.1"],"dns_suffix":["example.com"],"extra_routes":{"10.101.0.0/16":{"via":"10.3.100.10"}},"ip_configs":{"Corp-Core":{"ip":"10.3.100.9","netmask":"/24","type":"static"},"Corp-Mgmt":{"ip":"10.3.172.9","netmask":"/24","type":"static"},"Corp-lan":{"ip":"10.3.171.9","netmask":"/24","type":"static"}},"name":"ITParis","ntpOverride":true,"ntp_servers":["10.3.51.222"],"path_preferences":{"core":{"paths":[{"networks":["Corp-Core"],"type":"local"}],"strategy":"ordered"},"lab":{"paths":[{"networks":["Corp-lan"],"type":"local"}],"strategy":"ordered"},"mgmt":{"paths":[{"networks":["Corp-Mgmt"],"type":"local"}],"strategy":"ordered"},"untrust":{"paths":[{"name":"wan","type":"wan"}],"strategy":"ordered"}},"port_config":{"ge-0/0/0":{"aggregated":false,"ip_config":{"gateway":"192.168.1.1","ip":"192.168.1.9","netmask":"/24","type":"static"},"name":"wan","redundant":false,"traffic_shaping":{"enabled":false},"usage":"wan","wan_type":"broadband"},"ge-0/0/6-7":{"ae_disable_lacp":false,"ae_idx":"0","ae_lacp_force_up":true,"aggregated":true,"networks":["Corp-lan","Corp-Mgmt","Corp-Core"],"usage":"lan"}},"service_policies":[{"action":"allow","idp":{"enabled":false},"name":"ITParis-Internal","path_preference":"core","services":["internal_dns","drive"],"tenants":["ITParis"]},{"action":"deny","idp":{"enabled":false},"name":"ITParis-internet","path_preference":"untrust","services":["internet_any"],"tenants":["ITParis"]}],"type":"gateway"}'
contentMediaType: application/json
examples:
deviceprofile_ap:
value:
aeroscout:
enabled: true
host: aero.pvt.net
disable_eth1: true
disable_module: true
mesh:
enabled: true
group: 1
role: base
name: string
poe_passthrough: true
radio_config:
ant_gain_24: 0
ant_gain_5: 0
band_24:
allow_rrm_disable: true
antenna_mode: default
bandwidth: 20
channel: 6
disabled: true
power: 8
preamble: auto
band_24_usage: '24'
band_5:
allow_rrm_disable: true
antenna_mode: default
bandwidth: 20
channel: 50
disabled: true
power_max: 8
power_min: 15
preamble: auto
scanning_enabled: true
type: ap
deviceprofile_hub:
value:
dhcpd_config:
Corp-Mgmt:
dns_servers:
- 8.8.8.8
dns_suffix:
- stag.one
gateway: 10.3.172.9
ip_end: 10.3.172.99
ip_start: 10.3.172.50
type: local
Corp-lan:
dns_servers:
- 8.8.8.8
dns_suffix:
- stag.one
gateway: 10.3.171.9
ip_end: 10.3.171.99
ip_start: 10.3.171.50
type: local
dnsOverride: true
dns_servers:
- 10.3.20.201
- 10.3.51.222
- 1.1.1.1
dns_suffix:
- example.com
extra_routes:
10.101.0.0/16:
via: 10.3.100.10
ip_configs:
Corp-Core:
ip: 10.3.100.9
netmask: /24
type: static
Corp-Mgmt:
ip: 10.3.172.9
netmask: /24
type: static
Corp-lan:
ip: 10.3.171.9
netmask: /24
type: static
name: ITParis
ntpOverride: true
ntp_servers:
- 10.3.51.222
path_preferences:
core:
paths:
- networks:
- Corp-Core
type: local
strategy: ordered
lab:
paths:
- networks:
- Corp-lan
type: local
strategy: ordered
mgmt:
paths:
- networks:
- Corp-Mgmt
type: local
strategy: ordered
untrust:
paths:
- name: wan
type: wan
strategy: ordered
port_config:
ge-0/0/0:
aggregated: false
ip_config:
gateway: 192.168.1.1
ip: 192.168.1.9
netmask: /24
type: static
name: wan
redundant: false
traffic_shaping:
enabled: false
usage: wan
wan_type: broadband
ge-0/0/6-7:
ae_disable_lacp: false
ae_idx: '0'
ae_lacp_force_up: true
aggregated: true
networks:
- Corp-lan
- Corp-Mgmt
- Corp-Core
usage: lan
service_policies:
- action: allow
idp:
enabled: false
name: ITParis-Internal
path_preference: core
services:
- internal_dns
- drive
tenants:
- ITParis
- action: deny
idp:
enabled: false
name: ITParis-internet
path_preference: untrust
services:
- internet_any
tenants:
- ITParis
type: gateway
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/deviceprofile'
- description: Device profile configuration for an AP, switch, or gateway
examples:
- '{"aeroscout":{"enabled":true,"host":"string"},"created_time":0,"disable_eth1":true,"disable_module":true,"id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","ip_config":{"dns":["string"],"dns_suffix":["string"],"gateway":"192.168.0.1","gateway6":"2001:0db8:85a3:0000:0000:8a2e:0370:7334","ip":"192.168.0.1","ip6":"2001:0db8:85a3:0000:0000:8a2e:0370:7334","mtu":1500,"netmask":"192.168.0.1","netmask6":"2001:0db8:85a3:0000:0000:8a2e:0370:7334","type":"static","type6":"static","vlan_id":1},"mesh":{"enabled":true,"group":1,"role":"base"},"modified_time":0,"name":"string","org_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","poe_passthrough":true,"switch_config":{"enabled":true,"eth0":{"port_vlan_id":1,"vlan_ids":[1,10]},"eth1":{"port_vlan_id":1,"vlan_ids":[10]},"eth2":{"port_vlan_id":1,"vlan_ids":[10]},"eth3":{"port_vlan_id":1,"vlan_ids":[10]},"module":{"port_vlan_id":1,"vlan_ids":[10]},"wds":{"port_vlan_id":1,"vlan_ids":[10]}},"type":"ap","usb_config":{"cacert":"string","enabled":true,"host":"string","type":"imagotag","verify_cert":true}}'
- '{"created_time":1680762730,"dhcpd_config":{"Corp-Mgmt":{"dns_servers":["8.8.8.8"],"dns_suffix":["stag.one"],"gateway":"10.3.172.9","ip_end":"10.3.172.99","ip_start":"10.3.172.50","type":"local"},"Corp-lan":{"dns_servers":["8.8.8.8"],"dns_suffix":["stag.one"],"gateway":"10.3.171.9","ip_end":"10.3.171.99","ip_start":"10.3.171.50","type":"local"}},"dnsOverride":true,"dns_servers":["10.3.20.201","10.3.51.222","1.1.1.1"],"dns_suffix":["example.com"],"extra_routes":{"10.101.0.0/16":{"via":"10.3.100.10"}},"id":"4ea55b5d-7313-4a81-a292-7ee125fd4ebb","ip_configs":{"Corp-Core":{"ip":"10.3.100.9","netmask":"/24","type":"static"},"Corp-Mgmt":{"ip":"10.3.172.9","netmask":"/24","type":"static"},"Corp-lan":{"ip":"10.3.171.9","netmask":"/24","type":"static"}},"modified_time":1680762890,"name":"ITParis","ntpOverride":true,"ntp_servers":["10.3.51.222"],"org_id":"93986f10-773b-42be-9438-8d3e6d127f1a","path_preferences":{"core":{"paths":[{"networks":["Corp-Core"],"type":"local"}],"strategy":"ordered"},"lab":{"paths":[{"networks":["Corp-lan"],"type":"local"}],"strategy":"ordered"},"mgmt":{"paths":[{"networks":["Corp-Mgmt"],"type":"local"}],"strategy":"ordered"},"untrust":{"paths":[{"name":"wan","type":"wan"}],"strategy":"ordered"}},"port_config":{"ge-0/0/0":{"aggregated":false,"ip_config":{"gateway":"192.168.1.1","ip":"192.168.1.9","netmask":"/24","type":"static"},"name":"wan","redundant":false,"traffic_shaping":{"enabled":false},"usage":"wan","wan_type":"broadband"},"ge-0/0/6-7":{"ae_disable_lacp":false,"ae_idx":"0","ae_lacp_force_up":true,"aggregated":true,"networks":["Corp-lan","Corp-Mgmt","Corp-Core"],"usage":"lan"}},"service_policies":[{"action":"allow","idp":{"enabled":false},"name":"ITParis-Internal","path_preference":"core","services":["internal_dns","drive"],"tenants":["ITParis"]},{"action":"deny","idp":{"enabled":false},"name":"ITParis-internet","path_preference":"untrust","services":["internet_any"],"tenants":["ITParis"]}],"type":"gateway"}'
contentMediaType: application/json
examples:
Deviceprofile Ap:
value:
aeroscout:
enabled: true
host: string
created_time: 0
disable_eth1: true
disable_module: true
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ip_config:
dns:
- string
dns_suffix:
- string
gateway: 192.168.0.1
gateway6: 2001:0db8:85a3:0000:0000:8a2e:0370:7334
ip: 192.168.0.1
ip6: 2001:0db8:85a3:0000:0000:8a2e:0370:7334
mtu: 1500
netmask: 192.168.0.1
netmask6: 2001:0db8:85a3:0000:0000:8a2e:0370:7334
type: static
type6: static
vlan_id: 1
mesh:
enabled: true
group: 1
role: base
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
poe_passthrough: true
switch_config:
enabled: true
eth0:
port_vlan_id: 1
vlan_ids:
- 1
- 10
eth1:
port_vlan_id: 1
vlan_ids:
- 10
eth2:
port_vlan_id: 1
vlan_ids:
- 10
eth3:
port_vlan_id: 1
vlan_ids:
- 10
module:
port_vlan_id: 1
vlan_ids:
- 10
wds:
port_vlan_id: 1
vlan_ids:
- 10
type: ap
usb_config:
cacert: string
enabled: true
host: string
type: imagotag
verify_cert: true
Deviceprofile Hub:
value:
created_time: 1680762730
dhcpd_config:
Corp-Mgmt:
dns_servers:
- 8.8.8.8
dns_suffix:
- stag.one
gateway: 10.3.172.9
ip_end: 10.3.172.99
ip_start: 10.3.172.50
type: local
Corp-lan:
dns_servers:
- 8.8.8.8
dns_suffix:
- stag.one
gateway: 10.3.171.9
ip_end: 10.3.171.99
ip_start: 10.3.171.50
type: local
dnsOverride: true
dns_servers:
- 10.3.20.201
- 10.3.51.222
- 1.1.1.1
dns_suffix:
- example.com
extra_routes:
10.101.0.0/16:
via: 10.3.100.10
id: 4ea55b5d-7313-4a81-a292-7ee125fd4ebb
ip_configs:
Corp-Core:
ip: 10.3.100.9
netmask: /24
type: static
Corp-Mgmt:
ip: 10.3.172.9
netmask: /24
type: static
Corp-lan:
ip: 10.3.171.9
netmask: /24
type: static
modified_time: 1680762890
name: ITParis
ntpOverride: true
ntp_servers:
- 10.3.51.222
org_id: 93986f10-773b-42be-9438-8d3e6d127f1a
path_preferences:
core:
paths:
- networks:
- Corp-Core
type: local
strategy: ordered
lab:
paths:
- networks:
- Corp-lan
type: local
strategy: ordered
mgmt:
paths:
- networks:
- Corp-Mgmt
type: local
strategy: ordered
untrust:
paths:
- name: wan
type: wan
strategy: ordered
port_config:
ge-0/0/0:
aggregated: false
ip_config:
gateway: 192.168.1.1
ip: 192.168.1.9
netmask: /24
type: static
name: wan
redundant: false
traffic_shaping:
enabled: false
usage: wan
wan_type: broadband
ge-0/0/6-7:
ae_disable_lacp: false
ae_idx: '0'
ae_lacp_force_up: true
aggregated: true
networks:
- Corp-lan
- Corp-Mgmt
- Corp-Core
usage: lan
service_policies:
- action: allow
idp:
enabled: false
name: ITParis-Internal
path_preference: core
services:
- internal_dns
- drive
tenants:
- ITParis
- action: deny
idp:
enabled: false
name: ITParis-internet
path_preference: untrust
services:
- internet_any
tenants:
- ITParis
type: gateway
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/deviceprofile'
- description: Device profile configuration for an AP, switch, or gateway
examples:
- '{"aeroscout":{"enabled":true,"host":"string"},"created_time":0,"disable_eth1":true,"disable_module":true,"id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","ip_config":{"dns":["string"],"dns_suffix":["string"],"gateway":"192.168.0.1","gateway6":"2001:0db8:85a3:0000:0000:8a2e:0370:7334","ip":"192.168.0.1","ip6":"2001:0db8:85a3:0000:0000:8a2e:0370:7334","mtu":1500,"netmask":"192.168.0.1","netmask6":"2001:0db8:85a3:0000:0000:8a2e:0370:7334","type":"static","type6":"static","vlan_id":1},"mesh":{"enabled":true,"group":1,"role":"base"},"modified_time":0,"name":"string","org_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","poe_passthrough":true,"switch_config":{"enabled":true,"eth0":{"port_vlan_id":1,"vlan_ids":[1,10]},"eth1":{"port_vlan_id":1,"vlan_ids":[10]},"eth2":{"port_vlan_id":1,"vlan_ids":[10]},"eth3":{"port_vlan_id":1,"vlan_ids":[10]},"module":{"port_vlan_id":1,"vlan_ids":[10]},"wds":{"port_vlan_id":1,"vlan_ids":[10]}},"type":"ap","usb_config":{"cacert":"string","enabled":true,"host":"string","type":"imagotag","verify_cert":true}}'
- '{"created_time":1680762730,"dhcpd_config":{"Corp-Mgmt":{"dns_servers":["8.8.8.8"],"dns_suffix":["stag.one"],"gateway":"10.3.172.9","ip_end":"10.3.172.99","ip_start":"10.3.172.50","type":"local"},"Corp-lan":{"dns_servers":["8.8.8.8"],"dns_suffix":["stag.one"],"gateway":"10.3.171.9","ip_end":"10.3.171.99","ip_start":"10.3.171.50","type":"local"}},"dnsOverride":true,"dns_servers":["10.3.20.201","10.3.51.222","1.1.1.1"],"dns_suffix":["example.com"],"extra_routes":{"10.101.0.0/16":{"via":"10.3.100.10"}},"id":"4ea55b5d-7313-4a81-a292-7ee125fd4ebb","ip_configs":{"Corp-Core":{"ip":"10.3.100.9","netmask":"/24","type":"static"},"Corp-Mgmt":{"ip":"10.3.172.9","netmask":"/24","type":"static"},"Corp-lan":{"ip":"10.3.171.9","netmask":"/24","type":"static"}},"modified_time":1680762890,"name":"ITParis","ntpOverride":true,"ntp_servers":["10.3.51.222"],"org_id":"93986f10-773b-42be-9438-8d3e6d127f1a","path_preferences":{"core":{"paths":[{"networks":["Corp-Core"],"type":"local"}],"strategy":"ordered"},"lab":{"paths":[{"networks":["Corp-lan"],"type":"local"}],"strategy":"ordered"},"mgmt":{"paths":[{"networks":["Corp-Mgmt"],"type":"local"}],"strategy":"ordered"},"untrust":{"paths":[{"name":"wan","type":"wan"}],"strategy":"ordered"}},"port_config":{"ge-0/0/0":{"aggregated":false,"ip_config":{"gateway":"192.168.1.1","ip":"192.168.1.9","netmask":"/24","type":"static"},"name":"wan","redundant":false,"traffic_shaping":{"enabled":false},"usage":"wan","wan_type":"broadband"},"ge-0/0/6-7":{"ae_disable_lacp":false,"ae_idx":"0","ae_lacp_force_up":true,"aggregated":true,"networks":["Corp-lan","Corp-Mgmt","Corp-Core"],"usage":"lan"}},"service_policies":[{"action":"allow","idp":{"enabled":false},"name":"ITParis-Internal","path_preference":"core","services":["internal_dns","drive"],"tenants":["ITParis"]},{"action":"deny","idp":{"enabled":false},"name":"ITParis-internet","path_preference":"untrust","services":["internet_any"],"tenants":["ITParis"]}],"type":"gateway"}'
contentMediaType: application/vnd.api+json
examples:
Deviceprofile Ap:
value:
aeroscout:
enabled: true
host: string
created_time: 0
disable_eth1: true
disable_module: true
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ip_config:
dns:
- string
dns_suffix:
- string
gateway: 192.168.0.1
gateway6: 2001:0db8:85a3:0000:0000:8a2e:0370:7334
ip: 192.168.0.1
ip6: 2001:0db8:85a3:0000:0000:8a2e:0370:7334
mtu: 1500
netmask: 192.168.0.1
netmask6: 2001:0db8:85a3:0000:0000:8a2e:0370:7334
type: static
type6: static
vlan_id: 1
mesh:
enabled: true
group: 1
role: base
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
poe_passthrough: true
switch_config:
enabled: true
eth0:
port_vlan_id: 1
vlan_ids:
- 1
- 10
eth1:
port_vlan_id: 1
vlan_ids:
- 10
eth2:
port_vlan_id: 1
vlan_ids:
- 10
eth3:
port_vlan_id: 1
vlan_ids:
- 10
module:
port_vlan_id: 1
vlan_ids:
- 10
wds:
port_vlan_id: 1
vlan_ids:
- 10
type: ap
usb_config:
cacert: string
enabled: true
host: string
type: imagotag
verify_cert: true
Deviceprofile Hub:
value:
created_time: 1680762730
dhcpd_config:
Corp-Mgmt:
dns_servers:
- 8.8.8.8
dns_suffix:
- stag.one
gateway: 10.3.172.9
ip_end: 10.3.172.99
ip_start: 10.3.172.50
type: local
Corp-lan:
dns_servers:
- 8.8.8.8
dns_suffix:
- stag.one
gateway: 10.3.171.9
ip_end: 10.3.171.99
ip_start: 10.3.171.50
type: local
dnsOverride: true
dns_servers:
- 10.3.20.201
- 10.3.51.222
- 1.1.1.1
dns_suffix:
- example.com
extra_routes:
10.101.0.0/16:
via: 10.3.100.10
id: 4ea55b5d-7313-4a81-a292-7ee125fd4ebb
ip_configs:
Corp-Core:
ip: 10.3.100.9
netmask: /24
type: static
Corp-Mgmt:
ip: 10.3.172.9
netmask: /24
type: static
Corp-lan:
ip: 10.3.171.9
netmask: /24
type: static
modified_time: 1680762890
name: ITParis
ntpOverride: true
ntp_servers:
- 10.3.51.222
org_id: 93986f10-773b-42be-9438-8d3e6d127f1a
path_preferences:
core:
paths:
- networks:
- Corp-Core
type: local
strategy: ordered
lab:
paths:
- networks:
- Corp-lan
type: local
strategy: ordered
mgmt:
paths:
- networks:
- Corp-Mgmt
type: local
strategy: ordered
untrust:
paths:
- name: wan
type: wan
strategy: ordered
port_config:
ge-0/0/0:
aggregated: false
ip_config:
gateway: 192.168.1.1
ip: 192.168.1.9
netmask: /24
type: static
name: wan
redundant: false
traffic_shaping:
enabled: false
usage: wan
wan_type: broadband
ge-0/0/6-7:
ae_disable_lacp: false
ae_idx: '0'
ae_lacp_force_up: true
aggregated: true
networks:
- Corp-lan
- Corp-Mgmt
- Corp-Core
usage: lan
service_policies:
- action: allow
idp:
enabled: false
name: ITParis-Internal
path_preference: core
services:
- internal_dns
- drive
tenants:
- ITParis
- action: deny
idp:
enabled: false
name: ITParis-internet
path_preference: untrust
services:
- internet_any
tenants:
- ITParis
type: gateway
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/deviceprofiles/{deviceprofile_id}/assign:
post:
tags:
- Orgs Device Profiles
summary: assignOrgDeviceProfile
description: Assign Org Device Profile to Devices
operationId: assignOrgDeviceProfile
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: deviceprofile_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/mac_addresses'
- description: Request Body
examples:
- macs:
- 5c5b350e0001
- 5c5b350e0003
contentMediaType: application/json
examples:
Example:
value:
macs:
- 5c5b350e0001
- 5c5b350e0003
required: false
responses:
'200':
description: OK - list only devices that has deviceprofile_id changed
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_assign_success'
- description: Assignment operation success response
examples:
- success:
- 5c5b350e0001
contentMediaType: application/json
examples:
Example:
value:
success:
- 5c5b350e0001
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_assign_success'
- description: Assignment operation success response
examples:
- success:
- 5c5b350e0001
contentMediaType: application/vnd.api+json
examples:
Example:
value:
success:
- 5c5b350e0001
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/deviceprofiles/{deviceprofile_id}/unassign:
post:
tags:
- Orgs Device Profiles
summary: unassignOrgDeviceProfile
description: Unassign Org Device Profile from Devices
operationId: unassignOrgDeviceProfile
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: deviceprofile_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/mac_addresses'
- description: Request Body
examples:
- macs:
- 5c5b350e0001
- 5c5b350e0003
contentMediaType: application/json
examples:
Example:
value:
macs:
- 5c5b350e0001
- 5c5b350e0003
required: false
responses:
'200':
description: OK - list only devices that has deviceprofile_id changed
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_assign_success'
- description: Assignment operation success response
examples:
- success:
- 5c5b350e0001
contentMediaType: application/json
examples:
Example:
value:
success:
- 5c5b350e0001
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_assign_success'
- description: Assignment operation success response
examples:
- success:
- 5c5b350e0001
contentMediaType: application/vnd.api+json
examples:
Example:
value:
success:
- 5c5b350e0001
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/devices:
get:
tags:
- Orgs Devices
summary: listOrgDevices
description: List devices in the organization, including APs, switches and gateways managed or monitored by Mist.
operationId: listOrgDevices
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_org_devices'
- description: Response containing organization device records
examples:
- results:
- mac: string
name: string
contentMediaType: application/json
examples:
Example:
value:
results:
- mac: string
name: string
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_org_devices'
- description: Response containing organization device records
examples:
- results:
- mac: string
name: string
contentMediaType: application/vnd.api+json
examples:
Example:
value:
results:
- mac: string
name: string
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/devices/count:
get:
tags:
- Orgs Devices
summary: countOrgDevices
description: Count organization device records, optionally grouped by `distinct` and filtered by device identifiers, model, LLDP attributes, Mist Edge, tunnel status, device type, and time range.
operationId: countOrgDevices
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field used to group this count response. enum: `hostname`, `ip`, `lldp_mgmt_addr`, `lldp_port_id`, `lldp_system_desc`, `lldp_system_name`, `mac`, `model`, `mxedge_id`, `mxtunnel_status`, `site_id`, `version`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/org_devices_count_distinct'
- description: 'Field used to group this count response. enum: `hostname`, `ip`, `lldp_mgmt_addr`, `lldp_port_id`, `lldp_system_desc`, `lldp_system_name`, `mac`, `model`, `mxedge_id`, `mxtunnel_status`, `site_id`, `version`'
- name: hostname
in: query
description: Partial / full hostname
style: form
explode: true
schema:
type: string
examples:
- my-hostname
- name: site_id
in: query
description: Filter results by site identifier
style: form
explode: true
schema:
type: string
contentEncoding: uuid
examples:
- 7dae216d-7c98-a51b-e068-dd7d477b7216
- name: model
in: query
description: Filter results by device model. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- AP45,AP47D
- MR84
examples:
Untitled Example1:
value: AP45,AP47D
Untitled Example2:
value: MR84
- name: managed
in: query
description: 'for switches and gateways, to filter on managed/unmanaged devices. Deprecated in favour of mist_configured. enum: `true`, `false`'
deprecated: true
style: form
explode: true
schema:
type: string
examples:
- 'true'
deprecated: true
- name: mac
in: query
description: Filter results by MAC address
style: form
explode: true
schema:
type: string
examples:
- 5c5b53010101
- name: version
in: query
description: Filter results by software version
style: form
explode: true
schema:
type: string
examples:
- 10.0.0
- name: ip
in: query
description: Filter results by IPv4 address
style: form
explode: true
schema:
type: string
contentEncoding: ipv4
examples:
- 192.168.1.1
- name: mxtunnel_status
in: query
description: 'MxTunnel status, enum: `up`, `down`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/count_org_devices_mxtunnel_status'
- description: 'MxTunnel status, enum: `up`, `down`'
- name: mxedge_id
in: query
description: Mist Edge id, if AP is connecting to a Mist Edge
style: form
explode: true
schema:
type: string
contentEncoding: uuid
examples:
- 7dae216d-7c98-a51b-e068-dd7d477b7216
- name: lldp_system_name
in: query
description: Filter results by LLDP system name
style: form
explode: true
schema:
type: string
examples:
- my-lldp-system
- name: lldp_system_desc
in: query
description: Filter results by LLDP system description
style: form
explode: true
schema:
type: string
examples:
- my-lldp-system-description
- name: lldp_port_id
in: query
description: Filter results by LLDP port identifier
style: form
explode: true
schema:
type: string
examples:
- ge-0/0/1
- name: lldp_mgmt_addr
in: query
description: LLDP management IP address
style: form
explode: true
schema:
type: string
examples:
- 10.4.2.3
- name: type
in: query
description: 'Filter results by type. enum: `ap`, `gateway`, `switch`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/device_type_default_ap'
- description: 'Filter results by type. enum: `ap`, `gateway`, `switch`'
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/devices/events/count:
get:
tags:
- Orgs Devices
summary: countOrgDeviceEvents
description: Count device event records across the organization, optionally grouped by `distinct` and filtered by site, AP, firmware, model, event text, event type, and time range.
operationId: countOrgDeviceEvents
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field used to group this count response. enum: `ap`, `apfw`, `model`, `org_id`, `site_id`, `status`, `text`, `timestamp`, `type`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/org_devices_events_count_distinct'
- description: 'Field used to group this count response. enum: `ap`, `apfw`, `model`, `org_id`, `site_id`, `status`, `text`, `timestamp`, `type`'
- name: site_id
in: query
description: Filter results by site identifier
style: form
explode: true
schema:
type: string
contentEncoding: uuid
examples:
- 7dae216d-7c98-a51b-e068-dd7d477b7216
- name: ap
in: query
description: Filter results by AP MAC address
style: form
explode: true
schema:
type: string
examples:
- 5c5b53010101
- name: apfw
in: query
description: Filter results by AP firmware version
style: form
explode: true
schema:
type: string
examples:
- 10.0.0
- name: model
in: query
description: Filter results by device model
style: form
explode: true
schema:
type: string
examples:
- AP43
- name: text
in: query
description: Filter results by event message text
style: form
explode: true
schema:
type: string
examples:
- Device connected
- name: type
in: query
description: See [List Device Events Definitions]($e/Constants%20Events/listDeviceEventsDefinitions)
style: form
explode: true
schema:
type: string
- name: includes
in: query
description: Keyword to include events from additional indices (e.g. ext_tunnel for ext tunnel events)
style: form
explode: true
schema:
type: string
examples:
- ext_tunnel
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/devices/events/search:
get:
tags:
- Orgs Devices
summary: searchOrgDeviceEvents
description: Search device event records across the organization with filters for MAC address, model, device type, event text, event type, additional event indices, and time range.
operationId: searchOrgDeviceEvents
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: mac
in: query
description: Filter results by MAC address. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- 5c5b53010101,5c5b53020202
- 5c5b53010101
examples:
Untitled Example1:
value: 5c5b53010101,5c5b53020202
Untitled Example2:
value: 5c5b53010101
- name: model
in: query
description: Filter results by device model. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- EX4100-48MP,AP17
- AP43
examples:
Untitled Example1:
value: EX4100-48MP,AP17
Untitled Example2:
value: AP43
- name: device_type
in: query
description: Filter results by device type. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
default: ap
examples:
- switch,ap
- name: text
in: query
description: Filter results by event message text
style: form
explode: true
schema:
type: string
examples:
- Device connected
- name: type
in: query
description: See [List Device Events Definitions]($e/Constants%20Events/listDeviceEventsDefinitions). Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- SW_PORT_DOWN,AP_CONFIGURED
- name: last_by
in: query
description: Return last/recent event for passed in field
style: form
explode: true
schema:
type: string
examples:
- port_id
- name: includes
in: query
description: Keyword to include events from additional indices (e.g. ext_tunnel for ext tunnel events)
style: form
explode: true
schema:
type: string
examples:
- ext_tunnel
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_device_events_search'
- description: Paginated response for device or system event search results
examples:
- end: 0
limit: 0
next: string
results:
- ap: 5c5b351e13b5
apfw: 5c5b351e13b5
model: BT11-WW
org_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862a
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
text: Succeeding DNS query from 172.29.101.134 to 172.29.101.7 for "portal.mistsys.com" on vlan 1, id 60224
timestamp: 1547235620.89
type: CLIENT_DNS_OK
- device_type: gateway
job_id: c2096de9-0ca4-4a8b-b500-d37cbe0f0baf
mac: d007ca6c6ac0
org_id: 86f0c649-06b1-4337-b3d4-25eeb887f732
site_id: 9f8d28eb-77c7-44c7-a85b-4426bf291679
status: PROVISION_IN_PROGRESS
template_id: 660e8400-e29b-41d4-a716-446655440001
timestamp: 1748987445.959
tunnel_name: zs1
type: NOTICE
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
end: 0
limit: 0
next: string
results:
- ap: 5c5b351e13b5
apfw: 5c5b351e13b5
model: BT11-WW
org_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862a
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
text: Succeeding DNS query from 172.29.101.134 to 172.29.101.7 for "portal.mistsys.com" on vlan 1, id 60224
timestamp: 1547235620.89
type: CLIENT_DNS_OK
- device_type: gateway
job_id: c2096de9-0ca4-4a8b-b500-d37cbe0f0baf
mac: d007ca6c6ac0
org_id: 86f0c649-06b1-4337-b3d4-25eeb887f732
site_id: 9f8d28eb-77c7-44c7-a85b-4426bf291679
status: PROVISION_IN_PROGRESS
template_id: 660e8400-e29b-41d4-a716-446655440001
timestamp: 1748987445.959
tunnel_name: zs1
type: NOTICE
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_device_events_search'
- description: Paginated response for device or system event search results
examples:
- end: 0
limit: 0
next: string
results:
- ap: 5c5b351e13b5
apfw: 5c5b351e13b5
model: BT11-WW
org_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862a
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
text: Succeeding DNS query from 172.29.101.134 to 172.29.101.7 for "portal.mistsys.com" on vlan 1, id 60224
timestamp: 1547235620.89
type: CLIENT_DNS_OK
- device_type: gateway
job_id: c2096de9-0ca4-4a8b-b500-d37cbe0f0baf
mac: d007ca6c6ac0
org_id: 86f0c649-06b1-4337-b3d4-25eeb887f732
site_id: 9f8d28eb-77c7-44c7-a85b-4426bf291679
status: PROVISION_IN_PROGRESS
template_id: 660e8400-e29b-41d4-a716-446655440001
timestamp: 1748987445.959
tunnel_name: zs1
type: NOTICE
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 0
limit: 0
next: string
results:
- ap: 5c5b351e13b5
apfw: 5c5b351e13b5
model: BT11-WW
org_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862a
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
text: Succeeding DNS query from 172.29.101.134 to 172.29.101.7 for "portal.mistsys.com" on vlan 1, id 60224
timestamp: 1547235620.89
type: CLIENT_DNS_OK
- device_type: gateway
job_id: c2096de9-0ca4-4a8b-b500-d37cbe0f0baf
mac: d007ca6c6ac0
org_id: 86f0c649-06b1-4337-b3d4-25eeb887f732
site_id: 9f8d28eb-77c7-44c7-a85b-4426bf291679
status: PROVISION_IN_PROGRESS
template_id: 660e8400-e29b-41d4-a716-446655440001
timestamp: 1748987445.959
tunnel_name: zs1
type: NOTICE
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/devices/last_config/count:
get:
tags:
- Orgs Devices
summary: countOrgDeviceLastConfigs
description: Count device config history records across the organization, optionally grouped by `distinct` and filtered by device type and time range.
operationId: countOrgDeviceLastConfigs
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: type
in: query
description: 'Filter results by type. enum: `ap`, `gateway`, `switch`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/device_type_default_ap'
- description: 'Filter results by type. enum: `ap`, `gateway`, `switch`'
- name: distinct
in: query
description: 'Field used to group this count response. enum: `mac`, `name`, `site_id`, `version`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/org_devices_last_configs_count_distinct'
- description: 'Field used to group this count response. enum: `mac`, `name`, `site_id`, `version`'
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/devices/last_config/search:
get:
tags:
- Orgs Devices
summary: searchOrgDeviceLastConfigs
description: Search device config history records across the organization with filters for device type, MAC address, name, software version, certificate-expiry duration, and time range.
operationId: searchOrgDeviceLastConfigs
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_type
in: query
description: 'Filter results by device type. enum: `ap`, `gateway`, `switch`, `mxedge`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/last_config_device_type'
- description: 'Filter results by device type. enum: `ap`, `gateway`, `switch`, `mxedge`'
- name: mac
in: query
description: Filter results by MAC address. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- 5c5b53010101,5c5b53020202
- 5c5b53010101
examples:
Untitled Example1:
value: 5c5b53010101,5c5b53020202
Untitled Example2:
value: 5c5b53010101
- name: name
in: query
description: Filter results by name. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- name-a,name-b
- My AP
examples:
Untitled Example1:
value: name-a,name-b
Untitled Example2:
value: My AP
- name: version
in: query
description: Filter results by software version. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- apfw-0.15.34615-noro-0a3c,apfw-0.15.34436-noro-d810
- 10.0.0
examples:
Untitled Example1:
value: apfw-0.15.34615-noro-0a3c,apfw-0.15.34436-noro-d810
Untitled Example2:
value: 10.0.0
- name: cert_expiry_duration
in: query
description: 'Duration for expiring cert queries (format: 2d/3h/172800 seconds)'
style: form
explode: true
schema:
type: string
examples:
- 2d
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_config_history_search'
- description: Paginated device config history search response
examples:
- end: 1531862583
limit: 10
results:
- channel_24: 11
channel_5: 100
radio_macs:
- 5c5b352e000a
- 5c5b352e000b
- 5c5b352e000c
radios:
- band: '24'
channel: 11
- band: '5'
channel: 100
secpolicy_violated: false
ssids:
- test24
- test5
ssids_24:
- test24
ssids_5:
- test5
timestamp: 1531855856.643369
version: apfw-0.2.14754-cersei-75c8
wlans:
- auth: psk
bands:
- '24'
id: be22bba7-8e22-e1cf-5185-b880816fe2cf
ssid: test24
vlan_ids:
- '1'
- auth: psk
bands:
- '5'
id: f8c18724-4118-3487-811a-f98964988604
ssid: test5
vlan_ids:
- '1'
start: 1531776183
total: 1
contentMediaType: application/json
examples:
Example:
value:
end: 1531862583
limit: 10
results:
- channel_24: 11
channel_5: 100
radio_macs:
- 5c5b352e000a
- 5c5b352e000b
- 5c5b352e000c
radios:
- band: '24'
channel: 11
- band: '5'
channel: 100
secpolicy_violated: false
ssids:
- test24
- test5
ssids_24:
- test24
ssids_5:
- test5
timestamp: 1531855856.643369
version: apfw-0.2.14754-cersei-75c8
wlans:
- auth: psk
bands:
- '24'
id: be22bba7-8e22-e1cf-5185-b880816fe2cf
ssid: test24
vlan_ids:
- '1'
- auth: psk
bands:
- '5'
id: f8c18724-4118-3487-811a-f98964988604
ssid: test5
vlan_ids:
- '1'
start: 1531776183
total: 1
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_config_history_search'
- description: Paginated device config history search response
examples:
- end: 1531862583
limit: 10
results:
- channel_24: 11
channel_5: 100
radio_macs:
- 5c5b352e000a
- 5c5b352e000b
- 5c5b352e000c
radios:
- band: '24'
channel: 11
- band: '5'
channel: 100
secpolicy_violated: false
ssids:
- test24
- test5
ssids_24:
- test24
ssids_5:
- test5
timestamp: 1531855856.643369
version: apfw-0.2.14754-cersei-75c8
wlans:
- auth: psk
bands:
- '24'
id: be22bba7-8e22-e1cf-5185-b880816fe2cf
ssid: test24
vlan_ids:
- '1'
- auth: psk
bands:
- '5'
id: f8c18724-4118-3487-811a-f98964988604
ssid: test5
vlan_ids:
- '1'
start: 1531776183
total: 1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 1531862583
limit: 10
results:
- channel_24: 11
channel_5: 100
radio_macs:
- 5c5b352e000a
- 5c5b352e000b
- 5c5b352e000c
radios:
- band: '24'
channel: 11
- band: '5'
channel: 100
secpolicy_violated: false
ssids:
- test24
- test5
ssids_24:
- test24
ssids_5:
- test5
timestamp: 1531855856.643369
version: apfw-0.2.14754-cersei-75c8
wlans:
- auth: psk
bands:
- '24'
id: be22bba7-8e22-e1cf-5185-b880816fe2cf
ssid: test24
vlan_ids:
- '1'
- auth: psk
bands:
- '5'
id: f8c18724-4118-3487-811a-f98964988604
ssid: test5
vlan_ids:
- '1'
start: 1531776183
total: 1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/devices/radio_macs:
get:
tags:
- Orgs Devices
summary: listOrgApsMacs
description: >-
For some scenarios like E911 or security systems, the BSSIDs are required to identify which AP the client is connecting to. Then the location of the AP can be used as the approximate location of the client.
Each radio MAC can have up to 16 BSSIDs. These are derived by incrementing the least significant hexadecimal digit (last nibble) of the MAC address from 0 to F, while keeping the remaining bits unchanged.
operationId: listOrgApsMacs
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
minItems: 1
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/ap_radio_mac'
description: Access point radio MAC records supplied in an import payload
examples:
- - mac: 5c5b35000001
radio_macs:
- 5c5b35000040
- 5c5b35000050
- 5c5b35000060
- mac: 5c5b45000001
radio_macs:
- 5c5b45000040
- 5c5b45000050
- 5c5b45000060
contentMediaType: application/json
examples:
Example:
value:
- mac: 5c5b35000001
radio_macs:
- 5c5b35000040
- 5c5b35000050
- 5c5b35000060
- mac: 5c5b45000001
radio_macs:
- 5c5b45000040
- 5c5b45000050
- 5c5b45000060
application/vnd.api+json:
schema:
minItems: 1
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/ap_radio_mac'
description: Access point radio MAC records supplied in an import payload
examples:
- - mac: 5c5b35000001
radio_macs:
- 5c5b35000040
- 5c5b35000050
- 5c5b35000060
- mac: 5c5b45000001
radio_macs:
- 5c5b45000040
- 5c5b45000050
- 5c5b45000060
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- mac: 5c5b35000001
radio_macs:
- 5c5b35000040
- 5c5b35000050
- 5c5b35000060
- mac: 5c5b45000001
radio_macs:
- 5c5b45000040
- 5c5b45000050
- 5c5b45000060
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/devices/search:
get:
tags:
- Orgs Devices
summary: searchOrgDevices
description: Search organization devices with filters for AP radio attributes, gateway HA attributes, switch EVPN attributes, LLDP data, MAC address, IP address, model, software version, site, Mist Edge, and time range. Set `stats=true` to include device stats in the response.
operationId: searchOrgDevices
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: band_24_channel
in: query
description: When `type`==`ap`, Channel of band_24. Accepts multiple comma-separated integer values.
style: form
explode: true
schema:
type: integer
contentEncoding: int32
- name: band_5_channel
in: query
description: When `type`==`ap`, Channel of band_5. Accepts multiple comma-separated integer values.
style: form
explode: true
schema:
type: integer
contentEncoding: int32
- name: band_6_channel
in: query
description: When `type`==`ap`, Channel of band_6. Accepts multiple comma-separated integer values.
style: form
explode: true
schema:
type: integer
contentEncoding: int32
- name: band_24_bandwidth
in: query
description: When `type`==`ap`, Bandwidth of band_24. Accepts multiple comma-separated integer values.
style: form
explode: true
schema:
type: integer
contentEncoding: int32
- name: band_5_bandwidth
in: query
description: When `type`==`ap`, Bandwidth of band_5. Accepts multiple comma-separated integer values.
style: form
explode: true
schema:
type: integer
contentEncoding: int32
- name: band_6_bandwidth
in: query
description: When `type`==`ap`, Bandwidth of band_6. Accepts multiple comma-separated integer values.
style: form
explode: true
schema:
type: integer
contentEncoding: int32
- name: band_24_power
in: query
description: When `type`==`ap`, Power of band_24. Accepts multiple comma-separated integer values.
style: form
explode: true
schema:
type: integer
contentEncoding: int32
- name: band_5_power
in: query
description: When `type`==`ap`, Power of band_5. Accepts multiple comma-separated integer values.
style: form
explode: true
schema:
type: integer
contentEncoding: int32
- name: band_6_power
in: query
description: When `type`==`ap`, Power of band_6. Accepts multiple comma-separated integer values.
style: form
explode: true
schema:
type: integer
contentEncoding: int32
- name: clustered
in: query
description: When `type`==`gateway`, true / false
style: form
explode: true
schema:
type: boolean
- name: eth0_port_speed
in: query
description: When `type`==`ap`, Port speed of eth0. Accepts multiple comma-separated integer values.
style: form
explode: true
schema:
type: integer
contentEncoding: int32
examples:
- '100'
- '1000'
examples:
Untitled Example2:
value: 100
Untitled Example3:
value: 1000
- name: evpntopo_id
in: query
description: When `type`==`switch`, EVPN topology id
style: form
explode: true
schema:
type: string
contentEncoding: uuid
- name: ext_ip
in: query
description: Partial / full Device external ip. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `1.2.3.*` and `*.2.3.*` match `1.2.3.4`). Suffix-only wildcards (e.g. `*.2.3.4`) are not supported. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- 1.2.3.4,1.2.3.*
- 1.2.3.4
- 1.2.3.*
- '*2.3.*'
examples:
Untitled Example1:
value: 1.2.3.4,1.2.3.*
Untitled Example2:
value: 1.2.3.4
Untitled Example3:
value: 1.2.3.*
Untitled Example4:
value: '*2.3.*'
- name: hostname
in: query
description: Partial / full Device hostname. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `my-london*` and `*london*` match `my-london-1`). Suffix-only wildcards (e.g. `*london-1`) are not supported. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- my-london-1,my-london*
- my-london-1
- my-london*
- '*london*'
examples:
Untitled Example1:
value: my-london-1,my-london*
Untitled Example2:
value: my-london-1
Untitled Example3:
value: my-london*
Untitled Example4:
value: '*london*'
- name: ip
in: query
description: Partial / full Device IP address. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `10.100.10.*` and `*100.10.*` match `10.100.10.54`). Suffix-only wildcards (e.g. `*.54`) are not supported. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- 10.100.10.54,10.100.10.*
- 10.100.10.54
- 10.100.10.*
- '*100.10.*'
examples:
Untitled Example1:
value: 10.100.10.54,10.100.10.*
Untitled Example2:
value: 10.100.10.54
Untitled Example3:
value: 10.100.10.*
Untitled Example4:
value: '*100.10.*'
- name: last_config_status
in: query
description: When `type`==`switch` or `type`==`gateway`, last configuration status
style: form
explode: true
schema:
type: string
examples:
- success
- name: last_hostname
in: query
description: Last hostname of the device. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- ap-01,ap-02
- name: lldp_mgmt_addr
in: query
description: When `type`==`ap`, LLDP management IP address. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- 192.0.2.10,192.0.2.11
- name: lldp_port_id
in: query
description: When `type`==`ap`, LLDP port id. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `ge-0/0/*` and `*-0/0/*` match `ge-0/0/30`). Suffix-only wildcards (e.g. `*switch-01`) are not supported. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- 00000000-0000-0000-0000-000000000001,00000000-0000-0000-0000-000000000002
- name: lldp_system_desc
in: query
description: When `type`==`ap`, LLDP system description. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `Juniper Networks*` and `*Networks*` match `Juniper Networks, Inc.`). Suffix-only wildcards (e.g. `*switch-01`) are not supported
style: form
explode: true
schema:
type: string
- name: lldp_system_name
in: query
description: When `type`==`ap`, LLDP system name. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `my-switch*` and `*switch*` match `my-switch-01`). Suffix-only wildcards (e.g. `*switch-01`) are not supported. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- richmond-hill-switch,Phoenix_Switch
- name: mac
in: query
description: Partial / full Device MAC address. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `001122*` and `*1122*` match `001122334455`). Suffix-only wildcards (e.g. `*4455`) are not supported. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- aabbccddeeff,aabbcc*
- aabbccddeeff
- aabbcc*
- '*bbcc*'
examples:
Untitled Example1:
value: aabbccddeeff,aabbcc*
Untitled Example2:
value: aabbccddeeff
Untitled Example3:
value: aabbcc*
Untitled Example4:
value: '*bbcc*'
- name: model
in: query
description: Partial / full Device model. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `AP4*` and `*P4*` match `AP43`). Suffix-only wildcards (e.g. `*43`) are not supported. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- AP43,AP4*
- AP43
- AP4*
- '*P4*'
examples:
Untitled Example1:
value: AP43,AP4*
Untitled Example2:
value: AP43
Untitled Example3:
value: AP4*
Untitled Example4:
value: '*P4*'
- name: mxedge_id
in: query
description: When `type`==`ap`, Mist Edge id, if AP is connecting to a Mist Edge. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
contentEncoding: uuid
- name: mxedge_ids
in: query
description: When `type`==`ap`, Comma separated list of Mist Edge id, if AP is connecting to a Mist Edge
style: form
explode: true
schema:
type: string
- name: mxtunnel_status
in: query
description: 'When `type`==`ap`, Mist Tunnel status used to filter results. enum: `down`, `up`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/search_org_devices_mxtunnel_status'
- description: 'When `type`==`ap`, Mist Tunnel status used to filter results. enum: `down`, `up`'
- name: node
in: query
description: 'When `type`==`gateway`. enum: `node0`, `node1`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/ha_cluster_node_enum'
- description: 'When `type`==`gateway`. enum: `node0`, `node1`'
- name: node0_mac
in: query
description: When `type`==`gateway`, node0 MAC address
style: form
explode: true
schema:
type: string
- name: node1_mac
in: query
description: When `type`==`gateway`, node1 MAC address
style: form
explode: true
schema:
type: string
- name: power_constrained
in: query
description: When `type`==`ap`, whether the AP is power constrained.
style: form
explode: true
schema:
type: boolean
- name: radius_stats
in: query
description: >-
When `type`==`switch` or `type`==`gateway`, Key-value pairs where the key
is the RADIUS server address and the value contains authentication statistics:
* (string): IP address of the RADIUS server as the key
* `auth_accepts` (long): Number of accepted authentication requests
* `auth_rejects` (long): Number of rejected authentication requests
* `auth_timeouts` (long): Number of authentication timeouts
* `auth_server_status` (string): Status of the server. Possible values: `up`, `down`, `unreachable`
style: form
explode: true
schema:
type: string
- name: site_id
in: query
description: Filter results by site identifier
style: form
explode: true
schema:
type: string
examples:
- 7dae216d-7c98-a51b-e068-dd7d477b7216
- name: stats
in: query
description: Whether to return device stats
style: form
explode: true
schema:
type: boolean
default: false
- name: t128agent_version
in: query
description: When `type`==`gateway` (SSR only), version of 128T agent
style: form
explode: true
schema:
type: string
- name: type
in: query
description: 'Device type used to filter results. enum: `ap`, `gateway`, `switch`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/device_type_default_ap'
- description: 'Device type used to filter results. enum: `ap`, `gateway`, `switch`'
- name: version
in: query
description: Filter results by software version. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- 0.15.34615,0.14.29967
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_device_search'
- description: Paginated response for organization or site device search results
examples:
- '{"end":0,"limit":0,"next":"string","results":[{"hostname":["AP41-STB-3E5299-WH-2001","AP41-STB-3E5299-WH-50","AP41-STB-3E5299","5c5b353e5299"],"ip":"10.2.16.205","lldp_mgmt_addr":"10.2.10.139","lldp_port_desc":"GigabitEthernet1/0/1","lldp_port_id":"Gi1/0/1","lldp_system_desc":"Cisco IOS Software, C2960S Software (C2960S-UNIVERSALK9-M), Version 15.2(1)E1, RELEASE SOFTWARE (fc2)\nTechnical Support: https://www.cisco.com/techsupport\nCopyright (c) 1986-2013 by Cisco Systems, Inc.\nCompiled Fri 22-Nov-13 07:10 by prod_rel_team","lldp_system_name":"ME-DC-1-ACC-SW","mac":"5c5b353e5299","model":"AP41","mxedge_id":"00000000-0000-0000-1000-43a81f238391","mxtunnel_status":"down","org_id":"6748cfa6-4e12-11e6-9188-0242ac110007","power_constrained":false,"power_opmode":"","site_id":"a8178443-ecb5-461c-b854-f16627619ab3","sku":"AP41-US","timestamp":1596588619.007,"uptime":85280,"version":"0.7.20216","wlans":[{"id":"28c36fc7-dc22-4960-9d81-34087511c2e5","ssid":"Live-Demo-NAC"},{"id":"51b82e2b-f9e8-470b-a32a-cecde5501b0f","ssid":"Live-Demo"}]}],"start":0,"total":0}'
- '{"end":0,"limit":0,"next":"string","results":[{"clustered":true,"evpn_missing_links":false,"evpntopo_id":"","ext_ip":"250.242.0.102","hostname":["wan-teleworker","00ec77599d00","router"],"ip":"250.242.0.102","last_config_status":"success","last_hostname":"wan-teleworker","mac":"00ec77599d00","mist_configured":true,"model":"SSR120","node":"node1","node0_mac":"00ec77599d00","node1_mac":"00ec77599d01","num_members":0,"org_id":"6748cfa6-4e12-11e6-9188-0242ac110007","role":"","site_id":"a8178443-ecb5-461c-b854-f16627619ab3","t128agent_version":"3.8.0-201","time_drifted":false,"timestamp":1734001399.025,"type":"gateway","uptime":3586951,"version":"6.2.5-5.r2"}],"start":0,"total":0}'
- '{"end":0,"limit":0,"next":"string","results":[{"clustered":false,"evpn_missing_links":false,"evpntopo_id":"","ext_ip":"0.0.0.0","hostname":["ld-cup-idf-bbb"],"ip":"10.0.0.217","last_config_status":"success","last_hostname":"ld-cup-idf-bbb","last_trouble_code":"106","last_trouble_timestamp":1719540,"mac":"00c78d939c00","mist_configured":true,"model":"EX4100-48MP","num_members":1,"org_id":"6748cfa6-4e12-11e6-9188-0242ac110007","role":"","site_id":"a8178443-ecb5-461c-b854-f16627619ab3","time_drifted":false,"timestamp":1733998766.256,"type":"switch","uptime":19287811,"version":"22.4R3.25"}],"start":0,"total":0}'
contentMediaType: application/json
examples:
Ap:
value:
end: 0
limit: 0
next: string
results:
- hostname:
- AP41-STB-3E5299-WH-2001
- AP41-STB-3E5299-WH-50
- AP41-STB-3E5299
- 5c5b353e5299
ip: 10.2.16.205
lldp_mgmt_addr: 10.2.10.139
lldp_port_desc: GigabitEthernet1/0/1
lldp_port_id: Gi1/0/1
lldp_system_desc: >-
Cisco IOS Software, C2960S Software (C2960S-UNIVERSALK9-M), Version 15.2(1)E1, RELEASE SOFTWARE (fc2)
Technical Support: https://www.cisco.com/techsupport
Copyright (c) 1986-2013 by Cisco Systems, Inc.
Compiled Fri 22-Nov-13 07:10 by prod_rel_team
lldp_system_name: ME-DC-1-ACC-SW
mac: 5c5b353e5299
model: AP41
mxedge_id: 00000000-0000-0000-1000-43a81f238391
mxtunnel_status: down
org_id: 6748cfa6-4e12-11e6-9188-0242ac110007
power_constrained: false
power_opmode: ''
site_id: a8178443-ecb5-461c-b854-f16627619ab3
sku: AP41-US
timestamp: 1596588619.007
uptime: 85280
version: 0.7.20216
wlans:
- id: 28c36fc7-dc22-4960-9d81-34087511c2e5
ssid: Live-Demo-NAC
- id: 51b82e2b-f9e8-470b-a32a-cecde5501b0f
ssid: Live-Demo
start: 0
total: 0
Gateway:
value:
end: 0
limit: 0
next: string
results:
- clustered: true
evpn_missing_links: false
evpntopo_id: ''
ext_ip: 250.242.0.102
hostname:
- wan-teleworker
- 00ec77599d00
- router
ip: 250.242.0.102
last_config_status: success
last_hostname: wan-teleworker
mac: 00ec77599d00
mist_configured: true
model: SSR120
node: node1
node0_mac: 00ec77599d00
node1_mac: 00ec77599d01
num_members: 0
org_id: 6748cfa6-4e12-11e6-9188-0242ac110007
role: ''
site_id: a8178443-ecb5-461c-b854-f16627619ab3
t128agent_version: 3.8.0-201
time_drifted: false
timestamp: 1734001399.025
type: gateway
uptime: 3586951
version: 6.2.5-5.r2
start: 0
total: 0
Switch:
value:
end: 0
limit: 0
next: string
results:
- clustered: false
evpn_missing_links: false
evpntopo_id: ''
ext_ip: 0.0.0.0
hostname:
- ld-cup-idf-bbb
ip: 10.0.0.217
last_config_status: success
last_hostname: ld-cup-idf-bbb
last_trouble_code: '106'
last_trouble_timestamp: 1719540
mac: 00c78d939c00
mist_configured: true
model: EX4100-48MP
num_members: 1
org_id: 6748cfa6-4e12-11e6-9188-0242ac110007
role: ''
site_id: a8178443-ecb5-461c-b854-f16627619ab3
time_drifted: false
timestamp: 1733998766.256
type: switch
uptime: 19287811
version: 22.4R3.25
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_device_search'
- description: Paginated response for organization or site device search results
examples:
- '{"end":0,"limit":0,"next":"string","results":[{"hostname":["AP41-STB-3E5299-WH-2001","AP41-STB-3E5299-WH-50","AP41-STB-3E5299","5c5b353e5299"],"ip":"10.2.16.205","lldp_mgmt_addr":"10.2.10.139","lldp_port_desc":"GigabitEthernet1/0/1","lldp_port_id":"Gi1/0/1","lldp_system_desc":"Cisco IOS Software, C2960S Software (C2960S-UNIVERSALK9-M), Version 15.2(1)E1, RELEASE SOFTWARE (fc2)\nTechnical Support: https://www.cisco.com/techsupport\nCopyright (c) 1986-2013 by Cisco Systems, Inc.\nCompiled Fri 22-Nov-13 07:10 by prod_rel_team","lldp_system_name":"ME-DC-1-ACC-SW","mac":"5c5b353e5299","model":"AP41","mxedge_id":"00000000-0000-0000-1000-43a81f238391","mxtunnel_status":"down","org_id":"6748cfa6-4e12-11e6-9188-0242ac110007","power_constrained":false,"power_opmode":"","site_id":"a8178443-ecb5-461c-b854-f16627619ab3","sku":"AP41-US","timestamp":1596588619.007,"uptime":85280,"version":"0.7.20216","wlans":[{"id":"28c36fc7-dc22-4960-9d81-34087511c2e5","ssid":"Live-Demo-NAC"},{"id":"51b82e2b-f9e8-470b-a32a-cecde5501b0f","ssid":"Live-Demo"}]}],"start":0,"total":0}'
- '{"end":0,"limit":0,"next":"string","results":[{"clustered":true,"evpn_missing_links":false,"evpntopo_id":"","ext_ip":"250.242.0.102","hostname":["wan-teleworker","00ec77599d00","router"],"ip":"250.242.0.102","last_config_status":"success","last_hostname":"wan-teleworker","mac":"00ec77599d00","mist_configured":true,"model":"SSR120","node":"node1","node0_mac":"00ec77599d00","node1_mac":"00ec77599d01","num_members":0,"org_id":"6748cfa6-4e12-11e6-9188-0242ac110007","role":"","site_id":"a8178443-ecb5-461c-b854-f16627619ab3","t128agent_version":"3.8.0-201","time_drifted":false,"timestamp":1734001399.025,"type":"gateway","uptime":3586951,"version":"6.2.5-5.r2"}],"start":0,"total":0}'
- '{"end":0,"limit":0,"next":"string","results":[{"clustered":false,"evpn_missing_links":false,"evpntopo_id":"","ext_ip":"0.0.0.0","hostname":["ld-cup-idf-bbb"],"ip":"10.0.0.217","last_config_status":"success","last_hostname":"ld-cup-idf-bbb","last_trouble_code":"106","last_trouble_timestamp":1719540,"mac":"00c78d939c00","mist_configured":true,"model":"EX4100-48MP","num_members":1,"org_id":"6748cfa6-4e12-11e6-9188-0242ac110007","role":"","site_id":"a8178443-ecb5-461c-b854-f16627619ab3","time_drifted":false,"timestamp":1733998766.256,"type":"switch","uptime":19287811,"version":"22.4R3.25"}],"start":0,"total":0}'
contentMediaType: application/vnd.api+json
examples:
Ap:
value:
end: 0
limit: 0
next: string
results:
- hostname:
- AP41-STB-3E5299-WH-2001
- AP41-STB-3E5299-WH-50
- AP41-STB-3E5299
- 5c5b353e5299
ip: 10.2.16.205
lldp_mgmt_addr: 10.2.10.139
lldp_port_desc: GigabitEthernet1/0/1
lldp_port_id: Gi1/0/1
lldp_system_desc: >-
Cisco IOS Software, C2960S Software (C2960S-UNIVERSALK9-M), Version 15.2(1)E1, RELEASE SOFTWARE (fc2)
Technical Support: https://www.cisco.com/techsupport
Copyright (c) 1986-2013 by Cisco Systems, Inc.
Compiled Fri 22-Nov-13 07:10 by prod_rel_team
lldp_system_name: ME-DC-1-ACC-SW
mac: 5c5b353e5299
model: AP41
mxedge_id: 00000000-0000-0000-1000-43a81f238391
mxtunnel_status: down
org_id: 6748cfa6-4e12-11e6-9188-0242ac110007
power_constrained: false
power_opmode: ''
site_id: a8178443-ecb5-461c-b854-f16627619ab3
sku: AP41-US
timestamp: 1596588619.007
uptime: 85280
version: 0.7.20216
wlans:
- id: 28c36fc7-dc22-4960-9d81-34087511c2e5
ssid: Live-Demo-NAC
- id: 51b82e2b-f9e8-470b-a32a-cecde5501b0f
ssid: Live-Demo
start: 0
total: 0
Gateway:
value:
end: 0
limit: 0
next: string
results:
- clustered: true
evpn_missing_links: false
evpntopo_id: ''
ext_ip: 250.242.0.102
hostname:
- wan-teleworker
- 00ec77599d00
- router
ip: 250.242.0.102
last_config_status: success
last_hostname: wan-teleworker
mac: 00ec77599d00
mist_configured: true
model: SSR120
node: node1
node0_mac: 00ec77599d00
node1_mac: 00ec77599d01
num_members: 0
org_id: 6748cfa6-4e12-11e6-9188-0242ac110007
role: ''
site_id: a8178443-ecb5-461c-b854-f16627619ab3
t128agent_version: 3.8.0-201
time_drifted: false
timestamp: 1734001399.025
type: gateway
uptime: 3586951
version: 6.2.5-5.r2
start: 0
total: 0
Switch:
value:
end: 0
limit: 0
next: string
results:
- clustered: false
evpn_missing_links: false
evpntopo_id: ''
ext_ip: 0.0.0.0
hostname:
- ld-cup-idf-bbb
ip: 10.0.0.217
last_config_status: success
last_hostname: ld-cup-idf-bbb
last_trouble_code: '106'
last_trouble_timestamp: 1719540
mac: 00c78d939c00
mist_configured: true
model: EX4100-48MP
num_members: 1
org_id: 6748cfa6-4e12-11e6-9188-0242ac110007
role: ''
site_id: a8178443-ecb5-461c-b854-f16627619ab3
time_drifted: false
timestamp: 1733998766.256
type: switch
uptime: 19287811
version: 22.4R3.25
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/devices/summary:
get:
tags:
- Orgs Devices
summary: listOrgDevicesSummary
description: Return aggregate organization device counts by device category and assignment state.
operationId: listOrgDevicesSummary
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_org_devices_summary'
- description: Organization device count summary
examples:
- num_aps: 630
num_gateways: 6
num_mxedges: 1
num_switches: 30
num_unassigned_aps: 5
num_unassigned_gateways: 0
num_unassigned_switches: 0
contentMediaType: application/json
examples:
Example:
value:
num_aps: 630
num_gateways: 6
num_mxedges: 1
num_switches: 30
num_unassigned_aps: 5
num_unassigned_gateways: 0
num_unassigned_switches: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_org_devices_summary'
- description: Organization device count summary
examples:
- num_aps: 630
num_gateways: 6
num_mxedges: 1
num_switches: 30
num_unassigned_aps: 5
num_unassigned_gateways: 0
num_unassigned_switches: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
num_aps: 630
num_gateways: 6
num_mxedges: 1
num_switches: 30
num_unassigned_aps: 5
num_unassigned_gateways: 0
num_unassigned_switches: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/ocdevices/outbound_ssh_cmd:
get:
tags:
- Orgs Devices
summary: getOrgJuniperDevicesCommand
description: >-
Get Org Juniper Devices command
Juniper devices can be managed/adopted by Mist. Currently outbound-ssh + netconf is used.
A few lines of CLI commands are generated per-Org, allowing the Juniper devices to phone home to Mist.
operationId: getOrgJuniperDevicesCommand
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: site_id
in: query
description: Filter results by site identifier
style: form
explode: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_device_config_cmd'
- description: Device configuration command response
examples:
- cmd: >-
set system services ssh...
...
set system services outbound-ssh client mist ...
contentMediaType: application/json
examples:
Example:
value:
cmd: >-
set system services ssh...
...
set system services outbound-ssh client mist ...
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_device_config_cmd'
- description: Device configuration command response
examples:
- cmd: >-
set system services ssh...
...
set system services outbound-ssh client mist ...
contentMediaType: application/vnd.api+json
examples:
Example:
value:
cmd: >-
set system services ssh...
...
set system services outbound-ssh client mist ...
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/128routers/register_cmd:
get:
tags:
- Orgs Devices - SSR
summary: getOrg128TRegistrationCommands
description: 128T devices can be managed/adopted by Mist.
operationId: getOrg128TRegistrationCommands
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: ttl
in: query
description: Token validity duration in seconds. Defaults to 1 year (31536000 seconds)
style: form
explode: true
schema:
type: integer
contentEncoding: int32
examples:
- 31536000
- name: asset_ids
in: query
description: When specified restricts registration to listed assets only. Prefer HTTP body over headers for this parameter, especially with long lists to avoid header size limits.
style: form
explode: true
schema:
uniqueItems: true
type: array
items:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_router_ssr_register_cmd'
- description: SSR registration token and commands used to register the router with Mist
examples:
- conductor_cmd: register mist eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJvcmdfaWQiOiIyODE4ZTM4Ni04ZGVjLTI1NjItOWVkZS01YjhhMGZiYmRjNzEiLCJzdmMiOiIxMjhyb3V0ZXIiLCJwcm92aWRlciI6ImF3cyIsImVudiI6ImxvY2FsIiwiZXB0ZXJtX3VybCI6IndzczovL2xvY2FsL3dzIiwiaWF0IjoxNjEzODQ3NDg0LCJleHAiOjE2NDUzODM0ODR9.YnhgThKYAj1uaooi6j-zY8dMipp5YqJxnn79B9TB5XQ
registration_code: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJvcmdfaWQiOiIyODE4ZTM4Ni04ZGVjLTI1NjItOWVkZS01YjhhMGZiYmRjNzEiLCJzdmMiOiIxMjhyb3V0ZXIiLCJwcm92aWRlciI6ImF3cyIsImVudiI6ImxvY2FsIiwiZXB0ZXJtX3VybCI6IndzczovL2xvY2FsL3dzIiwiaWF0IjoxNjEzODQ3NDg0LCJleHAiOjE2NDUzODM0ODR9.YnhgThKYAj1uaooi6j-zY8dMipp5YqJxnn79B9TB5XQ
router_shell_cmd: 128agent register --registration-code eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJvcmdfaWQiOiIyODE4ZTM4Ni04ZGVjLTI1NjItOWVkZS01YjhhMGZiYmRjNzEiLCJzdmMiOiIxMjhyb3V0ZXIiLCJwcm92aWRlciI6ImF3cyIsImVudiI6ImxvY2FsIiwiZXB0ZXJtX3VybCI6IndzczovL2xvY2FsL3dzIiwiaWF0IjoxNjEzODQ3NDg0LCJleHAiOjE2NDUzODM0ODR9.YnhgThKYAj1uaooi6j-zY8dMipp5YqJxnn79B9TB5XQ
contentMediaType: application/json
examples:
Example:
value:
conductor_cmd: register mist eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJvcmdfaWQiOiIyODE4ZTM4Ni04ZGVjLTI1NjItOWVkZS01YjhhMGZiYmRjNzEiLCJzdmMiOiIxMjhyb3V0ZXIiLCJwcm92aWRlciI6ImF3cyIsImVudiI6ImxvY2FsIiwiZXB0ZXJtX3VybCI6IndzczovL2xvY2FsL3dzIiwiaWF0IjoxNjEzODQ3NDg0LCJleHAiOjE2NDUzODM0ODR9.YnhgThKYAj1uaooi6j-zY8dMipp5YqJxnn79B9TB5XQ
registration_code: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJvcmdfaWQiOiIyODE4ZTM4Ni04ZGVjLTI1NjItOWVkZS01YjhhMGZiYmRjNzEiLCJzdmMiOiIxMjhyb3V0ZXIiLCJwcm92aWRlciI6ImF3cyIsImVudiI6ImxvY2FsIiwiZXB0ZXJtX3VybCI6IndzczovL2xvY2FsL3dzIiwiaWF0IjoxNjEzODQ3NDg0LCJleHAiOjE2NDUzODM0ODR9.YnhgThKYAj1uaooi6j-zY8dMipp5YqJxnn79B9TB5XQ
router_shell_cmd: 128agent register --registration-code eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJvcmdfaWQiOiIyODE4ZTM4Ni04ZGVjLTI1NjItOWVkZS01YjhhMGZiYmRjNzEiLCJzdmMiOiIxMjhyb3V0ZXIiLCJwcm92aWRlciI6ImF3cyIsImVudiI6ImxvY2FsIiwiZXB0ZXJtX3VybCI6IndzczovL2xvY2FsL3dzIiwiaWF0IjoxNjEzODQ3NDg0LCJleHAiOjE2NDUzODM0ODR9.YnhgThKYAj1uaooi6j-zY8dMipp5YqJxnn79B9TB5XQ
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_router_ssr_register_cmd'
- description: SSR registration token and commands used to register the router with Mist
examples:
- conductor_cmd: register mist eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJvcmdfaWQiOiIyODE4ZTM4Ni04ZGVjLTI1NjItOWVkZS01YjhhMGZiYmRjNzEiLCJzdmMiOiIxMjhyb3V0ZXIiLCJwcm92aWRlciI6ImF3cyIsImVudiI6ImxvY2FsIiwiZXB0ZXJtX3VybCI6IndzczovL2xvY2FsL3dzIiwiaWF0IjoxNjEzODQ3NDg0LCJleHAiOjE2NDUzODM0ODR9.YnhgThKYAj1uaooi6j-zY8dMipp5YqJxnn79B9TB5XQ
registration_code: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJvcmdfaWQiOiIyODE4ZTM4Ni04ZGVjLTI1NjItOWVkZS01YjhhMGZiYmRjNzEiLCJzdmMiOiIxMjhyb3V0ZXIiLCJwcm92aWRlciI6ImF3cyIsImVudiI6ImxvY2FsIiwiZXB0ZXJtX3VybCI6IndzczovL2xvY2FsL3dzIiwiaWF0IjoxNjEzODQ3NDg0LCJleHAiOjE2NDUzODM0ODR9.YnhgThKYAj1uaooi6j-zY8dMipp5YqJxnn79B9TB5XQ
router_shell_cmd: 128agent register --registration-code eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJvcmdfaWQiOiIyODE4ZTM4Ni04ZGVjLTI1NjItOWVkZS01YjhhMGZiYmRjNzEiLCJzdmMiOiIxMjhyb3V0ZXIiLCJwcm92aWRlciI6ImF3cyIsImVudiI6ImxvY2FsIiwiZXB0ZXJtX3VybCI6IndzczovL2xvY2FsL3dzIiwiaWF0IjoxNjEzODQ3NDg0LCJleHAiOjE2NDUzODM0ODR9.YnhgThKYAj1uaooi6j-zY8dMipp5YqJxnn79B9TB5XQ
contentMediaType: application/vnd.api+json
examples:
Example:
value:
conductor_cmd: register mist eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJvcmdfaWQiOiIyODE4ZTM4Ni04ZGVjLTI1NjItOWVkZS01YjhhMGZiYmRjNzEiLCJzdmMiOiIxMjhyb3V0ZXIiLCJwcm92aWRlciI6ImF3cyIsImVudiI6ImxvY2FsIiwiZXB0ZXJtX3VybCI6IndzczovL2xvY2FsL3dzIiwiaWF0IjoxNjEzODQ3NDg0LCJleHAiOjE2NDUzODM0ODR9.YnhgThKYAj1uaooi6j-zY8dMipp5YqJxnn79B9TB5XQ
registration_code: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJvcmdfaWQiOiIyODE4ZTM4Ni04ZGVjLTI1NjItOWVkZS01YjhhMGZiYmRjNzEiLCJzdmMiOiIxMjhyb3V0ZXIiLCJwcm92aWRlciI6ImF3cyIsImVudiI6ImxvY2FsIiwiZXB0ZXJtX3VybCI6IndzczovL2xvY2FsL3dzIiwiaWF0IjoxNjEzODQ3NDg0LCJleHAiOjE2NDUzODM0ODR9.YnhgThKYAj1uaooi6j-zY8dMipp5YqJxnn79B9TB5XQ
router_shell_cmd: 128agent register --registration-code eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJvcmdfaWQiOiIyODE4ZTM4Ni04ZGVjLTI1NjItOWVkZS01YjhhMGZiYmRjNzEiLCJzdmMiOiIxMjhyb3V0ZXIiLCJwcm92aWRlciI6ImF3cyIsImVudiI6ImxvY2FsIiwiZXB0ZXJtX3VybCI6IndzczovL2xvY2FsL3dzIiwiaWF0IjoxNjEzODQ3NDg0LCJleHAiOjE2NDUzODM0ODR9.YnhgThKYAj1uaooi6j-zY8dMipp5YqJxnn79B9TB5XQ
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: true
parameters: []
/api/v1/orgs/{org_id}/ssr/export_idtokens:
post:
tags:
- Orgs Devices - SSR
summary: exportOrgSsrIdTokens
description: Export SSR ID tokens for the requested device MAC addresses so they can be imported into Conductor during SSR onboarding.
operationId: exportOrgSsrIdTokens
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/mac_addresses'
- description: Request Body
contentMediaType: application/json
required: false
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_ssr_export_id_tokens'
- description: Response containing SSR ID tokens exported for device onboarding
examples:
- results:
- mac: 025b35000020
token: string
contentMediaType: application/json
examples:
Example:
value:
results:
- mac: 025b35000020
token: string
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_ssr_export_id_tokens'
- description: Response containing SSR ID tokens exported for device onboarding
examples:
- results:
- mac: 025b35000020
token: string
contentMediaType: application/vnd.api+json
examples:
Example:
value:
results:
- mac: 025b35000020
token: string
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/ssr/register_cmd:
get:
tags:
- Orgs Devices - SSR
summary: getOrgSsrRegistrationCommands
description: Return the registration token and conductor or router commands used to register SSR routers with Mist. The optional TTL controls token validity, and asset IDs can restrict registration to specific assets.
operationId: getOrgSsrRegistrationCommands
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: ttl
in: query
description: Token validity duration in seconds. Defaults to 1 year (31536000 seconds)
style: form
explode: true
schema:
type: integer
contentEncoding: int32
examples:
- 31536000
- name: asset_ids
in: query
description: When specified restricts registration to listed assets only. Prefer HTTP body over headers for this parameter, especially with long lists to avoid header size limits.
style: form
explode: true
schema:
uniqueItems: true
type: array
items:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_router_ssr_register_cmd'
- description: SSR registration token and commands used to register the router with Mist
examples:
- conductor_cmd: register mist eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJvcmdfaWQiOiIyODE4ZTM4Ni04ZGVjLTI1NjItOWVkZS01YjhhMGZiYmRjNzEiLCJzdmMiOiIxMjhyb3V0ZXIiLCJwcm92aWRlciI6ImF3cyIsImVudiI6ImxvY2FsIiwiZXB0ZXJtX3VybCI6IndzczovL2xvY2FsL3dzIiwiaWF0IjoxNjEzODQ3NDg0LCJleHAiOjE2NDUzODM0ODR9.YnhgThKYAj1uaooi6j-zY8dMipp5YqJxnn79B9TB5XQ
registration_code: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJvcmdfaWQiOiIyODE4ZTM4Ni04ZGVjLTI1NjItOWVkZS01YjhhMGZiYmRjNzEiLCJzdmMiOiIxMjhyb3V0ZXIiLCJwcm92aWRlciI6ImF3cyIsImVudiI6ImxvY2FsIiwiZXB0ZXJtX3VybCI6IndzczovL2xvY2FsL3dzIiwiaWF0IjoxNjEzODQ3NDg0LCJleHAiOjE2NDUzODM0ODR9.YnhgThKYAj1uaooi6j-zY8dMipp5YqJxnn79B9TB5XQ
router_shell_cmd: 128agent register --registration-code eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJvcmdfaWQiOiIyODE4ZTM4Ni04ZGVjLTI1NjItOWVkZS01YjhhMGZiYmRjNzEiLCJzdmMiOiIxMjhyb3V0ZXIiLCJwcm92aWRlciI6ImF3cyIsImVudiI6ImxvY2FsIiwiZXB0ZXJtX3VybCI6IndzczovL2xvY2FsL3dzIiwiaWF0IjoxNjEzODQ3NDg0LCJleHAiOjE2NDUzODM0ODR9.YnhgThKYAj1uaooi6j-zY8dMipp5YqJxnn79B9TB5XQ
contentMediaType: application/json
examples:
Example:
value:
conductor_cmd: register mist eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJvcmdfaWQiOiIyODE4ZTM4Ni04ZGVjLTI1NjItOWVkZS01YjhhMGZiYmRjNzEiLCJzdmMiOiIxMjhyb3V0ZXIiLCJwcm92aWRlciI6ImF3cyIsImVudiI6ImxvY2FsIiwiZXB0ZXJtX3VybCI6IndzczovL2xvY2FsL3dzIiwiaWF0IjoxNjEzODQ3NDg0LCJleHAiOjE2NDUzODM0ODR9.YnhgThKYAj1uaooi6j-zY8dMipp5YqJxnn79B9TB5XQ
registration_code: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJvcmdfaWQiOiIyODE4ZTM4Ni04ZGVjLTI1NjItOWVkZS01YjhhMGZiYmRjNzEiLCJzdmMiOiIxMjhyb3V0ZXIiLCJwcm92aWRlciI6ImF3cyIsImVudiI6ImxvY2FsIiwiZXB0ZXJtX3VybCI6IndzczovL2xvY2FsL3dzIiwiaWF0IjoxNjEzODQ3NDg0LCJleHAiOjE2NDUzODM0ODR9.YnhgThKYAj1uaooi6j-zY8dMipp5YqJxnn79B9TB5XQ
router_shell_cmd: 128agent register --registration-code eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJvcmdfaWQiOiIyODE4ZTM4Ni04ZGVjLTI1NjItOWVkZS01YjhhMGZiYmRjNzEiLCJzdmMiOiIxMjhyb3V0ZXIiLCJwcm92aWRlciI6ImF3cyIsImVudiI6ImxvY2FsIiwiZXB0ZXJtX3VybCI6IndzczovL2xvY2FsL3dzIiwiaWF0IjoxNjEzODQ3NDg0LCJleHAiOjE2NDUzODM0ODR9.YnhgThKYAj1uaooi6j-zY8dMipp5YqJxnn79B9TB5XQ
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_router_ssr_register_cmd'
- description: SSR registration token and commands used to register the router with Mist
examples:
- conductor_cmd: register mist eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJvcmdfaWQiOiIyODE4ZTM4Ni04ZGVjLTI1NjItOWVkZS01YjhhMGZiYmRjNzEiLCJzdmMiOiIxMjhyb3V0ZXIiLCJwcm92aWRlciI6ImF3cyIsImVudiI6ImxvY2FsIiwiZXB0ZXJtX3VybCI6IndzczovL2xvY2FsL3dzIiwiaWF0IjoxNjEzODQ3NDg0LCJleHAiOjE2NDUzODM0ODR9.YnhgThKYAj1uaooi6j-zY8dMipp5YqJxnn79B9TB5XQ
registration_code: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJvcmdfaWQiOiIyODE4ZTM4Ni04ZGVjLTI1NjItOWVkZS01YjhhMGZiYmRjNzEiLCJzdmMiOiIxMjhyb3V0ZXIiLCJwcm92aWRlciI6ImF3cyIsImVudiI6ImxvY2FsIiwiZXB0ZXJtX3VybCI6IndzczovL2xvY2FsL3dzIiwiaWF0IjoxNjEzODQ3NDg0LCJleHAiOjE2NDUzODM0ODR9.YnhgThKYAj1uaooi6j-zY8dMipp5YqJxnn79B9TB5XQ
router_shell_cmd: 128agent register --registration-code eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJvcmdfaWQiOiIyODE4ZTM4Ni04ZGVjLTI1NjItOWVkZS01YjhhMGZiYmRjNzEiLCJzdmMiOiIxMjhyb3V0ZXIiLCJwcm92aWRlciI6ImF3cyIsImVudiI6ImxvY2FsIiwiZXB0ZXJtX3VybCI6IndzczovL2xvY2FsL3dzIiwiaWF0IjoxNjEzODQ3NDg0LCJleHAiOjE2NDUzODM0ODR9.YnhgThKYAj1uaooi6j-zY8dMipp5YqJxnn79B9TB5XQ
contentMediaType: application/vnd.api+json
examples:
Example:
value:
conductor_cmd: register mist eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJvcmdfaWQiOiIyODE4ZTM4Ni04ZGVjLTI1NjItOWVkZS01YjhhMGZiYmRjNzEiLCJzdmMiOiIxMjhyb3V0ZXIiLCJwcm92aWRlciI6ImF3cyIsImVudiI6ImxvY2FsIiwiZXB0ZXJtX3VybCI6IndzczovL2xvY2FsL3dzIiwiaWF0IjoxNjEzODQ3NDg0LCJleHAiOjE2NDUzODM0ODR9.YnhgThKYAj1uaooi6j-zY8dMipp5YqJxnn79B9TB5XQ
registration_code: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJvcmdfaWQiOiIyODE4ZTM4Ni04ZGVjLTI1NjItOWVkZS01YjhhMGZiYmRjNzEiLCJzdmMiOiIxMjhyb3V0ZXIiLCJwcm92aWRlciI6ImF3cyIsImVudiI6ImxvY2FsIiwiZXB0ZXJtX3VybCI6IndzczovL2xvY2FsL3dzIiwiaWF0IjoxNjEzODQ3NDg0LCJleHAiOjE2NDUzODM0ODR9.YnhgThKYAj1uaooi6j-zY8dMipp5YqJxnn79B9TB5XQ
router_shell_cmd: 128agent register --registration-code eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJvcmdfaWQiOiIyODE4ZTM4Ni04ZGVjLTI1NjItOWVkZS01YjhhMGZiYmRjNzEiLCJzdmMiOiIxMjhyb3V0ZXIiLCJwcm92aWRlciI6ImF3cyIsImVudiI6ImxvY2FsIiwiZXB0ZXJtX3VybCI6IndzczovL2xvY2FsL3dzIiwiaWF0IjoxNjEzODQ3NDg0LCJleHAiOjE2NDUzODM0ODR9.YnhgThKYAj1uaooi6j-zY8dMipp5YqJxnn79B9TB5XQ
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/aoscx/register_cmd:
get:
tags:
- Orgs Devices - AOSCX
summary: getOrgAoscxRegisterCmd
description: Generates a registration challenge token for TPM-based brownfield registration of AOSCX devices. The returned command string can be copied and pasted directly into an AOSCX device to register it with Mist.
operationId: getOrgAoscxRegisterCmd
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: AOSCX Brownfield Registration Commands
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/aoscx_register_cmd'
- description: AOSCX Brownfield Registration Commands
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/aoscx_register_cmd'
- description: AOSCX Brownfield Registration Commands
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/edgeconnect/register_cmd:
get:
tags:
- Orgs Devices - EdgeConnect
summary: getOrgEdgeconnectRegisterCmd
description: Returns a registration code for adopting an EdgeConnect device into Mist.
operationId: getOrgEdgeconnectRegisterCmd
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: EdgeConnect Registration Command
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/edgeconnect_register_cmd'
- description: EdgeConnect device registration command response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/edgeconnect_register_cmd'
- description: EdgeConnect device registration command response
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/evpn_topologies:
get:
tags:
- Orgs EVPN Topologies
summary: listOrgEvpnTopologies
description: List EVPN topology records in the organization, optionally filtering for org-level, site-level, or all topologies with `for_site`.
operationId: listOrgEvpnTopologies
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: for_site
in: query
description: 'Filter for org/site level EVPN topologies. enum: `any`, `false`, `true`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/mxedge_for_site'
- description: 'Filter for org/site level EVPN topologies. enum: `any`, `false`, `true`'
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/evpn_topology_response'
description: EVPN topology records returned by list APIs
examples:
- - created_time: 1736421230
evpn_options:
auto_loopback_subnet: 172.16.192.0/24
auto_loopback_subnet6: fd33:ab00:2::/64
auto_router_id_subnet: 172.16.254.0/23
core_as_border: true
overlay:
as: 65000
per_vlan_vga_v4_mac: false
routed_at: core
underlay:
as_base: 65001
subnet: 10.255.240.0/20
use_ipv6: false
for_site: false
id: 764fb173-94f9-447c-8454-def62e5a999f
modified_time: 1736421230
name: tert
org_id: 3a2627d7-bfbc-45af-b85d-8841581c6d63
pod_names:
'1': Pod 1
site_id: 00000000-0000-0000-0000-000000000000
contentMediaType: application/json
examples:
Example:
value:
- created_time: 1736421230
evpn_options:
auto_loopback_subnet: 172.16.192.0/24
auto_loopback_subnet6: fd33:ab00:2::/64
auto_router_id_subnet: 172.16.254.0/23
core_as_border: true
overlay:
as: 65000
per_vlan_vga_v4_mac: false
routed_at: core
underlay:
as_base: 65001
subnet: 10.255.240.0/20
use_ipv6: false
for_site: false
id: 764fb173-94f9-447c-8454-def62e5a999f
modified_time: 1736421230
name: tert
org_id: 3a2627d7-bfbc-45af-b85d-8841581c6d63
pod_names:
'1': Pod 1
site_id: 00000000-0000-0000-0000-000000000000
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/evpn_topology_response'
description: EVPN topology records returned by list APIs
examples:
- - created_time: 1736421230
evpn_options:
auto_loopback_subnet: 172.16.192.0/24
auto_loopback_subnet6: fd33:ab00:2::/64
auto_router_id_subnet: 172.16.254.0/23
core_as_border: true
overlay:
as: 65000
per_vlan_vga_v4_mac: false
routed_at: core
underlay:
as_base: 65001
subnet: 10.255.240.0/20
use_ipv6: false
for_site: false
id: 764fb173-94f9-447c-8454-def62e5a999f
modified_time: 1736421230
name: tert
org_id: 3a2627d7-bfbc-45af-b85d-8841581c6d63
pod_names:
'1': Pod 1
site_id: 00000000-0000-0000-0000-000000000000
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- created_time: 1736421230
evpn_options:
auto_loopback_subnet: 172.16.192.0/24
auto_loopback_subnet6: fd33:ab00:2::/64
auto_router_id_subnet: 172.16.254.0/23
core_as_border: true
overlay:
as: 65000
per_vlan_vga_v4_mac: false
routed_at: core
underlay:
as_base: 65001
subnet: 10.255.240.0/20
use_ipv6: false
for_site: false
id: 764fb173-94f9-447c-8454-def62e5a999f
modified_time: 1736421230
name: tert
org_id: 3a2627d7-bfbc-45af-b85d-8841581c6d63
pod_names:
'1': Pod 1
site_id: 00000000-0000-0000-0000-000000000000
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs EVPN Topologies
summary: createOrgEvpnTopology
description: >-
While all the `evpn_id` / `downlink_ips` can be specified by hand, the easiest way is to call the `build_vpn_topology` API, allowing you to examine the diff, and update it yourself. You can also simply call it with `overwrite=true` which will apply the updates for you.
**Notes:**
1. You can use `core` / `distribution` / `access` to create a CLOS topology
2. You can also use `core` / `distribution` to form a 2-tier EVPN topology where ESI-Lag is configured distribution to connect to access switches
3. In a small/medium campus, `collapsed-core` can be used where core switches are the inter-connected to do EVPN
4. The API uses a few pre-defined parameters and best-practices to generate the configs. It can be customized by using `evpn_options` in Site Setting / Network Template. (e.g. a different subnet for the underlay)
#### Collapsed Core
In a small-medium campus, EVPN can also be enabled only at the core switches (up to 4) by assigning all participating switches with `collapsed-core role`. When there are more than 2 switches, a ring-like topology will be formed.
#### ESI-Lag
If the access switches does not have EVPN support, you can take advantage of EVPN by setting up ESI-Lag on distribution switches
#### Leaf / Access / Collapsed-Core
For leaf nodes in a EVPN topology, you’d have to configure the IPs for networks that would participate in EVPN. Optionally, VRFs to isolate traffic from one tenant versus another
operationId: createOrgEvpnTopology
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/evpn_topology'
- examples:
- name: CC
pod_names:
'1': default
'2': default
switches:
- mac: 5c5b35000003
role: collapsed-core
- mac: 5c5b35000004
role: collapsed-core
contentMediaType: application/json
examples:
Example:
value:
name: CC
pod_names:
'1': default
'2': default
switches:
- mac: 5c5b35000003
role: collapsed-core
- mac: 5c5b35000004
role: collapsed-core
required: false
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/evpn_topology'
- description: EVPN topology create or update payload
examples:
- id: 9197ec96-4c8d-529f-c595-035895e688b2
name: CC
overwrite: true
pod_names:
'1': default
'2': default
switches:
- deviceprofile_id: 6a1deab1-96df-4fa2-8455-d5253f943d06
downlink_ips:
- 10.255.240.6
- 10.255.240.8
downlinks:
- 5c5b35000007
- 5c5b35000008
esilaglinks:
- 5c5b3500000f
evpn_id: 1
mac: 5c5b35000003
model: QFX10002-36Q
role: collapsed-core
site_id: 1916d52a-4a90-11e5-8b45-1258369c38a9
uplinks:
- 5c5b35000005
- 5c5b35000006
contentMediaType: application/json
examples:
Example:
value:
id: 9197ec96-4c8d-529f-c595-035895e688b2
name: CC
overwrite: true
pod_names:
'1': default
'2': default
switches:
- deviceprofile_id: 6a1deab1-96df-4fa2-8455-d5253f943d06
downlink_ips:
- 10.255.240.6
- 10.255.240.8
downlinks:
- 5c5b35000007
- 5c5b35000008
esilaglinks:
- 5c5b3500000f
evpn_id: 1
mac: 5c5b35000003
model: QFX10002-36Q
role: collapsed-core
site_id: 1916d52a-4a90-11e5-8b45-1258369c38a9
uplinks:
- 5c5b35000005
- 5c5b35000006
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/evpn_topology'
- description: EVPN topology create or update payload
examples:
- id: 9197ec96-4c8d-529f-c595-035895e688b2
name: CC
overwrite: true
pod_names:
'1': default
'2': default
switches:
- deviceprofile_id: 6a1deab1-96df-4fa2-8455-d5253f943d06
downlink_ips:
- 10.255.240.6
- 10.255.240.8
downlinks:
- 5c5b35000007
- 5c5b35000008
esilaglinks:
- 5c5b3500000f
evpn_id: 1
mac: 5c5b35000003
model: QFX10002-36Q
role: collapsed-core
site_id: 1916d52a-4a90-11e5-8b45-1258369c38a9
uplinks:
- 5c5b35000005
- 5c5b35000006
contentMediaType: application/vnd.api+json
examples:
Example:
value:
id: 9197ec96-4c8d-529f-c595-035895e688b2
name: CC
overwrite: true
pod_names:
'1': default
'2': default
switches:
- deviceprofile_id: 6a1deab1-96df-4fa2-8455-d5253f943d06
downlink_ips:
- 10.255.240.6
- 10.255.240.8
downlinks:
- 5c5b35000007
- 5c5b35000008
esilaglinks:
- 5c5b3500000f
evpn_id: 1
mac: 5c5b35000003
model: QFX10002-36Q
role: collapsed-core
site_id: 1916d52a-4a90-11e5-8b45-1258369c38a9
uplinks:
- 5c5b35000005
- 5c5b35000006
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/evpn_topologies/{evpn_topology_id}:
delete:
tags:
- Orgs EVPN Topologies
summary: deleteOrgEvpnTopology
description: Delete an EVPN topology from the organization by topology ID.
operationId: deleteOrgEvpnTopology
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: evpn_topology_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Orgs EVPN Topologies
summary: getOrgEvpnTopology
description: Retrieve the switch roles, links, and generation options for a specific EVPN topology.
operationId: getOrgEvpnTopology
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: evpn_topology_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/evpn_topology'
- description: EVPN topology create or update payload
examples:
- id: 9197ec96-4c8d-529f-c595-035895e688b2
name: CC
overwrite: true
pod_names:
'1': default
'2': default
switches:
- deviceprofile_id: 6a1deab1-96df-4fa2-8455-d5253f943d06
downlink_ips:
- 10.255.240.6
- 10.255.240.8
downlinks:
- 5c5b35000007
- 5c5b35000008
esilaglinks:
- 5c5b3500000f
evpn_id: 1
mac: 5c5b35000003
model: QFX10002-36Q
role: collapsed-core
site_id: 1916d52a-4a90-11e5-8b45-1258369c38a9
uplinks:
- 5c5b35000005
- 5c5b35000006
contentMediaType: application/json
examples:
Example:
value:
id: 9197ec96-4c8d-529f-c595-035895e688b2
name: CC
overwrite: true
pod_names:
'1': default
'2': default
switches:
- deviceprofile_id: 6a1deab1-96df-4fa2-8455-d5253f943d06
downlink_ips:
- 10.255.240.6
- 10.255.240.8
downlinks:
- 5c5b35000007
- 5c5b35000008
esilaglinks:
- 5c5b3500000f
evpn_id: 1
mac: 5c5b35000003
model: QFX10002-36Q
role: collapsed-core
site_id: 1916d52a-4a90-11e5-8b45-1258369c38a9
uplinks:
- 5c5b35000005
- 5c5b35000006
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/evpn_topology'
- description: EVPN topology create or update payload
examples:
- id: 9197ec96-4c8d-529f-c595-035895e688b2
name: CC
overwrite: true
pod_names:
'1': default
'2': default
switches:
- deviceprofile_id: 6a1deab1-96df-4fa2-8455-d5253f943d06
downlink_ips:
- 10.255.240.6
- 10.255.240.8
downlinks:
- 5c5b35000007
- 5c5b35000008
esilaglinks:
- 5c5b3500000f
evpn_id: 1
mac: 5c5b35000003
model: QFX10002-36Q
role: collapsed-core
site_id: 1916d52a-4a90-11e5-8b45-1258369c38a9
uplinks:
- 5c5b35000005
- 5c5b35000006
contentMediaType: application/vnd.api+json
examples:
Example:
value:
id: 9197ec96-4c8d-529f-c595-035895e688b2
name: CC
overwrite: true
pod_names:
'1': default
'2': default
switches:
- deviceprofile_id: 6a1deab1-96df-4fa2-8455-d5253f943d06
downlink_ips:
- 10.255.240.6
- 10.255.240.8
downlinks:
- 5c5b35000007
- 5c5b35000008
esilaglinks:
- 5c5b3500000f
evpn_id: 1
mac: 5c5b35000003
model: QFX10002-36Q
role: collapsed-core
site_id: 1916d52a-4a90-11e5-8b45-1258369c38a9
uplinks:
- 5c5b35000005
- 5c5b35000006
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Orgs EVPN Topologies
summary: updateOrgEvpnTopology
description: Update an EVPN topology, including switch membership, switch roles, links, and generation options.
operationId: updateOrgEvpnTopology
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: evpn_topology_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/evpn_topology'
- examples:
- overwrite: false
switches:
- mac: 5c5b35000003
role: collapsed-core
- mac: 5c5b35000004
role: none
contentMediaType: application/json
examples:
Example:
value:
overwrite: false
switches:
- mac: 5c5b35000003
role: collapsed-core
- mac: 5c5b35000004
role: none
required: false
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/evpn_topology'
- description: EVPN topology create or update payload
examples:
- id: 9197ec96-4c8d-529f-c595-035895e688b2
name: CC
overwrite: true
pod_names:
'1': default
'2': default
switches:
- deviceprofile_id: 6a1deab1-96df-4fa2-8455-d5253f943d06
downlink_ips:
- 10.255.240.6
- 10.255.240.8
downlinks:
- 5c5b35000007
- 5c5b35000008
esilaglinks:
- 5c5b3500000f
evpn_id: 1
mac: 5c5b35000003
model: QFX10002-36Q
role: collapsed-core
site_id: 1916d52a-4a90-11e5-8b45-1258369c38a9
uplinks:
- 5c5b35000005
- 5c5b35000006
contentMediaType: application/json
examples:
Example:
value:
id: 9197ec96-4c8d-529f-c595-035895e688b2
name: CC
overwrite: true
pod_names:
'1': default
'2': default
switches:
- deviceprofile_id: 6a1deab1-96df-4fa2-8455-d5253f943d06
downlink_ips:
- 10.255.240.6
- 10.255.240.8
downlinks:
- 5c5b35000007
- 5c5b35000008
esilaglinks:
- 5c5b3500000f
evpn_id: 1
mac: 5c5b35000003
model: QFX10002-36Q
role: collapsed-core
site_id: 1916d52a-4a90-11e5-8b45-1258369c38a9
uplinks:
- 5c5b35000005
- 5c5b35000006
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/evpn_topology'
- description: EVPN topology create or update payload
examples:
- id: 9197ec96-4c8d-529f-c595-035895e688b2
name: CC
overwrite: true
pod_names:
'1': default
'2': default
switches:
- deviceprofile_id: 6a1deab1-96df-4fa2-8455-d5253f943d06
downlink_ips:
- 10.255.240.6
- 10.255.240.8
downlinks:
- 5c5b35000007
- 5c5b35000008
esilaglinks:
- 5c5b3500000f
evpn_id: 1
mac: 5c5b35000003
model: QFX10002-36Q
role: collapsed-core
site_id: 1916d52a-4a90-11e5-8b45-1258369c38a9
uplinks:
- 5c5b35000005
- 5c5b35000006
contentMediaType: application/vnd.api+json
examples:
Example:
value:
id: 9197ec96-4c8d-529f-c595-035895e688b2
name: CC
overwrite: true
pod_names:
'1': default
'2': default
switches:
- deviceprofile_id: 6a1deab1-96df-4fa2-8455-d5253f943d06
downlink_ips:
- 10.255.240.6
- 10.255.240.8
downlinks:
- 5c5b35000007
- 5c5b35000008
esilaglinks:
- 5c5b3500000f
evpn_id: 1
mac: 5c5b35000003
model: QFX10002-36Q
role: collapsed-core
site_id: 1916d52a-4a90-11e5-8b45-1258369c38a9
uplinks:
- 5c5b35000005
- 5c5b35000006
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/setting/juniper/link_accounts:
post:
tags:
- Orgs Integration Juniper
summary: linkOrgToJuniperJuniperAccount
description: Link a Juniper account to the organization using Juniper account credentials. Linked accounts are returned in organization settings and can be used by Juniper integrations.
operationId: linkOrgToJuniperJuniperAccount
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/account_juniper_config'
- examples:
- password: password
username: john@nmo.com
contentMediaType: application/json
examples:
Example:
value:
password: password
username: john@nmo.com
required: false
responses:
'200':
description: Account linked
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/account_juniper_info'
- description: Linked Juniper account information returned by the integration
examples:
- account:
linked_by: John Smith (john@abccorp.com)
name: ABC Corp
contentMediaType: application/json
examples:
Example:
value:
account:
linked_by: John Smith (john@abccorp.com)
name: ABC Corp
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/account_juniper_info'
- description: Linked Juniper account information returned by the integration
examples:
- account:
linked_by: John Smith (john@abccorp.com)
name: ABC Corp
contentMediaType: application/vnd.api+json
examples:
Example:
value:
account:
linked_by: John Smith (john@abccorp.com)
name: ABC Corp
'400':
description: Account already linked
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_detail_string'
- description: Response containing a human-readable detail message
examples:
- detail: Account[ABC Corp] already linked
contentMediaType: application/json
examples:
Example:
value:
detail: Account[ABC Corp] already linked
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_detail_string'
- description: Response containing a human-readable detail message
examples:
- detail: Account[ABC Corp] already linked
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Account[ABC Corp] already linked
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/setting/juniper/unlink_account:
delete:
tags:
- Orgs Integration Juniper
summary: unlinkOrgFromJuniperCustomerId
description: Unlink a Juniper customer account from the organization. The `linked_by` field is required only when multiple linked accounts share the same account name.
operationId: unlinkOrgFromJuniperCustomerId
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/account_juniper_info'
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/otherdevices:
get:
tags:
- Orgs Devices - Others
summary: listOrgOtherDevices
description: List third-party devices across the organization, such as devices discovered or tracked outside the managed Mist device inventory.
operationId: listOrgOtherDevices
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: vendor
in: query
description: Filter results by vendor
style: form
explode: true
schema:
type: string
- name: mac
in: query
description: Filter results by MAC address
style: form
explode: true
schema:
type: string
- name: serial
in: query
description: Filter results by device serial number
style: form
explode: true
schema:
type: string
- name: model
in: query
description: Filter results by device model
style: form
explode: true
schema:
type: string
- name: name
in: query
description: Filter results by name
style: form
explode: true
schema:
type: string
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/device_other'
description: List of third-party devices reported by external integrations
examples:
- - created_time: 1676983730
device_mac: '001122334455'
id: ae9dee49-69e7-4710-a114-5b827a777738
mac: 5c5b35000018
model: AP41
modified_time: 1676983730
name: hallway
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
serial: FXLH2015150025
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
vendor: cradlepoint
contentMediaType: application/json
examples:
Example:
value:
- created_time: 1676983730
device_mac: '001122334455'
id: ae9dee49-69e7-4710-a114-5b827a777738
mac: 5c5b35000018
model: AP41
modified_time: 1676983730
name: hallway
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
serial: FXLH2015150025
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
vendor: cradlepoint
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/device_other'
description: List of third-party devices reported by external integrations
examples:
- - created_time: 1676983730
device_mac: '001122334455'
id: ae9dee49-69e7-4710-a114-5b827a777738
mac: 5c5b35000018
model: AP41
modified_time: 1676983730
name: hallway
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
serial: FXLH2015150025
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
vendor: cradlepoint
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- created_time: 1676983730
device_mac: '001122334455'
id: ae9dee49-69e7-4710-a114-5b827a777738
mac: 5c5b35000018
model: AP41
modified_time: 1676983730
name: hallway
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
serial: FXLH2015150025
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
vendor: cradlepoint
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Orgs Devices - Others
summary: updateOrgOtherDevices
description: Bulk assign or unassign third-party devices to or from a site by MAC address.
operationId: updateOrgOtherDevices
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/other_device_update_multi'
- examples:
- device_mac: 0adfea67e65b
macs:
- 5c5b350e0001
- 5c5b350e0003
op: assign
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
contentMediaType: application/json
examples:
Example:
value:
device_mac: 0adfea67e65b
macs:
- 5c5b350e0001
- 5c5b350e0003
op: assign
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/otherdevices/events/count:
get:
tags:
- Orgs Devices - Others
summary: countOrgOtherDeviceEvents
description: Count third-party device events across the organization, optionally grouped by `distinct` and filtered by event type and time range.
operationId: countOrgOtherDeviceEvents
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field used to group this count response. enum: `mac`, `site_id`, `type`, `vendor`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/org_otherdevices_events_count_distinct'
- description: 'Field used to group this count response. enum: `mac`, `site_id`, `type`, `vendor`'
- name: type
in: query
description: See [List Device Events Definitions]($e/Constants%20Events/listOtherDeviceEventsDefinitions)
style: form
explode: true
schema:
type: string
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/otherdevices/events/search:
get:
tags:
- Orgs Devices - Others
summary: searchOrgOtherDeviceEvents
description: Search third-party device events across the organization with filters for site, MAC address, attached device MAC address, model, vendor, event type, and time range.
operationId: searchOrgOtherDeviceEvents
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: site_id
in: query
description: Filter results by site identifier
style: form
explode: true
schema:
type: string
- name: mac
in: query
description: Filter results by MAC address
style: form
explode: true
schema:
type: string
- name: device_mac
in: query
description: MAC of attached device
style: form
explode: true
schema:
type: string
- name: model
in: query
description: Filter results by device model
style: form
explode: true
schema:
type: string
- name: vendor
in: query
description: Filter results by vendor
style: form
explode: true
schema:
type: string
- name: type
in: query
description: See [List Device Events Definitions]($e/Constants%20Events/listOtherDeviceEventsDefinitions)
style: form
explode: true
schema:
type: string
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_events_other_devices_search'
- description: Paginated response for other-device event search results
examples:
- end: 0
limit: 0
results:
- device_mac: string
mac: 5c5b351e13b5
org_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862a
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
text: 'Plugged: The Internal 5GB (SIM1) has been inserted into Internal 1.'
timestamp: 547235620.89
type: CELLULAR_EDGE_MODEM_WAN_PLUGGED
vendor: cradlepoint
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
end: 0
limit: 0
results:
- device_mac: string
mac: 5c5b351e13b5
org_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862a
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
text: 'Plugged: The Internal 5GB (SIM1) has been inserted into Internal 1.'
timestamp: 547235620.89
type: CELLULAR_EDGE_MODEM_WAN_PLUGGED
vendor: cradlepoint
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_events_other_devices_search'
- description: Paginated response for other-device event search results
examples:
- end: 0
limit: 0
results:
- device_mac: string
mac: 5c5b351e13b5
org_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862a
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
text: 'Plugged: The Internal 5GB (SIM1) has been inserted into Internal 1.'
timestamp: 547235620.89
type: CELLULAR_EDGE_MODEM_WAN_PLUGGED
vendor: cradlepoint
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 0
limit: 0
results:
- device_mac: string
mac: 5c5b351e13b5
org_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862a
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
text: 'Plugged: The Internal 5GB (SIM1) has been inserted into Internal 1.'
timestamp: 547235620.89
type: CELLULAR_EDGE_MODEM_WAN_PLUGGED
vendor: cradlepoint
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/otherdevices/{device_mac}:
delete:
tags:
- Orgs Devices - Others
summary: deleteOrgOtherDevice
description: Delete a third-party device record from the organization by device MAC address.
operationId: deleteOrgOtherDevice
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_mac
in: path
description: ''
required: true
schema:
pattern: ^[0-9a-fA-F]{12}$
type: string
examples:
- 0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Orgs Devices - Others
summary: getOrgOtherDevice
description: Retrieve details for a third-party device record, including vendor, model, serial, attached Mist device MAC address, site assignment, and state.
operationId: getOrgOtherDevice
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_mac
in: path
description: ''
required: true
schema:
pattern: ^[0-9a-fA-F]{12}$
type: string
examples:
- 0000000000ab
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/device_other'
- description: Third-party device discovered or managed through an external vendor integration
examples:
- device_mac: 00112233abcd
id: ae9dee49-69e7-4710-a114-5b827a777738
mac: 5c5b35000018
model: W2005
name: W2005-268
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
serial: WB23015E025468
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
state: online
vendor: cradlepoint
vendor_api_id: '4658714'
contentMediaType: application/json
examples:
Example:
value:
device_mac: 00112233abcd
id: ae9dee49-69e7-4710-a114-5b827a777738
mac: 5c5b35000018
model: W2005
name: W2005-268
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
serial: WB23015E025468
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
state: online
vendor: cradlepoint
vendor_api_id: '4658714'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/device_other'
- description: Third-party device discovered or managed through an external vendor integration
examples:
- device_mac: 00112233abcd
id: ae9dee49-69e7-4710-a114-5b827a777738
mac: 5c5b35000018
model: W2005
name: W2005-268
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
serial: WB23015E025468
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
state: online
vendor: cradlepoint
vendor_api_id: '4658714'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
device_mac: 00112233abcd
id: ae9dee49-69e7-4710-a114-5b827a777738
mac: 5c5b35000018
model: W2005
name: W2005-268
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
serial: WB23015E025468
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
state: online
vendor: cradlepoint
vendor_api_id: '4658714'
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Orgs Devices - Others
summary: updateOrgOtherDevice
description: Manually update the site or attached Mist device association for a third-party device when automatic identification is unavailable.
operationId: updateOrgOtherDevice
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_mac
in: path
description: ''
required: true
schema:
pattern: ^[0-9a-fA-F]{12}$
type: string
examples:
- 0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/other_device_update'
- examples:
- device_mac: 0adfea67e65b
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
contentMediaType: application/json
examples:
Example:
value:
device_mac: 0adfea67e65b
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/otherdevices/{device_mac}/reboot:
post:
tags:
- Orgs Devices - Others
summary: rebootOrgOtherDevice
description: Request a reboot for a third-party device by device MAC address.
operationId: rebootOrgOtherDevice
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_mac
in: path
description: ''
required: true
schema:
pattern: ^[0-9a-fA-F]{12}$
type: string
examples:
- 0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/setting/zscaler/setup:
delete:
tags:
- Orgs Integration Zscaler
summary: deleteOrgZscalerIntegration
description: Remove the Zscaler integration configuration from the organization.
operationId: deleteOrgZscalerIntegration
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Orgs Integration Zscaler
summary: getOrgZscalerIntegration
description: Return the Zscaler integration configuration, including Zscaler Internet Access cloud name, partner key, and partner administrator username.
operationId: getOrgZscalerIntegration
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/account_zscaler_info'
- description: OAuth linked Zscaler apps account details
examples:
- cloud_name: zscalerbeta.net
partner_key: K35vrZcK3JvrZc
username: john@nmo.com
contentMediaType: application/json
examples:
Example:
value:
cloud_name: zscalerbeta.net
partner_key: K35vrZcK3JvrZc
username: john@nmo.com
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/account_zscaler_info'
- description: OAuth linked Zscaler apps account details
examples:
- cloud_name: zscalerbeta.net
partner_key: K35vrZcK3JvrZc
username: john@nmo.com
contentMediaType: application/vnd.api+json
examples:
Example:
value:
cloud_name: zscalerbeta.net
partner_key: K35vrZcK3JvrZc
username: john@nmo.com
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs Integration Zscaler
summary: setupOrgZscalerIntegration
description: Configure the Zscaler integration with the Zscaler Internet Access cloud name, partner key, and partner administrator credentials used by Mist.
operationId: setupOrgZscalerIntegration
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/account_zscaler_config'
- examples:
- cloud_name: zscalerbeta.net
partner_key: K35vrZcK3JvrZc
password: password
username: john@nmo.com
contentMediaType: application/json
examples:
Example:
value:
cloud_name: zscalerbeta.net
partner_key: K35vrZcK3JvrZc
password: password
username: john@nmo.com
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/setting/mist_scep:
delete:
tags:
- Orgs SCEP
summary: disableOrgMistScep
description: Disable Mist SCEP for the organization and return the updated read-only SCEP settings.
operationId: disableOrgMistScep
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/org_setting_scep_response'
- description: Read-only Mist SCEP settings returned for the organization
examples:
- cert_providers:
- jamf
- intune
- byod
enabled: false
intune_scep_url: https://scep.mistsys.com/api/v1/incoming/intune/:org_id/scep
jamf_access_token: 1Z4QqEnCt05Jjt3TV5LgPJ4V_WL_RWnJ7dqVMLYHj81=
jamf_scep_url: https://scep.mistsys.com/api/v1/incoming/intune/:org_id/scep
jamf_webhook_url: https://scep.mistsys.com/api/v1/webhook/jamf/:org_id/scep
contentMediaType: application/json
examples:
Example:
value:
cert_providers:
- jamf
- intune
- byod
enabled: false
intune_scep_url: https://scep.mistsys.com/api/v1/incoming/intune/:org_id/scep
jamf_access_token: 1Z4QqEnCt05Jjt3TV5LgPJ4V_WL_RWnJ7dqVMLYHj81=
jamf_scep_url: https://scep.mistsys.com/api/v1/incoming/intune/:org_id/scep
jamf_webhook_url: https://scep.mistsys.com/api/v1/webhook/jamf/:org_id/scep
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/org_setting_scep_response'
- description: Read-only Mist SCEP settings returned for the organization
examples:
- cert_providers:
- jamf
- intune
- byod
enabled: false
intune_scep_url: https://scep.mistsys.com/api/v1/incoming/intune/:org_id/scep
jamf_access_token: 1Z4QqEnCt05Jjt3TV5LgPJ4V_WL_RWnJ7dqVMLYHj81=
jamf_scep_url: https://scep.mistsys.com/api/v1/incoming/intune/:org_id/scep
jamf_webhook_url: https://scep.mistsys.com/api/v1/webhook/jamf/:org_id/scep
contentMediaType: application/vnd.api+json
examples:
Example:
value:
cert_providers:
- jamf
- intune
- byod
enabled: false
intune_scep_url: https://scep.mistsys.com/api/v1/incoming/intune/:org_id/scep
jamf_access_token: 1Z4QqEnCt05Jjt3TV5LgPJ4V_WL_RWnJ7dqVMLYHj81=
jamf_scep_url: https://scep.mistsys.com/api/v1/incoming/intune/:org_id/scep
jamf_webhook_url: https://scep.mistsys.com/api/v1/webhook/jamf/:org_id/scep
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Orgs SCEP
summary: getOrgMistScep
description: Return Mist SCEP settings for the organization, including enabled and suspended status, configured certificate providers, and generated enrollment or webhook URLs.
operationId: getOrgMistScep
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/org_setting_scep_response'
- description: Read-only Mist SCEP settings returned for the organization
examples:
- cert_providers:
- jamf
- intune
- byod
enabled: false
intune_scep_url: https://scep.mistsys.com/api/v1/incoming/intune/:org_id/scep
jamf_access_token: 1Z4QqEnCt05Jjt3TV5LgPJ4V_WL_RWnJ7dqVMLYHj81=
jamf_scep_url: https://scep.mistsys.com/api/v1/incoming/intune/:org_id/scep
jamf_webhook_url: https://scep.mistsys.com/api/v1/webhook/jamf/:org_id/scep
contentMediaType: application/json
examples:
Example:
value:
cert_providers:
- jamf
- intune
- byod
enabled: false
intune_scep_url: https://scep.mistsys.com/api/v1/incoming/intune/:org_id/scep
jamf_access_token: 1Z4QqEnCt05Jjt3TV5LgPJ4V_WL_RWnJ7dqVMLYHj81=
jamf_scep_url: https://scep.mistsys.com/api/v1/incoming/intune/:org_id/scep
jamf_webhook_url: https://scep.mistsys.com/api/v1/webhook/jamf/:org_id/scep
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/org_setting_scep_response'
- description: Read-only Mist SCEP settings returned for the organization
examples:
- cert_providers:
- jamf
- intune
- byod
enabled: false
intune_scep_url: https://scep.mistsys.com/api/v1/incoming/intune/:org_id/scep
jamf_access_token: 1Z4QqEnCt05Jjt3TV5LgPJ4V_WL_RWnJ7dqVMLYHj81=
jamf_scep_url: https://scep.mistsys.com/api/v1/incoming/intune/:org_id/scep
jamf_webhook_url: https://scep.mistsys.com/api/v1/webhook/jamf/:org_id/scep
contentMediaType: application/vnd.api+json
examples:
Example:
value:
cert_providers:
- jamf
- intune
- byod
enabled: false
intune_scep_url: https://scep.mistsys.com/api/v1/incoming/intune/:org_id/scep
jamf_access_token: 1Z4QqEnCt05Jjt3TV5LgPJ4V_WL_RWnJ7dqVMLYHj81=
jamf_scep_url: https://scep.mistsys.com/api/v1/incoming/intune/:org_id/scep
jamf_webhook_url: https://scep.mistsys.com/api/v1/webhook/jamf/:org_id/scep
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Orgs SCEP
summary: updateOrgMistScep
description: Update Mist SCEP settings for the organization, including enabled state, suspension state, and certificate providers.
operationId: updateOrgMistScep
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/org_setting_scep'
- examples:
- enabled: true
contentMediaType: application/json
examples:
Example:
value:
enabled: true
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/org_setting_scep_response'
- description: Read-only Mist SCEP settings returned for the organization
examples:
- cert_providers:
- jamf
- intune
- byod
enabled: false
intune_scep_url: https://scep.mistsys.com/api/v1/incoming/intune/:org_id/scep
jamf_access_token: 1Z4QqEnCt05Jjt3TV5LgPJ4V_WL_RWnJ7dqVMLYHj81=
jamf_scep_url: https://scep.mistsys.com/api/v1/incoming/intune/:org_id/scep
jamf_webhook_url: https://scep.mistsys.com/api/v1/webhook/jamf/:org_id/scep
contentMediaType: application/json
examples:
Example:
value:
cert_providers:
- jamf
- intune
- byod
enabled: false
intune_scep_url: https://scep.mistsys.com/api/v1/incoming/intune/:org_id/scep
jamf_access_token: 1Z4QqEnCt05Jjt3TV5LgPJ4V_WL_RWnJ7dqVMLYHj81=
jamf_scep_url: https://scep.mistsys.com/api/v1/incoming/intune/:org_id/scep
jamf_webhook_url: https://scep.mistsys.com/api/v1/webhook/jamf/:org_id/scep
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/org_setting_scep_response'
- description: Read-only Mist SCEP settings returned for the organization
examples:
- cert_providers:
- jamf
- intune
- byod
enabled: false
intune_scep_url: https://scep.mistsys.com/api/v1/incoming/intune/:org_id/scep
jamf_access_token: 1Z4QqEnCt05Jjt3TV5LgPJ4V_WL_RWnJ7dqVMLYHj81=
jamf_scep_url: https://scep.mistsys.com/api/v1/incoming/intune/:org_id/scep
jamf_webhook_url: https://scep.mistsys.com/api/v1/webhook/jamf/:org_id/scep
contentMediaType: application/vnd.api+json
examples:
Example:
value:
cert_providers:
- jamf
- intune
- byod
enabled: false
intune_scep_url: https://scep.mistsys.com/api/v1/incoming/intune/:org_id/scep
jamf_access_token: 1Z4QqEnCt05Jjt3TV5LgPJ4V_WL_RWnJ7dqVMLYHj81=
jamf_scep_url: https://scep.mistsys.com/api/v1/incoming/intune/:org_id/scep
jamf_webhook_url: https://scep.mistsys.com/api/v1/webhook/jamf/:org_id/scep
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/setting/mist_scep/client_certs:
get:
tags:
- Orgs SCEP
summary: listOrgIssuedClientCertificates
description: List Mist SCEP client certificates issued for the organization. Results can be filtered by common name, certificate provider, serial number, device ID, or time range.
operationId: listOrgIssuedClientCertificates
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: common_name
in: query
description: Filter by certificate common name (e.g. user UPN or device identifier)
style: form
explode: true
schema:
type: string
- name: cert_provider
in: query
description: Filter by MDM or certificate provider that issued the certificate. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
- name: serial_number
in: query
description: Filter by certificate serial number. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
- name: device_id
in: query
description: Filter by device identifier associated with the certificate. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
- name: expire_time
in: query
description: Filter by certificate expiry time, in epoch seconds
style: form
explode: true
schema:
type: integer
contentEncoding: int32
- name: created_time
in: query
description: Filter by certificate issuance time, in epoch seconds
style: form
explode: true
schema:
type: integer
contentEncoding: int32
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/issued_client_certificates_results'
- description: Issued client certificate search results wrapper
examples:
- limit: 100
page: 1
results:
- cert_provider: jamf
common_name: john@corp.com
created_time: 1431382121
device_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
expire_time: 1718921115
serial_number: 13 00 13 03 23 EE D5 84 01
contentMediaType: application/json
examples:
Example:
value:
limit: 100
page: 1
results:
- cert_provider: jamf
common_name: john@corp.com
created_time: 1431382121
device_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
expire_time: 1718921115
serial_number: 13 00 13 03 23 EE D5 84 01
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/issued_client_certificates_results'
- description: Issued client certificate search results wrapper
examples:
- limit: 100
page: 1
results:
- cert_provider: jamf
common_name: john@corp.com
created_time: 1431382121
device_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
expire_time: 1718921115
serial_number: 13 00 13 03 23 EE D5 84 01
contentMediaType: application/vnd.api+json
examples:
Example:
value:
limit: 100
page: 1
results:
- cert_provider: jamf
common_name: john@corp.com
created_time: 1431382121
device_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
expire_time: 1718921115
serial_number: 13 00 13 03 23 EE D5 84 01
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/setting/mist_scep/client_certs/revoke:
post:
tags:
- Orgs SCEP
summary: revokeOrgIssuedClientCertificates
description: Revoke issued Mist SCEP client certificates by certificate serial number.
operationId: revokeOrgIssuedClientCertificates
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/client_cert_serial_numbers'
- examples:
- serial_numbers:
- 13 00 13 03 23 EE D5 84 01
contentMediaType: application/json
examples:
Example:
value:
serial_numbers:
- 13 00 13 03 23 EE D5 84 01
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/gatewaytemplates:
get:
tags:
- Orgs Gateway Templates
summary: listOrgGatewayTemplates
description: List organization gateway templates, which provide reusable WAN gateway configuration that can be applied to gateways at sites.
operationId: listOrgGatewayTemplates
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/gateway_template'
description: List of gateway device profiles
contentMediaType: application/json
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/gateway_template'
description: List of gateway device profiles
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs Gateway Templates
summary: createOrgGatewayTemplate
description: >-
Create an organization gateway template with reusable WAN gateway networks, ports, routing, and service-policy configuration.
Gateway templates can be applied to multiple sites within the organization to provide consistent gateway configuration across sites.
To assign a gateway template to a site, use the [Update Site]($e/Sites/updateSiteInfo) endpoint and specify the gateway template ID in the `gatewaytemplate_id` field of the request body.
operationId: createOrgGatewayTemplate
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Gateway Template
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/gateway_template'
- description: Gateway Template
examples:
- dhcpd_config:
Corp-Mgmt:
dns_servers:
- 8.8.8.8
dns_suffix:
- stag.one
gateway: 10.3.172.9
ip_end: 10.3.172.99
ip_start: 10.3.172.50
type: local
Corp-lan:
dns_servers:
- 8.8.8.8
dns_suffix:
- stag.one
gateway: 10.3.171.9
ip_end: 10.3.171.99
ip_start: 10.3.171.50
type: local
dnsOverride: true
dns_servers:
- 10.3.20.201
- 10.3.51.222
- 1.1.1.1
dns_suffix:
- example.com
extra_routes:
10.101.0.0/16:
via: 10.3.100.10
ip_configs:
Corp-Core:
ip: 10.3.100.9
netmask: /24
type: static
Corp-Mgmt:
ip: 10.3.172.9
netmask: /24
type: static
Corp-lan:
ip: 10.3.171.9
netmask: /24
type: static
name: ITParis
ntpOverride: true
ntp_servers:
- 10.3.51.222
path_preferences:
core:
paths:
- networks:
- Corp-Core
type: local
strategy: ordered
lab:
paths:
- networks:
- Corp-lan
type: local
strategy: ordered
mgmt:
paths:
- networks:
- Corp-Mgmt
type: local
strategy: ordered
untrust:
paths:
- name: wan
type: wan
strategy: ordered
port_config:
ge-0/0/0:
aggregated: false
ip_config:
gateway: 192.168.1.1
ip: 192.168.1.9
netmask: /24
type: static
name: wan
redundant: false
traffic_shaping:
enabled: false
usage: wan
wan_type: broadband
ge-0/0/6-7:
ae_disable_lacp: false
ae_idx: '0'
ae_lacp_force_up: true
aggregated: true
networks:
- Corp-lan
- Corp-Mgmt
- Corp-Core
usage: lan
service_policies:
- action: allow
idp:
enabled: false
name: ITParis-Internal
path_preference: core
services:
- internal_dns
- drive
tenants:
- ITParis
- action: deny
idp:
enabled: false
name: ITParis-internet
path_preference: untrust
services:
- internet_any
tenants:
- ITParis
type: standalone
contentMediaType: application/json
examples:
Example:
value:
dhcpd_config:
Corp-Mgmt:
dns_servers:
- 8.8.8.8
dns_suffix:
- stag.one
gateway: 10.3.172.9
ip_end: 10.3.172.99
ip_start: 10.3.172.50
type: local
Corp-lan:
dns_servers:
- 8.8.8.8
dns_suffix:
- stag.one
gateway: 10.3.171.9
ip_end: 10.3.171.99
ip_start: 10.3.171.50
type: local
dnsOverride: true
dns_servers:
- 10.3.20.201
- 10.3.51.222
- 1.1.1.1
dns_suffix:
- example.com
extra_routes:
10.101.0.0/16:
via: 10.3.100.10
ip_configs:
Corp-Core:
ip: 10.3.100.9
netmask: /24
type: static
Corp-Mgmt:
ip: 10.3.172.9
netmask: /24
type: static
Corp-lan:
ip: 10.3.171.9
netmask: /24
type: static
name: ITParis
ntpOverride: true
ntp_servers:
- 10.3.51.222
path_preferences:
core:
paths:
- networks:
- Corp-Core
type: local
strategy: ordered
lab:
paths:
- networks:
- Corp-lan
type: local
strategy: ordered
mgmt:
paths:
- networks:
- Corp-Mgmt
type: local
strategy: ordered
untrust:
paths:
- name: wan
type: wan
strategy: ordered
port_config:
ge-0/0/0:
aggregated: false
ip_config:
gateway: 192.168.1.1
ip: 192.168.1.9
netmask: /24
type: static
name: wan
redundant: false
traffic_shaping:
enabled: false
usage: wan
wan_type: broadband
ge-0/0/6-7:
ae_disable_lacp: false
ae_idx: '0'
ae_lacp_force_up: true
aggregated: true
networks:
- Corp-lan
- Corp-Mgmt
- Corp-Core
usage: lan
service_policies:
- action: allow
idp:
enabled: false
name: ITParis-Internal
path_preference: core
services:
- internal_dns
- drive
tenants:
- ITParis
- action: deny
idp:
enabled: false
name: ITParis-internet
path_preference: untrust
services:
- internet_any
tenants:
- ITParis
type: standalone
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/gateway_template'
- description: Gateway Template is applied to a site for gateway(s) in a site.
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/gateway_template'
- description: Gateway Template is applied to a site for gateway(s) in a site.
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/gatewaytemplates/{gatewaytemplate_id}:
delete:
tags:
- Orgs Gateway Templates
summary: deleteOrgGatewayTemplate
description: Delete an organization gateway template and remove that reusable gateway configuration object from the organization.
operationId: deleteOrgGatewayTemplate
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: gatewaytemplate_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Orgs Gateway Templates
summary: getOrgGatewayTemplate
description: Retrieve the configuration stored in a specific organization gateway template.
operationId: getOrgGatewayTemplate
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: gatewaytemplate_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/gateway_template'
- description: Gateway Template is applied to a site for gateway(s) in a site.
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/gateway_template'
- description: Gateway Template is applied to a site for gateway(s) in a site.
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Orgs Gateway Templates
summary: updateOrgGatewayTemplate
description: Update the configuration stored in an organization gateway template.
operationId: updateOrgGatewayTemplate
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: gatewaytemplate_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Gateway Template
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/gateway_template'
- description: Gateway Template
examples:
- dhcpd_config:
Corp-Mgmt:
dns_servers:
- 8.8.8.8
dns_suffix:
- stag.one
gateway: 10.3.172.9
ip_end: 10.3.172.99
ip_start: 10.3.172.50
type: local
Corp-lan:
dns_servers:
- 8.8.8.8
dns_suffix:
- stag.one
gateway: 10.3.171.9
ip_end: 10.3.171.99
ip_start: 10.3.171.50
type: local
dnsOverride: true
dns_servers:
- 10.3.20.201
- 10.3.51.222
- 1.1.1.1
dns_suffix:
- example.com
extra_routes:
10.101.0.0/16:
via: 10.3.100.10
ip_configs:
Corp-Core:
ip: 10.3.100.9
netmask: /24
type: static
Corp-Mgmt:
ip: 10.3.172.9
netmask: /24
type: static
Corp-lan:
ip: 10.3.171.9
netmask: /24
type: static
name: ITParis
ntpOverride: true
ntp_servers:
- 10.3.51.222
path_preferences:
core:
paths:
- networks:
- Corp-Core
type: local
strategy: ordered
lab:
paths:
- networks:
- Corp-lan
type: local
strategy: ordered
mgmt:
paths:
- networks:
- Corp-Mgmt
type: local
strategy: ordered
untrust:
paths:
- name: wan
type: wan
strategy: ordered
port_config:
ge-0/0/0:
aggregated: false
ip_config:
gateway: 192.168.1.1
ip: 192.168.1.9
netmask: /24
type: static
name: wan
redundant: false
traffic_shaping:
enabled: false
usage: wan
wan_type: broadband
ge-0/0/6-7:
ae_disable_lacp: false
ae_idx: '0'
ae_lacp_force_up: true
aggregated: true
networks:
- Corp-lan
- Corp-Mgmt
- Corp-Core
usage: lan
service_policies:
- action: allow
idp:
enabled: false
name: ITParis-Internal
path_preference: core
services:
- internal_dns
- drive
tenants:
- ITParis
- action: deny
idp:
enabled: false
name: ITParis-internet
path_preference: untrust
services:
- internet_any
tenants:
- ITParis
type: standalone
contentMediaType: application/json
examples:
Example:
value:
dhcpd_config:
Corp-Mgmt:
dns_servers:
- 8.8.8.8
dns_suffix:
- stag.one
gateway: 10.3.172.9
ip_end: 10.3.172.99
ip_start: 10.3.172.50
type: local
Corp-lan:
dns_servers:
- 8.8.8.8
dns_suffix:
- stag.one
gateway: 10.3.171.9
ip_end: 10.3.171.99
ip_start: 10.3.171.50
type: local
dnsOverride: true
dns_servers:
- 10.3.20.201
- 10.3.51.222
- 1.1.1.1
dns_suffix:
- example.com
extra_routes:
10.101.0.0/16:
via: 10.3.100.10
ip_configs:
Corp-Core:
ip: 10.3.100.9
netmask: /24
type: static
Corp-Mgmt:
ip: 10.3.172.9
netmask: /24
type: static
Corp-lan:
ip: 10.3.171.9
netmask: /24
type: static
name: ITParis
ntpOverride: true
ntp_servers:
- 10.3.51.222
path_preferences:
core:
paths:
- networks:
- Corp-Core
type: local
strategy: ordered
lab:
paths:
- networks:
- Corp-lan
type: local
strategy: ordered
mgmt:
paths:
- networks:
- Corp-Mgmt
type: local
strategy: ordered
untrust:
paths:
- name: wan
type: wan
strategy: ordered
port_config:
ge-0/0/0:
aggregated: false
ip_config:
gateway: 192.168.1.1
ip: 192.168.1.9
netmask: /24
type: static
name: wan
redundant: false
traffic_shaping:
enabled: false
usage: wan
wan_type: broadband
ge-0/0/6-7:
ae_disable_lacp: false
ae_idx: '0'
ae_lacp_force_up: true
aggregated: true
networks:
- Corp-lan
- Corp-Mgmt
- Corp-Core
usage: lan
service_policies:
- action: allow
idp:
enabled: false
name: ITParis-Internal
path_preference: core
services:
- internal_dns
- drive
tenants:
- ITParis
- action: deny
idp:
enabled: false
name: ITParis-internet
path_preference: untrust
services:
- internet_any
tenants:
- ITParis
type: standalone
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/gateway_template'
- description: Gateway Template is applied to a site for gateway(s) in a site.
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/gateway_template'
- description: Gateway Template is applied to a site for gateway(s) in a site.
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/guests:
get:
tags:
- Orgs Guests
summary: listOrgGuestAuthorizations
description: List guest authorization records across the organization, including WLAN, SSID, authentication method, expiration, and guest identity details.
operationId: listOrgGuestAuthorizations
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/guest'
description: List of guest authorization records
examples:
- '[{"authorized":true,"authorized_expiring_time":0,"authorized_time":0,"company":"string","email":"user@example.com","field1":"string","field2":"string","field3":"string","field4":"string","mac":"string","minutes":0,"name":"string"}]'
- '[{"authorized":true,"authorized_expiring_time":1480704955,"authorized_time":1480704355,"company":"abc","email":"john@abc.com","field1":"xxx","mac":"5684dae9ac8b","name":"John Smith"}]'
contentMediaType: application/json
examples:
Example:
value:
- authorized: true
authorized_expiring_time: 0
authorized_time: 0
company: string
email: user@example.com
field1: string
field2: string
field3: string
field4: string
mac: string
minutes: 0
name: string
Example2:
value:
- authorized: true
authorized_expiring_time: 1480704955
authorized_time: 1480704355
company: abc
email: john@abc.com
field1: xxx
mac: 5684dae9ac8b
name: John Smith
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/guest'
description: List of guest authorization records
examples:
- '[{"authorized":true,"authorized_expiring_time":0,"authorized_time":0,"company":"string","email":"user@example.com","field1":"string","field2":"string","field3":"string","field4":"string","mac":"string","minutes":0,"name":"string"}]'
- '[{"authorized":true,"authorized_expiring_time":1480704955,"authorized_time":1480704355,"company":"abc","email":"john@abc.com","field1":"xxx","mac":"5684dae9ac8b","name":"John Smith"}]'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- authorized: true
authorized_expiring_time: 0
authorized_time: 0
company: string
email: user@example.com
field1: string
field2: string
field3: string
field4: string
mac: string
minutes: 0
name: string
Example2:
value:
- authorized: true
authorized_expiring_time: 1480704955
authorized_time: 1480704355
company: abc
email: john@abc.com
field1: xxx
mac: 5684dae9ac8b
name: John Smith
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/guests/count:
get:
tags:
- Orgs Guests
summary: countOrgGuestAuthorizations
description: Count organization guest authorization records, optionally grouped by `distinct` and filtered by time range.
operationId: countOrgGuestAuthorizations
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field used to group this count response. enum: `auth_method`, `company`, `ssid`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/org_guests_count_distinct'
- description: 'Field used to group this count response. enum: `auth_method`, `company`, `ssid`'
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/guests/search:
get:
tags:
- Orgs Guests
summary: searchOrgGuestAuthorization
description: Search organization guest authorization records with filters for WLAN, SSID, authentication method, and time range.
operationId: searchOrgGuestAuthorization
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: wlan_id
in: query
description: Filter results by WLAN identifier
style: form
explode: true
schema:
type: string
examples:
- 00000000-0000-0000-0000-000000000000
- name: auth_method
in: query
description: Filter results by authentication method
style: form
explode: true
schema:
type: string
examples:
- psk
- name: ssid
in: query
description: Filter results by SSID
style: form
explode: true
schema:
type: string
examples:
- Guest
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_guest_search'
- description: Paginated response for guest authorization search results
examples:
- end: 1531862583
limit: 2
next: /api/v1/sites/8aaba0aa-09cc-44bd-9709-33b98040550c/guests/search?wlan_id=88ffe630-95b8-11e8-b294-346895ed1b7d&end=1531855849.000&limit=2&start=1531776183.0
results:
- ap: 5c5b350e0001
auth_method: passphrase
authorized_expiring_time: 1531810258.186273
authorized_time: 1531782218
company: mistsystems
email: user@mistsys.com
name: john
ssid: openNet
timestamp: 1531782218
- ap: 5c5b350e0001
auth_method: facebook
authorized_expiring_time: 1531810821.145
authorized_time: 1531782632
company: xyz inc.
email: cool_user@yahoo.com
name: John White
ssid: openNet
timestamp: 1531782632
start: 1531776183
total: 14
contentMediaType: application/json
examples:
Example:
value:
end: 1531862583
limit: 2
next: /api/v1/sites/8aaba0aa-09cc-44bd-9709-33b98040550c/guests/search?wlan_id=88ffe630-95b8-11e8-b294-346895ed1b7d&end=1531855849.000&limit=2&start=1531776183.0
results:
- ap: 5c5b350e0001
auth_method: passphrase
authorized_expiring_time: 1531810258.186273
authorized_time: 1531782218
company: mistsystems
email: user@mistsys.com
name: john
ssid: openNet
timestamp: 1531782218
- ap: 5c5b350e0001
auth_method: facebook
authorized_expiring_time: 1531810821.145
authorized_time: 1531782632
company: xyz inc.
email: cool_user@yahoo.com
name: John White
ssid: openNet
timestamp: 1531782632
start: 1531776183
total: 14
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_guest_search'
- description: Paginated response for guest authorization search results
examples:
- end: 1531862583
limit: 2
next: /api/v1/sites/8aaba0aa-09cc-44bd-9709-33b98040550c/guests/search?wlan_id=88ffe630-95b8-11e8-b294-346895ed1b7d&end=1531855849.000&limit=2&start=1531776183.0
results:
- ap: 5c5b350e0001
auth_method: passphrase
authorized_expiring_time: 1531810258.186273
authorized_time: 1531782218
company: mistsystems
email: user@mistsys.com
name: john
ssid: openNet
timestamp: 1531782218
- ap: 5c5b350e0001
auth_method: facebook
authorized_expiring_time: 1531810821.145
authorized_time: 1531782632
company: xyz inc.
email: cool_user@yahoo.com
name: John White
ssid: openNet
timestamp: 1531782632
start: 1531776183
total: 14
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 1531862583
limit: 2
next: /api/v1/sites/8aaba0aa-09cc-44bd-9709-33b98040550c/guests/search?wlan_id=88ffe630-95b8-11e8-b294-346895ed1b7d&end=1531855849.000&limit=2&start=1531776183.0
results:
- ap: 5c5b350e0001
auth_method: passphrase
authorized_expiring_time: 1531810258.186273
authorized_time: 1531782218
company: mistsystems
email: user@mistsys.com
name: john
ssid: openNet
timestamp: 1531782218
- ap: 5c5b350e0001
auth_method: facebook
authorized_expiring_time: 1531810821.145
authorized_time: 1531782632
company: xyz inc.
email: cool_user@yahoo.com
name: John White
ssid: openNet
timestamp: 1531782632
start: 1531776183
total: 14
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/guests/{guest_mac}:
delete:
tags:
- Orgs Guests
summary: deleteOrgGuestAuthorization
description: Delete a guest authorization record by guest MAC address.
operationId: deleteOrgGuestAuthorization
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: guest_mac
in: path
description: ''
required: true
schema:
pattern: ^[0-9a-fA-F]{12}$
type: string
examples:
- 0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Orgs Guests
summary: getOrgGuestAuthorization
description: Retrieve the guest authorization record associated with a guest MAC address.
operationId: getOrgGuestAuthorization
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: guest_mac
in: path
description: ''
required: true
schema:
pattern: ^[0-9a-fA-F]{12}$
type: string
examples:
- 0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/guest'
- description: Guest authorization record at site scope
examples:
- '{"authorized":true,"authorized_expiring_time":0,"authorized_time":0,"company":"string","email":"user@example.com","field1":"string","field2":"string","field3":"string","field4":"string","mac":"string","minutes":0,"name":"string"}'
- '{"authorized":true,"authorized_expiring_time":1480704955,"authorized_time":1480704355,"company":"abc","email":"john@abc.com","field1":"xxx","mac":"5684dae9ac8b","name":"John Smith"}'
contentMediaType: application/json
examples:
Example:
value:
authorized: true
authorized_expiring_time: 0
authorized_time: 0
company: string
email: user@example.com
field1: string
field2: string
field3: string
field4: string
mac: string
minutes: 0
name: string
Example2:
value:
authorized: true
authorized_expiring_time: 1480704955
authorized_time: 1480704355
company: abc
email: john@abc.com
field1: xxx
mac: 5684dae9ac8b
name: John Smith
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/guest'
- description: Guest authorization record at site scope
examples:
- '{"authorized":true,"authorized_expiring_time":0,"authorized_time":0,"company":"string","email":"user@example.com","field1":"string","field2":"string","field3":"string","field4":"string","mac":"string","minutes":0,"name":"string"}'
- '{"authorized":true,"authorized_expiring_time":1480704955,"authorized_time":1480704355,"company":"abc","email":"john@abc.com","field1":"xxx","mac":"5684dae9ac8b","name":"John Smith"}'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
authorized: true
authorized_expiring_time: 0
authorized_time: 0
company: string
email: user@example.com
field1: string
field2: string
field3: string
field4: string
mac: string
minutes: 0
name: string
Example2:
value:
authorized: true
authorized_expiring_time: 1480704955
authorized_time: 1480704355
company: abc
email: john@abc.com
field1: xxx
mac: 5684dae9ac8b
name: John Smith
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Orgs Guests
summary: updateOrgGuestAuthorization
description: Update the organization guest authorization record for a guest MAC address, including authorization state, duration, WLAN, and guest identity fields.
operationId: updateOrgGuestAuthorization
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: guest_mac
in: path
description: ''
required: true
schema:
pattern: ^[0-9a-fA-F]{12}$
type: string
examples:
- 0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/guest_org'
- examples:
- company: string
email: user@example.com
mac: string
minutes: 1440
name: John Smith
wlan_id: 6748cfa6-4e12-11e6-9188-0242ac110007
contentMediaType: application/json
examples:
Example:
value:
company: string
email: user@example.com
mac: string
minutes: 1440
name: John Smith
wlan_id: 6748cfa6-4e12-11e6-9188-0242ac110007
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/guest'
- description: Guest authorization record at site scope
examples:
- '{"authorized":true,"authorized_expiring_time":0,"authorized_time":0,"company":"string","email":"user@example.com","field1":"string","field2":"string","field3":"string","field4":"string","mac":"string","minutes":0,"name":"string"}'
- '{"authorized":true,"authorized_expiring_time":1480704955,"authorized_time":1480704355,"company":"abc","email":"john@abc.com","field1":"xxx","mac":"5684dae9ac8b","name":"John Smith"}'
contentMediaType: application/json
examples:
Example:
value:
authorized: true
authorized_expiring_time: 0
authorized_time: 0
company: string
email: user@example.com
field1: string
field2: string
field3: string
field4: string
mac: string
minutes: 0
name: string
Example2:
value:
authorized: true
authorized_expiring_time: 1480704955
authorized_time: 1480704355
company: abc
email: john@abc.com
field1: xxx
mac: 5684dae9ac8b
name: John Smith
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/guest'
- description: Guest authorization record at site scope
examples:
- '{"authorized":true,"authorized_expiring_time":0,"authorized_time":0,"company":"string","email":"user@example.com","field1":"string","field2":"string","field3":"string","field4":"string","mac":"string","minutes":0,"name":"string"}'
- '{"authorized":true,"authorized_expiring_time":1480704955,"authorized_time":1480704355,"company":"abc","email":"john@abc.com","field1":"xxx","mac":"5684dae9ac8b","name":"John Smith"}'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
authorized: true
authorized_expiring_time: 0
authorized_time: 0
company: string
email: user@example.com
field1: string
field2: string
field3: string
field4: string
mac: string
minutes: 0
name: string
Example2:
value:
authorized: true
authorized_expiring_time: 1480704955
authorized_time: 1480704355
company: abc
email: john@abc.com
field1: xxx
mac: 5684dae9ac8b
name: John Smith
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/idpprofiles:
get:
tags:
- Orgs IDP Profiles
summary: listOrgIdpProfiles
description: List organization Intrusion Detection and Prevention (IDP) profiles, including their base profile and signature overwrite rules.
operationId: listOrgIdpProfiles
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/idp_profile'
description: IDP profile records returned for an organization
examples:
- - base_profile: strict
created_time: 0
id: 874ca978-d736-4d4b-bc90-a49a29eec133
modified_time: 0
name: relaxed
overwrites:
- action: alert
matching:
attack_name:
- HTTP:INVALID:HDR-FIELD
dst_subnet:
- 63.1.2.0/24
severity:
- major
contentMediaType: application/json
examples:
Idpprofiles:
value:
- base_profile: strict
created_time: 0
id: 874ca978-d736-4d4b-bc90-a49a29eec133
modified_time: 0
name: relaxed
overwrites:
- action: alert
matching:
attack_name:
- HTTP:INVALID:HDR-FIELD
dst_subnet:
- 63.1.2.0/24
severity:
- major
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/idp_profile'
description: IDP profile records returned for an organization
examples:
- - base_profile: strict
created_time: 0
id: 874ca978-d736-4d4b-bc90-a49a29eec133
modified_time: 0
name: relaxed
overwrites:
- action: alert
matching:
attack_name:
- HTTP:INVALID:HDR-FIELD
dst_subnet:
- 63.1.2.0/24
severity:
- major
contentMediaType: application/vnd.api+json
examples:
Idpprofiles:
value:
- base_profile: strict
created_time: 0
id: 874ca978-d736-4d4b-bc90-a49a29eec133
modified_time: 0
name: relaxed
overwrites:
- action: alert
matching:
attack_name:
- HTTP:INVALID:HDR-FIELD
dst_subnet:
- 63.1.2.0/24
severity:
- major
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs IDP Profiles
summary: createOrgIdpProfile
description: Create an organization Intrusion Detection and Prevention (IDP) profile with a built-in base profile and optional signature overwrite rules.
operationId: createOrgIdpProfile
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/idp_profile'
- examples:
- base_profile: strict
name: relaxed
overwrites:
- action: alert
matching:
attack_name:
- HTTP:INVALID:HDR-FIELD
dst_subnet:
- 63.1.2.0/24
severity:
- major
contentMediaType: application/json
examples:
Example:
value:
base_profile: strict
name: relaxed
overwrites:
- action: alert
matching:
attack_name:
- HTTP:INVALID:HDR-FIELD
dst_subnet:
- 63.1.2.0/24
severity:
- major
required: false
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/idp_profile'
- description: Organization IDP profile with a base profile and targeted overwrite rules
examples:
- base_profile: strict
created_time: 0
id: 874ca978-d736-4d4b-bc90-a49a29eec133
modified_time: 0
name: relaxed
overwrites:
- action: alert
matching:
attack_name:
- HTTP:INVALID:HDR-FIELD
dst_subnet:
- 63.1.2.0/24
severity:
- major
contentMediaType: application/json
examples:
Idpprofile:
value:
base_profile: strict
created_time: 0
id: 874ca978-d736-4d4b-bc90-a49a29eec133
modified_time: 0
name: relaxed
overwrites:
- action: alert
matching:
attack_name:
- HTTP:INVALID:HDR-FIELD
dst_subnet:
- 63.1.2.0/24
severity:
- major
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/idp_profile'
- description: Organization IDP profile with a base profile and targeted overwrite rules
examples:
- base_profile: strict
created_time: 0
id: 874ca978-d736-4d4b-bc90-a49a29eec133
modified_time: 0
name: relaxed
overwrites:
- action: alert
matching:
attack_name:
- HTTP:INVALID:HDR-FIELD
dst_subnet:
- 63.1.2.0/24
severity:
- major
contentMediaType: application/vnd.api+json
examples:
Idpprofile:
value:
base_profile: strict
created_time: 0
id: 874ca978-d736-4d4b-bc90-a49a29eec133
modified_time: 0
name: relaxed
overwrites:
- action: alert
matching:
attack_name:
- HTTP:INVALID:HDR-FIELD
dst_subnet:
- 63.1.2.0/24
severity:
- major
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/idpprofiles/{idpprofile_id}:
delete:
tags:
- Orgs IDP Profiles
summary: deleteOrgIdpProfile
description: Delete an organization Intrusion Detection and Prevention (IDP) profile by profile ID.
operationId: deleteOrgIdpProfile
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: idpprofile_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Orgs IDP Profiles
summary: getOrgIdpProfile
description: Retrieve the base profile and signature overwrite rules for a specific organization IDP profile.
operationId: getOrgIdpProfile
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: idpprofile_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/idp_profile'
- description: Organization IDP profile with a base profile and targeted overwrite rules
examples:
- base_profile: strict
created_time: 0
id: 874ca978-d736-4d4b-bc90-a49a29eec133
modified_time: 0
name: relaxed
overwrites:
- action: alert
matching:
attack_name:
- HTTP:INVALID:HDR-FIELD
dst_subnet:
- 63.1.2.0/24
severity:
- major
contentMediaType: application/json
examples:
Idpprofile:
value:
base_profile: strict
created_time: 0
id: 874ca978-d736-4d4b-bc90-a49a29eec133
modified_time: 0
name: relaxed
overwrites:
- action: alert
matching:
attack_name:
- HTTP:INVALID:HDR-FIELD
dst_subnet:
- 63.1.2.0/24
severity:
- major
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/idp_profile'
- description: Organization IDP profile with a base profile and targeted overwrite rules
examples:
- base_profile: strict
created_time: 0
id: 874ca978-d736-4d4b-bc90-a49a29eec133
modified_time: 0
name: relaxed
overwrites:
- action: alert
matching:
attack_name:
- HTTP:INVALID:HDR-FIELD
dst_subnet:
- 63.1.2.0/24
severity:
- major
contentMediaType: application/vnd.api+json
examples:
Idpprofile:
value:
base_profile: strict
created_time: 0
id: 874ca978-d736-4d4b-bc90-a49a29eec133
modified_time: 0
name: relaxed
overwrites:
- action: alert
matching:
attack_name:
- HTTP:INVALID:HDR-FIELD
dst_subnet:
- 63.1.2.0/24
severity:
- major
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Orgs IDP Profiles
summary: updateOrgIdpProfile
description: Update an organization IDP profile, including its base profile and signature overwrite rules.
operationId: updateOrgIdpProfile
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: idpprofile_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/idp_profile'
- examples:
- base_profile: strict
name: relaxed
overwrites:
- action: alert
matching:
attack_name:
- HTTP:INVALID:HDR-FIELD
dst_subnet:
- 63.1.2.0/24
severity:
- major
contentMediaType: application/json
examples:
idpprofile:
value:
base_profile: strict
name: relaxed
overwrites:
- action: alert
matching:
attack_name:
- HTTP:INVALID:HDR-FIELD
dst_subnet:
- 63.1.2.0/24
severity:
- major
required: false
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/idp_profile'
- description: Organization IDP profile with a base profile and targeted overwrite rules
examples:
- base_profile: strict
created_time: 0
id: 874ca978-d736-4d4b-bc90-a49a29eec133
modified_time: 0
name: relaxed
overwrites:
- action: alert
matching:
attack_name:
- HTTP:INVALID:HDR-FIELD
dst_subnet:
- 63.1.2.0/24
severity:
- major
contentMediaType: application/json
examples:
Idpprofile:
value:
base_profile: strict
created_time: 0
id: 874ca978-d736-4d4b-bc90-a49a29eec133
modified_time: 0
name: relaxed
overwrites:
- action: alert
matching:
attack_name:
- HTTP:INVALID:HDR-FIELD
dst_subnet:
- 63.1.2.0/24
severity:
- major
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/idp_profile'
- description: Organization IDP profile with a base profile and targeted overwrite rules
examples:
- base_profile: strict
created_time: 0
id: 874ca978-d736-4d4b-bc90-a49a29eec133
modified_time: 0
name: relaxed
overwrites:
- action: alert
matching:
attack_name:
- HTTP:INVALID:HDR-FIELD
dst_subnet:
- 63.1.2.0/24
severity:
- major
contentMediaType: application/vnd.api+json
examples:
Idpprofile:
value:
base_profile: strict
created_time: 0
id: 874ca978-d736-4d4b-bc90-a49a29eec133
modified_time: 0
name: relaxed
overwrites:
- action: alert
matching:
attack_name:
- HTTP:INVALID:HDR-FIELD
dst_subnet:
- 63.1.2.0/24
severity:
- major
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/inventory:
get:
tags:
- Orgs Inventory
summary: getOrgInventory
description: "Get Org Inventory\n\n### VC (Virtual-Chassis) Management \n\nStarting with the April release, Virtual Chassis devices in Mist will now use\na cloud-assigned virtual MAC address as the device ID, instead of the physical\nMAC address of the FPC0 member.\n\n\n**Retrieving the device ID or Site ID of a Virtual Chassis:**\n\n1. Use this API call with the query parameters `vc=true` and `mac` set to the MAC address of the VC member.\n\n2. In the response, check the `vc_mac` and `mac` fields:\n\n - If `vc_mac` is empty or not present, the device is not part of a Virtual Chassis.\n The `device_id` and `site_id` will be available in the device information.\n\n - If `vc_mac` differs from the `mac` field, the device is part of a Virtual Chassis\n but is not the device used to generate the Virtual Chassis ID. Use the `vc_mac` value with the [Get Org Inventory]($e/Orgs%20Inventory/getOrgInventory)\n API call to retrieve the `device_id` and `site_id`.\n\n - If `vc_mac` matches the `mac` field, the device is the device used to generate the Virtual Chassis ID and he `device_id` and `site_id` will be available\n in the device information. \n This is the case if the device is the Virtual Chassis \"virtual device\" (MAC starting with `020003`) or if the device is the Virtual Chassis FPC0 and the Virtual Chassis is still using the FPC0 MAC address to generate the device ID.\n"
operationId: getOrgInventory
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: serial
in: query
description: Filter results by device serial number. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- PE3717390301,EY2523AN0523
- FXLH2015150025
examples:
Untitled Example1:
value: PE3717390301,EY2523AN0523
Untitled Example2:
value: FXLH2015150025
- name: model
in: query
description: Filter results by device model. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- EX4300-48T,EX4100-48MP
- AP43
examples:
Untitled Example1:
value: EX4300-48T,EX4100-48MP
Untitled Example2:
value: AP43
- name: type
in: query
description: 'Filter results by type. enum: `ap`, `gateway`, `switch`. Accepts multiple comma-separated values.'
style: form
explode: true
schema:
type: string
examples:
- switch,ap
- name: mac
in: query
description: Filter results by MAC address. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- 5c5b53010101,5c5b53020202
- 5c5b350e0001
examples:
Untitled Example1:
value: 5c5b53010101,5c5b53020202
Untitled Example2:
value: 5c5b350e0001
- name: site_id
in: query
description: Filter results by one site identifier. Use a single value; comma-separated values are not supported
style: form
explode: true
schema:
type: string
contentEncoding: uuid
examples:
- 4ac1dcf4-9d8b-7211-65c4-057819f0862b
- name: vc_mac
in: query
description: Virtual Chassis MAC address. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- 5c5b53010101,5c5b53020202
- 5c5b350e0001
examples:
Untitled Example1:
value: 5c5b53010101,5c5b53020202
Untitled Example2:
value: 5c5b350e0001
- name: vc
in: query
description: To display Virtual Chassis members
style: form
explode: true
schema:
type: boolean
default: false
examples:
- false
- name: unassigned
in: query
description: To display Unassigned devices
style: form
explode: true
schema:
type: boolean
default: true
examples:
- true
- name: modified_after
in: query
description: Filter on inventory last modified time, in epoch
style: form
explode: true
schema:
type: integer
contentEncoding: int32
examples:
- 1703003296
- name: disconnected_before
in: query
description: Filter results to devices that were last disconnected before this time, in epoch seconds
style: form
explode: true
schema:
type: integer
contentEncoding: int32
examples:
- 1733522845
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/inventory'
description: Inventory records for claimed devices
examples:
- - connected: true
created_time: 1542328276
deviceprofile_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
id: 00000000-0000-0000-0000-5c5b35000018
last_disconnected: 1542828000
mac: 5c5b35000018
model: AP41
modified_time: 1542829778
name: hallway
serial: FXLH2015150025
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
type: ap
contentMediaType: application/json
examples:
Example:
value:
- connected: true
created_time: 1542328276
deviceprofile_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
id: 00000000-0000-0000-0000-5c5b35000018
last_disconnected: 1542828000
mac: 5c5b35000018
model: AP41
modified_time: 1542829778
name: hallway
serial: FXLH2015150025
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
type: ap
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/inventory'
description: Inventory records for claimed devices
examples:
- - connected: true
created_time: 1542328276
deviceprofile_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
id: 00000000-0000-0000-0000-5c5b35000018
last_disconnected: 1542828000
mac: 5c5b35000018
model: AP41
modified_time: 1542829778
name: hallway
serial: FXLH2015150025
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
type: ap
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- connected: true
created_time: 1542328276
deviceprofile_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
id: 00000000-0000-0000-0000-5c5b35000018
last_disconnected: 1542828000
mac: 5c5b35000018
model: AP41
modified_time: 1542829778
name: hallway
serial: FXLH2015150025
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
type: ap
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs Inventory
summary: addOrgInventory
description: Claim devices into the organization inventory using order activation codes or device claim codes.
operationId: addOrgInventory
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
uniqueItems: true
type: array
items:
type: string
description: Request Body
examples:
- - 6JG8E-PTFV2-A9Z2N
- DVH4V-SNMSZ-PDXBR
contentMediaType: application/json
examples:
Example:
value:
- 6JG8E-PTFV2-A9Z2N
- DVH4V-SNMSZ-PDXBR
required: false
responses:
'200':
description: OK - if any of entries are valid or there’s no errors
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_inventory'
- description: Result of adding device claim codes to organization inventory
examples:
- added:
- 6JG8E-PTFV2-A9Z2N
duplicated:
- DVH4V-SNMSZ-PDXBR
error:
- PO1025335ohoh
inventory_added:
- mac: 5c5b35000018
magic: 6JG8EPTFV2A9Z2N
model: AP41
serial: FXLH2015150025
type: ap
inventory_duplicated:
- mac: 5c5b35000012
magic: DVH4VSNMSZPDXBR
model: AP41
serial: FXLH2015150027
type: ap
reason:
- belongs to another org ('e2f543f7-d6e1-409f-a565-e77a1f098d3b' (other) != '0de5d6fc-219a-414d-a840-67d6b919ad8f' (you))
contentMediaType: application/json
examples:
Example:
value:
added:
- 6JG8E-PTFV2-A9Z2N
duplicated:
- DVH4V-SNMSZ-PDXBR
error:
- PO1025335ohoh
inventory_added:
- mac: 5c5b35000018
magic: 6JG8EPTFV2A9Z2N
model: AP41
serial: FXLH2015150025
type: ap
inventory_duplicated:
- mac: 5c5b35000012
magic: DVH4VSNMSZPDXBR
model: AP41
serial: FXLH2015150027
type: ap
reason:
- belongs to another org ('e2f543f7-d6e1-409f-a565-e77a1f098d3b' (other) != '0de5d6fc-219a-414d-a840-67d6b919ad8f' (you))
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_inventory'
- description: Result of adding device claim codes to organization inventory
examples:
- added:
- 6JG8E-PTFV2-A9Z2N
duplicated:
- DVH4V-SNMSZ-PDXBR
error:
- PO1025335ohoh
inventory_added:
- mac: 5c5b35000018
magic: 6JG8EPTFV2A9Z2N
model: AP41
serial: FXLH2015150025
type: ap
inventory_duplicated:
- mac: 5c5b35000012
magic: DVH4VSNMSZPDXBR
model: AP41
serial: FXLH2015150027
type: ap
reason:
- belongs to another org ('e2f543f7-d6e1-409f-a565-e77a1f098d3b' (other) != '0de5d6fc-219a-414d-a840-67d6b919ad8f' (you))
contentMediaType: application/vnd.api+json
examples:
Example:
value:
added:
- 6JG8E-PTFV2-A9Z2N
duplicated:
- DVH4V-SNMSZ-PDXBR
error:
- PO1025335ohoh
inventory_added:
- mac: 5c5b35000018
magic: 6JG8EPTFV2A9Z2N
model: AP41
serial: FXLH2015150025
type: ap
inventory_duplicated:
- mac: 5c5b35000012
magic: DVH4VSNMSZPDXBR
model: AP41
serial: FXLH2015150027
type: ap
reason:
- belongs to another org ('e2f543f7-d6e1-409f-a565-e77a1f098d3b' (other) != '0de5d6fc-219a-414d-a840-67d6b919ad8f' (you))
'400':
description: OK - if any of entries are valid or there’s no errors
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_inventory'
- description: Result of adding device claim codes to organization inventory
examples:
- added:
- 6JG8E-PTFV2-A9Z2N
duplicated:
- DVH4V-SNMSZ-PDXBR
error:
- PO1025335ohoh
inventory_added:
- mac: 5c5b35000018
magic: 6JG8EPTFV2A9Z2N
model: AP41
serial: FXLH2015150025
type: ap
inventory_duplicated:
- mac: 5c5b35000012
magic: DVH4VSNMSZPDXBR
model: AP41
serial: FXLH2015150027
type: ap
reason:
- belongs to another org ('e2f543f7-d6e1-409f-a565-e77a1f098d3b' (other) != '0de5d6fc-219a-414d-a840-67d6b919ad8f' (you))
contentMediaType: application/json
examples:
Example:
value:
added:
- 6JG8E-PTFV2-A9Z2N
duplicated:
- DVH4V-SNMSZ-PDXBR
error:
- PO1025335ohoh
inventory_added:
- mac: 5c5b35000018
magic: 6JG8EPTFV2A9Z2N
model: AP41
serial: FXLH2015150025
type: ap
inventory_duplicated:
- mac: 5c5b35000012
magic: DVH4VSNMSZPDXBR
model: AP41
serial: FXLH2015150027
type: ap
reason:
- belongs to another org ('e2f543f7-d6e1-409f-a565-e77a1f098d3b' (other) != '0de5d6fc-219a-414d-a840-67d6b919ad8f' (you))
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_inventory'
- description: Result of adding device claim codes to organization inventory
examples:
- added:
- 6JG8E-PTFV2-A9Z2N
duplicated:
- DVH4V-SNMSZ-PDXBR
error:
- PO1025335ohoh
inventory_added:
- mac: 5c5b35000018
magic: 6JG8EPTFV2A9Z2N
model: AP41
serial: FXLH2015150025
type: ap
inventory_duplicated:
- mac: 5c5b35000012
magic: DVH4VSNMSZPDXBR
model: AP41
serial: FXLH2015150027
type: ap
reason:
- belongs to another org ('e2f543f7-d6e1-409f-a565-e77a1f098d3b' (other) != '0de5d6fc-219a-414d-a840-67d6b919ad8f' (you))
contentMediaType: application/vnd.api+json
examples:
Example:
value:
added:
- 6JG8E-PTFV2-A9Z2N
duplicated:
- DVH4V-SNMSZ-PDXBR
error:
- PO1025335ohoh
inventory_added:
- mac: 5c5b35000018
magic: 6JG8EPTFV2A9Z2N
model: AP41
serial: FXLH2015150025
type: ap
inventory_duplicated:
- mac: 5c5b35000012
magic: DVH4VSNMSZPDXBR
model: AP41
serial: FXLH2015150027
type: ap
reason:
- belongs to another org ('e2f543f7-d6e1-409f-a565-e77a1f098d3b' (other) != '0de5d6fc-219a-414d-a840-67d6b919ad8f' (you))
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Orgs Inventory
summary: updateOrgInventoryAssignment
description: Update inventory assignment for one or more devices, such as assigning them to a site, unassigning them, or deleting inventory records by MAC address or serial number.
operationId: updateOrgInventoryAssignment
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/inventory_update'
- examples:
- '{"disable_auto_config":false,"macs":["5c5b350e0001"],"no_reassign":false,"op":"assign","site_id":"4ac1dcf4-9d8b-7211-65c4-057819f0862b"}'
- '{"macs":["5c5b350e0001"],"op":"delete","serials":["FXLH2015150025","FXLH2015150026"]}'
contentMediaType: application/json
examples:
assign:
value:
disable_auto_config: false
macs:
- 5c5b350e0001
no_reassign: false
op: assign
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
delete:
value:
macs:
- 5c5b350e0001
op: delete
serials:
- FXLH2015150025
- FXLH2015150026
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_org_inventory_change'
- description: Result of an organization inventory assignment or deletion operation
examples:
- '{"error":[],"op":"assign","reason":[],"success":["5c5b350e0001"]}'
- '{"error":["FXLH2015150026"],"op":"delete","reason":[],"success":["FXLH2015150025","5c5b350e0001"]}'
- '{"error":["5c5b350e0001"],"op":"upgrade_to_mist","reason":["already managed"],"success":["c15353123096"]}'
contentMediaType: application/json
examples:
Assign:
value:
error: []
op: assign
reason: []
success:
- 5c5b350e0001
Delete:
value:
error:
- FXLH2015150026
op: delete
reason: []
success:
- FXLH2015150025
- 5c5b350e0001
Error:
value:
error:
- 5c5b350e0001
op: upgrade_to_mist
reason:
- already managed
success:
- c15353123096
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_org_inventory_change'
- description: Result of an organization inventory assignment or deletion operation
examples:
- '{"error":[],"op":"assign","reason":[],"success":["5c5b350e0001"]}'
- '{"error":["FXLH2015150026"],"op":"delete","reason":[],"success":["FXLH2015150025","5c5b350e0001"]}'
- '{"error":["5c5b350e0001"],"op":"upgrade_to_mist","reason":["already managed"],"success":["c15353123096"]}'
contentMediaType: application/vnd.api+json
examples:
Assign:
value:
error: []
op: assign
reason: []
success:
- 5c5b350e0001
Delete:
value:
error:
- FXLH2015150026
op: delete
reason: []
success:
- FXLH2015150025
- 5c5b350e0001
Error:
value:
error:
- 5c5b350e0001
op: upgrade_to_mist
reason:
- already managed
success:
- c15353123096
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/inventory/count:
get:
tags:
- Orgs Inventory
summary: countOrgInventory
description: Count organization inventory records, optionally grouped by `distinct` and filtered by device type, site, model, version, and status.
operationId: countOrgInventory
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field used to group this count response. enum: `model`, `status`, `site_id`, `sku`, `version`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/inventory_count_distinct'
- description: 'Field used to group this count response. enum: `model`, `status`, `site_id`, `sku`, `version`'
- name: type
in: query
description: 'Filter results by type. enum: `ap`, `gateway`, `switch`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/device_type_default_ap'
- description: 'Filter results by type. enum: `ap`, `gateway`, `switch`'
- name: site_id
in: query
description: Filter results by site identifier
style: form
explode: true
schema:
type: string
- name: model
in: query
description: Filter results by device model. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- AP45,BT11
- name: version
in: query
description: Filter results by software version
style: form
explode: true
schema:
type: string
- name: status
in: query
description: 'Filter results by status. enum: `connected`, `disconnected`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/device_status_filter'
- description: 'Filter results by status. enum: `connected`, `disconnected`'
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/inventory/create_ha_cluster:
post:
tags:
- Orgs Inventory
summary: createOrgGatewayHaCluster
description: Create a gateway HA cluster from unassigned gateway inventory nodes and assign the cluster to the specified site.
operationId: createOrgGatewayHaCluster
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ha_cluster_config'
- examples:
- disable_auto_config: true
mist_configured: true
nodes:
- mac: aff827549235
- mac: 8396cd006c8c
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
contentMediaType: application/json
examples:
Example:
value:
disable_auto_config: true
mist_configured: true
nodes:
- mac: aff827549235
- mac: 8396cd006c8c
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/inventory/delete_ha_cluster:
post:
tags:
- Orgs Inventory
summary: deleteOrgGatewayHaCluster
description: >-
Delete HA Cluster
After HA cluster deleted, both of the nodes will be unassigned.
operationId: deleteOrgGatewayHaCluster
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/ha_cluster_delete'
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/inventory/reevaluate_auto_assignment:
post:
tags:
- Orgs Inventory
summary: reevaluateOrgAutoAssignment
description: Re-run organization inventory auto-assignment rules against devices that are eligible for automatic site assignment.
operationId: reevaluateOrgAutoAssignment
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/inventory/replace:
post:
tags:
- Orgs Inventory
summary: replaceOrgDevices
description: >-
It’s a common request we get from the customers. When a AP HW has problem and need a replacement, they would want to copy the existing attributes (Device Config) of this old AP to the new one. It can be done by providing the MAC of a device that’s currently in the inventory but not assigned. The Device replaced will become unassigned.
This API also supports replacement of Mist Edges. This API copies device agnostic attributes from old Mist edge to new one.
Mist manufactured Mist Edges will be reset to factory settings but will still be in Inventory.Brownfield or VM’s will be
deleted from Inventory
**Note:** For Gateway devices only like-for-like replacements (can only replace a SRX320 with a SRX320 and not some other model) are allowed.
operationId: replaceOrgDevices
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/replace_device'
- description: Request Body
examples:
- discard: []
inventory_mac: 5c5b35000301
mac: 5c5b35000101
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
contentMediaType: application/json
examples:
Example:
value:
discard: []
inventory_mac: 5c5b35000301
mac: 5c5b35000101
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_org_inventory_change'
- description: Result of an organization inventory assignment or deletion operation
examples:
- '{"error":[],"op":"assign","reason":[],"success":["5c5b350e0001"]}'
- '{"error":["FXLH2015150026"],"op":"delete","reason":[],"success":["FXLH2015150025","5c5b350e0001"]}'
- '{"error":["5c5b350e0001"],"op":"upgrade_to_mist","reason":["already managed"],"success":["c15353123096"]}'
contentMediaType: application/json
examples:
Assign:
value:
error: []
op: assign
reason: []
success:
- 5c5b350e0001
Delete:
value:
error:
- FXLH2015150026
op: delete
reason: []
success:
- FXLH2015150025
- 5c5b350e0001
Error:
value:
error:
- 5c5b350e0001
op: upgrade_to_mist
reason:
- already managed
success:
- c15353123096
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_org_inventory_change'
- description: Result of an organization inventory assignment or deletion operation
examples:
- '{"error":[],"op":"assign","reason":[],"success":["5c5b350e0001"]}'
- '{"error":["FXLH2015150026"],"op":"delete","reason":[],"success":["FXLH2015150025","5c5b350e0001"]}'
- '{"error":["5c5b350e0001"],"op":"upgrade_to_mist","reason":["already managed"],"success":["c15353123096"]}'
contentMediaType: application/vnd.api+json
examples:
Assign:
value:
error: []
op: assign
reason: []
success:
- 5c5b350e0001
Delete:
value:
error:
- FXLH2015150026
op: delete
reason: []
success:
- FXLH2015150025
- 5c5b350e0001
Error:
value:
error:
- 5c5b350e0001
op: upgrade_to_mist
reason:
- already managed
success:
- c15353123096
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/inventory/search:
get:
tags:
- Orgs Inventory
summary: searchOrgInventory
description: Search organization inventory records with filters for type, MAC address, model, name, site, serial number, Virtual Chassis master state, SKU, version, status, and text.
operationId: searchOrgInventory
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: type
in: query
description: 'Filter results by type. enum: `ap`, `gateway`, `switch`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/device_type_default_ap'
- description: 'Filter results by type. enum: `ap`, `gateway`, `switch`'
- name: mac
in: query
description: Filter by MAC address. Partial matches may use `*` wildcards (e.g. `*5b35*` matches `5c5b350e0001` and `5c5b35000301`). Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- 5c5b350e0001,*5b35*
- 5c5b350e0001
- '*5b35*'
examples:
Untitled Example1:
value: 5c5b350e0001,*5b35*
Untitled Example2:
value: 5c5b350e0001
Untitled Example3:
value: '*5b35*'
- name: model
in: query
description: Partial / full Device model. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `AP4*` and `*P4*` match `AP43`). Suffix-only wildcards (e.g. `*43`) are not supported. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- AP43,AP4*
- AP43
- AP4*
- '*P4*'
examples:
Untitled Example1:
value: AP43,AP4*
Untitled Example2:
value: AP43
Untitled Example3:
value: AP4*
Untitled Example4:
value: '*P4*'
- name: name
in: query
description: Device name. Always a partial match (e.g. `london` will match `london-1`, `london-2`, `my-london-device`...). Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- name-a,name-b
- london
examples:
Untitled Example1:
value: name-a,name-b
Untitled Example2:
value: london
- name: site_id
in: query
description: Filter inventory results by site identifier. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
contentEncoding: uuid
examples:
- 4ac1dcf4-9d8b-7211-65c4-057819f0862b
examples:
Untitled Example2:
value: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
- name: serial
in: query
description: Device serial number. Partial match allowed with wildcard * (e.g. `*123*` will match `AB123CD`, `12345`, `XY123`). Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- AB123CD,*123*
- AB123CD
- '*123*'
examples:
Untitled Example1:
value: AB123CD,*123*
Untitled Example2:
value: AB123CD
Untitled Example3:
value: '*123*'
- name: magic
in: query
description: Device claim code (magic). Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- WVTFBLTNPXD23H2
- name: master
in: query
description: Filter inventory results by whether the device is the Virtual Chassis master
style: form
explode: true
schema:
type: string
examples:
- 'true'
- name: sku
in: query
description: Device SKU. Partial match allowed with wildcard * (e.g. `*2300*` will match `EX2300-F-12P`). Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- EX2300-F-12P,*2300*
- EX2300-F-12P
- '*2300*'
examples:
Untitled Example1:
value: EX2300-F-12P,*2300*
Untitled Example2:
value: EX2300-F-12P
Untitled Example3:
value: '*2300*'
- name: version
in: query
description: Device version. Partial match allowed with wildcard * (e.g. `2R3` will match `21.2R3-S3.5`). Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- 21.2R3-S3.5,*2R3*
- 21.2R3-S3.5
- '*2R3*'
examples:
Untitled Example1:
value: 21.2R3-S3.5,*2R3*
Untitled Example2:
value: 21.2R3-S3.5
Untitled Example3:
value: '*2R3*'
- name: status
in: query
description: 'Device status. enum: `connected`, `disconnected`. Accepts multiple comma-separated values.'
style: form
explode: true
schema:
type: string
examples:
- connected,disconnected
- name: text
in: query
description: Wildcards for name, mac, serial
style: form
explode: true
schema:
type: string
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/inventory_search'
- description: Paginated inventory search response
examples:
- limit: 1000
results:
- mac: f01c2df166e0
magic: WVTFBLTNPXD23H2
master: true
members:
- mac: f01c2df166e0
model: EX4300-48P
serial: PD3714460200
model: EX4300-48P
name: mist-wa-ex4300-VC
org_id: 9b853544-51e4-45fb-81ac-a442e4a111d0
serial: PD3714460200
site_id: 01dc141d-b6af-4baa-b00f-0e31ef954c4f
sku: EX4300-48P
status: disconnected
type: switch
vc_mac: f01c2df166e0
version: 21.4R3.5
total: 1
contentMediaType: application/json
examples:
Example:
value:
limit: 1000
results:
- mac: f01c2df166e0
magic: WVTFBLTNPXD23H2
master: true
members:
- mac: f01c2df166e0
model: EX4300-48P
serial: PD3714460200
model: EX4300-48P
name: mist-wa-ex4300-VC
org_id: 9b853544-51e4-45fb-81ac-a442e4a111d0
serial: PD3714460200
site_id: 01dc141d-b6af-4baa-b00f-0e31ef954c4f
sku: EX4300-48P
status: disconnected
type: switch
vc_mac: f01c2df166e0
version: 21.4R3.5
total: 1
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/inventory_search'
- description: Paginated inventory search response
examples:
- limit: 1000
results:
- mac: f01c2df166e0
magic: WVTFBLTNPXD23H2
master: true
members:
- mac: f01c2df166e0
model: EX4300-48P
serial: PD3714460200
model: EX4300-48P
name: mist-wa-ex4300-VC
org_id: 9b853544-51e4-45fb-81ac-a442e4a111d0
serial: PD3714460200
site_id: 01dc141d-b6af-4baa-b00f-0e31ef954c4f
sku: EX4300-48P
status: disconnected
type: switch
vc_mac: f01c2df166e0
version: 21.4R3.5
total: 1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
limit: 1000
results:
- mac: f01c2df166e0
magic: WVTFBLTNPXD23H2
master: true
members:
- mac: f01c2df166e0
model: EX4300-48P
serial: PD3714460200
model: EX4300-48P
name: mist-wa-ex4300-VC
org_id: 9b853544-51e4-45fb-81ac-a442e4a111d0
serial: PD3714460200
site_id: 01dc141d-b6af-4baa-b00f-0e31ef954c4f
sku: EX4300-48P
status: disconnected
type: switch
vc_mac: f01c2df166e0
version: 21.4R3.5
total: 1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/setting/jse/info:
get:
tags:
- Orgs Integration JSE
summary: getOrgJseInfo
description: Return the JSE organizations associated with the configured account. Use the returned organization names when selecting JSE provider options for secure edge tunnels.
operationId: getOrgJseInfo
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/account_jse_info'
- description: Linked Juniper Security Exchange account information
examples:
- cloud_name: devcentral.juniperclouds.net
org_names:
- Mist-Sys
- Mist-Eng
contentMediaType: application/json
examples:
Example:
value:
cloud_name: devcentral.juniperclouds.net
org_names:
- Mist-Sys
- Mist-Eng
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/account_jse_info'
- description: Linked Juniper Security Exchange account information
examples:
- cloud_name: devcentral.juniperclouds.net
org_names:
- Mist-Sys
- Mist-Eng
contentMediaType: application/vnd.api+json
examples:
Example:
value:
cloud_name: devcentral.juniperclouds.net
org_names:
- Mist-Sys
- Mist-Eng
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/setting/jse/setup:
delete:
tags:
- Orgs Integration JSE
summary: deleteOrgJseIntegration
description: Remove the JSE integration configuration from the organization.
operationId: deleteOrgJseIntegration
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Orgs Integration JSE
summary: getOrgJseIntegration
description: Return the JSE integration configuration, including the cloud hostname, integration username, and associated JSE organization names.
operationId: getOrgJseIntegration
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/account_jse_info'
- description: Linked Juniper Security Exchange account information
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/account_jse_info'
- description: Linked Juniper Security Exchange account information
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs Integration JSE
summary: setupOrgJseIntegration
description: Configure the JSE integration with the JSE cloud hostname and integration-user credentials. In JSE, use a custom role with read access to `service_location` and read-write access to site and IPsec profile APIs, then create and activate the integration user and service locations.
operationId: setupOrgJseIntegration
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/account_jse_config'
- examples:
- cloud_name: devcentral.juniperclouds.net
password: foryoureyesonly
username: john@abc.com
contentMediaType: application/json
examples:
Example:
value:
cloud_name: devcentral.juniperclouds.net
password: foryoureyesonly
username: john@abc.com
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/account_jse_info'
- description: Linked Juniper Security Exchange account information
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/account_jse_info'
- description: Linked Juniper Security Exchange account information
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/aamwprofiles:
get:
tags:
- Orgs Advanced Anti Malware Profiles
summary: listOrgAAMWProfiles
description: List organization-level Advanced Anti Malware profiles that define Sky ATP file verdict handling for this organization.
operationId: listOrgAAMWProfiles
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/aamw_profile'
description: List of Advanced Anti Malware profiles
examples:
- - categories:
- category: executable
hash_lookup_only: false
fallback_action: block
file_action: block
name: aamw-custom
verdict_threshold: 8
contentMediaType: application/json
examples:
Example:
value:
- categories:
- category: executable
hash_lookup_only: false
fallback_action: block
file_action: block
name: aamw-custom
verdict_threshold: 8
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/aamw_profile'
description: List of Advanced Anti Malware profiles
examples:
- - categories:
- category: executable
hash_lookup_only: false
fallback_action: block
file_action: block
name: aamw-custom
verdict_threshold: 8
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- categories:
- category: executable
hash_lookup_only: false
fallback_action: block
file_action: block
name: aamw-custom
verdict_threshold: 8
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs Advanced Anti Malware Profiles
summary: createOrgAAMWProfile
description: Create an organization-level Advanced Anti Malware profile with Sky ATP verdict threshold, fallback action, file action, and file-category rules.
operationId: createOrgAAMWProfile
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/aamw_profile'
- description: Request Body
examples:
- categories:
- category: executable
hash_lookup_only: false
fallback_action: block
file_action: block
name: aamw-custom
verdict_threshold: 8
contentMediaType: application/json
examples:
Example:
value:
categories:
- category: executable
hash_lookup_only: false
fallback_action: block
file_action: block
name: aamw-custom
verdict_threshold: 8
required: false
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/aamw_profile'
- description: Advanced Anti Malware profile that controls Sky ATP file verdict handling
examples:
- categories:
- category: executable
hash_lookup_only: false
fallback_action: block
file_action: block
name: aamw-custom
verdict_threshold: 8
contentMediaType: application/json
examples:
Example:
value:
categories:
- category: executable
hash_lookup_only: false
fallback_action: block
file_action: block
name: aamw-custom
verdict_threshold: 8
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/aamw_profile'
- description: Advanced Anti Malware profile that controls Sky ATP file verdict handling
examples:
- categories:
- category: executable
hash_lookup_only: false
fallback_action: block
file_action: block
name: aamw-custom
verdict_threshold: 8
contentMediaType: application/vnd.api+json
examples:
Example:
value:
categories:
- category: executable
hash_lookup_only: false
fallback_action: block
file_action: block
name: aamw-custom
verdict_threshold: 8
application/vnd.json+api:
schema:
allOf:
- $ref: '#/components/schemas/aamw_profile'
- description: Advanced Anti Malware profile that controls Sky ATP file verdict handling
examples:
- aamwprofile_id: 000000ab-00ab-00ab-00ab-0000000000ab
account_id: iojzXIJWEuiD73ZvydOfg
admin_id: 000000ab-00ab-00ab-00ab-0000000000ab
created_at: 2023-01-01T12:00:00Z
description: Example AAMW Profile Description
name: Example AAMW Profile
updated_at: 2023-01-01T12:00:00Z
contentMediaType: application/vnd.json+api
examples:
Example:
value:
aamwprofile_id: 000000ab-00ab-00ab-00ab-0000000000ab
account_id: iojzXIJWEuiD73ZvydOfg
admin_id: 000000ab-00ab-00ab-00ab-0000000000ab
created_at: 2023-01-01T12:00:00Z
description: Example AAMW Profile Description
name: Example AAMW Profile
updated_at: 2023-01-01T12:00:00Z
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/aamwprofiles/{aamwprofile_id}:
delete:
tags:
- Orgs Advanced Anti Malware Profiles
summary: deleteOrgAAMWProfile
description: Delete an Advanced Anti Malware profile from this organization.
operationId: deleteOrgAAMWProfile
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: aamwprofile_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Orgs Advanced Anti Malware Profiles
summary: getOrgAAMWProfile
description: Return an organization Advanced Anti Malware profile, including verdict threshold, actions, and file-category rules.
operationId: getOrgAAMWProfile
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: aamwprofile_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/aamw_profile'
- description: Advanced Anti Malware profile that controls Sky ATP file verdict handling
examples:
- categories:
- category: executable
hash_lookup_only: false
fallback_action: block
file_action: block
name: aamw-custom
verdict_threshold: 8
contentMediaType: application/json
examples:
Example:
value:
categories:
- category: executable
hash_lookup_only: false
fallback_action: block
file_action: block
name: aamw-custom
verdict_threshold: 8
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/aamw_profile'
- description: Advanced Anti Malware profile that controls Sky ATP file verdict handling
examples:
- categories:
- category: executable
hash_lookup_only: false
fallback_action: block
file_action: block
name: aamw-custom
verdict_threshold: 8
contentMediaType: application/vnd.api+json
examples:
Example:
value:
categories:
- category: executable
hash_lookup_only: false
fallback_action: block
file_action: block
name: aamw-custom
verdict_threshold: 8
application/vnd.json+api:
schema:
allOf:
- $ref: '#/components/schemas/aamw_profile'
- description: Advanced Anti Malware profile that controls Sky ATP file verdict handling
examples:
- aamwprofile_id: 000000ab-00ab-00ab-00ab-0000000000ab
account_id: iojzXIJWEuiD73ZvydOfg
admin_id: 000000ab-00ab-00ab-00ab-0000000000ab
created_at: 2023-01-01T12:00:00Z
description: Example AAMW Profile Description
name: Example AAMW Profile
updated_at: 2023-01-01T12:00:00Z
contentMediaType: application/vnd.json+api
examples:
Example:
value:
aamwprofile_id: 000000ab-00ab-00ab-00ab-0000000000ab
account_id: iojzXIJWEuiD73ZvydOfg
admin_id: 000000ab-00ab-00ab-00ab-0000000000ab
created_at: 2023-01-01T12:00:00Z
description: Example AAMW Profile Description
name: Example AAMW Profile
updated_at: 2023-01-01T12:00:00Z
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Orgs Advanced Anti Malware Profiles
summary: updateOrgAAMWProfile
description: Update an organization Advanced Anti Malware profile's Sky ATP verdict threshold, actions, or file-category rules.
operationId: updateOrgAAMWProfile
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: aamwprofile_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/aamw_profile'
- description: Request Body
examples:
- categories:
- category: executable
hash_lookup_only: false
fallback_action: block
file_action: block
name: aamw-custom
verdict_threshold: 8
contentMediaType: application/json
examples:
Example:
value:
categories:
- category: executable
hash_lookup_only: false
fallback_action: block
file_action: block
name: aamw-custom
verdict_threshold: 8
required: false
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/aamw_profile'
- description: Advanced Anti Malware profile that controls Sky ATP file verdict handling
examples:
- categories:
- category: executable
hash_lookup_only: false
fallback_action: block
file_action: block
name: aamw-custom
verdict_threshold: 8
contentMediaType: application/json
examples:
Example:
value:
categories:
- category: executable
hash_lookup_only: false
fallback_action: block
file_action: block
name: aamw-custom
verdict_threshold: 8
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/aamw_profile'
- description: Advanced Anti Malware profile that controls Sky ATP file verdict handling
examples:
- categories:
- category: executable
hash_lookup_only: false
fallback_action: block
file_action: block
name: aamw-custom
verdict_threshold: 8
contentMediaType: application/vnd.api+json
examples:
Example:
value:
categories:
- category: executable
hash_lookup_only: false
fallback_action: block
file_action: block
name: aamw-custom
verdict_threshold: 8
application/vnd.json+api:
schema:
allOf:
- $ref: '#/components/schemas/aamw_profile'
- description: Advanced Anti Malware profile that controls Sky ATP file verdict handling
examples:
- aamwprofile_id: 000000ab-00ab-00ab-00ab-0000000000ab
account_id: iojzXIJWEuiD73ZvydOfg
admin_id: 000000ab-00ab-00ab-00ab-0000000000ab
created_at: 2023-01-01T12:00:00Z
description: Example AAMW Profile Description
name: Example AAMW Profile
updated_at: 2023-01-01T12:00:00Z
contentMediaType: application/vnd.json+api
examples:
Example:
value:
aamwprofile_id: 000000ab-00ab-00ab-00ab-0000000000ab
account_id: iojzXIJWEuiD73ZvydOfg
admin_id: 000000ab-00ab-00ab-00ab-0000000000ab
created_at: 2023-01-01T12:00:00Z
description: Example AAMW Profile Description
name: Example AAMW Profile
updated_at: 2023-01-01T12:00:00Z
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/setting/skyatp/secintel_allowlist:
put:
tags:
- Orgs Integration SkyATP
summary: udpateOrgAtpAllowedList
description: Update the Sky ATP SecIntel allowlist with domain and IP address entries for the organization.
operationId: udpateOrgAtpAllowedList
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/skyatp_list'
- examples:
- domains:
- comment: restricted
value: unsafe.xxx
ips:
- comment: nas
value: 10.1.3.5
contentMediaType: application/json
examples:
Example:
value:
domains:
- comment: restricted
value: unsafe.xxx
ips:
- comment: nas
value: 10.1.3.5
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/skyatp_list'
- description: Sky ATP SecIntel allowlist or blocklist entries
examples:
- domains:
- comment: restricted
value: unsafe.xxx
ips:
- comment: nas
value: 10.1.3.5
contentMediaType: application/json
examples:
Example:
value:
domains:
- comment: restricted
value: unsafe.xxx
ips:
- comment: nas
value: 10.1.3.5
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/skyatp_list'
- description: Sky ATP SecIntel allowlist or blocklist entries
examples:
- domains:
- comment: restricted
value: unsafe.xxx
ips:
- comment: nas
value: 10.1.3.5
contentMediaType: application/vnd.api+json
examples:
Example:
value:
domains:
- comment: restricted
value: unsafe.xxx
ips:
- comment: nas
value: 10.1.3.5
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/setting/skyatp/secintel_blocklist:
put:
tags:
- Orgs Integration SkyATP
summary: udpateOrgAtpBlockedList
description: Update the Sky ATP SecIntel blocklist with domain and IP address entries for the organization.
operationId: udpateOrgAtpBlockedList
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/skyatp_list'
- examples:
- domains:
- comment: restricted
value: unsafe.xxx
ips:
- comment: nas
value: 10.1.3.5
contentMediaType: application/json
examples:
Example:
value:
domains:
- comment: restricted
value: unsafe.xxx
ips:
- comment: nas
value: 10.1.3.5
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/skyatp_list'
- description: Sky ATP SecIntel allowlist or blocklist entries
examples:
- domains:
- comment: restricted
value: unsafe.xxx
ips:
- comment: nas
value: 10.1.3.5
contentMediaType: application/json
examples:
Example:
value:
domains:
- comment: restricted
value: unsafe.xxx
ips:
- comment: nas
value: 10.1.3.5
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/skyatp_list'
- description: Sky ATP SecIntel allowlist or blocklist entries
examples:
- domains:
- comment: restricted
value: unsafe.xxx
ips:
- comment: nas
value: 10.1.3.5
contentMediaType: application/vnd.api+json
examples:
Example:
value:
domains:
- comment: restricted
value: unsafe.xxx
ips:
- comment: nas
value: 10.1.3.5
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/setting/skyatp/setup:
delete:
tags:
- Orgs Integration SkyATP
summary: deleteOrgSkyAtpIntegration
description: Remove the Sky ATP integration configuration from the organization.
operationId: deleteOrgSkyAtpIntegration
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Orgs Integration SkyATP
summary: getOrgSkyAtpIntegration
description: Return the Sky ATP integration configuration, including linked realm information and generated SecIntel allowlist and blocklist URLs.
operationId: getOrgSkyAtpIntegration
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/account_skyatp_data'
- description: Sky ATP SecIntel feed data and generated list URLs
examples:
- Example:
value:
secintel:
third_party_threat_feeds:
- block_list
secintel_allowlist_url: https://papi.s3.amazonaws.com/secintel_allowlist/xxx...
secintel_blocklist_url: https://papi.s3.amazonaws.com/secintel_blocklist/xxx...
contentMediaType: application/json
example:
Example:
value:
secintel:
third_party_threat_feeds:
- block_list
secintel_allowlist_url: https://papi.s3.amazonaws.com/secintel_allowlist/xxx...
secintel_blocklist_url: https://papi.s3.amazonaws.com/secintel_blocklist/xxx...
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/account_skyatp_data'
- description: Sky ATP SecIntel feed data and generated list URLs
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs Integration SkyATP
summary: setupOrgAtpIntegration
description: Configure the Sky ATP integration by linking or creating the Sky ATP realm with the supplied cloud, realm, username, and password. The integration enables Security Intelligence and Advanced Anti-Malware features, with SecIntel configuration for command-and-control, DNS feeds, infected hosts, blocklists, and allowlists.
operationId: setupOrgAtpIntegration
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/account_skyatp_config'
- examples:
- cloud_name: www.amerskyatp.com
password: foryoureyesonly
realm: mist-team
username: john@abc.com
contentMediaType: application/json
examples:
Example:
value:
cloud_name: www.amerskyatp.com
password: foryoureyesonly
realm: mist-team
username: john@abc.com
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/account_skyatp_data'
- description: Sky ATP SecIntel feed data and generated list URLs
examples:
- Example:
value:
secintel:
third_party_threat_feeds:
- block_list
secintel_allowlist_url: https://papi.s3.amazonaws.com/secintel_allowlist/xxx...
secintel_blocklist_url: https://papi.s3.amazonaws.com/secintel_blocklist/xxx...
contentMediaType: application/json
example:
Example:
value:
secintel:
third_party_threat_feeds:
- block_list
secintel_allowlist_url: https://papi.s3.amazonaws.com/secintel_allowlist/xxx...
secintel_blocklist_url: https://papi.s3.amazonaws.com/secintel_blocklist/xxx...
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/account_skyatp_data'
- description: Sky ATP SecIntel feed data and generated list URLs
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Orgs Integration SkyATP
summary: udpateOrgAtpIntegration
description: Update Sky ATP SecIntel feed configuration, including the third-party threat feeds enabled for the organization.
operationId: udpateOrgAtpIntegration
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/account_skyatp_data'
- examples:
- secintel:
third_party_threat_feeds:
- block_list
contentMediaType: application/json
examples:
Example:
value:
secintel:
third_party_threat_feeds:
- block_list
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/account_skyatp_info'
- description: Linked Sky ATP account and realm information
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/account_skyatp_info'
- description: Linked Sky ATP account and realm information
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/jsi/devices:
get:
tags:
- Orgs JSI
summary: listOrgJsiDevices
description: List organization devices connected to Juniper Support Insights (JSI), optionally filtered by model, serial number, or MAC address.
operationId: listOrgJsiDevices
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
- name: model
in: query
description: Filter results by device model
style: form
explode: true
schema:
type: string
examples:
- AP43
- name: serial
in: query
description: Filter results by device serial number
style: form
explode: true
schema:
type: string
examples:
- FXLH2015150025
- name: mac
in: query
description: Filter results by MAC address
style: form
explode: true
schema:
type: string
examples:
- 5c5b350e0001
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/jse_device'
description: JSE devices returned for an organization
examples:
- - ext_ip: 73.92.124.103
last_seen: 1654636867
mac: c15353123096
model: EX2300-C-12P
serial: DGCOO0015
contentMediaType: application/json
examples:
Example:
value:
- ext_ip: 73.92.124.103
last_seen: 1654636867
mac: c15353123096
model: EX2300-C-12P
serial: DGCOO0015
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/jse_device'
description: JSE devices returned for an organization
examples:
- - ext_ip: 73.92.124.103
last_seen: 1654636867
mac: c15353123096
model: EX2300-C-12P
serial: DGCOO0015
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- ext_ip: 73.92.124.103
last_seen: 1654636867
mac: c15353123096
model: EX2300-C-12P
serial: DGCOO0015
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/jsi/devices/outbound_ssh_cmd:
get:
tags:
- Orgs JSI
summary: adoptOrgJsiDevice
description: Return the outbound SSH registration command used to onboard Junos devices to Juniper Support Insights (JSI).
operationId: adoptOrgJsiDevice
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_device_config_cmd'
- description: Device configuration command response
examples:
- cmd: >-
set system services ssh...
...
set system services outbound-ssh client mist ...
contentMediaType: application/json
examples:
Example:
value:
cmd: >-
set system services ssh...
...
set system services outbound-ssh client mist ...
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_device_config_cmd'
- description: Device configuration command response
examples:
- cmd: >-
set system services ssh...
...
set system services outbound-ssh client mist ...
contentMediaType: application/vnd.api+json
examples:
Example:
value:
cmd: >-
set system services ssh...
...
set system services outbound-ssh client mist ...
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/jsi/devices/{device_mac}/shell:
post:
tags:
- Orgs JSI
summary: createOrgJsiDeviceShellSession
description: Create a WebSocket-backed shell session for a JSI-connected device identified by MAC address.
operationId: createOrgJsiDeviceShellSession
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_mac
in: path
description: ''
required: true
schema:
pattern: ^[0-9a-fA-F]{12}$
type: string
examples:
- 0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session_with_url'
- description: Response containing a WebSocket session handle and connection URL
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session_with_url'
- description: Response containing a WebSocket session handle and connection URL
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/jsi/inventory:
get:
tags:
- Orgs JSI
summary: listOrgJsiPastPurchases
description: "This gets all devices purchased from the accounts associated with the Org \n * Fetch Install base devices for all linked accounts and associated account of the linked accounts. \n * The primary and the associated account ids will be queries from SFDC by passing the linked account \n * Returns only the device centric details of the Install base device. No customer specific information will be returned."
operationId: listOrgJsiPastPurchases
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
- name: model
in: query
description: Filter results by one or more device models. Supports comma-separated values
style: form
explode: true
schema:
type: string
examples:
- AP43
- name: serial
in: query
description: Filter results by device serial number
style: form
explode: true
schema:
type: string
examples:
- FXLH2015150025
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/js_inventory_item'
description: JSI inventory items returned for an organization
examples:
- - device_name: name1
end_of_sale_time: 1561507200
eos_time: 1672012800
master: true
model: EX2300-24MP
org_id: 6e843b41-f953-4af9-80e5-e1a70f65754a
serial: XN3123300095
sku: EX2300
status: connected
suggested_version: Latest 21.4R3-Sx
type: switch
version: 23.4R2-S4.11
version_eos_time: 1672012800
version_time: 1561507200
warranty: Enhanced Hardware Warranty
warranty_time: 1672012800
warranty_type: Enhanced Hardware Warranty
contentMediaType: application/json
examples:
Example:
value:
- device_name: name1
end_of_sale_time: 1561507200
eos_time: 1672012800
master: true
model: EX2300-24MP
org_id: 6e843b41-f953-4af9-80e5-e1a70f65754a
serial: XN3123300095
sku: EX2300
status: connected
suggested_version: Latest 21.4R3-Sx
type: switch
version: 23.4R2-S4.11
version_eos_time: 1672012800
version_time: 1561507200
warranty: Enhanced Hardware Warranty
warranty_time: 1672012800
warranty_type: Enhanced Hardware Warranty
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/js_inventory_item'
description: JSI inventory items returned for an organization
examples:
- - device_name: name1
end_of_sale_time: 1561507200
eos_time: 1672012800
master: true
model: EX2300-24MP
org_id: 6e843b41-f953-4af9-80e5-e1a70f65754a
serial: XN3123300095
sku: EX2300
status: connected
suggested_version: Latest 21.4R3-Sx
type: switch
version: 23.4R2-S4.11
version_eos_time: 1672012800
version_time: 1561507200
warranty: Enhanced Hardware Warranty
warranty_time: 1672012800
warranty_type: Enhanced Hardware Warranty
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- device_name: name1
end_of_sale_time: 1561507200
eos_time: 1672012800
master: true
model: EX2300-24MP
org_id: 6e843b41-f953-4af9-80e5-e1a70f65754a
serial: XN3123300095
sku: EX2300
status: connected
suggested_version: Latest 21.4R3-Sx
type: switch
version: 23.4R2-S4.11
version_eos_time: 1672012800
version_time: 1561507200
warranty: Enhanced Hardware Warranty
warranty_time: 1672012800
warranty_type: Enhanced Hardware Warranty
'400':
description: Bad Request - no Juniper Account Linked
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_detail_string'
- description: Response containing a human-readable detail message
examples:
- detail: no juniper account linked
contentMediaType: application/json
examples:
No Juniper Account Linked:
value:
detail: no juniper account linked
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_detail_string'
- description: Response containing a human-readable detail message
examples:
- detail: no juniper account linked
contentMediaType: application/vnd.api+json
examples:
No Juniper Account Linked:
value:
detail: no juniper account linked
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/jsi/inventory/count:
get:
tags:
- Orgs JSI
summary: countOrgJsiAssetsAndContracts
description: Count devices purchased from the accounts associated with the Org
operationId: countOrgJsiAssetsAndContracts
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field used to group this count response. enum: `account_id`, `claimed`, `has_support`, `end_of_sale_time`, `eos_time`, `version_time`, `model`, `sku`, `status`, `type`, `version`, `warranty_type`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/jsi_inventory_count_distinct'
- description: 'Field used to group this count response. enum: `account_id`, `claimed`, `has_support`, `end_of_sale_time`, `eos_time`, `version_time`, `model`, `sku`, `status`, `type`, `version`, `warranty_type`'
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Request - no Juniper Account Linked
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_detail_string'
- description: Response containing a human-readable detail message
examples:
- detail: no juniper account linked
contentMediaType: application/json
examples:
No Juniper Account Linked:
value:
detail: no juniper account linked
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_detail_string'
- description: Response containing a human-readable detail message
examples:
- detail: no juniper account linked
contentMediaType: application/vnd.api+json
examples:
No Juniper Account Linked:
value:
detail: no juniper account linked
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/jsi/inventory/search:
get:
tags:
- Orgs JSI
summary: searchOrgJsiAssetsAndContracts
description: "This gets all devices purchased from the accounts associated with the Org \n * Fetch Install base devices for all linked accounts and associated account of the linked accounts. \n * The primary and the associated account ids will be queries from SFDC by passing the linked account \n * Returns only the device centric details of the Install base device. No customer specific information will be returned."
operationId: searchOrgJsiAssetsAndContracts
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: claimed
in: query
description: Device claim status, `true` for claimed devices, `false` for all devices. Accepts multiple comma-separated boolean values.
style: form
explode: true
schema:
type: boolean
examples:
- 'true'
examples:
Untitled Example2:
value: true
- name: model
in: query
description: Filter results by device model. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- QFX10000-36Q,QFX10000-30C
- AP43
examples:
Untitled Example1:
value: QFX10000-36Q,QFX10000-30C
Untitled Example2:
value: AP43
- name: serial
in: query
description: Filter results by device serial number. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- ACNP4666,ACNP6969
- FXLH2015150025
examples:
Untitled Example1:
value: ACNP4666,ACNP6969
Untitled Example2:
value: FXLH2015150025
- name: sku
in: query
description: Filter results by SKU. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- QFX10000-36Q,QFX10000-30C
- EX2300
examples:
Untitled Example1:
value: QFX10000-36Q,QFX10000-30C
Untitled Example2:
value: EX2300
- name: status
in: query
description: 'Device status. enum: `all`, `connected`, `disconnected`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/device_status'
- description: 'Device status. enum: `all`, `connected`, `disconnected`'
- name: warranty_type
in: query
description: Device warranty type used to filter Juniper Support Insight inventory
style: form
explode: true
schema:
type: string
- name: end_of_sale_after
in: query
description: Filter devices with End Of Sale date after this date
style: form
explode: true
schema:
type: string
examples:
- 2024-01-01
- name: end_of_sale_before
in: query
description: Filter devices with End Of Sale date before this date
style: form
explode: true
schema:
type: string
examples:
- 2025-12-31
- name: eos_after
in: query
description: Filter devices with End Of Support date after this date
style: form
explode: true
schema:
type: string
examples:
- 2024-01-01
- name: eos_before
in: query
description: Filter devices with End Of Support date before this date
style: form
explode: true
schema:
type: string
examples:
- 2025-12-31
- name: version_eos_after
in: query
description: Filter devices with OS Version End Of Support date after this date
style: form
explode: true
schema:
type: string
examples:
- 2024-01-01
- name: version_eos_before
in: query
description: Filter devices with OS Version End Of Support date before this date
style: form
explode: true
schema:
type: string
examples:
- 2025-12-31
- name: contract_end_before
in: query
description: Filter results by service contract end date before this date
style: form
explode: true
schema:
type: string
examples:
- 2025-12-31
- name: contract_end_after
in: query
description: Filter results by service contract end date after this date
style: form
explode: true
schema:
type: string
examples:
- 2024-01-01
- name: contract_type
in: query
description: Filter results by contract type
style: form
explode: true
schema:
type: string
- name: contract_sku
in: query
description: Filter results by contract SKU
style: form
explode: true
schema:
type: string
- name: end_of_service_time
in: query
description: Filter results by end of service time
style: form
explode: true
schema:
type: string
- name: support_contract_status
in: query
description: Filter results by service contract status
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/support_contract_status'
- description: Filter results by service contract status
- name: has_support
in: query
description: Indicates if the device is covered under active support contract. Accepts multiple comma-separated boolean values.
style: form
explode: true
schema:
type: boolean
examples:
- 'true'
examples:
Untitled Example2:
value: true
- name: sirt_id
in: query
description: To get the onboarded devices that are affected by the SIRT ID
style: form
explode: true
schema:
type: string
examples:
- JSA12345
- name: pbn_id
in: query
description: To get the onboarded devices that are affected by the PBN ID
style: form
explode: true
schema:
type: string
examples:
- PBN67890
- name: text
in: query
description: Wildcard text search across `account_id`, `contract_id`, `contract_reseller`, `contract_sku`, `device_name`, `distributor`, `ia_address`, `ia_country`, `ia_region`, `ia_zip_postal`, `model`, `serial`, `sku`, `status`, `suggested_version`, `version`, `warranty`
style: form
explode: true
schema:
type: string
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/js_inventory_search'
- description: Paginated JSI inventory search response
examples:
- end: 1748023308
limit: 1000
results:
- availability: Yes
claimed: true
contract_end_date: 2028-10-01
contract_id: 324343-234
contract_reseller: Reseller1
contract_sku: EX2300-24MP-AFO
contract_start_date: 2022-09-01
contract_type: Maintenance
current_contract_flag: No Contract
device_name: name1
distributor: Dist
end_of_sale_time: 1561507200
end_of_service_time: 1661507200
eol_psn: TSB18097
eos_time: 1672012800
has_support: true
ia_address: Address1
ia_country: United States
ia_region: Rhode Island
ia_zip_postal: 02865-3749
master: true
model: EX2300-24MP
org_id: 6e843b41-f953-4af9-80e5-e1a70f65754a
serial: XN3123300095
service_contract_no: '16036705'
service_contract_type: MS
service_decline_flag: No
service_eligible: Yes
ship_date_calc: 2022-08-31
sku: EX2300
status: connected
suggested_version: Latest 21.4R3-Sx
support_contract_status: Active
type: switch
version: 23.4R2-S4.11
version_description: ''
version_eos_time: 1672012800
version_time: 1561507200
warranty: Enhanced Hardware Warranty
warranty_end: 2042-11-28
warranty_start: 2022-09-01
warranty_time: 1672012800
warranty_type: WTY00002
start: 1748019708
total: 1
contentMediaType: application/json
examples:
Example:
value:
end: 1748023308
limit: 1000
results:
- availability: Yes
claimed: true
contract_end_date: 2028-10-01
contract_id: 324343-234
contract_reseller: Reseller1
contract_sku: EX2300-24MP-AFO
contract_start_date: 2022-09-01
contract_type: Maintenance
current_contract_flag: No Contract
device_name: name1
distributor: Dist
end_of_sale_time: 1561507200
end_of_service_time: 1661507200
eol_psn: TSB18097
eos_time: 1672012800
has_support: true
ia_address: Address1
ia_country: United States
ia_region: Rhode Island
ia_zip_postal: 02865-3749
master: true
model: EX2300-24MP
org_id: 6e843b41-f953-4af9-80e5-e1a70f65754a
serial: XN3123300095
service_contract_no: '16036705'
service_contract_type: MS
service_decline_flag: No
service_eligible: Yes
ship_date_calc: 2022-08-31
sku: EX2300
status: connected
suggested_version: Latest 21.4R3-Sx
support_contract_status: Active
type: switch
version: 23.4R2-S4.11
version_description: ''
version_eos_time: 1672012800
version_time: 1561507200
warranty: Enhanced Hardware Warranty
warranty_end: 2042-11-28
warranty_start: 2022-09-01
warranty_time: 1672012800
warranty_type: WTY00002
start: 1748019708
total: 1
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/js_inventory_search'
- description: Paginated JSI inventory search response
examples:
- end: 1748023308
limit: 1000
results:
- availability: Yes
claimed: true
contract_end_date: 2028-10-01
contract_id: 324343-234
contract_reseller: Reseller1
contract_sku: EX2300-24MP-AFO
contract_start_date: 2022-09-01
contract_type: Maintenance
current_contract_flag: No Contract
device_name: name1
distributor: Dist
end_of_sale_time: 1561507200
end_of_service_time: 1661507200
eol_psn: TSB18097
eos_time: 1672012800
has_support: true
ia_address: Address1
ia_country: United States
ia_region: Rhode Island
ia_zip_postal: 02865-3749
master: true
model: EX2300-24MP
org_id: 6e843b41-f953-4af9-80e5-e1a70f65754a
serial: XN3123300095
service_contract_no: '16036705'
service_contract_type: MS
service_decline_flag: No
service_eligible: Yes
ship_date_calc: 2022-08-31
sku: EX2300
status: connected
suggested_version: Latest 21.4R3-Sx
support_contract_status: Active
type: switch
version: 23.4R2-S4.11
version_description: ''
version_eos_time: 1672012800
version_time: 1561507200
warranty: Enhanced Hardware Warranty
warranty_end: 2042-11-28
warranty_start: 2022-09-01
warranty_time: 1672012800
warranty_type: WTY00002
start: 1748019708
total: 1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 1748023308
limit: 1000
results:
- availability: Yes
claimed: true
contract_end_date: 2028-10-01
contract_id: 324343-234
contract_reseller: Reseller1
contract_sku: EX2300-24MP-AFO
contract_start_date: 2022-09-01
contract_type: Maintenance
current_contract_flag: No Contract
device_name: name1
distributor: Dist
end_of_sale_time: 1561507200
end_of_service_time: 1661507200
eol_psn: TSB18097
eos_time: 1672012800
has_support: true
ia_address: Address1
ia_country: United States
ia_region: Rhode Island
ia_zip_postal: 02865-3749
master: true
model: EX2300-24MP
org_id: 6e843b41-f953-4af9-80e5-e1a70f65754a
serial: XN3123300095
service_contract_no: '16036705'
service_contract_type: MS
service_decline_flag: No
service_eligible: Yes
ship_date_calc: 2022-08-31
sku: EX2300
status: connected
suggested_version: Latest 21.4R3-Sx
support_contract_status: Active
type: switch
version: 23.4R2-S4.11
version_description: ''
version_eos_time: 1672012800
version_time: 1561507200
warranty: Enhanced Hardware Warranty
warranty_end: 2042-11-28
warranty_start: 2022-09-01
warranty_time: 1672012800
warranty_type: WTY00002
start: 1748019708
total: 1
'400':
description: Bad Request - no Juniper Account Linked
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_detail_string'
- description: Response containing a human-readable detail message
examples:
- detail: no juniper account linked
contentMediaType: application/json
examples:
No Juniper Account Linked:
value:
detail: no juniper account linked
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_detail_string'
- description: Response containing a human-readable detail message
examples:
- detail: no juniper account linked
contentMediaType: application/vnd.api+json
examples:
No Juniper Account Linked:
value:
detail: no juniper account linked
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/jsi/pbn/count:
get:
tags:
- Orgs JSI
summary: countOrgJsiPbn
description: Get count of PBN advisories grouped by specified field
operationId: countOrgJsiPbn
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field to group by enum: `versions`, `models`, `customer_risk`, `bug_type`'
required: true
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/count_pbn_distinct'
- description: 'Field to group by enum: `versions`, `models`, `customer_risk`, `bug_type`'
examples:
- versions
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/jsi/pbn/search:
get:
tags:
- Orgs JSI
summary: searchOrgJsiPbn
description: Text search for PBN (Problem Bug Notification) advisories. Search can be done on versions, models, customer_risk, id, and bug_type fields.
operationId: searchOrgJsiPbn
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: versions
in: query
description: Software versions affected by the PBN
style: form
explode: true
schema:
type: string
examples:
- 20.4R3
- name: models
in: query
description: Models affected by the PBN
style: form
explode: true
schema:
type: string
- name: customer_risk
in: query
description: 'Filter results by customer risk. enum: `Critical`, `Major`, `Minor`'
style: form
explode: true
schema:
type: string
- name: id
in: query
description: ID of the PBN
style: form
explode: true
schema:
type: string
examples:
- '1403338'
- name: bug_type
in: query
description: Filter results by bug type
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/jsi_pbn_bug_type'
- description: Filter results by bug type
- name: text
in: query
description: Wildcard search across `versions`, `models`, `customer_risk`, `id`, `bug_type`
style: form
explode: true
schema:
type: string
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/jsi_pbn_search'
- description: Juniper Security Intelligence PBN search response with result metadata
examples:
- end: 1753415677
limit: 1
next: /api/v1/orgs/bf105f5e-2490-453b-9dc0-81224ca295cf/jsi/pbn/search?end=1753415677&limit=1&search_after=%5B%221403338%22%5D&start=1753412077
results:
- bug_type: Day-1
customer_risk: Major
id: '1403338'
introduced_in: ''
models:
- MX10008
- vMX
product_family:
- EX2200
- QFX5210
release_notes: In aggregated interfaces and STP (Spanning Tree Protocol) scenario, the STP does not work.
restoration: ''
title: The STP does not work when aggregated interfaces number is "ae1000"
versions:
- 23.4R2-S1.1
workaround: Use the 'ae' number from 0 to 999 in QFX5000 and 0 to 479 in other QFXs / EX under STP.
workaround_provided: yes
start: 1753412077
total: 604
contentMediaType: application/json
examples:
Example:
value:
end: 1753415677
limit: 1
next: /api/v1/orgs/bf105f5e-2490-453b-9dc0-81224ca295cf/jsi/pbn/search?end=1753415677&limit=1&search_after=%5B%221403338%22%5D&start=1753412077
results:
- bug_type: Day-1
customer_risk: Major
id: '1403338'
introduced_in: ''
models:
- MX10008
- vMX
product_family:
- EX2200
- QFX5210
release_notes: In aggregated interfaces and STP (Spanning Tree Protocol) scenario, the STP does not work.
restoration: ''
title: The STP does not work when aggregated interfaces number is "ae1000"
versions:
- 23.4R2-S1.1
workaround: Use the 'ae' number from 0 to 999 in QFX5000 and 0 to 479 in other QFXs / EX under STP.
workaround_provided: yes
start: 1753412077
total: 604
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/jsi_pbn_search'
- description: Juniper Security Intelligence PBN search response with result metadata
examples:
- end: 1753415677
limit: 1
next: /api/v1/orgs/bf105f5e-2490-453b-9dc0-81224ca295cf/jsi/pbn/search?end=1753415677&limit=1&search_after=%5B%221403338%22%5D&start=1753412077
results:
- bug_type: Day-1
customer_risk: Major
id: '1403338'
introduced_in: ''
models:
- MX10008
- vMX
product_family:
- EX2200
- QFX5210
release_notes: In aggregated interfaces and STP (Spanning Tree Protocol) scenario, the STP does not work.
restoration: ''
title: The STP does not work when aggregated interfaces number is "ae1000"
versions:
- 23.4R2-S1.1
workaround: Use the 'ae' number from 0 to 999 in QFX5000 and 0 to 479 in other QFXs / EX under STP.
workaround_provided: yes
start: 1753412077
total: 604
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 1753415677
limit: 1
next: /api/v1/orgs/bf105f5e-2490-453b-9dc0-81224ca295cf/jsi/pbn/search?end=1753415677&limit=1&search_after=%5B%221403338%22%5D&start=1753412077
results:
- bug_type: Day-1
customer_risk: Major
id: '1403338'
introduced_in: ''
models:
- MX10008
- vMX
product_family:
- EX2200
- QFX5210
release_notes: In aggregated interfaces and STP (Spanning Tree Protocol) scenario, the STP does not work.
restoration: ''
title: The STP does not work when aggregated interfaces number is "ae1000"
versions:
- 23.4R2-S1.1
workaround: Use the 'ae' number from 0 to 999 in QFX5000 and 0 to 479 in other QFXs / EX under STP.
workaround_provided: yes
start: 1753412077
total: 604
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/jsi/sirt/count:
get:
tags:
- Orgs JSI
summary: countOrgJsiSirt
description: Get count of SIRT advisories grouped by specified field
operationId: countOrgJsiSirt
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field to group by. enum: `jsa_updated_date`, `models`, `severity`, `versions`'
required: true
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/count_sirt_distinct'
- description: 'Field to group by. enum: `jsa_updated_date`, `models`, `severity`, `versions`'
examples:
- versions
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/jsi/sirt/search:
get:
tags:
- Orgs JSI
summary: searchOrgJsiSirt
description: Search and get all the SIRT for the onboarded devices. Search can be done on severity, id, updated_after, updated_before, published_after, published_before, models, versions, and text fields.
operationId: searchOrgJsiSirt
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: severity
in: query
description: Filter results by SIRT severity
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/jsi_sirt_severity'
- description: Filter results by SIRT severity
- name: id
in: query
description: JSA number
style: form
explode: true
schema:
type: string
examples:
- JSA100053
- name: updated_after
in: query
description: JSA Updated date to be filtered after this date
style: form
explode: true
schema:
type: string
- name: updated_before
in: query
description: JSA Updated date to be filtered before this date
style: form
explode: true
schema:
type: string
- name: published_after
in: query
description: JSA Published date to be filtered after this date
style: form
explode: true
schema:
type: string
- name: published_before
in: query
description: JSA Published date to be filtered before this date
style: form
explode: true
schema:
type: string
- name: models
in: query
description: Models affected by the SIRT
style: form
explode: true
schema:
type: string
- name: versions
in: query
description: Software versions affected by the SIRT
style: form
explode: true
schema:
type: string
examples:
- 20.4R3
- name: text
in: query
description: Wildcard search across `versions`, `models`, `severity`, `id`
style: form
explode: true
schema:
type: string
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/jsi_sirt_search'
- description: Juniper Security Intelligence SIRT search response with result metadata
examples:
- end: 1753411849
limit: 1
next: /api/v1/orgs/bf105f5e-2490-453b-9dc0-81224ca295cf/jsi/sirt/search?end=1753411849&limit=1&search_after=%5B%22JSA100053%22%5D&start=1753408249
results:
- cvss_score: 6.5
id: JSA100053
models:
- MX10008
- vMX
problem: >
An Improper Handling of Length Parameter Inconsistency vulnerability in the routing protocol daemon (rpd).
published_date: 1752019200
release_notes: An Improper Handling of Length Parameter Inconsistency vulnerability in the routing protocol daemon (rpd).
severity: Medium
solution: 'false'
title: 'Junos OS and Junos OS Evolved: In an EVPN environment, receipt of a specifically malformed BGP update causes RPD crash'
updated_date: 1752019200
versions:
- 23.4R2-S1.1
workaround: ''
start: 1753408249
total: 14
contentMediaType: application/json
examples:
Example:
value:
end: 1753411849
limit: 1
next: /api/v1/orgs/bf105f5e-2490-453b-9dc0-81224ca295cf/jsi/sirt/search?end=1753411849&limit=1&search_after=%5B%22JSA100053%22%5D&start=1753408249
results:
- cvss_score: 6.5
id: JSA100053
models:
- MX10008
- vMX
problem: >
An Improper Handling of Length Parameter Inconsistency vulnerability in the routing protocol daemon (rpd).
published_date: 1752019200
release_notes: An Improper Handling of Length Parameter Inconsistency vulnerability in the routing protocol daemon (rpd).
severity: Medium
solution: 'false'
title: 'Junos OS and Junos OS Evolved: In an EVPN environment, receipt of a specifically malformed BGP update causes RPD crash'
updated_date: 1752019200
versions:
- 23.4R2-S1.1
workaround: ''
start: 1753408249
total: 14
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/jsi_sirt_search'
- description: Juniper Security Intelligence SIRT search response with result metadata
examples:
- end: 1753411849
limit: 1
next: /api/v1/orgs/bf105f5e-2490-453b-9dc0-81224ca295cf/jsi/sirt/search?end=1753411849&limit=1&search_after=%5B%22JSA100053%22%5D&start=1753408249
results:
- cvss_score: 6.5
id: JSA100053
models:
- MX10008
- vMX
problem: >
An Improper Handling of Length Parameter Inconsistency vulnerability in the routing protocol daemon (rpd).
published_date: 1752019200
release_notes: An Improper Handling of Length Parameter Inconsistency vulnerability in the routing protocol daemon (rpd).
severity: Medium
solution: 'false'
title: 'Junos OS and Junos OS Evolved: In an EVPN environment, receipt of a specifically malformed BGP update causes RPD crash'
updated_date: 1752019200
versions:
- 23.4R2-S1.1
workaround: ''
start: 1753408249
total: 14
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 1753411849
limit: 1
next: /api/v1/orgs/bf105f5e-2490-453b-9dc0-81224ca295cf/jsi/sirt/search?end=1753411849&limit=1&search_after=%5B%22JSA100053%22%5D&start=1753408249
results:
- cvss_score: 6.5
id: JSA100053
models:
- MX10008
- vMX
problem: >
An Improper Handling of Length Parameter Inconsistency vulnerability in the routing protocol daemon (rpd).
published_date: 1752019200
release_notes: An Improper Handling of Length Parameter Inconsistency vulnerability in the routing protocol daemon (rpd).
severity: Medium
solution: 'false'
title: 'Junos OS and Junos OS Evolved: In an EVPN environment, receipt of a specifically malformed BGP update causes RPD crash'
updated_date: 1752019200
versions:
- 23.4R2-S1.1
workaround: ''
start: 1753408249
total: 14
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/claim:
post:
tags:
- Orgs Licenses
summary: claimOrgLicense
description: Synchronously claims licenses and/or inventory devices from an activation code. All inventory devices are claimed immediately during the request.
operationId: claimOrgLicense
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/claim_activation'
- description: Request Body
examples:
- code: ZHT3K-H36DT-MG85D-M61AC
type: all
contentMediaType: application/json
examples:
Example:
value:
code: ZHT3K-H36DT-MG85D-M61AC
type: all
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_claim_license'
- description: Result of claiming licenses or activation codes
examples:
- inventory_added:
- mac: 5c5b35000018
magic: 6JG8EPTFV2A9Z2N
model: AP41
serial: FXLH2015150025
type: ap
inventory_duplicated:
- mac: 5c5b35000012
magic: DVH4VSNMSZPDXBR
model: AP41
serial: FXLH2015150027
type: ap
inventory_pending:
- mac: 5c5b35000012
license_added:
- end: 1520380800
quantity: 180
start: 1504828800
type: SUB-MAN
- end: 1520380800
quantity: 120
start: 1504828800
type: SUB-LOC
license_duplicated:
- end: 1520380800
quantity: 180
start: 1504828800
type: SUB-MAN
license_error:
- order: '00000464'
reason: ''
contentMediaType: application/json
examples:
Licenses Successfully Claimed And Applied:
value:
inventory_added:
- mac: 5c5b35000018
magic: 6JG8EPTFV2A9Z2N
model: AP41
serial: FXLH2015150025
type: ap
inventory_duplicated:
- mac: 5c5b35000012
magic: DVH4VSNMSZPDXBR
model: AP41
serial: FXLH2015150027
type: ap
inventory_pending:
- mac: 5c5b35000012
license_added:
- end: 1520380800
quantity: 180
start: 1504828800
type: SUB-MAN
- end: 1520380800
quantity: 120
start: 1504828800
type: SUB-LOC
license_duplicated:
- end: 1520380800
quantity: 180
start: 1504828800
type: SUB-MAN
license_error:
- order: '00000464'
reason: ''
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_claim_license'
- description: Result of claiming licenses or activation codes
examples:
- inventory_added:
- mac: 5c5b35000018
magic: 6JG8EPTFV2A9Z2N
model: AP41
serial: FXLH2015150025
type: ap
inventory_duplicated:
- mac: 5c5b35000012
magic: DVH4VSNMSZPDXBR
model: AP41
serial: FXLH2015150027
type: ap
inventory_pending:
- mac: 5c5b35000012
license_added:
- end: 1520380800
quantity: 180
start: 1504828800
type: SUB-MAN
- end: 1520380800
quantity: 120
start: 1504828800
type: SUB-LOC
license_duplicated:
- end: 1520380800
quantity: 180
start: 1504828800
type: SUB-MAN
license_error:
- order: '00000464'
reason: ''
contentMediaType: application/vnd.api+json
examples:
Licenses Successfully Claimed And Applied:
value:
inventory_added:
- mac: 5c5b35000018
magic: 6JG8EPTFV2A9Z2N
model: AP41
serial: FXLH2015150025
type: ap
inventory_duplicated:
- mac: 5c5b35000012
magic: DVH4VSNMSZPDXBR
model: AP41
serial: FXLH2015150027
type: ap
inventory_pending:
- mac: 5c5b35000012
license_added:
- end: 1520380800
quantity: 180
start: 1504828800
type: SUB-MAN
- end: 1520380800
quantity: 120
start: 1504828800
type: SUB-LOC
license_duplicated:
- end: 1520380800
quantity: 180
start: 1504828800
type: SUB-MAN
license_error:
- order: '00000464'
reason: ''
'400':
description: Invalid key (or already used)
headers: {}
content: {}
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/claim/status:
get:
tags:
- Orgs Licenses
summary: GetOrgLicenseAsyncClaimStatus
description: Return processing status for an asynchronous organization license claim, optionally including per-device license details.
operationId: GetOrgLicenseAsyncClaimStatus
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: detail
in: query
description: Whether to include license details in the claim status response
style: form
explode: true
schema:
type: boolean
examples:
- true
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_async_license'
- description: Asynchronous license claim progress response
examples:
- completed:
- '000000000022'
- '000000000011'
details:
- mac: '000000000022'
status: added
timestamp: 1709598053
failed: 0
incompleted: []
processed: 2
scheduled_at: 1709598052
status: done
succeed: 2
timestamp: 1709598053
total: 2
contentMediaType: application/json
examples:
Example:
value:
completed:
- '000000000022'
- '000000000011'
details:
- mac: '000000000022'
status: added
timestamp: 1709598053
failed: 0
incompleted: []
processed: 2
scheduled_at: 1709598052
status: done
succeed: 2
timestamp: 1709598053
total: 2
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_async_license'
- description: Asynchronous license claim progress response
examples:
- completed:
- '000000000022'
- '000000000011'
details:
- mac: '000000000022'
status: added
timestamp: 1709598053
failed: 0
incompleted: []
processed: 2
scheduled_at: 1709598052
status: done
succeed: 2
timestamp: 1709598053
total: 2
contentMediaType: application/vnd.api+json
examples:
Example:
value:
completed:
- '000000000022'
- '000000000011'
details:
- mac: '000000000022'
status: added
timestamp: 1709598053
failed: 0
incompleted: []
processed: 2
scheduled_at: 1709598052
status: done
succeed: 2
timestamp: 1709598053
total: 2
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/claims:
get:
tags:
- Orgs Licenses
summary: listOrgAsyncClaims
description: List all async inventory claim jobs for the organization, optionally including per-device details per claim.
operationId: listOrgAsyncClaims
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: detail
in: query
description: Whether to include per-device detail in each claim record
style: form
explode: true
schema:
type: boolean
examples:
- true
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_async_claims_list'
- description: List of async inventory claim jobs for the organization
examples:
- '{"claims":[{"claim_id":"8e2a0c6f-6f3c-4c4e-9c72-8c5b1c1b6b9b","completed":["000000000022","000000000011"],"failed":0,"incompleted":[],"org_id":"44fe2c6b-7d7d-46e6-8d4f-5ce6a7c6b01a","processed":2,"scheduled_at":1709598052,"status":"done","succeed":2,"timestamp":1709598053,"total":2},{"claim_id":"3a7b6c1e-4e5a-4eaa-9c7f-9a9c62b7f402","completed":["000000000044"],"failed":0,"incompleted":["000000000033"],"org_id":"44fe2c6b-7d7d-46e6-8d4f-5ce6a7c6b01a","processed":1,"scheduled_at":1709598070,"status":"ongoing","succeed":1,"timestamp":1709598075,"total":2}]}'
- '{"claims":[{"claim_id":"8e2a0c6f-6f3c-4c4e-9c72-8c5b1c1b6b9b","completed":["000000000022","000000000011"],"details":[{"mac":"000000000022","status":"added","timestamp":1709598053},{"mac":"000000000011","status":"added","timestamp":1709598053}],"failed":0,"incompleted":[],"org_id":"44fe2c6b-7d7d-46e6-8d4f-5ce6a7c6b01a","processed":2,"scheduled_at":1709598052,"status":"done","succeed":2,"timestamp":1709598053,"total":2}]}'
contentMediaType: application/json
examples:
Detail False:
value:
claims:
- claim_id: 8e2a0c6f-6f3c-4c4e-9c72-8c5b1c1b6b9b
completed:
- '000000000022'
- '000000000011'
failed: 0
incompleted: []
org_id: 44fe2c6b-7d7d-46e6-8d4f-5ce6a7c6b01a
processed: 2
scheduled_at: 1709598052
status: done
succeed: 2
timestamp: 1709598053
total: 2
- claim_id: 3a7b6c1e-4e5a-4eaa-9c7f-9a9c62b7f402
completed:
- '000000000044'
failed: 0
incompleted:
- '000000000033'
org_id: 44fe2c6b-7d7d-46e6-8d4f-5ce6a7c6b01a
processed: 1
scheduled_at: 1709598070
status: ongoing
succeed: 1
timestamp: 1709598075
total: 2
Detail True:
value:
claims:
- claim_id: 8e2a0c6f-6f3c-4c4e-9c72-8c5b1c1b6b9b
completed:
- '000000000022'
- '000000000011'
details:
- mac: '000000000022'
status: added
timestamp: 1709598053
- mac: '000000000011'
status: added
timestamp: 1709598053
failed: 0
incompleted: []
org_id: 44fe2c6b-7d7d-46e6-8d4f-5ce6a7c6b01a
processed: 2
scheduled_at: 1709598052
status: done
succeed: 2
timestamp: 1709598053
total: 2
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_async_claims_list'
- description: List of async inventory claim jobs for the organization
examples:
- '{"claims":[{"claim_id":"8e2a0c6f-6f3c-4c4e-9c72-8c5b1c1b6b9b","completed":["000000000022","000000000011"],"failed":0,"incompleted":[],"org_id":"44fe2c6b-7d7d-46e6-8d4f-5ce6a7c6b01a","processed":2,"scheduled_at":1709598052,"status":"done","succeed":2,"timestamp":1709598053,"total":2},{"claim_id":"3a7b6c1e-4e5a-4eaa-9c7f-9a9c62b7f402","completed":["000000000044"],"failed":0,"incompleted":["000000000033"],"org_id":"44fe2c6b-7d7d-46e6-8d4f-5ce6a7c6b01a","processed":1,"scheduled_at":1709598070,"status":"ongoing","succeed":1,"timestamp":1709598075,"total":2}]}'
- '{"claims":[{"claim_id":"8e2a0c6f-6f3c-4c4e-9c72-8c5b1c1b6b9b","completed":["000000000022","000000000011"],"details":[{"mac":"000000000022","status":"added","timestamp":1709598053},{"mac":"000000000011","status":"added","timestamp":1709598053}],"failed":0,"incompleted":[],"org_id":"44fe2c6b-7d7d-46e6-8d4f-5ce6a7c6b01a","processed":2,"scheduled_at":1709598052,"status":"done","succeed":2,"timestamp":1709598053,"total":2}]}'
contentMediaType: application/vnd.api+json
examples:
Detail False:
value:
claims:
- claim_id: 8e2a0c6f-6f3c-4c4e-9c72-8c5b1c1b6b9b
completed:
- '000000000022'
- '000000000011'
failed: 0
incompleted: []
org_id: 44fe2c6b-7d7d-46e6-8d4f-5ce6a7c6b01a
processed: 2
scheduled_at: 1709598052
status: done
succeed: 2
timestamp: 1709598053
total: 2
- claim_id: 3a7b6c1e-4e5a-4eaa-9c7f-9a9c62b7f402
completed:
- '000000000044'
failed: 0
incompleted:
- '000000000033'
org_id: 44fe2c6b-7d7d-46e6-8d4f-5ce6a7c6b01a
processed: 1
scheduled_at: 1709598070
status: ongoing
succeed: 1
timestamp: 1709598075
total: 2
Detail True:
value:
claims:
- claim_id: 8e2a0c6f-6f3c-4c4e-9c72-8c5b1c1b6b9b
completed:
- '000000000022'
- '000000000011'
details:
- mac: '000000000022'
status: added
timestamp: 1709598053
- mac: '000000000011'
status: added
timestamp: 1709598053
failed: 0
incompleted: []
org_id: 44fe2c6b-7d7d-46e6-8d4f-5ce6a7c6b01a
processed: 2
scheduled_at: 1709598052
status: done
succeed: 2
timestamp: 1709598053
total: 2
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs Licenses
summary: createOrgAsyncClaim
description: >-
Schedules an async claim for inventory devices. Inventory claiming is queued and processed in the background; the response returns immediately with a `claim_id` for polling. Licenses (if `type=all`) are still claimed synchronously during the request.
Use `GET /api/v1/orgs/{org_id}/claims/{claim_id}` to poll the result.
operationId: createOrgAsyncClaim
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/claim_activation_async'
- description: Request Body
examples:
- code: ZHT3K-H36DT-MG85D-M61AC
type: inventory
contentMediaType: application/json
examples:
Example:
value:
code: ZHT3K-H36DT-MG85D-M61AC
type: inventory
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_async_claim_create'
- description: Response to an async inventory claim request
examples:
- claim_id: 8e2a0c6f-6f3c-4c4e-9c72-8c5b1c1b6b9b
inventory_pending:
- mac: 5c5b35000012
- mac: 5c5b35000018
contentMediaType: application/json
examples:
Example:
value:
claim_id: 8e2a0c6f-6f3c-4c4e-9c72-8c5b1c1b6b9b
inventory_pending:
- mac: 5c5b35000012
- mac: 5c5b35000018
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_async_claim_create'
- description: Response to an async inventory claim request
examples:
- claim_id: 8e2a0c6f-6f3c-4c4e-9c72-8c5b1c1b6b9b
inventory_pending:
- mac: 5c5b35000012
- mac: 5c5b35000018
contentMediaType: application/vnd.api+json
examples:
Example:
value:
claim_id: 8e2a0c6f-6f3c-4c4e-9c72-8c5b1c1b6b9b
inventory_pending:
- mac: 5c5b35000012
- mac: 5c5b35000018
'400':
description: Invalid key (or already used)
headers: {}
content: {}
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/claims/{claim_id}:
get:
tags:
- Orgs Licenses
summary: getOrgAsyncClaimStatus
description: Return the processing status for a specific async inventory claim job, optionally including per-device details.
operationId: getOrgAsyncClaimStatus
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: claim_id
in: path
description: Unique identifier of the async claim job
required: true
schema:
type: string
contentEncoding: uuid
- name: detail
in: query
description: Whether to include per-device detail in the claim status response
style: form
explode: true
schema:
type: boolean
examples:
- true
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_async_claim_status'
- description: Async inventory claim job status
examples:
- claim_id: 8e2a0c6f-6f3c-4c4e-9c72-8c5b1c1b6b9b
completed:
- '000000000022'
- '000000000011'
details:
- mac: '000000000022'
status: added
timestamp: 1709598053
- mac: '000000000011'
status: added
timestamp: 1709598053
failed: 0
incompleted: []
org_id: 44fe2c6b-7d7d-46e6-8d4f-5ce6a7c6b01a
processed: 2
scheduled_at: 1709598052
status: done
succeed: 2
timestamp: 1709598053
total: 2
contentMediaType: application/json
examples:
Example:
value:
claim_id: 8e2a0c6f-6f3c-4c4e-9c72-8c5b1c1b6b9b
completed:
- '000000000022'
- '000000000011'
details:
- mac: '000000000022'
status: added
timestamp: 1709598053
- mac: '000000000011'
status: added
timestamp: 1709598053
failed: 0
incompleted: []
org_id: 44fe2c6b-7d7d-46e6-8d4f-5ce6a7c6b01a
processed: 2
scheduled_at: 1709598052
status: done
succeed: 2
timestamp: 1709598053
total: 2
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_async_claim_status'
- description: Async inventory claim job status
examples:
- claim_id: 8e2a0c6f-6f3c-4c4e-9c72-8c5b1c1b6b9b
completed:
- '000000000022'
- '000000000011'
details:
- mac: '000000000022'
status: added
timestamp: 1709598053
- mac: '000000000011'
status: added
timestamp: 1709598053
failed: 0
incompleted: []
org_id: 44fe2c6b-7d7d-46e6-8d4f-5ce6a7c6b01a
processed: 2
scheduled_at: 1709598052
status: done
succeed: 2
timestamp: 1709598053
total: 2
contentMediaType: application/vnd.api+json
examples:
Example:
value:
claim_id: 8e2a0c6f-6f3c-4c4e-9c72-8c5b1c1b6b9b
completed:
- '000000000022'
- '000000000011'
details:
- mac: '000000000022'
status: added
timestamp: 1709598053
- mac: '000000000011'
status: added
timestamp: 1709598053
failed: 0
incompleted: []
org_id: 44fe2c6b-7d7d-46e6-8d4f-5ce6a7c6b01a
processed: 2
scheduled_at: 1709598052
status: done
succeed: 2
timestamp: 1709598053
total: 2
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/licenses:
get:
tags:
- Orgs Licenses
summary: getOrgLicensesSummary
description: Return the organization license entitlement, subscription, amendment, consumption, and available-license summary.
operationId: getOrgLicensesSummary
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/license'
- description: Organization license entitlement, subscription, and usage summary
examples:
- amendments:
- created_time: 1644684842
end_time: 1744156799
id: ff0a14f6-1234-5678-90ab-c8e64d4bc6c6
modified_time: 1644684842
quantity: -1
start_time: 1632873600
subscription_id: VNA-000000af
type: SUB-VNA
- created_time: 1644684842
end_time: 1744156799
id: c1c28812-1234-5678-90ab-dc95680da61e
modified_time: 1644684842
quantity: -1
start_time: 1632873600
subscription_id: MAN-000008be
type: SUB-MAN
- created_time: 1644684842
end_time: 1744243199
id: 96c0a41f-1234-5678-90ab-afe74817e9fd
modified_time: 1644684842
quantity: -1
start_time: 1586476800
subscription_id: EX24-000000bc
type: SUB-EX24
entitled:
SUB-ENG: 26
SUB-EX24: 9
SUB-MAN: 26
SUB-VNA: 26
licenses:
- created_time: 1555353534
end_time: 1586822399
id: 693a41a6-1234-5678-90ab-f53dbd3a31c0
modified_time: 1555353534
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 2
remaining_quantity: 0
start_time: 1555286400
subscription_id: VNA-000000aa
type: SUB-VNA
- created_time: 1576132516
end_time: 1586822399
id: 656607cf-1234-5678-90ab-fc9035614ea5
modified_time: 1576132516
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 8
remaining_quantity: 0
start_time: 1576022400
subscription_id: VNA-000000ab
type: SUB-VNA
- created_time: 1579204568
end_time: 1730764800
id: db50d0bc-1234-5678-90ab-e439958cb06b
modified_time: 1579204568
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 2
remaining_quantity: 2
start_time: 1572998400
subscription_id: MAN-000000ac
type: SUB-MAN
- created_time: 1579204568
end_time: 1730764800
id: 2ff9e84a-1234-5678-90ab-fb9ec0726e01
modified_time: 1579204568
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 2
remaining_quantity: 2
start_time: 1572998400
subscription_id: ENG-000000ad
type: SUB-ENG
- created_time: 1579204568
end_time: 1730764800
id: 16df7ea6-1234-5678-90ab-78018cd4024d
modified_time: 1579204568
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 2
remaining_quantity: 2
start_time: 1572998400
subscription_id: VNA-000000ae
type: SUB-VNA
- created_time: 1586237081
end_time: 1744243199
id: 1b6f68d5-1234-5678-90ab-70d3e6d18c73
modified_time: 1586237081
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 14
remaining_quantity: 14
start_time: 1586563200
subscription_id: VNA-000000af
type: SUB-VNA
- created_time: 1586237097
end_time: 1744243199
id: 1375c9bf-1234-5678-90ab-9c636708c89e
modified_time: 1586237097
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 14
remaining_quantity: 14
start_time: 1586563200
subscription_id: MAN-000000ba
type: SUB-MAN
- created_time: 1586237137
end_time: 1744243199
id: 5974e979-1234-5678-90ab-438f833ec1c9
modified_time: 1586237137
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 14
remaining_quantity: 14
start_time: 1586563200
subscription_id: ENG-000000bb
type: SUB-ENG
- created_time: 1629947267
end_time: 1744243199
id: 340a9cb3-1234-5678-90ab-b009344dbf3c
modified_time: 1629947267
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 10
remaining_quantity: 9
start_time: 1586476800
subscription_id: EX24-000000bc
type: SUB-EX24
- created_time: 1632941870
end_time: 1744156799
id: 9b599b0f-1234-5678-90ab-406081b58e7f
modified_time: 1632941870
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 10
remaining_quantity: 10
start_time: 1632873600
subscription_id: ENG-000000bd
type: SUB-ENG
- created_time: 1632941882
end_time: 1744156799
id: d6d8ead3-1234-5678-90ab-98badeac7287
modified_time: 1632941882
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 11
remaining_quantity: 9
start_time: 1632873600
subscription_id: MAN-000008be
type: SUB-MAN
summary:
SUB-ENG: 18
SUB-EX24: 3
SUB-MAN: 22
SUB-VNA: 20
contentMediaType: application/json
examples:
Example:
value:
amendments:
- created_time: 1644684842
end_time: 1744156799
id: ff0a14f6-1234-5678-90ab-c8e64d4bc6c6
modified_time: 1644684842
quantity: -1
start_time: 1632873600
subscription_id: VNA-000000af
type: SUB-VNA
- created_time: 1644684842
end_time: 1744156799
id: c1c28812-1234-5678-90ab-dc95680da61e
modified_time: 1644684842
quantity: -1
start_time: 1632873600
subscription_id: MAN-000008be
type: SUB-MAN
- created_time: 1644684842
end_time: 1744243199
id: 96c0a41f-1234-5678-90ab-afe74817e9fd
modified_time: 1644684842
quantity: -1
start_time: 1586476800
subscription_id: EX24-000000bc
type: SUB-EX24
entitled:
SUB-ENG: 26
SUB-EX24: 9
SUB-MAN: 26
SUB-VNA: 26
licenses:
- created_time: 1555353534
end_time: 1586822399
id: 693a41a6-1234-5678-90ab-f53dbd3a31c0
modified_time: 1555353534
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 2
remaining_quantity: 0
start_time: 1555286400
subscription_id: VNA-000000aa
type: SUB-VNA
- created_time: 1576132516
end_time: 1586822399
id: 656607cf-1234-5678-90ab-fc9035614ea5
modified_time: 1576132516
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 8
remaining_quantity: 0
start_time: 1576022400
subscription_id: VNA-000000ab
type: SUB-VNA
- created_time: 1579204568
end_time: 1730764800
id: db50d0bc-1234-5678-90ab-e439958cb06b
modified_time: 1579204568
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 2
remaining_quantity: 2
start_time: 1572998400
subscription_id: MAN-000000ac
type: SUB-MAN
- created_time: 1579204568
end_time: 1730764800
id: 2ff9e84a-1234-5678-90ab-fb9ec0726e01
modified_time: 1579204568
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 2
remaining_quantity: 2
start_time: 1572998400
subscription_id: ENG-000000ad
type: SUB-ENG
- created_time: 1579204568
end_time: 1730764800
id: 16df7ea6-1234-5678-90ab-78018cd4024d
modified_time: 1579204568
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 2
remaining_quantity: 2
start_time: 1572998400
subscription_id: VNA-000000ae
type: SUB-VNA
- created_time: 1586237081
end_time: 1744243199
id: 1b6f68d5-1234-5678-90ab-70d3e6d18c73
modified_time: 1586237081
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 14
remaining_quantity: 14
start_time: 1586563200
subscription_id: VNA-000000af
type: SUB-VNA
- created_time: 1586237097
end_time: 1744243199
id: 1375c9bf-1234-5678-90ab-9c636708c89e
modified_time: 1586237097
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 14
remaining_quantity: 14
start_time: 1586563200
subscription_id: MAN-000000ba
type: SUB-MAN
- created_time: 1586237137
end_time: 1744243199
id: 5974e979-1234-5678-90ab-438f833ec1c9
modified_time: 1586237137
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 14
remaining_quantity: 14
start_time: 1586563200
subscription_id: ENG-000000bb
type: SUB-ENG
- created_time: 1629947267
end_time: 1744243199
id: 340a9cb3-1234-5678-90ab-b009344dbf3c
modified_time: 1629947267
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 10
remaining_quantity: 9
start_time: 1586476800
subscription_id: EX24-000000bc
type: SUB-EX24
- created_time: 1632941870
end_time: 1744156799
id: 9b599b0f-1234-5678-90ab-406081b58e7f
modified_time: 1632941870
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 10
remaining_quantity: 10
start_time: 1632873600
subscription_id: ENG-000000bd
type: SUB-ENG
- created_time: 1632941882
end_time: 1744156799
id: d6d8ead3-1234-5678-90ab-98badeac7287
modified_time: 1632941882
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 11
remaining_quantity: 9
start_time: 1632873600
subscription_id: MAN-000008be
type: SUB-MAN
summary:
SUB-ENG: 18
SUB-EX24: 3
SUB-MAN: 22
SUB-VNA: 20
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/license'
- description: Organization license entitlement, subscription, and usage summary
examples:
- amendments:
- created_time: 1644684842
end_time: 1744156799
id: ff0a14f6-1234-5678-90ab-c8e64d4bc6c6
modified_time: 1644684842
quantity: -1
start_time: 1632873600
subscription_id: VNA-000000af
type: SUB-VNA
- created_time: 1644684842
end_time: 1744156799
id: c1c28812-1234-5678-90ab-dc95680da61e
modified_time: 1644684842
quantity: -1
start_time: 1632873600
subscription_id: MAN-000008be
type: SUB-MAN
- created_time: 1644684842
end_time: 1744243199
id: 96c0a41f-1234-5678-90ab-afe74817e9fd
modified_time: 1644684842
quantity: -1
start_time: 1586476800
subscription_id: EX24-000000bc
type: SUB-EX24
entitled:
SUB-ENG: 26
SUB-EX24: 9
SUB-MAN: 26
SUB-VNA: 26
licenses:
- created_time: 1555353534
end_time: 1586822399
id: 693a41a6-1234-5678-90ab-f53dbd3a31c0
modified_time: 1555353534
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 2
remaining_quantity: 0
start_time: 1555286400
subscription_id: VNA-000000aa
type: SUB-VNA
- created_time: 1576132516
end_time: 1586822399
id: 656607cf-1234-5678-90ab-fc9035614ea5
modified_time: 1576132516
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 8
remaining_quantity: 0
start_time: 1576022400
subscription_id: VNA-000000ab
type: SUB-VNA
- created_time: 1579204568
end_time: 1730764800
id: db50d0bc-1234-5678-90ab-e439958cb06b
modified_time: 1579204568
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 2
remaining_quantity: 2
start_time: 1572998400
subscription_id: MAN-000000ac
type: SUB-MAN
- created_time: 1579204568
end_time: 1730764800
id: 2ff9e84a-1234-5678-90ab-fb9ec0726e01
modified_time: 1579204568
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 2
remaining_quantity: 2
start_time: 1572998400
subscription_id: ENG-000000ad
type: SUB-ENG
- created_time: 1579204568
end_time: 1730764800
id: 16df7ea6-1234-5678-90ab-78018cd4024d
modified_time: 1579204568
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 2
remaining_quantity: 2
start_time: 1572998400
subscription_id: VNA-000000ae
type: SUB-VNA
- created_time: 1586237081
end_time: 1744243199
id: 1b6f68d5-1234-5678-90ab-70d3e6d18c73
modified_time: 1586237081
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 14
remaining_quantity: 14
start_time: 1586563200
subscription_id: VNA-000000af
type: SUB-VNA
- created_time: 1586237097
end_time: 1744243199
id: 1375c9bf-1234-5678-90ab-9c636708c89e
modified_time: 1586237097
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 14
remaining_quantity: 14
start_time: 1586563200
subscription_id: MAN-000000ba
type: SUB-MAN
- created_time: 1586237137
end_time: 1744243199
id: 5974e979-1234-5678-90ab-438f833ec1c9
modified_time: 1586237137
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 14
remaining_quantity: 14
start_time: 1586563200
subscription_id: ENG-000000bb
type: SUB-ENG
- created_time: 1629947267
end_time: 1744243199
id: 340a9cb3-1234-5678-90ab-b009344dbf3c
modified_time: 1629947267
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 10
remaining_quantity: 9
start_time: 1586476800
subscription_id: EX24-000000bc
type: SUB-EX24
- created_time: 1632941870
end_time: 1744156799
id: 9b599b0f-1234-5678-90ab-406081b58e7f
modified_time: 1632941870
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 10
remaining_quantity: 10
start_time: 1632873600
subscription_id: ENG-000000bd
type: SUB-ENG
- created_time: 1632941882
end_time: 1744156799
id: d6d8ead3-1234-5678-90ab-98badeac7287
modified_time: 1632941882
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 11
remaining_quantity: 9
start_time: 1632873600
subscription_id: MAN-000008be
type: SUB-MAN
summary:
SUB-ENG: 18
SUB-EX24: 3
SUB-MAN: 22
SUB-VNA: 20
contentMediaType: application/vnd.api+json
examples:
Example:
value:
amendments:
- created_time: 1644684842
end_time: 1744156799
id: ff0a14f6-1234-5678-90ab-c8e64d4bc6c6
modified_time: 1644684842
quantity: -1
start_time: 1632873600
subscription_id: VNA-000000af
type: SUB-VNA
- created_time: 1644684842
end_time: 1744156799
id: c1c28812-1234-5678-90ab-dc95680da61e
modified_time: 1644684842
quantity: -1
start_time: 1632873600
subscription_id: MAN-000008be
type: SUB-MAN
- created_time: 1644684842
end_time: 1744243199
id: 96c0a41f-1234-5678-90ab-afe74817e9fd
modified_time: 1644684842
quantity: -1
start_time: 1586476800
subscription_id: EX24-000000bc
type: SUB-EX24
entitled:
SUB-ENG: 26
SUB-EX24: 9
SUB-MAN: 26
SUB-VNA: 26
licenses:
- created_time: 1555353534
end_time: 1586822399
id: 693a41a6-1234-5678-90ab-f53dbd3a31c0
modified_time: 1555353534
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 2
remaining_quantity: 0
start_time: 1555286400
subscription_id: VNA-000000aa
type: SUB-VNA
- created_time: 1576132516
end_time: 1586822399
id: 656607cf-1234-5678-90ab-fc9035614ea5
modified_time: 1576132516
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 8
remaining_quantity: 0
start_time: 1576022400
subscription_id: VNA-000000ab
type: SUB-VNA
- created_time: 1579204568
end_time: 1730764800
id: db50d0bc-1234-5678-90ab-e439958cb06b
modified_time: 1579204568
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 2
remaining_quantity: 2
start_time: 1572998400
subscription_id: MAN-000000ac
type: SUB-MAN
- created_time: 1579204568
end_time: 1730764800
id: 2ff9e84a-1234-5678-90ab-fb9ec0726e01
modified_time: 1579204568
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 2
remaining_quantity: 2
start_time: 1572998400
subscription_id: ENG-000000ad
type: SUB-ENG
- created_time: 1579204568
end_time: 1730764800
id: 16df7ea6-1234-5678-90ab-78018cd4024d
modified_time: 1579204568
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 2
remaining_quantity: 2
start_time: 1572998400
subscription_id: VNA-000000ae
type: SUB-VNA
- created_time: 1586237081
end_time: 1744243199
id: 1b6f68d5-1234-5678-90ab-70d3e6d18c73
modified_time: 1586237081
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 14
remaining_quantity: 14
start_time: 1586563200
subscription_id: VNA-000000af
type: SUB-VNA
- created_time: 1586237097
end_time: 1744243199
id: 1375c9bf-1234-5678-90ab-9c636708c89e
modified_time: 1586237097
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 14
remaining_quantity: 14
start_time: 1586563200
subscription_id: MAN-000000ba
type: SUB-MAN
- created_time: 1586237137
end_time: 1744243199
id: 5974e979-1234-5678-90ab-438f833ec1c9
modified_time: 1586237137
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 14
remaining_quantity: 14
start_time: 1586563200
subscription_id: ENG-000000bb
type: SUB-ENG
- created_time: 1629947267
end_time: 1744243199
id: 340a9cb3-1234-5678-90ab-b009344dbf3c
modified_time: 1629947267
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 10
remaining_quantity: 9
start_time: 1586476800
subscription_id: EX24-000000bc
type: SUB-EX24
- created_time: 1632941870
end_time: 1744156799
id: 9b599b0f-1234-5678-90ab-406081b58e7f
modified_time: 1632941870
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 10
remaining_quantity: 10
start_time: 1632873600
subscription_id: ENG-000000bd
type: SUB-ENG
- created_time: 1632941882
end_time: 1744156799
id: d6d8ead3-1234-5678-90ab-98badeac7287
modified_time: 1632941882
order_id: '00000000'
org_id: 9777c1a0-1234-5678-90ab-02e208b2d34f
quantity: 11
remaining_quantity: 9
start_time: 1632873600
subscription_id: MAN-000008be
type: SUB-MAN
summary:
SUB-ENG: 18
SUB-EX24: 3
SUB-MAN: 22
SUB-VNA: 20
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Orgs Licenses
summary: moveOrDeleteOrgLicenseToAnotherOrg
description: "Move, Undo Move or Delete Org License to Another Org\nIf the admin has admin privilege against the `org_id` and `dst_org_id`, he can move some of the licenses to another Org. Given that: \n1. the specified license is currently active \n2. there’s enough licenses left in the specified license (by subscription_id) \n3. there will still be enough entitled licenses for the type of license after the amendment"
operationId: moveOrDeleteOrgLicenseToAnotherOrg
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/org_license_action'
- description: Request Body
examples:
- '{"notes":"customer notes","op":"annotate","subscription_id":"SUB-000144"}'
- '{"op":"delete","subscription_id":"SUB-0000144"}'
- '{"dst_org_id":"3eff35f7-c218-894e-bca2-24e5325601cc","op":"amend","quantity":10,"subscription_id":"SUB-0000144"}'
- '{"amendment_id":"2b9116ab-cd1e-e897-6e08-31fccd88e792","op":"unamend"}'
contentMediaType: application/json
examples:
annotate:
value:
notes: customer notes
op: annotate
subscription_id: SUB-000144
delete:
value:
op: delete
subscription_id: SUB-0000144
move:
value:
dst_org_id: 3eff35f7-c218-894e-bca2-24e5325601cc
op: amend
quantity: 10
subscription_id: SUB-0000144
undo_move:
value:
amendment_id: 2b9116ab-cd1e-e897-6e08-31fccd88e792
op: unamend
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/licenses/usages:
get:
tags:
- Orgs Licenses
summary: getOrgLicensesBySite
description: >-
Get Licenses Usage by Sites
This shows license usage (i.e. needed) based on the features enabled for the site.
operationId: getOrgLicensesBySite
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/license_usage_org'
description: Organization license usage records returned by a usage response
examples:
- - fully_loaded:
SUB-LOC: 30
SUB-MAN: 80
num_devices: 80
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
usages:
SUB-LOC: 30
SUB-MAN: 60
contentMediaType: application/json
examples:
Example:
value:
- fully_loaded:
SUB-LOC: 30
SUB-MAN: 80
num_devices: 80
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
usages:
SUB-LOC: 30
SUB-MAN: 60
application/vnd.api+json:
schema:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/license_usage_org'
description: Organization license usage records returned by a usage response
examples:
- - fully_loaded:
SUB-LOC: 30
SUB-MAN: 80
num_devices: 80
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
usages:
SUB-LOC: 30
SUB-MAN: 60
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- fully_loaded:
SUB-LOC: 30
SUB-MAN: 80
num_devices: 80
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
usages:
SUB-LOC: 30
SUB-MAN: 60
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/setting/{app_name}/link_accounts:
get:
tags:
- Orgs Linked Applications
summary: getOrgOauthAppLinkedStatus
description: Return linked-account status for the specified organization OAuth application and the authorization URL used to start account linking.
operationId: getOrgOauthAppLinkedStatus
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: app_name
in: path
description: OAuth application name
required: true
schema:
allOf:
- $ref: '#/components/schemas/oauth_app_name'
- description: OAuth application name
- name: forward
in: query
description: Mist portal url to which backend needs to redirect after successful OAuth authorization. **Required** to get the `authorization_url`
required: true
style: form
explode: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/account_oauth_info'
- description: OAuth-linked application account status and authorization details
examples:
- '{"accounts":[{"account_id":"ae9dee49-69e7-4710-a114-5b827a777738","last_status":"success","last_sync":1665465339000,"linked_by":"Testname1","linked_timestamp":1728275689.284758,"name":"Test Company1 Ltd"},{"account_id":"845a23bf-bed9-e43c-4c86-6fa474be7ae5","error":"Get token failed, please re-link crowdstrike","last_status":"failed","last_sync":1234567890123,"linked_by":"Testname2","linked_timestamp":1728275689.284758,"name":"Test Company2 Ltd"}],"linked":true}'
- '{"accounts":[{"error":"OAuth token refresh failed, please re-link your account","instance_url":"junipertest.jamfcloud.com","last_status":"failed","last_sync":1665465339000,"linked_by":"Testname1","name":"Test Company1 Ltd","smartgroup_name":"CompliantGroup1"}],"linked":true}'
- '{"accounts":[{"account_id":"7f80cd00-40b1-49e5-b2cb-9386d89af0d6","client_id":"3e408b13255844149f2830e8609fe8f3","instance_url":"https://a0020372.mobicontrol.cloud","last_status":"success","last_sync":1665465339000,"linked_by":"User1","linked_timestamp":1702284364,"name":"Company1 Ltd."},{"account_id":"80364a28-7ccc-4746-b110-ecf3dfd3a359","client_id":"e81cfb1980454b4bb6109c74136ca528","error":"Get token failed, please re-link MobiControl account","instance_url":"https://a0032314.mobicontrol.cloud","last_status":"failed","last_sync":1234567890123,"linked_by":"User2","linked_timestamp":1702284364,"name":"Company2 Ltd."}],"linked":true}'
- '{"accounts":[{"account_id":"00fd8b39-cf92-4b43-a2ff-a461b48e7059","instance_url":"usea1-015.sentinelone.net","last_status":"success","last_sync":1234567891,"linked_by":"user1@test.com","linked_timestamp":1234567891,"name":"company1"},{"account_id":"00fd8b39-cf92-4b43-a2ff-a461b48e7060","error":"Get token failed, please re-link SentinelOne account","instance_url":"usea1-017.sentinelone.net","last_status":"failed","last_sync":1234567800,"linked_by":"user2@test.com","linked_timestamp":1234567891,"name":"company2"}],"linked":true}'
- '{"accounts":[{"account_id":"f43ea4c4-8a97-4159-9214-112a8c7b8f22","instance_url":"as800.airwatchportals.com","last_status":"success","last_sync":1665465339000,"linked_by":"Testname1","linked_timestamp":1702284364,"name":"Test Company1 Ltd","webhook_auth_type":"Basic","webhook_enabled":true,"webhook_password":"password_1234","webhook_url":"https://websync.nac-staging.mistsys.com/v1/S_41b2525af1d8dcbe9005/f43ea4c48f22/vmware/mdm","webhook_username":"username_1234"},{"account_id":"m56ea4c4-8a10-4189-9214-113a8c7b8m82","error":"Get token failed, please re-link VMware","instance_url":"as561.airwatchportals.com","last_status":"failed","last_sync":1234567890123,"linked_by":"Testname2","linked_timestamp":1702284364,"name":"Test Company2 Ltd","webhook_auth_type":"Basic","webhook_enabled":true,"webhook_password":"password_1234","webhook_url":"https://websync.nac-staging.mistsys.com/v1/S_41b2525af1d8dcbe9005/f43ea4c48f22/vmware/mdm","webhook_username":"username_1234"}],"linked":true}'
- '{"accounts":[{"account_id":"80364a28-7ccc-4746-b110-ecf3dfd3a359","cloud_name":"zdxcloud.net","key_id":"K35vrZcK3JvrZc","webhook_url":"https://webhook.url/xxx","zdx_org_id":"123456"}],"linked":true}'
- '{"accounts":[{"account_id":"KkEM7orQSIWHZNFzwMLuRA","company":"Test Company1 Ltd","last_status":"success","last_sync":1665465339,"linked_by":"Testname1","max_daily_api_requests":1500},{"account_id":"kojzWgIJQ0ujR73VvydOdg","company":"Test Company2 Ltd","error":"OAuth token refresh failed, please re-link your account","errors":["OAuth token refresh failed, please re-link your account","API daily rate limit reached for your account"],"last_status":"failed","last_sync":1665465346,"linked_by":"Testname2","max_daily_api_requests":5000},{"account_id":"iojzXIJWEuiD73ZvydOfg","company":"Test Company3 Ltd","last_status":"failed","last_sync":1665465538,"linked_by":"Testname3","max_daily_api_requests":3500}],"authorization_url":"https://zoom.us/oauth/authorize?response_type=code&client_id=YDyajBmJREjwkyb3TPAbA&redirect_uri=https%3A%2F%2Fapi.local%2Fapi%2Fv1%2Forg%2Fb4e16c72-d50e-4c03-a952-a3217e231e2c%2Foauth2%2Fapp%2Fzoom%2Fcallback&state=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpYXQiOjE2NDk3NjE0MDQsImZvcndhcmQiOiJodHRwczovL2NsaWVudGZvcndhcmR1cmwuY29tIn0.RIE4XTU5kpF4nKIy7_enJ0PpOCyTTp6DLm9PZsdncpI","linked":true}'
contentMediaType: application/json
examples:
Crowdstrike:
value:
accounts:
- account_id: ae9dee49-69e7-4710-a114-5b827a777738
last_status: success
last_sync: 1665465339000
linked_by: Testname1
linked_timestamp: 1728275689.284758
name: Test Company1 Ltd
- account_id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
error: Get token failed, please re-link crowdstrike
last_status: failed
last_sync: 1234567890123
linked_by: Testname2
linked_timestamp: 1728275689.284758
name: Test Company2 Ltd
linked: true
Jamf:
value:
accounts:
- error: OAuth token refresh failed, please re-link your account
instance_url: junipertest.jamfcloud.com
last_status: failed
last_sync: 1665465339000
linked_by: Testname1
name: Test Company1 Ltd
smartgroup_name: CompliantGroup1
linked: true
Mobicontrol:
value:
accounts:
- account_id: 7f80cd00-40b1-49e5-b2cb-9386d89af0d6
client_id: 3e408b13255844149f2830e8609fe8f3
instance_url: https://a0020372.mobicontrol.cloud
last_status: success
last_sync: 1665465339000
linked_by: User1
linked_timestamp: 1702284364
name: Company1 Ltd.
- account_id: 80364a28-7ccc-4746-b110-ecf3dfd3a359
client_id: e81cfb1980454b4bb6109c74136ca528
error: Get token failed, please re-link MobiControl account
instance_url: https://a0032314.mobicontrol.cloud
last_status: failed
last_sync: 1234567890123
linked_by: User2
linked_timestamp: 1702284364
name: Company2 Ltd.
linked: true
SentinelOne:
value:
accounts:
- account_id: 00fd8b39-cf92-4b43-a2ff-a461b48e7059
instance_url: usea1-015.sentinelone.net
last_status: success
last_sync: 1234567891
linked_by: user1@test.com
linked_timestamp: 1234567891
name: company1
- account_id: 00fd8b39-cf92-4b43-a2ff-a461b48e7060
error: Get token failed, please re-link SentinelOne account
instance_url: usea1-017.sentinelone.net
last_status: failed
last_sync: 1234567800
linked_by: user2@test.com
linked_timestamp: 1234567891
name: company2
linked: true
Vmware:
value:
accounts:
- account_id: f43ea4c4-8a97-4159-9214-112a8c7b8f22
instance_url: as800.airwatchportals.com
last_status: success
last_sync: 1665465339000
linked_by: Testname1
linked_timestamp: 1702284364
name: Test Company1 Ltd
webhook_auth_type: Basic
webhook_enabled: true
webhook_password: password_1234
webhook_url: https://websync.nac-staging.mistsys.com/v1/S_41b2525af1d8dcbe9005/f43ea4c48f22/vmware/mdm
webhook_username: username_1234
- account_id: m56ea4c4-8a10-4189-9214-113a8c7b8m82
error: Get token failed, please re-link VMware
instance_url: as561.airwatchportals.com
last_status: failed
last_sync: 1234567890123
linked_by: Testname2
linked_timestamp: 1702284364
name: Test Company2 Ltd
webhook_auth_type: Basic
webhook_enabled: true
webhook_password: password_1234
webhook_url: https://websync.nac-staging.mistsys.com/v1/S_41b2525af1d8dcbe9005/f43ea4c48f22/vmware/mdm
webhook_username: username_1234
linked: true
ZDX:
value:
accounts:
- account_id: 80364a28-7ccc-4746-b110-ecf3dfd3a359
cloud_name: zdxcloud.net
key_id: K35vrZcK3JvrZc
webhook_url: https://webhook.url/xxx
zdx_org_id: '123456'
linked: true
Zoom:
value:
accounts:
- account_id: KkEM7orQSIWHZNFzwMLuRA
company: Test Company1 Ltd
last_status: success
last_sync: 1665465339
linked_by: Testname1
max_daily_api_requests: 1500
- account_id: kojzWgIJQ0ujR73VvydOdg
company: Test Company2 Ltd
error: OAuth token refresh failed, please re-link your account
errors:
- OAuth token refresh failed, please re-link your account
- API daily rate limit reached for your account
last_status: failed
last_sync: 1665465346
linked_by: Testname2
max_daily_api_requests: 5000
- account_id: iojzXIJWEuiD73ZvydOfg
company: Test Company3 Ltd
last_status: failed
last_sync: 1665465538
linked_by: Testname3
max_daily_api_requests: 3500
authorization_url: https://zoom.us/oauth/authorize?response_type=code&client_id=YDyajBmJREjwkyb3TPAbA&redirect_uri=https%3A%2F%2Fapi.local%2Fapi%2Fv1%2Forg%2Fb4e16c72-d50e-4c03-a952-a3217e231e2c%2Foauth2%2Fapp%2Fzoom%2Fcallback&state=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpYXQiOjE2NDk3NjE0MDQsImZvcndhcmQiOiJodHRwczovL2NsaWVudGZvcndhcmR1cmwuY29tIn0.RIE4XTU5kpF4nKIy7_enJ0PpOCyTTp6DLm9PZsdncpI
linked: true
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/account_oauth_info'
- description: OAuth-linked application account status and authorization details
examples:
- '{"accounts":[{"account_id":"ae9dee49-69e7-4710-a114-5b827a777738","last_status":"success","last_sync":1665465339000,"linked_by":"Testname1","linked_timestamp":1728275689.284758,"name":"Test Company1 Ltd"},{"account_id":"845a23bf-bed9-e43c-4c86-6fa474be7ae5","error":"Get token failed, please re-link crowdstrike","last_status":"failed","last_sync":1234567890123,"linked_by":"Testname2","linked_timestamp":1728275689.284758,"name":"Test Company2 Ltd"}],"linked":true}'
- '{"accounts":[{"error":"OAuth token refresh failed, please re-link your account","instance_url":"junipertest.jamfcloud.com","last_status":"failed","last_sync":1665465339000,"linked_by":"Testname1","name":"Test Company1 Ltd","smartgroup_name":"CompliantGroup1"}],"linked":true}'
- '{"accounts":[{"account_id":"7f80cd00-40b1-49e5-b2cb-9386d89af0d6","client_id":"3e408b13255844149f2830e8609fe8f3","instance_url":"https://a0020372.mobicontrol.cloud","last_status":"success","last_sync":1665465339000,"linked_by":"User1","linked_timestamp":1702284364,"name":"Company1 Ltd."},{"account_id":"80364a28-7ccc-4746-b110-ecf3dfd3a359","client_id":"e81cfb1980454b4bb6109c74136ca528","error":"Get token failed, please re-link MobiControl account","instance_url":"https://a0032314.mobicontrol.cloud","last_status":"failed","last_sync":1234567890123,"linked_by":"User2","linked_timestamp":1702284364,"name":"Company2 Ltd."}],"linked":true}'
- '{"accounts":[{"account_id":"00fd8b39-cf92-4b43-a2ff-a461b48e7059","instance_url":"usea1-015.sentinelone.net","last_status":"success","last_sync":1234567891,"linked_by":"user1@test.com","linked_timestamp":1234567891,"name":"company1"},{"account_id":"00fd8b39-cf92-4b43-a2ff-a461b48e7060","error":"Get token failed, please re-link SentinelOne account","instance_url":"usea1-017.sentinelone.net","last_status":"failed","last_sync":1234567800,"linked_by":"user2@test.com","linked_timestamp":1234567891,"name":"company2"}],"linked":true}'
- '{"accounts":[{"account_id":"f43ea4c4-8a97-4159-9214-112a8c7b8f22","instance_url":"as800.airwatchportals.com","last_status":"success","last_sync":1665465339000,"linked_by":"Testname1","linked_timestamp":1702284364,"name":"Test Company1 Ltd","webhook_auth_type":"Basic","webhook_enabled":true,"webhook_password":"password_1234","webhook_url":"https://websync.nac-staging.mistsys.com/v1/S_41b2525af1d8dcbe9005/f43ea4c48f22/vmware/mdm","webhook_username":"username_1234"},{"account_id":"m56ea4c4-8a10-4189-9214-113a8c7b8m82","error":"Get token failed, please re-link VMware","instance_url":"as561.airwatchportals.com","last_status":"failed","last_sync":1234567890123,"linked_by":"Testname2","linked_timestamp":1702284364,"name":"Test Company2 Ltd","webhook_auth_type":"Basic","webhook_enabled":true,"webhook_password":"password_1234","webhook_url":"https://websync.nac-staging.mistsys.com/v1/S_41b2525af1d8dcbe9005/f43ea4c48f22/vmware/mdm","webhook_username":"username_1234"}],"linked":true}'
- '{"accounts":[{"account_id":"80364a28-7ccc-4746-b110-ecf3dfd3a359","cloud_name":"zdxcloud.net","key_id":"K35vrZcK3JvrZc","webhook_url":"https://webhook.url/xxx","zdx_org_id":"123456"}],"linked":true}'
- '{"accounts":[{"account_id":"KkEM7orQSIWHZNFzwMLuRA","company":"Test Company1 Ltd","last_status":"success","last_sync":1665465339,"linked_by":"Testname1","max_daily_api_requests":1500},{"account_id":"kojzWgIJQ0ujR73VvydOdg","company":"Test Company2 Ltd","error":"OAuth token refresh failed, please re-link your account","errors":["OAuth token refresh failed, please re-link your account","API daily rate limit reached for your account"],"last_status":"failed","last_sync":1665465346,"linked_by":"Testname2","max_daily_api_requests":5000},{"account_id":"iojzXIJWEuiD73ZvydOfg","company":"Test Company3 Ltd","last_status":"failed","last_sync":1665465538,"linked_by":"Testname3","max_daily_api_requests":3500}],"authorization_url":"https://zoom.us/oauth/authorize?response_type=code&client_id=YDyajBmJREjwkyb3TPAbA&redirect_uri=https%3A%2F%2Fapi.local%2Fapi%2Fv1%2Forg%2Fb4e16c72-d50e-4c03-a952-a3217e231e2c%2Foauth2%2Fapp%2Fzoom%2Fcallback&state=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpYXQiOjE2NDk3NjE0MDQsImZvcndhcmQiOiJodHRwczovL2NsaWVudGZvcndhcmR1cmwuY29tIn0.RIE4XTU5kpF4nKIy7_enJ0PpOCyTTp6DLm9PZsdncpI","linked":true}'
contentMediaType: application/vnd.api+json
examples:
Crowdstrike:
value:
accounts:
- account_id: ae9dee49-69e7-4710-a114-5b827a777738
last_status: success
last_sync: 1665465339000
linked_by: Testname1
linked_timestamp: 1728275689.284758
name: Test Company1 Ltd
- account_id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
error: Get token failed, please re-link crowdstrike
last_status: failed
last_sync: 1234567890123
linked_by: Testname2
linked_timestamp: 1728275689.284758
name: Test Company2 Ltd
linked: true
Jamf:
value:
accounts:
- error: OAuth token refresh failed, please re-link your account
instance_url: junipertest.jamfcloud.com
last_status: failed
last_sync: 1665465339000
linked_by: Testname1
name: Test Company1 Ltd
smartgroup_name: CompliantGroup1
linked: true
Mobicontrol:
value:
accounts:
- account_id: 7f80cd00-40b1-49e5-b2cb-9386d89af0d6
client_id: 3e408b13255844149f2830e8609fe8f3
instance_url: https://a0020372.mobicontrol.cloud
last_status: success
last_sync: 1665465339000
linked_by: User1
linked_timestamp: 1702284364
name: Company1 Ltd.
- account_id: 80364a28-7ccc-4746-b110-ecf3dfd3a359
client_id: e81cfb1980454b4bb6109c74136ca528
error: Get token failed, please re-link MobiControl account
instance_url: https://a0032314.mobicontrol.cloud
last_status: failed
last_sync: 1234567890123
linked_by: User2
linked_timestamp: 1702284364
name: Company2 Ltd.
linked: true
SentinelOne:
value:
accounts:
- account_id: 00fd8b39-cf92-4b43-a2ff-a461b48e7059
instance_url: usea1-015.sentinelone.net
last_status: success
last_sync: 1234567891
linked_by: user1@test.com
linked_timestamp: 1234567891
name: company1
- account_id: 00fd8b39-cf92-4b43-a2ff-a461b48e7060
error: Get token failed, please re-link SentinelOne account
instance_url: usea1-017.sentinelone.net
last_status: failed
last_sync: 1234567800
linked_by: user2@test.com
linked_timestamp: 1234567891
name: company2
linked: true
Vmware:
value:
accounts:
- account_id: f43ea4c4-8a97-4159-9214-112a8c7b8f22
instance_url: as800.airwatchportals.com
last_status: success
last_sync: 1665465339000
linked_by: Testname1
linked_timestamp: 1702284364
name: Test Company1 Ltd
webhook_auth_type: Basic
webhook_enabled: true
webhook_password: password_1234
webhook_url: https://websync.nac-staging.mistsys.com/v1/S_41b2525af1d8dcbe9005/f43ea4c48f22/vmware/mdm
webhook_username: username_1234
- account_id: m56ea4c4-8a10-4189-9214-113a8c7b8m82
error: Get token failed, please re-link VMware
instance_url: as561.airwatchportals.com
last_status: failed
last_sync: 1234567890123
linked_by: Testname2
linked_timestamp: 1702284364
name: Test Company2 Ltd
webhook_auth_type: Basic
webhook_enabled: true
webhook_password: password_1234
webhook_url: https://websync.nac-staging.mistsys.com/v1/S_41b2525af1d8dcbe9005/f43ea4c48f22/vmware/mdm
webhook_username: username_1234
linked: true
ZDX:
value:
accounts:
- account_id: 80364a28-7ccc-4746-b110-ecf3dfd3a359
cloud_name: zdxcloud.net
key_id: K35vrZcK3JvrZc
webhook_url: https://webhook.url/xxx
zdx_org_id: '123456'
linked: true
Zoom:
value:
accounts:
- account_id: KkEM7orQSIWHZNFzwMLuRA
company: Test Company1 Ltd
last_status: success
last_sync: 1665465339
linked_by: Testname1
max_daily_api_requests: 1500
- account_id: kojzWgIJQ0ujR73VvydOdg
company: Test Company2 Ltd
error: OAuth token refresh failed, please re-link your account
errors:
- OAuth token refresh failed, please re-link your account
- API daily rate limit reached for your account
last_status: failed
last_sync: 1665465346
linked_by: Testname2
max_daily_api_requests: 5000
- account_id: iojzXIJWEuiD73ZvydOfg
company: Test Company3 Ltd
last_status: failed
last_sync: 1665465538
linked_by: Testname3
max_daily_api_requests: 3500
authorization_url: https://zoom.us/oauth/authorize?response_type=code&client_id=YDyajBmJREjwkyb3TPAbA&redirect_uri=https%3A%2F%2Fapi.local%2Fapi%2Fv1%2Forg%2Fb4e16c72-d50e-4c03-a952-a3217e231e2c%2Foauth2%2Fapp%2Fzoom%2Fcallback&state=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpYXQiOjE2NDk3NjE0MDQsImZvcndhcmQiOiJodHRwczovL2NsaWVudGZvcndhcmR1cmwuY29tIn0.RIE4XTU5kpF4nKIy7_enJ0PpOCyTTp6DLm9PZsdncpI
linked: true
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs Linked Applications
summary: addOrgOauthAppAccounts
description: Add a linked account for the specified OAuth application using the app-specific account configuration payload.
operationId: addOrgOauthAppAccounts
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: app_name
in: path
description: OAuth application name
required: true
schema:
allOf:
- $ref: '#/components/schemas/oauth_app_name'
- description: OAuth application name
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/account_oauth_add'
- {}
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/account_oauth_info'
- description: OAuth-linked application account status and authorization details
examples:
- '{"accounts":[{"account_id":"ae9dee49-69e7-4710-a114-5b827a777738","last_status":"success","last_sync":1665465339000,"linked_by":"Testname1","linked_timestamp":1728275689.284758,"name":"Test Company1 Ltd"},{"account_id":"845a23bf-bed9-e43c-4c86-6fa474be7ae5","error":"Get token failed, please re-link crowdstrike","last_status":"failed","last_sync":1234567890123,"linked_by":"Testname2","linked_timestamp":1728275689.284758,"name":"Test Company2 Ltd"}],"linked":true}'
- '{"accounts":[{"error":"OAuth token refresh failed, please re-link your account","instance_url":"junipertest.jamfcloud.com","last_status":"failed","last_sync":1665465339000,"linked_by":"Testname1","name":"Test Company1 Ltd","smartgroup_name":"CompliantGroup1"}],"linked":true}'
- '{"accounts":[{"account_id":"7f80cd00-40b1-49e5-b2cb-9386d89af0d6","client_id":"3e408b13255844149f2830e8609fe8f3","instance_url":"https://a0020372.mobicontrol.cloud","last_status":"success","last_sync":1665465339000,"linked_by":"User1","linked_timestamp":1702284364,"name":"Company1 Ltd."},{"account_id":"80364a28-7ccc-4746-b110-ecf3dfd3a359","client_id":"e81cfb1980454b4bb6109c74136ca528","error":"Get token failed, please re-link MobiControl account","instance_url":"https://a0032314.mobicontrol.cloud","last_status":"failed","last_sync":1234567890123,"linked_by":"User2","linked_timestamp":1702284364,"name":"Company2 Ltd."}],"linked":true}'
- '{"accounts":[{"account_id":"00fd8b39-cf92-4b43-a2ff-a461b48e7059","instance_url":"usea1-015.sentinelone.net","last_status":"success","last_sync":1234567891,"linked_by":"user1@test.com","linked_timestamp":1234567891,"name":"company1"},{"account_id":"00fd8b39-cf92-4b43-a2ff-a461b48e7060","error":"Get token failed, please re-link SentinelOne account","instance_url":"usea1-017.sentinelone.net","last_status":"failed","last_sync":1234567800,"linked_by":"user2@test.com","linked_timestamp":1234567891,"name":"company2"}],"linked":true}'
- '{"accounts":[{"account_id":"f43ea4c4-8a97-4159-9214-112a8c7b8f22","instance_url":"as800.airwatchportals.com","last_status":"success","last_sync":1665465339000,"linked_by":"Testname1","linked_timestamp":1702284364,"name":"Test Company1 Ltd","webhook_auth_type":"Basic","webhook_enabled":true,"webhook_password":"password_1234","webhook_url":"https://websync.nac-staging.mistsys.com/v1/S_41b2525af1d8dcbe9005/f43ea4c48f22/vmware/mdm","webhook_username":"username_1234"},{"account_id":"m56ea4c4-8a10-4189-9214-113a8c7b8m82","error":"Get token failed, please re-link VMware","instance_url":"as561.airwatchportals.com","last_status":"failed","last_sync":1234567890123,"linked_by":"Testname2","linked_timestamp":1702284364,"name":"Test Company2 Ltd","webhook_auth_type":"Basic","webhook_enabled":true,"webhook_password":"password_1234","webhook_url":"https://websync.nac-staging.mistsys.com/v1/S_41b2525af1d8dcbe9005/f43ea4c48f22/vmware/mdm","webhook_username":"username_1234"}],"linked":true}'
- '{"accounts":[{"account_id":"80364a28-7ccc-4746-b110-ecf3dfd3a359","cloud_name":"zdxcloud.net","key_id":"K35vrZcK3JvrZc","webhook_url":"https://webhook.url/xxx","zdx_org_id":"123456"}],"linked":true}'
- '{"accounts":[{"account_id":"KkEM7orQSIWHZNFzwMLuRA","company":"Test Company1 Ltd","last_status":"success","last_sync":1665465339,"linked_by":"Testname1","max_daily_api_requests":1500},{"account_id":"kojzWgIJQ0ujR73VvydOdg","company":"Test Company2 Ltd","error":"OAuth token refresh failed, please re-link your account","errors":["OAuth token refresh failed, please re-link your account","API daily rate limit reached for your account"],"last_status":"failed","last_sync":1665465346,"linked_by":"Testname2","max_daily_api_requests":5000},{"account_id":"iojzXIJWEuiD73ZvydOfg","company":"Test Company3 Ltd","last_status":"failed","last_sync":1665465538,"linked_by":"Testname3","max_daily_api_requests":3500}],"authorization_url":"https://zoom.us/oauth/authorize?response_type=code&client_id=YDyajBmJREjwkyb3TPAbA&redirect_uri=https%3A%2F%2Fapi.local%2Fapi%2Fv1%2Forg%2Fb4e16c72-d50e-4c03-a952-a3217e231e2c%2Foauth2%2Fapp%2Fzoom%2Fcallback&state=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpYXQiOjE2NDk3NjE0MDQsImZvcndhcmQiOiJodHRwczovL2NsaWVudGZvcndhcmR1cmwuY29tIn0.RIE4XTU5kpF4nKIy7_enJ0PpOCyTTp6DLm9PZsdncpI","linked":true}'
contentMediaType: application/json
examples:
Crowdstrike:
value:
accounts:
- account_id: ae9dee49-69e7-4710-a114-5b827a777738
last_status: success
last_sync: 1665465339000
linked_by: Testname1
linked_timestamp: 1728275689.284758
name: Test Company1 Ltd
- account_id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
error: Get token failed, please re-link crowdstrike
last_status: failed
last_sync: 1234567890123
linked_by: Testname2
linked_timestamp: 1728275689.284758
name: Test Company2 Ltd
linked: true
Jamf:
value:
accounts:
- error: OAuth token refresh failed, please re-link your account
instance_url: junipertest.jamfcloud.com
last_status: failed
last_sync: 1665465339000
linked_by: Testname1
name: Test Company1 Ltd
smartgroup_name: CompliantGroup1
linked: true
Mobicontrol:
value:
accounts:
- account_id: 7f80cd00-40b1-49e5-b2cb-9386d89af0d6
client_id: 3e408b13255844149f2830e8609fe8f3
instance_url: https://a0020372.mobicontrol.cloud
last_status: success
last_sync: 1665465339000
linked_by: User1
linked_timestamp: 1702284364
name: Company1 Ltd.
- account_id: 80364a28-7ccc-4746-b110-ecf3dfd3a359
client_id: e81cfb1980454b4bb6109c74136ca528
error: Get token failed, please re-link MobiControl account
instance_url: https://a0032314.mobicontrol.cloud
last_status: failed
last_sync: 1234567890123
linked_by: User2
linked_timestamp: 1702284364
name: Company2 Ltd.
linked: true
SentinelOne:
value:
accounts:
- account_id: 00fd8b39-cf92-4b43-a2ff-a461b48e7059
instance_url: usea1-015.sentinelone.net
last_status: success
last_sync: 1234567891
linked_by: user1@test.com
linked_timestamp: 1234567891
name: company1
- account_id: 00fd8b39-cf92-4b43-a2ff-a461b48e7060
error: Get token failed, please re-link SentinelOne account
instance_url: usea1-017.sentinelone.net
last_status: failed
last_sync: 1234567800
linked_by: user2@test.com
linked_timestamp: 1234567891
name: company2
linked: true
Vmware:
value:
accounts:
- account_id: f43ea4c4-8a97-4159-9214-112a8c7b8f22
instance_url: as800.airwatchportals.com
last_status: success
last_sync: 1665465339000
linked_by: Testname1
linked_timestamp: 1702284364
name: Test Company1 Ltd
webhook_auth_type: Basic
webhook_enabled: true
webhook_password: password_1234
webhook_url: https://websync.nac-staging.mistsys.com/v1/S_41b2525af1d8dcbe9005/f43ea4c48f22/vmware/mdm
webhook_username: username_1234
- account_id: m56ea4c4-8a10-4189-9214-113a8c7b8m82
error: Get token failed, please re-link VMware
instance_url: as561.airwatchportals.com
last_status: failed
last_sync: 1234567890123
linked_by: Testname2
linked_timestamp: 1702284364
name: Test Company2 Ltd
webhook_auth_type: Basic
webhook_enabled: true
webhook_password: password_1234
webhook_url: https://websync.nac-staging.mistsys.com/v1/S_41b2525af1d8dcbe9005/f43ea4c48f22/vmware/mdm
webhook_username: username_1234
linked: true
ZDX:
value:
accounts:
- account_id: 80364a28-7ccc-4746-b110-ecf3dfd3a359
cloud_name: zdxcloud.net
key_id: K35vrZcK3JvrZc
webhook_url: https://webhook.url/xxx
zdx_org_id: '123456'
linked: true
Zoom:
value:
accounts:
- account_id: KkEM7orQSIWHZNFzwMLuRA
company: Test Company1 Ltd
last_status: success
last_sync: 1665465339
linked_by: Testname1
max_daily_api_requests: 1500
- account_id: kojzWgIJQ0ujR73VvydOdg
company: Test Company2 Ltd
error: OAuth token refresh failed, please re-link your account
errors:
- OAuth token refresh failed, please re-link your account
- API daily rate limit reached for your account
last_status: failed
last_sync: 1665465346
linked_by: Testname2
max_daily_api_requests: 5000
- account_id: iojzXIJWEuiD73ZvydOfg
company: Test Company3 Ltd
last_status: failed
last_sync: 1665465538
linked_by: Testname3
max_daily_api_requests: 3500
authorization_url: https://zoom.us/oauth/authorize?response_type=code&client_id=YDyajBmJREjwkyb3TPAbA&redirect_uri=https%3A%2F%2Fapi.local%2Fapi%2Fv1%2Forg%2Fb4e16c72-d50e-4c03-a952-a3217e231e2c%2Foauth2%2Fapp%2Fzoom%2Fcallback&state=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpYXQiOjE2NDk3NjE0MDQsImZvcndhcmQiOiJodHRwczovL2NsaWVudGZvcndhcmR1cmwuY29tIn0.RIE4XTU5kpF4nKIy7_enJ0PpOCyTTp6DLm9PZsdncpI
linked: true
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/account_oauth_info'
- description: OAuth-linked application account status and authorization details
examples:
- '{"accounts":[{"account_id":"ae9dee49-69e7-4710-a114-5b827a777738","last_status":"success","last_sync":1665465339000,"linked_by":"Testname1","linked_timestamp":1728275689.284758,"name":"Test Company1 Ltd"},{"account_id":"845a23bf-bed9-e43c-4c86-6fa474be7ae5","error":"Get token failed, please re-link crowdstrike","last_status":"failed","last_sync":1234567890123,"linked_by":"Testname2","linked_timestamp":1728275689.284758,"name":"Test Company2 Ltd"}],"linked":true}'
- '{"accounts":[{"error":"OAuth token refresh failed, please re-link your account","instance_url":"junipertest.jamfcloud.com","last_status":"failed","last_sync":1665465339000,"linked_by":"Testname1","name":"Test Company1 Ltd","smartgroup_name":"CompliantGroup1"}],"linked":true}'
- '{"accounts":[{"account_id":"7f80cd00-40b1-49e5-b2cb-9386d89af0d6","client_id":"3e408b13255844149f2830e8609fe8f3","instance_url":"https://a0020372.mobicontrol.cloud","last_status":"success","last_sync":1665465339000,"linked_by":"User1","linked_timestamp":1702284364,"name":"Company1 Ltd."},{"account_id":"80364a28-7ccc-4746-b110-ecf3dfd3a359","client_id":"e81cfb1980454b4bb6109c74136ca528","error":"Get token failed, please re-link MobiControl account","instance_url":"https://a0032314.mobicontrol.cloud","last_status":"failed","last_sync":1234567890123,"linked_by":"User2","linked_timestamp":1702284364,"name":"Company2 Ltd."}],"linked":true}'
- '{"accounts":[{"account_id":"00fd8b39-cf92-4b43-a2ff-a461b48e7059","instance_url":"usea1-015.sentinelone.net","last_status":"success","last_sync":1234567891,"linked_by":"user1@test.com","linked_timestamp":1234567891,"name":"company1"},{"account_id":"00fd8b39-cf92-4b43-a2ff-a461b48e7060","error":"Get token failed, please re-link SentinelOne account","instance_url":"usea1-017.sentinelone.net","last_status":"failed","last_sync":1234567800,"linked_by":"user2@test.com","linked_timestamp":1234567891,"name":"company2"}],"linked":true}'
- '{"accounts":[{"account_id":"f43ea4c4-8a97-4159-9214-112a8c7b8f22","instance_url":"as800.airwatchportals.com","last_status":"success","last_sync":1665465339000,"linked_by":"Testname1","linked_timestamp":1702284364,"name":"Test Company1 Ltd","webhook_auth_type":"Basic","webhook_enabled":true,"webhook_password":"password_1234","webhook_url":"https://websync.nac-staging.mistsys.com/v1/S_41b2525af1d8dcbe9005/f43ea4c48f22/vmware/mdm","webhook_username":"username_1234"},{"account_id":"m56ea4c4-8a10-4189-9214-113a8c7b8m82","error":"Get token failed, please re-link VMware","instance_url":"as561.airwatchportals.com","last_status":"failed","last_sync":1234567890123,"linked_by":"Testname2","linked_timestamp":1702284364,"name":"Test Company2 Ltd","webhook_auth_type":"Basic","webhook_enabled":true,"webhook_password":"password_1234","webhook_url":"https://websync.nac-staging.mistsys.com/v1/S_41b2525af1d8dcbe9005/f43ea4c48f22/vmware/mdm","webhook_username":"username_1234"}],"linked":true}'
- '{"accounts":[{"account_id":"80364a28-7ccc-4746-b110-ecf3dfd3a359","cloud_name":"zdxcloud.net","key_id":"K35vrZcK3JvrZc","webhook_url":"https://webhook.url/xxx","zdx_org_id":"123456"}],"linked":true}'
- '{"accounts":[{"account_id":"KkEM7orQSIWHZNFzwMLuRA","company":"Test Company1 Ltd","last_status":"success","last_sync":1665465339,"linked_by":"Testname1","max_daily_api_requests":1500},{"account_id":"kojzWgIJQ0ujR73VvydOdg","company":"Test Company2 Ltd","error":"OAuth token refresh failed, please re-link your account","errors":["OAuth token refresh failed, please re-link your account","API daily rate limit reached for your account"],"last_status":"failed","last_sync":1665465346,"linked_by":"Testname2","max_daily_api_requests":5000},{"account_id":"iojzXIJWEuiD73ZvydOfg","company":"Test Company3 Ltd","last_status":"failed","last_sync":1665465538,"linked_by":"Testname3","max_daily_api_requests":3500}],"authorization_url":"https://zoom.us/oauth/authorize?response_type=code&client_id=YDyajBmJREjwkyb3TPAbA&redirect_uri=https%3A%2F%2Fapi.local%2Fapi%2Fv1%2Forg%2Fb4e16c72-d50e-4c03-a952-a3217e231e2c%2Foauth2%2Fapp%2Fzoom%2Fcallback&state=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpYXQiOjE2NDk3NjE0MDQsImZvcndhcmQiOiJodHRwczovL2NsaWVudGZvcndhcmR1cmwuY29tIn0.RIE4XTU5kpF4nKIy7_enJ0PpOCyTTp6DLm9PZsdncpI","linked":true}'
contentMediaType: application/vnd.api+json
examples:
Crowdstrike:
value:
accounts:
- account_id: ae9dee49-69e7-4710-a114-5b827a777738
last_status: success
last_sync: 1665465339000
linked_by: Testname1
linked_timestamp: 1728275689.284758
name: Test Company1 Ltd
- account_id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
error: Get token failed, please re-link crowdstrike
last_status: failed
last_sync: 1234567890123
linked_by: Testname2
linked_timestamp: 1728275689.284758
name: Test Company2 Ltd
linked: true
Jamf:
value:
accounts:
- error: OAuth token refresh failed, please re-link your account
instance_url: junipertest.jamfcloud.com
last_status: failed
last_sync: 1665465339000
linked_by: Testname1
name: Test Company1 Ltd
smartgroup_name: CompliantGroup1
linked: true
Mobicontrol:
value:
accounts:
- account_id: 7f80cd00-40b1-49e5-b2cb-9386d89af0d6
client_id: 3e408b13255844149f2830e8609fe8f3
instance_url: https://a0020372.mobicontrol.cloud
last_status: success
last_sync: 1665465339000
linked_by: User1
linked_timestamp: 1702284364
name: Company1 Ltd.
- account_id: 80364a28-7ccc-4746-b110-ecf3dfd3a359
client_id: e81cfb1980454b4bb6109c74136ca528
error: Get token failed, please re-link MobiControl account
instance_url: https://a0032314.mobicontrol.cloud
last_status: failed
last_sync: 1234567890123
linked_by: User2
linked_timestamp: 1702284364
name: Company2 Ltd.
linked: true
SentinelOne:
value:
accounts:
- account_id: 00fd8b39-cf92-4b43-a2ff-a461b48e7059
instance_url: usea1-015.sentinelone.net
last_status: success
last_sync: 1234567891
linked_by: user1@test.com
linked_timestamp: 1234567891
name: company1
- account_id: 00fd8b39-cf92-4b43-a2ff-a461b48e7060
error: Get token failed, please re-link SentinelOne account
instance_url: usea1-017.sentinelone.net
last_status: failed
last_sync: 1234567800
linked_by: user2@test.com
linked_timestamp: 1234567891
name: company2
linked: true
Vmware:
value:
accounts:
- account_id: f43ea4c4-8a97-4159-9214-112a8c7b8f22
instance_url: as800.airwatchportals.com
last_status: success
last_sync: 1665465339000
linked_by: Testname1
linked_timestamp: 1702284364
name: Test Company1 Ltd
webhook_auth_type: Basic
webhook_enabled: true
webhook_password: password_1234
webhook_url: https://websync.nac-staging.mistsys.com/v1/S_41b2525af1d8dcbe9005/f43ea4c48f22/vmware/mdm
webhook_username: username_1234
- account_id: m56ea4c4-8a10-4189-9214-113a8c7b8m82
error: Get token failed, please re-link VMware
instance_url: as561.airwatchportals.com
last_status: failed
last_sync: 1234567890123
linked_by: Testname2
linked_timestamp: 1702284364
name: Test Company2 Ltd
webhook_auth_type: Basic
webhook_enabled: true
webhook_password: password_1234
webhook_url: https://websync.nac-staging.mistsys.com/v1/S_41b2525af1d8dcbe9005/f43ea4c48f22/vmware/mdm
webhook_username: username_1234
linked: true
ZDX:
value:
accounts:
- account_id: 80364a28-7ccc-4746-b110-ecf3dfd3a359
cloud_name: zdxcloud.net
key_id: K35vrZcK3JvrZc
webhook_url: https://webhook.url/xxx
zdx_org_id: '123456'
linked: true
Zoom:
value:
accounts:
- account_id: KkEM7orQSIWHZNFzwMLuRA
company: Test Company1 Ltd
last_status: success
last_sync: 1665465339
linked_by: Testname1
max_daily_api_requests: 1500
- account_id: kojzWgIJQ0ujR73VvydOdg
company: Test Company2 Ltd
error: OAuth token refresh failed, please re-link your account
errors:
- OAuth token refresh failed, please re-link your account
- API daily rate limit reached for your account
last_status: failed
last_sync: 1665465346
linked_by: Testname2
max_daily_api_requests: 5000
- account_id: iojzXIJWEuiD73ZvydOfg
company: Test Company3 Ltd
last_status: failed
last_sync: 1665465538
linked_by: Testname3
max_daily_api_requests: 3500
authorization_url: https://zoom.us/oauth/authorize?response_type=code&client_id=YDyajBmJREjwkyb3TPAbA&redirect_uri=https%3A%2F%2Fapi.local%2Fapi%2Fv1%2Forg%2Fb4e16c72-d50e-4c03-a952-a3217e231e2c%2Foauth2%2Fapp%2Fzoom%2Fcallback&state=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpYXQiOjE2NDk3NjE0MDQsImZvcndhcmQiOiJodHRwczovL2NsaWVudGZvcndhcmR1cmwuY29tIn0.RIE4XTU5kpF4nKIy7_enJ0PpOCyTTp6DLm9PZsdncpI
linked: true
'400':
description: Unsuccessful
headers: {}
content: {}
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/setting/{app_name}/link_accounts/{account_id}:
delete:
tags:
- Orgs Linked Applications
summary: deleteOrgOauthAppAuthorization
description: Remove a linked account authorization for the specified OAuth application and account ID.
operationId: deleteOrgOauthAppAuthorization
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: app_name
in: path
description: OAuth application name
required: true
schema:
allOf:
- $ref: '#/components/schemas/oauth_app_name'
- description: OAuth application name
- name: account_id
in: path
description: ''
required: true
schema:
type: string
examples:
- iojzXIJWEuiD73ZvydOfg
responses:
'200':
description: Successful
headers: {}
content: {}
'400':
description: Unsuccessful
headers: {}
content: {}
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Orgs Linked Applications
summary: updateOrgOauthAppAccount
description: Update app-specific settings for a linked OAuth application account, such as Zoom or Teams guest redaction settings or a Zoom daily API request quota.
operationId: updateOrgOauthAppAccount
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: app_name
in: path
description: OAuth application name
required: true
schema:
allOf:
- $ref: '#/components/schemas/oauth_app_name'
- description: OAuth application name
- name: account_id
in: path
description: ''
required: true
schema:
type: string
examples:
- iojzXIJWEuiD73ZvydOfg
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/account_oauth_config'
- examples:
- account_id: iojzXIJWEuiD73ZvydOfg
max_daily_api_requests: 5000
contentMediaType: application/json
examples:
Example:
value:
account_id: iojzXIJWEuiD73ZvydOfg
max_daily_api_requests: 5000
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/logs:
get:
tags:
- Orgs Logs
summary: listOrgAuditLogsLegacy
description: Get List of change logs for the current Org
operationId: listOrgAuditLogsLegacy
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: site_id
in: query
description: Filter results by site identifier. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- 00000000-0000-0000-0000-000000000001,00000000-0000-0000-0000-000000000002
- 4ac1dcf4-9d8b-7211-65c4-057819f0862b
examples:
Untitled Example1:
value: 00000000-0000-0000-0000-000000000001,00000000-0000-0000-0000-000000000002
Untitled Example2:
value: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
- name: admin_name
in: query
description: Filter results by one or more administrator names or email addresses. Supports comma-separated values
style: form
explode: true
schema:
type: string
examples:
- John Doe
- name: message
in: query
description: Filter results by one or more message text values. Supports comma-separated values
style: form
explode: true
schema:
type: string
examples:
- Created a new site
- name: sort
in: query
description: 'Field used to sort results; a leading `-` indicates descending order. enum: `-timestamp`, `admin_id`, `site_id`, `timestamp`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/list_org_logs_sort'
- description: 'Field used to sort results; a leading `-` indicates descending order. enum: `-timestamp`, `admin_id`, `site_id`, `timestamp`'
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_log_search'
- description: Paginated response for audit log search results
examples:
- end: 1428954000
limit: 100
results:
- admin_id: 72bfa2bd-e58a-4670-9d20-a1468f7a6f58
admin_name: test@mistsys.com
id: c6f9347b-b0a4-4a23-b927-fa9249f2ffb2
message: TEST AUDIT
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
timestamp: 1431382121
start: 1428939600
total: 135
contentMediaType: application/json
examples:
Example:
value:
end: 1428954000
limit: 100
results:
- admin_id: 72bfa2bd-e58a-4670-9d20-a1468f7a6f58
admin_name: test@mistsys.com
id: c6f9347b-b0a4-4a23-b927-fa9249f2ffb2
message: TEST AUDIT
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
timestamp: 1431382121
start: 1428939600
total: 135
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_log_search'
- description: Paginated response for audit log search results
examples:
- end: 1428954000
limit: 100
results:
- admin_id: 72bfa2bd-e58a-4670-9d20-a1468f7a6f58
admin_name: test@mistsys.com
id: c6f9347b-b0a4-4a23-b927-fa9249f2ffb2
message: TEST AUDIT
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
timestamp: 1431382121
start: 1428939600
total: 135
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 1428954000
limit: 100
results:
- admin_id: 72bfa2bd-e58a-4670-9d20-a1468f7a6f58
admin_name: test@mistsys.com
id: c6f9347b-b0a4-4a23-b927-fa9249f2ffb2
message: TEST AUDIT
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
timestamp: 1431382121
start: 1428939600
total: 135
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: true
parameters: []
/api/v1/orgs/{org_id}/logs/count:
get:
tags:
- Orgs Logs
summary: countOrgAuditLogs
description: Count organization audit log records, optionally grouped by `distinct` and filtered by administrator, site, message text, and time range.
operationId: countOrgAuditLogs
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field used to group this count response. enum: `admin_id`, `admin_name`, `message`, `site_id`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/org_logs_count_distinct'
- description: 'Field used to group this count response. enum: `admin_id`, `admin_name`, `message`, `site_id`'
- name: admin_id
in: query
description: Filter audit log results by administrator identifier
style: form
explode: true
schema:
type: string
contentEncoding: uuid
examples:
- 4ac1dcf4-9d8b-7211-65c4-057819f0862b
- name: admin_name
in: query
description: Filter audit log results by one or more administrator names. Supports comma-separated values
style: form
explode: true
schema:
type: string
examples:
- John Doe
- name: site_id
in: query
description: Filter results by site identifier
style: form
explode: true
schema:
type: string
contentEncoding: uuid
examples:
- 4ac1dcf4-9d8b-7211-65c4-057819f0862b
- name: message
in: query
description: Filter log results by message text
style: form
explode: true
schema:
type: string
examples:
- Created a new site
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/logs/search:
get:
tags:
- Orgs Logs
summary: listOrgAuditLogs
description: Get a list of change logs for the current Org
operationId: listOrgAuditLogs
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: site_id
in: query
description: Filter results by site identifier. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- 00000000-0000-0000-0000-000000000001,00000000-0000-0000-0000-000000000002
- 4ac1dcf4-9d8b-7211-65c4-057819f0862b
examples:
Untitled Example1:
value: 00000000-0000-0000-0000-000000000001,00000000-0000-0000-0000-000000000002
Untitled Example2:
value: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
- name: admin_name
in: query
description: Filter results by one or more administrator names or email addresses. Supports comma-separated values
style: form
explode: true
schema:
type: string
examples:
- John Doe
- name: message
in: query
description: Filter results by one or more message text values. Supports comma-separated values
style: form
explode: true
schema:
type: string
examples:
- Created a new site
- name: sort
in: query
description: 'Field used to sort results; a leading `-` indicates descending order. enum: `-timestamp`, `admin_id`, `site_id`, `timestamp`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/list_org_logs_sort'
- description: 'Field used to sort results; a leading `-` indicates descending order. enum: `-timestamp`, `admin_id`, `site_id`, `timestamp`'
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_log_search'
- description: Paginated response for audit log search results
examples:
- end: 1428954000
limit: 100
results:
- admin_id: 72bfa2bd-e58a-4670-9d20-a1468f7a6f58
admin_name: test@mistsys.com
id: c6f9347b-b0a4-4a23-b927-fa9249f2ffb2
message: TEST AUDIT
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
timestamp: 1431382121
start: 1428939600
total: 135
contentMediaType: application/json
examples:
Example:
value:
end: 1428954000
limit: 100
results:
- admin_id: 72bfa2bd-e58a-4670-9d20-a1468f7a6f58
admin_name: test@mistsys.com
id: c6f9347b-b0a4-4a23-b927-fa9249f2ffb2
message: TEST AUDIT
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
timestamp: 1431382121
start: 1428939600
total: 135
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_log_search'
- description: Paginated response for audit log search results
examples:
- end: 1428954000
limit: 100
results:
- admin_id: 72bfa2bd-e58a-4670-9d20-a1468f7a6f58
admin_name: test@mistsys.com
id: c6f9347b-b0a4-4a23-b927-fa9249f2ffb2
message: TEST AUDIT
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
timestamp: 1431382121
start: 1428939600
total: 135
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 1428954000
limit: 100
results:
- admin_id: 72bfa2bd-e58a-4670-9d20-a1468f7a6f58
admin_name: test@mistsys.com
id: c6f9347b-b0a4-4a23-b927-fa9249f2ffb2
message: TEST AUDIT
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
timestamp: 1431382121
start: 1428939600
total: 135
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/troubleshoot:
get:
tags:
- Orgs Marvis
summary: troubleshootOrg
description: >-
Troubleshoot sites, devices, clients, and wired clients for maximum of last 7 days from current time. See search APIs for device information:
- [search Device]($e/Orgs%20Devices/searchOrgDevices)
- [search Wireless Client]($e/Orgs%20Clients%20-%20Wireless/searchOrgWirelessClients)
- [search Wired Client]($e/Orgs%20Clients%20-%20Wired/searchOrgWiredClients)
- [search Wan Client]($e/Orgs%20Clients%20-%20Wan/searchOrgWanClients)
**NOTE**: requires Marvis subscription license
operationId: troubleshootOrg
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: mac
in: query
description: '**required** when troubleshooting device or a client'
style: form
explode: true
schema:
type: string
- name: site_id
in: query
description: '**required** when troubleshooting site'
style: form
explode: true
schema:
type: string
contentEncoding: uuid
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: type
in: query
description: 'When troubleshooting site, type of network to troubleshoot. enum: `wan`, `wired`, `wireless`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/troubleshoot_type'
- description: 'When troubleshooting site, type of network to troubleshoot. enum: `wan`, `wired`, `wireless`'
responses:
'200':
description: Troubleshoot Response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_troubleshoot'
- description: Organization troubleshooting response for the requested time window
examples:
- end: 1655151856
results:
- category: client
reason: slow association
recommendation: Ensure the IP helper-address is configured on the VLAN interface.
text: Clients of the AP had slow association 8% of the time on Bhavabhi and 5 GHz. ...
start: 1655065456
contentMediaType: application/json
examples:
Example:
value:
end: 1655151856
results:
- category: client
reason: slow association
recommendation: Ensure the IP helper-address is configured on the VLAN interface.
text: Clients of the AP had slow association 8% of the time on Bhavabhi and 5 GHz. ...
start: 1655065456
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_troubleshoot'
- description: Organization troubleshooting response for the requested time window
examples:
- end: 1655151856
results:
- category: client
reason: slow association
recommendation: Ensure the IP helper-address is configured on the VLAN interface.
text: Clients of the AP had slow association 8% of the time on Bhavabhi and 5 GHz. ...
start: 1655065456
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 1655151856
results:
- category: client
reason: slow association
recommendation: Ensure the IP helper-address is configured on the VLAN interface.
text: Clients of the AP had slow association 8% of the time on Bhavabhi and 5 GHz. ...
start: 1655065456
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/maps/import:
post:
tags:
- Orgs Maps
summary: importOrgMaps
description: >-
Import data from files is a multipart POST which has a file, an optional json, and an optional csv, to create floorplan, assign matching inventory to specific site, place ap if name or mac matches
### CSV File Format
```csv
Vendor AP name,Mist AP Mac
US Office AP-2 - 5c:5b:35:00:00:02,5c5b35000002
```
operationId: importOrgMaps
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
content:
multipart/form-data:
encoding: {}
schema:
type: object
properties:
auto_deviceprofile_assignment:
type: boolean
description: Whether to auto assign device to deviceprofile by name
examples:
- true
csv:
type: string
description: Optional AP name-mapping CSV file
contentEncoding: base64
file:
type: string
description: Ekahau or iBwave floorplan file to import
contentEncoding: base64
json:
allOf:
- $ref: '#/components/schemas/map_org_import_file_json2'
- description: Import options for the organization map file
contentMediaType: multipart/form-data
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_map_import'
- description: Result of importing map files and matching AP placements
examples:
- '{"aps":[{"action":"assigned-placed","floorplan_id":"6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9","height":3,"mac":"5c5b35000001","map_id":"845a23bf-bed9-e43c-4c86-6fa474be7ae5","orientation":45}],"floorplans":[{"action":"imported","id":"cbdb7f0b-3be0-4872-88f9-58790b509c23","map_id":"845a23bf-bed9-e43c-4c86-6fa474be7ae5","name":"map1"}],"site_id":"4ac1dcf4-9d8b-7211-65c4-057819f0862b","summary":{"num_ap_assigned":1,"num_inv_assigned":1,"num_map_assigned":1}}'
- '{"aps":[{"action":"assigned-named-placed","floorplan_id":"6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9","mac":"5c5b35000001","map_id":"845a23bf-bed9-e43c-4c86-6fa474be7ae5","orientation":45}],"floorplans":[{"action":"imported","id":"cbdb7f0b-3be0-4872-88f9-58790b509c23","map_id":"845a23bf-bed9-e43c-4c86-6fa474be7ae5","name":"map1"}],"site_id":"4ac1dcf4-9d8b-7211-65c4-057819f0862b","summary":{"num_ap_assigned":1,"num_inv_assigned":1,"num_map_assigned":1}}'
- '{"aps":[{"action":"placed","floorplan_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","height":3,"mac":"5c5b35000001","map_id":"845a23bf-bed9-e43c-4c86-6fa474be7ae5","orientation":45}],"floorplans":[{"action":"imported","id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","map_id":"845a23bf-bed9-e43c-4c86-6fa474be7ae5","name":"map1"}],"site_id":"4ac1dcf4-9d8b-7211-65c4-057819f0862b","summary":{"num_ap_assigned":1,"num_inv_assigned":1,"num_map_assigned":1}}'
contentMediaType: application/json
examples:
Assigned And Placed:
value:
aps:
- action: assigned-placed
floorplan_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
height: 3
mac: 5c5b35000001
map_id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
orientation: 45
floorplans:
- action: imported
id: cbdb7f0b-3be0-4872-88f9-58790b509c23
map_id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
name: map1
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
summary:
num_ap_assigned: 1
num_inv_assigned: 1
num_map_assigned: 1
Assigned Named And Placed:
value:
aps:
- action: assigned-named-placed
floorplan_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
mac: 5c5b35000001
map_id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
orientation: 45
floorplans:
- action: imported
id: cbdb7f0b-3be0-4872-88f9-58790b509c23
map_id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
name: map1
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
summary:
num_ap_assigned: 1
num_inv_assigned: 1
num_map_assigned: 1
Placed:
value:
aps:
- action: placed
floorplan_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
height: 3
mac: 5c5b35000001
map_id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
orientation: 45
floorplans:
- action: imported
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
map_id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
name: map1
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
summary:
num_ap_assigned: 1
num_inv_assigned: 1
num_map_assigned: 1
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_map_import'
- description: Result of importing map files and matching AP placements
examples:
- '{"aps":[{"action":"assigned-placed","floorplan_id":"6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9","height":3,"mac":"5c5b35000001","map_id":"845a23bf-bed9-e43c-4c86-6fa474be7ae5","orientation":45}],"floorplans":[{"action":"imported","id":"cbdb7f0b-3be0-4872-88f9-58790b509c23","map_id":"845a23bf-bed9-e43c-4c86-6fa474be7ae5","name":"map1"}],"site_id":"4ac1dcf4-9d8b-7211-65c4-057819f0862b","summary":{"num_ap_assigned":1,"num_inv_assigned":1,"num_map_assigned":1}}'
- '{"aps":[{"action":"assigned-named-placed","floorplan_id":"6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9","mac":"5c5b35000001","map_id":"845a23bf-bed9-e43c-4c86-6fa474be7ae5","orientation":45}],"floorplans":[{"action":"imported","id":"cbdb7f0b-3be0-4872-88f9-58790b509c23","map_id":"845a23bf-bed9-e43c-4c86-6fa474be7ae5","name":"map1"}],"site_id":"4ac1dcf4-9d8b-7211-65c4-057819f0862b","summary":{"num_ap_assigned":1,"num_inv_assigned":1,"num_map_assigned":1}}'
- '{"aps":[{"action":"placed","floorplan_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","height":3,"mac":"5c5b35000001","map_id":"845a23bf-bed9-e43c-4c86-6fa474be7ae5","orientation":45}],"floorplans":[{"action":"imported","id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","map_id":"845a23bf-bed9-e43c-4c86-6fa474be7ae5","name":"map1"}],"site_id":"4ac1dcf4-9d8b-7211-65c4-057819f0862b","summary":{"num_ap_assigned":1,"num_inv_assigned":1,"num_map_assigned":1}}'
contentMediaType: application/vnd.api+json
examples:
Assigned And Placed:
value:
aps:
- action: assigned-placed
floorplan_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
height: 3
mac: 5c5b35000001
map_id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
orientation: 45
floorplans:
- action: imported
id: cbdb7f0b-3be0-4872-88f9-58790b509c23
map_id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
name: map1
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
summary:
num_ap_assigned: 1
num_inv_assigned: 1
num_map_assigned: 1
Assigned Named And Placed:
value:
aps:
- action: assigned-named-placed
floorplan_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
mac: 5c5b35000001
map_id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
orientation: 45
floorplans:
- action: imported
id: cbdb7f0b-3be0-4872-88f9-58790b509c23
map_id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
name: map1
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
summary:
num_ap_assigned: 1
num_inv_assigned: 1
num_map_assigned: 1
Placed:
value:
aps:
- action: placed
floorplan_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
height: 3
mac: 5c5b35000001
map_id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
orientation: 45
floorplans:
- action: imported
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
map_id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
name: map1
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
summary:
num_ap_assigned: 1
num_inv_assigned: 1
num_map_assigned: 1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/sites/{site_name}/maps/import:
post:
tags:
- Orgs Maps
summary: importOrgMapToSite
description: Import floorplan data into a site from a multipart upload. The upload includes an Ekahau or iBwave floorplan file, optional import options JSON, and optional AP name-mapping CSV; matching inventory can be assigned to the site and APs placed when names or MAC addresses match.
operationId: importOrgMapToSite
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: site_name
in: path
description: ''
required: true
schema:
type: string
requestBody:
content:
multipart/form-data:
encoding: {}
schema:
type: object
properties:
auto_deviceprofile_assignment:
type: boolean
description: Whether to auto assign device to deviceprofile by name
examples:
- true
csv:
type: string
description: Optional AP name-mapping CSV file
contentEncoding: base64
file:
type: string
description: Ekahau or iBwave floorplan file to import
contentEncoding: base64
json:
allOf:
- $ref: '#/components/schemas/map_import_json1'
- description: Import options for the site map file
contentMediaType: multipart/form-data
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_map_import'
- description: Result of importing map files and matching AP placements
examples:
- '{"aps":[{"action":"assigned-placed","floorplan_id":"6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9","height":3,"mac":"5c5b35000001","map_id":"845a23bf-bed9-e43c-4c86-6fa474be7ae5","orientation":45}],"floorplans":[{"action":"imported","id":"cbdb7f0b-3be0-4872-88f9-58790b509c23","map_id":"845a23bf-bed9-e43c-4c86-6fa474be7ae5","name":"map1"}],"site_id":"4ac1dcf4-9d8b-7211-65c4-057819f0862b","summary":{"num_ap_assigned":1,"num_inv_assigned":1,"num_map_assigned":1}}'
- '{"aps":[{"action":"assigned-named-placed","floorplan_id":"6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9","mac":"5c5b35000001","map_id":"845a23bf-bed9-e43c-4c86-6fa474be7ae5","orientation":45}],"floorplans":[{"action":"imported","id":"cbdb7f0b-3be0-4872-88f9-58790b509c23","map_id":"845a23bf-bed9-e43c-4c86-6fa474be7ae5","name":"map1"}],"site_id":"4ac1dcf4-9d8b-7211-65c4-057819f0862b","summary":{"num_ap_assigned":1,"num_inv_assigned":1,"num_map_assigned":1}}'
- '{"aps":[{"action":"placed","floorplan_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","height":3,"mac":"5c5b35000001","map_id":"845a23bf-bed9-e43c-4c86-6fa474be7ae5","orientation":45}],"floorplans":[{"action":"imported","id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","map_id":"845a23bf-bed9-e43c-4c86-6fa474be7ae5","name":"map1"}],"site_id":"4ac1dcf4-9d8b-7211-65c4-057819f0862b","summary":{"num_ap_assigned":1,"num_inv_assigned":1,"num_map_assigned":1}}'
contentMediaType: application/json
examples:
Assigned And Placed:
value:
aps:
- action: assigned-placed
floorplan_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
height: 3
mac: 5c5b35000001
map_id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
orientation: 45
floorplans:
- action: imported
id: cbdb7f0b-3be0-4872-88f9-58790b509c23
map_id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
name: map1
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
summary:
num_ap_assigned: 1
num_inv_assigned: 1
num_map_assigned: 1
Assigned Named And Placed:
value:
aps:
- action: assigned-named-placed
floorplan_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
mac: 5c5b35000001
map_id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
orientation: 45
floorplans:
- action: imported
id: cbdb7f0b-3be0-4872-88f9-58790b509c23
map_id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
name: map1
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
summary:
num_ap_assigned: 1
num_inv_assigned: 1
num_map_assigned: 1
Placed:
value:
aps:
- action: placed
floorplan_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
height: 3
mac: 5c5b35000001
map_id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
orientation: 45
floorplans:
- action: imported
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
map_id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
name: map1
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
summary:
num_ap_assigned: 1
num_inv_assigned: 1
num_map_assigned: 1
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_map_import'
- description: Result of importing map files and matching AP placements
examples:
- '{"aps":[{"action":"assigned-placed","floorplan_id":"6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9","height":3,"mac":"5c5b35000001","map_id":"845a23bf-bed9-e43c-4c86-6fa474be7ae5","orientation":45}],"floorplans":[{"action":"imported","id":"cbdb7f0b-3be0-4872-88f9-58790b509c23","map_id":"845a23bf-bed9-e43c-4c86-6fa474be7ae5","name":"map1"}],"site_id":"4ac1dcf4-9d8b-7211-65c4-057819f0862b","summary":{"num_ap_assigned":1,"num_inv_assigned":1,"num_map_assigned":1}}'
- '{"aps":[{"action":"assigned-named-placed","floorplan_id":"6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9","mac":"5c5b35000001","map_id":"845a23bf-bed9-e43c-4c86-6fa474be7ae5","orientation":45}],"floorplans":[{"action":"imported","id":"cbdb7f0b-3be0-4872-88f9-58790b509c23","map_id":"845a23bf-bed9-e43c-4c86-6fa474be7ae5","name":"map1"}],"site_id":"4ac1dcf4-9d8b-7211-65c4-057819f0862b","summary":{"num_ap_assigned":1,"num_inv_assigned":1,"num_map_assigned":1}}'
- '{"aps":[{"action":"placed","floorplan_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","height":3,"mac":"5c5b35000001","map_id":"845a23bf-bed9-e43c-4c86-6fa474be7ae5","orientation":45}],"floorplans":[{"action":"imported","id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","map_id":"845a23bf-bed9-e43c-4c86-6fa474be7ae5","name":"map1"}],"site_id":"4ac1dcf4-9d8b-7211-65c4-057819f0862b","summary":{"num_ap_assigned":1,"num_inv_assigned":1,"num_map_assigned":1}}'
contentMediaType: application/vnd.api+json
examples:
Assigned And Placed:
value:
aps:
- action: assigned-placed
floorplan_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
height: 3
mac: 5c5b35000001
map_id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
orientation: 45
floorplans:
- action: imported
id: cbdb7f0b-3be0-4872-88f9-58790b509c23
map_id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
name: map1
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
summary:
num_ap_assigned: 1
num_inv_assigned: 1
num_map_assigned: 1
Assigned Named And Placed:
value:
aps:
- action: assigned-named-placed
floorplan_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
mac: 5c5b35000001
map_id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
orientation: 45
floorplans:
- action: imported
id: cbdb7f0b-3be0-4872-88f9-58790b509c23
map_id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
name: map1
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
summary:
num_ap_assigned: 1
num_inv_assigned: 1
num_map_assigned: 1
Placed:
value:
aps:
- action: placed
floorplan_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
height: 3
mac: 5c5b35000001
map_id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
orientation: 45
floorplans:
- action: imported
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
map_id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
name: map1
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
summary:
num_ap_assigned: 1
num_inv_assigned: 1
num_map_assigned: 1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/mxclusters:
get:
tags:
- Orgs MxClusters
summary: listOrgMxEdgeClusters
description: List Mist Edge clusters in the organization, which group one or more Mist Edge devices for tunneling, RadSec, and related edge services.
operationId: listOrgMxEdgeClusters
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/mxcluster'
description: List of Mist Edge clusters
examples:
- - created_time: 0
for_site: true
id: 467f6eca-6276-4993-bfeb-53cbbbba6f78
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
radsec:
acct_servers:
- host: string
port: 1813
secret: string
auth_servers:
- host: string
port: 1812
secret: string
enabled: true
server_selection: ordered
radsec_tls:
keypair: string
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
tunterm_ap_subnets:
- string
tunterm_dhcpd_config:
enabled: false
property1:
enabled: false
servers:
- string
type: relay
property2:
enabled: false
servers:
- string
type: relay
servers:
- string
type: relay
tunterm_extra_routes:
property1:
via: string
property2:
via: string
tunterm_hosts:
- string
contentMediaType: application/json
examples:
Example:
value:
- created_time: 0
for_site: true
id: 467f6eca-6276-4993-bfeb-53cbbbba6f78
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
radsec:
acct_servers:
- host: string
port: 1813
secret: string
auth_servers:
- host: string
port: 1812
secret: string
enabled: true
server_selection: ordered
radsec_tls:
keypair: string
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
tunterm_ap_subnets:
- string
tunterm_dhcpd_config:
enabled: false
property1:
enabled: false
servers:
- string
type: relay
property2:
enabled: false
servers:
- string
type: relay
servers:
- string
type: relay
tunterm_extra_routes:
property1:
via: string
property2:
via: string
tunterm_hosts:
- string
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/mxcluster'
description: List of Mist Edge clusters
examples:
- - created_time: 0
for_site: true
id: 467f6eca-6276-4993-bfeb-53cbbbba6f78
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
radsec:
acct_servers:
- host: string
port: 1813
secret: string
auth_servers:
- host: string
port: 1812
secret: string
enabled: true
server_selection: ordered
radsec_tls:
keypair: string
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
tunterm_ap_subnets:
- string
tunterm_dhcpd_config:
enabled: false
property1:
enabled: false
servers:
- string
type: relay
property2:
enabled: false
servers:
- string
type: relay
servers:
- string
type: relay
tunterm_extra_routes:
property1:
via: string
property2:
via: string
tunterm_hosts:
- string
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- created_time: 0
for_site: true
id: 467f6eca-6276-4993-bfeb-53cbbbba6f78
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
radsec:
acct_servers:
- host: string
port: 1813
secret: string
auth_servers:
- host: string
port: 1812
secret: string
enabled: true
server_selection: ordered
radsec_tls:
keypair: string
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
tunterm_ap_subnets:
- string
tunterm_dhcpd_config:
enabled: false
property1:
enabled: false
servers:
- string
type: relay
property2:
enabled: false
servers:
- string
type: relay
servers:
- string
type: relay
tunterm_extra_routes:
property1:
via: string
property2:
via: string
tunterm_hosts:
- string
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs MxClusters
summary: createOrgMxEdgeCluster
description: >-
Create a Mist Edge cluster with tunnel termination, RadSec, NAC,
and management settings.
**Note**: It is not recommended to combine multiple roles (tunnel termination, RadSec, NAC) on the same Mist Edge cluster
operationId: createOrgMxEdgeCluster
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/mxcluster'
- description: Request Body
examples:
- name: string
radsec:
auth_servers:
- host: string
port: 0
enabled: true
tunterm_ap_subnets:
- string
tunterm_hosts:
- string
contentMediaType: application/json
examples:
Example:
value:
name: string
radsec:
auth_servers:
- host: string
port: 0
enabled: true
tunterm_ap_subnets:
- string
tunterm_hosts:
- string
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/mxcluster'
- description: Mist Edge cluster that groups one or more Mist Edge devices for tunneling, RadSec, and related edge services
examples:
- created_time: 0
for_site: true
id: 468f6eca-6276-4993-bfeb-53cbbbba6f68
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
radsec:
acct_servers:
- host: string
port: 1813
secret: string
auth_servers:
- host: string
port: 1812
secret: string
enabled: true
server_selection: ordered
radsec_tls:
keypair: string
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
tunterm_ap_subnets:
- string
tunterm_dhcpd_config:
enabled: false
property1:
enabled: false
servers:
- string
type: relay
property2:
enabled: false
servers:
- string
type: relay
servers:
- string
type: relay
tunterm_extra_routes:
property1:
via: string
property2:
via: string
tunterm_hosts:
- string
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
for_site: true
id: 468f6eca-6276-4993-bfeb-53cbbbba6f68
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
radsec:
acct_servers:
- host: string
port: 1813
secret: string
auth_servers:
- host: string
port: 1812
secret: string
enabled: true
server_selection: ordered
radsec_tls:
keypair: string
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
tunterm_ap_subnets:
- string
tunterm_dhcpd_config:
enabled: false
property1:
enabled: false
servers:
- string
type: relay
property2:
enabled: false
servers:
- string
type: relay
servers:
- string
type: relay
tunterm_extra_routes:
property1:
via: string
property2:
via: string
tunterm_hosts:
- string
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/mxcluster'
- description: Mist Edge cluster that groups one or more Mist Edge devices for tunneling, RadSec, and related edge services
examples:
- created_time: 0
for_site: true
id: 468f6eca-6276-4993-bfeb-53cbbbba6f68
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
radsec:
acct_servers:
- host: string
port: 1813
secret: string
auth_servers:
- host: string
port: 1812
secret: string
enabled: true
server_selection: ordered
radsec_tls:
keypair: string
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
tunterm_ap_subnets:
- string
tunterm_dhcpd_config:
enabled: false
property1:
enabled: false
servers:
- string
type: relay
property2:
enabled: false
servers:
- string
type: relay
servers:
- string
type: relay
tunterm_extra_routes:
property1:
via: string
property2:
via: string
tunterm_hosts:
- string
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
for_site: true
id: 468f6eca-6276-4993-bfeb-53cbbbba6f68
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
radsec:
acct_servers:
- host: string
port: 1813
secret: string
auth_servers:
- host: string
port: 1812
secret: string
enabled: true
server_selection: ordered
radsec_tls:
keypair: string
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
tunterm_ap_subnets:
- string
tunterm_dhcpd_config:
enabled: false
property1:
enabled: false
servers:
- string
type: relay
property2:
enabled: false
servers:
- string
type: relay
servers:
- string
type: relay
tunterm_extra_routes:
property1:
via: string
property2:
via: string
tunterm_hosts:
- string
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/mxclusters/{mxcluster_id}:
delete:
tags:
- Orgs MxClusters
summary: deleteOrgMxEdgeCluster
description: Delete a Mist Edge cluster by cluster ID, removing its cluster configuration from the organization.
operationId: deleteOrgMxEdgeCluster
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: mxcluster_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Orgs MxClusters
summary: getOrgMxEdgeCluster
description: Retrieve configuration details for a specific Mist Edge cluster, including tunneling, RadSec, NAC, and management settings.
operationId: getOrgMxEdgeCluster
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: mxcluster_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/mxcluster'
- description: Mist Edge cluster that groups one or more Mist Edge devices for tunneling, RadSec, and related edge services
examples:
- created_time: 0
for_site: true
id: 468f6eca-6276-4993-bfeb-53cbbbba6f68
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
radsec:
acct_servers:
- host: string
port: 1813
secret: string
auth_servers:
- host: string
port: 1812
secret: string
enabled: true
server_selection: ordered
radsec_tls:
keypair: string
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
tunterm_ap_subnets:
- string
tunterm_dhcpd_config:
enabled: false
property1:
enabled: false
servers:
- string
type: relay
property2:
enabled: false
servers:
- string
type: relay
servers:
- string
type: relay
tunterm_extra_routes:
property1:
via: string
property2:
via: string
tunterm_hosts:
- string
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
for_site: true
id: 468f6eca-6276-4993-bfeb-53cbbbba6f68
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
radsec:
acct_servers:
- host: string
port: 1813
secret: string
auth_servers:
- host: string
port: 1812
secret: string
enabled: true
server_selection: ordered
radsec_tls:
keypair: string
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
tunterm_ap_subnets:
- string
tunterm_dhcpd_config:
enabled: false
property1:
enabled: false
servers:
- string
type: relay
property2:
enabled: false
servers:
- string
type: relay
servers:
- string
type: relay
tunterm_extra_routes:
property1:
via: string
property2:
via: string
tunterm_hosts:
- string
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/mxcluster'
- description: Mist Edge cluster that groups one or more Mist Edge devices for tunneling, RadSec, and related edge services
examples:
- created_time: 0
for_site: true
id: 468f6eca-6276-4993-bfeb-53cbbbba6f68
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
radsec:
acct_servers:
- host: string
port: 1813
secret: string
auth_servers:
- host: string
port: 1812
secret: string
enabled: true
server_selection: ordered
radsec_tls:
keypair: string
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
tunterm_ap_subnets:
- string
tunterm_dhcpd_config:
enabled: false
property1:
enabled: false
servers:
- string
type: relay
property2:
enabled: false
servers:
- string
type: relay
servers:
- string
type: relay
tunterm_extra_routes:
property1:
via: string
property2:
via: string
tunterm_hosts:
- string
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
for_site: true
id: 468f6eca-6276-4993-bfeb-53cbbbba6f68
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
radsec:
acct_servers:
- host: string
port: 1813
secret: string
auth_servers:
- host: string
port: 1812
secret: string
enabled: true
server_selection: ordered
radsec_tls:
keypair: string
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
tunterm_ap_subnets:
- string
tunterm_dhcpd_config:
enabled: false
property1:
enabled: false
servers:
- string
type: relay
property2:
enabled: false
servers:
- string
type: relay
servers:
- string
type: relay
tunterm_extra_routes:
property1:
via: string
property2:
via: string
tunterm_hosts:
- string
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Orgs MxClusters
summary: updateOrgMxEdgeCluster
description: Update a Mist Edge cluster's tunneling, RadSec, NAC, and management settings.
operationId: updateOrgMxEdgeCluster
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: mxcluster_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/mxcluster'
- description: Request Body
examples:
- name: string
radsec:
auth_servers:
- host: string
port: 0
enabled: true
tunterm_ap_subnets:
- string
tunterm_hosts:
- string
contentMediaType: application/json
examples:
Example:
value:
name: string
radsec:
auth_servers:
- host: string
port: 0
enabled: true
tunterm_ap_subnets:
- string
tunterm_hosts:
- string
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/mxcluster'
- description: Mist Edge cluster that groups one or more Mist Edge devices for tunneling, RadSec, and related edge services
examples:
- created_time: 0
for_site: true
id: 468f6eca-6276-4993-bfeb-53cbbbba6f68
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
radsec:
acct_servers:
- host: string
port: 1813
secret: string
auth_servers:
- host: string
port: 1812
secret: string
enabled: true
server_selection: ordered
radsec_tls:
keypair: string
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
tunterm_ap_subnets:
- string
tunterm_dhcpd_config:
enabled: false
property1:
enabled: false
servers:
- string
type: relay
property2:
enabled: false
servers:
- string
type: relay
servers:
- string
type: relay
tunterm_extra_routes:
property1:
via: string
property2:
via: string
tunterm_hosts:
- string
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
for_site: true
id: 468f6eca-6276-4993-bfeb-53cbbbba6f68
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
radsec:
acct_servers:
- host: string
port: 1813
secret: string
auth_servers:
- host: string
port: 1812
secret: string
enabled: true
server_selection: ordered
radsec_tls:
keypair: string
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
tunterm_ap_subnets:
- string
tunterm_dhcpd_config:
enabled: false
property1:
enabled: false
servers:
- string
type: relay
property2:
enabled: false
servers:
- string
type: relay
servers:
- string
type: relay
tunterm_extra_routes:
property1:
via: string
property2:
via: string
tunterm_hosts:
- string
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/mxcluster'
- description: Mist Edge cluster that groups one or more Mist Edge devices for tunneling, RadSec, and related edge services
examples:
- created_time: 0
for_site: true
id: 468f6eca-6276-4993-bfeb-53cbbbba6f68
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
radsec:
acct_servers:
- host: string
port: 1813
secret: string
auth_servers:
- host: string
port: 1812
secret: string
enabled: true
server_selection: ordered
radsec_tls:
keypair: string
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
tunterm_ap_subnets:
- string
tunterm_dhcpd_config:
enabled: false
property1:
enabled: false
servers:
- string
type: relay
property2:
enabled: false
servers:
- string
type: relay
servers:
- string
type: relay
tunterm_extra_routes:
property1:
via: string
property2:
via: string
tunterm_hosts:
- string
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
for_site: true
id: 468f6eca-6276-4993-bfeb-53cbbbba6f68
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
radsec:
acct_servers:
- host: string
port: 1813
secret: string
auth_servers:
- host: string
port: 1812
secret: string
enabled: true
server_selection: ordered
radsec_tls:
keypair: string
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
tunterm_ap_subnets:
- string
tunterm_dhcpd_config:
enabled: false
property1:
enabled: false
servers:
- string
type: relay
property2:
enabled: false
servers:
- string
type: relay
servers:
- string
type: relay
tunterm_extra_routes:
property1:
via: string
property2:
via: string
tunterm_hosts:
- string
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/mxedges:
get:
tags:
- Orgs MxEdges
summary: listOrgMxEdges
description: List Mist Edge appliances in the organization, optionally filtering for org-level, site-level, or all Mist Edges with `for_site`.
operationId: listOrgMxEdges
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: for_site
in: query
description: 'Filter for org/site level Mist Edges. enum: `any`, `false`, `true`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/mxedge_for_site'
- description: 'Filter for org/site level Mist Edges. enum: `any`, `false`, `true`'
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/mxedge'
description: List of Mist Edge appliances
examples:
- - cpu_stat:
cpus:
cpu0:
idle: 79
interrupt: 0
system: 4
usage: 20
user: 16
cpu1:
idle: 93
interrupt: 0
system: 4
usage: 6
user: 1
idle: 87
interrupt: 0
system: 5
usage: 12
user: 7
ext_ip: 116.187.144.16
id: 387804a7-3474-85ce-15a2-f9a9684c9c90
ip_stat:
ip: 172.16.5.3
ips:
ens192: 172.16.5.3/24,fe81::20c:29ff:fef8:d18e/64
lag_stat:
lag0:
active_ports:
- '0'
- '1'
last_seen: 1547437078
magic: ExNpT5gi-ADR8WTFd4EiQPY3cP5WdSoD
memory_stats:
active: 1061085184
available: 4124860416
buffers: 789495808
cached: 718016512
free: 2818838528
inactive: 458158080
swap_cached: 0
swap_free: 8161062912
swap_total: 8161062912
total: 7947616256
usage: 65
model: ME-S2019
mxagent_registered: false
mxcluster_id: 572586b7-f97b-a22b-526c-8b97a3f609c4
name: Guest
num_tunnels: 31
port_stat:
eth0:
full_duplex: true
lldp_stats:
mgmt_addr: 122.16.3.11
port_desc: GigabitEthernet4/0/16
port_id: "\x05Gi4/0/16"
system_desc: Cisco IOS Software
system_name: ME-DC2-DIS-SW
rx_bytes: 2056
rx_errors: 0
rx_pkts: 670
speed: 1000
tx_bytes: 2056
tx_pkts: 670
up: true
eth1:
up: false
module:
up: false
status: connected
tunterm_registered: false
tunterm_stat:
monitoring_failed: false
uptime: 884221
version: 0.1.2
virtualization_type: VirtualizationVMware
contentMediaType: application/json
examples:
Example:
value:
- cpu_stat:
cpus:
cpu0:
idle: 79
interrupt: 0
system: 4
usage: 20
user: 16
cpu1:
idle: 93
interrupt: 0
system: 4
usage: 6
user: 1
idle: 87
interrupt: 0
system: 5
usage: 12
user: 7
ext_ip: 116.187.144.16
id: 387804a7-3474-85ce-15a2-f9a9684c9c90
ip_stat:
ip: 172.16.5.3
ips:
ens192: 172.16.5.3/24,fe81::20c:29ff:fef8:d18e/64
lag_stat:
lag0:
active_ports:
- '0'
- '1'
last_seen: 1547437078
magic: ExNpT5gi-ADR8WTFd4EiQPY3cP5WdSoD
memory_stats:
active: 1061085184
available: 4124860416
buffers: 789495808
cached: 718016512
free: 2818838528
inactive: 458158080
swap_cached: 0
swap_free: 8161062912
swap_total: 8161062912
total: 7947616256
usage: 65
model: ME-S2019
mxagent_registered: false
mxcluster_id: 572586b7-f97b-a22b-526c-8b97a3f609c4
name: Guest
num_tunnels: 31
port_stat:
eth0:
full_duplex: true
lldp_stats:
mgmt_addr: 122.16.3.11
port_desc: GigabitEthernet4/0/16
port_id: "\x05Gi4/0/16"
system_desc: Cisco IOS Software
system_name: ME-DC2-DIS-SW
rx_bytes: 2056
rx_errors: 0
rx_pkts: 670
speed: 1000
tx_bytes: 2056
tx_pkts: 670
up: true
eth1:
up: false
module:
up: false
status: connected
tunterm_registered: false
tunterm_stat:
monitoring_failed: false
uptime: 884221
version: 0.1.2
virtualization_type: VirtualizationVMware
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/mxedge'
description: List of Mist Edge appliances
examples:
- - cpu_stat:
cpus:
cpu0:
idle: 79
interrupt: 0
system: 4
usage: 20
user: 16
cpu1:
idle: 93
interrupt: 0
system: 4
usage: 6
user: 1
idle: 87
interrupt: 0
system: 5
usage: 12
user: 7
ext_ip: 116.187.144.16
id: 387804a7-3474-85ce-15a2-f9a9684c9c90
ip_stat:
ip: 172.16.5.3
ips:
ens192: 172.16.5.3/24,fe81::20c:29ff:fef8:d18e/64
lag_stat:
lag0:
active_ports:
- '0'
- '1'
last_seen: 1547437078
magic: ExNpT5gi-ADR8WTFd4EiQPY3cP5WdSoD
memory_stats:
active: 1061085184
available: 4124860416
buffers: 789495808
cached: 718016512
free: 2818838528
inactive: 458158080
swap_cached: 0
swap_free: 8161062912
swap_total: 8161062912
total: 7947616256
usage: 65
model: ME-S2019
mxagent_registered: false
mxcluster_id: 572586b7-f97b-a22b-526c-8b97a3f609c4
name: Guest
num_tunnels: 31
port_stat:
eth0:
full_duplex: true
lldp_stats:
mgmt_addr: 122.16.3.11
port_desc: GigabitEthernet4/0/16
port_id: "\x05Gi4/0/16"
system_desc: Cisco IOS Software
system_name: ME-DC2-DIS-SW
rx_bytes: 2056
rx_errors: 0
rx_pkts: 670
speed: 1000
tx_bytes: 2056
tx_pkts: 670
up: true
eth1:
up: false
module:
up: false
status: connected
tunterm_registered: false
tunterm_stat:
monitoring_failed: false
uptime: 884221
version: 0.1.2
virtualization_type: VirtualizationVMware
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- cpu_stat:
cpus:
cpu0:
idle: 79
interrupt: 0
system: 4
usage: 20
user: 16
cpu1:
idle: 93
interrupt: 0
system: 4
usage: 6
user: 1
idle: 87
interrupt: 0
system: 5
usage: 12
user: 7
ext_ip: 116.187.144.16
id: 387804a7-3474-85ce-15a2-f9a9684c9c90
ip_stat:
ip: 172.16.5.3
ips:
ens192: 172.16.5.3/24,fe81::20c:29ff:fef8:d18e/64
lag_stat:
lag0:
active_ports:
- '0'
- '1'
last_seen: 1547437078
magic: ExNpT5gi-ADR8WTFd4EiQPY3cP5WdSoD
memory_stats:
active: 1061085184
available: 4124860416
buffers: 789495808
cached: 718016512
free: 2818838528
inactive: 458158080
swap_cached: 0
swap_free: 8161062912
swap_total: 8161062912
total: 7947616256
usage: 65
model: ME-S2019
mxagent_registered: false
mxcluster_id: 572586b7-f97b-a22b-526c-8b97a3f609c4
name: Guest
num_tunnels: 31
port_stat:
eth0:
full_duplex: true
lldp_stats:
mgmt_addr: 122.16.3.11
port_desc: GigabitEthernet4/0/16
port_id: "\x05Gi4/0/16"
system_desc: Cisco IOS Software
system_name: ME-DC2-DIS-SW
rx_bytes: 2056
rx_errors: 0
rx_pkts: 670
speed: 1000
tx_bytes: 2056
tx_pkts: 670
up: true
eth1:
up: false
module:
up: false
status: connected
tunterm_registered: false
tunterm_stat:
monitoring_failed: false
uptime: 884221
version: 0.1.2
virtualization_type: VirtualizationVMware
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs MxEdges
summary: createOrgMxEdge
description: Create a Mist Edge appliance configuration in the organization, including cluster assignment, management, services, and tunnel termination settings.
operationId: createOrgMxEdge
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/mxedge'
- description: Request Body
examples:
- model: ME-100
mxcluster_id: 572586b7-f97b-a22b-526c-8b97a3f609c4
mxedge_mgmt: {}
name: Guest
ntp_servers: []
oob_ip_config: {}
services:
- tunterm
tunterm_ip_config:
gateway: 10.2.1.254
ip: 10.2.1.1
netmask: 255.255.255.0
tunterm_port_config:
downstream_ports:
- '0'
- '1'
- '2'
- '3'
separate_upstream_downstream: true
upstream_port_vlan_id: 1
upstream_ports:
- '0'
- '1'
- '2'
- '3'
tunterm_switch_config:
'0':
port_vlan_id: 1
vlan_ids:
- 5
- 2
- 3
enabled: true
contentMediaType: application/json
examples:
Example:
value:
model: ME-100
mxcluster_id: 572586b7-f97b-a22b-526c-8b97a3f609c4
mxedge_mgmt: {}
name: Guest
ntp_servers: []
oob_ip_config: {}
services:
- tunterm
tunterm_ip_config:
gateway: 10.2.1.254
ip: 10.2.1.1
netmask: 255.255.255.0
tunterm_port_config:
downstream_ports:
- '0'
- '1'
- '2'
- '3'
separate_upstream_downstream: true
upstream_port_vlan_id: 1
upstream_ports:
- '0'
- '1'
- '2'
- '3'
tunterm_switch_config:
'0':
port_vlan_id: 1
vlan_ids:
- 5
- 2
- 3
enabled: true
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/mxedge'
- description: Mist Edge appliance configuration and registration state
examples:
- id: 95ddd29a-6a3c-929e-a431-51a5b09f36a6
magic: L-NpT5gi-ADR8WTFd4EiQPY3cP5WdSoD
model: ME-100
mxagent_registered: true
mxcluster_id: 572586b7-f97b-a22b-526c-8b97a3f609c4
mxedge_mgmt:
mist_password: MIST_PASSWORD
root_password: ROOT_PASSWORD
name: Guest
ntp_servers: []
oob_ip_config:
dns:
- 8.8.8.8
- 4.4.4.4
gateway: 10.2.1.254
ip: 10.2.1.10
netmask: 255.255.255.0
type: static
tunterm_dhcpd_config:
'2':
enabled: true
servers:
- 11.2.3.44
enabled: false
servers:
- 11.2.3.4
tunterm_extra_routes:
11.0.0.0/8:
via: 10.3.3.1
tunterm_ip_config:
gateway: 10.2.1.254
ip: 10.2.1.1
netmask: 255.255.255.0
contentMediaType: application/json
examples:
Example:
value:
id: 95ddd29a-6a3c-929e-a431-51a5b09f36a6
magic: L-NpT5gi-ADR8WTFd4EiQPY3cP5WdSoD
model: ME-100
mxagent_registered: true
mxcluster_id: 572586b7-f97b-a22b-526c-8b97a3f609c4
mxedge_mgmt:
mist_password: MIST_PASSWORD
root_password: ROOT_PASSWORD
name: Guest
ntp_servers: []
oob_ip_config:
dns:
- 8.8.8.8
- 4.4.4.4
gateway: 10.2.1.254
ip: 10.2.1.10
netmask: 255.255.255.0
type: static
tunterm_dhcpd_config:
'2':
enabled: true
servers:
- 11.2.3.44
enabled: false
servers:
- 11.2.3.4
tunterm_extra_routes:
11.0.0.0/8:
via: 10.3.3.1
tunterm_ip_config:
gateway: 10.2.1.254
ip: 10.2.1.1
netmask: 255.255.255.0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/mxedge'
- description: Mist Edge appliance configuration and registration state
examples:
- id: 95ddd29a-6a3c-929e-a431-51a5b09f36a6
magic: L-NpT5gi-ADR8WTFd4EiQPY3cP5WdSoD
model: ME-100
mxagent_registered: true
mxcluster_id: 572586b7-f97b-a22b-526c-8b97a3f609c4
mxedge_mgmt:
mist_password: MIST_PASSWORD
root_password: ROOT_PASSWORD
name: Guest
ntp_servers: []
oob_ip_config:
dns:
- 8.8.8.8
- 4.4.4.4
gateway: 10.2.1.254
ip: 10.2.1.10
netmask: 255.255.255.0
type: static
tunterm_dhcpd_config:
'2':
enabled: true
servers:
- 11.2.3.44
enabled: false
servers:
- 11.2.3.4
tunterm_extra_routes:
11.0.0.0/8:
via: 10.3.3.1
tunterm_ip_config:
gateway: 10.2.1.254
ip: 10.2.1.1
netmask: 255.255.255.0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
id: 95ddd29a-6a3c-929e-a431-51a5b09f36a6
magic: L-NpT5gi-ADR8WTFd4EiQPY3cP5WdSoD
model: ME-100
mxagent_registered: true
mxcluster_id: 572586b7-f97b-a22b-526c-8b97a3f609c4
mxedge_mgmt:
mist_password: MIST_PASSWORD
root_password: ROOT_PASSWORD
name: Guest
ntp_servers: []
oob_ip_config:
dns:
- 8.8.8.8
- 4.4.4.4
gateway: 10.2.1.254
ip: 10.2.1.10
netmask: 255.255.255.0
type: static
tunterm_dhcpd_config:
'2':
enabled: true
servers:
- 11.2.3.44
enabled: false
servers:
- 11.2.3.4
tunterm_extra_routes:
11.0.0.0/8:
via: 10.3.3.1
tunterm_ip_config:
gateway: 10.2.1.254
ip: 10.2.1.1
netmask: 255.255.255.0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/mxedges/assign:
post:
tags:
- Orgs MxEdges
summary: assignOrgMxEdgeToSite
description: Assign one or more Mist Edge appliances from the organization to a site by Mist Edge ID and site ID.
operationId: assignOrgMxEdgeToSite
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/mxedges_assign'
- description: Request Body
examples:
- mxedge_ids:
- 387804a7-3474-85ce-15a2-f9a9684c9c90
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
contentMediaType: application/json
examples:
Example:
value:
mxedge_ids:
- 387804a7-3474-85ce-15a2-f9a9684c9c90
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
required: false
responses:
'200':
description: OK - list only devices that has deviceprofile_id changed
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_assign_success'
- description: Assignment operation success response
examples:
- success:
- 5c5b350e0001
contentMediaType: application/json
examples:
Example:
value:
success:
- 5c5b350e0001
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_assign_success'
- description: Assignment operation success response
examples:
- success:
- 5c5b350e0001
contentMediaType: application/vnd.api+json
examples:
Example:
value:
success:
- 5c5b350e0001
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/mxedges/claim:
post:
tags:
- Orgs MxEdges
summary: claimOrgMxEdge
description: Claim one or more Mist Edge appliances into the organization using their claim codes.
operationId: claimOrgMxEdge
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
uniqueItems: true
type: array
items:
type: string
description: Request Body
examples:
- - 6JG8E-PTFV2-A9Z2N
- DVH4V-SNMSZ-PDXBR
contentMediaType: application/json
examples:
Example:
value:
- 6JG8E-PTFV2-A9Z2N
- DVH4V-SNMSZ-PDXBR
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_claim_mx_edge'
- description: Mist Edge claim response
examples:
- id: 95ddd29a-6a3c-929e-a431-51a5b09f36a6
magic: ExNpT5gi-ADR8WTFd4EiQPY3cP5WdSoD
contentMediaType: application/json
examples:
Example:
value:
id: 95ddd29a-6a3c-929e-a431-51a5b09f36a6
magic: ExNpT5gi-ADR8WTFd4EiQPY3cP5WdSoD
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_claim_mx_edge'
- description: Mist Edge claim response
examples:
- id: 95ddd29a-6a3c-929e-a431-51a5b09f36a6
magic: ExNpT5gi-ADR8WTFd4EiQPY3cP5WdSoD
contentMediaType: application/vnd.api+json
examples:
Example:
value:
id: 95ddd29a-6a3c-929e-a431-51a5b09f36a6
magic: ExNpT5gi-ADR8WTFd4EiQPY3cP5WdSoD
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/mxedges/count:
get:
tags:
- Orgs MxEdges
summary: countOrgMxEdges
description: Count organization Mist Edge records, optionally grouped by `distinct` and filtered by Mist Edge, cluster, site, model, distro, tunnel termination version, and time range.
operationId: countOrgMxEdges
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field used to group this count response. enum: `distro`, `model`, `mxcluster_id`, `site_id`, `tunterm_version`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/org_mxedge_count_distinct'
- description: 'Field used to group this count response. enum: `distro`, `model`, `mxcluster_id`, `site_id`, `tunterm_version`'
- name: mxedge_id
in: query
description: Filter results by Mist Edge identifier
style: form
explode: true
schema:
type: string
- name: site_id
in: query
description: Mist edge site id
style: form
explode: true
schema:
type: string
- name: mxcluster_id
in: query
description: Mist edge cluster id
style: form
explode: true
schema:
type: string
- name: model
in: query
description: Filter results by device model
style: form
explode: true
schema:
type: string
- name: distro
in: query
description: Debian code name (buster, bullseye)
style: form
explode: true
schema:
type: string
- name: tunterm_version
in: query
description: Filter results by tunnel termination version
style: form
explode: true
schema:
type: string
- name: sort
in: query
description: Field used to sort results
style: form
explode: true
schema:
type: string
- name: stats
in: query
description: Whether to return device stats, default is false
style: form
explode: true
schema:
type: boolean
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/mxedges/events/count:
get:
tags:
- Orgs MxEdges
summary: countOrgSiteMxEdgeEvents
description: Count Mist Edge event records across the organization, optionally grouped by `distinct` and filtered by Mist Edge, cluster, event type, service, and time range.
operationId: countOrgSiteMxEdgeEvents
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field used to group this count response. enum: `mxcluster_id`, `mxedge_id`, `package`, `type`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/org_mxedge_events_count_distinct'
- description: 'Field used to group this count response. enum: `mxcluster_id`, `mxedge_id`, `package`, `type`'
- name: mxedge_id
in: query
description: Filter results by Mist Edge identifier
style: form
explode: true
schema:
type: string
- name: mxcluster_id
in: query
description: Mist edge cluster id
style: form
explode: true
schema:
type: string
- name: type
in: query
description: See [List Device Events Definitions]($e/Constants%20Events/listDeviceEventsDefinitions)
style: form
explode: true
schema:
type: string
- name: service
in: query
description: Filter results by service name
style: form
explode: true
schema:
type: string
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/mxedges/events/search:
get:
tags:
- Orgs MxEdges
summary: searchOrgMistEdgeEvents
description: Search Mist Edge event records across the organization with filters for Mist Edge, cluster, event type, service, component, and time range.
operationId: searchOrgMistEdgeEvents
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: mxedge_id
in: query
description: Filter results by Mist Edge identifier
style: form
explode: true
schema:
type: string
- name: mxcluster_id
in: query
description: Mist edge cluster id
style: form
explode: true
schema:
type: string
- name: type
in: query
description: See [List Device Events Definitions]($e/Constants%20Events/listDeviceEventsDefinitions)
style: form
explode: true
schema:
type: string
- name: service
in: query
description: Filter results by service name
style: form
explode: true
schema:
type: string
- name: component
in: query
description: Filter results by component name
style: form
explode: true
schema:
type: string
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_mxedge_events_search'
- description: Search response for Mist Edge event records
examples:
- end: 1694708579
limit: 10
page: 3
results:
- mxcluster_id: 2815c917-58e7-472f-a190-bfd44fb58d05
mxedge_id: 00000000-0000-0000-1000-020000dc585c
org_id: f2695c32-0e83-4936-b1b2-96fc88051213
service: tunterm
timestamp: 1694678225.927
type: ME_SERVICE_STOPPED
start: 1694622179
contentMediaType: application/json
examples:
Example:
value:
end: 1694708579
limit: 10
page: 3
results:
- mxcluster_id: 2815c917-58e7-472f-a190-bfd44fb58d05
mxedge_id: 00000000-0000-0000-1000-020000dc585c
org_id: f2695c32-0e83-4936-b1b2-96fc88051213
service: tunterm
timestamp: 1694678225.927
type: ME_SERVICE_STOPPED
start: 1694622179
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_mxedge_events_search'
- description: Search response for Mist Edge event records
examples:
- end: 1694708579
limit: 10
page: 3
results:
- mxcluster_id: 2815c917-58e7-472f-a190-bfd44fb58d05
mxedge_id: 00000000-0000-0000-1000-020000dc585c
org_id: f2695c32-0e83-4936-b1b2-96fc88051213
service: tunterm
timestamp: 1694678225.927
type: ME_SERVICE_STOPPED
start: 1694622179
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 1694708579
limit: 10
page: 3
results:
- mxcluster_id: 2815c917-58e7-472f-a190-bfd44fb58d05
mxedge_id: 00000000-0000-0000-1000-020000dc585c
org_id: f2695c32-0e83-4936-b1b2-96fc88051213
service: tunterm
timestamp: 1694678225.927
type: ME_SERVICE_STOPPED
start: 1694622179
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/mxedges/search:
get:
tags:
- Orgs MxEdges
summary: searchOrgMxEdges
description: Search organization Mist Edge records with filters for hostname, Mist Edge, cluster, site, model, distro, tunnel termination version, and time range.
operationId: searchOrgMxEdges
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: hostname
in: query
description: Partial / full Device hostname. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `my-london*` and `*london*` match `my-london-1`). Suffix-only wildcards (e.g. `*london-1`) are not supported. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- my-london-1,my-london*
- my-london-1
- my-london*
- '*london*'
examples:
Untitled Example1:
value: my-london-1,my-london*
Untitled Example2:
value: my-london-1
Untitled Example3:
value: my-london*
Untitled Example4:
value: '*london*'
- name: mxedge_id
in: query
description: Filter results by Mist Edge identifier. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- 00000000-0000-0000-0000-000000000001,00000000-0000-0000-0000-000000000002
- name: mxcluster_id
in: query
description: Mist edge cluster id. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- 00000000-0000-0000-0000-000000000001,00000000-0000-0000-0000-000000000002
- name: model
in: query
description: Partial / full Device model. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `AP4*` and `*P4*` match `AP43`). Suffix-only wildcards (e.g. `*43`) are not supported. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- AP43,AP4*
- AP43
- AP4*
- '*P4*'
examples:
Untitled Example1:
value: AP43,AP4*
Untitled Example2:
value: AP43
Untitled Example3:
value: AP4*
Untitled Example4:
value: '*P4*'
- name: distro
in: query
description: Debian code name (buster, bullseye)
style: form
explode: true
schema:
type: string
- name: tunterm_version
in: query
description: Filter results by tunnel termination version
style: form
explode: true
schema:
type: string
- name: site_id
in: query
description: Mist edge site id
style: form
explode: true
schema:
type: string
- name: stats
in: query
description: Whether to return device stats, default is false
style: form
explode: true
schema:
type: boolean
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_mxedge_search'
- description: Search response for Mist Edge records
examples:
- end: 1694708579
limit: 10
results:
- distro: buster
last_seen: 1695151551.833
model: ME-X5
mxedge_id: 00000000-0000-0000-1000-d420b0f0025d
org_id: 35d96b1a-1a13-4ba8-90f5-1e78dd2a10c5
tunterm_version: 0.1.2813
uptime: 5662632
start: 1694622179
total: 2
contentMediaType: application/json
examples:
Example:
value:
end: 1694708579
limit: 10
results:
- distro: buster
last_seen: 1695151551.833
model: ME-X5
mxedge_id: 00000000-0000-0000-1000-d420b0f0025d
org_id: 35d96b1a-1a13-4ba8-90f5-1e78dd2a10c5
tunterm_version: 0.1.2813
uptime: 5662632
start: 1694622179
total: 2
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_mxedge_search'
- description: Search response for Mist Edge records
examples:
- end: 1694708579
limit: 10
results:
- distro: buster
last_seen: 1695151551.833
model: ME-X5
mxedge_id: 00000000-0000-0000-1000-d420b0f0025d
org_id: 35d96b1a-1a13-4ba8-90f5-1e78dd2a10c5
tunterm_version: 0.1.2813
uptime: 5662632
start: 1694622179
total: 2
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 1694708579
limit: 10
results:
- distro: buster
last_seen: 1695151551.833
model: ME-X5
mxedge_id: 00000000-0000-0000-1000-d420b0f0025d
org_id: 35d96b1a-1a13-4ba8-90f5-1e78dd2a10c5
tunterm_version: 0.1.2813
uptime: 5662632
start: 1694622179
total: 2
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/mxedges/unassign:
post:
tags:
- Orgs MxEdges
summary: unassignOrgMxEdgeFromSite
description: Unassign one or more Mist Edge appliances from their current site while keeping them in the organization.
operationId: unassignOrgMxEdgeFromSite
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/mxedges_unassign'
- description: Request Body
examples:
- mxedge_ids:
- 387804a7-3474-85ce-15a2-f9a9684c9c90
contentMediaType: application/json
examples:
Example:
value:
mxedge_ids:
- 387804a7-3474-85ce-15a2-f9a9684c9c90
required: false
responses:
'200':
description: OK - list only devices that has deviceprofile_id changed
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_assign_success'
- description: Assignment operation success response
examples:
- success:
- 5c5b350e0001
contentMediaType: application/json
examples:
Example:
value:
success:
- 5c5b350e0001
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_assign_success'
- description: Assignment operation success response
examples:
- success:
- 5c5b350e0001
contentMediaType: application/vnd.api+json
examples:
Example:
value:
success:
- 5c5b350e0001
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/mxedges/versions:
get:
tags:
- Orgs MxEdges
summary: getOrgMxEdgeUpgradeInfo
description: Retrieve available Mist Edge package versions by upgrade channel and distro.
operationId: getOrgMxEdgeUpgradeInfo
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: channel
in: query
description: 'Upgrade channel used to filter available versions. enum: `alpha`, `beta`, `stable`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/get_org_mxedge_upgrade_info_channel'
- description: 'Upgrade channel used to filter available versions. enum: `alpha`, `beta`, `stable`'
- name: distro
in: query
description: Filter results by distro
style: form
explode: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/mxedge_upgrade_info_items'
description: Available Mist Edge upgrade versions by package
examples:
- - default: true
distro: bullseye
package: mxagent
version: 2.4.100
- distro: bullseye
package: tunterm
version: 1.0.0
contentMediaType: application/json
examples:
Example:
value:
- default: true
distro: bullseye
package: mxagent
version: 2.4.100
- distro: bullseye
package: tunterm
version: 1.0.0
application/vnd.api+json:
schema:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/mxedge_upgrade_info_items'
description: Available Mist Edge upgrade versions by package
examples:
- - default: true
distro: bullseye
package: mxagent
version: 2.4.100
- distro: bullseye
package: tunterm
version: 1.0.0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- default: true
distro: bullseye
package: mxagent
version: 2.4.100
- distro: bullseye
package: tunterm
version: 1.0.0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/mxedges/{mxedge_id}:
delete:
tags:
- Orgs MxEdges
summary: deleteOrgMxEdge
description: Delete a Mist Edge appliance record from the organization by Mist Edge ID.
operationId: deleteOrgMxEdge
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: mxedge_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Orgs MxEdges
summary: getOrgMxEdge
description: Retrieve configuration and registration details for a specific Mist Edge appliance in the organization.
operationId: getOrgMxEdge
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: mxedge_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/mxedge'
- description: Mist Edge appliance configuration and registration state
examples:
- id: 95ddd29a-6a3c-929e-a431-51a5b09f36a6
magic: L-NpT5gi-ADR8WTFd4EiQPY3cP5WdSoD
model: ME-100
mxagent_registered: true
mxcluster_id: 572586b7-f97b-a22b-526c-8b97a3f609c4
mxedge_mgmt:
mist_password: MIST_PASSWORD
root_password: ROOT_PASSWORD
name: Guest
ntp_servers: []
oob_ip_config:
dns:
- 8.8.8.8
- 4.4.4.4
gateway: 10.2.1.254
ip: 10.2.1.10
netmask: 255.255.255.0
type: static
tunterm_dhcpd_config:
'2':
enabled: true
servers:
- 11.2.3.44
enabled: false
servers:
- 11.2.3.4
tunterm_extra_routes:
11.0.0.0/8:
via: 10.3.3.1
tunterm_ip_config:
gateway: 10.2.1.254
ip: 10.2.1.1
netmask: 255.255.255.0
contentMediaType: application/json
examples:
Example:
value:
id: 95ddd29a-6a3c-929e-a431-51a5b09f36a6
magic: L-NpT5gi-ADR8WTFd4EiQPY3cP5WdSoD
model: ME-100
mxagent_registered: true
mxcluster_id: 572586b7-f97b-a22b-526c-8b97a3f609c4
mxedge_mgmt:
mist_password: MIST_PASSWORD
root_password: ROOT_PASSWORD
name: Guest
ntp_servers: []
oob_ip_config:
dns:
- 8.8.8.8
- 4.4.4.4
gateway: 10.2.1.254
ip: 10.2.1.10
netmask: 255.255.255.0
type: static
tunterm_dhcpd_config:
'2':
enabled: true
servers:
- 11.2.3.44
enabled: false
servers:
- 11.2.3.4
tunterm_extra_routes:
11.0.0.0/8:
via: 10.3.3.1
tunterm_ip_config:
gateway: 10.2.1.254
ip: 10.2.1.1
netmask: 255.255.255.0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/mxedge'
- description: Mist Edge appliance configuration and registration state
examples:
- id: 95ddd29a-6a3c-929e-a431-51a5b09f36a6
magic: L-NpT5gi-ADR8WTFd4EiQPY3cP5WdSoD
model: ME-100
mxagent_registered: true
mxcluster_id: 572586b7-f97b-a22b-526c-8b97a3f609c4
mxedge_mgmt:
mist_password: MIST_PASSWORD
root_password: ROOT_PASSWORD
name: Guest
ntp_servers: []
oob_ip_config:
dns:
- 8.8.8.8
- 4.4.4.4
gateway: 10.2.1.254
ip: 10.2.1.10
netmask: 255.255.255.0
type: static
tunterm_dhcpd_config:
'2':
enabled: true
servers:
- 11.2.3.44
enabled: false
servers:
- 11.2.3.4
tunterm_extra_routes:
11.0.0.0/8:
via: 10.3.3.1
tunterm_ip_config:
gateway: 10.2.1.254
ip: 10.2.1.1
netmask: 255.255.255.0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
id: 95ddd29a-6a3c-929e-a431-51a5b09f36a6
magic: L-NpT5gi-ADR8WTFd4EiQPY3cP5WdSoD
model: ME-100
mxagent_registered: true
mxcluster_id: 572586b7-f97b-a22b-526c-8b97a3f609c4
mxedge_mgmt:
mist_password: MIST_PASSWORD
root_password: ROOT_PASSWORD
name: Guest
ntp_servers: []
oob_ip_config:
dns:
- 8.8.8.8
- 4.4.4.4
gateway: 10.2.1.254
ip: 10.2.1.10
netmask: 255.255.255.0
type: static
tunterm_dhcpd_config:
'2':
enabled: true
servers:
- 11.2.3.44
enabled: false
servers:
- 11.2.3.4
tunterm_extra_routes:
11.0.0.0/8:
via: 10.3.3.1
tunterm_ip_config:
gateway: 10.2.1.254
ip: 10.2.1.1
netmask: 255.255.255.0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Orgs MxEdges
summary: updateOrgMxEdge
description: Update a Mist Edge appliance configuration, including model, name, management IP, services, and tunnel termination settings.
operationId: updateOrgMxEdge
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: mxedge_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/mxedge'
- description: Request Body
examples:
- model: ME-X1
name: me-gc1-01
oob_ip_config:
dns:
- 8.8.8.8
- 1.1.1.1
gateway: 10.3.172.9
ip: 10.3.172.201
netmask: /24
type: static
services:
- tunterm
tunterm_ip_config:
gateway: 10.10.172.2
ip: 10.10.172.201
netmask: /24
tunterm_port_config:
downstream_ports:
- '0'
separate_upstream_downstream: true
upstream_port_vlan_id: '1010'
upstream_ports:
- '1'
contentMediaType: application/json
examples:
Example:
value:
model: ME-X1
name: me-gc1-01
oob_ip_config:
dns:
- 8.8.8.8
- 1.1.1.1
gateway: 10.3.172.9
ip: 10.3.172.201
netmask: /24
type: static
services:
- tunterm
tunterm_ip_config:
gateway: 10.10.172.2
ip: 10.10.172.201
netmask: /24
tunterm_port_config:
downstream_ports:
- '0'
separate_upstream_downstream: true
upstream_port_vlan_id: '1010'
upstream_ports:
- '1'
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/mxedge'
- description: Mist Edge appliance configuration and registration state
examples:
- id: 95ddd29a-6a3c-929e-a431-51a5b09f36a6
magic: L-NpT5gi-ADR8WTFd4EiQPY3cP5WdSoD
model: ME-100
mxagent_registered: true
mxcluster_id: 572586b7-f97b-a22b-526c-8b97a3f609c4
mxedge_mgmt:
mist_password: MIST_PASSWORD
root_password: ROOT_PASSWORD
name: Guest
ntp_servers: []
oob_ip_config:
dns:
- 8.8.8.8
- 4.4.4.4
gateway: 10.2.1.254
ip: 10.2.1.10
netmask: 255.255.255.0
type: static
tunterm_dhcpd_config:
'2':
enabled: true
servers:
- 11.2.3.44
enabled: false
servers:
- 11.2.3.4
tunterm_extra_routes:
11.0.0.0/8:
via: 10.3.3.1
tunterm_ip_config:
gateway: 10.2.1.254
ip: 10.2.1.1
netmask: 255.255.255.0
contentMediaType: application/json
examples:
Example:
value:
id: 95ddd29a-6a3c-929e-a431-51a5b09f36a6
magic: L-NpT5gi-ADR8WTFd4EiQPY3cP5WdSoD
model: ME-100
mxagent_registered: true
mxcluster_id: 572586b7-f97b-a22b-526c-8b97a3f609c4
mxedge_mgmt:
mist_password: MIST_PASSWORD
root_password: ROOT_PASSWORD
name: Guest
ntp_servers: []
oob_ip_config:
dns:
- 8.8.8.8
- 4.4.4.4
gateway: 10.2.1.254
ip: 10.2.1.10
netmask: 255.255.255.0
type: static
tunterm_dhcpd_config:
'2':
enabled: true
servers:
- 11.2.3.44
enabled: false
servers:
- 11.2.3.4
tunterm_extra_routes:
11.0.0.0/8:
via: 10.3.3.1
tunterm_ip_config:
gateway: 10.2.1.254
ip: 10.2.1.1
netmask: 255.255.255.0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/mxedge'
- description: Mist Edge appliance configuration and registration state
examples:
- id: 95ddd29a-6a3c-929e-a431-51a5b09f36a6
magic: L-NpT5gi-ADR8WTFd4EiQPY3cP5WdSoD
model: ME-100
mxagent_registered: true
mxcluster_id: 572586b7-f97b-a22b-526c-8b97a3f609c4
mxedge_mgmt:
mist_password: MIST_PASSWORD
root_password: ROOT_PASSWORD
name: Guest
ntp_servers: []
oob_ip_config:
dns:
- 8.8.8.8
- 4.4.4.4
gateway: 10.2.1.254
ip: 10.2.1.10
netmask: 255.255.255.0
type: static
tunterm_dhcpd_config:
'2':
enabled: true
servers:
- 11.2.3.44
enabled: false
servers:
- 11.2.3.4
tunterm_extra_routes:
11.0.0.0/8:
via: 10.3.3.1
tunterm_ip_config:
gateway: 10.2.1.254
ip: 10.2.1.1
netmask: 255.255.255.0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
id: 95ddd29a-6a3c-929e-a431-51a5b09f36a6
magic: L-NpT5gi-ADR8WTFd4EiQPY3cP5WdSoD
model: ME-100
mxagent_registered: true
mxcluster_id: 572586b7-f97b-a22b-526c-8b97a3f609c4
mxedge_mgmt:
mist_password: MIST_PASSWORD
root_password: ROOT_PASSWORD
name: Guest
ntp_servers: []
oob_ip_config:
dns:
- 8.8.8.8
- 4.4.4.4
gateway: 10.2.1.254
ip: 10.2.1.10
netmask: 255.255.255.0
type: static
tunterm_dhcpd_config:
'2':
enabled: true
servers:
- 11.2.3.44
enabled: false
servers:
- 11.2.3.4
tunterm_extra_routes:
11.0.0.0/8:
via: 10.3.3.1
tunterm_ip_config:
gateway: 10.2.1.254
ip: 10.2.1.1
netmask: 255.255.255.0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/mxedges/{mxedge_id}/image/{image_number}:
delete:
tags:
- Orgs MxEdges
summary: deleteOrgMxEdgeImage
description: Delete a numbered image attachment from a Mist Edge appliance.
operationId: deleteOrgMxEdgeImage
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: mxedge_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: image_number
in: path
description: ''
required: true
schema:
maximum: 3
minimum: 1
type: integer
contentEncoding: int32
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs MxEdges
summary: addOrgMxEdgeImage
description: Upload and attach an image file to a Mist Edge appliance. A Mist Edge can have up to three image attachments.
operationId: addOrgMxEdgeImage
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: mxedge_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: image_number
in: path
description: ''
required: true
schema:
maximum: 3
minimum: 1
type: integer
contentEncoding: int32
requestBody:
content:
multipart/form-data:
encoding: {}
schema:
required:
- file
type: object
properties:
file:
type: string
description: Image file content uploaded as multipart form data
contentEncoding: base64
json:
type: string
description: Optional JSON metadata submitted with the image upload
contentMediaType: multipart/form-data
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/mxedges/{mxedge_id}/restart:
post:
tags:
- Orgs MxEdges
summary: restartOrgMxEdge
description: Restart the registration workflow for a Mist Edge replacement by disconnecting the currently registered appliance so another Mist Edge can register.
operationId: restartOrgMxEdge
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: mxedge_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/mxedges/{mxedge_id}/services/tunterm/bounce_port:
post:
tags:
- Orgs MxEdges
summary: bounceOrgMxEdgeDataPorts
description: Bounce one or more TunTerm data ports on a Mist Edge, optionally setting the hold time between port bounces.
operationId: bounceOrgMxEdgeDataPorts
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: mxedge_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/utils_tunterm_bounce_port'
- examples:
- '{"ports":["0","2"]}'
- '{"hold_time":0,"ports":["string"]}'
contentMediaType: application/json
examples:
Example:
value:
ports:
- '0'
- '2'
Example2:
value:
hold_time: 0
ports:
- string
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/mxedges/{mxedge_id}/services/tunterm/disconnect_aps:
post:
tags:
- Orgs MxEdges
summary: disconnectOrgMxEdgeTuntermAps
description: Disconnect specific APs from the Mist Edge TunTerm service by AP MAC address.
operationId: disconnectOrgMxEdgeTuntermAps
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: mxedge_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/mac_addresses'
- examples:
- macs:
- 5c5b353e4eb1
- 5c5b353e4eb2
contentMediaType: application/json
examples:
Example:
value:
macs:
- 5c5b353e4eb1
- 5c5b353e4eb2
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/mxedges/{mxedge_id}/services/{name}/{action}:
post:
tags:
- Orgs MxEdges
summary: controlOrgMxEdgeServices
description: Start, stop, or restart a named Mist Edge service such as `tunterm`, `mxagent`, or `radsecproxy`.
operationId: controlOrgMxEdgeServices
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: mxedge_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: name
in: path
description: 'enum: `mxagent`, `mxdas`, `mxnacedge`, `mxocproxy`, `radsecproxy`, `tunterm`'
required: true
schema:
allOf:
- $ref: '#/components/schemas/mxedge_service_name'
- description: 'enum: `mxagent`, `mxdas`, `mxnacedge`, `mxocproxy`, `radsecproxy`, `tunterm`'
- name: action
in: path
description: Restart or start or stop
required: true
schema:
allOf:
- $ref: '#/components/schemas/mxedge_service_action'
- description: Restart or start or stop
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/mxedges/{mxedge_id}/support:
post:
tags:
- Orgs MxEdges
summary: uploadOrgMxEdgeSupportFiles
description: Trigger upload of support files from a Mist Edge for troubleshooting.
operationId: uploadOrgMxEdgeSupportFiles
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: mxedge_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/mxedges/{mxedge_id}/unregister:
post:
tags:
- Orgs MxEdges
summary: unregisterOrgMxEdge
description: Unregister a Mist Edge during a replacement workflow by disconnecting the currently registered appliance so another Mist Edge can register.
operationId: unregisterOrgMxEdge
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: mxedge_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/mxedges/{mxedge_id}/vm_params:
get:
tags:
- Orgs MxEdges
summary: getOrgMxEdgeVmParams
description: Retrieve VM deployment parameters for a Mist Edge, including model, optional name, and base64 user data.
operationId: getOrgMxEdgeVmParams
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: mxedge_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: Mist Edge VM Parameters
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/mxedge_vm_params'
- description: Mist Edge VM parameters
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/mxedge_vm_params'
- description: Mist Edge VM parameters
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/mxtunnels:
get:
tags:
- Orgs MxTunnels
summary: listOrgMxTunnels
description: List organization Mist Tunnel configurations used to carry AP user VLANs to Mist Edge clusters.
operationId: listOrgMxTunnels
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/mxtunnel'
description: List of Mist Tunnel configurations
examples:
- - hello_interval: 60
hello_retries: 3
ipsec:
dns_servers:
- 172.16.0.8
enabled: true
extra_routes:
- dest: 172.16.0.0/12
next_hop: 172.16.0.1
split_tunnel: true
mxcluster_ids:
- 572586b7-f97b-a22b-526c-8b97a3f609c4
name: HQ
protocol: udp
vlan_ids:
- 3
- 4
- 5
contentMediaType: application/json
examples:
Example:
value:
- hello_interval: 60
hello_retries: 3
ipsec:
dns_servers:
- 172.16.0.8
enabled: true
extra_routes:
- dest: 172.16.0.0/12
next_hop: 172.16.0.1
split_tunnel: true
mxcluster_ids:
- 572586b7-f97b-a22b-526c-8b97a3f609c4
name: HQ
protocol: udp
vlan_ids:
- 3
- 4
- 5
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/mxtunnel'
description: List of Mist Tunnel configurations
examples:
- - hello_interval: 60
hello_retries: 3
ipsec:
dns_servers:
- 172.16.0.8
enabled: true
extra_routes:
- dest: 172.16.0.0/12
next_hop: 172.16.0.1
split_tunnel: true
mxcluster_ids:
- 572586b7-f97b-a22b-526c-8b97a3f609c4
name: HQ
protocol: udp
vlan_ids:
- 3
- 4
- 5
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- hello_interval: 60
hello_retries: 3
ipsec:
dns_servers:
- 172.16.0.8
enabled: true
extra_routes:
- dest: 172.16.0.0/12
next_hop: 172.16.0.1
split_tunnel: true
mxcluster_ids:
- 572586b7-f97b-a22b-526c-8b97a3f609c4
name: HQ
protocol: udp
vlan_ids:
- 3
- 4
- 5
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs MxTunnels
summary: createOrgMxTunnel
description: Create an organization Mist Tunnel configuration, including hosting Mist Edge clusters, VLANs, heartbeat settings, and optional IPsec settings.
operationId: createOrgMxTunnel
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/mxtunnel'
- description: Request Body
examples:
- cluster_ids:
- string
hello_interval: 60
hello_retries: 7
ipsec:
dns_servers:
- string
enabled: true
extra_routes:
- dest: string
next_hop: 192.168.0.1
split_tunnel: true
use_mxedge: true
vlan_ids:
- 0
contentMediaType: application/json
examples:
Example:
value:
cluster_ids:
- string
hello_interval: 60
hello_retries: 7
ipsec:
dns_servers:
- string
enabled: true
extra_routes:
- dest: string
next_hop: 192.168.0.1
split_tunnel: true
use_mxedge: true
vlan_ids:
- 0
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/mxtunnel'
- description: Mist Tunnel configuration for tunneling AP user VLANs to Mist Edge clusters
examples:
- cluster_ids:
- string
created_time: 0
for_site: true
hello_interval: 60
hello_retries: 7
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ipsec:
dns_servers:
- string
enabled: true
extra_routes:
- dest: string
next_hop: 192.168.0.1
split_tunnel: true
use_mxedge: true
modified_time: 0
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
vlan_ids:
- 0
contentMediaType: application/json
examples:
Example:
value:
cluster_ids:
- string
created_time: 0
for_site: true
hello_interval: 60
hello_retries: 7
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ipsec:
dns_servers:
- string
enabled: true
extra_routes:
- dest: string
next_hop: 192.168.0.1
split_tunnel: true
use_mxedge: true
modified_time: 0
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
vlan_ids:
- 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/mxtunnel'
- description: Mist Tunnel configuration for tunneling AP user VLANs to Mist Edge clusters
examples:
- cluster_ids:
- string
created_time: 0
for_site: true
hello_interval: 60
hello_retries: 7
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ipsec:
dns_servers:
- string
enabled: true
extra_routes:
- dest: string
next_hop: 192.168.0.1
split_tunnel: true
use_mxedge: true
modified_time: 0
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
vlan_ids:
- 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
cluster_ids:
- string
created_time: 0
for_site: true
hello_interval: 60
hello_retries: 7
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ipsec:
dns_servers:
- string
enabled: true
extra_routes:
- dest: string
next_hop: 192.168.0.1
split_tunnel: true
use_mxedge: true
modified_time: 0
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
vlan_ids:
- 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/mxtunnels/{mxtunnel_id}:
delete:
tags:
- Orgs MxTunnels
summary: deleteOrgMxTunnel
description: Delete an organization Mist Tunnel configuration by Mist Tunnel ID.
operationId: deleteOrgMxTunnel
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: mxtunnel_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Orgs MxTunnels
summary: getOrgMxTunnel
description: Retrieve configuration details for a specific organization Mist Tunnel, including cluster, VLAN, heartbeat, IPsec, and preemption settings.
operationId: getOrgMxTunnel
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: mxtunnel_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/mxtunnel'
- description: Mist Tunnel configuration for tunneling AP user VLANs to Mist Edge clusters
examples:
- cluster_ids:
- string
created_time: 0
for_site: true
hello_interval: 60
hello_retries: 7
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ipsec:
dns_servers:
- string
enabled: true
extra_routes:
- dest: string
next_hop: 192.168.0.1
split_tunnel: true
use_mxedge: true
modified_time: 0
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
vlan_ids:
- 0
contentMediaType: application/json
examples:
Example:
value:
cluster_ids:
- string
created_time: 0
for_site: true
hello_interval: 60
hello_retries: 7
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ipsec:
dns_servers:
- string
enabled: true
extra_routes:
- dest: string
next_hop: 192.168.0.1
split_tunnel: true
use_mxedge: true
modified_time: 0
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
vlan_ids:
- 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/mxtunnel'
- description: Mist Tunnel configuration for tunneling AP user VLANs to Mist Edge clusters
examples:
- cluster_ids:
- string
created_time: 0
for_site: true
hello_interval: 60
hello_retries: 7
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ipsec:
dns_servers:
- string
enabled: true
extra_routes:
- dest: string
next_hop: 192.168.0.1
split_tunnel: true
use_mxedge: true
modified_time: 0
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
vlan_ids:
- 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
cluster_ids:
- string
created_time: 0
for_site: true
hello_interval: 60
hello_retries: 7
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ipsec:
dns_servers:
- string
enabled: true
extra_routes:
- dest: string
next_hop: 192.168.0.1
split_tunnel: true
use_mxedge: true
modified_time: 0
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
vlan_ids:
- 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Orgs MxTunnels
summary: updateOrgMxTunnel
description: Update an organization Mist Tunnel configuration, including cluster membership, VLANs, heartbeat settings, IPsec, and preemption behavior.
operationId: updateOrgMxTunnel
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: mxtunnel_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/mxtunnel'
- description: Request Body
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/mxtunnel'
- description: Mist Tunnel configuration for tunneling AP user VLANs to Mist Edge clusters
examples:
- cluster_ids:
- string
created_time: 0
for_site: true
hello_interval: 60
hello_retries: 7
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ipsec:
dns_servers:
- string
enabled: true
extra_routes:
- dest: string
next_hop: 192.168.0.1
split_tunnel: true
use_mxedge: true
modified_time: 0
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
vlan_ids:
- 0
contentMediaType: application/json
examples:
Example:
value:
cluster_ids:
- string
created_time: 0
for_site: true
hello_interval: 60
hello_retries: 7
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ipsec:
dns_servers:
- string
enabled: true
extra_routes:
- dest: string
next_hop: 192.168.0.1
split_tunnel: true
use_mxedge: true
modified_time: 0
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
vlan_ids:
- 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/mxtunnel'
- description: Mist Tunnel configuration for tunneling AP user VLANs to Mist Edge clusters
examples:
- cluster_ids:
- string
created_time: 0
for_site: true
hello_interval: 60
hello_retries: 7
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ipsec:
dns_servers:
- string
enabled: true
extra_routes:
- dest: string
next_hop: 192.168.0.1
split_tunnel: true
use_mxedge: true
modified_time: 0
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
vlan_ids:
- 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
cluster_ids:
- string
created_time: 0
for_site: true
hello_interval: 60
hello_retries: 7
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ipsec:
dns_servers:
- string
enabled: true
extra_routes:
- dest: string
next_hop: 192.168.0.1
split_tunnel: true
use_mxedge: true
modified_time: 0
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
vlan_ids:
- 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/mist_nac/test_idp:
post:
tags:
- Orgs NAC IDP
summary: validateOrgIdpCredential
description: "IDP Credential Validation. The output will be available through websocket. As there can be multiple commands issued against the same device at the same time and the output all goes through the same websocket stream, `session` is introduced for demux.\n\n#### Subscribe to Device Command outputs\n`WS /api-ws/v1/stream`\n\n``` json\n{\n \"subscribe\": \"orgs/{org_id}/mist_nac/test_idp\"\n}\n\n ```\n\n### Response (no idp can be found)\n\n``` json\n{\n \"event\": \"data\",\n \"channel\": \"/orgs/{org_id}/mist_nac/test_idp\",\n \"status\": \n \"data\": {\n \"status\": \"failure\",\n \"error\": \"No matching IDP found\"\n }\n}\n\n ```\n\n### Response OK\n\n``` json\n{\n \"event\": \"data\",\n \"channel\": \"/orgs/{org_id}/mist_nac/test_idp\",\n \"status\": \n \"data\": {\n \"status\": \"success\",\n \"idp_id\": \"915793c0-1355-4e98-b1c0-23df2227b357\",\n \"idp_type\": \"ldap\",\n // more attributes will be added later\n }\n}\n\n ```\n\n### Response Invalid Credentials\n\n``` json\n{\n \"event\": \"data\",\n \"channel\": \"/orgs/{org_id}/mist_nac/test_idp\",\n \"status\": \n \"data\": {\n \"status\": \"failure\",\n \"error\": \"Invalid Credentials\",\n \"idp_id\": \"915793c0-1355-4e98-b1c0-23df2227b357\",\n \"idp_type\": \"ldap\",\n }\n}\n\n ```"
operationId: validateOrgIdpCredential
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/username_password'
- examples:
- password: xxxxxx
username: suriyas@juniper.net
contentMediaType: application/json
examples:
Example:
value:
password: xxxxxx
username: suriyas@juniper.net
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session'
- description: Response containing the WebSocket session handle for asynchronous command output
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session'
- description: Response containing the WebSocket session handle for asynchronous command output
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/insights/fingerprints/count:
get:
tags:
- Sites NAC Fingerprints
summary: countSiteClientFingerprints
description: Count Client Fingerprints
operationId: countSiteClientFingerprints
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field used to group this count response. enum: `family`, `model`, `os`, `os_type`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/fingerprints_count_distinct'
- description: 'Field used to group this count response. enum: `family`, `model`, `os`, `os_type`'
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/insights/fingerprints/search:
get:
tags:
- Sites NAC Fingerprints
summary: searchSiteClientFingerprints
description: Search Client Fingerprints
operationId: searchSiteClientFingerprints
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: family
in: query
description: Device Category of the client device
style: form
explode: true
schema:
type: string
examples:
- EX Series Switch
- name: client_type
in: query
description: 'Filter results by client type. enum: `wireless`, `wired`, `vty`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/nac_access_type'
- description: 'Filter results by client type. enum: `wireless`, `wired`, `vty`'
examples:
- wired
- name: model
in: query
description: Filter results by device model
style: form
explode: true
schema:
type: string
examples:
- ex4100-f-12p
- name: mfg
in: query
description: Manufacturer name of the client device
style: form
explode: true
schema:
type: string
examples:
- Juniper Networks, Inc.
- name: os
in: query
description: Operating System name and version of the client device
style: form
explode: true
schema:
type: string
examples:
- JUNOS 22.3R1.12
- name: os_type
in: query
description: Operating system name of the client device
style: form
explode: true
schema:
type: string
examples:
- JUNOS
- name: mac
in: query
description: Filter results by MAC address
style: form
explode: true
schema:
type: string
examples:
- d420b080516d
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: interval
in: query
description: Aggregation works by giving a time range plus interval (e.g. 1d, 1h, 10m) where aggregation function would be applied to.
style: form
explode: true
schema:
type: string
examples:
- 10m
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order.
style: form
explode: true
schema:
type: string
default: wxid
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/fingerprint_search_result'
- description: Search response for client device fingerprint records
examples:
- end: 1735678700
limit: 10
results:
- family: Apple
mac: d420b080516e
mfg: Apple, Inc.
model: Unknown
org_id: bb2fb165-0931-49c7-a1b8-9b5814326b7d
os: iOS 18.1.1
os_type: iOS
random_mac: true
site_id: 441a1214-6928-442a-8e92-e1d34b8ec6a6
timestamp: 1735678662.58
- family: EX Series Switch
mac: d420b080516d
mfg: Juniper Networks, Inc.
model: ex4100-f-12p
org_id: b6bc08f3-60a3-402b-8f0d-caf9132a1e9a
os: JUNOS 22.3R1.12
os_type: JUNOS
random_mac: false
site_id: 441a1214-6928-442a-8e92-e1d34b8ec6a6
timestamp: 1735669092.932
start: 1735678650
total: 2
contentMediaType: application/json
examples:
Example:
value:
end: 1735678700
limit: 10
results:
- family: Apple
mac: d420b080516e
mfg: Apple, Inc.
model: Unknown
org_id: bb2fb165-0931-49c7-a1b8-9b5814326b7d
os: iOS 18.1.1
os_type: iOS
random_mac: true
site_id: 441a1214-6928-442a-8e92-e1d34b8ec6a6
timestamp: 1735678662.58
- family: EX Series Switch
mac: d420b080516d
mfg: Juniper Networks, Inc.
model: ex4100-f-12p
org_id: b6bc08f3-60a3-402b-8f0d-caf9132a1e9a
os: JUNOS 22.3R1.12
os_type: JUNOS
random_mac: false
site_id: 441a1214-6928-442a-8e92-e1d34b8ec6a6
timestamp: 1735669092.932
start: 1735678650
total: 2
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/fingerprint_search_result'
- description: Search response for client device fingerprint records
examples:
- end: 1735678700
limit: 10
results:
- family: Apple
mac: d420b080516e
mfg: Apple, Inc.
model: Unknown
org_id: bb2fb165-0931-49c7-a1b8-9b5814326b7d
os: iOS 18.1.1
os_type: iOS
random_mac: true
site_id: 441a1214-6928-442a-8e92-e1d34b8ec6a6
timestamp: 1735678662.58
- family: EX Series Switch
mac: d420b080516d
mfg: Juniper Networks, Inc.
model: ex4100-f-12p
org_id: b6bc08f3-60a3-402b-8f0d-caf9132a1e9a
os: JUNOS 22.3R1.12
os_type: JUNOS
random_mac: false
site_id: 441a1214-6928-442a-8e92-e1d34b8ec6a6
timestamp: 1735669092.932
start: 1735678650
total: 2
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 1735678700
limit: 10
results:
- family: Apple
mac: d420b080516e
mfg: Apple, Inc.
model: Unknown
org_id: bb2fb165-0931-49c7-a1b8-9b5814326b7d
os: iOS 18.1.1
os_type: iOS
random_mac: true
site_id: 441a1214-6928-442a-8e92-e1d34b8ec6a6
timestamp: 1735678662.58
- family: EX Series Switch
mac: d420b080516d
mfg: Juniper Networks, Inc.
model: ex4100-f-12p
org_id: b6bc08f3-60a3-402b-8f0d-caf9132a1e9a
os: JUNOS 22.3R1.12
os_type: JUNOS
random_mac: false
site_id: 441a1214-6928-442a-8e92-e1d34b8ec6a6
timestamp: 1735669092.932
start: 1735678650
total: 2
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/nactags:
get:
tags:
- Orgs NAC Tags
summary: listOrgNacTags
description: List organization NAC tags, optionally filtering by tag type, name, or match attribute.
operationId: listOrgNacTags
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: type
in: query
description: 'Filter results by type. enum: `egress_vlan_names`, `gbp_tag`, `match`, `radius_attrs`, `radius_group`, `radius_vendor_attrs`, `redirect_nacportal_id`, `session_timeout`, `username_attr`, `vlan`. Accepts multiple comma-separated values.'
style: form
explode: true
schema:
type: string
examples:
- match,vlan
- name: name
in: query
description: Filter results by name. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- name-a,name-b
- name: match
in: query
description: 'if `type`==`match`, Type of NAC Tag. enum: `cert_cn`, `cert_eku`, `cert_issuer`, `cert_san`, `cert_serial`, `cert_sub`, `cert_template`, `client_mac`, `edr_status`, `gbp_tag`, `hostname`, `idp_role`, `ingress_vlan`, `mdm_status`, `nas_ip`, `radius_group`, `realm`, `ssid`, `user_name`, `usermac_label`. Accepts multiple comma-separated values.'
style: form
explode: true
schema:
type: string
examples:
- ssid,idp_role
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/nac_tag'
description: List of NAC tags
contentMediaType: application/json
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/nac_tag'
description: List of NAC tags
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs NAC Tags
summary: createOrgNacTag
description: Create a NAC tag used either as rule-matching criteria or as a result attribute returned when NAC allows access.
operationId: createOrgNacTag
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/nac_tag'
required: false
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/nac_tag'
- description: NAC tag used as a rule-matching classifier or as a result attribute for allowed users
examples:
- '{"egress_vlan_names":["1vlan-30","1vlan-20","2vlan10"],"name":"trunk_ap","type":"egress_vlan_names"}'
- '{"match":"cert_cn","name":"staff","type":"match","values":["john","staff*"]}'
- '{"match":"cert_eku","name":"EKU-Match","type":"match","values":["1.3.6.1.4.1.54321.10.1","1.3.6.1.4.1.54321.20.2"]}'
- '{"match":"cert_issuer","name":"issuer1","type":"match","values":["/C=CN/ST=defy/L=defy/O=defy/OU=defy/CN=defy"]}'
- '{"match":"cert_san","name":"san1","type":"match","values":["henry1@defy.com"]}'
- '{"match":"cert_serial","name":"serial1","type":"match","values":["6a524ab782fb468c00c59f51cff00268d95533b8"]}'
- '{"match":"cert_sub","name":"subject1","type":"match","values":["/C=CN/ST=defy/O=defy/OU=defy/CN=steve"]}'
- '{"match":"cert_template","name":"templ1","type":"match","values":["1.3.6.1.4.1.311.21.8.4200806.605933.871088.11229391.9863893.29.13545645.4807979","1.3.6.1.4.1.311.21.8.3285427.4093958.2707341.9961608.11572555.6.4903431.2258457"]}'
- '{"match":"client_mac","name":"cameras","type":"match","values":["010203040506","abcdef*"]}'
- '{"match":"edr_status","match_all":false,"name":"edr_health","type":"match","values":["sentinelone_healthy","sentinelone_infected","crowdstrike_low","crowdstrike_medium","crowdstrike_high","crowdstrike_critical","crowdstrike_informational","unknown"]}'
- '{"match":"hostname","name":"hostname1","type":"match","values":["CP*","USR*"]}'
- '{"name":"VIP_group","radius_group":"VIP","type":"radius_group"}'
- '{"match":"realm","name":"defy","type":"match","values":["defy.com"]}'
- '{"match":"idp_role","name":"VIP","type":"match","values":["vip"]}'
- '{"match":"user_name","name":"admins","type":"match","values":["bob","steve"]}'
- '{"name":"guest_vlan","type":"vlan","vlan":"30"}'
- '{"name":"custom_attrs","radius_attrs":["Idle-Timeout=600","Termination-Action=RADIUS-Request"],"type":"radius_attrs"}'
- '{"name":"custom_radius_vendor_attrs","radius_vendor_attrs":["PaloAlto-Admin-Role=superuser","PaloAlto-Panorama-Admin-Role=administrator"],"type":"radius_vendor_attrs"}'
- '{"name":"timeout","session_timeout":86400,"type":"session_timeout"}'
- '{"allow_usermac_override":true,"name":"username_attr","type":"username_attr","username_attr":"automatic"}'
contentMediaType: application/json
examples:
Egress Vlan Names:
value:
egress_vlan_names:
- 1vlan-30
- 1vlan-20
- 2vlan10
name: trunk_ap
type: egress_vlan_names
Matches Cert CN:
value:
match: cert_cn
name: staff
type: match
values:
- john
- staff*
Matches Cert EKU:
value:
match: cert_eku
name: EKU-Match
type: match
values:
- 1.3.6.1.4.1.54321.10.1
- 1.3.6.1.4.1.54321.20.2
Matches Cert Issuer:
value:
match: cert_issuer
name: issuer1
type: match
values:
- /C=CN/ST=defy/L=defy/O=defy/OU=defy/CN=defy
Matches Cert SAN:
value:
match: cert_san
name: san1
type: match
values:
- henry1@defy.com
Matches Cert Serial:
value:
match: cert_serial
name: serial1
type: match
values:
- 6a524ab782fb468c00c59f51cff00268d95533b8
Matches Cert Sub:
value:
match: cert_sub
name: subject1
type: match
values:
- /C=CN/ST=defy/O=defy/OU=defy/CN=steve
Matches Cert Template:
value:
match: cert_template
name: templ1
type: match
values:
- 1.3.6.1.4.1.311.21.8.4200806.605933.871088.11229391.9863893.29.13545645.4807979
- 1.3.6.1.4.1.311.21.8.3285427.4093958.2707341.9961608.11572555.6.4903431.2258457
Matches Client Mac:
value:
match: client_mac
name: cameras
type: match
values:
- '010203040506'
- abcdef*
Matches EDR Status:
value:
match: edr_status
match_all: false
name: edr_health
type: match
values:
- sentinelone_healthy
- sentinelone_infected
- crowdstrike_low
- crowdstrike_medium
- crowdstrike_high
- crowdstrike_critical
- crowdstrike_informational
- unknown
Matches Hostname:
value:
match: hostname
name: hostname1
type: match
values:
- CP*
- USR*
Matches Radius Group:
value:
name: VIP_group
radius_group: VIP
type: radius_group
Matches Realm:
value:
match: realm
name: defy
type: match
values:
- defy.com
Matches Role:
value:
match: idp_role
name: VIP
type: match
values:
- vip
Matches Username:
value:
match: user_name
name: admins
type: match
values:
- bob
- steve
Matches Vlan:
value:
name: guest_vlan
type: vlan
vlan: '30'
Radius Attrs:
value:
name: custom_attrs
radius_attrs:
- Idle-Timeout=600
- Termination-Action=RADIUS-Request
type: radius_attrs
Radius Vendor Attrs:
value:
name: custom_radius_vendor_attrs
radius_vendor_attrs:
- PaloAlto-Admin-Role=superuser
- PaloAlto-Panorama-Admin-Role=administrator
type: radius_vendor_attrs
Session Timeout:
value:
name: timeout
session_timeout: 86400
type: session_timeout
Username Attr:
value:
allow_usermac_override: true
name: username_attr
type: username_attr
username_attr: automatic
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/nac_tag'
- description: NAC tag used as a rule-matching classifier or as a result attribute for allowed users
examples:
- '{"egress_vlan_names":["1vlan-30","1vlan-20","2vlan10"],"name":"trunk_ap","type":"egress_vlan_names"}'
- '{"match":"cert_cn","name":"staff","type":"match","values":["john","staff*"]}'
- '{"match":"cert_issuer","name":"issuer1","type":"match","values":["/C=CN/ST=defy/L=defy/O=defy/OU=defy/CN=defy"]}'
- '{"match":"cert_san","name":"san1","type":"match","values":["henry1@defy.com"]}'
- '{"match":"cert_serial","name":"serial1","type":"match","values":["6a524ab782fb468c00c59f51cff00268d95533b8"]}'
- '{"match":"cert_sub","name":"subject1","type":"match","values":["/C=CN/ST=defy/O=defy/OU=defy/CN=steve"]}'
- '{"match":"cert_template","name":"templ1","type":"match","values":["1.3.6.1.4.1.311.21.8.4200806.605933.871088.11229391.9863893.29.13545645.4807979","1.3.6.1.4.1.311.21.8.3285427.4093958.2707341.9961608.11572555.6.4903431.2258457"]}'
- '{"match":"client_mac","name":"cameras","type":"match","values":["010203040506","abcdef*"]}'
- '{"match":"hostname","name":"hostname1","type":"match","values":["CP*","USR*"]}'
- '{"name":"VIP_group","radius_group":"VIP","type":"radius_group"}'
- '{"match":"realm","name":"defy","type":"match","values":["defy.com"]}'
- '{"match":"idp_role","name":"VIP","type":"match","values":["vip"]}'
- '{"match":"user_name","name":"admins","type":"match","values":["bob","steve"]}'
- '{"name":"guest_vlan","type":"vlan","vlan":"30"}'
- '{"name":"custom_attrs","radius_attrs":["Idle-Timeout=600","Termination-Action=RADIUS-Request"],"type":"radius_attrs"}'
- '{"name":"custom_radius_vendor_attrs","radius_vendor_attrs":["PaloAlto-Admin-Role=superuser","PaloAlto-Panorama-Admin-Role=administrator"],"type":"radius_vendor_attrs"}'
- '{"name":"timeout","session_timeout":86400,"type":"session_timeout"}'
- '{"allow_usermac_override":true,"name":"username_attr","type":"username_attr","username_attr":"automatic"}'
contentMediaType: application/vnd.api+json
examples:
Egress Vlan Names:
value:
egress_vlan_names:
- 1vlan-30
- 1vlan-20
- 2vlan10
name: trunk_ap
type: egress_vlan_names
Matches Cert CN:
value:
match: cert_cn
name: staff
type: match
values:
- john
- staff*
Matches Cert Issuer:
value:
match: cert_issuer
name: issuer1
type: match
values:
- /C=CN/ST=defy/L=defy/O=defy/OU=defy/CN=defy
Matches Cert SAN:
value:
match: cert_san
name: san1
type: match
values:
- henry1@defy.com
Matches Cert Serial:
value:
match: cert_serial
name: serial1
type: match
values:
- 6a524ab782fb468c00c59f51cff00268d95533b8
Matches Cert Sub:
value:
match: cert_sub
name: subject1
type: match
values:
- /C=CN/ST=defy/O=defy/OU=defy/CN=steve
Matches Cert Template:
value:
match: cert_template
name: templ1
type: match
values:
- 1.3.6.1.4.1.311.21.8.4200806.605933.871088.11229391.9863893.29.13545645.4807979
- 1.3.6.1.4.1.311.21.8.3285427.4093958.2707341.9961608.11572555.6.4903431.2258457
Matches Client Mac:
value:
match: client_mac
name: cameras
type: match
values:
- '010203040506'
- abcdef*
Matches Hostname:
value:
match: hostname
name: hostname1
type: match
values:
- CP*
- USR*
Matches Radius Group:
value:
name: VIP_group
radius_group: VIP
type: radius_group
Matches Realm:
value:
match: realm
name: defy
type: match
values:
- defy.com
Matches Role:
value:
match: idp_role
name: VIP
type: match
values:
- vip
Matches Username:
value:
match: user_name
name: admins
type: match
values:
- bob
- steve
Matches Vlan:
value:
name: guest_vlan
type: vlan
vlan: '30'
Radius Attrs:
value:
name: custom_attrs
radius_attrs:
- Idle-Timeout=600
- Termination-Action=RADIUS-Request
type: radius_attrs
Radius Vendor Attrs:
value:
name: custom_radius_vendor_attrs
radius_vendor_attrs:
- PaloAlto-Admin-Role=superuser
- PaloAlto-Panorama-Admin-Role=administrator
type: radius_vendor_attrs
Session Timeout:
value:
name: timeout
session_timeout: 86400
type: session_timeout
Username Attr:
value:
allow_usermac_override: true
name: username_attr
type: username_attr
username_attr: automatic
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/nactags/{nactag_id}:
delete:
tags:
- Orgs NAC Tags
summary: deleteOrgNacTag
description: Delete an organization NAC tag by tag ID so it can no longer be used by NAC rules.
operationId: deleteOrgNacTag
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: nactag_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Orgs NAC Tags
summary: getOrgNacTag
description: Retrieve configuration details for a specific NAC tag, including type, match values, RADIUS attributes, VLAN or session results, and portal redirection settings.
operationId: getOrgNacTag
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: nactag_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/nac_tag'
- description: NAC tag used as a rule-matching classifier or as a result attribute for allowed users
examples:
- '{"egress_vlan_names":["1vlan-30","1vlan-20","2vlan10"],"name":"trunk_ap","type":"egress_vlan_names"}'
- '{"match":"cert_cn","name":"staff","type":"match","values":["john","staff*"]}'
- '{"match":"cert_eku","name":"EKU-Match","type":"match","values":["1.3.6.1.4.1.54321.10.1","1.3.6.1.4.1.54321.20.2"]}'
- '{"match":"cert_issuer","name":"issuer1","type":"match","values":["/C=CN/ST=defy/L=defy/O=defy/OU=defy/CN=defy"]}'
- '{"match":"cert_san","name":"san1","type":"match","values":["henry1@defy.com"]}'
- '{"match":"cert_serial","name":"serial1","type":"match","values":["6a524ab782fb468c00c59f51cff00268d95533b8"]}'
- '{"match":"cert_sub","name":"subject1","type":"match","values":["/C=CN/ST=defy/O=defy/OU=defy/CN=steve"]}'
- '{"match":"cert_template","name":"templ1","type":"match","values":["1.3.6.1.4.1.311.21.8.4200806.605933.871088.11229391.9863893.29.13545645.4807979","1.3.6.1.4.1.311.21.8.3285427.4093958.2707341.9961608.11572555.6.4903431.2258457"]}'
- '{"match":"client_mac","name":"cameras","type":"match","values":["010203040506","abcdef*"]}'
- '{"match":"edr_status","match_all":false,"name":"edr_health","type":"match","values":["sentinelone_healthy","sentinelone_infected","crowdstrike_low","crowdstrike_medium","crowdstrike_high","crowdstrike_critical","crowdstrike_informational","unknown"]}'
- '{"match":"hostname","name":"hostname1","type":"match","values":["CP*","USR*"]}'
- '{"name":"VIP_group","radius_group":"VIP","type":"radius_group"}'
- '{"match":"realm","name":"defy","type":"match","values":["defy.com"]}'
- '{"match":"idp_role","name":"VIP","type":"match","values":["vip"]}'
- '{"match":"user_name","name":"admins","type":"match","values":["bob","steve"]}'
- '{"name":"guest_vlan","type":"vlan","vlan":"30"}'
- '{"name":"custom_attrs","radius_attrs":["Idle-Timeout=600","Termination-Action=RADIUS-Request"],"type":"radius_attrs"}'
- '{"name":"custom_radius_vendor_attrs","radius_vendor_attrs":["PaloAlto-Admin-Role=superuser","PaloAlto-Panorama-Admin-Role=administrator"],"type":"radius_vendor_attrs"}'
- '{"name":"timeout","session_timeout":86400,"type":"session_timeout"}'
- '{"allow_usermac_override":true,"name":"username_attr","type":"username_attr","username_attr":"automatic"}'
contentMediaType: application/json
examples:
Egress Vlan Names:
value:
egress_vlan_names:
- 1vlan-30
- 1vlan-20
- 2vlan10
name: trunk_ap
type: egress_vlan_names
Matches Cert CN:
value:
match: cert_cn
name: staff
type: match
values:
- john
- staff*
Matches Cert EKU:
value:
match: cert_eku
name: EKU-Match
type: match
values:
- 1.3.6.1.4.1.54321.10.1
- 1.3.6.1.4.1.54321.20.2
Matches Cert Issuer:
value:
match: cert_issuer
name: issuer1
type: match
values:
- /C=CN/ST=defy/L=defy/O=defy/OU=defy/CN=defy
Matches Cert SAN:
value:
match: cert_san
name: san1
type: match
values:
- henry1@defy.com
Matches Cert Serial:
value:
match: cert_serial
name: serial1
type: match
values:
- 6a524ab782fb468c00c59f51cff00268d95533b8
Matches Cert Sub:
value:
match: cert_sub
name: subject1
type: match
values:
- /C=CN/ST=defy/O=defy/OU=defy/CN=steve
Matches Cert Template:
value:
match: cert_template
name: templ1
type: match
values:
- 1.3.6.1.4.1.311.21.8.4200806.605933.871088.11229391.9863893.29.13545645.4807979
- 1.3.6.1.4.1.311.21.8.3285427.4093958.2707341.9961608.11572555.6.4903431.2258457
Matches Client Mac:
value:
match: client_mac
name: cameras
type: match
values:
- '010203040506'
- abcdef*
Matches EDR Status:
value:
match: edr_status
match_all: false
name: edr_health
type: match
values:
- sentinelone_healthy
- sentinelone_infected
- crowdstrike_low
- crowdstrike_medium
- crowdstrike_high
- crowdstrike_critical
- crowdstrike_informational
- unknown
Matches Hostname:
value:
match: hostname
name: hostname1
type: match
values:
- CP*
- USR*
Matches Radius Group:
value:
name: VIP_group
radius_group: VIP
type: radius_group
Matches Realm:
value:
match: realm
name: defy
type: match
values:
- defy.com
Matches Role:
value:
match: idp_role
name: VIP
type: match
values:
- vip
Matches Username:
value:
match: user_name
name: admins
type: match
values:
- bob
- steve
Matches Vlan:
value:
name: guest_vlan
type: vlan
vlan: '30'
Radius Attrs:
value:
name: custom_attrs
radius_attrs:
- Idle-Timeout=600
- Termination-Action=RADIUS-Request
type: radius_attrs
Radius Vendor Attrs:
value:
name: custom_radius_vendor_attrs
radius_vendor_attrs:
- PaloAlto-Admin-Role=superuser
- PaloAlto-Panorama-Admin-Role=administrator
type: radius_vendor_attrs
Session Timeout:
value:
name: timeout
session_timeout: 86400
type: session_timeout
Username Attr:
value:
allow_usermac_override: true
name: username_attr
type: username_attr
username_attr: automatic
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/nac_tag'
- description: NAC tag used as a rule-matching classifier or as a result attribute for allowed users
examples:
- '{"egress_vlan_names":["1vlan-30","1vlan-20","2vlan10"],"name":"trunk_ap","type":"egress_vlan_names"}'
- '{"match":"cert_cn","name":"staff","type":"match","values":["john","staff*"]}'
- '{"match":"cert_issuer","name":"issuer1","type":"match","values":["/C=CN/ST=defy/L=defy/O=defy/OU=defy/CN=defy"]}'
- '{"match":"cert_san","name":"san1","type":"match","values":["henry1@defy.com"]}'
- '{"match":"cert_serial","name":"serial1","type":"match","values":["6a524ab782fb468c00c59f51cff00268d95533b8"]}'
- '{"match":"cert_sub","name":"subject1","type":"match","values":["/C=CN/ST=defy/O=defy/OU=defy/CN=steve"]}'
- '{"match":"cert_template","name":"templ1","type":"match","values":["1.3.6.1.4.1.311.21.8.4200806.605933.871088.11229391.9863893.29.13545645.4807979","1.3.6.1.4.1.311.21.8.3285427.4093958.2707341.9961608.11572555.6.4903431.2258457"]}'
- '{"match":"client_mac","name":"cameras","type":"match","values":["010203040506","abcdef*"]}'
- '{"match":"hostname","name":"hostname1","type":"match","values":["CP*","USR*"]}'
- '{"name":"VIP_group","radius_group":"VIP","type":"radius_group"}'
- '{"match":"realm","name":"defy","type":"match","values":["defy.com"]}'
- '{"match":"idp_role","name":"VIP","type":"match","values":["vip"]}'
- '{"match":"user_name","name":"admins","type":"match","values":["bob","steve"]}'
- '{"name":"guest_vlan","type":"vlan","vlan":"30"}'
- '{"name":"custom_attrs","radius_attrs":["Idle-Timeout=600","Termination-Action=RADIUS-Request"],"type":"radius_attrs"}'
- '{"name":"custom_radius_vendor_attrs","radius_vendor_attrs":["PaloAlto-Admin-Role=superuser","PaloAlto-Panorama-Admin-Role=administrator"],"type":"radius_vendor_attrs"}'
- '{"name":"timeout","session_timeout":86400,"type":"session_timeout"}'
- '{"allow_usermac_override":true,"name":"username_attr","type":"username_attr","username_attr":"automatic"}'
contentMediaType: application/vnd.api+json
examples:
Egress Vlan Names:
value:
egress_vlan_names:
- 1vlan-30
- 1vlan-20
- 2vlan10
name: trunk_ap
type: egress_vlan_names
Matches Cert CN:
value:
match: cert_cn
name: staff
type: match
values:
- john
- staff*
Matches Cert Issuer:
value:
match: cert_issuer
name: issuer1
type: match
values:
- /C=CN/ST=defy/L=defy/O=defy/OU=defy/CN=defy
Matches Cert SAN:
value:
match: cert_san
name: san1
type: match
values:
- henry1@defy.com
Matches Cert Serial:
value:
match: cert_serial
name: serial1
type: match
values:
- 6a524ab782fb468c00c59f51cff00268d95533b8
Matches Cert Sub:
value:
match: cert_sub
name: subject1
type: match
values:
- /C=CN/ST=defy/O=defy/OU=defy/CN=steve
Matches Cert Template:
value:
match: cert_template
name: templ1
type: match
values:
- 1.3.6.1.4.1.311.21.8.4200806.605933.871088.11229391.9863893.29.13545645.4807979
- 1.3.6.1.4.1.311.21.8.3285427.4093958.2707341.9961608.11572555.6.4903431.2258457
Matches Client Mac:
value:
match: client_mac
name: cameras
type: match
values:
- '010203040506'
- abcdef*
Matches Hostname:
value:
match: hostname
name: hostname1
type: match
values:
- CP*
- USR*
Matches Radius Group:
value:
name: VIP_group
radius_group: VIP
type: radius_group
Matches Realm:
value:
match: realm
name: defy
type: match
values:
- defy.com
Matches Role:
value:
match: idp_role
name: VIP
type: match
values:
- vip
Matches Username:
value:
match: user_name
name: admins
type: match
values:
- bob
- steve
Matches Vlan:
value:
name: guest_vlan
type: vlan
vlan: '30'
Radius Attrs:
value:
name: custom_attrs
radius_attrs:
- Idle-Timeout=600
- Termination-Action=RADIUS-Request
type: radius_attrs
Radius Vendor Attrs:
value:
name: custom_radius_vendor_attrs
radius_vendor_attrs:
- PaloAlto-Admin-Role=superuser
- PaloAlto-Panorama-Admin-Role=administrator
type: radius_vendor_attrs
Session Timeout:
value:
name: timeout
session_timeout: 86400
type: session_timeout
Username Attr:
value:
allow_usermac_override: true
name: username_attr
type: username_attr
username_attr: automatic
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Orgs NAC Tags
summary: updateOrgNacTag
description: Update a NAC tag, including matcher values or result attributes such as RADIUS attributes, VLAN, session timeout, username attribute, or portal redirection.
operationId: updateOrgNacTag
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: nactag_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/nac_tag'
required: false
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/nac_tag'
- description: NAC tag used as a rule-matching classifier or as a result attribute for allowed users
examples:
- '{"egress_vlan_names":["1vlan-30","1vlan-20","2vlan10"],"name":"trunk_ap","type":"egress_vlan_names"}'
- '{"match":"cert_cn","name":"staff","type":"match","values":["john","staff*"]}'
- '{"match":"cert_eku","name":"EKU-Match","type":"match","values":["1.3.6.1.4.1.54321.10.1","1.3.6.1.4.1.54321.20.2"]}'
- '{"match":"cert_issuer","name":"issuer1","type":"match","values":["/C=CN/ST=defy/L=defy/O=defy/OU=defy/CN=defy"]}'
- '{"match":"cert_san","name":"san1","type":"match","values":["henry1@defy.com"]}'
- '{"match":"cert_serial","name":"serial1","type":"match","values":["6a524ab782fb468c00c59f51cff00268d95533b8"]}'
- '{"match":"cert_sub","name":"subject1","type":"match","values":["/C=CN/ST=defy/O=defy/OU=defy/CN=steve"]}'
- '{"match":"cert_template","name":"templ1","type":"match","values":["1.3.6.1.4.1.311.21.8.4200806.605933.871088.11229391.9863893.29.13545645.4807979","1.3.6.1.4.1.311.21.8.3285427.4093958.2707341.9961608.11572555.6.4903431.2258457"]}'
- '{"match":"client_mac","name":"cameras","type":"match","values":["010203040506","abcdef*"]}'
- '{"match":"edr_status","match_all":false,"name":"edr_health","type":"match","values":["sentinelone_healthy","sentinelone_infected","crowdstrike_low","crowdstrike_medium","crowdstrike_high","crowdstrike_critical","crowdstrike_informational","unknown"]}'
- '{"match":"hostname","name":"hostname1","type":"match","values":["CP*","USR*"]}'
- '{"name":"VIP_group","radius_group":"VIP","type":"radius_group"}'
- '{"match":"realm","name":"defy","type":"match","values":["defy.com"]}'
- '{"match":"idp_role","name":"VIP","type":"match","values":["vip"]}'
- '{"match":"user_name","name":"admins","type":"match","values":["bob","steve"]}'
- '{"name":"guest_vlan","type":"vlan","vlan":"30"}'
- '{"name":"custom_attrs","radius_attrs":["Idle-Timeout=600","Termination-Action=RADIUS-Request"],"type":"radius_attrs"}'
- '{"name":"custom_radius_vendor_attrs","radius_vendor_attrs":["PaloAlto-Admin-Role=superuser","PaloAlto-Panorama-Admin-Role=administrator"],"type":"radius_vendor_attrs"}'
- '{"name":"timeout","session_timeout":86400,"type":"session_timeout"}'
- '{"allow_usermac_override":true,"name":"username_attr","type":"username_attr","username_attr":"automatic"}'
contentMediaType: application/json
examples:
Egress Vlan Names:
value:
egress_vlan_names:
- 1vlan-30
- 1vlan-20
- 2vlan10
name: trunk_ap
type: egress_vlan_names
Matches Cert CN:
value:
match: cert_cn
name: staff
type: match
values:
- john
- staff*
Matches Cert EKU:
value:
match: cert_eku
name: EKU-Match
type: match
values:
- 1.3.6.1.4.1.54321.10.1
- 1.3.6.1.4.1.54321.20.2
Matches Cert Issuer:
value:
match: cert_issuer
name: issuer1
type: match
values:
- /C=CN/ST=defy/L=defy/O=defy/OU=defy/CN=defy
Matches Cert SAN:
value:
match: cert_san
name: san1
type: match
values:
- henry1@defy.com
Matches Cert Serial:
value:
match: cert_serial
name: serial1
type: match
values:
- 6a524ab782fb468c00c59f51cff00268d95533b8
Matches Cert Sub:
value:
match: cert_sub
name: subject1
type: match
values:
- /C=CN/ST=defy/O=defy/OU=defy/CN=steve
Matches Cert Template:
value:
match: cert_template
name: templ1
type: match
values:
- 1.3.6.1.4.1.311.21.8.4200806.605933.871088.11229391.9863893.29.13545645.4807979
- 1.3.6.1.4.1.311.21.8.3285427.4093958.2707341.9961608.11572555.6.4903431.2258457
Matches Client Mac:
value:
match: client_mac
name: cameras
type: match
values:
- '010203040506'
- abcdef*
Matches EDR Status:
value:
match: edr_status
match_all: false
name: edr_health
type: match
values:
- sentinelone_healthy
- sentinelone_infected
- crowdstrike_low
- crowdstrike_medium
- crowdstrike_high
- crowdstrike_critical
- crowdstrike_informational
- unknown
Matches Hostname:
value:
match: hostname
name: hostname1
type: match
values:
- CP*
- USR*
Matches Radius Group:
value:
name: VIP_group
radius_group: VIP
type: radius_group
Matches Realm:
value:
match: realm
name: defy
type: match
values:
- defy.com
Matches Role:
value:
match: idp_role
name: VIP
type: match
values:
- vip
Matches Username:
value:
match: user_name
name: admins
type: match
values:
- bob
- steve
Matches Vlan:
value:
name: guest_vlan
type: vlan
vlan: '30'
Radius Attrs:
value:
name: custom_attrs
radius_attrs:
- Idle-Timeout=600
- Termination-Action=RADIUS-Request
type: radius_attrs
Radius Vendor Attrs:
value:
name: custom_radius_vendor_attrs
radius_vendor_attrs:
- PaloAlto-Admin-Role=superuser
- PaloAlto-Panorama-Admin-Role=administrator
type: radius_vendor_attrs
Session Timeout:
value:
name: timeout
session_timeout: 86400
type: session_timeout
Username Attr:
value:
allow_usermac_override: true
name: username_attr
type: username_attr
username_attr: automatic
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/nac_tag'
- description: NAC tag used as a rule-matching classifier or as a result attribute for allowed users
examples:
- '{"egress_vlan_names":["1vlan-30","1vlan-20","2vlan10"],"name":"trunk_ap","type":"egress_vlan_names"}'
- '{"match":"cert_cn","name":"staff","type":"match","values":["john","staff*"]}'
- '{"match":"cert_issuer","name":"issuer1","type":"match","values":["/C=CN/ST=defy/L=defy/O=defy/OU=defy/CN=defy"]}'
- '{"match":"cert_san","name":"san1","type":"match","values":["henry1@defy.com"]}'
- '{"match":"cert_serial","name":"serial1","type":"match","values":["6a524ab782fb468c00c59f51cff00268d95533b8"]}'
- '{"match":"cert_sub","name":"subject1","type":"match","values":["/C=CN/ST=defy/O=defy/OU=defy/CN=steve"]}'
- '{"match":"cert_template","name":"templ1","type":"match","values":["1.3.6.1.4.1.311.21.8.4200806.605933.871088.11229391.9863893.29.13545645.4807979","1.3.6.1.4.1.311.21.8.3285427.4093958.2707341.9961608.11572555.6.4903431.2258457"]}'
- '{"match":"client_mac","name":"cameras","type":"match","values":["010203040506","abcdef*"]}'
- '{"match":"hostname","name":"hostname1","type":"match","values":["CP*","USR*"]}'
- '{"name":"VIP_group","radius_group":"VIP","type":"radius_group"}'
- '{"match":"realm","name":"defy","type":"match","values":["defy.com"]}'
- '{"match":"idp_role","name":"VIP","type":"match","values":["vip"]}'
- '{"match":"user_name","name":"admins","type":"match","values":["bob","steve"]}'
- '{"name":"guest_vlan","type":"vlan","vlan":"30"}'
- '{"name":"custom_attrs","radius_attrs":["Idle-Timeout=600","Termination-Action=RADIUS-Request"],"type":"radius_attrs"}'
- '{"name":"custom_radius_vendor_attrs","radius_vendor_attrs":["PaloAlto-Admin-Role=superuser","PaloAlto-Panorama-Admin-Role=administrator"],"type":"radius_vendor_attrs"}'
- '{"name":"timeout","session_timeout":86400,"type":"session_timeout"}'
- '{"allow_usermac_override":true,"name":"username_attr","type":"username_attr","username_attr":"automatic"}'
contentMediaType: application/vnd.api+json
examples:
Egress Vlan Names:
value:
egress_vlan_names:
- 1vlan-30
- 1vlan-20
- 2vlan10
name: trunk_ap
type: egress_vlan_names
Matches Cert CN:
value:
match: cert_cn
name: staff
type: match
values:
- john
- staff*
Matches Cert Issuer:
value:
match: cert_issuer
name: issuer1
type: match
values:
- /C=CN/ST=defy/L=defy/O=defy/OU=defy/CN=defy
Matches Cert SAN:
value:
match: cert_san
name: san1
type: match
values:
- henry1@defy.com
Matches Cert Serial:
value:
match: cert_serial
name: serial1
type: match
values:
- 6a524ab782fb468c00c59f51cff00268d95533b8
Matches Cert Sub:
value:
match: cert_sub
name: subject1
type: match
values:
- /C=CN/ST=defy/O=defy/OU=defy/CN=steve
Matches Cert Template:
value:
match: cert_template
name: templ1
type: match
values:
- 1.3.6.1.4.1.311.21.8.4200806.605933.871088.11229391.9863893.29.13545645.4807979
- 1.3.6.1.4.1.311.21.8.3285427.4093958.2707341.9961608.11572555.6.4903431.2258457
Matches Client Mac:
value:
match: client_mac
name: cameras
type: match
values:
- '010203040506'
- abcdef*
Matches Hostname:
value:
match: hostname
name: hostname1
type: match
values:
- CP*
- USR*
Matches Radius Group:
value:
name: VIP_group
radius_group: VIP
type: radius_group
Matches Realm:
value:
match: realm
name: defy
type: match
values:
- defy.com
Matches Role:
value:
match: idp_role
name: VIP
type: match
values:
- vip
Matches Username:
value:
match: user_name
name: admins
type: match
values:
- bob
- steve
Matches Vlan:
value:
name: guest_vlan
type: vlan
vlan: '30'
Radius Attrs:
value:
name: custom_attrs
radius_attrs:
- Idle-Timeout=600
- Termination-Action=RADIUS-Request
type: radius_attrs
Radius Vendor Attrs:
value:
name: custom_radius_vendor_attrs
radius_vendor_attrs:
- PaloAlto-Admin-Role=superuser
- PaloAlto-Panorama-Admin-Role=administrator
type: radius_vendor_attrs
Session Timeout:
value:
name: timeout
session_timeout: 86400
type: session_timeout
Username Attr:
value:
allow_usermac_override: true
name: username_attr
type: username_attr
username_attr: automatic
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/nacportals:
get:
tags:
- Orgs NAC Portals
summary: listOrgNacPortals
description: List NAC portal configurations in the organization for guest portal, guest admin, or Marvis Client onboarding workflows.
operationId: listOrgNacPortals
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/nac_portal'
description: List of NAC portal configurations
examples:
- - access_type: wireless
additional_cacerts:
- >-
-----BEGIN CERTIFICATE-----
MIIFZjCCA06gAwIBAgIIP61/1qm/uDowDQYJKoZIhvcNAQELBQE
-----END CERTIFICATE-----
cert_expire_time: 365
enable_location: false
enable_telemetry: true
expiry_notification_time: 2
name: get-wifi
notify_expiry: true
ssid: Corp
sso:
idp_cert: >-
-----BEGIN CERTIFICATE-----
MIIFZjCCA06gAwIBAgIIP61/1qm/uDowDQYJKoZIhvcNAQELBQE
-----END CERTIFICATE-----
idp_sign_algo: sha256
idp_sso_url: https://yourorg.onelogin.com/trust/saml2/http-post/sso/138130
issuer: https://app.onelogin.com/saml/metadata/138130
nameid_format: email
sso_role_matching:
- assigned: user
match: Student
use_sso_role_for_cert: true
contentMediaType: application/json
examples:
Example:
value:
- access_type: wireless
additional_cacerts:
- >-
-----BEGIN CERTIFICATE-----
MIIFZjCCA06gAwIBAgIIP61/1qm/uDowDQYJKoZIhvcNAQELBQE
-----END CERTIFICATE-----
cert_expire_time: 365
enable_location: false
enable_telemetry: true
expiry_notification_time: 2
name: get-wifi
notify_expiry: true
ssid: Corp
sso:
idp_cert: >-
-----BEGIN CERTIFICATE-----
MIIFZjCCA06gAwIBAgIIP61/1qm/uDowDQYJKoZIhvcNAQELBQE
-----END CERTIFICATE-----
idp_sign_algo: sha256
idp_sso_url: https://yourorg.onelogin.com/trust/saml2/http-post/sso/138130
issuer: https://app.onelogin.com/saml/metadata/138130
nameid_format: email
sso_role_matching:
- assigned: user
match: Student
use_sso_role_for_cert: true
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/nac_portal'
description: List of NAC portal configurations
examples:
- - access_type: wireless
additional_cacerts:
- >-
-----BEGIN CERTIFICATE-----
MIIFZjCCA06gAwIBAgIIP61/1qm/uDowDQYJKoZIhvcNAQELBQE
-----END CERTIFICATE-----
cert_expire_time: 365
enable_location: false
enable_telemetry: true
expiry_notification_time: 2
name: get-wifi
notify_expiry: true
ssid: Corp
sso:
idp_cert: >-
-----BEGIN CERTIFICATE-----
MIIFZjCCA06gAwIBAgIIP61/1qm/uDowDQYJKoZIhvcNAQELBQE
-----END CERTIFICATE-----
idp_sign_algo: sha256
idp_sso_url: https://yourorg.onelogin.com/trust/saml2/http-post/sso/138130
issuer: https://app.onelogin.com/saml/metadata/138130
nameid_format: email
sso_role_matching:
- assigned: user
match: Student
use_sso_role_for_cert: true
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- access_type: wireless
additional_cacerts:
- >-
-----BEGIN CERTIFICATE-----
MIIFZjCCA06gAwIBAgIIP61/1qm/uDowDQYJKoZIhvcNAQELBQE
-----END CERTIFICATE-----
cert_expire_time: 365
enable_location: false
enable_telemetry: true
expiry_notification_time: 2
name: get-wifi
notify_expiry: true
ssid: Corp
sso:
idp_cert: >-
-----BEGIN CERTIFICATE-----
MIIFZjCCA06gAwIBAgIIP61/1qm/uDowDQYJKoZIhvcNAQELBQE
-----END CERTIFICATE-----
idp_sign_algo: sha256
idp_sso_url: https://yourorg.onelogin.com/trust/saml2/http-post/sso/138130
issuer: https://app.onelogin.com/saml/metadata/138130
nameid_format: email
sso_role_matching:
- assigned: user
match: Student
use_sso_role_for_cert: true
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs NAC Portals
summary: createOrgNacPortal
description: Create a NAC portal configuration for guest access, guest administration, or Marvis Client certificate onboarding.
operationId: createOrgNacPortal
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/nac_portal'
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/nac_portal'
- description: NAC portal configuration for 802.1X onboarding, guest access, or Marvis client certificate provisioning
examples:
- access_type: wireless
cert_expire_time: 365
enable_location: false
enable_telemetry: true
expiry_notification_time: 2
name: get-wifi
notify_expiry: true
ssid: Corp
sso:
idp_cert: >-
-----BEGIN CERTIFICATE-----
MIIFZjCCA06gAwIBAgIIP61/1qm/uDowDQYJKoZIhvcNAQELBQE
-----END CERTIFICATE-----
idp_sign_algo: sha256
idp_sso_url: https://yourorg.onelogin.com/trust/saml2/http-post/sso/138130
issuer: https://app.onelogin.com/saml/metadata/138130
nameid_format: email
sso_role_matching:
- assigned: user
match: Student
use_sso_role_for_cert: true
contentMediaType: application/json
examples:
Example:
value:
access_type: wireless
cert_expire_time: 365
enable_location: false
enable_telemetry: true
expiry_notification_time: 2
name: get-wifi
notify_expiry: true
ssid: Corp
sso:
idp_cert: >-
-----BEGIN CERTIFICATE-----
MIIFZjCCA06gAwIBAgIIP61/1qm/uDowDQYJKoZIhvcNAQELBQE
-----END CERTIFICATE-----
idp_sign_algo: sha256
idp_sso_url: https://yourorg.onelogin.com/trust/saml2/http-post/sso/138130
issuer: https://app.onelogin.com/saml/metadata/138130
nameid_format: email
sso_role_matching:
- assigned: user
match: Student
use_sso_role_for_cert: true
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/nac_portal'
- description: NAC portal configuration for 802.1X onboarding, guest access, or Marvis client certificate provisioning
examples:
- access_type: wireless
cert_expire_time: 365
enable_location: false
enable_telemetry: true
expiry_notification_time: 2
name: get-wifi
notify_expiry: true
ssid: Corp
sso:
idp_cert: >-
-----BEGIN CERTIFICATE-----
MIIFZjCCA06gAwIBAgIIP61/1qm/uDowDQYJKoZIhvcNAQELBQE
-----END CERTIFICATE-----
idp_sign_algo: sha256
idp_sso_url: https://yourorg.onelogin.com/trust/saml2/http-post/sso/138130
issuer: https://app.onelogin.com/saml/metadata/138130
nameid_format: email
sso_role_matching:
- assigned: user
match: Student
use_sso_role_for_cert: true
contentMediaType: application/vnd.api+json
examples:
Example:
value:
access_type: wireless
cert_expire_time: 365
enable_location: false
enable_telemetry: true
expiry_notification_time: 2
name: get-wifi
notify_expiry: true
ssid: Corp
sso:
idp_cert: >-
-----BEGIN CERTIFICATE-----
MIIFZjCCA06gAwIBAgIIP61/1qm/uDowDQYJKoZIhvcNAQELBQE
-----END CERTIFICATE-----
idp_sign_algo: sha256
idp_sso_url: https://yourorg.onelogin.com/trust/saml2/http-post/sso/138130
issuer: https://app.onelogin.com/saml/metadata/138130
nameid_format: email
sso_role_matching:
- assigned: user
match: Student
use_sso_role_for_cert: true
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/nacportals/{nacportal_id}:
delete:
tags:
- Orgs NAC Portals
summary: deleteOrgNacPortal
description: Delete an organization NAC portal configuration by NAC portal ID.
operationId: deleteOrgNacPortal
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: nacportal_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Orgs NAC Portals
summary: getOrgNacPortal
description: Retrieve configuration details for a specific NAC portal, including portal type, SSID, SSO, guest portal, certificate, and template settings.
operationId: getOrgNacPortal
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: nacportal_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/nac_portal'
- description: NAC portal configuration for 802.1X onboarding, guest access, or Marvis client certificate provisioning
examples:
- access_type: wireless
cert_expire_time: 365
enable_location: false
enable_telemetry: true
expiry_notification_time: 2
name: get-wifi
notify_expiry: true
ssid: Corp
sso:
idp_cert: >-
-----BEGIN CERTIFICATE-----
MIIFZjCCA06gAwIBAgIIP61/1qm/uDowDQYJKoZIhvcNAQELBQE
-----END CERTIFICATE-----
idp_sign_algo: sha256
idp_sso_url: https://yourorg.onelogin.com/trust/saml2/http-post/sso/138130
issuer: https://app.onelogin.com/saml/metadata/138130
nameid_format: email
sso_role_matching:
- assigned: user
match: Student
use_sso_role_for_cert: true
contentMediaType: application/json
examples:
Example:
value:
access_type: wireless
cert_expire_time: 365
enable_location: false
enable_telemetry: true
expiry_notification_time: 2
name: get-wifi
notify_expiry: true
ssid: Corp
sso:
idp_cert: >-
-----BEGIN CERTIFICATE-----
MIIFZjCCA06gAwIBAgIIP61/1qm/uDowDQYJKoZIhvcNAQELBQE
-----END CERTIFICATE-----
idp_sign_algo: sha256
idp_sso_url: https://yourorg.onelogin.com/trust/saml2/http-post/sso/138130
issuer: https://app.onelogin.com/saml/metadata/138130
nameid_format: email
sso_role_matching:
- assigned: user
match: Student
use_sso_role_for_cert: true
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/nac_portal'
- description: NAC portal configuration for 802.1X onboarding, guest access, or Marvis client certificate provisioning
examples:
- access_type: wireless
cert_expire_time: 365
enable_location: false
enable_telemetry: true
expiry_notification_time: 2
name: get-wifi
notify_expiry: true
ssid: Corp
sso:
idp_cert: >-
-----BEGIN CERTIFICATE-----
MIIFZjCCA06gAwIBAgIIP61/1qm/uDowDQYJKoZIhvcNAQELBQE
-----END CERTIFICATE-----
idp_sign_algo: sha256
idp_sso_url: https://yourorg.onelogin.com/trust/saml2/http-post/sso/138130
issuer: https://app.onelogin.com/saml/metadata/138130
nameid_format: email
sso_role_matching:
- assigned: user
match: Student
use_sso_role_for_cert: true
contentMediaType: application/vnd.api+json
examples:
Example:
value:
access_type: wireless
cert_expire_time: 365
enable_location: false
enable_telemetry: true
expiry_notification_time: 2
name: get-wifi
notify_expiry: true
ssid: Corp
sso:
idp_cert: >-
-----BEGIN CERTIFICATE-----
MIIFZjCCA06gAwIBAgIIP61/1qm/uDowDQYJKoZIhvcNAQELBQE
-----END CERTIFICATE-----
idp_sign_algo: sha256
idp_sso_url: https://yourorg.onelogin.com/trust/saml2/http-post/sso/138130
issuer: https://app.onelogin.com/saml/metadata/138130
nameid_format: email
sso_role_matching:
- assigned: user
match: Student
use_sso_role_for_cert: true
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Orgs NAC Portals
summary: updateOrgNacPortal
description: Update a NAC portal configuration, including portal type, SSID, SSO, guest portal, certificate, and template settings.
operationId: updateOrgNacPortal
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: nacportal_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/nac_portal'
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/nac_portal'
- description: NAC portal configuration for 802.1X onboarding, guest access, or Marvis client certificate provisioning
examples:
- access_type: wireless
cert_expire_time: 365
enable_location: false
enable_telemetry: true
expiry_notification_time: 2
name: get-wifi
notify_expiry: true
ssid: Corp
sso:
idp_cert: >-
-----BEGIN CERTIFICATE-----
MIIFZjCCA06gAwIBAgIIP61/1qm/uDowDQYJKoZIhvcNAQELBQE
-----END CERTIFICATE-----
idp_sign_algo: sha256
idp_sso_url: https://yourorg.onelogin.com/trust/saml2/http-post/sso/138130
issuer: https://app.onelogin.com/saml/metadata/138130
nameid_format: email
sso_role_matching:
- assigned: user
match: Student
use_sso_role_for_cert: true
contentMediaType: application/json
examples:
Example:
value:
access_type: wireless
cert_expire_time: 365
enable_location: false
enable_telemetry: true
expiry_notification_time: 2
name: get-wifi
notify_expiry: true
ssid: Corp
sso:
idp_cert: >-
-----BEGIN CERTIFICATE-----
MIIFZjCCA06gAwIBAgIIP61/1qm/uDowDQYJKoZIhvcNAQELBQE
-----END CERTIFICATE-----
idp_sign_algo: sha256
idp_sso_url: https://yourorg.onelogin.com/trust/saml2/http-post/sso/138130
issuer: https://app.onelogin.com/saml/metadata/138130
nameid_format: email
sso_role_matching:
- assigned: user
match: Student
use_sso_role_for_cert: true
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/nac_portal'
- description: NAC portal configuration for 802.1X onboarding, guest access, or Marvis client certificate provisioning
examples:
- access_type: wireless
cert_expire_time: 365
enable_location: false
enable_telemetry: true
expiry_notification_time: 2
name: get-wifi
notify_expiry: true
ssid: Corp
sso:
idp_cert: >-
-----BEGIN CERTIFICATE-----
MIIFZjCCA06gAwIBAgIIP61/1qm/uDowDQYJKoZIhvcNAQELBQE
-----END CERTIFICATE-----
idp_sign_algo: sha256
idp_sso_url: https://yourorg.onelogin.com/trust/saml2/http-post/sso/138130
issuer: https://app.onelogin.com/saml/metadata/138130
nameid_format: email
sso_role_matching:
- assigned: user
match: Student
use_sso_role_for_cert: true
contentMediaType: application/vnd.api+json
examples:
Example:
value:
access_type: wireless
cert_expire_time: 365
enable_location: false
enable_telemetry: true
expiry_notification_time: 2
name: get-wifi
notify_expiry: true
ssid: Corp
sso:
idp_cert: >-
-----BEGIN CERTIFICATE-----
MIIFZjCCA06gAwIBAgIIP61/1qm/uDowDQYJKoZIhvcNAQELBQE
-----END CERTIFICATE-----
idp_sign_algo: sha256
idp_sso_url: https://yourorg.onelogin.com/trust/saml2/http-post/sso/138130
issuer: https://app.onelogin.com/saml/metadata/138130
nameid_format: email
sso_role_matching:
- assigned: user
match: Student
use_sso_role_for_cert: true
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/nacportals/{nacportal_id}/failures:
get:
tags:
- Orgs NAC Portals
summary: listOrgNacPortalSsoLatestFailures
description: List recent SAML SSO failures for a NAC portal within a selected time range.
operationId: listOrgNacPortalSsoLatestFailures
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: nacportal_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_sso_failure_search'
- description: Response containing recent SSO authentication failure records
examples:
- results:
- detail: string
saml_assertion_xml: string
timestamp: 0
contentMediaType: application/json
examples:
Example:
value:
results:
- detail: string
saml_assertion_xml: string
timestamp: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_sso_failure_search'
- description: Response containing recent SSO authentication failure records
examples:
- results:
- detail: string
saml_assertion_xml: string
timestamp: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
results:
- detail: string
saml_assertion_xml: string
timestamp: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/nacportals/{nacportal_id}/portal_image:
delete:
tags:
- Orgs NAC Portals
summary: deleteOrgNacPortalImage
description: Delete the custom background image for a NAC portal. If no image is configured, the NAC portal uses the default background image.
operationId: deleteOrgNacPortalImage
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: nacportal_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs NAC Portals
summary: uploadOrgNacPortalImage
description: Upload a custom background image for a NAC portal.
operationId: uploadOrgNacPortalImage
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: nacportal_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
content:
multipart/form-data:
encoding: {}
schema:
type: object
properties:
file:
type: string
description: Image binary payload to upload for the PSK portal
contentEncoding: base64
json:
type: string
description: Metadata JSON string describing the PSK portal image upload
contentMediaType: multipart/form-data
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/nacportals/{nacportal_id}/portal_template:
put:
tags:
- Orgs NAC Portals
summary: updateOrgNacPortalTemplate
description: Update visual template settings for a NAC portal, including alignment, primary color, logo, and Powered by visibility.
operationId: updateOrgNacPortalTemplate
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: nacportal_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/nac_portal_template'
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/nacportals/{nacportal_id}/saml_metadata:
get:
tags:
- Orgs NAC Portals
summary: getOrgNacPortalSamlMetadata
description: Retrieve SAML service provider metadata for a NAC portal, including ACS URL, entity ID, logout URL, and metadata XML.
operationId: getOrgNacPortalSamlMetadata
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: nacportal_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/saml_metadata'
- description: Read-only SAML and SCIM metadata generated for an SSO configuration
examples:
- acs_url: https://api.mist.com/api/v1/saml/llDfa13f/login
entity_id: https://api.mist.com/api/v1/saml/llDfa13f/login
logout_url: https://api.mist.com/api/v1/saml/llDfa13f/logout
metadata: urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified
contentMediaType: application/json
examples:
Example:
value:
acs_url: https://api.mist.com/api/v1/saml/llDfa13f/login
entity_id: https://api.mist.com/api/v1/saml/llDfa13f/login
logout_url: https://api.mist.com/api/v1/saml/llDfa13f/logout
metadata: urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/saml_metadata'
- description: Read-only SAML and SCIM metadata generated for an SSO configuration
examples:
- acs_url: https://api.mist.com/api/v1/saml/llDfa13f/login
entity_id: https://api.mist.com/api/v1/saml/llDfa13f/login
logout_url: https://api.mist.com/api/v1/saml/llDfa13f/logout
metadata: urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified
contentMediaType: application/vnd.api+json
examples:
Example:
value:
acs_url: https://api.mist.com/api/v1/saml/llDfa13f/login
entity_id: https://api.mist.com/api/v1/saml/llDfa13f/login
logout_url: https://api.mist.com/api/v1/saml/llDfa13f/logout
metadata: urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/nacportals/{nacportal_id}/saml_metadata.xml:
get:
tags:
- Orgs NAC Portals
summary: downloadOrgNacPortalSamlMetadata
description: >-
Download NAC portal SAML service provider metadata as an XML document.
Example of metadata.xml:
```xml
urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified
Mist
```
operationId: downloadOrgNacPortalSamlMetadata
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: nacportal_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: string
description: File
contentEncoding: base64
contentMediaType: application/json
application/vnd.api+json:
schema:
type: string
description: File
contentEncoding: base64
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/setting/mist_nac_crls:
get:
tags:
- Orgs NAC CRL
summary: getOrgNacCrl
description: List uploaded NAC CRL files for the organization, including file IDs, issuer names, upload timestamps, and download URLs.
operationId: getOrgNacCrl
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_nac_crl_files'
- description: Response containing uploaded NAC CRL file metadata
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_nac_crl_files'
- description: Response containing uploaded NAC CRL file metadata
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs NAC CRL
summary: importOrgNacCrl
description: Upload a NAC Certificate Revocation List (CRL) file in PEM or DER format. This multipart request supports one CRL file per issuer; uploading another file for the same issuer replaces the existing file.
operationId: importOrgNacCrl
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
content:
multipart/form-data:
encoding: {}
schema:
type: object
properties:
file:
type: string
description: a PEM or DER formatted CRL file
contentEncoding: base64
json:
type: string
description: a JSON string with "name" field for CRL file issuer (optional)
contentMediaType: multipart/form-data
required: false
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/nac_crl_file'
- description: Metadata for an uploaded NAC CRL file
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/nac_crl_file'
- description: Metadata for an uploaded NAC CRL file
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/setting/mist_nac_crls/{naccrl_id}:
delete:
tags:
- Orgs NAC CRL
summary: deleteOrgNacCrl
description: Delete an uploaded NAC CRL file identified by the file ID assigned when the CRL was uploaded.
operationId: deleteOrgNacCrl
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: naccrl_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/stats:
get:
tags:
- Orgs Stats
summary: getOrgStats
description: Return an organization statistics summary, including device, inventory, and site counts, connected and disconnected device counts, organization group membership, and SLE summaries.
operationId: getOrgStats
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/stats_org'
- description: Organization statistics summary returned by the org stats endpoint
examples:
- alarmtemplate_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
allow_mist: true
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
num_devices: 0
num_devices_connected: 0
num_devices_disconnected: 0
num_inventory: 0
num_sites: 0
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
session_expiry: 0
sle:
- path: string
user_minutes:
ok: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
alarmtemplate_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
allow_mist: true
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
num_devices: 0
num_devices_connected: 0
num_devices_disconnected: 0
num_inventory: 0
num_sites: 0
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
session_expiry: 0
sle:
- path: string
user_minutes:
ok: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/stats_org'
- description: Organization statistics summary returned by the org stats endpoint
examples:
- alarmtemplate_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
allow_mist: true
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
num_devices: 0
num_devices_connected: 0
num_devices_disconnected: 0
num_inventory: 0
num_sites: 0
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
session_expiry: 0
sle:
- path: string
user_minutes:
ok: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
alarmtemplate_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
allow_mist: true
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
num_devices: 0
num_devices_connected: 0
num_devices_disconnected: 0
num_inventory: 0
num_sites: 0
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
session_expiry: 0
sle:
- path: string
user_minutes:
ok: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/stats/assets:
get:
tags:
- Orgs Stats - Assets
summary: listOrgAssetsStats
description: List BLE asset location and advertisement statistics for the organization over an optional time window, including map coordinates, RSSI, zones, and iBeacon or Eddystone fields.
operationId: listOrgAssetsStats
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/stats_asset'
description: Asset statistics returned by the request
examples:
- - _ttl: 86400
battery_voltage: 3370
by: asset
device_id: 00000000-0000-0000-1000-5c5b35000001
device_name: BLE Device
eddystone_uid_instance: 5c5b35000001
eddystone_uid_namespace: 2818e3868dec25629ede
eddystone_url_url: https://www.abc.com
ibeacon_major: 13
ibeacon_minor: 138
ibeacon_uuid: f3f17139-704a-f03a-2786-0400279e37c3
id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
last_seen: 1480716946
mac: 4a0222000e31
manufacture: Asset Manufacturer Name
map_id: 63eda950-c6da-11e4-a628-60f81dd250cc
mfg_company_id: 935
mfg_data: 648520a1020000
name: Asset Name
rssi: -45
rssizones:
- id: 478f6eca-6276-4993-bfeb-5bcbbbbacf08
since: 0
service_packets:
- data: '640'
last_rx_time: 1645855923
rx_cnt: 213065
uuid: 00003e10-0000-1000-8000-00805f9b34fb
temperature: 23.5
x: 51
y: 29
zones:
- id: 477f6eca-6276-4993-bfeb-5ccbbbbadf08
since: 0
contentMediaType: application/json
examples:
Example:
value:
- _ttl: 86400
battery_voltage: 3370
by: asset
device_id: 00000000-0000-0000-1000-5c5b35000001
device_name: BLE Device
eddystone_uid_instance: 5c5b35000001
eddystone_uid_namespace: 2818e3868dec25629ede
eddystone_url_url: https://www.abc.com
ibeacon_major: 13
ibeacon_minor: 138
ibeacon_uuid: f3f17139-704a-f03a-2786-0400279e37c3
id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
last_seen: 1480716946
mac: 4a0222000e31
manufacture: Asset Manufacturer Name
map_id: 63eda950-c6da-11e4-a628-60f81dd250cc
mfg_company_id: 935
mfg_data: 648520a1020000
name: Asset Name
rssi: -45
rssizones:
- id: 478f6eca-6276-4993-bfeb-5bcbbbbacf08
since: 0
service_packets:
- data: '640'
last_rx_time: 1645855923
rx_cnt: 213065
uuid: 00003e10-0000-1000-8000-00805f9b34fb
temperature: 23.5
x: 51
y: 29
zones:
- id: 477f6eca-6276-4993-bfeb-5ccbbbbadf08
since: 0
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/stats_asset'
description: Asset statistics returned by the request
examples:
- - _ttl: 86400
battery_voltage: 3370
by: asset
device_id: 00000000-0000-0000-1000-5c5b35000001
device_name: BLE Device
eddystone_uid_instance: 5c5b35000001
eddystone_uid_namespace: 2818e3868dec25629ede
eddystone_url_url: https://www.abc.com
ibeacon_major: 13
ibeacon_minor: 138
ibeacon_uuid: f3f17139-704a-f03a-2786-0400279e37c3
id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
last_seen: 1480716946
mac: 4a0222000e31
manufacture: Asset Manufacturer Name
map_id: 63eda950-c6da-11e4-a628-60f81dd250cc
mfg_company_id: 935
mfg_data: 648520a1020000
name: Asset Name
rssi: -45
rssizones:
- id: 478f6eca-6276-4993-bfeb-5bcbbbbacf08
since: 0
service_packets:
- data: '640'
last_rx_time: 1645855923
rx_cnt: 213065
uuid: 00003e10-0000-1000-8000-00805f9b34fb
temperature: 23.5
x: 51
y: 29
zones:
- id: 477f6eca-6276-4993-bfeb-5ccbbbbadf08
since: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- _ttl: 86400
battery_voltage: 3370
by: asset
device_id: 00000000-0000-0000-1000-5c5b35000001
device_name: BLE Device
eddystone_uid_instance: 5c5b35000001
eddystone_uid_namespace: 2818e3868dec25629ede
eddystone_url_url: https://www.abc.com
ibeacon_major: 13
ibeacon_minor: 138
ibeacon_uuid: f3f17139-704a-f03a-2786-0400279e37c3
id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
last_seen: 1480716946
mac: 4a0222000e31
manufacture: Asset Manufacturer Name
map_id: 63eda950-c6da-11e4-a628-60f81dd250cc
mfg_company_id: 935
mfg_data: 648520a1020000
name: Asset Name
rssi: -45
rssizones:
- id: 478f6eca-6276-4993-bfeb-5bcbbbbacf08
since: 0
service_packets:
- data: '640'
last_rx_time: 1645855923
rx_cnt: 213065
uuid: 00003e10-0000-1000-8000-00805f9b34fb
temperature: 23.5
x: 51
y: 29
zones:
- id: 477f6eca-6276-4993-bfeb-5ccbbbbadf08
since: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/stats/assets/count:
get:
tags:
- Orgs Stats - Assets
summary: countOrgAssetsByDistanceField
description: Count organization asset statistics grouped by a distinct asset attribute, such as MAC address, site, map, iBeacon UUID, iBeacon major, or iBeacon minor.
operationId: countOrgAssetsByDistanceField
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field used to group this count response. enum: `ibeacon_major`, `ibeacon_minor`, `ibeacon_uuid`, `mac`, `map_id`, `site_id`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/org_asset_count_distinct'
- description: 'Field used to group this count response. enum: `ibeacon_major`, `ibeacon_minor`, `ibeacon_uuid`, `mac`, `map_id`, `site_id`'
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/stats/assets/search:
get:
tags:
- Orgs Stats - Assets
summary: searchOrgAssets
description: Search BLE asset statistics with filters for site, MAC address, asset name, map, iBeacon or Eddystone identifiers, reporting AP MAC address, RSSI, beam, and time range. Supports pagination and sorting.
operationId: searchOrgAssets
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: site_id
in: query
description: Filter results by site identifier
style: form
explode: true
schema:
type: string
- name: mac
in: query
description: Filter results by MAC address. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- 5c5b53010101,5c5b53020202
- name: device_name
in: query
description: Filter asset results by reporting device name
style: form
explode: true
schema:
type: string
- name: name
in: query
description: Filter results by name. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- name-a,name-b
- name: map_id
in: query
description: Filter results by map identifier
style: form
explode: true
schema:
type: string
- name: ibeacon_uuid
in: query
description: Filter asset results by iBeacon UUID. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- 00000000-0000-0000-0000-000000000001,00000000-0000-0000-0000-000000000002
- name: ibeacon_major
in: query
description: Filter asset results by iBeacon major value. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- 59788,902
- name: ibeacon_minor
in: query
description: Filter asset results by iBeacon minor value. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- 8385,4432
- name: eddystone_uid_namespace
in: query
description: Filter asset results by Eddystone UID namespace
style: form
explode: true
schema:
type: string
- name: eddystone_uid_instance
in: query
description: Filter asset results by Eddystone UID instance
style: form
explode: true
schema:
type: string
- name: eddystone_url
in: query
description: Filter asset results by Eddystone URL
style: form
explode: true
schema:
type: string
- name: ap_mac
in: query
description: Filter asset results by reporting AP MAC address. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- 5c5b53010101,5c5b53020202
- name: beam
in: query
description: Filter asset results by beam value. Accepts multiple comma-separated integer values.
style: form
explode: true
schema:
type: integer
contentEncoding: int32
- name: rssi
in: query
description: Filter asset results by RSSI value. Accepts multiple comma-separated integer values.
style: form
explode: true
schema:
type: integer
contentEncoding: int32
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_stats_assets'
- description: Paginated response for asset statistics search results
examples:
- end: 0
limit: 0
next: string
results:
- battery_voltage: 0
eddystone_uid_instance: string
eddystone_uid_namespace: string
eddystone_url_url: string
ibeacon_major: 1
ibeacon_minor: 1
ibeacon_uuid: 1f89bc00-d0af-481b-82fe-a6629259a39f
last_seen: 0
mac: string
map_id: 09d2b626-2e4e-45ef-a3c4-e6aeb6c83db1
name: string
rssizones:
- id: 476f6eca-6276-4993-bfeb-5dcbbbbaef08
since: 0
x: 0
y: 0
zones:
- id: 475f6eca-6276-4993-bfeb-5ecbbbbf6f08
since: 0
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
end: 0
limit: 0
next: string
results:
- battery_voltage: 0
eddystone_uid_instance: string
eddystone_uid_namespace: string
eddystone_url_url: string
ibeacon_major: 1
ibeacon_minor: 1
ibeacon_uuid: 1f89bc00-d0af-481b-82fe-a6629259a39f
last_seen: 0
mac: string
map_id: 09d2b626-2e4e-45ef-a3c4-e6aeb6c83db1
name: string
rssizones:
- id: 476f6eca-6276-4993-bfeb-5dcbbbbaef08
since: 0
x: 0
y: 0
zones:
- id: 475f6eca-6276-4993-bfeb-5ecbbbbf6f08
since: 0
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_stats_assets'
- description: Paginated response for asset statistics search results
examples:
- end: 0
limit: 0
next: string
results:
- battery_voltage: 0
eddystone_uid_instance: string
eddystone_uid_namespace: string
eddystone_url_url: string
ibeacon_major: 1
ibeacon_minor: 1
ibeacon_uuid: 1f89bc00-d0af-481b-82fe-a6629259a39f
last_seen: 0
mac: string
map_id: 09d2b626-2e4e-45ef-a3c4-e6aeb6c83db1
name: string
rssizones:
- id: 476f6eca-6276-4993-bfeb-5dcbbbbaef08
since: 0
x: 0
y: 0
zones:
- id: 475f6eca-6276-4993-bfeb-5ecbbbbf6f08
since: 0
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 0
limit: 0
next: string
results:
- battery_voltage: 0
eddystone_uid_instance: string
eddystone_uid_namespace: string
eddystone_url_url: string
ibeacon_major: 1
ibeacon_minor: 1
ibeacon_uuid: 1f89bc00-d0af-481b-82fe-a6629259a39f
last_seen: 0
mac: string
map_id: 09d2b626-2e4e-45ef-a3c4-e6aeb6c83db1
name: string
rssizones:
- id: 476f6eca-6276-4993-bfeb-5dcbbbbaef08
since: 0
x: 0
y: 0
zones:
- id: 475f6eca-6276-4993-bfeb-5ecbbbbf6f08
since: 0
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/stats/bgp_peers/count:
get:
tags:
- Orgs Stats - BGP Peers
summary: countOrgBgpStats
description: Count by Distinct Attributes of Org BGP Stats
operationId: countOrgBgpStats
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: state
in: query
description: Filter peer results by state
style: form
explode: true
schema:
type: string
examples:
- established
- name: distinct
in: query
description: Field used to group this count response
style: form
explode: true
schema:
type: string
examples:
- site_id
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/stats/bgp_peers/search:
get:
tags:
- Orgs Stats - BGP Peers
summary: searchOrgBgpStats
description: Search Org BGP Stats
operationId: searchOrgBgpStats
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: mac
in: query
description: Filter results by MAC address. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- 5c5b53010101,5c5b53020202
- name: neighbor_mac
in: query
description: Filter peer results by neighbor MAC address
style: form
explode: true
schema:
type: string
- name: site_id
in: query
description: Filter results by site identifier
style: form
explode: true
schema:
type: string
- name: vrf_name
in: query
description: Filter peer results by VRF name. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- default,vpn_OrgOverlay
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_search_bgps'
- description: Paginated response for BGP peer statistics search results
examples:
- end: 0
limit: 0
results:
- evpn_overlay: true
for_overlay: true
local_as: 65000
mac: 020001c04668
neighbor: 15.8.3.5
neighbor_as: 65000
neighbor_mac: 020001c04600
node: node0
org_id: 0c160b7f-1027-4cd1-923b-744534c4b070
rx_pkts: 63366
rx_routes: 60
site_id: 725a8d34-a126-4f2c-b990-d1219421cb75
state: established
timestamp: 1666251056.07
tx_pkts: 1735
tx_routes: 60
up: true
uptime: 31355
vrf_name: default
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
end: 0
limit: 0
results:
- evpn_overlay: true
for_overlay: true
local_as: 65000
mac: 020001c04668
neighbor: 15.8.3.5
neighbor_as: 65000
neighbor_mac: 020001c04600
node: node0
org_id: 0c160b7f-1027-4cd1-923b-744534c4b070
rx_pkts: 63366
rx_routes: 60
site_id: 725a8d34-a126-4f2c-b990-d1219421cb75
state: established
timestamp: 1666251056.07
tx_pkts: 1735
tx_routes: 60
up: true
uptime: 31355
vrf_name: default
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_search_bgps'
- description: Paginated response for BGP peer statistics search results
examples:
- end: 0
limit: 0
results:
- evpn_overlay: true
for_overlay: true
local_as: 65000
mac: 020001c04668
neighbor: 15.8.3.5
neighbor_as: 65000
neighbor_mac: 020001c04600
node: node0
org_id: 0c160b7f-1027-4cd1-923b-744534c4b070
rx_pkts: 63366
rx_routes: 60
site_id: 725a8d34-a126-4f2c-b990-d1219421cb75
state: established
timestamp: 1666251056.07
tx_pkts: 1735
tx_routes: 60
up: true
uptime: 31355
vrf_name: default
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 0
limit: 0
results:
- evpn_overlay: true
for_overlay: true
local_as: 65000
mac: 020001c04668
neighbor: 15.8.3.5
neighbor_as: 65000
neighbor_mac: 020001c04600
node: node0
org_id: 0c160b7f-1027-4cd1-923b-744534c4b070
rx_pkts: 63366
rx_routes: 60
site_id: 725a8d34-a126-4f2c-b990-d1219421cb75
state: established
timestamp: 1666251056.07
tx_pkts: 1735
tx_routes: 60
up: true
uptime: 31355
vrf_name: default
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/stats/devices:
get:
tags:
- Orgs Stats - Devices
summary: listOrgDevicesStats
description: >-
Get List of Org Devices stats
This API renders some high-level device stats, pagination is assumed and returned in response header (as the response is an array)
operationId: listOrgDevicesStats
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: type
in: query
description: 'Filter results by one device type. Use a single value; comma-separated values are not supported. enum: `all`, `ap`, `gateway`, `switch`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/device_enum_with_all'
- description: 'Filter results by one device type. Use a single value; comma-separated values are not supported. enum: `all`, `ap`, `gateway`, `switch`'
- name: status
in: query
description: 'Filter results by status. enum: `all`, `connected`, `disconnected`. Accepts multiple comma-separated values.'
style: form
explode: true
schema:
type: string
examples:
- disconnected,connected
- name: site_id
in: query
description: Filter results by site identifier. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- 00000000-0000-0000-0000-000000000001,00000000-0000-0000-0000-000000000002
- name: mac
in: query
description: Filter results by MAC address. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- 5c5b53010101,5c5b53020202
- name: evpntopo_id
in: query
description: Filter results by evpntopo id
style: form
explode: true
schema:
type: string
- name: evpn_unused
in: query
description: If `evpn_unused`==`true`, find EVPN eligible switches which don’t belong to any EVPN Topology yet
style: form
explode: true
schema:
type: string
- name: fields
in: query
description: List of additional fields requests, comma separated, or `fields=*` for all of them
style: form
explode: true
schema:
type: string
examples:
- field1,field2
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/stats_device'
description: Device statistics records returned by a stats response
examples:
- '[{"auto_upgrade_stat":{"lastcheck":1720594762},"ble_stat":{"beacon_enabled":true,"beacon_rate":4,"eddystone_uid_enabled":false,"eddystone_uid_freq_msec":1000,"eddystone_uid_instance":"5c5b35d0077b","eddystone_uid_namespace":"9777c1a06ef611e68bbf","eddystone_url_enabled":false,"eddystone_url_freq_msec":1000,"eddystone_url_url":"","ibeacon_enabled":false,"ibeacon_freq_msec":1000,"ibeacon_major":894,"ibeacon_minor":9328,"ibeacon_uuid":"af010e2b-f829-4975-b49e-2e896ed1d627","major":894,"minors":[9328,9329,9330,9331,9332,9333,9334,9335,-1],"power":8,"rx_bytes":158500843,"rx_pkts":3549163,"tx_bytes":509640,"tx_pkts":85411,"tx_resets":0,"uuid":"af010e2b-f829-4975-b49e-2e896ed1d627"},"config_reverted":false,"cpu_system":21921854,"cpu_user":7496631,"cpu_util":5,"created_time":1718228350,"env_stat":{"accel_x":-0.092,"accel_y":0.004,"accel_z":-1.02,"ambient_temp":43,"attitude":0,"cpu_temp":53,"humidity":9,"magne_x":0,"magne_y":0,"magne_z":0,"pressure":968,"vcore_voltage":0},"ext_ip":"66.129.234.28","hw_rev":"C02","id":"00000000-0000-0000-1000-5c5b35d0077b","inactive_wired_vlans":[],"ip":"192.168.95.3","ip_stat":{"dhcp_server":"192.168.95.1","dns":["8.8.8.8"],"gateway":"192.168.95.1","ip":"192.168.95.3","ip6":"fe80:0:0:0:5e5b:35ff:fed0:77b","ips":{"vlan1":"192.168.95.3/24,fe80:0:0:0:5e5b:35ff:fed0:77b/64"},"netmask":"255.255.255.0","netmask6":"/64"},"last_seen":1720595866,"last_trouble":{"code":"07","timestamp":1720039666},"lldp_stat":{"chassis_id":"d0:07:ca:f5:21:00","lldp_med_supported":false,"mgmt_addr":"100.123.105.1","mgmt_addrs":["100.123.105.1"],"port_desc":"ge-0/0/4","port_id":"ge-0/0/4","power_allocated":0,"power_draw":0,"power_request_count":0,"power_requested":0,"system_desc":"Juniper Networks, Inc. ex4300-48t internet router, kernel JUNOS 20.4R3-S7.2, Build date: 2023-04-21 19:47:18 UTC Copyright (c) 1996-2023 Juniper Networks, Inc.","system_name":"Phoenix-Switch"},"mac":"5c5b35d0077b","mem_total_kb":505468,"mem_used_kb":202096,"model":"AP43","modified_time":1718530662,"mount":"faceup","name":"Phoenix","notes":"","num_clients":1,"org_id":"af010e2b-f829-4975-b49e-2e896ed1d627","port_stat":{"eth0":{"full_duplex":true,"rx_bytes":1284143195,"rx_errors":0,"rx_peak_bps":17585,"rx_pkts":5199816,"speed":1000,"tx_bytes":1283744961,"tx_peak_bps":26484,"tx_pkts":3990463,"up":true},"eth1":{"full_duplex":false,"rx_bytes":0,"rx_errors":0,"rx_peak_bps":0,"rx_pkts":0,"speed":0,"tx_bytes":0,"tx_peak_bps":0,"tx_pkts":0,"up":false}},"power_budget":8400,"power_constrained":false,"power_src":"DC Input","radio_config":{},"radio_stat":{"band_24":{"bandwidth":20,"channel":11,"mac":"5c5b35dea810","noise_floor":-80,"num_clients":0,"power":17,"rx_bytes":12948211,"rx_pkts":65292,"tx_bytes":19071943,"tx_pkts":76926,"usage":"24","util_all":24,"util_non_wifi":2,"util_rx_in_bss":0,"util_rx_other_bss":17,"util_tx":4,"util_undecodable_wifi":0,"util_unknown_wifi":1},"band_5":{"bandwidth":40,"channel":36,"mac":"5c5b35dea7f0","noise_floor":-90,"num_clients":1,"power":17,"rx_bytes":578362619,"rx_pkts":2687577,"tx_bytes":1199571353,"tx_pkts":2479302,"usage":"5","util_all":13,"util_non_wifi":0,"util_rx_in_bss":0,"util_rx_other_bss":10,"util_tx":1,"util_undecodable_wifi":0,"util_unknown_wifi":1}},"rx_bps":9276,"rx_bytes":591310830,"rx_pkts":2752869,"serial":"A0703200709E6","site_id":"46fc665e-9706-4296-8fe2-78f42f2e67e4","status":"connected","switch_redundancy":{"num_redundant_aps":1},"tx_bps":8067,"tx_bytes":1218643296,"tx_pkts":2556228,"type":"ap","uptime":1593120,"version":"0.14.29313"}]'
- '[{"arp_table_stats":{"arp_table_count":21,"max_entries_supported":64000},"auto_upgrade_stat":{"lastcheck":1720595477},"cert_expiry":1743292763,"cluster_config":{"configuration":"active-active","control_link_info":{"name":"fxp1","status":"Up"},"ethernet_connection":[{"name":"reth0","status":"Up"},{"name":"reth1","status":"Up"},{"name":"reth2","status":"Down"},{"name":"reth3","status":"Down"},{"name":"reth4","status":"Up"}],"fabric_link_info":{"DataPlaneNotifiedStatus":"Up","Interface":[],"InternalStatus":"Up","State":"Enabled","Status":"Enabled"},"last_status_change_reason":"No failures","operational":"active-active","primary_node_health":"Healthy","redundancy_group_information":[{"Id":0,"MonitoringFailure":"none","Threshold":255},{"Id":1,"MonitoringFailure":"interface-monitoring","Threshold":0},{"Id":2,"MonitoringFailure":"none","Threshold":255}],"secondary_node_health":"Not healthy","status":"Green"},"config_status":"COMMITED","config_timestamp":1720182848,"config_version":1720182848,"cpu2_stat":{"idle":86,"interrupt":0,"load_avg":[0.13,0.17,0.16],"system":5,"user":9},"cpu_stat":{"idle":76,"interrupt":0,"load_avg":[0.18,0.31,0.39],"system":10,"user":14},"created_time":1711756611,"deviceprofile_id":"5e5daedf-e650-4013-b41c-845f0d2b9414","deviceprofile_name":"wan_srx_tor_hub1","dhcpd_stat":{"byod_dc1":{"num_ips":100,"num_leased":0},"corp_dc1":{"num_ips":100,"num_leased":4},"guest_dc1":{"num_ips":241,"num_leased":0},"iot_dc1":{"num_ips":100,"num_leased":0},"mgmt_dc1":{"num_ips":100,"num_leased":2},"teleworker":{"num_ips":140,"num_leased":0}},"ext_ip":"69.196.157.189","fwupdate":{"progress":100,"status":"upgraded","status_id":3037,"timestamp":1718392692.580769,"will_retry":false},"has_pcap":false,"hostname":"wan_srx_tor_hub1-srx","id":"00000000-0000-0000-1000-4db14e107134","if_stat":{"ge-0/0/5.130":{"address_mode":"Unknown","nat_addresses":[],"network_name":"","port_id":"ge-0/0/5","port_usage":"lan","rx_bytes":0,"rx_pkts":0,"tx_bytes":0,"tx_pkts":0,"up":true,"vlan":0},"ge-1/0/5.120":{"address_mode":"Unknown","nat_addresses":[],"network_name":"","port_id":"ge-1/0/5","port_usage":"lan","rx_bytes":0,"rx_pkts":0,"tx_bytes":0,"tx_pkts":0,"up":true,"vlan":0}},"ip":"69.196.157.190","ip_stat":{"gateway":"69.196.157.185","ip":"69.196.157.190","ips":{"vlan1":"69.196.157.190,69.196.157.190"},"netmask":"255.255.255.255"},"is_ha":true,"last_seen":1720598726,"mac":"4db14e107134","mac_table_stats":{"mac_table_count":0,"max_mac_entries_supported":160000},"memory2_stat":{"usage":32},"memory_stat":{"usage":39},"model":"SRX300","modified_time":1720092942,"module2_stat":[{"backup_version":"21.2R3-S7.7","fans":[],"last_seen":1720598717,"mac":"ec38739270c0","model":"SRX300","psus":[{"name":"Power Supply 0","status":"ok"}],"recovery_version":"21.2R3-S7.7","serial":"CV2218AF1505","status":"connected","temperatures":[{"celsius":49,"name":"Routing Engine","status":"ok"},{"celsius":64,"name":"Routing Engine CPU","status":"ok"}],"uptime":580964,"vc_links":[{"neighbor_module_idx":0,"neighbor_port_id":"fxp1","port_id":"fxp1"}],"vc_role":"secondary","vc_state":"active","version":"21.2R3-S6.11"}],"module_stat":[{"backup_version":"21.2R3-S7.7","fans":[],"last_seen":1720598716.999985,"mac":"4db14e107134","model":"SRX300","psus":[{"name":"Power Supply 0","status":"ok"}],"recovery_version":"21.2R3-S7.7","serial":"CV0219AN0335","status":"connected","temperatures":[{"celsius":49,"name":"Routing Engine","status":"ok"},{"celsius":65,"name":"Routing Engine CPU","status":"ok"}],"uptime":1945193,"vc_links":[{"neighbor_module_idx":1,"neighbor_port_id":"fxp1","port_id":"fxp1"}],"vc_role":"primary","vc_state":"active","version":"21.2R3-S6.11"}],"name":"wan_srx_tor_hub1-srx","org_id":"af010e2b-f829-4975-b49e-2e896ed1d627","route_summary_stats":{"fib_routes":0,"max_unicast_routes_supported":1240000,"rib_routes":0,"total_routes":0},"serial":"CV0219AN0335","service_stat":{},"service_status":{"appid_status":"enabled","appid_version":3720,"ewf_status":"disabled","idp_install_result":"successful","idp_install_timestamp":"2024-07-10T06:29:11.708164029Z","idp_status":"disabled","idp_update_timestamp":"2024-07-10T06:28:28.567046244Z"},"site_id":"83c31971-ad70-4419-ae20-7f2b90748986","spu2_stat":[{"spu_cpu":0,"spu_current_session":39,"spu_max_session":32768,"spu_memory":31,"spu_pending_session":0,"spu_uptime":1944572,"spu_valid_session":0}],"spu_stat":[{"spu_cpu":1,"spu_current_session":47,"spu_max_session":32768,"spu_memory":34,"spu_pending_session":0,"spu_uptime":1944572,"spu_valid_session":0}],"status":"connected","tag_id":3550217,"tag_uuid":"af010e2b-f829-4975-b49e-2e896ed1d627","type":"gateway","uptime":581259,"version":"21.2R3-S6.11"}]'
- '[{"ap_redundancy":{"num_aps":1,"num_aps_with_switch_redundancy":1},"arp_table_stats":{"arp_table_count":16,"max_entries_supported":32000},"auto_upgrade_stat":{"lastcheck":1720600596},"cert_expiry":1743932274,"clients":[{"device_mac":"0912f561b653","mac":"001132f5ad23","port_id":"ge-1/0/11"}],"clients_stats":{"total":{"num_aps":[0,0],"num_wired_clients":13}},"config_status":"COMMITED","config_timestamp":1720552389,"config_version":1720552389,"cpu_stat":{"idle":74,"interrupt":0,"load_avg":[0.8,0.75,0.78],"system":13,"user":13},"created_time":1712346090,"dhcpd_stat":{"ifo":{"num_ips":5,"num_leased":0}},"ext_ip":"153.142.221.41","fw_versions_outofsync":false,"fwupdate":{"progress":100,"status":"upgraded","status_id":3037,"timestamp":1712409702.9714448,"will_retry":false},"has_pcap":true,"hostname":"SW-HLAB-ea2e00","hw_rev":"A","id":"00000000-0000-0000-1000-0912f561b653","if_stat":{"ge-0/0/5.0":{"port_id":"ge-0/0/5","rx_bytes":0,"rx_pkts":78110,"tx_bytes":0,"tx_pkts":61037,"up":true},"ge-1/0/0.0":{"port_id":"ge-1/0/0","rx_bytes":0,"rx_pkts":56415,"tx_bytes":0,"tx_pkts":72209,"up":true},"irb.172":{"ips":["10.3.172.41/24"],"port_id":"irb","rx_bytes":0,"rx_pkts":1291755,"tx_bytes":0,"tx_pkts":990327,"up":true,"vlan":172},"vme.0":{"port_id":"vme","rx_bytes":0,"rx_pkts":0,"tx_bytes":0,"tx_pkts":0,"up":true}},"ip":"10.3.10.10","ip_stat":{"gateway":"10.3.172.9","ip":"10.3.10.10","ips":{"vlan172":"10.3.172.41"},"netmask":"255.255.255.255"},"last_seen":1720601189,"last_trouble":{"code":"103","timestamp":1712412455215},"mac":"0912f561b653","mac_table_stats":{"mac_table_count":58,"max_mac_entries_supported":64000},"memory_stat":{"usage":16},"model":"EX4100-F-12P","modified_time":1720552388,"module_stat":[{"boot_partition":"junos","cpu_stat":{"idle":74,"interrupt":0,"load_avg":[0.8,0.75,0.78],"system":13,"user":13},"fpc_idx":0,"mac":"0912f561b653","memory_stat":{"usage":16},"model":"EX4100-F-12P","pics":[{"index":0,"model_number":"EX4100-F-12P","port_groups":[{"count":12,"type":"GE"}]},{"index":1,"model_number":"EX4100-F-12P","port_groups":[{"count":4,"type":"SFP/SFP+"}]},{"index":2,"model_number":"EX4100-F-12P","port_groups":[{"count":2,"type":"GE"}]}],"poe":{"max_power":180,"power_draw":7.3},"psus":[{"name":"Power Supply 0","status":"ok"},{"name":"Power Supply 1","status":"absent"},{"name":"Power Supply 2","status":"absent"}],"serial":"FJ0324AV0077","temperatures":[{"celsius":51,"name":"Thermal board Sensor 1","status":"ok"},{"celsius":51,"name":"Thermal board Sensor 2","status":"ok"},{"celsius":50,"name":"Thermal board Sensor 3","status":"ok"},{"celsius":57,"name":"PFE Die Sensor","status":"ok"}],"type":"fpc","uptime":1692720,"vc_links":[{"neighbor_module_idx":1,"neighbor_port_id":"vcp-1/1/1","port_id":"vcp-0/1/0"},{"neighbor_module_idx":1,"neighbor_port_id":"vcp-1/1/0","port_id":"vcp-0/1/1"}],"vc_mode":"HiGiG","vc_role":"master","vc_state":"present","version":"22.4R3.25"},{"boot_partition":"junos","cpu_stat":{"idle":79,"interrupt":0,"load_avg":[0.52,0.46,0.46],"system":6,"user":15},"fpc_idx":1,"mac":"485a0deb2380","memory_stat":{"usage":14},"model":"EX4100-F-12P","pics":[{"index":0,"model_number":"EX4100-F-12P","port_groups":[{"count":12,"type":"GE"}]},{"index":1,"model_number":"EX4100-F-12P","port_groups":[{"count":4,"type":"SFP/SFP+"}]},{"index":2,"model_number":"EX4100-F-12P","port_groups":[{"count":2,"type":"GE"}]}],"poe":{"max_power":180,"power_draw":22.1},"psus":[{"name":"Power Supply 0","status":"ok"},{"name":"Power Supply 1","status":"absent"},{"name":"Power Supply 2","status":"absent"}],"serial":"FJ0424AV0101","temperatures":[{"celsius":52,"name":"Thermal board Sensor 1","status":"ok"},{"celsius":53,"name":"Thermal board Sensor 2","status":"ok"},{"celsius":52,"name":"Thermal board Sensor 3","status":"ok"},{"celsius":59,"name":"PFE Die Sensor","status":"ok"}],"type":"fpc","uptime":1692720,"vc_links":[{"neighbor_module_idx":0,"neighbor_port_id":"vcp-0/1/1","port_id":"vcp-1/1/0"},{"neighbor_module_idx":0,"neighbor_port_id":"vcp-0/1/0","port_id":"vcp-1/1/1"}],"vc_mode":"HiGiG","vc_role":"backup","vc_state":"present","version":"22.4R3.25"}],"name":"SW-HLAB-ea2e00","org_id":"c5324060-19da-48fa-af28-2b530bd08765","route_summary_stats":{"fib_routes":7,"max_unicast_routes_supported":32150,"rib_routes":40,"total_routes":3},"serial":"FJ0324AV0077","site_id":"a0e43ffb-94a6-4f27-92aa-9cf832e1143d","status":"connected","tag_id":3564806,"tag_uuid":"507604a4-6b34-449c-acb3-87955430b006","type":"switch","uptime":1692720,"vc_mac":"0912f561b653","vc_setup_info":{"config_type":"nonprovisioned","err_missing_dev_id_fpc":false},"version":"22.4R3.25"}]'
contentMediaType: application/json
examples:
Access Point Stats:
value:
- auto_upgrade_stat:
lastcheck: 1720594762
ble_stat:
beacon_enabled: true
beacon_rate: 4
eddystone_uid_enabled: false
eddystone_uid_freq_msec: 1000
eddystone_uid_instance: 5c5b35d0077b
eddystone_uid_namespace: 9777c1a06ef611e68bbf
eddystone_url_enabled: false
eddystone_url_freq_msec: 1000
eddystone_url_url: ''
ibeacon_enabled: false
ibeacon_freq_msec: 1000
ibeacon_major: 894
ibeacon_minor: 9328
ibeacon_uuid: af010e2b-f829-4975-b49e-2e896ed1d627
major: 894
minors:
- 9328
- 9329
- 9330
- 9331
- 9332
- 9333
- 9334
- 9335
- -1
power: 8
rx_bytes: 158500843
rx_pkts: 3549163
tx_bytes: 509640
tx_pkts: 85411
tx_resets: 0
uuid: af010e2b-f829-4975-b49e-2e896ed1d627
config_reverted: false
cpu_system: 21921854
cpu_user: 7496631
cpu_util: 5
created_time: 1718228350
env_stat:
accel_x: -0.092
accel_y: 0.004
accel_z: -1.02
ambient_temp: 43
attitude: 0
cpu_temp: 53
humidity: 9
magne_x: 0
magne_y: 0
magne_z: 0
pressure: 968
vcore_voltage: 0
ext_ip: 66.129.234.28
hw_rev: C02
id: 00000000-0000-0000-1000-5c5b35d0077b
inactive_wired_vlans: []
ip: 192.168.95.3
ip_stat:
dhcp_server: 192.168.95.1
dns:
- 8.8.8.8
gateway: 192.168.95.1
ip: 192.168.95.3
ip6: fe80:0:0:0:5e5b:35ff:fed0:77b
ips:
vlan1: 192.168.95.3/24,fe80:0:0:0:5e5b:35ff:fed0:77b/64
netmask: 255.255.255.0
netmask6: /64
last_seen: 1720595866
last_trouble:
code: '07'
timestamp: 1720039666
lldp_stat:
chassis_id: d0:07:ca:f5:21:00
lldp_med_supported: false
mgmt_addr: 100.123.105.1
mgmt_addrs:
- 100.123.105.1
port_desc: ge-0/0/4
port_id: ge-0/0/4
power_allocated: 0
power_draw: 0
power_request_count: 0
power_requested: 0
system_desc: 'Juniper Networks, Inc. ex4300-48t internet router, kernel JUNOS 20.4R3-S7.2, Build date: 2023-04-21 19:47:18 UTC Copyright (c) 1996-2023 Juniper Networks, Inc.'
system_name: Phoenix-Switch
mac: 5c5b35d0077b
mem_total_kb: 505468
mem_used_kb: 202096
model: AP43
modified_time: 1718530662
mount: faceup
name: Phoenix
notes: ''
num_clients: 1
org_id: af010e2b-f829-4975-b49e-2e896ed1d627
port_stat:
eth0:
full_duplex: true
rx_bytes: 1284143195
rx_errors: 0
rx_peak_bps: 17585
rx_pkts: 5199816
speed: 1000
tx_bytes: 1283744961
tx_peak_bps: 26484
tx_pkts: 3990463
up: true
eth1:
full_duplex: false
rx_bytes: 0
rx_errors: 0
rx_peak_bps: 0
rx_pkts: 0
speed: 0
tx_bytes: 0
tx_peak_bps: 0
tx_pkts: 0
up: false
power_budget: 8400
power_constrained: false
power_src: DC Input
radio_config: {}
radio_stat:
band_24:
bandwidth: 20
channel: 11
mac: 5c5b35dea810
noise_floor: -80
num_clients: 0
power: 17
rx_bytes: 12948211
rx_pkts: 65292
tx_bytes: 19071943
tx_pkts: 76926
usage: '24'
util_all: 24
util_non_wifi: 2
util_rx_in_bss: 0
util_rx_other_bss: 17
util_tx: 4
util_undecodable_wifi: 0
util_unknown_wifi: 1
band_5:
bandwidth: 40
channel: 36
mac: 5c5b35dea7f0
noise_floor: -90
num_clients: 1
power: 17
rx_bytes: 578362619
rx_pkts: 2687577
tx_bytes: 1199571353
tx_pkts: 2479302
usage: '5'
util_all: 13
util_non_wifi: 0
util_rx_in_bss: 0
util_rx_other_bss: 10
util_tx: 1
util_undecodable_wifi: 0
util_unknown_wifi: 1
rx_bps: 9276
rx_bytes: 591310830
rx_pkts: 2752869
serial: A0703200709E6
site_id: 46fc665e-9706-4296-8fe2-78f42f2e67e4
status: connected
switch_redundancy:
num_redundant_aps: 1
tx_bps: 8067
tx_bytes: 1218643296
tx_pkts: 2556228
type: ap
uptime: 1593120
version: 0.14.29313
Gateway Stats:
value:
- arp_table_stats:
arp_table_count: 21
max_entries_supported: 64000
auto_upgrade_stat:
lastcheck: 1720595477
cert_expiry: 1743292763
cluster_config:
configuration: active-active
control_link_info:
name: fxp1
status: Up
ethernet_connection:
- name: reth0
status: Up
- name: reth1
status: Up
- name: reth2
status: Down
- name: reth3
status: Down
- name: reth4
status: Up
fabric_link_info:
DataPlaneNotifiedStatus: Up
Interface: []
InternalStatus: Up
State: Enabled
Status: Enabled
last_status_change_reason: No failures
operational: active-active
primary_node_health: Healthy
redundancy_group_information:
- Id: 0
MonitoringFailure: none
Threshold: 255
- Id: 1
MonitoringFailure: interface-monitoring
Threshold: 0
- Id: 2
MonitoringFailure: none
Threshold: 255
secondary_node_health: Not healthy
status: Green
config_status: COMMITED
config_timestamp: 1720182848
config_version: 1720182848
cpu2_stat:
idle: 86
interrupt: 0
load_avg:
- 0.13
- 0.17
- 0.16
system: 5
user: 9
cpu_stat:
idle: 76
interrupt: 0
load_avg:
- 0.18
- 0.31
- 0.39
system: 10
user: 14
created_time: 1711756611
deviceprofile_id: 5e5daedf-e650-4013-b41c-845f0d2b9414
deviceprofile_name: wan_srx_tor_hub1
dhcpd_stat:
byod_dc1:
num_ips: 100
num_leased: 0
corp_dc1:
num_ips: 100
num_leased: 4
guest_dc1:
num_ips: 241
num_leased: 0
iot_dc1:
num_ips: 100
num_leased: 0
mgmt_dc1:
num_ips: 100
num_leased: 2
teleworker:
num_ips: 140
num_leased: 0
ext_ip: 69.196.157.189
fwupdate:
progress: 100
status: upgraded
status_id: 3037
timestamp: 1718392692.580769
will_retry: false
has_pcap: false
hostname: wan_srx_tor_hub1-srx
id: 00000000-0000-0000-1000-4db14e107134
if_stat:
ge-0/0/5.130:
address_mode: Unknown
nat_addresses: []
network_name: ''
port_id: ge-0/0/5
port_usage: lan
rx_bytes: 0
rx_pkts: 0
tx_bytes: 0
tx_pkts: 0
up: true
vlan: 0
ge-1/0/5.120:
address_mode: Unknown
nat_addresses: []
network_name: ''
port_id: ge-1/0/5
port_usage: lan
rx_bytes: 0
rx_pkts: 0
tx_bytes: 0
tx_pkts: 0
up: true
vlan: 0
ip: 69.196.157.190
ip_stat:
gateway: 69.196.157.185
ip: 69.196.157.190
ips:
vlan1: 69.196.157.190,69.196.157.190
netmask: 255.255.255.255
is_ha: true
last_seen: 1720598726
mac: 4db14e107134
mac_table_stats:
mac_table_count: 0
max_mac_entries_supported: 160000
memory2_stat:
usage: 32
memory_stat:
usage: 39
model: SRX300
modified_time: 1720092942
module2_stat:
- backup_version: 21.2R3-S7.7
fans: []
last_seen: 1720598717
mac: ec38739270c0
model: SRX300
psus:
- name: Power Supply 0
status: ok
recovery_version: 21.2R3-S7.7
serial: CV2218AF1505
status: connected
temperatures:
- celsius: 49
name: Routing Engine
status: ok
- celsius: 64
name: Routing Engine CPU
status: ok
uptime: 580964
vc_links:
- neighbor_module_idx: 0
neighbor_port_id: fxp1
port_id: fxp1
vc_role: secondary
vc_state: active
version: 21.2R3-S6.11
module_stat:
- backup_version: 21.2R3-S7.7
fans: []
last_seen: 1720598716.999985
mac: 4db14e107134
model: SRX300
psus:
- name: Power Supply 0
status: ok
recovery_version: 21.2R3-S7.7
serial: CV0219AN0335
status: connected
temperatures:
- celsius: 49
name: Routing Engine
status: ok
- celsius: 65
name: Routing Engine CPU
status: ok
uptime: 1945193
vc_links:
- neighbor_module_idx: 1
neighbor_port_id: fxp1
port_id: fxp1
vc_role: primary
vc_state: active
version: 21.2R3-S6.11
name: wan_srx_tor_hub1-srx
org_id: af010e2b-f829-4975-b49e-2e896ed1d627
route_summary_stats:
fib_routes: 0
max_unicast_routes_supported: 1240000
rib_routes: 0
total_routes: 0
serial: CV0219AN0335
service_stat: {}
service_status:
appid_status: enabled
appid_version: 3720
ewf_status: disabled
idp_install_result: successful
idp_install_timestamp: 2024-07-10T06:29:11.708164029Z
idp_status: disabled
idp_update_timestamp: 2024-07-10T06:28:28.567046244Z
site_id: 83c31971-ad70-4419-ae20-7f2b90748986
spu2_stat:
- spu_cpu: 0
spu_current_session: 39
spu_max_session: 32768
spu_memory: 31
spu_pending_session: 0
spu_uptime: 1944572
spu_valid_session: 0
spu_stat:
- spu_cpu: 1
spu_current_session: 47
spu_max_session: 32768
spu_memory: 34
spu_pending_session: 0
spu_uptime: 1944572
spu_valid_session: 0
status: connected
tag_id: 3550217
tag_uuid: af010e2b-f829-4975-b49e-2e896ed1d627
type: gateway
uptime: 581259
version: 21.2R3-S6.11
Switch Stats:
value:
- ap_redundancy:
num_aps: 1
num_aps_with_switch_redundancy: 1
arp_table_stats:
arp_table_count: 16
max_entries_supported: 32000
auto_upgrade_stat:
lastcheck: 1720600596
cert_expiry: 1743932274
clients:
- device_mac: 0912f561b653
mac: 001132f5ad23
port_id: ge-1/0/11
clients_stats:
total:
num_aps:
- 0
- 0
num_wired_clients: 13
config_status: COMMITED
config_timestamp: 1720552389
config_version: 1720552389
cpu_stat:
idle: 74
interrupt: 0
load_avg:
- 0.8
- 0.75
- 0.78
system: 13
user: 13
created_time: 1712346090
dhcpd_stat:
ifo:
num_ips: 5
num_leased: 0
ext_ip: 153.142.221.41
fw_versions_outofsync: false
fwupdate:
progress: 100
status: upgraded
status_id: 3037
timestamp: 1712409702.9714448
will_retry: false
has_pcap: true
hostname: SW-HLAB-ea2e00
hw_rev: A
id: 00000000-0000-0000-1000-0912f561b653
if_stat:
ge-0/0/5.0:
port_id: ge-0/0/5
rx_bytes: 0
rx_pkts: 78110
tx_bytes: 0
tx_pkts: 61037
up: true
ge-1/0/0.0:
port_id: ge-1/0/0
rx_bytes: 0
rx_pkts: 56415
tx_bytes: 0
tx_pkts: 72209
up: true
irb.172:
ips:
- 10.3.172.41/24
port_id: irb
rx_bytes: 0
rx_pkts: 1291755
tx_bytes: 0
tx_pkts: 990327
up: true
vlan: 172
vme.0:
port_id: vme
rx_bytes: 0
rx_pkts: 0
tx_bytes: 0
tx_pkts: 0
up: true
ip: 10.3.10.10
ip_stat:
gateway: 10.3.172.9
ip: 10.3.10.10
ips:
vlan172: 10.3.172.41
netmask: 255.255.255.255
last_seen: 1720601189
last_trouble:
code: '103'
timestamp: 1712412455215
mac: 0912f561b653
mac_table_stats:
mac_table_count: 58
max_mac_entries_supported: 64000
memory_stat:
usage: 16
model: EX4100-F-12P
modified_time: 1720552388
module_stat:
- boot_partition: junos
cpu_stat:
idle: 74
interrupt: 0
load_avg:
- 0.8
- 0.75
- 0.78
system: 13
user: 13
fpc_idx: 0
mac: 0912f561b653
memory_stat:
usage: 16
model: EX4100-F-12P
pics:
- index: 0
model_number: EX4100-F-12P
port_groups:
- count: 12
type: GE
- index: 1
model_number: EX4100-F-12P
port_groups:
- count: 4
type: SFP/SFP+
- index: 2
model_number: EX4100-F-12P
port_groups:
- count: 2
type: GE
poe:
max_power: 180
power_draw: 7.3
psus:
- name: Power Supply 0
status: ok
- name: Power Supply 1
status: absent
- name: Power Supply 2
status: absent
serial: FJ0324AV0077
temperatures:
- celsius: 51
name: Thermal board Sensor 1
status: ok
- celsius: 51
name: Thermal board Sensor 2
status: ok
- celsius: 50
name: Thermal board Sensor 3
status: ok
- celsius: 57
name: PFE Die Sensor
status: ok
type: fpc
uptime: 1692720
vc_links:
- neighbor_module_idx: 1
neighbor_port_id: vcp-1/1/1
port_id: vcp-0/1/0
- neighbor_module_idx: 1
neighbor_port_id: vcp-1/1/0
port_id: vcp-0/1/1
vc_mode: HiGiG
vc_role: master
vc_state: present
version: 22.4R3.25
- boot_partition: junos
cpu_stat:
idle: 79
interrupt: 0
load_avg:
- 0.52
- 0.46
- 0.46
system: 6
user: 15
fpc_idx: 1
mac: 485a0deb2380
memory_stat:
usage: 14
model: EX4100-F-12P
pics:
- index: 0
model_number: EX4100-F-12P
port_groups:
- count: 12
type: GE
- index: 1
model_number: EX4100-F-12P
port_groups:
- count: 4
type: SFP/SFP+
- index: 2
model_number: EX4100-F-12P
port_groups:
- count: 2
type: GE
poe:
max_power: 180
power_draw: 22.1
psus:
- name: Power Supply 0
status: ok
- name: Power Supply 1
status: absent
- name: Power Supply 2
status: absent
serial: FJ0424AV0101
temperatures:
- celsius: 52
name: Thermal board Sensor 1
status: ok
- celsius: 53
name: Thermal board Sensor 2
status: ok
- celsius: 52
name: Thermal board Sensor 3
status: ok
- celsius: 59
name: PFE Die Sensor
status: ok
type: fpc
uptime: 1692720
vc_links:
- neighbor_module_idx: 0
neighbor_port_id: vcp-0/1/1
port_id: vcp-1/1/0
- neighbor_module_idx: 0
neighbor_port_id: vcp-0/1/0
port_id: vcp-1/1/1
vc_mode: HiGiG
vc_role: backup
vc_state: present
version: 22.4R3.25
name: SW-HLAB-ea2e00
org_id: c5324060-19da-48fa-af28-2b530bd08765
route_summary_stats:
fib_routes: 7
max_unicast_routes_supported: 32150
rib_routes: 40
total_routes: 3
serial: FJ0324AV0077
site_id: a0e43ffb-94a6-4f27-92aa-9cf832e1143d
status: connected
tag_id: 3564806
tag_uuid: 507604a4-6b34-449c-acb3-87955430b006
type: switch
uptime: 1692720
vc_mac: 0912f561b653
vc_setup_info:
config_type: nonprovisioned
err_missing_dev_id_fpc: false
version: 22.4R3.25
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/stats_device'
description: Device statistics records returned by a stats response
examples:
- '[{"auto_upgrade_stat":{"lastcheck":1720594762},"ble_stat":{"beacon_enabled":true,"beacon_rate":4,"eddystone_uid_enabled":false,"eddystone_uid_freq_msec":1000,"eddystone_uid_instance":"5c5b35d0077b","eddystone_uid_namespace":"9777c1a06ef611e68bbf","eddystone_url_enabled":false,"eddystone_url_freq_msec":1000,"eddystone_url_url":"","ibeacon_enabled":false,"ibeacon_freq_msec":1000,"ibeacon_major":894,"ibeacon_minor":9328,"ibeacon_uuid":"af010e2b-f829-4975-b49e-2e896ed1d627","major":894,"minors":[9328,9329,9330,9331,9332,9333,9334,9335,-1],"power":8,"rx_bytes":158500843,"rx_pkts":3549163,"tx_bytes":509640,"tx_pkts":85411,"tx_resets":0,"uuid":"af010e2b-f829-4975-b49e-2e896ed1d627"},"config_reverted":false,"cpu_system":21921854,"cpu_user":7496631,"cpu_util":5,"created_time":1718228350,"env_stat":{"accel_x":-0.092,"accel_y":0.004,"accel_z":-1.02,"ambient_temp":43,"attitude":0,"cpu_temp":53,"humidity":9,"magne_x":0,"magne_y":0,"magne_z":0,"pressure":968,"vcore_voltage":0},"ext_ip":"66.129.234.28","hw_rev":"C02","id":"00000000-0000-0000-1000-5c5b35d0077b","inactive_wired_vlans":[],"ip":"192.168.95.3","ip_stat":{"dhcp_server":"192.168.95.1","dns":["8.8.8.8"],"gateway":"192.168.95.1","ip":"192.168.95.3","ip6":"fe80:0:0:0:5e5b:35ff:fed0:77b","ips":{"vlan1":"192.168.95.3/24,fe80:0:0:0:5e5b:35ff:fed0:77b/64"},"netmask":"255.255.255.0","netmask6":"/64"},"last_seen":1720595866,"last_trouble":{"code":"07","timestamp":1720039666},"lldp_stat":{"chassis_id":"d0:07:ca:f5:21:00","lldp_med_supported":false,"mgmt_addr":"100.123.105.1","mgmt_addrs":["100.123.105.1"],"port_desc":"ge-0/0/4","port_id":"ge-0/0/4","power_allocated":0,"power_draw":0,"power_request_count":0,"power_requested":0,"system_desc":"Juniper Networks, Inc. ex4300-48t internet router, kernel JUNOS 20.4R3-S7.2, Build date: 2023-04-21 19:47:18 UTC Copyright (c) 1996-2023 Juniper Networks, Inc.","system_name":"Phoenix-Switch"},"mac":"5c5b35d0077b","mem_total_kb":505468,"mem_used_kb":202096,"model":"AP43","modified_time":1718530662,"mount":"faceup","name":"Phoenix","notes":"","num_clients":1,"org_id":"af010e2b-f829-4975-b49e-2e896ed1d627","port_stat":{"eth0":{"full_duplex":true,"rx_bytes":1284143195,"rx_errors":0,"rx_peak_bps":17585,"rx_pkts":5199816,"speed":1000,"tx_bytes":1283744961,"tx_peak_bps":26484,"tx_pkts":3990463,"up":true},"eth1":{"full_duplex":false,"rx_bytes":0,"rx_errors":0,"rx_peak_bps":0,"rx_pkts":0,"speed":0,"tx_bytes":0,"tx_peak_bps":0,"tx_pkts":0,"up":false}},"power_budget":8400,"power_constrained":false,"power_src":"DC Input","radio_config":{},"radio_stat":{"band_24":{"bandwidth":20,"channel":11,"mac":"5c5b35dea810","noise_floor":-80,"num_clients":0,"power":17,"rx_bytes":12948211,"rx_pkts":65292,"tx_bytes":19071943,"tx_pkts":76926,"usage":"24","util_all":24,"util_non_wifi":2,"util_rx_in_bss":0,"util_rx_other_bss":17,"util_tx":4,"util_undecodable_wifi":0,"util_unknown_wifi":1},"band_5":{"bandwidth":40,"channel":36,"mac":"5c5b35dea7f0","noise_floor":-90,"num_clients":1,"power":17,"rx_bytes":578362619,"rx_pkts":2687577,"tx_bytes":1199571353,"tx_pkts":2479302,"usage":"5","util_all":13,"util_non_wifi":0,"util_rx_in_bss":0,"util_rx_other_bss":10,"util_tx":1,"util_undecodable_wifi":0,"util_unknown_wifi":1}},"rx_bps":9276,"rx_bytes":591310830,"rx_pkts":2752869,"serial":"A0703200709E6","site_id":"46fc665e-9706-4296-8fe2-78f42f2e67e4","status":"connected","switch_redundancy":{"num_redundant_aps":1},"tx_bps":8067,"tx_bytes":1218643296,"tx_pkts":2556228,"type":"ap","uptime":1593120,"version":"0.14.29313"}]'
- '[{"arp_table_stats":{"arp_table_count":21,"max_entries_supported":64000},"auto_upgrade_stat":{"lastcheck":1720595477},"cert_expiry":1743292763,"cluster_config":{"configuration":"active-active","control_link_info":{"name":"fxp1","status":"Up"},"ethernet_connection":[{"name":"reth0","status":"Up"},{"name":"reth1","status":"Up"},{"name":"reth2","status":"Down"},{"name":"reth3","status":"Down"},{"name":"reth4","status":"Up"}],"fabric_link_info":{"DataPlaneNotifiedStatus":"Up","Interface":[],"InternalStatus":"Up","State":"Enabled","Status":"Enabled"},"last_status_change_reason":"No failures","operational":"active-active","primary_node_health":"Healthy","redundancy_group_information":[{"Id":0,"MonitoringFailure":"none","Threshold":255},{"Id":1,"MonitoringFailure":"interface-monitoring","Threshold":0},{"Id":2,"MonitoringFailure":"none","Threshold":255}],"secondary_node_health":"Not healthy","status":"Green"},"config_status":"COMMITED","config_timestamp":1720182848,"config_version":1720182848,"cpu2_stat":{"idle":86,"interrupt":0,"load_avg":[0.13,0.17,0.16],"system":5,"user":9},"cpu_stat":{"idle":76,"interrupt":0,"load_avg":[0.18,0.31,0.39],"system":10,"user":14},"created_time":1711756611,"deviceprofile_id":"5e5daedf-e650-4013-b41c-845f0d2b9414","deviceprofile_name":"wan_srx_tor_hub1","dhcpd_stat":{"byod_dc1":{"num_ips":100,"num_leased":0},"corp_dc1":{"num_ips":100,"num_leased":4},"guest_dc1":{"num_ips":241,"num_leased":0},"iot_dc1":{"num_ips":100,"num_leased":0},"mgmt_dc1":{"num_ips":100,"num_leased":2},"teleworker":{"num_ips":140,"num_leased":0}},"ext_ip":"69.196.157.189","fwupdate":{"progress":100,"status":"upgraded","status_id":3037,"timestamp":1718392692.580769,"will_retry":false},"has_pcap":false,"hostname":"wan_srx_tor_hub1-srx","id":"00000000-0000-0000-1000-4db14e107134","if_stat":{"ge-0/0/5.130":{"address_mode":"Unknown","nat_addresses":[],"network_name":"","port_id":"ge-0/0/5","port_usage":"lan","rx_bytes":0,"rx_pkts":0,"tx_bytes":0,"tx_pkts":0,"up":true,"vlan":0},"ge-1/0/5.120":{"address_mode":"Unknown","nat_addresses":[],"network_name":"","port_id":"ge-1/0/5","port_usage":"lan","rx_bytes":0,"rx_pkts":0,"tx_bytes":0,"tx_pkts":0,"up":true,"vlan":0}},"ip":"69.196.157.190","ip_stat":{"gateway":"69.196.157.185","ip":"69.196.157.190","ips":{"vlan1":"69.196.157.190,69.196.157.190"},"netmask":"255.255.255.255"},"is_ha":true,"last_seen":1720598726,"mac":"4db14e107134","mac_table_stats":{"mac_table_count":0,"max_mac_entries_supported":160000},"memory2_stat":{"usage":32},"memory_stat":{"usage":39},"model":"SRX300","modified_time":1720092942,"module2_stat":[{"backup_version":"21.2R3-S7.7","fans":[],"last_seen":1720598717,"mac":"ec38739270c0","model":"SRX300","psus":[{"name":"Power Supply 0","status":"ok"}],"recovery_version":"21.2R3-S7.7","serial":"CV2218AF1505","status":"connected","temperatures":[{"celsius":49,"name":"Routing Engine","status":"ok"},{"celsius":64,"name":"Routing Engine CPU","status":"ok"}],"uptime":580964,"vc_links":[{"neighbor_module_idx":0,"neighbor_port_id":"fxp1","port_id":"fxp1"}],"vc_role":"secondary","vc_state":"active","version":"21.2R3-S6.11"}],"module_stat":[{"backup_version":"21.2R3-S7.7","fans":[],"last_seen":1720598716.999985,"mac":"4db14e107134","model":"SRX300","psus":[{"name":"Power Supply 0","status":"ok"}],"recovery_version":"21.2R3-S7.7","serial":"CV0219AN0335","status":"connected","temperatures":[{"celsius":49,"name":"Routing Engine","status":"ok"},{"celsius":65,"name":"Routing Engine CPU","status":"ok"}],"uptime":1945193,"vc_links":[{"neighbor_module_idx":1,"neighbor_port_id":"fxp1","port_id":"fxp1"}],"vc_role":"primary","vc_state":"active","version":"21.2R3-S6.11"}],"name":"wan_srx_tor_hub1-srx","org_id":"af010e2b-f829-4975-b49e-2e896ed1d627","route_summary_stats":{"fib_routes":0,"max_unicast_routes_supported":1240000,"rib_routes":0,"total_routes":0},"serial":"CV0219AN0335","service_stat":{},"service_status":{"appid_status":"enabled","appid_version":3720,"ewf_status":"disabled","idp_install_result":"successful","idp_install_timestamp":"2024-07-10T06:29:11.708164029Z","idp_status":"disabled","idp_update_timestamp":"2024-07-10T06:28:28.567046244Z"},"site_id":"83c31971-ad70-4419-ae20-7f2b90748986","spu2_stat":[{"spu_cpu":0,"spu_current_session":39,"spu_max_session":32768,"spu_memory":31,"spu_pending_session":0,"spu_uptime":1944572,"spu_valid_session":0}],"spu_stat":[{"spu_cpu":1,"spu_current_session":47,"spu_max_session":32768,"spu_memory":34,"spu_pending_session":0,"spu_uptime":1944572,"spu_valid_session":0}],"status":"connected","tag_id":3550217,"tag_uuid":"af010e2b-f829-4975-b49e-2e896ed1d627","type":"gateway","uptime":581259,"version":"21.2R3-S6.11"}]'
- '[{"ap_redundancy":{"num_aps":1,"num_aps_with_switch_redundancy":1},"arp_table_stats":{"arp_table_count":16,"max_entries_supported":32000},"auto_upgrade_stat":{"lastcheck":1720600596},"cert_expiry":1743932274,"clients":[{"device_mac":"0912f561b653","mac":"001132f5ad23","port_id":"ge-1/0/11"}],"clients_stats":{"total":{"num_aps":[0,0],"num_wired_clients":13}},"config_status":"COMMITED","config_timestamp":1720552389,"config_version":1720552389,"cpu_stat":{"idle":74,"interrupt":0,"load_avg":[0.8,0.75,0.78],"system":13,"user":13},"created_time":1712346090,"dhcpd_stat":{"ifo":{"num_ips":5,"num_leased":0}},"ext_ip":"153.142.221.41","fw_versions_outofsync":false,"fwupdate":{"progress":100,"status":"upgraded","status_id":3037,"timestamp":1712409702.9714448,"will_retry":false},"has_pcap":true,"hostname":"SW-HLAB-ea2e00","hw_rev":"A","id":"00000000-0000-0000-1000-0912f561b653","if_stat":{"ge-0/0/5.0":{"port_id":"ge-0/0/5","rx_bytes":0,"rx_pkts":78110,"tx_bytes":0,"tx_pkts":61037,"up":true},"ge-1/0/0.0":{"port_id":"ge-1/0/0","rx_bytes":0,"rx_pkts":56415,"tx_bytes":0,"tx_pkts":72209,"up":true},"irb.172":{"ips":["10.3.172.41/24"],"port_id":"irb","rx_bytes":0,"rx_pkts":1291755,"tx_bytes":0,"tx_pkts":990327,"up":true,"vlan":172},"vme.0":{"port_id":"vme","rx_bytes":0,"rx_pkts":0,"tx_bytes":0,"tx_pkts":0,"up":true}},"ip":"10.3.10.10","ip_stat":{"gateway":"10.3.172.9","ip":"10.3.10.10","ips":{"vlan172":"10.3.172.41"},"netmask":"255.255.255.255"},"last_seen":1720601189,"last_trouble":{"code":"103","timestamp":1712412455215},"mac":"0912f561b653","mac_table_stats":{"mac_table_count":58,"max_mac_entries_supported":64000},"memory_stat":{"usage":16},"model":"EX4100-F-12P","modified_time":1720552388,"module_stat":[{"boot_partition":"junos","cpu_stat":{"idle":74,"interrupt":0,"load_avg":[0.8,0.75,0.78],"system":13,"user":13},"fpc_idx":0,"mac":"0912f561b653","memory_stat":{"usage":16},"model":"EX4100-F-12P","pics":[{"index":0,"model_number":"EX4100-F-12P","port_groups":[{"count":12,"type":"GE"}]},{"index":1,"model_number":"EX4100-F-12P","port_groups":[{"count":4,"type":"SFP/SFP+"}]},{"index":2,"model_number":"EX4100-F-12P","port_groups":[{"count":2,"type":"GE"}]}],"poe":{"max_power":180,"power_draw":7.3},"psus":[{"name":"Power Supply 0","status":"ok"},{"name":"Power Supply 1","status":"absent"},{"name":"Power Supply 2","status":"absent"}],"serial":"FJ0324AV0077","temperatures":[{"celsius":51,"name":"Thermal board Sensor 1","status":"ok"},{"celsius":51,"name":"Thermal board Sensor 2","status":"ok"},{"celsius":50,"name":"Thermal board Sensor 3","status":"ok"},{"celsius":57,"name":"PFE Die Sensor","status":"ok"}],"type":"fpc","uptime":1692720,"vc_links":[{"neighbor_module_idx":1,"neighbor_port_id":"vcp-1/1/1","port_id":"vcp-0/1/0"},{"neighbor_module_idx":1,"neighbor_port_id":"vcp-1/1/0","port_id":"vcp-0/1/1"}],"vc_mode":"HiGiG","vc_role":"master","vc_state":"present","version":"22.4R3.25"},{"boot_partition":"junos","cpu_stat":{"idle":79,"interrupt":0,"load_avg":[0.52,0.46,0.46],"system":6,"user":15},"fpc_idx":1,"mac":"485a0deb2380","memory_stat":{"usage":14},"model":"EX4100-F-12P","pics":[{"index":0,"model_number":"EX4100-F-12P","port_groups":[{"count":12,"type":"GE"}]},{"index":1,"model_number":"EX4100-F-12P","port_groups":[{"count":4,"type":"SFP/SFP+"}]},{"index":2,"model_number":"EX4100-F-12P","port_groups":[{"count":2,"type":"GE"}]}],"poe":{"max_power":180,"power_draw":22.1},"psus":[{"name":"Power Supply 0","status":"ok"},{"name":"Power Supply 1","status":"absent"},{"name":"Power Supply 2","status":"absent"}],"serial":"FJ0424AV0101","temperatures":[{"celsius":52,"name":"Thermal board Sensor 1","status":"ok"},{"celsius":53,"name":"Thermal board Sensor 2","status":"ok"},{"celsius":52,"name":"Thermal board Sensor 3","status":"ok"},{"celsius":59,"name":"PFE Die Sensor","status":"ok"}],"type":"fpc","uptime":1692720,"vc_links":[{"neighbor_module_idx":0,"neighbor_port_id":"vcp-0/1/1","port_id":"vcp-1/1/0"},{"neighbor_module_idx":0,"neighbor_port_id":"vcp-0/1/0","port_id":"vcp-1/1/1"}],"vc_mode":"HiGiG","vc_role":"backup","vc_state":"present","version":"22.4R3.25"}],"name":"SW-HLAB-ea2e00","org_id":"c5324060-19da-48fa-af28-2b530bd08765","route_summary_stats":{"fib_routes":7,"max_unicast_routes_supported":32150,"rib_routes":40,"total_routes":3},"serial":"FJ0324AV0077","site_id":"a0e43ffb-94a6-4f27-92aa-9cf832e1143d","status":"connected","tag_id":3564806,"tag_uuid":"507604a4-6b34-449c-acb3-87955430b006","type":"switch","uptime":1692720,"vc_mac":"0912f561b653","vc_setup_info":{"config_type":"nonprovisioned","err_missing_dev_id_fpc":false},"version":"22.4R3.25"}]'
contentMediaType: application/vnd.api+json
examples:
Access Point Stats:
value:
- auto_upgrade_stat:
lastcheck: 1720594762
ble_stat:
beacon_enabled: true
beacon_rate: 4
eddystone_uid_enabled: false
eddystone_uid_freq_msec: 1000
eddystone_uid_instance: 5c5b35d0077b
eddystone_uid_namespace: 9777c1a06ef611e68bbf
eddystone_url_enabled: false
eddystone_url_freq_msec: 1000
eddystone_url_url: ''
ibeacon_enabled: false
ibeacon_freq_msec: 1000
ibeacon_major: 894
ibeacon_minor: 9328
ibeacon_uuid: af010e2b-f829-4975-b49e-2e896ed1d627
major: 894
minors:
- 9328
- 9329
- 9330
- 9331
- 9332
- 9333
- 9334
- 9335
- -1
power: 8
rx_bytes: 158500843
rx_pkts: 3549163
tx_bytes: 509640
tx_pkts: 85411
tx_resets: 0
uuid: af010e2b-f829-4975-b49e-2e896ed1d627
config_reverted: false
cpu_system: 21921854
cpu_user: 7496631
cpu_util: 5
created_time: 1718228350
env_stat:
accel_x: -0.092
accel_y: 0.004
accel_z: -1.02
ambient_temp: 43
attitude: 0
cpu_temp: 53
humidity: 9
magne_x: 0
magne_y: 0
magne_z: 0
pressure: 968
vcore_voltage: 0
ext_ip: 66.129.234.28
hw_rev: C02
id: 00000000-0000-0000-1000-5c5b35d0077b
inactive_wired_vlans: []
ip: 192.168.95.3
ip_stat:
dhcp_server: 192.168.95.1
dns:
- 8.8.8.8
gateway: 192.168.95.1
ip: 192.168.95.3
ip6: fe80:0:0:0:5e5b:35ff:fed0:77b
ips:
vlan1: 192.168.95.3/24,fe80:0:0:0:5e5b:35ff:fed0:77b/64
netmask: 255.255.255.0
netmask6: /64
last_seen: 1720595866
last_trouble:
code: '07'
timestamp: 1720039666
lldp_stat:
chassis_id: d0:07:ca:f5:21:00
lldp_med_supported: false
mgmt_addr: 100.123.105.1
mgmt_addrs:
- 100.123.105.1
port_desc: ge-0/0/4
port_id: ge-0/0/4
power_allocated: 0
power_draw: 0
power_request_count: 0
power_requested: 0
system_desc: 'Juniper Networks, Inc. ex4300-48t internet router, kernel JUNOS 20.4R3-S7.2, Build date: 2023-04-21 19:47:18 UTC Copyright (c) 1996-2023 Juniper Networks, Inc.'
system_name: Phoenix-Switch
mac: 5c5b35d0077b
mem_total_kb: 505468
mem_used_kb: 202096
model: AP43
modified_time: 1718530662
mount: faceup
name: Phoenix
notes: ''
num_clients: 1
org_id: af010e2b-f829-4975-b49e-2e896ed1d627
port_stat:
eth0:
full_duplex: true
rx_bytes: 1284143195
rx_errors: 0
rx_peak_bps: 17585
rx_pkts: 5199816
speed: 1000
tx_bytes: 1283744961
tx_peak_bps: 26484
tx_pkts: 3990463
up: true
eth1:
full_duplex: false
rx_bytes: 0
rx_errors: 0
rx_peak_bps: 0
rx_pkts: 0
speed: 0
tx_bytes: 0
tx_peak_bps: 0
tx_pkts: 0
up: false
power_budget: 8400
power_constrained: false
power_src: DC Input
radio_config: {}
radio_stat:
band_24:
bandwidth: 20
channel: 11
mac: 5c5b35dea810
noise_floor: -80
num_clients: 0
power: 17
rx_bytes: 12948211
rx_pkts: 65292
tx_bytes: 19071943
tx_pkts: 76926
usage: '24'
util_all: 24
util_non_wifi: 2
util_rx_in_bss: 0
util_rx_other_bss: 17
util_tx: 4
util_undecodable_wifi: 0
util_unknown_wifi: 1
band_5:
bandwidth: 40
channel: 36
mac: 5c5b35dea7f0
noise_floor: -90
num_clients: 1
power: 17
rx_bytes: 578362619
rx_pkts: 2687577
tx_bytes: 1199571353
tx_pkts: 2479302
usage: '5'
util_all: 13
util_non_wifi: 0
util_rx_in_bss: 0
util_rx_other_bss: 10
util_tx: 1
util_undecodable_wifi: 0
util_unknown_wifi: 1
rx_bps: 9276
rx_bytes: 591310830
rx_pkts: 2752869
serial: A0703200709E6
site_id: 46fc665e-9706-4296-8fe2-78f42f2e67e4
status: connected
switch_redundancy:
num_redundant_aps: 1
tx_bps: 8067
tx_bytes: 1218643296
tx_pkts: 2556228
type: ap
uptime: 1593120
version: 0.14.29313
Gateway Stats:
value:
- arp_table_stats:
arp_table_count: 21
max_entries_supported: 64000
auto_upgrade_stat:
lastcheck: 1720595477
cert_expiry: 1743292763
cluster_config:
configuration: active-active
control_link_info:
name: fxp1
status: Up
ethernet_connection:
- name: reth0
status: Up
- name: reth1
status: Up
- name: reth2
status: Down
- name: reth3
status: Down
- name: reth4
status: Up
fabric_link_info:
DataPlaneNotifiedStatus: Up
Interface: []
InternalStatus: Up
State: Enabled
Status: Enabled
last_status_change_reason: No failures
operational: active-active
primary_node_health: Healthy
redundancy_group_information:
- Id: 0
MonitoringFailure: none
Threshold: 255
- Id: 1
MonitoringFailure: interface-monitoring
Threshold: 0
- Id: 2
MonitoringFailure: none
Threshold: 255
secondary_node_health: Not healthy
status: Green
config_status: COMMITED
config_timestamp: 1720182848
config_version: 1720182848
cpu2_stat:
idle: 86
interrupt: 0
load_avg:
- 0.13
- 0.17
- 0.16
system: 5
user: 9
cpu_stat:
idle: 76
interrupt: 0
load_avg:
- 0.18
- 0.31
- 0.39
system: 10
user: 14
created_time: 1711756611
deviceprofile_id: 5e5daedf-e650-4013-b41c-845f0d2b9414
deviceprofile_name: wan_srx_tor_hub1
dhcpd_stat:
byod_dc1:
num_ips: 100
num_leased: 0
corp_dc1:
num_ips: 100
num_leased: 4
guest_dc1:
num_ips: 241
num_leased: 0
iot_dc1:
num_ips: 100
num_leased: 0
mgmt_dc1:
num_ips: 100
num_leased: 2
teleworker:
num_ips: 140
num_leased: 0
ext_ip: 69.196.157.189
fwupdate:
progress: 100
status: upgraded
status_id: 3037
timestamp: 1718392692.580769
will_retry: false
has_pcap: false
hostname: wan_srx_tor_hub1-srx
id: 00000000-0000-0000-1000-4db14e107134
if_stat:
ge-0/0/5.130:
address_mode: Unknown
nat_addresses: []
network_name: ''
port_id: ge-0/0/5
port_usage: lan
rx_bytes: 0
rx_pkts: 0
tx_bytes: 0
tx_pkts: 0
up: true
vlan: 0
ge-1/0/5.120:
address_mode: Unknown
nat_addresses: []
network_name: ''
port_id: ge-1/0/5
port_usage: lan
rx_bytes: 0
rx_pkts: 0
tx_bytes: 0
tx_pkts: 0
up: true
vlan: 0
ip: 69.196.157.190
ip_stat:
gateway: 69.196.157.185
ip: 69.196.157.190
ips:
vlan1: 69.196.157.190,69.196.157.190
netmask: 255.255.255.255
is_ha: true
last_seen: 1720598726
mac: 4db14e107134
mac_table_stats:
mac_table_count: 0
max_mac_entries_supported: 160000
memory2_stat:
usage: 32
memory_stat:
usage: 39
model: SRX300
modified_time: 1720092942
module2_stat:
- backup_version: 21.2R3-S7.7
fans: []
last_seen: 1720598717
mac: ec38739270c0
model: SRX300
psus:
- name: Power Supply 0
status: ok
recovery_version: 21.2R3-S7.7
serial: CV2218AF1505
status: connected
temperatures:
- celsius: 49
name: Routing Engine
status: ok
- celsius: 64
name: Routing Engine CPU
status: ok
uptime: 580964
vc_links:
- neighbor_module_idx: 0
neighbor_port_id: fxp1
port_id: fxp1
vc_role: secondary
vc_state: active
version: 21.2R3-S6.11
module_stat:
- backup_version: 21.2R3-S7.7
fans: []
last_seen: 1720598716.999985
mac: 4db14e107134
model: SRX300
psus:
- name: Power Supply 0
status: ok
recovery_version: 21.2R3-S7.7
serial: CV0219AN0335
status: connected
temperatures:
- celsius: 49
name: Routing Engine
status: ok
- celsius: 65
name: Routing Engine CPU
status: ok
uptime: 1945193
vc_links:
- neighbor_module_idx: 1
neighbor_port_id: fxp1
port_id: fxp1
vc_role: primary
vc_state: active
version: 21.2R3-S6.11
name: wan_srx_tor_hub1-srx
org_id: af010e2b-f829-4975-b49e-2e896ed1d627
route_summary_stats:
fib_routes: 0
max_unicast_routes_supported: 1240000
rib_routes: 0
total_routes: 0
serial: CV0219AN0335
service_stat: {}
service_status:
appid_status: enabled
appid_version: 3720
ewf_status: disabled
idp_install_result: successful
idp_install_timestamp: 2024-07-10T06:29:11.708164029Z
idp_status: disabled
idp_update_timestamp: 2024-07-10T06:28:28.567046244Z
site_id: 83c31971-ad70-4419-ae20-7f2b90748986
spu2_stat:
- spu_cpu: 0
spu_current_session: 39
spu_max_session: 32768
spu_memory: 31
spu_pending_session: 0
spu_uptime: 1944572
spu_valid_session: 0
spu_stat:
- spu_cpu: 1
spu_current_session: 47
spu_max_session: 32768
spu_memory: 34
spu_pending_session: 0
spu_uptime: 1944572
spu_valid_session: 0
status: connected
tag_id: 3550217
tag_uuid: af010e2b-f829-4975-b49e-2e896ed1d627
type: gateway
uptime: 581259
version: 21.2R3-S6.11
Switch Stats:
value:
- ap_redundancy:
num_aps: 1
num_aps_with_switch_redundancy: 1
arp_table_stats:
arp_table_count: 16
max_entries_supported: 32000
auto_upgrade_stat:
lastcheck: 1720600596
cert_expiry: 1743932274
clients:
- device_mac: 0912f561b653
mac: 001132f5ad23
port_id: ge-1/0/11
clients_stats:
total:
num_aps:
- 0
- 0
num_wired_clients: 13
config_status: COMMITED
config_timestamp: 1720552389
config_version: 1720552389
cpu_stat:
idle: 74
interrupt: 0
load_avg:
- 0.8
- 0.75
- 0.78
system: 13
user: 13
created_time: 1712346090
dhcpd_stat:
ifo:
num_ips: 5
num_leased: 0
ext_ip: 153.142.221.41
fw_versions_outofsync: false
fwupdate:
progress: 100
status: upgraded
status_id: 3037
timestamp: 1712409702.9714448
will_retry: false
has_pcap: true
hostname: SW-HLAB-ea2e00
hw_rev: A
id: 00000000-0000-0000-1000-0912f561b653
if_stat:
ge-0/0/5.0:
port_id: ge-0/0/5
rx_bytes: 0
rx_pkts: 78110
tx_bytes: 0
tx_pkts: 61037
up: true
ge-1/0/0.0:
port_id: ge-1/0/0
rx_bytes: 0
rx_pkts: 56415
tx_bytes: 0
tx_pkts: 72209
up: true
irb.172:
ips:
- 10.3.172.41/24
port_id: irb
rx_bytes: 0
rx_pkts: 1291755
tx_bytes: 0
tx_pkts: 990327
up: true
vlan: 172
vme.0:
port_id: vme
rx_bytes: 0
rx_pkts: 0
tx_bytes: 0
tx_pkts: 0
up: true
ip: 10.3.10.10
ip_stat:
gateway: 10.3.172.9
ip: 10.3.10.10
ips:
vlan172: 10.3.172.41
netmask: 255.255.255.255
last_seen: 1720601189
last_trouble:
code: '103'
timestamp: 1712412455215
mac: 0912f561b653
mac_table_stats:
mac_table_count: 58
max_mac_entries_supported: 64000
memory_stat:
usage: 16
model: EX4100-F-12P
modified_time: 1720552388
module_stat:
- boot_partition: junos
cpu_stat:
idle: 74
interrupt: 0
load_avg:
- 0.8
- 0.75
- 0.78
system: 13
user: 13
fpc_idx: 0
mac: 0912f561b653
memory_stat:
usage: 16
model: EX4100-F-12P
pics:
- index: 0
model_number: EX4100-F-12P
port_groups:
- count: 12
type: GE
- index: 1
model_number: EX4100-F-12P
port_groups:
- count: 4
type: SFP/SFP+
- index: 2
model_number: EX4100-F-12P
port_groups:
- count: 2
type: GE
poe:
max_power: 180
power_draw: 7.3
psus:
- name: Power Supply 0
status: ok
- name: Power Supply 1
status: absent
- name: Power Supply 2
status: absent
serial: FJ0324AV0077
temperatures:
- celsius: 51
name: Thermal board Sensor 1
status: ok
- celsius: 51
name: Thermal board Sensor 2
status: ok
- celsius: 50
name: Thermal board Sensor 3
status: ok
- celsius: 57
name: PFE Die Sensor
status: ok
type: fpc
uptime: 1692720
vc_links:
- neighbor_module_idx: 1
neighbor_port_id: vcp-1/1/1
port_id: vcp-0/1/0
- neighbor_module_idx: 1
neighbor_port_id: vcp-1/1/0
port_id: vcp-0/1/1
vc_mode: HiGiG
vc_role: master
vc_state: present
version: 22.4R3.25
- boot_partition: junos
cpu_stat:
idle: 79
interrupt: 0
load_avg:
- 0.52
- 0.46
- 0.46
system: 6
user: 15
fpc_idx: 1
mac: 485a0deb2380
memory_stat:
usage: 14
model: EX4100-F-12P
pics:
- index: 0
model_number: EX4100-F-12P
port_groups:
- count: 12
type: GE
- index: 1
model_number: EX4100-F-12P
port_groups:
- count: 4
type: SFP/SFP+
- index: 2
model_number: EX4100-F-12P
port_groups:
- count: 2
type: GE
poe:
max_power: 180
power_draw: 22.1
psus:
- name: Power Supply 0
status: ok
- name: Power Supply 1
status: absent
- name: Power Supply 2
status: absent
serial: FJ0424AV0101
temperatures:
- celsius: 52
name: Thermal board Sensor 1
status: ok
- celsius: 53
name: Thermal board Sensor 2
status: ok
- celsius: 52
name: Thermal board Sensor 3
status: ok
- celsius: 59
name: PFE Die Sensor
status: ok
type: fpc
uptime: 1692720
vc_links:
- neighbor_module_idx: 0
neighbor_port_id: vcp-0/1/1
port_id: vcp-1/1/0
- neighbor_module_idx: 0
neighbor_port_id: vcp-0/1/0
port_id: vcp-1/1/1
vc_mode: HiGiG
vc_role: backup
vc_state: present
version: 22.4R3.25
name: SW-HLAB-ea2e00
org_id: c5324060-19da-48fa-af28-2b530bd08765
route_summary_stats:
fib_routes: 7
max_unicast_routes_supported: 32150
rib_routes: 40
total_routes: 3
serial: FJ0324AV0077
site_id: a0e43ffb-94a6-4f27-92aa-9cf832e1143d
status: connected
tag_id: 3564806
tag_uuid: 507604a4-6b34-449c-acb3-87955430b006
type: switch
uptime: 1692720
vc_mac: 0912f561b653
vc_setup_info:
config_type: nonprovisioned
err_missing_dev_id_fpc: false
version: 22.4R3.25
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/stats/marvisclients/count:
get:
tags:
- Orgs Stats - Marvis Clients
summary: countOrgMarvisClientsStats
description: Count Marvis Client stats records by a distinct field.
operationId: countOrgMarvisClientsStats
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field to count by. enum: `device_id`, `wifi_mac`, `wifi_ip`, `hostname`, `model`, `mfg`, `serial`, `os_type`, `os_version`'
style: form
explode: true
schema:
type: string
default: os_type
- name: device_id
in: query
description: Filter by Marvis Client installation device UUID
style: form
explode: true
schema:
type: string
- name: wifi_mac
in: query
description: Filter by device Wi-Fi MAC address
style: form
explode: true
schema:
type: string
- name: wifi_ip
in: query
description: Filter by device Wi-Fi IP address
style: form
explode: true
schema:
type: string
- name: hostname
in: query
description: Filter by device hostname
style: form
explode: true
schema:
type: string
- name: model
in: query
description: Filter by device model
style: form
explode: true
schema:
type: string
- name: mfg
in: query
description: Filter by device manufacturer
style: form
explode: true
schema:
type: string
- name: serial
in: query
description: Filter by device serial number
style: form
explode: true
schema:
type: string
- name: os_type
in: query
description: Filter by device OS type or platform
style: form
explode: true
schema:
type: string
- name: os_version
in: query
description: Filter by device OS version
style: form
explode: true
schema:
type: string
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
responses:
'200':
description: Count result
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/stats/marvisclients/search:
get:
tags:
- Orgs Stats - Marvis Clients
summary: searchOrgMarvisClientsStats
description: Search Marvis Client stats records across the organization.
operationId: searchOrgMarvisClientsStats
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: query
description: Filter by Marvis Client installation device UUID
style: form
explode: true
schema:
type: string
- name: wifi_mac
in: query
description: Filter by device Wi-Fi MAC address
style: form
explode: true
schema:
type: string
- name: wifi_ip
in: query
description: Filter by device Wi-Fi IP address
style: form
explode: true
schema:
type: string
- name: hostname
in: query
description: Filter by device hostname
style: form
explode: true
schema:
type: string
- name: model
in: query
description: Filter by device model
style: form
explode: true
schema:
type: string
- name: mfg
in: query
description: Filter by device manufacturer
style: form
explode: true
schema:
type: string
- name: serial
in: query
description: Filter by device serial number
style: form
explode: true
schema:
type: string
- name: os_type
in: query
description: Filter by device OS type or platform
style: form
explode: true
schema:
type: string
- name: os_version
in: query
description: Filter by device OS version
style: form
explode: true
schema:
type: string
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
responses:
'200':
description: Paginated Marvis Client stats search results
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/stats_marvis_clients_search'
- description: Paginated list of Marvis Client stats records
examples:
- limit: 100
results:
- battery_charging: false
battery_level: 82
cpu_background: 2.1
cpu_idle: 78.3
cpu_system: 5.4
cpu_user: 14.2
device_id: 0c2a2c6c-5a95-4956-a02d-e1b39c2e5c6e
hostname: my-android-phone
location:
map_id: b4695157-0d1d-4da0-8f9e-5c38149d8b81
site_id: d14f16d8-d14f-11e5-8e81-1258369c38a9
timestamp: 1717027100
x: 423.5
y: 201
memory_total: 8589934592
memory_usage: 3758096384
mfg: Samsung
model: Galaxy S23
org_id: c168ddee-c14c-11e5-8e81-1258369c38a9
os_type: Android
os_version: '14'
serial: R5CX123456A
storage_total: 128849018880
storage_usage: 52428800000
timestamp: 1717027200
wifi_band: 5GHz
wifi_bssid: 00:11:22:33:44:55
wifi_channel: 36
wifi_ip: 192.168.1.55
wifi_mac: 00:aa:bb:cc:dd:ee
wifi_rssi: -58
wifi_ssid: Corp-WiFi
total: 1
contentMediaType: application/json
examples:
Example:
value:
limit: 100
results:
- battery_charging: false
battery_level: 82
cpu_background: 2.1
cpu_idle: 78.3
cpu_system: 5.4
cpu_user: 14.2
device_id: 0c2a2c6c-5a95-4956-a02d-e1b39c2e5c6e
hostname: my-android-phone
location:
map_id: b4695157-0d1d-4da0-8f9e-5c38149d8b81
site_id: d14f16d8-d14f-11e5-8e81-1258369c38a9
timestamp: 1717027100
x: 423.5
y: 201
memory_total: 8589934592
memory_usage: 3758096384
mfg: Samsung
model: Galaxy S23
org_id: c168ddee-c14c-11e5-8e81-1258369c38a9
os_type: Android
os_version: '14'
serial: R5CX123456A
storage_total: 128849018880
storage_usage: 52428800000
timestamp: 1717027200
wifi_band: 5GHz
wifi_bssid: 00:11:22:33:44:55
wifi_channel: 36
wifi_ip: 192.168.1.55
wifi_mac: 00:aa:bb:cc:dd:ee
wifi_rssi: -58
wifi_ssid: Corp-WiFi
total: 1
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/stats_marvis_clients_search'
- description: Paginated list of Marvis Client stats records
examples:
- limit: 100
results:
- battery_charging: false
battery_level: 82
cpu_background: 2.1
cpu_idle: 78.3
cpu_system: 5.4
cpu_user: 14.2
device_id: 0c2a2c6c-5a95-4956-a02d-e1b39c2e5c6e
hostname: my-android-phone
location:
map_id: b4695157-0d1d-4da0-8f9e-5c38149d8b81
site_id: d14f16d8-d14f-11e5-8e81-1258369c38a9
timestamp: 1717027100
x: 423.5
y: 201
memory_total: 8589934592
memory_usage: 3758096384
mfg: Samsung
model: Galaxy S23
org_id: c168ddee-c14c-11e5-8e81-1258369c38a9
os_type: Android
os_version: '14'
serial: R5CX123456A
storage_total: 128849018880
storage_usage: 52428800000
timestamp: 1717027200
wifi_band: 5GHz
wifi_bssid: 00:11:22:33:44:55
wifi_channel: 36
wifi_ip: 192.168.1.55
wifi_mac: 00:aa:bb:cc:dd:ee
wifi_rssi: -58
wifi_ssid: Corp-WiFi
total: 1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
limit: 100
results:
- battery_charging: false
battery_level: 82
cpu_background: 2.1
cpu_idle: 78.3
cpu_system: 5.4
cpu_user: 14.2
device_id: 0c2a2c6c-5a95-4956-a02d-e1b39c2e5c6e
hostname: my-android-phone
location:
map_id: b4695157-0d1d-4da0-8f9e-5c38149d8b81
site_id: d14f16d8-d14f-11e5-8e81-1258369c38a9
timestamp: 1717027100
x: 423.5
y: 201
memory_total: 8589934592
memory_usage: 3758096384
mfg: Samsung
model: Galaxy S23
org_id: c168ddee-c14c-11e5-8e81-1258369c38a9
os_type: Android
os_version: '14'
serial: R5CX123456A
storage_total: 128849018880
storage_usage: 52428800000
timestamp: 1717027200
wifi_band: 5GHz
wifi_bssid: 00:11:22:33:44:55
wifi_channel: 36
wifi_ip: 192.168.1.55
wifi_mac: 00:aa:bb:cc:dd:ee
wifi_rssi: -58
wifi_ssid: Corp-WiFi
total: 1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/stats/mxedges:
get:
tags:
- Orgs Stats - MxEdges
summary: listOrgMxEdgesStats
description: Get List of Org MxEdge Stats
operationId: listOrgMxEdgesStats
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: for_site
in: query
description: 'Filter for site level Mist Edges. enum: `any`, `true`, `false`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/for_site'
- description: 'Filter for site level Mist Edges. enum: `any`, `true`, `false`'
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/stats_mxedge'
description: Mist Edge statistics records returned by a stats response
examples:
- - cpu_stat:
cpus:
property1:
idle: 0
interrupt: 0
system: 0
usage: 0
user: 0
property2:
idle: 0
interrupt: 0
system: 0
usage: 0
user: 0
idle: 0
interrupt: 0
system: 0
usage: 0
user: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ip_stat:
ip: string
ips:
property1: string
property2: string
lag_stat:
property1:
active_ports:
- string
property2:
active_ports:
- string
last_seen: 0
magic: string
memory_stat:
active: 0
available: 0
buffers: 0
cached: 0
free: 0
inactive: 0
swap_cached: 0
swap_free: 0
swap_total: 0
total: 0
usage: 0
model: string
mxagent_registered: true
mxcluster_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
num_tunnels: 0
port_stat:
property1:
full_duplex: true
lldp_stats:
mgmt_addr: string
port_desc: string
port_id: string
system_desc: string
system_name: string
rx_bytes: 0
rx_errors: 0
rx_pkts: 0
speed: 0
tx_bytes: 0
tx_pkts: 0
up: true
property2:
full_duplex: true
lldp_stats:
mgmt_addr: string
port_desc: string
port_id: string
system_desc: string
system_name: string
rx_bytes: 0
rx_errors: 0
rx_pkts: 0
speed: 0
tx_bytes: 0
tx_pkts: 0
up: true
status: string
tunterm_registered: true
tunterm_stat:
monitoring_failed: true
uptime: 0
virtualization_type: string
contentMediaType: application/json
examples:
Example:
value:
- cpu_stat:
cpus:
property1:
idle: 0
interrupt: 0
system: 0
usage: 0
user: 0
property2:
idle: 0
interrupt: 0
system: 0
usage: 0
user: 0
idle: 0
interrupt: 0
system: 0
usage: 0
user: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ip_stat:
ip: string
ips:
property1: string
property2: string
lag_stat:
property1:
active_ports:
- string
property2:
active_ports:
- string
last_seen: 0
magic: string
memory_stat:
active: 0
available: 0
buffers: 0
cached: 0
free: 0
inactive: 0
swap_cached: 0
swap_free: 0
swap_total: 0
total: 0
usage: 0
model: string
mxagent_registered: true
mxcluster_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
num_tunnels: 0
port_stat:
property1:
full_duplex: true
lldp_stats:
mgmt_addr: string
port_desc: string
port_id: string
system_desc: string
system_name: string
rx_bytes: 0
rx_errors: 0
rx_pkts: 0
speed: 0
tx_bytes: 0
tx_pkts: 0
up: true
property2:
full_duplex: true
lldp_stats:
mgmt_addr: string
port_desc: string
port_id: string
system_desc: string
system_name: string
rx_bytes: 0
rx_errors: 0
rx_pkts: 0
speed: 0
tx_bytes: 0
tx_pkts: 0
up: true
status: string
tunterm_registered: true
tunterm_stat:
monitoring_failed: true
uptime: 0
virtualization_type: string
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/stats_mxedge'
description: Mist Edge statistics records returned by a stats response
examples:
- - cpu_stat:
cpus:
property1:
idle: 0
interrupt: 0
system: 0
usage: 0
user: 0
property2:
idle: 0
interrupt: 0
system: 0
usage: 0
user: 0
idle: 0
interrupt: 0
system: 0
usage: 0
user: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ip_stat:
ip: string
ips:
property1: string
property2: string
lag_stat:
property1:
active_ports:
- string
property2:
active_ports:
- string
last_seen: 0
magic: string
memory_stat:
active: 0
available: 0
buffers: 0
cached: 0
free: 0
inactive: 0
swap_cached: 0
swap_free: 0
swap_total: 0
total: 0
usage: 0
model: string
mxagent_registered: true
mxcluster_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
num_tunnels: 0
port_stat:
property1:
full_duplex: true
lldp_stats:
mgmt_addr: string
port_desc: string
port_id: string
system_desc: string
system_name: string
rx_bytes: 0
rx_errors: 0
rx_pkts: 0
speed: 0
tx_bytes: 0
tx_pkts: 0
up: true
property2:
full_duplex: true
lldp_stats:
mgmt_addr: string
port_desc: string
port_id: string
system_desc: string
system_name: string
rx_bytes: 0
rx_errors: 0
rx_pkts: 0
speed: 0
tx_bytes: 0
tx_pkts: 0
up: true
status: string
tunterm_registered: true
tunterm_stat:
monitoring_failed: true
uptime: 0
virtualization_type: string
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- cpu_stat:
cpus:
property1:
idle: 0
interrupt: 0
system: 0
usage: 0
user: 0
property2:
idle: 0
interrupt: 0
system: 0
usage: 0
user: 0
idle: 0
interrupt: 0
system: 0
usage: 0
user: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ip_stat:
ip: string
ips:
property1: string
property2: string
lag_stat:
property1:
active_ports:
- string
property2:
active_ports:
- string
last_seen: 0
magic: string
memory_stat:
active: 0
available: 0
buffers: 0
cached: 0
free: 0
inactive: 0
swap_cached: 0
swap_free: 0
swap_total: 0
total: 0
usage: 0
model: string
mxagent_registered: true
mxcluster_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
num_tunnels: 0
port_stat:
property1:
full_duplex: true
lldp_stats:
mgmt_addr: string
port_desc: string
port_id: string
system_desc: string
system_name: string
rx_bytes: 0
rx_errors: 0
rx_pkts: 0
speed: 0
tx_bytes: 0
tx_pkts: 0
up: true
property2:
full_duplex: true
lldp_stats:
mgmt_addr: string
port_desc: string
port_id: string
system_desc: string
system_name: string
rx_bytes: 0
rx_errors: 0
rx_pkts: 0
speed: 0
tx_bytes: 0
tx_pkts: 0
up: true
status: string
tunterm_registered: true
tunterm_stat:
monitoring_failed: true
uptime: 0
virtualization_type: string
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/stats/mxedges/{mxedge_id}:
get:
tags:
- Orgs Stats - MxEdges
summary: getOrgMxEdgeStats
description: Get Org MxEdge Details Stats
operationId: getOrgMxEdgeStats
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: mxedge_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: for_site
in: query
description: Filter results by whether the object is scoped to a site
style: form
explode: true
schema:
type: boolean
default: false
responses:
'200':
description: MxEdge Stats
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/stats_mxedge'
- description: Statistics for a Mist Edge appliance returned by stats endpoints
examples:
- cpu_stat:
cpus:
cpu0:
idle: 89
interrupt: 0
system: 8
usage: 10
user: 1
cpu1:
idle: 81
interrupt: 0
system: 4
usage: 18
user: 13
cpu2:
idle: 81
interrupt: 0
system: 4
usage: 18
user: 13
cpu3:
idle: 2
interrupt: 0
system: 50
usage: 97
user: 46
idle: 62
interrupt: 0
system: 17
usage: 37
user: 19
created_time: 1632684398
for_site: false
id: 00000000-0000-0000-1000-020000a80cb4
inactive_vlan_strs:
wired:
- '100'
- 102-106
ip_stat:
ip: 192.168.1.244
ips:
ens18: 192.168.1.244/24,fe80::104c:ffff:fee0:caf8/64
macs:
ens18: e4434b217044
lag_stat:
lacp0:
active_ports:
- port0
- port1
last_seen: 1633721215
mac: 020000a80cb4
memory_stat:
active: 394936320
available: 4699291648
buffers: 107646976
cached: 478060544
free: 4330659840
inactive: 211980288
swap_cached: 0
swap_free: 1022357504
swap_total: 1022357504
total: 8365957120
usage: 48
model: ME-VM
modified_time: 1633643629
mxagent_registered: true
mxcluster_id: 678bc339-7635-4556-bbc0-e77ad493ef8b
name: me-vm-1
num_tunnels: 0
oob_ip_config:
dns:
- 8.8.8.8
- 1.1.1.1
gateway: 10.0.0.1
ip: 10.0.0.10
netmask: 255.255.255.0
type: static
org_id: 11b08247-b1ee-4152-9b25-312b323ce480
port_stat:
port0:
full_duplex: true
mac: 9e294e49091d
rx_bytes: 646898375700
rx_errors: 0
rx_pkts: 8784449574
speed: 10000
state: forwarding
tx_bytes: 647200748038
tx_errors: 0
tx_pkts: 8788647466
up: true
port1:
full_duplex: true
mac: a270fe53437e
rx_bytes: 647200437652
rx_errors: 0
rx_pkts: 8788644886
speed: 10000
state: forwarding
tx_bytes: 646898681650
tx_errors: 0
tx_pkts: 8784452092
up: true
serial: string
service_stat:
mxagent:
ext_ip: 99.0.86.164
last_seen: 1633721215
package_state: Installed
package_version: 3.1.1037-1
running_state: Running
uptime: 21240
tunterm:
ext_ip: 99.0.86.164
last_seen: 1633721203
package_state: Installed
package_version: 0.1.2449+deb10
running_state: Running
uptime: 76261
services:
- tunterm
site_id: 00000000-0000-0000-0000-000000000000
status: connected
tunterm_ip_config:
gateway: 192.168.11.1
ip: 192.168.11.91
netmask: 255.255.255.0
tunterm_port_config:
downstream_ports:
- '0'
- '1'
separate_upstream_downstream: false
upstream_ports:
- '0'
- '1'
tunterm_registered: true
tunterm_stat:
monitoring_failed: false
uptime: 76281
virtualization_type: KVM
contentMediaType: application/json
examples:
Example:
value:
cpu_stat:
cpus:
cpu0:
idle: 89
interrupt: 0
system: 8
usage: 10
user: 1
cpu1:
idle: 81
interrupt: 0
system: 4
usage: 18
user: 13
cpu2:
idle: 81
interrupt: 0
system: 4
usage: 18
user: 13
cpu3:
idle: 2
interrupt: 0
system: 50
usage: 97
user: 46
idle: 62
interrupt: 0
system: 17
usage: 37
user: 19
created_time: 1632684398
for_site: false
id: 00000000-0000-0000-1000-020000a80cb4
inactive_vlan_strs:
wired:
- '100'
- 102-106
ip_stat:
ip: 192.168.1.244
ips:
ens18: 192.168.1.244/24,fe80::104c:ffff:fee0:caf8/64
macs:
ens18: e4434b217044
lag_stat:
lacp0:
active_ports:
- port0
- port1
last_seen: 1633721215
mac: 020000a80cb4
memory_stat:
active: 394936320
available: 4699291648
buffers: 107646976
cached: 478060544
free: 4330659840
inactive: 211980288
swap_cached: 0
swap_free: 1022357504
swap_total: 1022357504
total: 8365957120
usage: 48
model: ME-VM
modified_time: 1633643629
mxagent_registered: true
mxcluster_id: 678bc339-7635-4556-bbc0-e77ad493ef8b
name: me-vm-1
num_tunnels: 0
oob_ip_config:
dns:
- 8.8.8.8
- 1.1.1.1
gateway: 10.0.0.1
ip: 10.0.0.10
netmask: 255.255.255.0
type: static
org_id: 11b08247-b1ee-4152-9b25-312b323ce480
port_stat:
port0:
full_duplex: true
mac: 9e294e49091d
rx_bytes: 646898375700
rx_errors: 0
rx_pkts: 8784449574
speed: 10000
state: forwarding
tx_bytes: 647200748038
tx_errors: 0
tx_pkts: 8788647466
up: true
port1:
full_duplex: true
mac: a270fe53437e
rx_bytes: 647200437652
rx_errors: 0
rx_pkts: 8788644886
speed: 10000
state: forwarding
tx_bytes: 646898681650
tx_errors: 0
tx_pkts: 8784452092
up: true
serial: string
service_stat:
mxagent:
ext_ip: 99.0.86.164
last_seen: 1633721215
package_state: Installed
package_version: 3.1.1037-1
running_state: Running
uptime: 21240
tunterm:
ext_ip: 99.0.86.164
last_seen: 1633721203
package_state: Installed
package_version: 0.1.2449+deb10
running_state: Running
uptime: 76261
services:
- tunterm
site_id: 00000000-0000-0000-0000-000000000000
status: connected
tunterm_ip_config:
gateway: 192.168.11.1
ip: 192.168.11.91
netmask: 255.255.255.0
tunterm_port_config:
downstream_ports:
- '0'
- '1'
separate_upstream_downstream: false
upstream_ports:
- '0'
- '1'
tunterm_registered: true
tunterm_stat:
monitoring_failed: false
uptime: 76281
virtualization_type: KVM
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/stats_mxedge'
- description: Statistics for a Mist Edge appliance returned by stats endpoints
examples:
- cpu_stat:
cpus:
cpu0:
idle: 89
interrupt: 0
system: 8
usage: 10
user: 1
cpu1:
idle: 81
interrupt: 0
system: 4
usage: 18
user: 13
cpu2:
idle: 81
interrupt: 0
system: 4
usage: 18
user: 13
cpu3:
idle: 2
interrupt: 0
system: 50
usage: 97
user: 46
idle: 62
interrupt: 0
system: 17
usage: 37
user: 19
created_time: 1632684398
for_site: false
id: 00000000-0000-0000-1000-020000a80cb4
inactive_vlan_strs:
wired:
- '100'
- 102-106
ip_stat:
ip: 192.168.1.244
ips:
ens18: 192.168.1.244/24,fe80::104c:ffff:fee0:caf8/64
macs:
ens18: e4434b217044
lag_stat:
lacp0:
active_ports:
- port0
- port1
last_seen: 1633721215
mac: 020000a80cb4
memory_stat:
active: 394936320
available: 4699291648
buffers: 107646976
cached: 478060544
free: 4330659840
inactive: 211980288
swap_cached: 0
swap_free: 1022357504
swap_total: 1022357504
total: 8365957120
usage: 48
model: ME-VM
modified_time: 1633643629
mxagent_registered: true
mxcluster_id: 678bc339-7635-4556-bbc0-e77ad493ef8b
name: me-vm-1
num_tunnels: 0
oob_ip_config:
dns:
- 8.8.8.8
- 1.1.1.1
gateway: 10.0.0.1
ip: 10.0.0.10
netmask: 255.255.255.0
type: static
org_id: 11b08247-b1ee-4152-9b25-312b323ce480
port_stat:
port0:
full_duplex: true
mac: 9e294e49091d
rx_bytes: 646898375700
rx_errors: 0
rx_pkts: 8784449574
speed: 10000
state: forwarding
tx_bytes: 647200748038
tx_errors: 0
tx_pkts: 8788647466
up: true
port1:
full_duplex: true
mac: a270fe53437e
rx_bytes: 647200437652
rx_errors: 0
rx_pkts: 8788644886
speed: 10000
state: forwarding
tx_bytes: 646898681650
tx_errors: 0
tx_pkts: 8784452092
up: true
serial: string
service_stat:
mxagent:
ext_ip: 99.0.86.164
last_seen: 1633721215
package_state: Installed
package_version: 3.1.1037-1
running_state: Running
uptime: 21240
tunterm:
ext_ip: 99.0.86.164
last_seen: 1633721203
package_state: Installed
package_version: 0.1.2449+deb10
running_state: Running
uptime: 76261
services:
- tunterm
site_id: 00000000-0000-0000-0000-000000000000
status: connected
tunterm_ip_config:
gateway: 192.168.11.1
ip: 192.168.11.91
netmask: 255.255.255.0
tunterm_port_config:
downstream_ports:
- '0'
- '1'
separate_upstream_downstream: false
upstream_ports:
- '0'
- '1'
tunterm_registered: true
tunterm_stat:
monitoring_failed: false
uptime: 76281
virtualization_type: KVM
contentMediaType: application/vnd.api+json
examples:
Example:
value:
cpu_stat:
cpus:
cpu0:
idle: 89
interrupt: 0
system: 8
usage: 10
user: 1
cpu1:
idle: 81
interrupt: 0
system: 4
usage: 18
user: 13
cpu2:
idle: 81
interrupt: 0
system: 4
usage: 18
user: 13
cpu3:
idle: 2
interrupt: 0
system: 50
usage: 97
user: 46
idle: 62
interrupt: 0
system: 17
usage: 37
user: 19
created_time: 1632684398
for_site: false
id: 00000000-0000-0000-1000-020000a80cb4
inactive_vlan_strs:
wired:
- '100'
- 102-106
ip_stat:
ip: 192.168.1.244
ips:
ens18: 192.168.1.244/24,fe80::104c:ffff:fee0:caf8/64
macs:
ens18: e4434b217044
lag_stat:
lacp0:
active_ports:
- port0
- port1
last_seen: 1633721215
mac: 020000a80cb4
memory_stat:
active: 394936320
available: 4699291648
buffers: 107646976
cached: 478060544
free: 4330659840
inactive: 211980288
swap_cached: 0
swap_free: 1022357504
swap_total: 1022357504
total: 8365957120
usage: 48
model: ME-VM
modified_time: 1633643629
mxagent_registered: true
mxcluster_id: 678bc339-7635-4556-bbc0-e77ad493ef8b
name: me-vm-1
num_tunnels: 0
oob_ip_config:
dns:
- 8.8.8.8
- 1.1.1.1
gateway: 10.0.0.1
ip: 10.0.0.10
netmask: 255.255.255.0
type: static
org_id: 11b08247-b1ee-4152-9b25-312b323ce480
port_stat:
port0:
full_duplex: true
mac: 9e294e49091d
rx_bytes: 646898375700
rx_errors: 0
rx_pkts: 8784449574
speed: 10000
state: forwarding
tx_bytes: 647200748038
tx_errors: 0
tx_pkts: 8788647466
up: true
port1:
full_duplex: true
mac: a270fe53437e
rx_bytes: 647200437652
rx_errors: 0
rx_pkts: 8788644886
speed: 10000
state: forwarding
tx_bytes: 646898681650
tx_errors: 0
tx_pkts: 8784452092
up: true
serial: string
service_stat:
mxagent:
ext_ip: 99.0.86.164
last_seen: 1633721215
package_state: Installed
package_version: 3.1.1037-1
running_state: Running
uptime: 21240
tunterm:
ext_ip: 99.0.86.164
last_seen: 1633721203
package_state: Installed
package_version: 0.1.2449+deb10
running_state: Running
uptime: 76261
services:
- tunterm
site_id: 00000000-0000-0000-0000-000000000000
status: connected
tunterm_ip_config:
gateway: 192.168.11.1
ip: 192.168.11.91
netmask: 255.255.255.0
tunterm_port_config:
downstream_ports:
- '0'
- '1'
separate_upstream_downstream: false
upstream_ports:
- '0'
- '1'
tunterm_registered: true
tunterm_stat:
monitoring_failed: false
uptime: 76281
virtualization_type: KVM
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/stats/ospf_peers/count:
get:
tags:
- Orgs Stats - Ospf
summary: countOrgOspfStats
description: Count OSPF peer stats by distinct attribute name
operationId: countOrgOspfStats
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field used to group this count response. enum: `site_id`, `org_id`, `mac`, `peer_ip`, `port_id`, `state`, `vrf_name`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/ospf_peer_stats_count_distinct'
- description: 'Field used to group this count response. enum: `site_id`, `org_id`, `mac`, `peer_ip`, `port_id`, `state`, `vrf_name`'
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/stats/ospf_peers/search:
get:
tags:
- Orgs Stats - Ospf
summary: searchOrgOspfStats
description: Search OSPF Neighbor Stats
operationId: searchOrgOspfStats
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: site_id
in: query
description: Filter results by site identifier
style: form
explode: true
schema:
type: string
- name: mac
in: query
description: Filter results by MAC address
style: form
explode: true
schema:
type: string
- name: vrf_name
in: query
description: Filter peer results by VRF name
style: form
explode: true
schema:
type: string
- name: peer_ip
in: query
description: Filter peer results by peer IP address
style: form
explode: true
schema:
type: string
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ospf_peer_stats_search_result'
- description: Paginated OSPF peer statistics search result
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/ospf_peer_stats_search_result'
- description: Paginated OSPF peer statistics search result
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/stats/otherdevices/{device_mac}:
get:
tags:
- Orgs Stats - Other Devices
summary: getOrgOtherDeviceStats
description: Get Otherdevice Stats
operationId: getOrgOtherDeviceStats
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_mac
in: path
description: ''
required: true
schema:
pattern: ^[0-9a-fA-F]{12}$
type: string
examples:
- 0000000000ab
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/stats_device_other'
- description: Statistics for a third-party or other device tracked by Mist
examples:
- cached_stats: true
connected_devices:
0200010edbca:
mac: 020001abcdef
name: DNT-NTR-GWE
port_id: ge-0/0/1
type: gateway
last_seen: 1740996902
lldp_enabled: true
mac: 00304498a1e8
uptime: 622828
vendor: cradlepoint
vendor_specific:
interfaces:
ethernet-IPPT:
bytes_in: 331068567
bytes_out: 6763536255
display_name: Primary LAN
ip: 192.168.0.1
link: true
mode: lan
port_parent: Primary LAN
service_mode: Ethernet
type: ethernet
uptime: 0
ethernet-lan:
bytes_in: 13072566048
bytes_out: 5617915438
display_name: Secondary LAN
ip: 192.168.0.1
link: false
mode: lan
port_parent: Secondary LAN
service_mode: Ethernet
type: ethernet
uptime: 0
mdm-8a1084c9:
bytes_in: 0
bytes_out: 0
carrier: Unknown Service
imei: '866401234567894'
imsi: ''
ip: ''
link: false
mode: wan
mtu: 1400
rsrp: 0
rsrq: 0
rssi: 0
service_mode: Not Available
sinr: 0
state: NOSIM
type: mdm
uptime: 0
mdm-8a1fc70c:
bytes_in: 5623096929
bytes_out: 12372750366
carrier: AT&T
imei: '866401234567893'
imsi: '208001234567893'
ip: 12.68.86.17
link: true
mode: wan
mtu: 1400
rsrp: -108
rsrq: -14
rssi: -74
service_mode: 5G NSA
sinr: -1.2
state: READY
type: mdm
uptime: 2095779
version: 7.24.80
contentMediaType: application/json
examples:
Otherdevice Stats:
value:
cached_stats: true
connected_devices:
0200010edbca:
mac: 020001abcdef
name: DNT-NTR-GWE
port_id: ge-0/0/1
type: gateway
last_seen: 1740996902
lldp_enabled: true
mac: 00304498a1e8
uptime: 622828
vendor: cradlepoint
vendor_specific:
interfaces:
ethernet-IPPT:
bytes_in: 331068567
bytes_out: 6763536255
display_name: Primary LAN
ip: 192.168.0.1
link: true
mode: lan
port_parent: Primary LAN
service_mode: Ethernet
type: ethernet
uptime: 0
ethernet-lan:
bytes_in: 13072566048
bytes_out: 5617915438
display_name: Secondary LAN
ip: 192.168.0.1
link: false
mode: lan
port_parent: Secondary LAN
service_mode: Ethernet
type: ethernet
uptime: 0
mdm-8a1084c9:
bytes_in: 0
bytes_out: 0
carrier: Unknown Service
imei: '866401234567894'
imsi: ''
ip: ''
link: false
mode: wan
mtu: 1400
rsrp: 0
rsrq: 0
rssi: 0
service_mode: Not Available
sinr: 0
state: NOSIM
type: mdm
uptime: 0
mdm-8a1fc70c:
bytes_in: 5623096929
bytes_out: 12372750366
carrier: AT&T
imei: '866401234567893'
imsi: '208001234567893'
ip: 12.68.86.17
link: true
mode: wan
mtu: 1400
rsrp: -108
rsrq: -14
rssi: -74
service_mode: 5G NSA
sinr: -1.2
state: READY
type: mdm
uptime: 2095779
version: 7.24.80
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/stats_device_other'
- description: Statistics for a third-party or other device tracked by Mist
examples:
- cached_stats: true
connected_devices:
0200010edbca:
mac: 020001abcdef
name: DNT-NTR-GWE
port_id: ge-0/0/1
type: gateway
last_seen: 1740996902
lldp_enabled: true
mac: 00304498a1e8
uptime: 622828
vendor: cradlepoint
vendor_specific:
interfaces:
ethernet-IPPT:
bytes_in: 331068567
bytes_out: 6763536255
display_name: Primary LAN
ip: 192.168.0.1
link: true
mode: lan
port_parent: Primary LAN
service_mode: Ethernet
type: ethernet
uptime: 0
ethernet-lan:
bytes_in: 13072566048
bytes_out: 5617915438
display_name: Secondary LAN
ip: 192.168.0.1
link: false
mode: lan
port_parent: Secondary LAN
service_mode: Ethernet
type: ethernet
uptime: 0
mdm-8a1084c9:
bytes_in: 0
bytes_out: 0
carrier: Unknown Service
imei: '866401234567894'
imsi: ''
ip: ''
link: false
mode: wan
mtu: 1400
rsrp: 0
rsrq: 0
rssi: 0
service_mode: Not Available
sinr: 0
state: NOSIM
type: mdm
uptime: 0
mdm-8a1fc70c:
bytes_in: 5623096929
bytes_out: 12372750366
carrier: AT&T
imei: '866401234567893'
imsi: '208001234567893'
ip: 12.68.86.17
link: true
mode: wan
mtu: 1400
rsrp: -108
rsrq: -14
rssi: -74
service_mode: 5G NSA
sinr: -1.2
state: READY
type: mdm
uptime: 2095779
version: 7.24.80
contentMediaType: application/vnd.api+json
examples:
Otherdevice Stats:
value:
cached_stats: true
connected_devices:
0200010edbca:
mac: 020001abcdef
name: DNT-NTR-GWE
port_id: ge-0/0/1
type: gateway
last_seen: 1740996902
lldp_enabled: true
mac: 00304498a1e8
uptime: 622828
vendor: cradlepoint
vendor_specific:
interfaces:
ethernet-IPPT:
bytes_in: 331068567
bytes_out: 6763536255
display_name: Primary LAN
ip: 192.168.0.1
link: true
mode: lan
port_parent: Primary LAN
service_mode: Ethernet
type: ethernet
uptime: 0
ethernet-lan:
bytes_in: 13072566048
bytes_out: 5617915438
display_name: Secondary LAN
ip: 192.168.0.1
link: false
mode: lan
port_parent: Secondary LAN
service_mode: Ethernet
type: ethernet
uptime: 0
mdm-8a1084c9:
bytes_in: 0
bytes_out: 0
carrier: Unknown Service
imei: '866401234567894'
imsi: ''
ip: ''
link: false
mode: wan
mtu: 1400
rsrp: 0
rsrq: 0
rssi: 0
service_mode: Not Available
sinr: 0
state: NOSIM
type: mdm
uptime: 0
mdm-8a1fc70c:
bytes_in: 5623096929
bytes_out: 12372750366
carrier: AT&T
imei: '866401234567893'
imsi: '208001234567893'
ip: 12.68.86.17
link: true
mode: wan
mtu: 1400
rsrp: -108
rsrq: -14
rssi: -74
service_mode: 5G NSA
sinr: -1.2
state: READY
type: mdm
uptime: 2095779
version: 7.24.80
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/stats/ports/count:
get:
tags:
- Orgs Stats - Ports
summary: countOrgSwOrGwPorts
description: Count by Distinct Attributes of Switch/Gateway Ports at the Org level
operationId: countOrgSwOrGwPorts
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field used to group this count response. enum: `full_duplex`, `mac`, `neighbor_mac`, `neighbor_port_desc`, `neighbor_system_name`, `poe_disabled`, `poe_mode`, `poe_on`, `port_id`, `port_mac`, `speed`, `up`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/site_ports_count_distinct'
- description: 'Field used to group this count response. enum: `full_duplex`, `mac`, `neighbor_mac`, `neighbor_port_desc`, `neighbor_system_name`, `poe_disabled`, `poe_mode`, `poe_on`, `port_id`, `port_mac`, `speed`, `up`'
- name: full_duplex
in: query
description: Indicates full or half duplex
style: form
explode: true
schema:
type: boolean
examples:
- true
- name: mac
in: query
description: Filter results by MAC address. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- 5c5b53010101,5c5b53020202
- 5c5b350e0410
examples:
Untitled Example1:
value: 5c5b53010101,5c5b53020202
Untitled Example2:
value: 5c5b350e0410
- name: neighbor_mac
in: query
description: Chassis identifier of the chassis type listed
style: form
explode: true
schema:
type: string
examples:
- 5c5b350e0410
- name: neighbor_port_desc
in: query
description: Description supplied by the system on the interface E.g. "GigabitEthernet2/0/39"
style: form
explode: true
schema:
type: string
examples:
- ge-2/0/39
- name: neighbor_system_name
in: query
description: Name supplied by the system on the interface E.g. neighbor system name E.g. "Kumar-Acc-SW.mist.local"
style: form
explode: true
schema:
type: string
examples:
- Kumar-Acc-SW.mist.local
- name: poe_disabled
in: query
description: Is the POE configured not be disabled.
style: form
explode: true
schema:
type: boolean
examples:
- false
- name: poe_mode
in: query
description: POE mode depending on class E.g. "802.3at"
style: form
explode: true
schema:
type: string
examples:
- 802.3at
- name: poe_on
in: query
description: Is the device attached to POE
style: form
explode: true
schema:
type: boolean
examples:
- true
- name: port_id
in: query
description: Filter results by port identifier
style: form
explode: true
schema:
type: string
examples:
- ge-2/0/39
- name: port_mac
in: query
description: Filter results by port MAC address
style: form
explode: true
schema:
type: string
examples:
- 5c5b350e0410
- name: power_draw
in: query
description: Amount of power being used by the interface at the time the command is executed. Unit in watts.
style: form
explode: true
schema:
type: number
contentEncoding: double
examples:
- 15.4
- name: tx_pkts
in: query
description: Filter results by transmitted packet count
style: form
explode: true
schema:
type: integer
contentEncoding: int32
examples:
- 1000000
- name: rx_pkts
in: query
description: Filter results by received packet count
style: form
explode: true
schema:
type: integer
contentEncoding: int32
examples:
- 1000000
- name: rx_bytes
in: query
description: Filter results by received byte count
style: form
explode: true
schema:
type: integer
contentEncoding: int32
examples:
- 1000000
- name: tx_bps
in: query
description: Filter results by transmit rate
style: form
explode: true
schema:
type: integer
contentEncoding: int32
examples:
- 1000000
- name: rx_bps
in: query
description: Filter results by receive rate
style: form
explode: true
schema:
type: integer
contentEncoding: int32
examples:
- 1000000
- name: tx_mcast_pkts
in: query
description: Filter results by transmitted multicast packet count
style: form
explode: true
schema:
type: integer
contentEncoding: int32
examples:
- 1000000
- name: tx_bcast_pkts
in: query
description: Filter results by transmitted broadcast packet count
style: form
explode: true
schema:
type: integer
contentEncoding: int32
examples:
- 1000000
- name: rx_mcast_pkts
in: query
description: Filter results by received multicast packet count
style: form
explode: true
schema:
type: integer
contentEncoding: int32
examples:
- 1000000
- name: rx_bcast_pkts
in: query
description: Filter results by received broadcast packet count
style: form
explode: true
schema:
type: integer
contentEncoding: int32
examples:
- 1000000
- name: speed
in: query
description: Filter results by port speed
style: form
explode: true
schema:
type: integer
contentEncoding: int32
examples:
- 1000000000
- name: stp_state
in: query
description: 'STP state used to filter port results when `up`==`true`. enum: `""`, `blocking`, `disabled`, `forwarding`, `learning`, `listening`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/port_stp_state'
- description: 'STP state used to filter port results when `up`==`true`. enum: `""`, `blocking`, `disabled`, `forwarding`, `learning`, `listening`'
- name: stp_role
in: query
description: 'STP role used to filter port results when `up`==`true`. enum: `""`, `alternate`, `backup`, `designated`, `disabled`, `root`, `root-prevented`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/port_stp_role'
- description: 'STP role used to filter port results when `up`==`true`. enum: `""`, `alternate`, `backup`, `designated`, `disabled`, `root`, `root-prevented`'
- name: auth_state
in: query
description: 'Authentication state used to filter port results when `up`==`true` and the port has an authenticator role. enum: `""`, `authenticated`, `authenticating`, `held`, `init`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/port_auth_state'
- description: 'Authentication state used to filter port results when `up`==`true` and the port has an authenticator role. enum: `""`, `authenticated`, `authenticating`, `held`, `init`'
- name: up
in: query
description: Indicates if interface is up
style: form
explode: true
schema:
type: boolean
examples:
- true
- name: site_id
in: query
description: Filter results by site identifier
style: form
explode: true
schema:
type: string
contentEncoding: uuid
examples:
- 72771e6a-6f5e-4de4-a5b9-1266c4197811
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/stats/ports/search:
get:
tags:
- Orgs Stats - Ports
summary: searchOrgSwOrGwPorts
description: >-
Search Switch / Gateway Ports Stats.
Returns a list of switch/gateway ports stats that match the search criteria.
The response provide current/last port status and statistics within the hour.
Traffic information (Tx/Rx) are cumulative counters since the last device reboot.
operationId: searchOrgSwOrGwPorts
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_type
in: query
description: 'Type of device. enum: `switch`, `gateway`, `all`. Accepts multiple comma-separated values.'
style: form
explode: true
schema:
type: string
examples:
- gateway,switch
- name: auth_state
in: query
description: 'Authentication state used to filter port results when `up`==`true` and the port has an authenticator role. enum: `""`, `authenticated`, `authenticating`, `held`, `init`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/port_auth_state'
- description: 'Authentication state used to filter port results when `up`==`true` and the port has an authenticator role. enum: `""`, `authenticated`, `authenticating`, `held`, `init`'
- name: full_duplex
in: query
description: Indicates full or half duplex
style: form
explode: true
schema:
type: boolean
- name: lte_imsi
in: query
description: LTE IMSI value, Check for null/empty
style: form
explode: true
schema:
type: string
examples:
- '310260000000001'
- name: lte_iccid
in: query
description: LTE ICCID value, Check for null/empty
style: form
explode: true
schema:
type: string
examples:
- '89014103211118510720'
- name: lte_imei
in: query
description: LTE IMEI value, Check for null/empty
style: form
explode: true
schema:
type: string
examples:
- '123456789012345'
- name: mac
in: query
description: Filter results by MAC address. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- 5c5b53010101,5c5b53020202
- name: neighbor_mac
in: query
description: Chassis identifier of the chassis type listed. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- 5c5b53010101,5c5b53020202
- name: neighbor_port_desc
in: query
description: Description supplied by the system on the interface E.g. "GigabitEthernet2/0/39". Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- ge-0-2,ge-0-1
- name: neighbor_system_name
in: query
description: Name supplied by the system on the interface E.g. neighbor system name E.g. "Kumar-Acc-SW.mist.local". Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- sdwan-newyork,toronto-srx-2_node1
- name: poe_disabled
in: query
description: Is the POE configured not be disabled.
style: form
explode: true
schema:
type: boolean
- name: poe_mode
in: query
description: POE mode depending on class E.g. "802.3at"
style: form
explode: true
schema:
type: string
- name: poe_on
in: query
description: Is the device attached to POE
style: form
explode: true
schema:
type: boolean
- name: poe_priority
in: query
description: 'PoE priority used to filter switch port results. enum: `low`, `high`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/poe_priority'
- description: 'PoE priority used to filter switch port results. enum: `low`, `high`'
- name: port_id
in: query
description: Filter results by port identifier. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- ge-0/0/1,ge-0/0/2
- name: port_mac
in: query
description: Filter results by port MAC address. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- 5c5b53010101,5c5b53020202
- name: speed
in: query
description: Filter results by port speed
style: form
explode: true
schema:
type: integer
contentEncoding: int32
- name: stp_state
in: query
description: 'STP state used to filter port results when `up`==`true`. enum: `""`, `blocking`, `disabled`, `forwarding`, `learning`, `listening`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/port_stp_state'
- description: 'STP state used to filter port results when `up`==`true`. enum: `""`, `blocking`, `disabled`, `forwarding`, `learning`, `listening`'
- name: stp_role
in: query
description: 'STP role used to filter port results when `up`==`true`. enum: `""`, `alternate`, `backup`, `designated`, `disabled`, `root`, `root-prevented`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/port_stp_role'
- description: 'STP role used to filter port results when `up`==`true`. enum: `""`, `alternate`, `backup`, `designated`, `disabled`, `root`, `root-prevented`'
- name: up
in: query
description: Indicates if interface is up
style: form
explode: true
schema:
type: boolean
- name: xcvr_part_number
in: query
description: Optic Slot Partnumber, Check for null/empty
style: form
explode: true
schema:
type: string
examples:
- SFP-10G-SR
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_port_stats_search'
- description: Paginated response for switch and gateway port statistics search results
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_port_stats_search'
- description: Paginated response for switch and gateway port statistics search results
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/stats/sites:
get:
tags:
- Orgs Stats - Sites
summary: listOrgSiteStats
description: Get List of Org Site Stats
operationId: listOrgSiteStats
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/stats_site'
description: Site statistics records returned by a stats response
examples:
- - address: 1601 S De Anza Blvd, Cupertino, CA 95014, USA
alarmtemplate_id: null
analyticEnabled: true
aptemplate_id: null
country_code: US
created_time: 1472591606
engagementEnabled: true
gatewaytemplate_id: e571f2a2-d748-4ad4-bd6c-895467957c21
id: 83bc290a-b76d-47fa-a294-d34e47f30f7f
lat: 37.295553
latlng:
lat: 37.295553
lng: -122.033007
lng: -122.033007
modified_time: 1728057857
msp_id: a9af4951-a1de-4520-b398-c95a58947349
name: Live-Demo
networktemplate_id: 964cb213-deb2-469d-8c1e-a5f8661c6886
notes: This site is used for demonstration purposes.
num_ap: 17
num_ap_connected: 14
num_clients: 14
num_devices: 26
num_devices_connected: 22
num_gateway: 1
num_gateway_connected: 1
num_switch: 8
num_switch_connected: 7
org_id: b9814b40-ac4b-4424-86a8-b787eb68b86a
rftemplate_id: 2c134c07-3c57-46b3-a53b-8aea92ed7234
secpolicy_id: null
sitegroup_ids:
- 5644a432-eea9-4a2f-a30a-ddaf4dbc79cf
- 5fc0f305-f626-49db-8869-10b87f201bba
- 882796ef-190b-405e-98ef-cb487140cf64
sitetemplate_id: null
timezone: America/Los_Angeles
tzoffset: 960
contentMediaType: application/json
examples:
Example:
value:
- address: 1601 S De Anza Blvd, Cupertino, CA 95014, USA
alarmtemplate_id: null
analyticEnabled: true
aptemplate_id: null
country_code: US
created_time: 1472591606
engagementEnabled: true
gatewaytemplate_id: e571f2a2-d748-4ad4-bd6c-895467957c21
id: 83bc290a-b76d-47fa-a294-d34e47f30f7f
lat: 37.295553
latlng:
lat: 37.295553
lng: -122.033007
lng: -122.033007
modified_time: 1728057857
msp_id: a9af4951-a1de-4520-b398-c95a58947349
name: Live-Demo
networktemplate_id: 964cb213-deb2-469d-8c1e-a5f8661c6886
notes: This site is used for demonstration purposes.
num_ap: 17
num_ap_connected: 14
num_clients: 14
num_devices: 26
num_devices_connected: 22
num_gateway: 1
num_gateway_connected: 1
num_switch: 8
num_switch_connected: 7
org_id: b9814b40-ac4b-4424-86a8-b787eb68b86a
rftemplate_id: 2c134c07-3c57-46b3-a53b-8aea92ed7234
secpolicy_id: null
sitegroup_ids:
- 5644a432-eea9-4a2f-a30a-ddaf4dbc79cf
- 5fc0f305-f626-49db-8869-10b87f201bba
- 882796ef-190b-405e-98ef-cb487140cf64
sitetemplate_id: null
timezone: America/Los_Angeles
tzoffset: 960
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/stats_site'
description: Site statistics records returned by a stats response
examples:
- - address: 1601 S De Anza Blvd, Cupertino, CA 95014, USA
alarmtemplate_id: null
analyticEnabled: true
aptemplate_id: null
country_code: US
created_time: 1472591606
engagementEnabled: true
gatewaytemplate_id: e571f2a2-d748-4ad4-bd6c-895467957c21
id: 83bc290a-b76d-47fa-a294-d34e47f30f7f
lat: 37.295553
latlng:
lat: 37.295553
lng: -122.033007
lng: -122.033007
modified_time: 1728057857
msp_id: a9af4951-a1de-4520-b398-c95a58947349
name: Live-Demo
networktemplate_id: 964cb213-deb2-469d-8c1e-a5f8661c6886
notes: This site is used for demonstration purposes.
num_ap: 17
num_ap_connected: 14
num_clients: 14
num_devices: 26
num_devices_connected: 22
num_gateway: 1
num_gateway_connected: 1
num_switch: 8
num_switch_connected: 7
org_id: b9814b40-ac4b-4424-86a8-b787eb68b86a
rftemplate_id: 2c134c07-3c57-46b3-a53b-8aea92ed7234
secpolicy_id: null
sitegroup_ids:
- 5644a432-eea9-4a2f-a30a-ddaf4dbc79cf
- 5fc0f305-f626-49db-8869-10b87f201bba
- 882796ef-190b-405e-98ef-cb487140cf64
sitetemplate_id: null
timezone: America/Los_Angeles
tzoffset: 960
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- address: 1601 S De Anza Blvd, Cupertino, CA 95014, USA
alarmtemplate_id: null
analyticEnabled: true
aptemplate_id: null
country_code: US
created_time: 1472591606
engagementEnabled: true
gatewaytemplate_id: e571f2a2-d748-4ad4-bd6c-895467957c21
id: 83bc290a-b76d-47fa-a294-d34e47f30f7f
lat: 37.295553
latlng:
lat: 37.295553
lng: -122.033007
lng: -122.033007
modified_time: 1728057857
msp_id: a9af4951-a1de-4520-b398-c95a58947349
name: Live-Demo
networktemplate_id: 964cb213-deb2-469d-8c1e-a5f8661c6886
notes: This site is used for demonstration purposes.
num_ap: 17
num_ap_connected: 14
num_clients: 14
num_devices: 26
num_devices_connected: 22
num_gateway: 1
num_gateway_connected: 1
num_switch: 8
num_switch_connected: 7
org_id: b9814b40-ac4b-4424-86a8-b787eb68b86a
rftemplate_id: 2c134c07-3c57-46b3-a53b-8aea92ed7234
secpolicy_id: null
sitegroup_ids:
- 5644a432-eea9-4a2f-a30a-ddaf4dbc79cf
- 5fc0f305-f626-49db-8869-10b87f201bba
- 882796ef-190b-405e-98ef-cb487140cf64
sitetemplate_id: null
timezone: America/Los_Angeles
tzoffset: 960
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/stats/tunnels/count:
get:
tags:
- Orgs Stats - Tunnels
summary: countOrgTunnelsStats
description: Count by Distinct Attributes of Mist Tunnels Stats
operationId: countOrgTunnelsStats
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field used to group tunnel statistics count results. enum: `ap`, `auth_algo`, `encrypt_algo`, `ike_version`, `ip`, `last_event`, `mac`, `mxcluster_id`, `mxedge_id`, `node`, `peer_host`, `peer_ip`, `peer_mxedge_id`, `protocol`, `remote_ip`, `remote_port`, `site_id`, `state`, `tunnel_name`, `up`, `wxtunnel_id`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/org_tunnel_count_distinct'
- description: 'Field used to group tunnel statistics count results. enum: `ap`, `auth_algo`, `encrypt_algo`, `ike_version`, `ip`, `last_event`, `mac`, `mxcluster_id`, `mxedge_id`, `node`, `peer_host`, `peer_ip`, `peer_mxedge_id`, `protocol`, `remote_ip`, `remote_port`, `site_id`, `state`, `tunnel_name`, `up`, `wxtunnel_id`'
- name: type
in: query
description: 'Filter results by type. enum: `wan`, `wxtunnel`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/org_tunnel_type_count'
- description: 'Filter results by type. enum: `wan`, `wxtunnel`'
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/stats/tunnels/search:
get:
tags:
- Orgs Stats - Tunnels
summary: searchOrgTunnelsStats
description: >
By default the endpoint returns only `wxtunnel` type stats, to get `wan` type stats
you need to specify `type=wan` in the query parameters.
Tunnel types:
- `wxtunnel` (default) - A WxLan Tunnel (WxTunnel) are used to create a secure connection between Juniper Mist Access Points and third-party VPN concentrators using protocols such as L2TPv3 or dmvpn.
- `wan` - A WAN Tunnel is a secure connection between two Gateways, typically used for site-to-site or mesh connectivity. It can be configured with various protocols and encryption methods.
If `type` is not specified or `type`==`wxtunnel`, the following parameters are supported:
- `mxcluster_id` - the MX cluster ID
- `site_id` - the site ID
- `wxtunnel_id` - the WX tunnel ID
- `ap` - the AP MAC address
If `type`==`wan`, the following parameters are supported:
- `mac` - the MAC address of the WAN device
- `node` - the node ID
- `peer_ip` - the peer IP address
- `peer_host` - the peer host name
- `ip` - the IP address of the WAN device
- `tunnel_name` - the name of the tunnel
- `protocol` - the protocol used for the tunnel
- `auth_algo` - the authentication algorithm used for the tunnel
- `encrypt_algo` - the encryption algorithm used for the tunnel
- `ike_version` - the IKE version used for the tunnel
- `up` - the status of the tunnel (up or down)
operationId: searchOrgTunnelsStats
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: mxcluster_id
in: query
description: Filter results by mxcluster id when `type`==`wxtunnel`
style: form
explode: true
schema:
type: string
- name: site_id
in: query
description: Filter results by site identifier
style: form
explode: true
schema:
type: string
- name: wxtunnel_id
in: query
description: Filter results by wxtunnel id when `type`==`wxtunnel`
style: form
explode: true
schema:
type: string
- name: ap
in: query
description: Filter results by AP MAC address when `type`==`wxtunnel`
style: form
explode: true
schema:
type: string
- name: mac
in: query
description: Filter results by MAC address when `type`==`wan`
style: form
explode: true
schema:
type: string
- name: node
in: query
description: Filter results by node when `type`==`wan`
style: form
explode: true
schema:
type: string
- name: peer_ip
in: query
description: Filter results by peer ip when `type`==`wan`
style: form
explode: true
schema:
type: string
- name: peer_host
in: query
description: Filter results by peer host when `type`==`wan`
style: form
explode: true
schema:
type: string
- name: ip
in: query
description: Filter results by IP address when `type`==`wan`
style: form
explode: true
schema:
type: string
- name: tunnel_name
in: query
description: Filter results by tunnel name when `type`==`wan`
style: form
explode: true
schema:
type: string
- name: protocol
in: query
description: Filter results by protocol when `type`==`wan`
style: form
explode: true
schema:
type: string
- name: auth_algo
in: query
description: Filter results by auth algo when `type`==`wan`
style: form
explode: true
schema:
type: string
- name: encrypt_algo
in: query
description: Filter results by encrypt algo when `type`==`wan`
style: form
explode: true
schema:
type: string
- name: ike_version
in: query
description: Filter results by ike version when `type`==`wan`
style: form
explode: true
schema:
type: string
- name: up
in: query
description: Filter results by up when `type`==`wan`
style: form
explode: true
schema:
type: string
- name: type
in: query
description: 'Filter results by type. enum: `wan`, `wxtunnel`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/tunnel_type'
- description: 'Filter results by type. enum: `wan`, `wxtunnel`'
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 5m
examples:
- 10m
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_tunnel_search'
- description: Paginated response for organization tunnel statistics search results
examples:
- '{"end":1531862583,"limit":10,"results":[{"auth_algo":"hmac-md5-96","encrypt_algo":"aes-256-cbc","ike_version":"2","ip":"192.168.233.0","last_event":"down reason","mac":"020001ae9dd5","node":"node0","org_id":"78c11da8-f984-4425-bedb-a7ddd7d0f6da","peer_host":"sunnyvale1-vpn.zscalerbeta.net","peer_ip":"10.224.8.16","protocol":"ipsec","rx_bytes":150,"rx_pkts":75,"site_id":"e83e7928-eda1-4e93-82db-df3dd42ab726","tunnel_name":"Device-ipsec-1","tx_bytes":100,"tx_pkts":50,"up":true,"uptime":10,"wan_name":"wan"}],"start":1531776183,"total":1}'
- '{"end":1531862583,"limit":10,"results":[{"ap":"5c5b35000010","last_seen":1547437078,"mtu":582,"mxcluster_id":"572586b7-f97b-a22b-526c-8b97a3f609c4","mxedge_id":"387804a7-3474-85ce-15a2-f9a9684c9c90","mxtunnel_id":"7dae216d-7c98-a51b-e068-dd7d477b7216","org_id":"2818e386-8dec-2562-9ede-5b8a0fbbdc71","peer_mxedge_id":"09320a5c-bc23-441e-80a0-b96c632d45f5","remote_ip":"172.16.1.2","remote_port":13535,"sessions":[{"local_sid":31,"remote_id":"mxtunnel","remote_sid":13,"state":"established"}],"site_id":"4ac1dcf4-9d8b-7211-65c4-057819f0862b","start_time":1744000000,"state":"established_with_sessions"}],"start":1531776183,"total":1}'
contentMediaType: application/json
examples:
Type Wan:
value:
end: 1531862583
limit: 10
results:
- auth_algo: hmac-md5-96
encrypt_algo: aes-256-cbc
ike_version: '2'
ip: 192.168.233.0
last_event: down reason
mac: 020001ae9dd5
node: node0
org_id: 78c11da8-f984-4425-bedb-a7ddd7d0f6da
peer_host: sunnyvale1-vpn.zscalerbeta.net
peer_ip: 10.224.8.16
protocol: ipsec
rx_bytes: 150
rx_pkts: 75
site_id: e83e7928-eda1-4e93-82db-df3dd42ab726
tunnel_name: Device-ipsec-1
tx_bytes: 100
tx_pkts: 50
up: true
uptime: 10
wan_name: wan
start: 1531776183
total: 1
Type Wxtunnel:
value:
end: 1531862583
limit: 10
results:
- ap: 5c5b35000010
last_seen: 1547437078
mtu: 582
mxcluster_id: 572586b7-f97b-a22b-526c-8b97a3f609c4
mxedge_id: 387804a7-3474-85ce-15a2-f9a9684c9c90
mxtunnel_id: 7dae216d-7c98-a51b-e068-dd7d477b7216
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
peer_mxedge_id: 09320a5c-bc23-441e-80a0-b96c632d45f5
remote_ip: 172.16.1.2
remote_port: 13535
sessions:
- local_sid: 31
remote_id: mxtunnel
remote_sid: 13
state: established
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
start_time: 1744000000
state: established_with_sessions
start: 1531776183
total: 1
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_tunnel_search'
- description: Paginated response for organization tunnel statistics search results
examples:
- '{"end":1531862583,"limit":10,"results":[{"auth_algo":"hmac-md5-96","encrypt_algo":"aes-256-cbc","ike_version":"2","ip":"192.168.233.0","last_event":"down reason","mac":"020001ae9dd5","node":"node0","org_id":"78c11da8-f984-4425-bedb-a7ddd7d0f6da","peer_host":"sunnyvale1-vpn.zscalerbeta.net","peer_ip":"10.224.8.16","protocol":"ipsec","rx_bytes":150,"rx_pkts":75,"site_id":"e83e7928-eda1-4e93-82db-df3dd42ab726","tunnel_name":"Device-ipsec-1","tx_bytes":100,"tx_pkts":50,"up":true,"uptime":10,"wan_name":"wan"}],"start":1531776183,"total":1}'
- '{"end":1531862583,"limit":10,"results":[{"ap":"5c5b35000010","last_seen":1547437078,"mtu":582,"mxcluster_id":"572586b7-f97b-a22b-526c-8b97a3f609c4","mxedge_id":"387804a7-3474-85ce-15a2-f9a9684c9c90","mxtunnel_id":"7dae216d-7c98-a51b-e068-dd7d477b7216","org_id":"2818e386-8dec-2562-9ede-5b8a0fbbdc71","peer_mxedge_id":"09320a5c-bc23-441e-80a0-b96c632d45f5","remote_ip":"172.16.1.2","remote_port":13535,"sessions":[{"local_sid":31,"remote_id":"mxtunnel","remote_sid":13,"state":"established"}],"site_id":"4ac1dcf4-9d8b-7211-65c4-057819f0862b","start_time":1744000000,"state":"established_with_sessions"}],"start":1531776183,"total":1}'
contentMediaType: application/vnd.api+json
examples:
Type Wan:
value:
end: 1531862583
limit: 10
results:
- auth_algo: hmac-md5-96
encrypt_algo: aes-256-cbc
ike_version: '2'
ip: 192.168.233.0
last_event: down reason
mac: 020001ae9dd5
node: node0
org_id: 78c11da8-f984-4425-bedb-a7ddd7d0f6da
peer_host: sunnyvale1-vpn.zscalerbeta.net
peer_ip: 10.224.8.16
protocol: ipsec
rx_bytes: 150
rx_pkts: 75
site_id: e83e7928-eda1-4e93-82db-df3dd42ab726
tunnel_name: Device-ipsec-1
tx_bytes: 100
tx_pkts: 50
up: true
uptime: 10
wan_name: wan
start: 1531776183
total: 1
Type Wxtunnel:
value:
end: 1531862583
limit: 10
results:
- ap: 5c5b35000010
last_seen: 1547437078
mtu: 582
mxcluster_id: 572586b7-f97b-a22b-526c-8b97a3f609c4
mxedge_id: 387804a7-3474-85ce-15a2-f9a9684c9c90
mxtunnel_id: 7dae216d-7c98-a51b-e068-dd7d477b7216
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
peer_mxedge_id: 09320a5c-bc23-441e-80a0-b96c632d45f5
remote_ip: 172.16.1.2
remote_port: 13535
sessions:
- local_sid: 31
remote_id: mxtunnel
remote_sid: 13
state: established
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
start_time: 1744000000
state: established_with_sessions
start: 1531776183
total: 1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/stats/vpn_peers/count:
get:
tags:
- Orgs Stats - VPN Peers
summary: countOrgPeerPathStats
description: Count by Distinct Attributes of Org Peer Path Stats
operationId: countOrgPeerPathStats
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: Field used to group this count response
style: form
explode: true
schema:
type: string
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/stats/vpn_peers/search:
get:
tags:
- Orgs Stats - VPN Peers
summary: searchOrgPeerPathStats
description: Search Org Peer Path Stats
operationId: searchOrgPeerPathStats
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: mac
in: query
description: Filter results by MAC address. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- 5c5b53010101,5c5b53020202
- name: site_id
in: query
description: Filter results by site identifier
style: form
explode: true
schema:
type: string
- name: type
in: query
description: 'VPN implementation type used to filter the results. enum: `ipsec`, `svr`. Accepts multiple comma-separated values.'
style: form
explode: true
schema:
type: string
examples:
- svr,ipsec
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/vpn_peer_stat_search'
- description: Search response containing VPN peer path statistics
examples:
- end: 1619518989.4989712
limit: 10
results:
- is_active: true
last_seen: 1619518709.222
mac: 020001c04668
org_id: 0c160b7f-1027-4cd1-923b-744534c4b070
peer_mac: 020001367edd
peer_port_id: DC_Internet
peer_site_id: 725a8d34-a126-4f2c-b990-d1219421cb75
port_id: Lte
site_id: 725a8d34-a126-4f2c-b990-d1219421cb75
type: svr
up: true
uptime: 1527128046
- is_active: true
last_seen: 1619518709.222
latency: 91
mac: 020001c04668
mos: 4
mtu: 1500
org_id: 0c160b7f-1027-4cd1-923b-744534c4b070
peer_mac: 020001367edd
peer_port_id: DC_Internet
peer_router_name: RIDCBBP1
peer_site_id: 725a8d34-a126-4f2c-b990-d1219421cb75
port_id: Lte
router_name: RIST01544AP1
site_id: 725a8d34-a126-4f2c-b990-d1219421cb75
type: svr
up: true
uptime: 1527128046
start: 1619518689.4989705
total: 2
contentMediaType: application/json
examples:
Example:
value:
end: 1619518989.4989712
limit: 10
results:
- is_active: true
last_seen: 1619518709.222
mac: 020001c04668
org_id: 0c160b7f-1027-4cd1-923b-744534c4b070
peer_mac: 020001367edd
peer_port_id: DC_Internet
peer_site_id: 725a8d34-a126-4f2c-b990-d1219421cb75
port_id: Lte
site_id: 725a8d34-a126-4f2c-b990-d1219421cb75
type: svr
up: true
uptime: 1527128046
- is_active: true
last_seen: 1619518709.222
latency: 91
mac: 020001c04668
mos: 4
mtu: 1500
org_id: 0c160b7f-1027-4cd1-923b-744534c4b070
peer_mac: 020001367edd
peer_port_id: DC_Internet
peer_router_name: RIDCBBP1
peer_site_id: 725a8d34-a126-4f2c-b990-d1219421cb75
port_id: Lte
router_name: RIST01544AP1
site_id: 725a8d34-a126-4f2c-b990-d1219421cb75
type: svr
up: true
uptime: 1527128046
start: 1619518689.4989705
total: 2
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/vpn_peer_stat_search'
- description: Search response containing VPN peer path statistics
examples:
- end: 1619518989.4989712
limit: 10
results:
- is_active: true
last_seen: 1619518709.222
mac: 020001c04668
org_id: 0c160b7f-1027-4cd1-923b-744534c4b070
peer_mac: 020001367edd
peer_port_id: DC_Internet
peer_site_id: 725a8d34-a126-4f2c-b990-d1219421cb75
port_id: Lte
site_id: 725a8d34-a126-4f2c-b990-d1219421cb75
type: svr
up: true
uptime: 1527128046
- is_active: true
last_seen: 1619518709.222
latency: 91
mac: 020001c04668
mos: 4
mtu: 1500
org_id: 0c160b7f-1027-4cd1-923b-744534c4b070
peer_mac: 020001367edd
peer_port_id: DC_Internet
peer_router_name: RIDCBBP1
peer_site_id: 725a8d34-a126-4f2c-b990-d1219421cb75
port_id: Lte
router_name: RIST01544AP1
site_id: 725a8d34-a126-4f2c-b990-d1219421cb75
type: svr
up: true
uptime: 1527128046
start: 1619518689.4989705
total: 2
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 1619518989.4989712
limit: 10
results:
- is_active: true
last_seen: 1619518709.222
mac: 020001c04668
org_id: 0c160b7f-1027-4cd1-923b-744534c4b070
peer_mac: 020001367edd
peer_port_id: DC_Internet
peer_site_id: 725a8d34-a126-4f2c-b990-d1219421cb75
port_id: Lte
site_id: 725a8d34-a126-4f2c-b990-d1219421cb75
type: svr
up: true
uptime: 1527128046
- is_active: true
last_seen: 1619518709.222
latency: 91
mac: 020001c04668
mos: 4
mtu: 1500
org_id: 0c160b7f-1027-4cd1-923b-744534c4b070
peer_mac: 020001367edd
peer_port_id: DC_Internet
peer_router_name: RIDCBBP1
peer_site_id: 725a8d34-a126-4f2c-b990-d1219421cb75
port_id: Lte
router_name: RIST01544AP1
site_id: 725a8d34-a126-4f2c-b990-d1219421cb75
type: svr
up: true
uptime: 1527128046
start: 1619518689.4989705
total: 2
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/nacrules:
get:
tags:
- Orgs NAC Rules
summary: listOrgNacRules
description: List organization NAC authentication policy rules with evaluation order.
operationId: listOrgNacRules
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/nac_rule'
description: List of NAC authentication policy rules
examples:
- - action: allow
apply_tags:
- string
created_time: 0
id: 455f6eca-6276-4993-bfeb-53cbbbba6208
matching:
auth_type: eap-tls
nactags:
- string
port_types:
- wireless
site_ids:
- 454f6eca-6276-4993-bfeb-53cbbbba6308
sitegroup_ids:
- 453f6eca-6276-4993-bfeb-53cbbbba6408
modified_time: 0
name: string
not_matching:
auth_type: eap-tls
nactags:
- string
port_types:
- wireless
site_ids:
- 452f6eca-6276-4993-bfeb-53cbbbba6508
sitegroup_ids:
- 451f6eca-6276-4993-bfeb-53cbbbba6608
order: 1
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
contentMediaType: application/json
examples:
Example:
value:
- action: allow
apply_tags:
- string
created_time: 0
id: 455f6eca-6276-4993-bfeb-53cbbbba6208
matching:
auth_type: eap-tls
nactags:
- string
port_types:
- wireless
site_ids:
- 454f6eca-6276-4993-bfeb-53cbbbba6308
sitegroup_ids:
- 453f6eca-6276-4993-bfeb-53cbbbba6408
modified_time: 0
name: string
not_matching:
auth_type: eap-tls
nactags:
- string
port_types:
- wireless
site_ids:
- 452f6eca-6276-4993-bfeb-53cbbbba6508
sitegroup_ids:
- 451f6eca-6276-4993-bfeb-53cbbbba6608
order: 1
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/nac_rule'
description: List of NAC authentication policy rules
examples:
- - action: allow
apply_tags:
- string
created_time: 0
id: 455f6eca-6276-4993-bfeb-53cbbbba6208
matching:
auth_type: eap-tls
nactags:
- string
port_types:
- wireless
site_ids:
- 454f6eca-6276-4993-bfeb-53cbbbba6308
sitegroup_ids:
- 453f6eca-6276-4993-bfeb-53cbbbba6408
modified_time: 0
name: string
not_matching:
auth_type: eap-tls
nactags:
- string
port_types:
- wireless
site_ids:
- 452f6eca-6276-4993-bfeb-53cbbbba6508
sitegroup_ids:
- 451f6eca-6276-4993-bfeb-53cbbbba6608
order: 1
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- action: allow
apply_tags:
- string
created_time: 0
id: 455f6eca-6276-4993-bfeb-53cbbbba6208
matching:
auth_type: eap-tls
nactags:
- string
port_types:
- wireless
site_ids:
- 454f6eca-6276-4993-bfeb-53cbbbba6308
sitegroup_ids:
- 453f6eca-6276-4993-bfeb-53cbbbba6408
modified_time: 0
name: string
not_matching:
auth_type: eap-tls
nactags:
- string
port_types:
- wireless
site_ids:
- 452f6eca-6276-4993-bfeb-53cbbbba6508
sitegroup_ids:
- 451f6eca-6276-4993-bfeb-53cbbbba6608
order: 1
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs NAC Rules
summary: createOrgNacRule
description: Create a NAC authentication policy rule with match and not-match criteria, an allow or block action, optional result tags, and rule priority.
operationId: createOrgNacRule
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/nac_rule'
- examples:
- action: allow
apply_tags:
- c049dfcd-0c73-5014-1c64-062e9903f1e5"
matching:
auth_type: eap-tls
nactags:
- 041d5d36-716c-4cfb-4988-3857c6aa14a2
- a809a97f-d599-f812-eb8c-c3f84aabf6ba
port_types:
- wired
site_ids:
- bb19fc3e-4124-4b57-80d9-c3f6edce47c4
- bb19fc3e-6564-4b57-80d9-c3f6edce47c1
sitegroup_ids:
- bb19fc3e-4124-4b57-80d9-c3f6edce47c4
- bb19fc3e-6564-4b57-80d9-c3f6edce47c1
name: name1
not_matching: {}
order: 1
contentMediaType: application/json
examples:
Example:
value:
action: allow
apply_tags:
- c049dfcd-0c73-5014-1c64-062e9903f1e5"
matching:
auth_type: eap-tls
nactags:
- 041d5d36-716c-4cfb-4988-3857c6aa14a2
- a809a97f-d599-f812-eb8c-c3f84aabf6ba
port_types:
- wired
site_ids:
- bb19fc3e-4124-4b57-80d9-c3f6edce47c4
- bb19fc3e-6564-4b57-80d9-c3f6edce47c1
sitegroup_ids:
- bb19fc3e-4124-4b57-80d9-c3f6edce47c4
- bb19fc3e-6564-4b57-80d9-c3f6edce47c1
name: name1
not_matching: {}
order: 1
required: false
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/nac_rule'
- description: NAC authentication policy rule that matches request criteria and applies an allow or block action
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/nac_rule'
- description: NAC authentication policy rule that matches request criteria and applies an allow or block action
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/nacrules/{nacrule_id}:
delete:
tags:
- Orgs NAC Rules
summary: deleteOrgNacRule
description: Delete an organization NAC authentication policy rule by rule ID.
operationId: deleteOrgNacRule
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: nacrule_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Orgs NAC Rules
summary: getOrgNacRule
description: Retrieve configuration details for a specific NAC authentication policy rule, including action, matching criteria, dry-run state, and priority.
operationId: getOrgNacRule
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: nacrule_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/nac_rule'
- description: NAC authentication policy rule that matches request criteria and applies an allow or block action
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/nac_rule'
- description: NAC authentication policy rule that matches request criteria and applies an allow or block action
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Orgs NAC Rules
summary: updateOrgNacRule
description: Update a NAC authentication policy rule, including match and not-match criteria, action, result tags, dry-run state, and priority.
operationId: updateOrgNacRule
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: nacrule_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/nac_rule'
required: false
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/nac_rule'
- description: NAC authentication policy rule that matches request criteria and applies an allow or block action
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/nac_rule'
- description: NAC authentication policy rule that matches request criteria and applies an allow or block action
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/networktemplates:
get:
tags:
- Orgs Network Templates
summary: listOrgNetworkTemplates
description: List organization network templates that provide switch network, port, management, routing, NAC, and service configuration at the organization level.
operationId: listOrgNetworkTemplates
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/network_template'
description: List of network templates
examples:
- - additional_config_cmds:
- set snmp community public
created_time: 0
dhcp_snooping:
all_networks: true
enable_arp_spoof_check: true
enable_ip_source_guard: true
enabled: true
networks:
- string
dns_servers:
- 8.8.8.8
- 4.4.4.4
dns_suffix:
- .mist.local
- .mist.com
extra_routes:
0.0.0.0/0:
via: 1.2.3.4
group_tags: {}
id: 497f6eca-6276-4993-bfeb-53cbbbba6808
import_org_networks:
- ap
mist_nac:
enabled: true
network: default
modified_time: 0
name: template_name
networks:
corp:
vlan_id: 600
default:
subnet: 192.168.1.0/24
vlan_id: 1
guest:
vlan_id: 700
mgmt:
vlan_id: 500
ntp_servers:
- 192.168.1.10
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
port_usages:
ap:
all_networks: false
allow_dhcpd: true
bypass_auth_when_server_down: true
description: WAP
disable_autoneg: false
disabled: false
duplex: auto
enable_mac_auth: false
enable_qos: true
mac_auth_only: false
mac_auth_protocol: pap
mac_limit: 0
mode: trunk
networks:
- guest
- corp
persist_mac: false
poe_disabled: false
port_network: default
server_reject_network: null
storm_control:
no_broadcast: false
no_multicast: false
no_registered_multicast: false
no_unknown_unicast: false
percentage: 80
stp_edge: true
dynamic:
mode: dynamic
reset_default_when: link_down
rules:
- equals: string
equals_any:
- string
expression: string
src: lldp_chassis_id
usage: string
iot:
allow_dhcpd: true
mode: access
port_network: default
stp_edge: true
uplink:
all_networks: true
enable_qos: false
mode: trunk
port_network: default
stp_edge: false
radius_config:
acct_interim_interval: 0
acct_servers:
- host: 1.2.3.4
keywrap_enabled: true
keywrap_format: hex
keywrap_kek: '1122334455'
keywrap_mack: '1122334455'
port: 1813
secret: testing123
auth_servers:
- host: 1.2.3.4
keywrap_enabled: true
keywrap_format: hex
keywrap_kek: '1122334455'
keywrap_mack: '1122334455'
port: 1812
secret: testing123
auth_servers_retries: 3
auth_servers_timeout: 5
coa_enabled: false
coa_port: 3799
network: default
remote_syslog:
archive:
files: 20
size: 5m
console:
contents:
- facility: config
severity: warning
enabled: false
files:
- archive:
files: 10
size: 5m
contents:
- facility: config
severity: warning
explicit_priority: true
file: file-name
match: '!alarm|ntp|errors.crc_error[chan]'
structured_data: true
network: default
send_to_all_servers: false
servers:
- facility: config
host: syslogd.internal
port: 514
protocol: udp
severity: info
tag: ''
time_format: millisecond
users:
- contents:
- facility: config
severity: warning
match: '"!alarm|ntp|errors.crc_error[chan]"'
user: '*'
switch_matching:
enable: true
rules:
- additional_config_cmds:
- set snmp community public
match_model: EX4300
match_name[0:3]: abc
name: match by name
port_config:
ge-0/0/0:
usage: uplink
ge-0/0/8-16ge-1/0/0-47:
usage: ap
- additional_config_cmds:
- set snmp community public2
match_role: access
name: match by role
port_config:
ge-0/0/0:
usage: uplink
switch_mgmt:
config_revert_timer: 10
protect_re:
enabled: false
root_password: string
tacacs:
acct_servers:
- host: 198.51.100.1
port: '49'
secret: string
timeout: 10
enabled: true
network: string
tacplus_servers:
- host: 198.51.100.1
port: '49'
secret: string
timeout: 10
vrf_config:
enabled: false
vrf_instances:
property1:
extra_routes:
property1:
via: 198.51.100.1
property2:
via: 198.51.100.10
networks:
- string
property2:
extra_routes:
property1:
via: 198.51.100.1
property2:
via: 198.51.100.10
networks:
- string
contentMediaType: application/json
examples:
Example:
value:
- additional_config_cmds:
- set snmp community public
created_time: 0
dhcp_snooping:
all_networks: true
enable_arp_spoof_check: true
enable_ip_source_guard: true
enabled: true
networks:
- string
dns_servers:
- 8.8.8.8
- 4.4.4.4
dns_suffix:
- .mist.local
- .mist.com
extra_routes:
0.0.0.0/0:
via: 1.2.3.4
group_tags: {}
id: 497f6eca-6276-4993-bfeb-53cbbbba6808
import_org_networks:
- ap
mist_nac:
enabled: true
network: default
modified_time: 0
name: template_name
networks:
corp:
vlan_id: 600
default:
subnet: 192.168.1.0/24
vlan_id: 1
guest:
vlan_id: 700
mgmt:
vlan_id: 500
ntp_servers:
- 192.168.1.10
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
port_usages:
ap:
all_networks: false
allow_dhcpd: true
bypass_auth_when_server_down: true
description: WAP
disable_autoneg: false
disabled: false
duplex: auto
enable_mac_auth: false
enable_qos: true
mac_auth_only: false
mac_auth_protocol: pap
mac_limit: 0
mode: trunk
networks:
- guest
- corp
persist_mac: false
poe_disabled: false
port_network: default
server_reject_network: null
storm_control:
no_broadcast: false
no_multicast: false
no_registered_multicast: false
no_unknown_unicast: false
percentage: 80
stp_edge: true
dynamic:
mode: dynamic
reset_default_when: link_down
rules:
- equals: string
equals_any:
- string
expression: string
src: lldp_chassis_id
usage: string
iot:
allow_dhcpd: true
mode: access
port_network: default
stp_edge: true
uplink:
all_networks: true
enable_qos: false
mode: trunk
port_network: default
stp_edge: false
radius_config:
acct_interim_interval: 0
acct_servers:
- host: 1.2.3.4
keywrap_enabled: true
keywrap_format: hex
keywrap_kek: '1122334455'
keywrap_mack: '1122334455'
port: 1813
secret: testing123
auth_servers:
- host: 1.2.3.4
keywrap_enabled: true
keywrap_format: hex
keywrap_kek: '1122334455'
keywrap_mack: '1122334455'
port: 1812
secret: testing123
auth_servers_retries: 3
auth_servers_timeout: 5
coa_enabled: false
coa_port: 3799
network: default
remote_syslog:
archive:
files: 20
size: 5m
console:
contents:
- facility: config
severity: warning
enabled: false
files:
- archive:
files: 10
size: 5m
contents:
- facility: config
severity: warning
explicit_priority: true
file: file-name
match: '!alarm|ntp|errors.crc_error[chan]'
structured_data: true
network: default
send_to_all_servers: false
servers:
- facility: config
host: syslogd.internal
port: 514
protocol: udp
severity: info
tag: ''
time_format: millisecond
users:
- contents:
- facility: config
severity: warning
match: '"!alarm|ntp|errors.crc_error[chan]"'
user: '*'
switch_matching:
enable: true
rules:
- additional_config_cmds:
- set snmp community public
match_model: EX4300
match_name[0:3]: abc
name: match by name
port_config:
ge-0/0/0:
usage: uplink
ge-0/0/8-16ge-1/0/0-47:
usage: ap
- additional_config_cmds:
- set snmp community public2
match_role: access
name: match by role
port_config:
ge-0/0/0:
usage: uplink
switch_mgmt:
config_revert_timer: 10
protect_re:
enabled: false
root_password: string
tacacs:
acct_servers:
- host: 198.51.100.1
port: '49'
secret: string
timeout: 10
enabled: true
network: string
tacplus_servers:
- host: 198.51.100.1
port: '49'
secret: string
timeout: 10
vrf_config:
enabled: false
vrf_instances:
property1:
extra_routes:
property1:
via: 198.51.100.1
property2:
via: 198.51.100.10
networks:
- string
property2:
extra_routes:
property1:
via: 198.51.100.1
property2:
via: 198.51.100.10
networks:
- string
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/network_template'
description: List of network templates
examples:
- - additional_config_cmds:
- set snmp community public
created_time: 0
dhcp_snooping:
all_networks: true
enable_arp_spoof_check: true
enable_ip_source_guard: true
enabled: true
networks:
- string
dns_servers:
- 8.8.8.8
- 4.4.4.4
dns_suffix:
- .mist.local
- .mist.com
extra_routes:
0.0.0.0/0:
via: 1.2.3.4
group_tags: {}
id: 497f6eca-6276-4993-bfeb-53cbbbba6808
import_org_networks:
- ap
mist_nac:
enabled: true
network: default
modified_time: 0
name: template_name
networks:
corp:
vlan_id: 600
default:
subnet: 192.168.1.0/24
vlan_id: 1
guest:
vlan_id: 700
mgmt:
vlan_id: 500
ntp_servers:
- 192.168.1.10
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
port_usages:
ap:
all_networks: false
allow_dhcpd: true
bypass_auth_when_server_down: true
description: WAP
disable_autoneg: false
disabled: false
duplex: auto
enable_mac_auth: false
enable_qos: true
mac_auth_only: false
mac_auth_protocol: pap
mac_limit: 0
mode: trunk
networks:
- guest
- corp
persist_mac: false
poe_disabled: false
port_network: default
server_reject_network: null
storm_control:
no_broadcast: false
no_multicast: false
no_registered_multicast: false
no_unknown_unicast: false
percentage: 80
stp_edge: true
dynamic:
mode: dynamic
reset_default_when: link_down
rules:
- equals: string
equals_any:
- string
expression: string
src: lldp_chassis_id
usage: string
iot:
allow_dhcpd: true
mode: access
port_network: default
stp_edge: true
uplink:
all_networks: true
enable_qos: false
mode: trunk
port_network: default
stp_edge: false
radius_config:
acct_interim_interval: 0
acct_servers:
- host: 1.2.3.4
keywrap_enabled: true
keywrap_format: hex
keywrap_kek: '1122334455'
keywrap_mack: '1122334455'
port: 1813
secret: testing123
auth_servers:
- host: 1.2.3.4
keywrap_enabled: true
keywrap_format: hex
keywrap_kek: '1122334455'
keywrap_mack: '1122334455'
port: 1812
secret: testing123
auth_servers_retries: 3
auth_servers_timeout: 5
coa_enabled: false
coa_port: 3799
network: default
remote_syslog:
archive:
files: 20
size: 5m
console:
contents:
- facility: config
severity: warning
enabled: false
files:
- archive:
files: 10
size: 5m
contents:
- facility: config
severity: warning
explicit_priority: true
file: file-name
match: '!alarm|ntp|errors.crc_error[chan]'
structured_data: true
network: default
send_to_all_servers: false
servers:
- facility: config
host: syslogd.internal
port: 514
protocol: udp
severity: info
tag: ''
time_format: millisecond
users:
- contents:
- facility: config
severity: warning
match: '"!alarm|ntp|errors.crc_error[chan]"'
user: '*'
switch_matching:
enable: true
rules:
- additional_config_cmds:
- set snmp community public
match_model: EX4300
match_name[0:3]: abc
name: match by name
port_config:
ge-0/0/0:
usage: uplink
ge-0/0/8-16ge-1/0/0-47:
usage: ap
- additional_config_cmds:
- set snmp community public2
match_role: access
name: match by role
port_config:
ge-0/0/0:
usage: uplink
switch_mgmt:
config_revert_timer: 10
protect_re:
enabled: false
root_password: string
tacacs:
acct_servers:
- host: 198.51.100.1
port: '49'
secret: string
timeout: 10
enabled: true
network: string
tacplus_servers:
- host: 198.51.100.1
port: '49'
secret: string
timeout: 10
vrf_config:
enabled: false
vrf_instances:
property1:
extra_routes:
property1:
via: 198.51.100.1
property2:
via: 198.51.100.10
networks:
- string
property2:
extra_routes:
property1:
via: 198.51.100.1
property2:
via: 198.51.100.10
networks:
- string
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- additional_config_cmds:
- set snmp community public
created_time: 0
dhcp_snooping:
all_networks: true
enable_arp_spoof_check: true
enable_ip_source_guard: true
enabled: true
networks:
- string
dns_servers:
- 8.8.8.8
- 4.4.4.4
dns_suffix:
- .mist.local
- .mist.com
extra_routes:
0.0.0.0/0:
via: 1.2.3.4
group_tags: {}
id: 497f6eca-6276-4993-bfeb-53cbbbba6808
import_org_networks:
- ap
mist_nac:
enabled: true
network: default
modified_time: 0
name: template_name
networks:
corp:
vlan_id: 600
default:
subnet: 192.168.1.0/24
vlan_id: 1
guest:
vlan_id: 700
mgmt:
vlan_id: 500
ntp_servers:
- 192.168.1.10
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
port_usages:
ap:
all_networks: false
allow_dhcpd: true
bypass_auth_when_server_down: true
description: WAP
disable_autoneg: false
disabled: false
duplex: auto
enable_mac_auth: false
enable_qos: true
mac_auth_only: false
mac_auth_protocol: pap
mac_limit: 0
mode: trunk
networks:
- guest
- corp
persist_mac: false
poe_disabled: false
port_network: default
server_reject_network: null
storm_control:
no_broadcast: false
no_multicast: false
no_registered_multicast: false
no_unknown_unicast: false
percentage: 80
stp_edge: true
dynamic:
mode: dynamic
reset_default_when: link_down
rules:
- equals: string
equals_any:
- string
expression: string
src: lldp_chassis_id
usage: string
iot:
allow_dhcpd: true
mode: access
port_network: default
stp_edge: true
uplink:
all_networks: true
enable_qos: false
mode: trunk
port_network: default
stp_edge: false
radius_config:
acct_interim_interval: 0
acct_servers:
- host: 1.2.3.4
keywrap_enabled: true
keywrap_format: hex
keywrap_kek: '1122334455'
keywrap_mack: '1122334455'
port: 1813
secret: testing123
auth_servers:
- host: 1.2.3.4
keywrap_enabled: true
keywrap_format: hex
keywrap_kek: '1122334455'
keywrap_mack: '1122334455'
port: 1812
secret: testing123
auth_servers_retries: 3
auth_servers_timeout: 5
coa_enabled: false
coa_port: 3799
network: default
remote_syslog:
archive:
files: 20
size: 5m
console:
contents:
- facility: config
severity: warning
enabled: false
files:
- archive:
files: 10
size: 5m
contents:
- facility: config
severity: warning
explicit_priority: true
file: file-name
match: '!alarm|ntp|errors.crc_error[chan]'
structured_data: true
network: default
send_to_all_servers: false
servers:
- facility: config
host: syslogd.internal
port: 514
protocol: udp
severity: info
tag: ''
time_format: millisecond
users:
- contents:
- facility: config
severity: warning
match: '"!alarm|ntp|errors.crc_error[chan]"'
user: '*'
switch_matching:
enable: true
rules:
- additional_config_cmds:
- set snmp community public
match_model: EX4300
match_name[0:3]: abc
name: match by name
port_config:
ge-0/0/0:
usage: uplink
ge-0/0/8-16ge-1/0/0-47:
usage: ap
- additional_config_cmds:
- set snmp community public2
match_role: access
name: match by role
port_config:
ge-0/0/0:
usage: uplink
switch_mgmt:
config_revert_timer: 10
protect_re:
enabled: false
root_password: string
tacacs:
acct_servers:
- host: 198.51.100.1
port: '49'
secret: string
timeout: 10
enabled: true
network: string
tacplus_servers:
- host: 198.51.100.1
port: '49'
secret: string
timeout: 10
vrf_config:
enabled: false
vrf_instances:
property1:
extra_routes:
property1:
via: 198.51.100.1
property2:
via: 198.51.100.10
networks:
- string
property2:
extra_routes:
property1:
via: 198.51.100.1
property2:
via: 198.51.100.10
networks:
- string
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs Network Templates
summary: createOrgNetworkTemplate
description: >-
Create an organization network template with network, port usage, switch management, routing, NAC, and service configuration at the organization level.
Network templates can be applied to multiple sites within the organization to provide consistent network configuration across sites.
To assign a network template to a site, use the [Update Site]($e/Sites/updateSiteInfo) endpoint and specify the network template ID in the `networktemplate_id` field of the request body.
operationId: createOrgNetworkTemplate
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/network_template'
- description: Request Body
examples:
- additional_config_cmds:
- set snmp community public
dhcp_snooping:
all_networks: true
enable_arp_spoof_check: true
enable_ip_source_guard: true
enabled: true
networks:
- string
dns_servers:
- string
dns_suffix:
- string
import_org_networks:
- ap
mist_nac:
enabled: true
network: string
name: string
networks:
property1:
subnet: 192.168.1.0/24
vlan_id: 10
property2:
subnet: 192.168.1.0/24
vlan_id: 10
ntp_servers:
- string
port_usages:
dynamic:
mode: dynamic
reset_default_when: link_down
rules:
- equals: string
equals_any:
- string
expression: string
src: lldp_chassis_id
usage: string
property1:
all_networks: false
allow_dhcpd: true
bypass_auth_when_server_down: true
description: string
disable_autoneg: false
disabled: false
duplex: auto
enable_mac_auth: true
enable_qos: true
guest_network: string
mac_auth_only: true
mac_auth_protocol: pap
mac_limit: 0
mode: access
networks:
- string
persist_mac: false
poe_disabled: false
port_auth: dot1x
port_network: string
server_reject_network: null
speed: auto
storm_control:
no_broadcast: false
no_multicast: false
no_registered_multicast: false
no_unknown_unicast: false
percentage: 80
stp_edge: true
voip_network: string
property2:
all_networks: false
allow_dhcpd: true
bypass_auth_when_server_down: true
description: string
disable_autoneg: false
disabled: false
duplex: auto
enable_mac_auth: true
enable_qos: true
guest_network: string
mac_auth_only: true
mac_auth_protocol: pap
mac_limit: 0
mode: access
networks:
- string
persist_mac: false
poe_disabled: false
port_network: string
server_reject_network: null
speed: auto
storm_control:
no_broadcast: false
no_multicast: false
no_registered_multicast: false
no_unknown_unicast: false
percentage: 80
stp_edge: true
voip_network: string
switch_mgmt:
config_revert_timer: 10
protect_re:
enabled: false
root_password: string
tacacs:
acct_servers:
- host: 198.51.100.1
port: '49'
secret: string
timeout: 10
enabled: true
network: string
tacplus_servers:
- host: 198.51.100.1
port: '49'
secret: string
timeout: 10
vrf_config:
enabled: false
vrf_instances:
property1:
extra_routes:
property1:
via: 192.0.2.10
property2:
via: 198.51.100.1
networks:
- string
property2:
extra_routes:
property1:
via: 198.51.100.1
property2:
via: 198.51.100.10
networks:
- string
contentMediaType: application/json
examples:
Example:
value:
additional_config_cmds:
- set snmp community public
dhcp_snooping:
all_networks: true
enable_arp_spoof_check: true
enable_ip_source_guard: true
enabled: true
networks:
- string
dns_servers:
- string
dns_suffix:
- string
import_org_networks:
- ap
mist_nac:
enabled: true
network: string
name: string
networks:
property1:
subnet: 192.168.1.0/24
vlan_id: 10
property2:
subnet: 192.168.1.0/24
vlan_id: 10
ntp_servers:
- string
port_usages:
dynamic:
mode: dynamic
reset_default_when: link_down
rules:
- equals: string
equals_any:
- string
expression: string
src: lldp_chassis_id
usage: string
property1:
all_networks: false
allow_dhcpd: true
bypass_auth_when_server_down: true
description: string
disable_autoneg: false
disabled: false
duplex: auto
enable_mac_auth: true
enable_qos: true
guest_network: string
mac_auth_only: true
mac_auth_protocol: pap
mac_limit: 0
mode: access
networks:
- string
persist_mac: false
poe_disabled: false
port_auth: dot1x
port_network: string
server_reject_network: null
speed: auto
storm_control:
no_broadcast: false
no_multicast: false
no_registered_multicast: false
no_unknown_unicast: false
percentage: 80
stp_edge: true
voip_network: string
property2:
all_networks: false
allow_dhcpd: true
bypass_auth_when_server_down: true
description: string
disable_autoneg: false
disabled: false
duplex: auto
enable_mac_auth: true
enable_qos: true
guest_network: string
mac_auth_only: true
mac_auth_protocol: pap
mac_limit: 0
mode: access
networks:
- string
persist_mac: false
poe_disabled: false
port_network: string
server_reject_network: null
speed: auto
storm_control:
no_broadcast: false
no_multicast: false
no_registered_multicast: false
no_unknown_unicast: false
percentage: 80
stp_edge: true
voip_network: string
switch_mgmt:
config_revert_timer: 10
protect_re:
enabled: false
root_password: string
tacacs:
acct_servers:
- host: 198.51.100.1
port: '49'
secret: string
timeout: 10
enabled: true
network: string
tacplus_servers:
- host: 198.51.100.1
port: '49'
secret: string
timeout: 10
vrf_config:
enabled: false
vrf_instances:
property1:
extra_routes:
property1:
via: 192.0.2.10
property2:
via: 198.51.100.1
networks:
- string
property2:
extra_routes:
property1:
via: 198.51.100.1
property2:
via: 198.51.100.10
networks:
- string
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/network_template'
- description: Network template configuration applied to sites or site groups
examples:
- additional_config_cmds:
- set snmp community public
created_time: 0
dhcp_snooping:
all_networks: true
enable_arp_spoof_check: true
enable_ip_source_guard: true
enabled: true
networks:
- string
dns_servers:
- string
dns_suffix:
- string
extra_routes:
property1:
via: string
property2:
via: string
group_tags: {}
id: 497f6eca-6276-4993-bfeb-53cbbbba6708
import_org_networks:
- ap
mist_nac:
enabled: true
network: string
modified_time: 0
name: string
networks:
property1:
subnet: 192.168.1.0/24
vlan_id: 10
property2:
subnet: 192.168.1.0/24
vlan_id: 10
ntp_servers:
- string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
port_usages:
dynamic:
mode: dynamic
reset_default_when: link_down
rules:
- equals: string
equals_any:
- string
expression: string
src: lldp_chassis_id
usage: string
property1:
all_networks: false
allow_dhcpd: true
bypass_auth_when_server_down: true
description: string
disable_autoneg: false
disabled: false
duplex: auto
enable_mac_auth: true
enable_qos: true
guest_network: string
mac_auth_only: true
mac_auth_protocol: pap
mac_limit: 0
networks:
- string
persist_mac: false
poe_disabled: false
port_auth: dot1x
port_network: string
server_reject_network: null
speed: auto
storm_control:
no_broadcast: false
no_multicast: false
no_registered_multicast: false
no_unknown_unicast: false
percentage: 80
stp_edge: true
voip_network: string
property2:
all_networks: false
allow_dhcpd: true
bypass_auth_when_server_down: true
description: string
disable_autoneg: false
disabled: false
duplex: auto
enable_mac_auth: true
enable_qos: true
guest_network: string
mac_auth_only: true
mac_auth_protocol: pap
mac_limit: 0
mode: access
networks:
- string
persist_mac: false
poe_disabled: false
port_network: string
server_reject_network: null
speed: auto
storm_control:
no_broadcast: false
no_multicast: false
no_registered_multicast: false
no_unknown_unicast: false
percentage: 80
stp_edge: true
voip_network: string
switch_mgmt:
config_revert_timer: 10
protect_re:
enabled: false
root_password: string
tacacs:
acct_servers:
- host: 198.51.100.1
port: '49'
secret: string
timeout: 10
enabled: true
network: string
tacplus_servers:
- host: 198.51.100.1
port: '49'
secret: string
timeout: 10
vrf_config:
enabled: false
vrf_instances:
property1:
extra_routes:
property1:
via: 198.51.100.1
property2:
via: 198.51.100.10
networks:
- string
property2:
extra_routes:
property1:
via: 198.51.100.1
property2:
via: 198.51.100.10
networks:
- string
contentMediaType: application/json
examples:
Example:
value:
additional_config_cmds:
- set snmp community public
created_time: 0
dhcp_snooping:
all_networks: true
enable_arp_spoof_check: true
enable_ip_source_guard: true
enabled: true
networks:
- string
dns_servers:
- string
dns_suffix:
- string
extra_routes:
property1:
via: string
property2:
via: string
group_tags: {}
id: 497f6eca-6276-4993-bfeb-53cbbbba6708
import_org_networks:
- ap
mist_nac:
enabled: true
network: string
modified_time: 0
name: string
networks:
property1:
subnet: 192.168.1.0/24
vlan_id: 10
property2:
subnet: 192.168.1.0/24
vlan_id: 10
ntp_servers:
- string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
port_usages:
dynamic:
mode: dynamic
reset_default_when: link_down
rules:
- equals: string
equals_any:
- string
expression: string
src: lldp_chassis_id
usage: string
property1:
all_networks: false
allow_dhcpd: true
bypass_auth_when_server_down: true
description: string
disable_autoneg: false
disabled: false
duplex: auto
enable_mac_auth: true
enable_qos: true
guest_network: string
mac_auth_only: true
mac_auth_protocol: pap
mac_limit: 0
networks:
- string
persist_mac: false
poe_disabled: false
port_auth: dot1x
port_network: string
server_reject_network: null
speed: auto
storm_control:
no_broadcast: false
no_multicast: false
no_registered_multicast: false
no_unknown_unicast: false
percentage: 80
stp_edge: true
voip_network: string
property2:
all_networks: false
allow_dhcpd: true
bypass_auth_when_server_down: true
description: string
disable_autoneg: false
disabled: false
duplex: auto
enable_mac_auth: true
enable_qos: true
guest_network: string
mac_auth_only: true
mac_auth_protocol: pap
mac_limit: 0
mode: access
networks:
- string
persist_mac: false
poe_disabled: false
port_network: string
server_reject_network: null
speed: auto
storm_control:
no_broadcast: false
no_multicast: false
no_registered_multicast: false
no_unknown_unicast: false
percentage: 80
stp_edge: true
voip_network: string
switch_mgmt:
config_revert_timer: 10
protect_re:
enabled: false
root_password: string
tacacs:
acct_servers:
- host: 198.51.100.1
port: '49'
secret: string
timeout: 10
enabled: true
network: string
tacplus_servers:
- host: 198.51.100.1
port: '49'
secret: string
timeout: 10
vrf_config:
enabled: false
vrf_instances:
property1:
extra_routes:
property1:
via: 198.51.100.1
property2:
via: 198.51.100.10
networks:
- string
property2:
extra_routes:
property1:
via: 198.51.100.1
property2:
via: 198.51.100.10
networks:
- string
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/network_template'
- description: Network template configuration applied to sites or site groups
examples:
- additional_config_cmds:
- set snmp community public
created_time: 0
dhcp_snooping:
all_networks: true
enable_arp_spoof_check: true
enable_ip_source_guard: true
enabled: true
networks:
- string
dns_servers:
- string
dns_suffix:
- string
extra_routes:
property1:
via: string
property2:
via: string
group_tags: {}
id: 497f6eca-6276-4993-bfeb-53cbbbba6708
import_org_networks:
- ap
mist_nac:
enabled: true
network: string
modified_time: 0
name: string
networks:
property1:
subnet: 192.168.1.0/24
vlan_id: 10
property2:
subnet: 192.168.1.0/24
vlan_id: 10
ntp_servers:
- string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
port_usages:
dynamic:
mode: dynamic
reset_default_when: link_down
rules:
- equals: string
equals_any:
- string
expression: string
src: lldp_chassis_id
usage: string
property1:
all_networks: false
allow_dhcpd: true
bypass_auth_when_server_down: true
description: string
disable_autoneg: false
disabled: false
duplex: auto
enable_mac_auth: true
enable_qos: true
guest_network: string
mac_auth_only: true
mac_auth_protocol: pap
mac_limit: 0
networks:
- string
persist_mac: false
poe_disabled: false
port_auth: dot1x
port_network: string
server_reject_network: null
speed: auto
storm_control:
no_broadcast: false
no_multicast: false
no_registered_multicast: false
no_unknown_unicast: false
percentage: 80
stp_edge: true
voip_network: string
property2:
all_networks: false
allow_dhcpd: true
bypass_auth_when_server_down: true
description: string
disable_autoneg: false
disabled: false
duplex: auto
enable_mac_auth: true
enable_qos: true
guest_network: string
mac_auth_only: true
mac_auth_protocol: pap
mac_limit: 0
mode: access
networks:
- string
persist_mac: false
poe_disabled: false
port_network: string
server_reject_network: null
speed: auto
storm_control:
no_broadcast: false
no_multicast: false
no_registered_multicast: false
no_unknown_unicast: false
percentage: 80
stp_edge: true
voip_network: string
switch_mgmt:
config_revert_timer: 10
protect_re:
enabled: false
root_password: string
tacacs:
acct_servers:
- host: 198.51.100.1
port: '49'
secret: string
timeout: 10
enabled: true
network: string
tacplus_servers:
- host: 198.51.100.1
port: '49'
secret: string
timeout: 10
vrf_config:
enabled: false
vrf_instances:
property1:
extra_routes:
property1:
via: 198.51.100.1
property2:
via: 198.51.100.10
networks:
- string
property2:
extra_routes:
property1:
via: 198.51.100.1
property2:
via: 198.51.100.10
networks:
- string
contentMediaType: application/vnd.api+json
examples:
Example:
value:
additional_config_cmds:
- set snmp community public
created_time: 0
dhcp_snooping:
all_networks: true
enable_arp_spoof_check: true
enable_ip_source_guard: true
enabled: true
networks:
- string
dns_servers:
- string
dns_suffix:
- string
extra_routes:
property1:
via: string
property2:
via: string
group_tags: {}
id: 497f6eca-6276-4993-bfeb-53cbbbba6708
import_org_networks:
- ap
mist_nac:
enabled: true
network: string
modified_time: 0
name: string
networks:
property1:
subnet: 192.168.1.0/24
vlan_id: 10
property2:
subnet: 192.168.1.0/24
vlan_id: 10
ntp_servers:
- string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
port_usages:
dynamic:
mode: dynamic
reset_default_when: link_down
rules:
- equals: string
equals_any:
- string
expression: string
src: lldp_chassis_id
usage: string
property1:
all_networks: false
allow_dhcpd: true
bypass_auth_when_server_down: true
description: string
disable_autoneg: false
disabled: false
duplex: auto
enable_mac_auth: true
enable_qos: true
guest_network: string
mac_auth_only: true
mac_auth_protocol: pap
mac_limit: 0
networks:
- string
persist_mac: false
poe_disabled: false
port_auth: dot1x
port_network: string
server_reject_network: null
speed: auto
storm_control:
no_broadcast: false
no_multicast: false
no_registered_multicast: false
no_unknown_unicast: false
percentage: 80
stp_edge: true
voip_network: string
property2:
all_networks: false
allow_dhcpd: true
bypass_auth_when_server_down: true
description: string
disable_autoneg: false
disabled: false
duplex: auto
enable_mac_auth: true
enable_qos: true
guest_network: string
mac_auth_only: true
mac_auth_protocol: pap
mac_limit: 0
mode: access
networks:
- string
persist_mac: false
poe_disabled: false
port_network: string
server_reject_network: null
speed: auto
storm_control:
no_broadcast: false
no_multicast: false
no_registered_multicast: false
no_unknown_unicast: false
percentage: 80
stp_edge: true
voip_network: string
switch_mgmt:
config_revert_timer: 10
protect_re:
enabled: false
root_password: string
tacacs:
acct_servers:
- host: 198.51.100.1
port: '49'
secret: string
timeout: 10
enabled: true
network: string
tacplus_servers:
- host: 198.51.100.1
port: '49'
secret: string
timeout: 10
vrf_config:
enabled: false
vrf_instances:
property1:
extra_routes:
property1:
via: 198.51.100.1
property2:
via: 198.51.100.10
networks:
- string
property2:
extra_routes:
property1:
via: 198.51.100.1
property2:
via: 198.51.100.10
networks:
- string
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/networktemplates/{networktemplate_id}:
delete:
tags:
- Orgs Network Templates
summary: deleteOrgNetworkTemplate
description: Delete an organization network template by template ID so it can no longer be applied to sites or site groups.
operationId: deleteOrgNetworkTemplate
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: networktemplate_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Orgs Network Templates
summary: getOrgNetworkTemplate
description: Retrieve details for a specific organization network template, including network, port usage, switch management, routing, NAC, and service defaults.
operationId: getOrgNetworkTemplate
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: networktemplate_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/network_template'
- description: Network template configuration applied to sites or site groups
contentMediaType: application/json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Orgs Network Templates
summary: updateOrgNetworkTemplate
description: Update an organization network template, including network, port usage, switch management, routing, NAC, and service defaults.
operationId: updateOrgNetworkTemplate
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: networktemplate_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/network_template'
- description: Request Body
examples:
- additional_config_cmds:
- set snmp community public
dhcp_snooping:
all_networks: true
enable_arp_spoof_check: true
enable_ip_source_guard: true
enabled: true
networks:
- string
dns_servers:
- string
dns_suffix:
- string
extra_routes:
property1:
via: string
property2:
via: string
group_tags: {}
import_org_networks:
- ap
mist_nac:
enabled: true
network: string
name: string
networks:
property1:
subnet: 192.168.1.0/24
vlan_id: 10
property2:
subnet: 192.168.1.0/24
vlan_id: 10
ntp_servers:
- string
port_usages:
dynamic:
mode: dynamic
reset_default_when: link_down
rules:
- equals: string
equals_any:
- string
expression: string
src: lldp_chassis_id
usage: string
property1:
all_networks: false
allow_dhcpd: true
bypass_auth_when_server_down: true
description: string
disable_autoneg: false
disabled: false
duplex: auto
enable_mac_auth: true
enable_qos: true
guest_network: string
mac_auth_only: true
mac_auth_protocol: pap
mac_limit: 0
mode: access
networks:
- string
persist_mac: false
poe_disabled: false
port_auth: dot1x
port_network: string
server_reject_network: null
speed: auto
storm_control:
no_broadcast: false
no_multicast: false
no_registered_multicast: false
no_unknown_unicast: false
percentage: 80
stp_edge: true
voip_network: string
property2:
all_networks: false
allow_dhcpd: true
bypass_auth_when_server_down: true
description: string
disable_autoneg: false
disabled: false
duplex: auto
enable_mac_auth: true
enable_qos: true
guest_network: string
mac_auth_only: true
mac_auth_protocol: pap
mac_limit: 0
mode: access
networks:
- string
persist_mac: false
poe_disabled: false
port_network: string
server_reject_network: null
speed: auto
storm_control:
no_broadcast: false
no_multicast: false
no_registered_multicast: false
no_unknown_unicast: false
percentage: 80
stp_edge: true
voip_network: string
switch_mgmt:
config_revert_timer: 10
protect_re:
enabled: false
root_password: string
tacacs:
acct_servers:
- host: 198.51.100.1
port: '49'
secret: string
timeout: 10
enabled: true
network: string
tacplus_servers:
- host: 198.51.100.1
port: '49'
secret: string
timeout: 10
vrf_config:
enabled: false
vrf_instances:
property1:
extra_routes:
property1:
via: 198.51.100.1
property2:
via: 198.51.100.2
networks:
- string
property2:
extra_routes:
property1:
via: 198.51.100.1
property2:
via: 198.51.100.2
networks:
- string
contentMediaType: application/json
examples:
Example:
value:
additional_config_cmds:
- set snmp community public
dhcp_snooping:
all_networks: true
enable_arp_spoof_check: true
enable_ip_source_guard: true
enabled: true
networks:
- string
dns_servers:
- string
dns_suffix:
- string
extra_routes:
property1:
via: string
property2:
via: string
group_tags: {}
import_org_networks:
- ap
mist_nac:
enabled: true
network: string
name: string
networks:
property1:
subnet: 192.168.1.0/24
vlan_id: 10
property2:
subnet: 192.168.1.0/24
vlan_id: 10
ntp_servers:
- string
port_usages:
dynamic:
mode: dynamic
reset_default_when: link_down
rules:
- equals: string
equals_any:
- string
expression: string
src: lldp_chassis_id
usage: string
property1:
all_networks: false
allow_dhcpd: true
bypass_auth_when_server_down: true
description: string
disable_autoneg: false
disabled: false
duplex: auto
enable_mac_auth: true
enable_qos: true
guest_network: string
mac_auth_only: true
mac_auth_protocol: pap
mac_limit: 0
mode: access
networks:
- string
persist_mac: false
poe_disabled: false
port_auth: dot1x
port_network: string
server_reject_network: null
speed: auto
storm_control:
no_broadcast: false
no_multicast: false
no_registered_multicast: false
no_unknown_unicast: false
percentage: 80
stp_edge: true
voip_network: string
property2:
all_networks: false
allow_dhcpd: true
bypass_auth_when_server_down: true
description: string
disable_autoneg: false
disabled: false
duplex: auto
enable_mac_auth: true
enable_qos: true
guest_network: string
mac_auth_only: true
mac_auth_protocol: pap
mac_limit: 0
mode: access
networks:
- string
persist_mac: false
poe_disabled: false
port_network: string
server_reject_network: null
speed: auto
storm_control:
no_broadcast: false
no_multicast: false
no_registered_multicast: false
no_unknown_unicast: false
percentage: 80
stp_edge: true
voip_network: string
switch_mgmt:
config_revert_timer: 10
protect_re:
enabled: false
root_password: string
tacacs:
acct_servers:
- host: 198.51.100.1
port: '49'
secret: string
timeout: 10
enabled: true
network: string
tacplus_servers:
- host: 198.51.100.1
port: '49'
secret: string
timeout: 10
vrf_config:
enabled: false
vrf_instances:
property1:
extra_routes:
property1:
via: 198.51.100.1
property2:
via: 198.51.100.2
networks:
- string
property2:
extra_routes:
property1:
via: 198.51.100.1
property2:
via: 198.51.100.2
networks:
- string
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/network_template'
- description: Network template configuration applied to sites or site groups
examples:
- additional_config_cmds:
- set snmp community public
dhcp_snooping:
all_networks: true
enable_arp_spoof_check: true
enable_ip_source_guard: true
enabled: true
networks:
- string
dns_servers:
- string
dns_suffix:
- string
extra_routes:
property1:
via: string
property2:
via: string
import_org_networks:
- ap
mist_nac:
enabled: true
network: string
name: string
networks:
property1:
subnet: 192.168.1.0/24
vlan_id: 10
property2:
subnet: 192.168.1.0/24
vlan_id: 10
ntp_servers:
- string
port_usages:
dynamic:
mode: dynamic
reset_default_when: link_down
rules:
- equals: string
equals_any:
- string
expression: string
src: lldp_chassis_id
usage: string
property1:
all_networks: false
allow_dhcpd: true
bypass_auth_when_server_down: true
description: string
disable_autoneg: false
disabled: false
duplex: auto
enable_mac_auth: true
enable_qos: true
guest_network: string
mac_auth_only: true
mac_auth_protocol: pap
mac_limit: 0
mode: access
networks:
- string
persist_mac: false
poe_disabled: false
port_auth: dot1x
port_network: string
server_reject_network: null
speed: auto
storm_control:
no_broadcast: false
no_multicast: false
no_registered_multicast: false
no_unknown_unicast: false
percentage: 80
stp_edge: true
voip_network: string
property2:
all_networks: false
allow_dhcpd: true
bypass_auth_when_server_down: true
description: string
disable_autoneg: false
disabled: false
duplex: auto
enable_mac_auth: true
enable_qos: true
guest_network: string
mac_auth_only: true
mac_auth_protocol: pap
mac_limit: 0
mode: access
networks:
- string
persist_mac: false
poe_disabled: false
port_network: string
server_reject_network: null
speed: auto
storm_control:
no_broadcast: false
no_multicast: false
no_registered_multicast: false
no_unknown_unicast: false
percentage: 80
stp_edge: true
voip_network: string
switch_mgmt:
config_revert_timer: 10
protect_re:
enabled: false
root_password: string
tacacs:
acct_servers:
- host: 198.51.100.1
port: '49'
secret: string
timeout: 10
enabled: true
network: string
tacplus_servers:
- host: 198.51.100.1
port: '49'
secret: string
timeout: 10
vrf_config:
enabled: false
vrf_instances:
property1:
extra_routes:
property1:
via: 198.51.100.1
property2:
via: 198.51.100.2
networks:
- string
property2:
extra_routes:
property1:
via: 198.51.100.1
property2:
via: 198.51.100.2
networks:
- string
contentMediaType: application/json
examples:
Example:
value:
additional_config_cmds:
- set snmp community public
dhcp_snooping:
all_networks: true
enable_arp_spoof_check: true
enable_ip_source_guard: true
enabled: true
networks:
- string
dns_servers:
- string
dns_suffix:
- string
extra_routes:
property1:
via: string
property2:
via: string
import_org_networks:
- ap
mist_nac:
enabled: true
network: string
name: string
networks:
property1:
subnet: 192.168.1.0/24
vlan_id: 10
property2:
subnet: 192.168.1.0/24
vlan_id: 10
ntp_servers:
- string
port_usages:
dynamic:
mode: dynamic
reset_default_when: link_down
rules:
- equals: string
equals_any:
- string
expression: string
src: lldp_chassis_id
usage: string
property1:
all_networks: false
allow_dhcpd: true
bypass_auth_when_server_down: true
description: string
disable_autoneg: false
disabled: false
duplex: auto
enable_mac_auth: true
enable_qos: true
guest_network: string
mac_auth_only: true
mac_auth_protocol: pap
mac_limit: 0
mode: access
networks:
- string
persist_mac: false
poe_disabled: false
port_auth: dot1x
port_network: string
server_reject_network: null
speed: auto
storm_control:
no_broadcast: false
no_multicast: false
no_registered_multicast: false
no_unknown_unicast: false
percentage: 80
stp_edge: true
voip_network: string
property2:
all_networks: false
allow_dhcpd: true
bypass_auth_when_server_down: true
description: string
disable_autoneg: false
disabled: false
duplex: auto
enable_mac_auth: true
enable_qos: true
guest_network: string
mac_auth_only: true
mac_auth_protocol: pap
mac_limit: 0
mode: access
networks:
- string
persist_mac: false
poe_disabled: false
port_network: string
server_reject_network: null
speed: auto
storm_control:
no_broadcast: false
no_multicast: false
no_registered_multicast: false
no_unknown_unicast: false
percentage: 80
stp_edge: true
voip_network: string
switch_mgmt:
config_revert_timer: 10
protect_re:
enabled: false
root_password: string
tacacs:
acct_servers:
- host: 198.51.100.1
port: '49'
secret: string
timeout: 10
enabled: true
network: string
tacplus_servers:
- host: 198.51.100.1
port: '49'
secret: string
timeout: 10
vrf_config:
enabled: false
vrf_instances:
property1:
extra_routes:
property1:
via: 198.51.100.1
property2:
via: 198.51.100.2
networks:
- string
property2:
extra_routes:
property1:
via: 198.51.100.1
property2:
via: 198.51.100.2
networks:
- string
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/networks:
get:
tags:
- Orgs Networks
summary: listOrgNetworks
description: List organization-level Layer 3 network definitions used for service routes and gateway or network template configuration.
operationId: listOrgNetworks
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/network'
description: List of organization network definitions
examples:
- - created_time: 0
disallow_mist_services: false
gateway: 192.168.70.1
hosts:
property1:
external_ips: 172.16.10.32-172.16.10.35
ips: 192.168.70.32-192.168.70.35
property2:
external_ips: 172.16.10.32-172.16.10.35
ips: 192.168.70.32-192.168.70.35
id: 497f6eca-6276-4993-bfeb-53cbbbba6f13
internal_access:
enabled: true
internet_access:
create_simple_service_policy: false
destination_nat:
property1:
internal_ip: 192.168.70.30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.30
name: web server
port: '443'
enabled: true
restricted: false
static_nat:
property1:
internal_ip: 192.168.70.3
name: printer-1
property2:
internal_ip: 192.168.70.3
name: printer-1
isolation: true
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
subnet: 192.168.70.0/24
tenants:
property1:
addresses:
- 10.10.10.10
property2:
addresses:
- 10.10.10.45
vlan_id: 10
vpn_access:
property1:
allow_ping: true
destination_nat:
property1:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
nat_pool: 172.16.0.0/26
routed: true
source_nat:
external_ip: 172.16.0.8/30
static_nat:
property1:
internal_ip: 192.168.70.3
name: pos_station-1
property2:
internal_ip: 192.168.70.3
name: pos_station-1
summarized_subnet: 172.16.0.0/16
property2:
allow_ping: true
destination_nat:
property1:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
nat_pool: 172.16.0.0/26
routed: true
source_nat:
external_ip: 172.16.0.8/30
static_nat:
property1:
internal_ip: 192.168.70.3
name: pos_station-1
property2:
internal_ip: 192.168.70.3
name: pos_station-1
summarized_subnet: 172.16.0.0/16
contentMediaType: application/json
examples:
Example:
value:
- created_time: 0
disallow_mist_services: false
gateway: 192.168.70.1
hosts:
property1:
external_ips: 172.16.10.32-172.16.10.35
ips: 192.168.70.32-192.168.70.35
property2:
external_ips: 172.16.10.32-172.16.10.35
ips: 192.168.70.32-192.168.70.35
id: 497f6eca-6276-4993-bfeb-53cbbbba6f13
internal_access:
enabled: true
internet_access:
create_simple_service_policy: false
destination_nat:
property1:
internal_ip: 192.168.70.30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.30
name: web server
port: '443'
enabled: true
restricted: false
static_nat:
property1:
internal_ip: 192.168.70.3
name: printer-1
property2:
internal_ip: 192.168.70.3
name: printer-1
isolation: true
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
subnet: 192.168.70.0/24
tenants:
property1:
addresses:
- 10.10.10.10
property2:
addresses:
- 10.10.10.45
vlan_id: 10
vpn_access:
property1:
allow_ping: true
destination_nat:
property1:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
nat_pool: 172.16.0.0/26
routed: true
source_nat:
external_ip: 172.16.0.8/30
static_nat:
property1:
internal_ip: 192.168.70.3
name: pos_station-1
property2:
internal_ip: 192.168.70.3
name: pos_station-1
summarized_subnet: 172.16.0.0/16
property2:
allow_ping: true
destination_nat:
property1:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
nat_pool: 172.16.0.0/26
routed: true
source_nat:
external_ip: 172.16.0.8/30
static_nat:
property1:
internal_ip: 192.168.70.3
name: pos_station-1
property2:
internal_ip: 192.168.70.3
name: pos_station-1
summarized_subnet: 172.16.0.0/16
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/network'
description: List of organization network definitions
examples:
- - created_time: 0
disallow_mist_services: false
gateway: 192.168.70.1
hosts:
property1:
external_ips: 172.16.10.32-172.16.10.35
ips: 192.168.70.32-192.168.70.35
property2:
external_ips: 172.16.10.32-172.16.10.35
ips: 192.168.70.32-192.168.70.35
id: 497f6eca-6276-4993-bfeb-53cbbbba6f13
internal_access:
enabled: true
internet_access:
create_simple_service_policy: false
destination_nat:
property1:
internal_ip: 192.168.70.30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.30
name: web server
port: '443'
enabled: true
restricted: false
static_nat:
property1:
internal_ip: 192.168.70.3
name: printer-1
property2:
internal_ip: 192.168.70.3
name: printer-1
isolation: true
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
subnet: 192.168.70.0/24
tenants:
property1:
addresses:
- 10.10.10.10
property2:
addresses:
- 10.10.10.45
vlan_id: 10
vpn_access:
property1:
allow_ping: true
destination_nat:
property1:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
nat_pool: 172.16.0.0/26
routed: true
source_nat:
external_ip: 172.16.0.8/30
static_nat:
property1:
internal_ip: 192.168.70.3
name: pos_station-1
property2:
internal_ip: 192.168.70.3
name: pos_station-1
summarized_subnet: 172.16.0.0/16
property2:
allow_ping: true
destination_nat:
property1:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
nat_pool: 172.16.0.0/26
routed: true
source_nat:
external_ip: 172.16.0.8/30
static_nat:
property1:
internal_ip: 192.168.70.3
name: pos_station-1
property2:
internal_ip: 192.168.70.3
name: pos_station-1
summarized_subnet: 172.16.0.0/16
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- created_time: 0
disallow_mist_services: false
gateway: 192.168.70.1
hosts:
property1:
external_ips: 172.16.10.32-172.16.10.35
ips: 192.168.70.32-192.168.70.35
property2:
external_ips: 172.16.10.32-172.16.10.35
ips: 192.168.70.32-192.168.70.35
id: 497f6eca-6276-4993-bfeb-53cbbbba6f13
internal_access:
enabled: true
internet_access:
create_simple_service_policy: false
destination_nat:
property1:
internal_ip: 192.168.70.30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.30
name: web server
port: '443'
enabled: true
restricted: false
static_nat:
property1:
internal_ip: 192.168.70.3
name: printer-1
property2:
internal_ip: 192.168.70.3
name: printer-1
isolation: true
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
subnet: 192.168.70.0/24
tenants:
property1:
addresses:
- 10.10.10.10
property2:
addresses:
- 10.10.10.45
vlan_id: 10
vpn_access:
property1:
allow_ping: true
destination_nat:
property1:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
nat_pool: 172.16.0.0/26
routed: true
source_nat:
external_ip: 172.16.0.8/30
static_nat:
property1:
internal_ip: 192.168.70.3
name: pos_station-1
property2:
internal_ip: 192.168.70.3
name: pos_station-1
summarized_subnet: 172.16.0.0/16
property2:
allow_ping: true
destination_nat:
property1:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
nat_pool: 172.16.0.0/26
routed: true
source_nat:
external_ip: 172.16.0.8/30
static_nat:
property1:
internal_ip: 192.168.70.3
name: pos_station-1
property2:
internal_ip: 192.168.70.3
name: pos_station-1
summarized_subnet: 172.16.0.0/16
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs Networks
summary: createOrgNetwork
description: >-
Create an organization network definition with subnet, gateway,
VLAN, access, NAT, multicast, tenant, and VPN access settings used for service
routes and gateway or network template configuration.
Networks can be used
- in the gateway configuration to define Layer 3 network settings and policies for traffic entering or leaving the gateway through a specific interface, such as a corporate LAN, guest Wi-Fi, or DMZ network.
- in the service policies to allow or deny traffic matching the network or to apply specific inspection settings or steering rules.
operationId: createOrgNetwork
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/network'
- examples:
- disallow_mist_services: false
gateway: 192.168.70.1
hosts:
property1:
external_ips: 172.16.10.32-172.16.10.35
ips: 192.168.70.32-192.168.70.35
property2:
external_ips: 172.16.10.32-172.16.10.35
ips: 192.168.70.32-192.168.70.35
internal_access:
enabled: true
internet_access:
create_simple_service_policy: false
destination_nat:
property1:
internal_ip: 192.168.70.30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.30
name: web server
port: '443'
enabled: true
restricted: false
static_nat:
property1:
internal_ip: 192.168.70.3
name: printer-1
property2:
internal_ip: 192.168.70.3
name: printer-1
isolation: true
name: string
subnet: 192.168.70.0/24
tenants:
property1:
addresses:
- 10.10.10.10.
property2:
addresses:
- 10.10.10.52
vlan_id: 10
vpn_access:
property1:
allow_ping: true
destination_nat:
property1:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
nat_pool: 172.16.0.0/26
routed: true
source_nat:
external_ip: 172.16.0.8/30
static_nat:
property1:
internal_ip: 192.168.70.3
name: pos_station-1
property2:
internal_ip: 192.168.70.3
name: pos_station-1
summarized_subnet: 172.16.0.0/16
property2:
allow_ping: true
destination_nat:
property1:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
nat_pool: 172.16.0.0/26
routed: true
source_nat:
external_ip: 172.16.0.8/30
static_nat:
property1:
internal_ip: 192.168.70.3
name: pos_station-1
property2:
internal_ip: 192.168.70.3
name: pos_station-1
summarized_subnet: 172.16.0.0/16
contentMediaType: application/json
examples:
Example:
value:
disallow_mist_services: false
gateway: 192.168.70.1
hosts:
property1:
external_ips: 172.16.10.32-172.16.10.35
ips: 192.168.70.32-192.168.70.35
property2:
external_ips: 172.16.10.32-172.16.10.35
ips: 192.168.70.32-192.168.70.35
internal_access:
enabled: true
internet_access:
create_simple_service_policy: false
destination_nat:
property1:
internal_ip: 192.168.70.30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.30
name: web server
port: '443'
enabled: true
restricted: false
static_nat:
property1:
internal_ip: 192.168.70.3
name: printer-1
property2:
internal_ip: 192.168.70.3
name: printer-1
isolation: true
name: string
subnet: 192.168.70.0/24
tenants:
property1:
addresses:
- 10.10.10.10.
property2:
addresses:
- 10.10.10.52
vlan_id: 10
vpn_access:
property1:
allow_ping: true
destination_nat:
property1:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
nat_pool: 172.16.0.0/26
routed: true
source_nat:
external_ip: 172.16.0.8/30
static_nat:
property1:
internal_ip: 192.168.70.3
name: pos_station-1
property2:
internal_ip: 192.168.70.3
name: pos_station-1
summarized_subnet: 172.16.0.0/16
property2:
allow_ping: true
destination_nat:
property1:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
nat_pool: 172.16.0.0/26
routed: true
source_nat:
external_ip: 172.16.0.8/30
static_nat:
property1:
internal_ip: 192.168.70.3
name: pos_station-1
property2:
internal_ip: 192.168.70.3
name: pos_station-1
summarized_subnet: 172.16.0.0/16
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/network'
- description: Organization-level Layer 3 network definition that can be merged into site settings and used for service routes. Networks are used to define the service routes in the Gateway settings or templates
examples:
- created_time: 0
disallow_mist_services: false
gateway: 192.168.70.1
hosts:
property1:
external_ips: 172.16.10.32-172.16.10.35
ips: 192.168.70.32-192.168.70.35
property2:
external_ips: 172.16.10.32-172.16.10.35
ips: 192.168.70.32-192.168.70.35
id: 497f6eca-6276-4993-bfeb-53cbbbba6f12
internal_access:
enabled: true
internet_access:
create_simple_service_policy: false
destination_nat:
property1:
internal_ip: 192.168.70.30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.30
name: web server
port: '443'
enabled: true
restricted: false
static_nat:
property1:
internal_ip: 192.168.70.3
name: printer-1
property2:
internal_ip: 192.168.70.3
name: printer-1
isolation: true
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
subnet: 192.168.70.0/24
tenants:
property1:
addresses:
- 10.10.10.10
property2:
addresses:
- 10.10.10.52
vlan_id: 10
vpn_access:
property1:
allow_ping: true
destination_nat:
property1:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
nat_pool: 172.16.0.0/26
routed: true
source_nat:
external_ip: 172.16.0.8/30
static_nat:
property1:
internal_ip: 192.168.70.3
name: pos_station-1
property2:
internal_ip: 192.168.70.3
name: pos_station-1
summarized_subnet: 172.16.0.0/16
property2:
allow_ping: true
destination_nat:
property1:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
nat_pool: 172.16.0.0/26
routed: true
source_nat:
external_ip: 172.16.0.8/30
static_nat:
property1:
internal_ip: 192.168.70.3
name: pos_station-1
property2:
internal_ip: 192.168.70.3
name: pos_station-1
summarized_subnet: 172.16.0.0/16
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
disallow_mist_services: false
gateway: 192.168.70.1
hosts:
property1:
external_ips: 172.16.10.32-172.16.10.35
ips: 192.168.70.32-192.168.70.35
property2:
external_ips: 172.16.10.32-172.16.10.35
ips: 192.168.70.32-192.168.70.35
id: 497f6eca-6276-4993-bfeb-53cbbbba6f12
internal_access:
enabled: true
internet_access:
create_simple_service_policy: false
destination_nat:
property1:
internal_ip: 192.168.70.30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.30
name: web server
port: '443'
enabled: true
restricted: false
static_nat:
property1:
internal_ip: 192.168.70.3
name: printer-1
property2:
internal_ip: 192.168.70.3
name: printer-1
isolation: true
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
subnet: 192.168.70.0/24
tenants:
property1:
addresses:
- 10.10.10.10
property2:
addresses:
- 10.10.10.52
vlan_id: 10
vpn_access:
property1:
allow_ping: true
destination_nat:
property1:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
nat_pool: 172.16.0.0/26
routed: true
source_nat:
external_ip: 172.16.0.8/30
static_nat:
property1:
internal_ip: 192.168.70.3
name: pos_station-1
property2:
internal_ip: 192.168.70.3
name: pos_station-1
summarized_subnet: 172.16.0.0/16
property2:
allow_ping: true
destination_nat:
property1:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
nat_pool: 172.16.0.0/26
routed: true
source_nat:
external_ip: 172.16.0.8/30
static_nat:
property1:
internal_ip: 192.168.70.3
name: pos_station-1
property2:
internal_ip: 192.168.70.3
name: pos_station-1
summarized_subnet: 172.16.0.0/16
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/network'
- description: Organization-level Layer 3 network definition that can be merged into site settings and used for service routes. Networks are used to define the service routes in the Gateway settings or templates
examples:
- created_time: 0
disallow_mist_services: false
gateway: 192.168.70.1
hosts:
property1:
external_ips: 172.16.10.32-172.16.10.35
ips: 192.168.70.32-192.168.70.35
property2:
external_ips: 172.16.10.32-172.16.10.35
ips: 192.168.70.32-192.168.70.35
id: 497f6eca-6276-4993-bfeb-53cbbbba6f12
internal_access:
enabled: true
internet_access:
create_simple_service_policy: false
destination_nat:
property1:
internal_ip: 192.168.70.30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.30
name: web server
port: '443'
enabled: true
restricted: false
static_nat:
property1:
internal_ip: 192.168.70.3
name: printer-1
property2:
internal_ip: 192.168.70.3
name: printer-1
isolation: true
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
subnet: 192.168.70.0/24
tenants:
property1:
addresses:
- 10.10.10.10
property2:
addresses:
- 10.10.10.52
vlan_id: 10
vpn_access:
property1:
allow_ping: true
destination_nat:
property1:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
nat_pool: 172.16.0.0/26
routed: true
source_nat:
external_ip: 172.16.0.8/30
static_nat:
property1:
internal_ip: 192.168.70.3
name: pos_station-1
property2:
internal_ip: 192.168.70.3
name: pos_station-1
summarized_subnet: 172.16.0.0/16
property2:
allow_ping: true
destination_nat:
property1:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
nat_pool: 172.16.0.0/26
routed: true
source_nat:
external_ip: 172.16.0.8/30
static_nat:
property1:
internal_ip: 192.168.70.3
name: pos_station-1
property2:
internal_ip: 192.168.70.3
name: pos_station-1
summarized_subnet: 172.16.0.0/16
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
disallow_mist_services: false
gateway: 192.168.70.1
hosts:
property1:
external_ips: 172.16.10.32-172.16.10.35
ips: 192.168.70.32-192.168.70.35
property2:
external_ips: 172.16.10.32-172.16.10.35
ips: 192.168.70.32-192.168.70.35
id: 497f6eca-6276-4993-bfeb-53cbbbba6f12
internal_access:
enabled: true
internet_access:
create_simple_service_policy: false
destination_nat:
property1:
internal_ip: 192.168.70.30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.30
name: web server
port: '443'
enabled: true
restricted: false
static_nat:
property1:
internal_ip: 192.168.70.3
name: printer-1
property2:
internal_ip: 192.168.70.3
name: printer-1
isolation: true
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
subnet: 192.168.70.0/24
tenants:
property1:
addresses:
- 10.10.10.10
property2:
addresses:
- 10.10.10.52
vlan_id: 10
vpn_access:
property1:
allow_ping: true
destination_nat:
property1:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
nat_pool: 172.16.0.0/26
routed: true
source_nat:
external_ip: 172.16.0.8/30
static_nat:
property1:
internal_ip: 192.168.70.3
name: pos_station-1
property2:
internal_ip: 192.168.70.3
name: pos_station-1
summarized_subnet: 172.16.0.0/16
property2:
allow_ping: true
destination_nat:
property1:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
nat_pool: 172.16.0.0/26
routed: true
source_nat:
external_ip: 172.16.0.8/30
static_nat:
property1:
internal_ip: 192.168.70.3
name: pos_station-1
property2:
internal_ip: 192.168.70.3
name: pos_station-1
summarized_subnet: 172.16.0.0/16
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/networks/{network_id}:
delete:
tags:
- Orgs Networks
summary: deleteOrgNetwork
description: Delete an organization network definition by network ID so it can no longer be referenced by gateway or network template configuration.
operationId: deleteOrgNetwork
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: network_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Orgs Networks
summary: getOrgNetwork
description: Retrieve details for a specific organization network, including subnet, gateway, VLAN, access, NAT, multicast, tenant, and VPN access settings.
operationId: getOrgNetwork
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: network_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/network'
- description: Organization-level Layer 3 network definition that can be merged into site settings and used for service routes. Networks are used to define the service routes in the Gateway settings or templates
examples:
- created_time: 0
disallow_mist_services: false
gateway: 192.168.70.1
hosts:
property1:
external_ips: 172.16.10.32-172.16.10.35
ips: 192.168.70.32-192.168.70.35
property2:
external_ips: 172.16.10.32-172.16.10.35
ips: 192.168.70.32-192.168.70.35
id: 497f6eca-6276-4993-bfeb-53cbbbba6f12
internal_access:
enabled: true
internet_access:
create_simple_service_policy: false
destination_nat:
property1:
internal_ip: 192.168.70.30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.30
name: web server
port: '443'
enabled: true
restricted: false
static_nat:
property1:
internal_ip: 192.168.70.3
name: printer-1
property2:
internal_ip: 192.168.70.3
name: printer-1
isolation: true
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
subnet: 192.168.70.0/24
tenants:
property1:
addresses:
- 10.10.10.10
property2:
addresses:
- 10.10.10.52
vlan_id: 10
vpn_access:
property1:
allow_ping: true
destination_nat:
property1:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
nat_pool: 172.16.0.0/26
routed: true
source_nat:
external_ip: 172.16.0.8/30
static_nat:
property1:
internal_ip: 192.168.70.3
name: pos_station-1
property2:
internal_ip: 192.168.70.3
name: pos_station-1
summarized_subnet: 172.16.0.0/16
property2:
allow_ping: true
destination_nat:
property1:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
nat_pool: 172.16.0.0/26
routed: true
source_nat:
external_ip: 172.16.0.8/30
static_nat:
property1:
internal_ip: 192.168.70.3
name: pos_station-1
property2:
internal_ip: 192.168.70.3
name: pos_station-1
summarized_subnet: 172.16.0.0/16
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
disallow_mist_services: false
gateway: 192.168.70.1
hosts:
property1:
external_ips: 172.16.10.32-172.16.10.35
ips: 192.168.70.32-192.168.70.35
property2:
external_ips: 172.16.10.32-172.16.10.35
ips: 192.168.70.32-192.168.70.35
id: 497f6eca-6276-4993-bfeb-53cbbbba6f12
internal_access:
enabled: true
internet_access:
create_simple_service_policy: false
destination_nat:
property1:
internal_ip: 192.168.70.30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.30
name: web server
port: '443'
enabled: true
restricted: false
static_nat:
property1:
internal_ip: 192.168.70.3
name: printer-1
property2:
internal_ip: 192.168.70.3
name: printer-1
isolation: true
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
subnet: 192.168.70.0/24
tenants:
property1:
addresses:
- 10.10.10.10
property2:
addresses:
- 10.10.10.52
vlan_id: 10
vpn_access:
property1:
allow_ping: true
destination_nat:
property1:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
nat_pool: 172.16.0.0/26
routed: true
source_nat:
external_ip: 172.16.0.8/30
static_nat:
property1:
internal_ip: 192.168.70.3
name: pos_station-1
property2:
internal_ip: 192.168.70.3
name: pos_station-1
summarized_subnet: 172.16.0.0/16
property2:
allow_ping: true
destination_nat:
property1:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
nat_pool: 172.16.0.0/26
routed: true
source_nat:
external_ip: 172.16.0.8/30
static_nat:
property1:
internal_ip: 192.168.70.3
name: pos_station-1
property2:
internal_ip: 192.168.70.3
name: pos_station-1
summarized_subnet: 172.16.0.0/16
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/network'
- description: Organization-level Layer 3 network definition that can be merged into site settings and used for service routes. Networks are used to define the service routes in the Gateway settings or templates
examples:
- created_time: 0
disallow_mist_services: false
gateway: 192.168.70.1
hosts:
property1:
external_ips: 172.16.10.32-172.16.10.35
ips: 192.168.70.32-192.168.70.35
property2:
external_ips: 172.16.10.32-172.16.10.35
ips: 192.168.70.32-192.168.70.35
id: 497f6eca-6276-4993-bfeb-53cbbbba6f12
internal_access:
enabled: true
internet_access:
create_simple_service_policy: false
destination_nat:
property1:
internal_ip: 192.168.70.30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.30
name: web server
port: '443'
enabled: true
restricted: false
static_nat:
property1:
internal_ip: 192.168.70.3
name: printer-1
property2:
internal_ip: 192.168.70.3
name: printer-1
isolation: true
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
subnet: 192.168.70.0/24
tenants:
property1:
addresses:
- 10.10.10.10
property2:
addresses:
- 10.10.10.52
vlan_id: 10
vpn_access:
property1:
allow_ping: true
destination_nat:
property1:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
nat_pool: 172.16.0.0/26
routed: true
source_nat:
external_ip: 172.16.0.8/30
static_nat:
property1:
internal_ip: 192.168.70.3
name: pos_station-1
property2:
internal_ip: 192.168.70.3
name: pos_station-1
summarized_subnet: 172.16.0.0/16
property2:
allow_ping: true
destination_nat:
property1:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
nat_pool: 172.16.0.0/26
routed: true
source_nat:
external_ip: 172.16.0.8/30
static_nat:
property1:
internal_ip: 192.168.70.3
name: pos_station-1
property2:
internal_ip: 192.168.70.3
name: pos_station-1
summarized_subnet: 172.16.0.0/16
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
disallow_mist_services: false
gateway: 192.168.70.1
hosts:
property1:
external_ips: 172.16.10.32-172.16.10.35
ips: 192.168.70.32-192.168.70.35
property2:
external_ips: 172.16.10.32-172.16.10.35
ips: 192.168.70.32-192.168.70.35
id: 497f6eca-6276-4993-bfeb-53cbbbba6f12
internal_access:
enabled: true
internet_access:
create_simple_service_policy: false
destination_nat:
property1:
internal_ip: 192.168.70.30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.30
name: web server
port: '443'
enabled: true
restricted: false
static_nat:
property1:
internal_ip: 192.168.70.3
name: printer-1
property2:
internal_ip: 192.168.70.3
name: printer-1
isolation: true
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
subnet: 192.168.70.0/24
tenants:
property1:
addresses:
- 10.10.10.10
property2:
addresses:
- 10.10.10.52
vlan_id: 10
vpn_access:
property1:
allow_ping: true
destination_nat:
property1:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
nat_pool: 172.16.0.0/26
routed: true
source_nat:
external_ip: 172.16.0.8/30
static_nat:
property1:
internal_ip: 192.168.70.3
name: pos_station-1
property2:
internal_ip: 192.168.70.3
name: pos_station-1
summarized_subnet: 172.16.0.0/16
property2:
allow_ping: true
destination_nat:
property1:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
nat_pool: 172.16.0.0/26
routed: true
source_nat:
external_ip: 172.16.0.8/30
static_nat:
property1:
internal_ip: 192.168.70.3
name: pos_station-1
property2:
internal_ip: 192.168.70.3
name: pos_station-1
summarized_subnet: 172.16.0.0/16
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Orgs Networks
summary: updateOrgNetwork
description: Update an organization network definition, including subnet, gateway, VLAN, access, NAT, multicast, tenant, and VPN access settings.
operationId: updateOrgNetwork
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: network_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/network'
- examples:
- disallow_mist_services: false
gateway: 192.168.70.1
hosts:
property1:
external_ips: 172.16.10.32-172.16.10.35
ips: 192.168.70.32-192.168.70.35
property2:
external_ips: 172.16.10.32-172.16.10.35
ips: 192.168.70.32-192.168.70.35
internal_access:
enabled: true
internet_access:
create_simple_service_policy: false
destination_nat:
property1:
internal_ip: 192.168.70.30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.30
name: web server
port: '443'
enabled: true
restricted: false
static_nat:
property1:
internal_ip: 192.168.70.3
name: printer-1
property2:
internal_ip: 192.168.70.3
name: printer-1
isolation: true
name: string
subnet: 192.168.70.0/24
tenants:
property1:
addresses:
- 10.10.10.10
property2:
addresses:
- 10.10.10.52
vlan_id: 10
vpn_access:
property1:
allow_ping: true
destination_nat:
property1:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
nat_pool: 172.16.0.0/26
routed: true
source_nat:
external_ip: 172.16.0.8/30
static_nat:
property1:
internal_ip: 192.168.70.3
name: pos_station-1
property2:
internal_ip: 192.168.70.3
name: pos_station-1
summarized_subnet: 172.16.0.0/16
property2:
allow_ping: true
destination_nat:
property1:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
nat_pool: 172.16.0.0/26
routed: true
source_nat:
external_ip: 172.16.0.8/30
static_nat:
property1:
internal_ip: 192.168.70.3
name: pos_station-1
property2:
internal_ip: 192.168.70.3
name: pos_station-1
summarized_subnet: 172.16.0.0/16
contentMediaType: application/json
examples:
Example:
value:
disallow_mist_services: false
gateway: 192.168.70.1
hosts:
property1:
external_ips: 172.16.10.32-172.16.10.35
ips: 192.168.70.32-192.168.70.35
property2:
external_ips: 172.16.10.32-172.16.10.35
ips: 192.168.70.32-192.168.70.35
internal_access:
enabled: true
internet_access:
create_simple_service_policy: false
destination_nat:
property1:
internal_ip: 192.168.70.30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.30
name: web server
port: '443'
enabled: true
restricted: false
static_nat:
property1:
internal_ip: 192.168.70.3
name: printer-1
property2:
internal_ip: 192.168.70.3
name: printer-1
isolation: true
name: string
subnet: 192.168.70.0/24
tenants:
property1:
addresses:
- 10.10.10.10
property2:
addresses:
- 10.10.10.52
vlan_id: 10
vpn_access:
property1:
allow_ping: true
destination_nat:
property1:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
nat_pool: 172.16.0.0/26
routed: true
source_nat:
external_ip: 172.16.0.8/30
static_nat:
property1:
internal_ip: 192.168.70.3
name: pos_station-1
property2:
internal_ip: 192.168.70.3
name: pos_station-1
summarized_subnet: 172.16.0.0/16
property2:
allow_ping: true
destination_nat:
property1:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
nat_pool: 172.16.0.0/26
routed: true
source_nat:
external_ip: 172.16.0.8/30
static_nat:
property1:
internal_ip: 192.168.70.3
name: pos_station-1
property2:
internal_ip: 192.168.70.3
name: pos_station-1
summarized_subnet: 172.16.0.0/16
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/network'
- description: Organization-level Layer 3 network definition that can be merged into site settings and used for service routes. Networks are used to define the service routes in the Gateway settings or templates
examples:
- created_time: 0
disallow_mist_services: false
gateway: 192.168.70.1
hosts:
property1:
external_ips: 172.16.10.32-172.16.10.35
ips: 192.168.70.32-192.168.70.35
property2:
external_ips: 172.16.10.32-172.16.10.35
ips: 192.168.70.32-192.168.70.35
id: 497f6eca-6276-4993-bfeb-53cbbbba6f12
internal_access:
enabled: true
internet_access:
create_simple_service_policy: false
destination_nat:
property1:
internal_ip: 192.168.70.30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.30
name: web server
port: '443'
enabled: true
restricted: false
static_nat:
property1:
internal_ip: 192.168.70.3
name: printer-1
property2:
internal_ip: 192.168.70.3
name: printer-1
isolation: true
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
subnet: 192.168.70.0/24
tenants:
property1:
addresses:
- 10.10.10.10
property2:
addresses:
- 10.10.10.52
vlan_id: 10
vpn_access:
property1:
allow_ping: true
destination_nat:
property1:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
nat_pool: 172.16.0.0/26
routed: true
source_nat:
external_ip: 172.16.0.8/30
static_nat:
property1:
internal_ip: 192.168.70.3
name: pos_station-1
property2:
internal_ip: 192.168.70.3
name: pos_station-1
summarized_subnet: 172.16.0.0/16
property2:
allow_ping: true
destination_nat:
property1:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
nat_pool: 172.16.0.0/26
routed: true
source_nat:
external_ip: 172.16.0.8/30
static_nat:
property1:
internal_ip: 192.168.70.3
name: pos_station-1
property2:
internal_ip: 192.168.70.3
name: pos_station-1
summarized_subnet: 172.16.0.0/16
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
disallow_mist_services: false
gateway: 192.168.70.1
hosts:
property1:
external_ips: 172.16.10.32-172.16.10.35
ips: 192.168.70.32-192.168.70.35
property2:
external_ips: 172.16.10.32-172.16.10.35
ips: 192.168.70.32-192.168.70.35
id: 497f6eca-6276-4993-bfeb-53cbbbba6f12
internal_access:
enabled: true
internet_access:
create_simple_service_policy: false
destination_nat:
property1:
internal_ip: 192.168.70.30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.30
name: web server
port: '443'
enabled: true
restricted: false
static_nat:
property1:
internal_ip: 192.168.70.3
name: printer-1
property2:
internal_ip: 192.168.70.3
name: printer-1
isolation: true
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
subnet: 192.168.70.0/24
tenants:
property1:
addresses:
- 10.10.10.10
property2:
addresses:
- 10.10.10.52
vlan_id: 10
vpn_access:
property1:
allow_ping: true
destination_nat:
property1:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
nat_pool: 172.16.0.0/26
routed: true
source_nat:
external_ip: 172.16.0.8/30
static_nat:
property1:
internal_ip: 192.168.70.3
name: pos_station-1
property2:
internal_ip: 192.168.70.3
name: pos_station-1
summarized_subnet: 172.16.0.0/16
property2:
allow_ping: true
destination_nat:
property1:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
nat_pool: 172.16.0.0/26
routed: true
source_nat:
external_ip: 172.16.0.8/30
static_nat:
property1:
internal_ip: 192.168.70.3
name: pos_station-1
property2:
internal_ip: 192.168.70.3
name: pos_station-1
summarized_subnet: 172.16.0.0/16
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/network'
- description: Organization-level Layer 3 network definition that can be merged into site settings and used for service routes. Networks are used to define the service routes in the Gateway settings or templates
examples:
- created_time: 0
disallow_mist_services: false
gateway: 192.168.70.1
hosts:
property1:
external_ips: 172.16.10.32-172.16.10.35
ips: 192.168.70.32-192.168.70.35
property2:
external_ips: 172.16.10.32-172.16.10.35
ips: 192.168.70.32-192.168.70.35
id: 497f6eca-6276-4993-bfeb-53cbbbba6f12
internal_access:
enabled: true
internet_access:
create_simple_service_policy: false
destination_nat:
property1:
internal_ip: 192.168.70.30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.30
name: web server
port: '443'
enabled: true
restricted: false
static_nat:
property1:
internal_ip: 192.168.70.3
name: printer-1
property2:
internal_ip: 192.168.70.3
name: printer-1
isolation: true
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
subnet: 192.168.70.0/24
tenants:
property1:
addresses:
- 10.10.10.10
property2:
addresses:
- 10.10.10.52
vlan_id: 10
vpn_access:
property1:
allow_ping: true
destination_nat:
property1:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
nat_pool: 172.16.0.0/26
routed: true
source_nat:
external_ip: 172.16.0.8/30
static_nat:
property1:
internal_ip: 192.168.70.3
name: pos_station-1
property2:
internal_ip: 192.168.70.3
name: pos_station-1
summarized_subnet: 172.16.0.0/16
property2:
allow_ping: true
destination_nat:
property1:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
nat_pool: 172.16.0.0/26
routed: true
source_nat:
external_ip: 172.16.0.8/30
static_nat:
property1:
internal_ip: 192.168.70.3
name: pos_station-1
property2:
internal_ip: 192.168.70.3
name: pos_station-1
summarized_subnet: 172.16.0.0/16
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
disallow_mist_services: false
gateway: 192.168.70.1
hosts:
property1:
external_ips: 172.16.10.32-172.16.10.35
ips: 192.168.70.32-192.168.70.35
property2:
external_ips: 172.16.10.32-172.16.10.35
ips: 192.168.70.32-192.168.70.35
id: 497f6eca-6276-4993-bfeb-53cbbbba6f12
internal_access:
enabled: true
internet_access:
create_simple_service_policy: false
destination_nat:
property1:
internal_ip: 192.168.70.30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.30
name: web server
port: '443'
enabled: true
restricted: false
static_nat:
property1:
internal_ip: 192.168.70.3
name: printer-1
property2:
internal_ip: 192.168.70.3
name: printer-1
isolation: true
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
subnet: 192.168.70.0/24
tenants:
property1:
addresses:
- 10.10.10.10
property2:
addresses:
- 10.10.10.52
vlan_id: 10
vpn_access:
property1:
allow_ping: true
destination_nat:
property1:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
nat_pool: 172.16.0.0/26
routed: true
source_nat:
external_ip: 172.16.0.8/30
static_nat:
property1:
internal_ip: 192.168.70.3
name: pos_station-1
property2:
internal_ip: 192.168.70.3
name: pos_station-1
summarized_subnet: 172.16.0.0/16
property2:
allow_ping: true
destination_nat:
property1:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
nat_pool: 172.16.0.0/26
routed: true
source_nat:
external_ip: 172.16.0.8/30
static_nat:
property1:
internal_ip: 192.168.70.3
name: pos_station-1
property2:
internal_ip: 192.168.70.3
name: pos_station-1
summarized_subnet: 172.16.0.0/16
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/pma/dashboards:
get:
tags:
- Orgs Premium Analytics
summary: listOrgPmaDashboards
description: List Premium Analytics dashboard metadata and redirect URLs available to the organization.
operationId: listOrgPmaDashboards
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/pma_dashboard'
description: List of PMA dashboard metadata records
examples:
- - name: dashboard_1
url: https://mist.looker.com/login/embed/%2Fembed%2Fdashboards%2F1?group_ids=%5B3%5D&last_name=%22%22&models=%5B%22generic%22%5D&.....
contentMediaType: application/json
examples:
Example:
value:
- name: dashboard_1
url: https://mist.looker.com/login/embed/%2Fembed%2Fdashboards%2F1?group_ids=%5B3%5D&last_name=%22%22&models=%5B%22generic%22%5D&.....
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/pma_dashboard'
description: List of PMA dashboard metadata records
examples:
- - name: dashboard_1
url: https://mist.looker.com/login/embed/%2Fembed%2Fdashboards%2F1?group_ids=%5B3%5D&last_name=%22%22&models=%5B%22generic%22%5D&.....
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- name: dashboard_1
url: https://mist.looker.com/login/embed/%2Fembed%2Fdashboards%2F1?group_ids=%5B3%5D&last_name=%22%22&models=%5B%22generic%22%5D&.....
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/psks:
get:
tags:
- Orgs Psks
summary: listOrgPsks
description: List organization personal PSKs for WLAN access, optionally filtering by name, SSID, or role.
operationId: listOrgPsks
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: name
in: query
description: Filter results by name. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- psk-a,psk-b
- name: ssid
in: query
description: Filter results by SSID. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- Corp,Guest
- name: role
in: query
description: Filter PSK results by role. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- employee,contractor
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/psk'
description: List of personal PSK configurations
examples:
- - created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
passphrase: secretpsk
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ssid: string
usage: multi
vlan_id: 1
contentMediaType: application/json
examples:
Example:
value:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
passphrase: secretpsk
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ssid: string
usage: multi
vlan_id: 1
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/psk'
description: List of personal PSK configurations
examples:
- - created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
passphrase: secretpsk
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ssid: string
usage: multi
vlan_id: 1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
passphrase: secretpsk
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ssid: string
usage: multi
vlan_id: 1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs Psks
summary: createOrgPsk
description: >-
Create an organization personal PSK for WLAN access, including SSID, passphrase, usage mode, optional client MAC binding, role, VLAN, and expiration settings.
When `usage`==`macs`, corresponding "macs" field will hold a list consisting of client MAC addresses (["xx:xx:xx:xx:xx",...]) or mac patterns(["xx:xx:*","xx*",...]) or both (["xx:xx:xx:xx:xx:xx", "xx:*", ...]). This list is capped at 5000
operationId: createOrgPsk
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: upsert
in: query
description: If a key exists with the same `name`, replace it with the new one
style: form
explode: true
schema:
type: boolean
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/psk'
- description: Request Body
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/psk'
- description: Personal pre-shared key configuration for WLAN access
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/psk'
- description: Personal pre-shared key configuration for WLAN access
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Orgs Psks
summary: updateOrgMultiplePsks
description: Update multiple organization personal PSKs in one request, including passphrase, usage mode, role, VLAN, expiration, and notification settings.
operationId: updateOrgMultiplePsks
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/psk'
description: ''
examples:
- - expire_time: 1614990263
mac: string
max_usage: 0
name: string
passphrase: secretpsk
ssid: string
usage: multi
vlan_id: 10
contentMediaType: application/json
examples:
Example:
value:
- expire_time: 1614990263
mac: string
max_usage: 0
name: string
passphrase: secretpsk
ssid: string
usage: multi
vlan_id: 10
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/psk'
description: List of personal PSK configurations
examples:
- - created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
passphrase: secretpsk
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ssid: string
usage: multi
vlan_id: 1
contentMediaType: application/json
examples:
Example:
value:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
passphrase: secretpsk
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ssid: string
usage: multi
vlan_id: 1
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/psk'
description: List of personal PSK configurations
examples:
- - created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
passphrase: secretpsk
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ssid: string
usage: multi
vlan_id: 1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
passphrase: secretpsk
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ssid: string
usage: multi
vlan_id: 1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/psks/delete:
post:
tags:
- Orgs Psks
summary: deleteOrgPskList
description: >-
Delete one or more organization PSKs by ID.
The request accepts a single PSK ID string or a list of PSK ID strings.
**Warning**: If no PSK IDs are provided in the request, all organization PSKs will be deleted and clients will no longer be able to authenticate to any SSID with a PSK.
operationId: deleteOrgPskList
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/psk_id_list'
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/psks/import:
post:
tags:
- Orgs Psks
summary: importOrgPsks
description: >-
Import organization PSKs from a CSV file or JSON payload.
## CSV File Format
```
PSK Import CSV File Format:
name,ssid,passphrase,usage,vlan_id,mac,max_usage,role,expire_time,notify_expiry,expiry_notification_time,notify_on_create_or_edit,email
Common,warehouse,foryoureyesonly,single,35,a31425f31278,0,student,1618594236
Justin,reception,visible,multi,1002,200,teacher,1618594236
Common2,ssid,1245678-xx,single,35,a31425f31278,0,student,1618594236,true,7,true,admin@test.com
```
operationId: importOrgPsks
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
content:
multipart/form-data:
encoding: {}
schema:
type: object
properties:
file:
type: string
description: Uploaded CSV or binary file containing PSKs to import
contentEncoding: base64
contentMediaType: multipart/form-data
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/psk'
description: List of personal PSK configurations
examples:
- - created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
passphrase: secretpsk
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ssid: string
usage: multi
vlan_id: 1
contentMediaType: application/json
examples:
Example:
value:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
passphrase: secretpsk
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ssid: string
usage: multi
vlan_id: 1
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/psk'
description: List of personal PSK configurations
examples:
- - created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
passphrase: secretpsk
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ssid: string
usage: multi
vlan_id: 1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
passphrase: secretpsk
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ssid: string
usage: multi
vlan_id: 1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/psks/{psk_id}:
delete:
tags:
- Orgs Psks
summary: deleteOrgPsk
description: Delete an organization personal PSK by PSK ID so clients can no longer authenticate with that key.
operationId: deleteOrgPsk
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: psk_id
in: path
description: PSK ID
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Orgs Psks
summary: getOrgPsk
description: Retrieve details for an organization personal PSK, including SSID, usage mode, MAC binding, role, VLAN, expiration, and notification settings.
operationId: getOrgPsk
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: psk_id
in: path
description: PSK ID
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/psk'
- description: Personal pre-shared key configuration for WLAN access
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/psk'
- description: Personal pre-shared key configuration for WLAN access
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Orgs Psks
summary: updateOrgPsk
description: Update an organization personal PSK, including passphrase, usage mode, MAC binding, role, VLAN, expiration, and notification settings.
operationId: updateOrgPsk
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: psk_id
in: path
description: PSK ID
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/psk'
- description: Request Body
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/psk'
- description: Personal pre-shared key configuration for WLAN access
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/psk'
- description: Personal pre-shared key configuration for WLAN access
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/psks/{psk_id}/delete_old_passphrase:
post:
tags:
- Orgs Psks
summary: deleteOrgPskOldPassphrase
description: "Remove the stored `old_passphrase` from a PSK after rotation. \nIf successful, the response returns the PSK with `old_passphrase` removed."
operationId: deleteOrgPskOldPassphrase
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: psk_id
in: path
description: PSK ID
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/psk'
- description: Personal pre-shared key configuration for WLAN access
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/psk'
- description: Personal pre-shared key configuration for WLAN access
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/pskportals:
get:
tags:
- Orgs Psk Portals
summary: listOrgPskPortals
description: List self-service PSK Portal configurations in the organization, including portal mode, SSID, authentication, expiry, and passphrase rules.
operationId: listOrgPskPortals
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/psk_portal'
description: List of PSK portal configurations
contentMediaType: application/json
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/psk_portal'
description: List of PSK portal configurations
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs Psk Portals
summary: createOrgPskPortal
description: Create a self-service PSK Portal configuration for issuing personal PSKs, including SSID, BYOD or admin mode, SSO or sponsor authentication, passphrase rules, and expiry settings.
operationId: createOrgPskPortal
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/psk_portal'
- examples:
- auth: sso
expire_time: 262800
expiry_notification_time: 2
hide_psks_created_by_other_admins: false
max_usage: 1
name: USR-test
notify_expiry: false
passphrase_rules:
alphabets_enabled: true
length: 8
numerics_enabled: true
symbols: ()[]{}_%@#&$
symbols_enabled: true
ssid: USR-test
sso:
idp_cert: >-
-----BEGIN CERTIFICATE-----
MIIDqDCCApCgA...-----END CERTIFICATE-----
idp_sign_algo: sha256
idp_sso_url: https://dev-00000000.okta.com/app/dev-00000000/a6b88bec5ab7/sso/saml
issuer: http://www.okta.com/a6b88bec5ab7
nameid_format: email
type: byod
vlan_id: 42
contentMediaType: application/json
examples:
Example:
value:
auth: sso
expire_time: 262800
expiry_notification_time: 2
hide_psks_created_by_other_admins: false
max_usage: 1
name: USR-test
notify_expiry: false
passphrase_rules:
alphabets_enabled: true
length: 8
numerics_enabled: true
symbols: ()[]{}_%@#&$
symbols_enabled: true
ssid: USR-test
sso:
idp_cert: >-
-----BEGIN CERTIFICATE-----
MIIDqDCCApCgA...-----END CERTIFICATE-----
idp_sign_algo: sha256
idp_sso_url: https://dev-00000000.okta.com/app/dev-00000000/a6b88bec5ab7/sso/saml
issuer: http://www.okta.com/a6b88bec5ab7
nameid_format: email
type: byod
vlan_id: 42
required: false
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/psk_portal'
- description: Self-service portal configuration for issuing personal PSKs
examples:
- auth: sso
created_time: 1727272316
expire_time: 262800
expiry_notification_time: 2
hide_psks_created_by_other_admins: false
id: 86ef73e5-e360-4e33-abd8-c2da7b11cbd6
max_usage: 1
modified_time: 1727272316
name: USR-test
notify_expiry: false
org_id: 8f6c24d5-b618-4c30-b6ff-b2febc1078ab
passphrase_rules:
alphabets_enabled: true
length: 8
numerics_enabled: true
symbols: ()[]{}_%@#&$
symbols_enabled: true
role: ''
ssid: USR-test
sso:
idp_cert: >-
-----BEGIN CERTIFICATE-----
MIIDqDCCApCgA...-----END CERTIFICATE-----
idp_sign_algo: sha256
idp_sso_url: https://dev-00000000.okta.com/app/dev-00000000/a6b88bec5ab7/sso/saml
issuer: http://www.okta.com/a6b88bec5ab7
nameid_format: email
type: byod
ui_url: https://pskportal.gc1.mist.com/#!byod/a6b88bec-5ab7-41ae-a34c-44ff52a8b81d
vlan_id: 123
contentMediaType: application/json
examples:
PSK Portal:
value:
auth: sso
created_time: 1727272316
expire_time: 262800
expiry_notification_time: 2
hide_psks_created_by_other_admins: false
id: 86ef73e5-e360-4e33-abd8-c2da7b11cbd6
max_usage: 1
modified_time: 1727272316
name: USR-test
notify_expiry: false
org_id: 8f6c24d5-b618-4c30-b6ff-b2febc1078ab
passphrase_rules:
alphabets_enabled: true
length: 8
numerics_enabled: true
symbols: ()[]{}_%@#&$
symbols_enabled: true
role: ''
ssid: USR-test
sso:
idp_cert: >-
-----BEGIN CERTIFICATE-----
MIIDqDCCApCgA...-----END CERTIFICATE-----
idp_sign_algo: sha256
idp_sso_url: https://dev-00000000.okta.com/app/dev-00000000/a6b88bec5ab7/sso/saml
issuer: http://www.okta.com/a6b88bec5ab7
nameid_format: email
type: byod
ui_url: https://pskportal.gc1.mist.com/#!byod/a6b88bec-5ab7-41ae-a34c-44ff52a8b81d
vlan_id: 123
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/psk_portal'
- description: Self-service portal configuration for issuing personal PSKs
examples:
- auth: sso
created_time: 1727272316
expire_time: 262800
expiry_notification_time: 2
hide_psks_created_by_other_admins: false
id: 86ef73e5-e360-4e33-abd8-c2da7b11cbd6
max_usage: 1
modified_time: 1727272316
name: USR-test
notify_expiry: false
org_id: 8f6c24d5-b618-4c30-b6ff-b2febc1078ab
passphrase_rules:
alphabets_enabled: true
length: 8
numerics_enabled: true
symbols: ()[]{}_%@#&$
symbols_enabled: true
role: ''
ssid: USR-test
sso:
idp_cert: >-
-----BEGIN CERTIFICATE-----
MIIDqDCCApCgA...-----END CERTIFICATE-----
idp_sign_algo: sha256
idp_sso_url: https://dev-00000000.okta.com/app/dev-00000000/a6b88bec5ab7/sso/saml
issuer: http://www.okta.com/a6b88bec5ab7
nameid_format: email
type: byod
ui_url: https://pskportal.gc1.mist.com/#!byod/a6b88bec-5ab7-41ae-a34c-44ff52a8b81d
vlan_id: 123
contentMediaType: application/vnd.api+json
examples:
PSK Portal:
value:
auth: sso
created_time: 1727272316
expire_time: 262800
expiry_notification_time: 2
hide_psks_created_by_other_admins: false
id: 86ef73e5-e360-4e33-abd8-c2da7b11cbd6
max_usage: 1
modified_time: 1727272316
name: USR-test
notify_expiry: false
org_id: 8f6c24d5-b618-4c30-b6ff-b2febc1078ab
passphrase_rules:
alphabets_enabled: true
length: 8
numerics_enabled: true
symbols: ()[]{}_%@#&$
symbols_enabled: true
role: ''
ssid: USR-test
sso:
idp_cert: >-
-----BEGIN CERTIFICATE-----
MIIDqDCCApCgA...-----END CERTIFICATE-----
idp_sign_algo: sha256
idp_sso_url: https://dev-00000000.okta.com/app/dev-00000000/a6b88bec5ab7/sso/saml
issuer: http://www.okta.com/a6b88bec5ab7
nameid_format: email
type: byod
ui_url: https://pskportal.gc1.mist.com/#!byod/a6b88bec-5ab7-41ae-a34c-44ff52a8b81d
vlan_id: 123
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/pskportals/logs:
get:
tags:
- Orgs Psk Portals
summary: listOrgPskPortalLogs
description: List PSK Portal log entries in the organization for the selected time range.
operationId: listOrgPskPortalLogs
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_psk_portal_logs_search'
- description: Paginated response for organization PSK Portal log search results
examples:
- end: 1428954000
limit: 100
results:
- id: 8a3dcaa7-80e3-4bb0-a75b-7bc6322cfd09
message: Rotate PSK test@mist.com
name_id: test@mist.com
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
psk_id: 608fe603-f9f0-4ce9-9473-04ef6c6ea749
psk_name: test@mist.com
pskportal_id: c1742c09-af35-4161-96ef-7dc65c6d5674
timestamp: 1686346104.096
start: 1428939600
total: 135
contentMediaType: application/json
examples:
PSK Portal Logs:
value:
end: 1428954000
limit: 100
results:
- id: 8a3dcaa7-80e3-4bb0-a75b-7bc6322cfd09
message: Rotate PSK test@mist.com
name_id: test@mist.com
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
psk_id: 608fe603-f9f0-4ce9-9473-04ef6c6ea749
psk_name: test@mist.com
pskportal_id: c1742c09-af35-4161-96ef-7dc65c6d5674
timestamp: 1686346104.096
start: 1428939600
total: 135
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_psk_portal_logs_search'
- description: Paginated response for organization PSK Portal log search results
examples:
- end: 1428954000
limit: 100
results:
- id: 8a3dcaa7-80e3-4bb0-a75b-7bc6322cfd09
message: Rotate PSK test@mist.com
name_id: test@mist.com
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
psk_id: 608fe603-f9f0-4ce9-9473-04ef6c6ea749
psk_name: test@mist.com
pskportal_id: c1742c09-af35-4161-96ef-7dc65c6d5674
timestamp: 1686346104.096
start: 1428939600
total: 135
contentMediaType: application/vnd.api+json
examples:
PSK Portal Logs:
value:
end: 1428954000
limit: 100
results:
- id: 8a3dcaa7-80e3-4bb0-a75b-7bc6322cfd09
message: Rotate PSK test@mist.com
name_id: test@mist.com
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
psk_id: 608fe603-f9f0-4ce9-9473-04ef6c6ea749
psk_name: test@mist.com
pskportal_id: c1742c09-af35-4161-96ef-7dc65c6d5674
timestamp: 1686346104.096
start: 1428939600
total: 135
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/pskportals/logs/count:
get:
tags:
- Orgs Psk Portals
summary: countOrgPskPortalLogs
description: Count PSK Portal log entries across the organization, optionally grouped by `distinct` and filtered by time range.
operationId: countOrgPskPortalLogs
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field used to group this count response. enum: `admin_id`, `admin_name`, `psk_id`, `psk_name`, `pskportal_id`, `user_id`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/org_psk_portal_logs_count_distinct'
- description: 'Field used to group this count response. enum: `admin_id`, `admin_name`, `psk_id`, `psk_name`, `pskportal_id`, `user_id`'
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/pskportals/logs/search:
get:
tags:
- Orgs Psk Portals
summary: searchOrgPskPortalLogs
description: Search PSK Portal log entries across the organization with filters for PSK, portal, admin, SSO NameID, and time range.
operationId: searchOrgPskPortalLogs
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: psk_name
in: query
description: Filter PSK portal log results by PSK name
style: form
explode: true
schema:
type: string
- name: psk_id
in: query
description: Filter PSK portal log results by PSK identifier
style: form
explode: true
schema:
type: string
- name: pskportal_id
in: query
description: Filter PSK portal log results by PSK portal identifier
style: form
explode: true
schema:
type: string
- name: id
in: query
description: Filter results by identifier
style: form
explode: true
schema:
type: string
contentEncoding: uuid
- name: admin_name
in: query
description: Filter audit log results by administrator name
style: form
explode: true
schema:
type: string
- name: admin_id
in: query
description: Filter audit log results by administrator identifier
style: form
explode: true
schema:
type: string
- name: name_id
in: query
description: Filter results by name id
style: form
explode: true
schema:
type: string
contentEncoding: uuid
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_psk_portal_logs_search'
- description: Paginated response for organization PSK Portal log search results
examples:
- end: 1428954000
limit: 100
results:
- id: 8a3dcaa7-80e3-4bb0-a75b-7bc6322cfd09
message: Rotate PSK test@mist.com
name_id: test@mist.com
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
psk_id: 608fe603-f9f0-4ce9-9473-04ef6c6ea749
psk_name: test@mist.com
pskportal_id: c1742c09-af35-4161-96ef-7dc65c6d5674
timestamp: 1686346104.096
start: 1428939600
total: 135
contentMediaType: application/json
examples:
PSK Portal Logs:
value:
end: 1428954000
limit: 100
results:
- id: 8a3dcaa7-80e3-4bb0-a75b-7bc6322cfd09
message: Rotate PSK test@mist.com
name_id: test@mist.com
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
psk_id: 608fe603-f9f0-4ce9-9473-04ef6c6ea749
psk_name: test@mist.com
pskportal_id: c1742c09-af35-4161-96ef-7dc65c6d5674
timestamp: 1686346104.096
start: 1428939600
total: 135
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_psk_portal_logs_search'
- description: Paginated response for organization PSK Portal log search results
examples:
- end: 1428954000
limit: 100
results:
- id: 8a3dcaa7-80e3-4bb0-a75b-7bc6322cfd09
message: Rotate PSK test@mist.com
name_id: test@mist.com
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
psk_id: 608fe603-f9f0-4ce9-9473-04ef6c6ea749
psk_name: test@mist.com
pskportal_id: c1742c09-af35-4161-96ef-7dc65c6d5674
timestamp: 1686346104.096
start: 1428939600
total: 135
contentMediaType: application/vnd.api+json
examples:
PSK Portal Logs:
value:
end: 1428954000
limit: 100
results:
- id: 8a3dcaa7-80e3-4bb0-a75b-7bc6322cfd09
message: Rotate PSK test@mist.com
name_id: test@mist.com
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
psk_id: 608fe603-f9f0-4ce9-9473-04ef6c6ea749
psk_name: test@mist.com
pskportal_id: c1742c09-af35-4161-96ef-7dc65c6d5674
timestamp: 1686346104.096
start: 1428939600
total: 135
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/pskportals/{pskportal_id}:
delete:
tags:
- Orgs Psk Portals
summary: deleteOrgPskPortal
description: Delete a PSK Portal configuration by portal ID, removing the self-service entry point for issuing PSKs through that portal.
operationId: deleteOrgPskPortal
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: pskportal_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Orgs Psk Portals
summary: getOrgPskPortal
description: Retrieve PSK Portal configuration details, including SSID, mode, authentication, SSO, passphrase, expiry, notification, and template URLs.
operationId: getOrgPskPortal
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: pskportal_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/psk_portal'
- description: Self-service portal configuration for issuing personal PSKs
examples:
- auth: sso
created_time: 1727272316
expire_time: 262800
expiry_notification_time: 2
hide_psks_created_by_other_admins: false
id: 86ef73e5-e360-4e33-abd8-c2da7b11cbd6
max_usage: 1
modified_time: 1727272316
name: USR-test
notify_expiry: false
org_id: 8f6c24d5-b618-4c30-b6ff-b2febc1078ab
passphrase_rules:
alphabets_enabled: true
length: 8
numerics_enabled: true
symbols: ()[]{}_%@#&$
symbols_enabled: true
role: ''
ssid: USR-test
sso:
idp_cert: >-
-----BEGIN CERTIFICATE-----
MIIDqDCCApCgA...-----END CERTIFICATE-----
idp_sign_algo: sha256
idp_sso_url: https://dev-00000000.okta.com/app/dev-00000000/a6b88bec5ab7/sso/saml
issuer: http://www.okta.com/a6b88bec5ab7
nameid_format: email
type: byod
ui_url: https://pskportal.gc1.mist.com/#!byod/a6b88bec-5ab7-41ae-a34c-44ff52a8b81d
vlan_id: 123
contentMediaType: application/json
examples:
PSK Portal:
value:
auth: sso
created_time: 1727272316
expire_time: 262800
expiry_notification_time: 2
hide_psks_created_by_other_admins: false
id: 86ef73e5-e360-4e33-abd8-c2da7b11cbd6
max_usage: 1
modified_time: 1727272316
name: USR-test
notify_expiry: false
org_id: 8f6c24d5-b618-4c30-b6ff-b2febc1078ab
passphrase_rules:
alphabets_enabled: true
length: 8
numerics_enabled: true
symbols: ()[]{}_%@#&$
symbols_enabled: true
role: ''
ssid: USR-test
sso:
idp_cert: >-
-----BEGIN CERTIFICATE-----
MIIDqDCCApCgA...-----END CERTIFICATE-----
idp_sign_algo: sha256
idp_sso_url: https://dev-00000000.okta.com/app/dev-00000000/a6b88bec5ab7/sso/saml
issuer: http://www.okta.com/a6b88bec5ab7
nameid_format: email
type: byod
ui_url: https://pskportal.gc1.mist.com/#!byod/a6b88bec-5ab7-41ae-a34c-44ff52a8b81d
vlan_id: 123
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/psk_portal'
- description: Self-service portal configuration for issuing personal PSKs
examples:
- auth: sso
created_time: 1727272316
expire_time: 262800
expiry_notification_time: 2
hide_psks_created_by_other_admins: false
id: 86ef73e5-e360-4e33-abd8-c2da7b11cbd6
max_usage: 1
modified_time: 1727272316
name: USR-test
notify_expiry: false
org_id: 8f6c24d5-b618-4c30-b6ff-b2febc1078ab
passphrase_rules:
alphabets_enabled: true
length: 8
numerics_enabled: true
symbols: ()[]{}_%@#&$
symbols_enabled: true
role: ''
ssid: USR-test
sso:
idp_cert: >-
-----BEGIN CERTIFICATE-----
MIIDqDCCApCgA...-----END CERTIFICATE-----
idp_sign_algo: sha256
idp_sso_url: https://dev-00000000.okta.com/app/dev-00000000/a6b88bec5ab7/sso/saml
issuer: http://www.okta.com/a6b88bec5ab7
nameid_format: email
type: byod
ui_url: https://pskportal.gc1.mist.com/#!byod/a6b88bec-5ab7-41ae-a34c-44ff52a8b81d
vlan_id: 123
contentMediaType: application/vnd.api+json
examples:
PSK Portal:
value:
auth: sso
created_time: 1727272316
expire_time: 262800
expiry_notification_time: 2
hide_psks_created_by_other_admins: false
id: 86ef73e5-e360-4e33-abd8-c2da7b11cbd6
max_usage: 1
modified_time: 1727272316
name: USR-test
notify_expiry: false
org_id: 8f6c24d5-b618-4c30-b6ff-b2febc1078ab
passphrase_rules:
alphabets_enabled: true
length: 8
numerics_enabled: true
symbols: ()[]{}_%@#&$
symbols_enabled: true
role: ''
ssid: USR-test
sso:
idp_cert: >-
-----BEGIN CERTIFICATE-----
MIIDqDCCApCgA...-----END CERTIFICATE-----
idp_sign_algo: sha256
idp_sso_url: https://dev-00000000.okta.com/app/dev-00000000/a6b88bec5ab7/sso/saml
issuer: http://www.okta.com/a6b88bec5ab7
nameid_format: email
type: byod
ui_url: https://pskportal.gc1.mist.com/#!byod/a6b88bec-5ab7-41ae-a34c-44ff52a8b81d
vlan_id: 123
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Orgs Psk Portals
summary: updateOrgPskPortal
description: Update a PSK Portal configuration, including SSID, mode, authentication, SSO, passphrase, expiry, notification, and template settings.
operationId: updateOrgPskPortal
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: pskportal_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/psk_portal'
- examples:
- auth: sso
expire_time: 262800
expiry_notification_time: 2
hide_psks_created_by_other_admins: false
max_usage: 1
name: USR-test
notify_expiry: false
passphrase_rules:
alphabets_enabled: true
length: 8
numerics_enabled: true
symbols: ()[]{}_%@#&$
symbols_enabled: true
sponsors:
idp_cert: >-
-----BEGIN CERTIFICATE-----
MIIDqDCCApCgA...-----END CERTIFICATE-----
idp_sign_algo: sha256
idp_sso_url: https://dev-00000000.okta.com/app/dev-00000000/a6b88bec5ab7/sso/saml
issuer: http://www.okta.com/a6b88bec5ab7
nameid_format: email
ssid: USR-test
type: byod
vlan_id: nu42ll
contentMediaType: application/json
examples:
Example:
value:
auth: sso
expire_time: 262800
expiry_notification_time: 2
hide_psks_created_by_other_admins: false
max_usage: 1
name: USR-test
notify_expiry: false
passphrase_rules:
alphabets_enabled: true
length: 8
numerics_enabled: true
symbols: ()[]{}_%@#&$
symbols_enabled: true
sponsors:
idp_cert: >-
-----BEGIN CERTIFICATE-----
MIIDqDCCApCgA...-----END CERTIFICATE-----
idp_sign_algo: sha256
idp_sso_url: https://dev-00000000.okta.com/app/dev-00000000/a6b88bec5ab7/sso/saml
issuer: http://www.okta.com/a6b88bec5ab7
nameid_format: email
ssid: USR-test
type: byod
vlan_id: nu42ll
required: false
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/psk_portal'
- description: Self-service portal configuration for issuing personal PSKs
examples:
- auth: sso
created_time: 1727272316
expire_time: 262800
expiry_notification_time: 2
hide_psks_created_by_other_admins: false
id: 86ef73e5-e360-4e33-abd8-c2da7b11cbd6
max_usage: 1
modified_time: 1727272316
name: USR-test
notify_expiry: false
org_id: 8f6c24d5-b618-4c30-b6ff-b2febc1078ab
passphrase_rules:
alphabets_enabled: true
length: 8
numerics_enabled: true
symbols: ()[]{}_%@#&$
symbols_enabled: true
role: ''
ssid: USR-test
sso:
idp_cert: >-
-----BEGIN CERTIFICATE-----
MIIDqDCCApCgA...-----END CERTIFICATE-----
idp_sign_algo: sha256
idp_sso_url: https://dev-00000000.okta.com/app/dev-00000000/a6b88bec5ab7/sso/saml
issuer: http://www.okta.com/a6b88bec5ab7
nameid_format: email
type: byod
ui_url: https://pskportal.gc1.mist.com/#!byod/a6b88bec-5ab7-41ae-a34c-44ff52a8b81d
vlan_id: 123
contentMediaType: application/json
examples:
PSK Portal:
value:
auth: sso
created_time: 1727272316
expire_time: 262800
expiry_notification_time: 2
hide_psks_created_by_other_admins: false
id: 86ef73e5-e360-4e33-abd8-c2da7b11cbd6
max_usage: 1
modified_time: 1727272316
name: USR-test
notify_expiry: false
org_id: 8f6c24d5-b618-4c30-b6ff-b2febc1078ab
passphrase_rules:
alphabets_enabled: true
length: 8
numerics_enabled: true
symbols: ()[]{}_%@#&$
symbols_enabled: true
role: ''
ssid: USR-test
sso:
idp_cert: >-
-----BEGIN CERTIFICATE-----
MIIDqDCCApCgA...-----END CERTIFICATE-----
idp_sign_algo: sha256
idp_sso_url: https://dev-00000000.okta.com/app/dev-00000000/a6b88bec5ab7/sso/saml
issuer: http://www.okta.com/a6b88bec5ab7
nameid_format: email
type: byod
ui_url: https://pskportal.gc1.mist.com/#!byod/a6b88bec-5ab7-41ae-a34c-44ff52a8b81d
vlan_id: 123
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/psk_portal'
- description: Self-service portal configuration for issuing personal PSKs
examples:
- auth: sso
created_time: 1727272316
expire_time: 262800
expiry_notification_time: 2
hide_psks_created_by_other_admins: false
id: 86ef73e5-e360-4e33-abd8-c2da7b11cbd6
max_usage: 1
modified_time: 1727272316
name: USR-test
notify_expiry: false
org_id: 8f6c24d5-b618-4c30-b6ff-b2febc1078ab
passphrase_rules:
alphabets_enabled: true
length: 8
numerics_enabled: true
symbols: ()[]{}_%@#&$
symbols_enabled: true
role: ''
ssid: USR-test
sso:
idp_cert: >-
-----BEGIN CERTIFICATE-----
MIIDqDCCApCgA...-----END CERTIFICATE-----
idp_sign_algo: sha256
idp_sso_url: https://dev-00000000.okta.com/app/dev-00000000/a6b88bec5ab7/sso/saml
issuer: http://www.okta.com/a6b88bec5ab7
nameid_format: email
type: byod
ui_url: https://pskportal.gc1.mist.com/#!byod/a6b88bec-5ab7-41ae-a34c-44ff52a8b81d
vlan_id: 123
contentMediaType: application/vnd.api+json
examples:
PSK Portal:
value:
auth: sso
created_time: 1727272316
expire_time: 262800
expiry_notification_time: 2
hide_psks_created_by_other_admins: false
id: 86ef73e5-e360-4e33-abd8-c2da7b11cbd6
max_usage: 1
modified_time: 1727272316
name: USR-test
notify_expiry: false
org_id: 8f6c24d5-b618-4c30-b6ff-b2febc1078ab
passphrase_rules:
alphabets_enabled: true
length: 8
numerics_enabled: true
symbols: ()[]{}_%@#&$
symbols_enabled: true
role: ''
ssid: USR-test
sso:
idp_cert: >-
-----BEGIN CERTIFICATE-----
MIIDqDCCApCgA...-----END CERTIFICATE-----
idp_sign_algo: sha256
idp_sso_url: https://dev-00000000.okta.com/app/dev-00000000/a6b88bec5ab7/sso/saml
issuer: http://www.okta.com/a6b88bec5ab7
nameid_format: email
type: byod
ui_url: https://pskportal.gc1.mist.com/#!byod/a6b88bec-5ab7-41ae-a34c-44ff52a8b81d
vlan_id: 123
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/pskportals/{pskportal_id}/portal_image:
delete:
tags:
- Orgs Psk Portals
summary: deleteOrgPskPortalImage
description: Delete the custom background image for a PSK Portal. If no image is configured, the PSK Portal uses the default background image.
operationId: deleteOrgPskPortalImage
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: pskportal_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs Psk Portals
summary: uploadOrgPskPortalImage
description: Upload a custom background image for a PSK Portal.
operationId: uploadOrgPskPortalImage
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: pskportal_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
content:
multipart/form-data:
encoding: {}
schema:
type: object
properties:
file:
type: string
description: Image binary payload to upload for the PSK portal
contentEncoding: base64
json:
type: string
description: Metadata JSON string describing the PSK portal image upload
contentMediaType: multipart/form-data
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/pskportals/{pskportal_id}/portal_template:
put:
tags:
- Orgs Psk Portals
summary: updateOrgPskPortalTemplate
description: Update PSK Portal UI template settings, including alignment, color, logo, Powered by visibility, and Terms of Service text.
operationId: updateOrgPskPortalTemplate
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: pskportal_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/psk_portal_template'
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/exports/e911_report:
delete:
tags:
- Orgs Reports
summary: disableOrgE911Report
description: Disable automatic E911 AP BSSID report generation for the organization.
operationId: disableOrgE911Report
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/org_e911_report'
- description: E911 AP BSSID report status for the organization
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/org_e911_report'
- description: E911 AP BSSID report status for the organization
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Orgs Reports
summary: getOrgE911Report
description: Get the status of E911 AP BSSID reports and download URL if available.
operationId: getOrgE911Report
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/org_e911_report'
- description: E911 AP BSSID report status for the organization
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/org_e911_report'
- description: E911 AP BSSID report status for the organization
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs Reports
summary: enableOrgE911Report
description: Enable automatic E911 AP BSSID report generation for the organization. Reports will be generated immediately and then every 24 hours.
operationId: enableOrgE911Report
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/org_e911_report'
- description: E911 AP BSSID report status for the organization
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/org_e911_report'
- description: E911 AP BSSID report status for the organization
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/rftemplates:
get:
tags:
- Orgs RF Templates
summary: listOrgRfTemplates
description: List organization RF templates used by RRM to apply radio settings across sites.
operationId: listOrgRfTemplates
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/rf_template'
description: List of RF templates
examples:
- - ant_gain_24: 0
ant_gain_5: 0
band_24:
allow_rrm_disable: true
ant_gain: 0
bandwidth: 20
channels:
- 1
- 6
- 11
disabled: false
power_max: 11
power_min: 3
preamble: short
band_24_usage: auto
band_5:
allow_rrm_disable: false
ant_gain: 0
bandwidth: 80
channels:
- 36
- 40
- 44
- 48
- 52
- 56
- 60
- 64
- 100
- 104
- 149
- 153
- 157
- 161
disabled: false
power_max: 16
power_min: 9
preamble: short
country_code: FR
created_time: 1594743723
enable_unii_4: false
id: b3f20330-f76a-49f1-bc65-0d8727140b1d
model_specific: {}
modified_time: 1613582192
name: Lab
org_id: 203d3d02-dbc0-4c1b-9f41-76896a3330f4
contentMediaType: application/json
examples:
Example:
value:
- ant_gain_24: 0
ant_gain_5: 0
band_24:
allow_rrm_disable: true
ant_gain: 0
bandwidth: 20
channels:
- 1
- 6
- 11
disabled: false
power_max: 11
power_min: 3
preamble: short
band_24_usage: auto
band_5:
allow_rrm_disable: false
ant_gain: 0
bandwidth: 80
channels:
- 36
- 40
- 44
- 48
- 52
- 56
- 60
- 64
- 100
- 104
- 149
- 153
- 157
- 161
disabled: false
power_max: 16
power_min: 9
preamble: short
country_code: FR
created_time: 1594743723
enable_unii_4: false
id: b3f20330-f76a-49f1-bc65-0d8727140b1d
model_specific: {}
modified_time: 1613582192
name: Lab
org_id: 203d3d02-dbc0-4c1b-9f41-76896a3330f4
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/rf_template'
description: List of RF templates
examples:
- - ant_gain_24: 0
ant_gain_5: 0
band_24:
allow_rrm_disable: true
ant_gain: 0
bandwidth: 20
channels:
- 1
- 6
- 11
disabled: false
power_max: 11
power_min: 3
preamble: short
band_24_usage: auto
band_5:
allow_rrm_disable: false
ant_gain: 0
bandwidth: 80
channels:
- 36
- 40
- 44
- 48
- 52
- 56
- 60
- 64
- 100
- 104
- 149
- 153
- 157
- 161
disabled: false
power_max: 16
power_min: 9
preamble: short
country_code: FR
created_time: 1594743723
enable_unii_4: false
id: b3f20330-f76a-49f1-bc65-0d8727140b1d
model_specific: {}
modified_time: 1613582192
name: Lab
org_id: 203d3d02-dbc0-4c1b-9f41-76896a3330f4
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- ant_gain_24: 0
ant_gain_5: 0
band_24:
allow_rrm_disable: true
ant_gain: 0
bandwidth: 20
channels:
- 1
- 6
- 11
disabled: false
power_max: 11
power_min: 3
preamble: short
band_24_usage: auto
band_5:
allow_rrm_disable: false
ant_gain: 0
bandwidth: 80
channels:
- 36
- 40
- 44
- 48
- 52
- 56
- 60
- 64
- 100
- 104
- 149
- 153
- 157
- 161
disabled: false
power_max: 16
power_min: 9
preamble: short
country_code: FR
created_time: 1594743723
enable_unii_4: false
id: b3f20330-f76a-49f1-bc65-0d8727140b1d
model_specific: {}
modified_time: 1613582192
name: Lab
org_id: 203d3d02-dbc0-4c1b-9f41-76896a3330f4
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs RF Templates
summary: createOrgRfTemplate
description: >-
Create an organization RF template with 2.4, 5, and 6 GHz radio
settings, country code, scanning behavior, antenna gain, and model-specific
overrides.
To assign a RF template to a site, use the [Update Site]($e/Sites/updateSiteInfo) endpoint and specify the RF template ID in the `rftemplate_id` field of the request body.
operationId: createOrgRfTemplate
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/rf_template'
- description: Request Body
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/rf_template'
- description: RF template used by the current RRM calculation
examples:
- ant_gain_24: 0
ant_gain_5: 0
band_24:
allow_rrm_disable: true
ant_gain: 0
bandwidth: 20
channels:
- 1
- 6
- 11
disabled: false
power_max: 11
power_min: 3
preamble: short
band_24_usage: auto
band_5:
allow_rrm_disable: false
ant_gain: 0
bandwidth: 80
channels:
- 36
- 40
- 44
- 48
- 52
- 56
- 60
- 64
- 100
- 104
- 149
- 153
- 157
- 161
disabled: false
power_max: 16
power_min: 9
preamble: short
country_code: FR
created_time: 1594743723
enable_unii_4: false
id: b3f20330-f76a-49f1-bc65-0d8727140b1d
model_specific: {}
modified_time: 1613582192
name: Lab
org_id: 203d3d02-dbc0-4c1b-9f41-76896a3330f4
contentMediaType: application/json
examples:
Example:
value:
ant_gain_24: 0
ant_gain_5: 0
band_24:
allow_rrm_disable: true
ant_gain: 0
bandwidth: 20
channels:
- 1
- 6
- 11
disabled: false
power_max: 11
power_min: 3
preamble: short
band_24_usage: auto
band_5:
allow_rrm_disable: false
ant_gain: 0
bandwidth: 80
channels:
- 36
- 40
- 44
- 48
- 52
- 56
- 60
- 64
- 100
- 104
- 149
- 153
- 157
- 161
disabled: false
power_max: 16
power_min: 9
preamble: short
country_code: FR
created_time: 1594743723
enable_unii_4: false
id: b3f20330-f76a-49f1-bc65-0d8727140b1d
model_specific: {}
modified_time: 1613582192
name: Lab
org_id: 203d3d02-dbc0-4c1b-9f41-76896a3330f4
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/rf_template'
- description: RF template used by the current RRM calculation
examples:
- ant_gain_24: 0
ant_gain_5: 0
band_24:
allow_rrm_disable: true
ant_gain: 0
bandwidth: 20
channels:
- 1
- 6
- 11
disabled: false
power_max: 11
power_min: 3
preamble: short
band_24_usage: auto
band_5:
allow_rrm_disable: false
ant_gain: 0
bandwidth: 80
channels:
- 36
- 40
- 44
- 48
- 52
- 56
- 60
- 64
- 100
- 104
- 149
- 153
- 157
- 161
disabled: false
power_max: 16
power_min: 9
preamble: short
country_code: FR
created_time: 1594743723
enable_unii_4: false
id: b3f20330-f76a-49f1-bc65-0d8727140b1d
model_specific: {}
modified_time: 1613582192
name: Lab
org_id: 203d3d02-dbc0-4c1b-9f41-76896a3330f4
contentMediaType: application/vnd.api+json
examples:
Example:
value:
ant_gain_24: 0
ant_gain_5: 0
band_24:
allow_rrm_disable: true
ant_gain: 0
bandwidth: 20
channels:
- 1
- 6
- 11
disabled: false
power_max: 11
power_min: 3
preamble: short
band_24_usage: auto
band_5:
allow_rrm_disable: false
ant_gain: 0
bandwidth: 80
channels:
- 36
- 40
- 44
- 48
- 52
- 56
- 60
- 64
- 100
- 104
- 149
- 153
- 157
- 161
disabled: false
power_max: 16
power_min: 9
preamble: short
country_code: FR
created_time: 1594743723
enable_unii_4: false
id: b3f20330-f76a-49f1-bc65-0d8727140b1d
model_specific: {}
modified_time: 1613582192
name: Lab
org_id: 203d3d02-dbc0-4c1b-9f41-76896a3330f4
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/rftemplates/{rftemplate_id}:
delete:
tags:
- Orgs RF Templates
summary: deleteOrgRfTemplate
description: Delete an organization RF template by template ID so it can no longer be applied to sites.
operationId: deleteOrgRfTemplate
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: rftemplate_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Orgs RF Templates
summary: getOrgRfTemplate
description: Retrieve details for a specific organization RF template, including radio settings, country code, scanning behavior, antenna gain, and model-specific overrides.
operationId: getOrgRfTemplate
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: rftemplate_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/rf_template'
- description: RF template used by the current RRM calculation
examples:
- ant_gain_24: 0
ant_gain_5: 0
band_24:
allow_rrm_disable: true
ant_gain: 0
bandwidth: 20
channels:
- 1
- 6
- 11
disabled: false
power_max: 11
power_min: 3
preamble: short
band_24_usage: auto
band_5:
allow_rrm_disable: false
ant_gain: 0
bandwidth: 80
channels:
- 36
- 40
- 44
- 48
- 52
- 56
- 60
- 64
- 100
- 104
- 149
- 153
- 157
- 161
disabled: false
power_max: 16
power_min: 9
preamble: short
country_code: FR
created_time: 1594743723
enable_unii_4: false
id: b3f20330-f76a-49f1-bc65-0d8727140b1d
model_specific: {}
modified_time: 1613582192
name: Lab
org_id: 203d3d02-dbc0-4c1b-9f41-76896a3330f4
contentMediaType: application/json
examples:
Example:
value:
ant_gain_24: 0
ant_gain_5: 0
band_24:
allow_rrm_disable: true
ant_gain: 0
bandwidth: 20
channels:
- 1
- 6
- 11
disabled: false
power_max: 11
power_min: 3
preamble: short
band_24_usage: auto
band_5:
allow_rrm_disable: false
ant_gain: 0
bandwidth: 80
channels:
- 36
- 40
- 44
- 48
- 52
- 56
- 60
- 64
- 100
- 104
- 149
- 153
- 157
- 161
disabled: false
power_max: 16
power_min: 9
preamble: short
country_code: FR
created_time: 1594743723
enable_unii_4: false
id: b3f20330-f76a-49f1-bc65-0d8727140b1d
model_specific: {}
modified_time: 1613582192
name: Lab
org_id: 203d3d02-dbc0-4c1b-9f41-76896a3330f4
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/rf_template'
- description: RF template used by the current RRM calculation
examples:
- ant_gain_24: 0
ant_gain_5: 0
band_24:
allow_rrm_disable: true
ant_gain: 0
bandwidth: 20
channels:
- 1
- 6
- 11
disabled: false
power_max: 11
power_min: 3
preamble: short
band_24_usage: auto
band_5:
allow_rrm_disable: false
ant_gain: 0
bandwidth: 80
channels:
- 36
- 40
- 44
- 48
- 52
- 56
- 60
- 64
- 100
- 104
- 149
- 153
- 157
- 161
disabled: false
power_max: 16
power_min: 9
preamble: short
country_code: FR
created_time: 1594743723
enable_unii_4: false
id: b3f20330-f76a-49f1-bc65-0d8727140b1d
model_specific: {}
modified_time: 1613582192
name: Lab
org_id: 203d3d02-dbc0-4c1b-9f41-76896a3330f4
contentMediaType: application/vnd.api+json
examples:
Example:
value:
ant_gain_24: 0
ant_gain_5: 0
band_24:
allow_rrm_disable: true
ant_gain: 0
bandwidth: 20
channels:
- 1
- 6
- 11
disabled: false
power_max: 11
power_min: 3
preamble: short
band_24_usage: auto
band_5:
allow_rrm_disable: false
ant_gain: 0
bandwidth: 80
channels:
- 36
- 40
- 44
- 48
- 52
- 56
- 60
- 64
- 100
- 104
- 149
- 153
- 157
- 161
disabled: false
power_max: 16
power_min: 9
preamble: short
country_code: FR
created_time: 1594743723
enable_unii_4: false
id: b3f20330-f76a-49f1-bc65-0d8727140b1d
model_specific: {}
modified_time: 1613582192
name: Lab
org_id: 203d3d02-dbc0-4c1b-9f41-76896a3330f4
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Orgs RF Templates
summary: updateOrgRfTemplate
description: Update an organization RF template, including radio settings, country code, scanning behavior, antenna gain, and model-specific overrides.
operationId: updateOrgRfTemplate
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: rftemplate_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/rf_template'
- description: Request Body
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/rf_template'
- description: RF template used by the current RRM calculation
examples:
- ant_gain_24: 0
ant_gain_5: 0
band_24:
allow_rrm_disable: true
ant_gain: 0
bandwidth: 20
channels:
- 1
- 6
- 11
disabled: false
power_max: 11
power_min: 3
preamble: short
band_24_usage: auto
band_5:
allow_rrm_disable: false
ant_gain: 0
bandwidth: 80
channels:
- 36
- 40
- 44
- 48
- 52
- 56
- 60
- 64
- 100
- 104
- 149
- 153
- 157
- 161
disabled: false
power_max: 16
power_min: 9
preamble: short
country_code: FR
created_time: 1594743723
enable_unii_4: false
id: b3f20330-f76a-49f1-bc65-0d8727140b1d
model_specific: {}
modified_time: 1613582192
name: Lab
org_id: 203d3d02-dbc0-4c1b-9f41-76896a3330f4
contentMediaType: application/json
examples:
Example:
value:
ant_gain_24: 0
ant_gain_5: 0
band_24:
allow_rrm_disable: true
ant_gain: 0
bandwidth: 20
channels:
- 1
- 6
- 11
disabled: false
power_max: 11
power_min: 3
preamble: short
band_24_usage: auto
band_5:
allow_rrm_disable: false
ant_gain: 0
bandwidth: 80
channels:
- 36
- 40
- 44
- 48
- 52
- 56
- 60
- 64
- 100
- 104
- 149
- 153
- 157
- 161
disabled: false
power_max: 16
power_min: 9
preamble: short
country_code: FR
created_time: 1594743723
enable_unii_4: false
id: b3f20330-f76a-49f1-bc65-0d8727140b1d
model_specific: {}
modified_time: 1613582192
name: Lab
org_id: 203d3d02-dbc0-4c1b-9f41-76896a3330f4
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/rf_template'
- description: RF template used by the current RRM calculation
examples:
- ant_gain_24: 0
ant_gain_5: 0
band_24:
allow_rrm_disable: true
ant_gain: 0
bandwidth: 20
channels:
- 1
- 6
- 11
disabled: false
power_max: 11
power_min: 3
preamble: short
band_24_usage: auto
band_5:
allow_rrm_disable: false
ant_gain: 0
bandwidth: 80
channels:
- 36
- 40
- 44
- 48
- 52
- 56
- 60
- 64
- 100
- 104
- 149
- 153
- 157
- 161
disabled: false
power_max: 16
power_min: 9
preamble: short
country_code: FR
created_time: 1594743723
enable_unii_4: false
id: b3f20330-f76a-49f1-bc65-0d8727140b1d
model_specific: {}
modified_time: 1613582192
name: Lab
org_id: 203d3d02-dbc0-4c1b-9f41-76896a3330f4
contentMediaType: application/vnd.api+json
examples:
Example:
value:
ant_gain_24: 0
ant_gain_5: 0
band_24:
allow_rrm_disable: true
ant_gain: 0
bandwidth: 20
channels:
- 1
- 6
- 11
disabled: false
power_max: 11
power_min: 3
preamble: short
band_24_usage: auto
band_5:
allow_rrm_disable: false
ant_gain: 0
bandwidth: 80
channels:
- 36
- 40
- 44
- 48
- 52
- 56
- 60
- 64
- 100
- 104
- 149
- 153
- 157
- 161
disabled: false
power_max: 16
power_min: 9
preamble: short
country_code: FR
created_time: 1594743723
enable_unii_4: false
id: b3f20330-f76a-49f1-bc65-0d8727140b1d
model_specific: {}
modified_time: 1613582192
name: Lab
org_id: 203d3d02-dbc0-4c1b-9f41-76896a3330f4
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/mobile/verify/{secret}:
post:
tags:
- Orgs SDK Invites
summary: activateSdkInvite
description: Activate a mobile SDK invite by verifying the invite secret and binding it to the supplied device identifier. The response returns the device-specific secret used by the mobile SDK client.
operationId: activateSdkInvite
parameters:
- name: secret
in: path
description: ''
required: true
schema:
type: string
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/device_id_string'
- examples:
- device_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/json
examples:
Example:
value:
device_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_mobile_verify_secret'
- description: Mobile SDK invite verification response
examples:
- name: Macy's
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
secret: device-specific-secret
contentMediaType: application/json
examples:
Example:
value:
name: Macy's
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
secret: device-specific-secret
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_mobile_verify_secret'
- description: Mobile SDK invite verification response
examples:
- name: Macy's
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
secret: device-specific-secret
contentMediaType: application/vnd.api+json
examples:
Example:
value:
name: Macy's
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
secret: device-specific-secret
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/sdkinvites:
get:
tags:
- Orgs SDK Invites
summary: listSdkInvites
description: List SDK invites configured for the organization. SDK invites are used to onboard mobile SDK clients and can define whether an invite is enabled, limited by usage quota, or scoped to a site.
operationId: listSdkInvites
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/sdkinvite'
description: SDK invite configurations returned by list operations
examples:
- - created_time: 1428954000
enabled: true
expire_time: 1428954000
id: 5034b980-b49e-501c-66e0-9de4c38f18a2
name: Macy's
quota: -1
contentMediaType: application/json
examples:
Example:
value:
- created_time: 1428954000
enabled: true
expire_time: 1428954000
id: 5034b980-b49e-501c-66e0-9de4c38f18a2
name: Macy's
quota: -1
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/sdkinvite'
description: SDK invite configurations returned by list operations
examples:
- - created_time: 1428954000
enabled: true
expire_time: 1428954000
id: 5034b980-b49e-501c-66e0-9de4c38f18a2
name: Macy's
quota: -1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- created_time: 1428954000
enabled: true
expire_time: 1428954000
id: 5034b980-b49e-501c-66e0-9de4c38f18a2
name: Macy's
quota: -1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs SDK Invites
summary: createSdkInvite
description: Create an SDK invite that mobile SDK clients can use to onboard into the organization. The invite can be enabled or disabled, limited by usage quota, and associated with a site.
operationId: createSdkInvite
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sdkinvite'
- description: Request Body
examples:
- enabled: true
name: string
quota: 0
quota_limited: true
contentMediaType: application/json
examples:
Example:
value:
enabled: true
name: string
quota: 0
quota_limited: true
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sdkinvite'
- description: SDK invite configuration used to onboard mobile SDK clients to an organization
examples:
- created_time: 1428954000
enabled: true
expire_time: 1428954000
id: 5034b980-b49e-501c-66e0-9de4c38f18a2
name: Macy's
quota: -1
contentMediaType: application/json
examples:
Example:
value:
created_time: 1428954000
enabled: true
expire_time: 1428954000
id: 5034b980-b49e-501c-66e0-9de4c38f18a2
name: Macy's
quota: -1
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/sdkinvite'
- description: SDK invite configuration used to onboard mobile SDK clients to an organization
examples:
- created_time: 1428954000
enabled: true
expire_time: 1428954000
id: 5034b980-b49e-501c-66e0-9de4c38f18a2
name: Macy's
quota: -1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 1428954000
enabled: true
expire_time: 1428954000
id: 5034b980-b49e-501c-66e0-9de4c38f18a2
name: Macy's
quota: -1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/sdkinvites/{sdkinvite_id}:
delete:
tags:
- Orgs SDK Invites
summary: revokeSdkInvite
description: Revoke an SDK invite so it can no longer be used for mobile SDK client onboarding.
operationId: revokeSdkInvite
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: sdkinvite_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Orgs SDK Invites
summary: getSdkInvite
description: Return the configuration and status of an SDK invite, including enablement, expiration time, usage quota, and site scope.
operationId: getSdkInvite
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: sdkinvite_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sdkinvite'
- description: SDK invite configuration used to onboard mobile SDK clients to an organization
examples:
- created_time: 1428954000
enabled: true
expire_time: 1428954000
id: 5034b980-b49e-501c-66e0-9de4c38f18a2
name: Macy's
quota: -1
contentMediaType: application/json
examples:
Example:
value:
created_time: 1428954000
enabled: true
expire_time: 1428954000
id: 5034b980-b49e-501c-66e0-9de4c38f18a2
name: Macy's
quota: -1
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/sdkinvite'
- description: SDK invite configuration used to onboard mobile SDK clients to an organization
examples:
- created_time: 1428954000
enabled: true
expire_time: 1428954000
id: 5034b980-b49e-501c-66e0-9de4c38f18a2
name: Macy's
quota: -1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 1428954000
enabled: true
expire_time: 1428954000
id: 5034b980-b49e-501c-66e0-9de4c38f18a2
name: Macy's
quota: -1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Orgs SDK Invites
summary: updateSdkInvite
description: Update an SDK invite's onboarding settings, such as its display name, enabled state, expiration time, quota, or site association.
operationId: updateSdkInvite
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: sdkinvite_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sdkinvite'
- description: Request Body
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sdkinvite'
- description: SDK invite configuration used to onboard mobile SDK clients to an organization
examples:
- created_time: 1428954000
enabled: true
expire_time: 1428954000
id: 5034b980-b49e-501c-66e0-9de4c38f18a2
name: Macy's
quota: -1
contentMediaType: application/json
examples:
Example:
value:
created_time: 1428954000
enabled: true
expire_time: 1428954000
id: 5034b980-b49e-501c-66e0-9de4c38f18a2
name: Macy's
quota: -1
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/sdkinvite'
- description: SDK invite configuration used to onboard mobile SDK clients to an organization
examples:
- created_time: 1428954000
enabled: true
expire_time: 1428954000
id: 5034b980-b49e-501c-66e0-9de4c38f18a2
name: Macy's
quota: -1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 1428954000
enabled: true
expire_time: 1428954000
id: 5034b980-b49e-501c-66e0-9de4c38f18a2
name: Macy's
quota: -1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/sdkinvites/{sdkinvite_id}/email:
post:
tags:
- Orgs SDK Invites
summary: sendSdkInviteEmail
description: Send the SDK invite to a recipient email address so the recipient can onboard a mobile SDK client.
operationId: sendSdkInviteEmail
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: sdkinvite_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/email_string'
- description: Request Body
examples:
- email: test@abc.com
contentMediaType: application/json
examples:
Example:
value:
email: test@abc.com
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/sdkinvites/{sdkinvite_id}/qrcode:
get:
tags:
- Orgs SDK Invites
summary: getSdkInviteQrCode
description: Download a QR code image for the SDK invite so it can be scanned by a mobile SDK client during onboarding.
operationId: getSdkInviteQrCode
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: sdkinvite_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: string
description: File
contentEncoding: base64
contentMediaType: application/json
application/vnd.api+json:
schema:
type: string
description: File
contentEncoding: base64
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/sdkinvites/{sdkinvite_id}/sms:
post:
tags:
- Orgs SDK Invites
summary: sendSdkInviteSms
description: Send the SDK invite to a phone number by SMS so the recipient can onboard a mobile SDK client.
operationId: sendSdkInviteSms
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: sdkinvite_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sdk_invite_sms'
- description: Request Body
examples:
- number: '14081234567'
contentMediaType: application/json
examples:
Example:
value:
number: '14081234567'
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/sdktemplates:
get:
tags:
- Orgs SDK Templates
summary: listSdkTemplates
description: List SDK templates configured for the organization. SDK templates define visual customization for the mobile SDK experience, including branding images, colors, header text, and welcome messages.
operationId: listSdkTemplates
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/sdktemplate'
description: SDK visual customization templates returned by list operations
examples:
- - bg_image: https://p.imgci.com/db/PICTURES/CMS/227700/227791.4.jpg
btn_flr_bgcolor: '#282828'
default: true
header_txt: Mist
name: default
search_txtcolor: '#282828'
welcome_msg: Welcome to Mist
contentMediaType: application/json
examples:
Example:
value:
- bg_image: https://p.imgci.com/db/PICTURES/CMS/227700/227791.4.jpg
btn_flr_bgcolor: '#282828'
default: true
header_txt: Mist
name: default
search_txtcolor: '#282828'
welcome_msg: Welcome to Mist
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/sdktemplate'
description: SDK visual customization templates returned by list operations
examples:
- - bg_image: https://p.imgci.com/db/PICTURES/CMS/227700/227791.4.jpg
btn_flr_bgcolor: '#282828'
default: true
header_txt: Mist
name: default
search_txtcolor: '#282828'
welcome_msg: Welcome to Mist
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- bg_image: https://p.imgci.com/db/PICTURES/CMS/227700/227791.4.jpg
btn_flr_bgcolor: '#282828'
default: true
header_txt: Mist
name: default
search_txtcolor: '#282828'
welcome_msg: Welcome to Mist
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs SDK Templates
summary: createSdkTemplate
description: Create an SDK template that defines visual customization for the mobile SDK experience, including branding images, colors, header text, and welcome messages.
operationId: createSdkTemplate
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sdktemplate'
- description: Request Body
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sdktemplate'
- description: Visual customization template for the mobile SDK experience
examples:
- bg_image: https://p.imgci.com/db/PICTURES/CMS/227700/227791.4.jpg
btn_flr_bgcolor: '#282828'
default: true
header_txt: Mist
name: default
search_txtcolor: '#282828'
welcome_msg: Welcome to Mist
contentMediaType: application/json
examples:
Example:
value:
bg_image: https://p.imgci.com/db/PICTURES/CMS/227700/227791.4.jpg
btn_flr_bgcolor: '#282828'
default: true
header_txt: Mist
name: default
search_txtcolor: '#282828'
welcome_msg: Welcome to Mist
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/sdktemplate'
- description: Visual customization template for the mobile SDK experience
examples:
- bg_image: https://p.imgci.com/db/PICTURES/CMS/227700/227791.4.jpg
btn_flr_bgcolor: '#282828'
default: true
header_txt: Mist
name: default
search_txtcolor: '#282828'
welcome_msg: Welcome to Mist
contentMediaType: application/vnd.api+json
examples:
Example:
value:
bg_image: https://p.imgci.com/db/PICTURES/CMS/227700/227791.4.jpg
btn_flr_bgcolor: '#282828'
default: true
header_txt: Mist
name: default
search_txtcolor: '#282828'
welcome_msg: Welcome to Mist
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/sdktemplates/{sdktemplate_id}:
delete:
tags:
- Orgs SDK Templates
summary: deleteSdkTemplate
description: Delete an SDK visual customization template from the organization.
operationId: deleteSdkTemplate
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: sdktemplate_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Orgs SDK Templates
summary: getSdkTemplate
description: Return the visual customization settings for an SDK template, including branding text, image URLs, colors, default state, and site scope.
operationId: getSdkTemplate
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: sdktemplate_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sdktemplate'
- description: Visual customization template for the mobile SDK experience
examples:
- bg_image: https://p.imgci.com/db/PICTURES/CMS/227700/227791.4.jpg
btn_flr_bgcolor: '#282828'
default: true
header_txt: Mist
name: default
search_txtcolor: '#282828'
welcome_msg: Welcome to Mist
contentMediaType: application/json
examples:
Example:
value:
bg_image: https://p.imgci.com/db/PICTURES/CMS/227700/227791.4.jpg
btn_flr_bgcolor: '#282828'
default: true
header_txt: Mist
name: default
search_txtcolor: '#282828'
welcome_msg: Welcome to Mist
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/sdktemplate'
- description: Visual customization template for the mobile SDK experience
examples:
- bg_image: https://p.imgci.com/db/PICTURES/CMS/227700/227791.4.jpg
btn_flr_bgcolor: '#282828'
default: true
header_txt: Mist
name: default
search_txtcolor: '#282828'
welcome_msg: Welcome to Mist
contentMediaType: application/vnd.api+json
examples:
Example:
value:
bg_image: https://p.imgci.com/db/PICTURES/CMS/227700/227791.4.jpg
btn_flr_bgcolor: '#282828'
default: true
header_txt: Mist
name: default
search_txtcolor: '#282828'
welcome_msg: Welcome to Mist
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Orgs SDK Templates
summary: updateSdkTemplate
description: Update an SDK template's visual customization settings, such as branding images, colors, header text, welcome message, default state, or site association.
operationId: updateSdkTemplate
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: sdktemplate_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sdktemplate'
- description: Request Body
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sdktemplate'
- description: Visual customization template for the mobile SDK experience
examples:
- bg_image: https://p.imgci.com/db/PICTURES/CMS/227700/227791.4.jpg
btn_flr_bgcolor: '#282828'
default: true
header_txt: Mist
name: default
search_txtcolor: '#282828'
welcome_msg: Welcome to Mist
contentMediaType: application/json
examples:
Example:
value:
bg_image: https://p.imgci.com/db/PICTURES/CMS/227700/227791.4.jpg
btn_flr_bgcolor: '#282828'
default: true
header_txt: Mist
name: default
search_txtcolor: '#282828'
welcome_msg: Welcome to Mist
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/sdktemplate'
- description: Visual customization template for the mobile SDK experience
examples:
- bg_image: https://p.imgci.com/db/PICTURES/CMS/227700/227791.4.jpg
btn_flr_bgcolor: '#282828'
default: true
header_txt: Mist
name: default
search_txtcolor: '#282828'
welcome_msg: Welcome to Mist
contentMediaType: application/vnd.api+json
examples:
Example:
value:
bg_image: https://p.imgci.com/db/PICTURES/CMS/227700/227791.4.jpg
btn_flr_bgcolor: '#282828'
default: true
header_txt: Mist
name: default
search_txtcolor: '#282828'
welcome_msg: Welcome to Mist
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/secpolicies:
get:
tags:
- Orgs Security Policies
summary: listOrgSecPolicies
description: List organization security policies. Security policies define WLAN configuration baselines used to audit intended wireless settings against actual AP configuration.
operationId: listOrgSecPolicies
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/secpolicy'
description: Security policies returned by list operations
examples:
- - name: corporate only
wlans:
- auth:
pairwise:
- wpa1-tkip
- wpa2-tkip
type: psk
band: both
ssid: office
- auth:
type: open
band: '5'
ssid: office-guest
contentMediaType: application/json
examples:
Example:
value:
- name: corporate only
wlans:
- auth:
pairwise:
- wpa1-tkip
- wpa2-tkip
type: psk
band: both
ssid: office
- auth:
type: open
band: '5'
ssid: office-guest
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/secpolicy'
description: Security policies returned by list operations
examples:
- - name: corporate only
wlans:
- auth:
pairwise:
- wpa1-tkip
- wpa2-tkip
type: psk
band: both
ssid: office
- auth:
type: open
band: '5'
ssid: office-guest
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- name: corporate only
wlans:
- auth:
pairwise:
- wpa1-tkip
- wpa2-tkip
type: psk
band: both
ssid: office
- auth:
type: open
band: '5'
ssid: office-guest
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs Security Policies
summary: createOrgSecPolicy
description: Create an organization security policy containing WLAN configuration baselines for auditing site and AP configuration compliance.
operationId: createOrgSecPolicy
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/secpolicy'
- examples:
- name: string
wlans:
- acct_immediate_update: false
acct_interim_interval: 0
acct_servers:
- host: 1.2.3.4
keywrap_enabled: true
keywrap_format: hex
keywrap_kek: '1122334455'
keywrap_mack: '1122334455'
port: 1813
secret: testing123
allow_ipv6_ndp: true
allow_mdns: false
allow_ssdp: false
app_limit:
apps:
dropbox: 300
netflix: 60
enabled: false
wxtag_ids:
f99862d9-2726-931f-7559-3dfdf5d070d3: 30
app_qos:
apps:
skype-business-video:
dscp: 32
dst_subnet: 10.2.0.0/16
src_subnet: 10.2.0.0/16
enabled: true
others:
- dscp: 32
dst_subnet: 10.2.0.0/16
port_ranges: 80,1024-6553
protocol: udp
src_subnet: 10.2.0.0/16
arp_filter: false
auth:
anticlog_threshold: 16
eap_reauth: false
enable_mac_auth: false
key_idx: 1
keys:
- string
multi_psk_only: false
pairwise:
- wpa2-ccmp
private_wlan: true
psk: foryoureyesonly
type: psk
wep_as_secondary_auth: true
auth_server_selection: ordered
auth_servers:
- host: 1.2.3.4
keywrap_enabled: true
keywrap_format: hex
keywrap_kek: '1122334455'
keywrap_mack: '1122334455'
port: 1812
secret: testing123
auth_servers_nas_id: 5c5b350e0101-nas
auth_servers_nas_ip: 15.3.1.5
auth_servers_retries: 5
auth_servers_timeout: 5
band: string
band_steer: false
band_steer_force_band5: false
bands:
- '24'
- '5'
block_blacklist_clients: false
bonjour:
additional_vlan_ids: 10,20
enabled: false
services:
airplay:
radius_groups:
- teachers
scope: same_ap
cisco_cwa:
allowed_hostnames:
- snapchat.com
allowed_subnets:
- 63.5.3.0/24
blocked_subnets:
- 192.168.0.0/16
enabled: false
client_limit_down: 1000
client_limit_down_enabled: false
client_limit_up: 512
client_limit_up_enabled: false
coa_servers:
- disable_event_timestamp_check: false
enabled: false
ip: 1.2.3.4
port: 3799
secret: testing456
disable_11ax: false
disable_ht_vht_rates: false
disable_uapsd: false
disable_v1_roam_notify: false
disable_v2_roam_notify: false
disable_wmm: false
dns_server_rewrite:
enabled: false
radius_groups:
contractor: 172.1.1.1
guest: 8.8.8.8
dtim: 2
dynamic_psk:
default_psk: foryoureyesonly
default_vlan_id: 999
enabled: false
source: cloud_psks
dynamic_vlan:
default_vlan_id: 999
enabled: false
local_vlan_ids:
- 1
type: airespace-interface-name
vlans:
'131': default
'322': fast,video
enable_local_keycaching: false
enable_wireless_bridging: false
enabled: true
fast_dot1x_timers: false
hide_ssid: false
hostname_ie: false
hotspot20:
domain_name:
- mist.com
enabled: true
nai_realms:
- string
operators:
- google
- att
rcoi:
- 5A03BA0000
venue_name: some_name
interface: all
isolation: false
l2_isolation: false
legacy_overds: false
limit_bcast: false
limit_probe_response: true
max_idletime: 1800
mist_nac:
enabled: false
no_static_dns: false
no_static_ip: false
portal:
amazon_client_id: string
amazon_client_secret: string
amazon_email_domains:
- string
amazon_enabled: false
auth: none
azure_client_id: string
azure_client_secret: string
azure_enabled: false
azure_tenant_id: string
broadnet_password: password
broadnet_sid: MIST
broadnet_user_id: juniper
bypass_when_cloud_down: false
clickatell_api_key: string
cross_site: false
email_enabled: true
enabled: false
expire: 1440
external_portal_url: string
facebook_client_id: string
facebook_client_secret: string
facebook_email_domains:
- string
facebook_enabled: false
forward: false
forward_url: https://abc.com/promotions
google_client_id: string
google_client_secret: string
google_email_domains:
- mydomain.edu
- mydomain.org
google_enabled: false
gupshup_password: string
gupshup_userid: string
microsoft_client_id: string
microsoft_client_secret: string
microsoft_email_domains:
- string
microsoft_enabled: false
passphrase_enabled: false
password: let me in
predefined_sponsors_enabled: true
privacy: true
puzzel_password: string
puzzel_service_id: string
puzzel_username: string
smsMessageFormat: string
sms_enabled: false
sms_provider: twilio
sponsor_auto_approve: false
sponsor_email_domains:
- reserved.net
- reserved.org
sponsor_enabled: false
sponsor_link_validity_duration: '30'
sponsor_notify_all: false
sponsor_status_notify: false
sponsors:
sponsor1@company.com: FirstName1 LastName1
sponsor2@company.com: FirstName2 LastName2
sso_default_role: string
sso_forced_role: string
sso_idp_cert: string
sso_idp_sign_algo: sha256
sso_idp_sso_url: string
sso_issuer: string
sso_nameid_format: email
telstra_client_id: string
telstra_client_secret: string
twilio_auth_token: af9dac44c344a875ab5d31cb7abcdefg
twilio_phone_number: '+18548888888'
twilio_sid: AC72ec6ba0ec5af30e6731c5e47abcdefgh
portal_allowed_hostnames:
- snapchat.com
- ibm.com
portal_allowed_subnets:
- 63.5.3.0/24
portal_denied_hostnames:
- msg.snapchat.com
qos:
class: best_effort
overwrite: false
radsec:
enabled: true
idle_timeout: 60
mxcluster_ids:
- 572586b7-f97b-a22b-526c-8b97a3f609c4
proxy_hosts:
- mxedge1.local
server_name: radsec.abc.com
servers:
- host: 1.1.1.1
port: 1812
use_mxedge: true
use_site_mxedge: false
rateset:
'24':
ht: 00ff00ff00ff
legacy:
- '6'
- '9'
- '12'
- '18'
- 24b
- '36'
- '48'
- '54'
min_rssi: -70
template: custom
vht: 03ff03ff03ff01ff
'5':
ht: 00ff00ff00ff
legacy:
- '6'
- '9'
- '12'
- '18'
- 24b
- '36'
- '48'
- '54'
min_rssi: -70
template: custom
vht: 03ff03ff03ff01ff
roam_mode: NONE
schedule:
enabled: false
hours:
fri: 09:00-17:00
mon: 09:00-17:00
sle_excluded: false
ssid: corporate
use_eapol_v1: false
vlan_enabled: false
vlan_ids:
- 3
- 4
- 5
vlan_pooling: false
wxtag_ids:
- 497f6eca-6276-4993-bfeb-53e4bbba6f08
wxtunnel_id: string
wxtunnel_remote_id: string
contentMediaType: application/json
examples:
Example:
value:
name: string
wlans:
- acct_immediate_update: false
acct_interim_interval: 0
acct_servers:
- host: 1.2.3.4
keywrap_enabled: true
keywrap_format: hex
keywrap_kek: '1122334455'
keywrap_mack: '1122334455'
port: 1813
secret: testing123
allow_ipv6_ndp: true
allow_mdns: false
allow_ssdp: false
app_limit:
apps:
dropbox: 300
netflix: 60
enabled: false
wxtag_ids:
f99862d9-2726-931f-7559-3dfdf5d070d3: 30
app_qos:
apps:
skype-business-video:
dscp: 32
dst_subnet: 10.2.0.0/16
src_subnet: 10.2.0.0/16
enabled: true
others:
- dscp: 32
dst_subnet: 10.2.0.0/16
port_ranges: 80,1024-6553
protocol: udp
src_subnet: 10.2.0.0/16
arp_filter: false
auth:
anticlog_threshold: 16
eap_reauth: false
enable_mac_auth: false
key_idx: 1
keys:
- string
multi_psk_only: false
pairwise:
- wpa2-ccmp
private_wlan: true
psk: foryoureyesonly
type: psk
wep_as_secondary_auth: true
auth_server_selection: ordered
auth_servers:
- host: 1.2.3.4
keywrap_enabled: true
keywrap_format: hex
keywrap_kek: '1122334455'
keywrap_mack: '1122334455'
port: 1812
secret: testing123
auth_servers_nas_id: 5c5b350e0101-nas
auth_servers_nas_ip: 15.3.1.5
auth_servers_retries: 5
auth_servers_timeout: 5
band: string
band_steer: false
band_steer_force_band5: false
bands:
- '24'
- '5'
block_blacklist_clients: false
bonjour:
additional_vlan_ids: 10,20
enabled: false
services:
airplay:
radius_groups:
- teachers
scope: same_ap
cisco_cwa:
allowed_hostnames:
- snapchat.com
allowed_subnets:
- 63.5.3.0/24
blocked_subnets:
- 192.168.0.0/16
enabled: false
client_limit_down: 1000
client_limit_down_enabled: false
client_limit_up: 512
client_limit_up_enabled: false
coa_servers:
- disable_event_timestamp_check: false
enabled: false
ip: 1.2.3.4
port: 3799
secret: testing456
disable_11ax: false
disable_ht_vht_rates: false
disable_uapsd: false
disable_v1_roam_notify: false
disable_v2_roam_notify: false
disable_wmm: false
dns_server_rewrite:
enabled: false
radius_groups:
contractor: 172.1.1.1
guest: 8.8.8.8
dtim: 2
dynamic_psk:
default_psk: foryoureyesonly
default_vlan_id: 999
enabled: false
source: cloud_psks
dynamic_vlan:
default_vlan_id: 999
enabled: false
local_vlan_ids:
- 1
type: airespace-interface-name
vlans:
'131': default
'322': fast,video
enable_local_keycaching: false
enable_wireless_bridging: false
enabled: true
fast_dot1x_timers: false
hide_ssid: false
hostname_ie: false
hotspot20:
domain_name:
- mist.com
enabled: true
nai_realms:
- string
operators:
- google
- att
rcoi:
- 5A03BA0000
venue_name: some_name
interface: all
isolation: false
l2_isolation: false
legacy_overds: false
limit_bcast: false
limit_probe_response: true
max_idletime: 1800
mist_nac:
enabled: false
no_static_dns: false
no_static_ip: false
portal:
amazon_client_id: string
amazon_client_secret: string
amazon_email_domains:
- string
amazon_enabled: false
auth: none
azure_client_id: string
azure_client_secret: string
azure_enabled: false
azure_tenant_id: string
broadnet_password: password
broadnet_sid: MIST
broadnet_user_id: juniper
bypass_when_cloud_down: false
clickatell_api_key: string
cross_site: false
email_enabled: true
enabled: false
expire: 1440
external_portal_url: string
facebook_client_id: string
facebook_client_secret: string
facebook_email_domains:
- string
facebook_enabled: false
forward: false
forward_url: https://abc.com/promotions
google_client_id: string
google_client_secret: string
google_email_domains:
- mydomain.edu
- mydomain.org
google_enabled: false
gupshup_password: string
gupshup_userid: string
microsoft_client_id: string
microsoft_client_secret: string
microsoft_email_domains:
- string
microsoft_enabled: false
passphrase_enabled: false
password: let me in
predefined_sponsors_enabled: true
privacy: true
puzzel_password: string
puzzel_service_id: string
puzzel_username: string
smsMessageFormat: string
sms_enabled: false
sms_provider: twilio
sponsor_auto_approve: false
sponsor_email_domains:
- reserved.net
- reserved.org
sponsor_enabled: false
sponsor_link_validity_duration: '30'
sponsor_notify_all: false
sponsor_status_notify: false
sponsors:
sponsor1@company.com: FirstName1 LastName1
sponsor2@company.com: FirstName2 LastName2
sso_default_role: string
sso_forced_role: string
sso_idp_cert: string
sso_idp_sign_algo: sha256
sso_idp_sso_url: string
sso_issuer: string
sso_nameid_format: email
telstra_client_id: string
telstra_client_secret: string
twilio_auth_token: af9dac44c344a875ab5d31cb7abcdefg
twilio_phone_number: '+18548888888'
twilio_sid: AC72ec6ba0ec5af30e6731c5e47abcdefgh
portal_allowed_hostnames:
- snapchat.com
- ibm.com
portal_allowed_subnets:
- 63.5.3.0/24
portal_denied_hostnames:
- msg.snapchat.com
qos:
class: best_effort
overwrite: false
radsec:
enabled: true
idle_timeout: 60
mxcluster_ids:
- 572586b7-f97b-a22b-526c-8b97a3f609c4
proxy_hosts:
- mxedge1.local
server_name: radsec.abc.com
servers:
- host: 1.1.1.1
port: 1812
use_mxedge: true
use_site_mxedge: false
rateset:
'24':
ht: 00ff00ff00ff
legacy:
- '6'
- '9'
- '12'
- '18'
- 24b
- '36'
- '48'
- '54'
min_rssi: -70
template: custom
vht: 03ff03ff03ff01ff
'5':
ht: 00ff00ff00ff
legacy:
- '6'
- '9'
- '12'
- '18'
- 24b
- '36'
- '48'
- '54'
min_rssi: -70
template: custom
vht: 03ff03ff03ff01ff
roam_mode: NONE
schedule:
enabled: false
hours:
fri: 09:00-17:00
mon: 09:00-17:00
sle_excluded: false
ssid: corporate
use_eapol_v1: false
vlan_enabled: false
vlan_ids:
- 3
- 4
- 5
vlan_pooling: false
wxtag_ids:
- 497f6eca-6276-4993-bfeb-53e4bbba6f08
wxtunnel_id: string
wxtunnel_remote_id: string
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/secpolicy'
- description: Security Policy is designed to audit / catch discrepancies between "what’s intended to be running" versus "what’s actually running" in a network. Many big organizations have separated Security and IT team (for good reasons). Each site can be assigned a security policy. Whenever an AP is provisioned, the configuration will be checked against the security policy. Any violations will be flagged in Device Config History where you can search for the when and where the violation occurs.
examples:
- name: corporate only
wlans:
- auth:
pairwise:
- wpa1-tkip
- wpa2-tkip
type: psk
band: both
ssid: office
- auth:
type: open
band: '5'
ssid: office-guest
contentMediaType: application/json
examples:
Example:
value:
name: corporate only
wlans:
- auth:
pairwise:
- wpa1-tkip
- wpa2-tkip
type: psk
band: both
ssid: office
- auth:
type: open
band: '5'
ssid: office-guest
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/secpolicy'
- description: Security Policy is designed to audit / catch discrepancies between "what’s intended to be running" versus "what’s actually running" in a network. Many big organizations have separated Security and IT team (for good reasons). Each site can be assigned a security policy. Whenever an AP is provisioned, the configuration will be checked against the security policy. Any violations will be flagged in Device Config History where you can search for the when and where the violation occurs.
examples:
- name: corporate only
wlans:
- auth:
pairwise:
- wpa1-tkip
- wpa2-tkip
type: psk
band: both
ssid: office
- auth:
type: open
band: '5'
ssid: office-guest
contentMediaType: application/vnd.api+json
examples:
Example:
value:
name: corporate only
wlans:
- auth:
pairwise:
- wpa1-tkip
- wpa2-tkip
type: psk
band: both
ssid: office
- auth:
type: open
band: '5'
ssid: office-guest
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/secpolicies/{secpolicy_id}:
delete:
tags:
- Orgs Security Policies
summary: deleteOrgSecPolicy
description: Remove an organization security policy from the set available for assignment and configuration compliance checks.
operationId: deleteOrgSecPolicy
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: secpolicy_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Orgs Security Policies
summary: getOrgSecPolicy
description: Return an organization security policy, including the WLAN configuration baselines used for compliance auditing.
operationId: getOrgSecPolicy
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: secpolicy_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/secpolicy'
- description: Security Policy is designed to audit / catch discrepancies between "what’s intended to be running" versus "what’s actually running" in a network. Many big organizations have separated Security and IT team (for good reasons). Each site can be assigned a security policy. Whenever an AP is provisioned, the configuration will be checked against the security policy. Any violations will be flagged in Device Config History where you can search for the when and where the violation occurs.
examples:
- name: corporate only
wlans:
- auth:
pairwise:
- wpa1-tkip
- wpa2-tkip
type: psk
band: both
ssid: office
- auth:
type: open
band: '5'
ssid: office-guest
contentMediaType: application/json
examples:
Example:
value:
name: corporate only
wlans:
- auth:
pairwise:
- wpa1-tkip
- wpa2-tkip
type: psk
band: both
ssid: office
- auth:
type: open
band: '5'
ssid: office-guest
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/secpolicy'
- description: Security Policy is designed to audit / catch discrepancies between "what’s intended to be running" versus "what’s actually running" in a network. Many big organizations have separated Security and IT team (for good reasons). Each site can be assigned a security policy. Whenever an AP is provisioned, the configuration will be checked against the security policy. Any violations will be flagged in Device Config History where you can search for the when and where the violation occurs.
examples:
- name: corporate only
wlans:
- auth:
pairwise:
- wpa1-tkip
- wpa2-tkip
type: psk
band: both
ssid: office
- auth:
type: open
band: '5'
ssid: office-guest
contentMediaType: application/vnd.api+json
examples:
Example:
value:
name: corporate only
wlans:
- auth:
pairwise:
- wpa1-tkip
- wpa2-tkip
type: psk
band: both
ssid: office
- auth:
type: open
band: '5'
ssid: office-guest
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Orgs Security Policies
summary: updateOrgSecPolicy
description: Update an organization security policy, including its name and WLAN configuration baselines for compliance auditing.
operationId: updateOrgSecPolicy
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: secpolicy_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/secpolicy'
- description: Request Body
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/secpolicy'
- description: Security Policy is designed to audit / catch discrepancies between "what’s intended to be running" versus "what’s actually running" in a network. Many big organizations have separated Security and IT team (for good reasons). Each site can be assigned a security policy. Whenever an AP is provisioned, the configuration will be checked against the security policy. Any violations will be flagged in Device Config History where you can search for the when and where the violation occurs.
examples:
- name: corporate only
wlans:
- auth:
pairwise:
- wpa1-tkip
- wpa2-tkip
type: psk
band: both
ssid: office
- auth:
type: open
band: '5'
ssid: office-guest
contentMediaType: application/json
examples:
Example:
value:
name: corporate only
wlans:
- auth:
pairwise:
- wpa1-tkip
- wpa2-tkip
type: psk
band: both
ssid: office
- auth:
type: open
band: '5'
ssid: office-guest
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/secpolicy'
- description: Security Policy is designed to audit / catch discrepancies between "what’s intended to be running" versus "what’s actually running" in a network. Many big organizations have separated Security and IT team (for good reasons). Each site can be assigned a security policy. Whenever an AP is provisioned, the configuration will be checked against the security policy. Any violations will be flagged in Device Config History where you can search for the when and where the violation occurs.
examples:
- name: corporate only
wlans:
- auth:
pairwise:
- wpa1-tkip
- wpa2-tkip
type: psk
band: both
ssid: office
- auth:
type: open
band: '5'
ssid: office-guest
contentMediaType: application/vnd.api+json
examples:
Example:
value:
name: corporate only
wlans:
- auth:
pairwise:
- wpa1-tkip
- wpa2-tkip
type: psk
band: both
ssid: office
- auth:
type: open
band: '5'
ssid: office-guest
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/services:
get:
tags:
- Orgs Services
summary: listOrgServices
description: List organization service definitions. Services describe applications, application categories, URLs, hostnames, subnets, or custom protocol and port match criteria used by gateway and SSR policies.
operationId: listOrgServices
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/service'
description: Service definitions returned by list operations
examples:
- - addresses:
- string
apps:
- string
dscp: 8
hostnames:
- string
max_jitter: 0
max_latency: 0
max_loss: 0
name: string
specs:
- port_range: '0'
protocol: any
traffic_class: best_effort
traffic_type: default
type: custom
contentMediaType: application/json
examples:
Example:
value:
- addresses:
- string
apps:
- string
dscp: 8
hostnames:
- string
max_jitter: 0
max_latency: 0
max_loss: 0
name: string
specs:
- port_range: '0'
protocol: any
traffic_class: best_effort
traffic_type: default
type: custom
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/service'
description: Service definitions returned by list operations
examples:
- - addresses:
- string
apps:
- string
dscp: 8
hostnames:
- string
max_jitter: 0
max_latency: 0
max_loss: 0
name: string
specs:
- port_range: '0'
protocol: any
traffic_class: best_effort
traffic_type: default
type: custom
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- addresses:
- string
apps:
- string
dscp: 8
hostnames:
- string
max_jitter: 0
max_latency: 0
max_loss: 0
name: string
specs:
- port_range: '0'
protocol: any
traffic_class: best_effort
traffic_type: default
type: custom
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs Services
summary: createOrgService
description: >-
Create an organization service definition with the match criteria
used by gateway and SSR policies, such as applications, URLs, hostnames,
subnets, or custom protocol and port rules.
Services can be user in the service policies to allow or deny traffic matching the service or to apply specific inspection settings or steering rules.
operationId: createOrgService
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/service'
- examples:
- addresses:
- 0.0.0.0/0
app_key: string
name: string
network_id: d6797cf4-42b9-4cad-8591-9dd91c3f0fc3
specs:
- port_range: 8080,8443
protocol: any
subnet: string
type: custom
contentMediaType: application/json
examples:
Example:
value:
addresses:
- 0.0.0.0/0
app_key: string
name: string
network_id: d6797cf4-42b9-4cad-8591-9dd91c3f0fc3
specs:
- port_range: 8080,8443
protocol: any
subnet: string
type: custom
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/service'
- description: Traffic service definition for applications or destinations used by gateway and SSR policies
examples:
- addresses:
- string
app_categories:
- string
apps:
- string
created_time: 0
dscp: 0
failover_policy: revertible
hostnames:
- string
id: 497f6eca-6276-5004-bfeb-53cbbbba6f16
max_jitter: 0
max_latency: 0
max_loss: 0
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
sle_enabled: false
specs:
- port_range: '0'
protocol: any
traffic_class: best_effort
traffic_type: data_best_effort
type: custom
vpn_name: addresses
contentMediaType: application/json
examples:
Example:
value:
addresses:
- string
app_categories:
- string
apps:
- string
created_time: 0
dscp: 0
failover_policy: revertible
hostnames:
- string
id: 497f6eca-6276-5004-bfeb-53cbbbba6f16
max_jitter: 0
max_latency: 0
max_loss: 0
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
sle_enabled: false
specs:
- port_range: '0'
protocol: any
traffic_class: best_effort
traffic_type: data_best_effort
type: custom
vpn_name: addresses
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/service'
- description: Traffic service definition for applications or destinations used by gateway and SSR policies
examples:
- addresses:
- string
app_categories:
- string
apps:
- string
created_time: 0
dscp: 0
failover_policy: revertible
hostnames:
- string
id: 497f6eca-6276-5004-bfeb-53cbbbba6f16
max_jitter: 0
max_latency: 0
max_loss: 0
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
sle_enabled: false
specs:
- port_range: '0'
protocol: any
traffic_class: best_effort
traffic_type: data_best_effort
type: custom
vpn_name: addresses
contentMediaType: application/vnd.api+json
examples:
Example:
value:
addresses:
- string
app_categories:
- string
apps:
- string
created_time: 0
dscp: 0
failover_policy: revertible
hostnames:
- string
id: 497f6eca-6276-5004-bfeb-53cbbbba6f16
max_jitter: 0
max_latency: 0
max_loss: 0
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
sle_enabled: false
specs:
- port_range: '0'
protocol: any
traffic_class: best_effort
traffic_type: data_best_effort
type: custom
vpn_name: addresses
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/services/{service_id}:
delete:
tags:
- Orgs Services
summary: deleteOrgService
description: Remove an organization service definition from the available service catalog.
operationId: deleteOrgService
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: service_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Orgs Services
summary: getOrgService
description: Return an organization service definition, including its matching mode, match values, traffic classification, and optional SSR path-selection thresholds.
operationId: getOrgService
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: service_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/service'
- description: Traffic service definition for applications or destinations used by gateway and SSR policies
examples:
- addresses:
- string
app_categories:
- string
apps:
- string
created_time: 0
dscp: 0
failover_policy: revertible
hostnames:
- string
id: 497f6eca-6276-5004-bfeb-53cbbbba6f16
max_jitter: 0
max_latency: 0
max_loss: 0
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
sle_enabled: false
specs:
- port_range: '0'
protocol: any
traffic_class: best_effort
traffic_type: data_best_effort
type: custom
vpn_name: addresses
contentMediaType: application/json
examples:
Example:
value:
addresses:
- string
app_categories:
- string
apps:
- string
created_time: 0
dscp: 0
failover_policy: revertible
hostnames:
- string
id: 497f6eca-6276-5004-bfeb-53cbbbba6f16
max_jitter: 0
max_latency: 0
max_loss: 0
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
sle_enabled: false
specs:
- port_range: '0'
protocol: any
traffic_class: best_effort
traffic_type: data_best_effort
type: custom
vpn_name: addresses
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/service'
- description: Traffic service definition for applications or destinations used by gateway and SSR policies
examples:
- addresses:
- string
app_categories:
- string
apps:
- string
created_time: 0
dscp: 0
failover_policy: revertible
hostnames:
- string
id: 497f6eca-6276-5004-bfeb-53cbbbba6f16
max_jitter: 0
max_latency: 0
max_loss: 0
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
sle_enabled: false
specs:
- port_range: '0'
protocol: any
traffic_class: best_effort
traffic_type: data_best_effort
type: custom
vpn_name: addresses
contentMediaType: application/vnd.api+json
examples:
Example:
value:
addresses:
- string
app_categories:
- string
apps:
- string
created_time: 0
dscp: 0
failover_policy: revertible
hostnames:
- string
id: 497f6eca-6276-5004-bfeb-53cbbbba6f16
max_jitter: 0
max_latency: 0
max_loss: 0
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
sle_enabled: false
specs:
- port_range: '0'
protocol: any
traffic_class: best_effort
traffic_type: data_best_effort
type: custom
vpn_name: addresses
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Orgs Services
summary: updateOrgService
description: Update an organization service definition, including its matching mode, match values, traffic classification, or optional SSR path-selection thresholds.
operationId: updateOrgService
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: service_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/service'
- examples:
- addresses:
- string
app_categories:
- string
apps:
- string
dscp: 0
failover_policy: revertible
hostnames:
- string
max_jitter: 0
max_latency: 0
max_loss: 0
name: string
sle_enabled: false
specs:
- port_range: '0'
protocol: any
traffic_class: best_effort
traffic_type: data_best_effort
type: custom
vpn_name: addresses
contentMediaType: application/json
examples:
Example:
value:
addresses:
- string
app_categories:
- string
apps:
- string
dscp: 0
failover_policy: revertible
hostnames:
- string
max_jitter: 0
max_latency: 0
max_loss: 0
name: string
sle_enabled: false
specs:
- port_range: '0'
protocol: any
traffic_class: best_effort
traffic_type: data_best_effort
type: custom
vpn_name: addresses
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/service'
- description: Traffic service definition for applications or destinations used by gateway and SSR policies
examples:
- addresses:
- string
app_categories:
- string
apps:
- string
created_time: 0
dscp: 0
failover_policy: revertible
hostnames:
- string
id: 497f6eca-6276-5004-bfeb-53cbbbba6f16
max_jitter: 0
max_latency: 0
max_loss: 0
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
sle_enabled: false
specs:
- port_range: '0'
protocol: any
traffic_class: best_effort
traffic_type: data_best_effort
type: custom
vpn_name: addresses
contentMediaType: application/json
examples:
Example:
value:
addresses:
- string
app_categories:
- string
apps:
- string
created_time: 0
dscp: 0
failover_policy: revertible
hostnames:
- string
id: 497f6eca-6276-5004-bfeb-53cbbbba6f16
max_jitter: 0
max_latency: 0
max_loss: 0
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
sle_enabled: false
specs:
- port_range: '0'
protocol: any
traffic_class: best_effort
traffic_type: data_best_effort
type: custom
vpn_name: addresses
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/service'
- description: Traffic service definition for applications or destinations used by gateway and SSR policies
examples:
- addresses:
- string
app_categories:
- string
apps:
- string
created_time: 0
dscp: 0
failover_policy: revertible
hostnames:
- string
id: 497f6eca-6276-5004-bfeb-53cbbbba6f16
max_jitter: 0
max_latency: 0
max_loss: 0
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
sle_enabled: false
specs:
- port_range: '0'
protocol: any
traffic_class: best_effort
traffic_type: data_best_effort
type: custom
vpn_name: addresses
contentMediaType: application/vnd.api+json
examples:
Example:
value:
addresses:
- string
app_categories:
- string
apps:
- string
created_time: 0
dscp: 0
failover_policy: revertible
hostnames:
- string
id: 497f6eca-6276-5004-bfeb-53cbbbba6f16
max_jitter: 0
max_latency: 0
max_loss: 0
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
sle_enabled: false
specs:
- port_range: '0'
protocol: any
traffic_class: best_effort
traffic_type: data_best_effort
type: custom
vpn_name: addresses
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/servicepolicies:
get:
tags:
- Orgs Service Policies
summary: listOrgServicePolicies
description: List organization-level service policies. Service policies match tenants to services or service groups and define the allow or deny action plus optional inspection controls.
operationId: listOrgServicePolicies
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/org_service_policy'
description: List of organization-level service policies
examples:
- - action: allow
created_time: 0
id: string
modified_time: 0
name: string
org_id: string
services:
- string
tenants:
- string
contentMediaType: application/json
examples:
Example:
value:
- action: allow
created_time: 0
id: string
modified_time: 0
name: string
org_id: string
services:
- string
tenants:
- string
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/org_service_policy'
description: List of organization-level service policies
examples:
- - action: allow
created_time: 0
id: string
modified_time: 0
name: string
org_id: string
services:
- string
tenants:
- string
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- action: allow
created_time: 0
id: string
modified_time: 0
name: string
org_id: string
services:
- string
tenants:
- string
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs Service Policies
summary: createOrgServicePolicy
description: >-
Create an organization-level service policy that matches tenants
to services and applies an allow or deny action with optional security inspection
settings.
Organization-level service policies can be imported in the gateway templates and gateway policies.
operationId: createOrgServicePolicy
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/org_service_policy'
- examples:
- action: allow
name: string
services:
- string
tenants:
- string
contentMediaType: application/json
examples:
Example:
value:
action: allow
name: string
services:
- string
tenants:
- string
required: false
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/org_service_policy'
- description: Organization-level service policy that allows or denies traffic for tenants and services
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/org_service_policy'
- description: Organization-level service policy that allows or denies traffic for tenants and services
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/servicepolicies/{servicepolicy_id}:
delete:
tags:
- Orgs Service Policies
summary: deleteOrgServicePolicy
description: Remove an organization-level service policy from the available policy set.
operationId: deleteOrgServicePolicy
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: servicepolicy_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Orgs Service Policies
summary: getOrgServicePolicy
description: Return an organization-level service policy, including the matched tenants and services, action, local routing, path preference, and inspection settings.
operationId: getOrgServicePolicy
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: servicepolicy_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/org_service_policy'
- description: Organization-level service policy that allows or denies traffic for tenants and services
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/org_service_policy'
- description: Organization-level service policy that allows or denies traffic for tenants and services
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Orgs Service Policies
summary: updateOrgServicePolicy
description: Update an organization-level service policy, including its tenant and service matches, action, local routing, path preference, or inspection settings.
operationId: updateOrgServicePolicy
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: servicepolicy_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/org_service_policy'
- examples:
- action: allow
name: string
services:
- string
tenants:
- string
contentMediaType: application/json
examples:
Example:
value:
action: allow
name: string
services:
- string
tenants:
- string
required: false
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/org_service_policy'
- description: Organization-level service policy that allows or denies traffic for tenants and services
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/org_service_policy'
- description: Organization-level service policy that allows or denies traffic for tenants and services
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/setting:
get:
tags:
- Orgs Setting
summary: getOrgSettings
description: Return organization-wide settings, including feature flags, automatic device assignment rules, management connectivity, packet capture, security controls, and integration configuration.
operationId: getOrgSettings
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/org_setting'
- description: Organization-wide feature, integration, management, and security settings
examples:
- '{"auto_device_naming":{"enable":true,"rules":[{"match_device":"ap","prefix":"MIST-","src":"lldp_port_desc"}]},"auto_deviceprofile_assignment":{"enable":true,"rules":[{"expression":"string","model":"string","prefix":"string","src":"name","subnet":"string","suffix":"string","value":"string"}]},"auto_site_assignment":{"enable":true,"rules":[{"expression":"string","model":"string","prefix":"string","src":"name","subnet":"string","suffix":"string","value":"string"}]},"cacerts":["string"],"cloudshark":{"apitoken":"string","url":"string"},"created_time":0,"device_cert":{"cert":"string","key":"string"},"device_updown_threshold":0,"disable_pcap":true,"id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","installer":{"allow_all_sites":true,"extra_site_ids":["b069b358-4c97-5319-1f8c-7c5ca64d6ab1"],"grace_period":0},"mgmt":{"mxtunnel_ids":["b069b358-4c97-5319-1f8c-7c5ca64d6ab1"],"use_mxtunnel":true,"use_wxtunnel":true},"modified_time":0,"msp_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","name":"string","password_policy":{"enabled":true,"expiry_in_days":180,"min_length":8,"requires_special_char":true,"requires_two_factor_auth":true},"pcap":{"bucket":"string","max_pkt_len":0},"pcap_bucket_verified":true,"remote_syslog":{"enabled":true,"send_to_all_servers":true,"servers":[{"facility":"conflict-log","host":"string","port":0,"protocol":"udp","severity":"any","tag":"string"}]},"security":{"disable_local_ssh":true,"fips_zeroize_password":"string","limit_ssh_access":true},"tags":["string"],"ui_idle_timeout":0}'
- '{"auto_device_naming":{"enable":true,"rules":[{"expression":"...","src":"lldp_port_desc"}]},"auto_deviceprofile_assignment":{"enable":true},"auto_site_assignment":{"enable":true,"rules":[{"expression":"[0:3]","prefix":"XX-","src":"name","suffix":"-YY"},{"src":"subnet","subnet":"10.1.2.0/18","value":"s1351"},{"expression":"...","src":"lldp_system_name"},{"expression":"...","src":"dns_suffix"},{"model":"AP41","src":"model","value":"s1351"}]},"cacerts":["-----BEGIN CERTIFICATE-----\nMIIFZjCCA06gAwIBAgIIP61/1qm/uDowDQYJKoZIhvcNAQELBQE\n-----END CERTIFICATE-----","-----BEGIN CERTIFICATE-----\nBhMCRVMxFDASBgNVBAoMC1N0YXJ0Q29tIENBMSwwKgYDVn-----END CERTIFICATE-----"],"cloudshark":{"apitoken":"accbd6f10c6d05c3","url":"https://cloudshark.hosted.domain"},"device_cert":{"cert":"-----BEGIN CERTIFICATE-----\nMIIFZjCCA06gAwIBAgIIP61/1qm/uDowDQYJKoZIhvcNAQELBQE\n-----END CERTIFICATE-----","key":"-----BEGIN PRI..."},"device_updown_threshold":0,"disable_pcap":false,"installer":{"allow_all_sites":false,"extra_site_ids":["4ac1dcf4-9d8b-7211-65c4-057819f0862b","52f4347e-3e4b-186c-21ca-ad5b70eb23d6"],"grace_period":14},"mgmt":{"mxtunnel_ids":["08cd7499-5841-51c8-e663-fb16b6f3b45e"],"use_mxtunnel":true,"use_wxtunnel":false},"password_policy":{"enabled":true,"expiry_in_days":60,"min_length":8,"requires_special_char":false,"requires_two_factor_auth":true},"pcap":{"bucket":"myorg_pcap","max_pkt_len":128},"pcap_bucket_verified":true,"remote_syslog":{"enabled":true,"send_to_all_servers":true,"servers":[{"facility":"any","host":"syslogd.internal","port":514,"protocol":"udp","severity":"info","tag":""}]},"security":{"disable_local_ssh":false,"fips_zeroize_password":"NUKETHESITE","limit_ssh_access":false},"tags":["beta"],"ui_idle_timeout":10}'
contentMediaType: application/json
examples:
Example:
value:
auto_device_naming:
enable: true
rules:
- match_device: ap
prefix: MIST-
src: lldp_port_desc
auto_deviceprofile_assignment:
enable: true
rules:
- expression: string
model: string
prefix: string
src: name
subnet: string
suffix: string
value: string
auto_site_assignment:
enable: true
rules:
- expression: string
model: string
prefix: string
src: name
subnet: string
suffix: string
value: string
cacerts:
- string
cloudshark:
apitoken: string
url: string
created_time: 0
device_cert:
cert: string
key: string
device_updown_threshold: 0
disable_pcap: true
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
installer:
allow_all_sites: true
extra_site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
grace_period: 0
mgmt:
mxtunnel_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
use_mxtunnel: true
use_wxtunnel: true
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
password_policy:
enabled: true
expiry_in_days: 180
min_length: 8
requires_special_char: true
requires_two_factor_auth: true
pcap:
bucket: string
max_pkt_len: 0
pcap_bucket_verified: true
remote_syslog:
enabled: true
send_to_all_servers: true
servers:
- facility: conflict-log
host: string
port: 0
protocol: udp
severity: any
tag: string
security:
disable_local_ssh: true
fips_zeroize_password: string
limit_ssh_access: true
tags:
- string
ui_idle_timeout: 0
Example2:
value:
auto_device_naming:
enable: true
rules:
- expression: '...'
src: lldp_port_desc
auto_deviceprofile_assignment:
enable: true
auto_site_assignment:
enable: true
rules:
- expression: '[0:3]'
prefix: XX-
src: name
suffix: -YY
- src: subnet
subnet: 10.1.2.0/18
value: s1351
- expression: '...'
src: lldp_system_name
- expression: '...'
src: dns_suffix
- model: AP41
src: model
value: s1351
cacerts:
- >-
-----BEGIN CERTIFICATE-----
MIIFZjCCA06gAwIBAgIIP61/1qm/uDowDQYJKoZIhvcNAQELBQE
-----END CERTIFICATE-----
- >-
-----BEGIN CERTIFICATE-----
BhMCRVMxFDASBgNVBAoMC1N0YXJ0Q29tIENBMSwwKgYDVn-----END CERTIFICATE-----
cloudshark:
apitoken: accbd6f10c6d05c3
url: https://cloudshark.hosted.domain
device_cert:
cert: >-
-----BEGIN CERTIFICATE-----
MIIFZjCCA06gAwIBAgIIP61/1qm/uDowDQYJKoZIhvcNAQELBQE
-----END CERTIFICATE-----
key: '-----BEGIN PRI...'
device_updown_threshold: 0
disable_pcap: false
installer:
allow_all_sites: false
extra_site_ids:
- 4ac1dcf4-9d8b-7211-65c4-057819f0862b
- 52f4347e-3e4b-186c-21ca-ad5b70eb23d6
grace_period: 14
mgmt:
mxtunnel_ids:
- 08cd7499-5841-51c8-e663-fb16b6f3b45e
use_mxtunnel: true
use_wxtunnel: false
password_policy:
enabled: true
expiry_in_days: 60
min_length: 8
requires_special_char: false
requires_two_factor_auth: true
pcap:
bucket: myorg_pcap
max_pkt_len: 128
pcap_bucket_verified: true
remote_syslog:
enabled: true
send_to_all_servers: true
servers:
- facility: any
host: syslogd.internal
port: 514
protocol: udp
severity: info
tag: ''
security:
disable_local_ssh: false
fips_zeroize_password: NUKETHESITE
limit_ssh_access: false
tags:
- beta
ui_idle_timeout: 10
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/org_setting'
- description: Organization-wide feature, integration, management, and security settings
examples:
- '{"auto_device_naming":{"enable":true,"rules":[{"match_device":"ap","prefix":"MIST-","src":"lldp_port_desc"}]},"auto_deviceprofile_assignment":{"enable":true,"rules":[{"expression":"string","model":"string","prefix":"string","src":"name","subnet":"string","suffix":"string","value":"string"}]},"auto_site_assignment":{"enable":true,"rules":[{"expression":"string","model":"string","prefix":"string","src":"name","subnet":"string","suffix":"string","value":"string"}]},"cacerts":["string"],"cloudshark":{"apitoken":"string","url":"string"},"created_time":0,"device_cert":{"cert":"string","key":"string"},"device_updown_threshold":0,"disable_pcap":true,"id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","installer":{"allow_all_sites":true,"extra_site_ids":["b069b358-4c97-5319-1f8c-7c5ca64d6ab1"],"grace_period":0},"mgmt":{"mxtunnel_ids":["b069b358-4c97-5319-1f8c-7c5ca64d6ab1"],"use_mxtunnel":true,"use_wxtunnel":true},"modified_time":0,"msp_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","name":"string","password_policy":{"enabled":true,"expiry_in_days":180,"min_length":8,"requires_special_char":true,"requires_two_factor_auth":true},"pcap":{"bucket":"string","max_pkt_len":0},"pcap_bucket_verified":true,"remote_syslog":{"enabled":true,"send_to_all_servers":true,"servers":[{"facility":"conflict-log","host":"string","port":0,"protocol":"udp","severity":"any","tag":"string"}]},"security":{"disable_local_ssh":true,"fips_zeroize_password":"string","limit_ssh_access":true},"tags":["string"],"ui_idle_timeout":0}'
- '{"auto_device_naming":{"enable":true,"rules":[{"expression":"...","src":"lldp_port_desc"}]},"auto_deviceprofile_assignment":{"enable":true},"auto_site_assignment":{"enable":true,"rules":[{"expression":"[0:3]","prefix":"XX-","src":"name","suffix":"-YY"},{"src":"subnet","subnet":"10.1.2.0/18","value":"s1351"},{"expression":"...","src":"lldp_system_name"},{"expression":"...","src":"dns_suffix"},{"model":"AP41","src":"model","value":"s1351"}]},"cacerts":["-----BEGIN CERTIFICATE-----\nMIIFZjCCA06gAwIBAgIIP61/1qm/uDowDQYJKoZIhvcNAQELBQE\n-----END CERTIFICATE-----","-----BEGIN CERTIFICATE-----\nBhMCRVMxFDASBgNVBAoMC1N0YXJ0Q29tIENBMSwwKgYDVn-----END CERTIFICATE-----"],"cloudshark":{"apitoken":"accbd6f10c6d05c3","url":"https://cloudshark.hosted.domain"},"device_cert":{"cert":"-----BEGIN CERTIFICATE-----\nMIIFZjCCA06gAwIBAgIIP61/1qm/uDowDQYJKoZIhvcNAQELBQE\n-----END CERTIFICATE-----","key":"-----BEGIN PRI..."},"device_updown_threshold":0,"disable_pcap":false,"installer":{"allow_all_sites":false,"extra_site_ids":["4ac1dcf4-9d8b-7211-65c4-057819f0862b","52f4347e-3e4b-186c-21ca-ad5b70eb23d6"],"grace_period":14},"mgmt":{"mxtunnel_ids":["08cd7499-5841-51c8-e663-fb16b6f3b45e"],"use_mxtunnel":true,"use_wxtunnel":false},"password_policy":{"enabled":true,"expiry_in_days":60,"min_length":8,"requires_special_char":false,"requires_two_factor_auth":true},"pcap":{"bucket":"myorg_pcap","max_pkt_len":128},"pcap_bucket_verified":true,"remote_syslog":{"enabled":true,"send_to_all_servers":true,"servers":[{"facility":"any","host":"syslogd.internal","port":514,"protocol":"udp","severity":"info","tag":""}]},"security":{"disable_local_ssh":false,"fips_zeroize_password":"NUKETHESITE","limit_ssh_access":false},"tags":["beta"],"ui_idle_timeout":10}'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
auto_device_naming:
enable: true
rules:
- match_device: ap
prefix: MIST-
src: lldp_port_desc
auto_deviceprofile_assignment:
enable: true
rules:
- expression: string
model: string
prefix: string
src: name
subnet: string
suffix: string
value: string
auto_site_assignment:
enable: true
rules:
- expression: string
model: string
prefix: string
src: name
subnet: string
suffix: string
value: string
cacerts:
- string
cloudshark:
apitoken: string
url: string
created_time: 0
device_cert:
cert: string
key: string
device_updown_threshold: 0
disable_pcap: true
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
installer:
allow_all_sites: true
extra_site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
grace_period: 0
mgmt:
mxtunnel_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
use_mxtunnel: true
use_wxtunnel: true
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
password_policy:
enabled: true
expiry_in_days: 180
min_length: 8
requires_special_char: true
requires_two_factor_auth: true
pcap:
bucket: string
max_pkt_len: 0
pcap_bucket_verified: true
remote_syslog:
enabled: true
send_to_all_servers: true
servers:
- facility: conflict-log
host: string
port: 0
protocol: udp
severity: any
tag: string
security:
disable_local_ssh: true
fips_zeroize_password: string
limit_ssh_access: true
tags:
- string
ui_idle_timeout: 0
Example2:
value:
auto_device_naming:
enable: true
rules:
- expression: '...'
src: lldp_port_desc
auto_deviceprofile_assignment:
enable: true
auto_site_assignment:
enable: true
rules:
- expression: '[0:3]'
prefix: XX-
src: name
suffix: -YY
- src: subnet
subnet: 10.1.2.0/18
value: s1351
- expression: '...'
src: lldp_system_name
- expression: '...'
src: dns_suffix
- model: AP41
src: model
value: s1351
cacerts:
- >-
-----BEGIN CERTIFICATE-----
MIIFZjCCA06gAwIBAgIIP61/1qm/uDowDQYJKoZIhvcNAQELBQE
-----END CERTIFICATE-----
- >-
-----BEGIN CERTIFICATE-----
BhMCRVMxFDASBgNVBAoMC1N0YXJ0Q29tIENBMSwwKgYDVn-----END CERTIFICATE-----
cloudshark:
apitoken: accbd6f10c6d05c3
url: https://cloudshark.hosted.domain
device_cert:
cert: >-
-----BEGIN CERTIFICATE-----
MIIFZjCCA06gAwIBAgIIP61/1qm/uDowDQYJKoZIhvcNAQELBQE
-----END CERTIFICATE-----
key: '-----BEGIN PRI...'
device_updown_threshold: 0
disable_pcap: false
installer:
allow_all_sites: false
extra_site_ids:
- 4ac1dcf4-9d8b-7211-65c4-057819f0862b
- 52f4347e-3e4b-186c-21ca-ad5b70eb23d6
grace_period: 14
mgmt:
mxtunnel_ids:
- 08cd7499-5841-51c8-e663-fb16b6f3b45e
use_mxtunnel: true
use_wxtunnel: false
password_policy:
enabled: true
expiry_in_days: 60
min_length: 8
requires_special_char: false
requires_two_factor_auth: true
pcap:
bucket: myorg_pcap
max_pkt_len: 128
pcap_bucket_verified: true
remote_syslog:
enabled: true
send_to_all_servers: true
servers:
- facility: any
host: syslogd.internal
port: 514
protocol: udp
severity: info
tag: ''
security:
disable_local_ssh: false
fips_zeroize_password: NUKETHESITE
limit_ssh_access: false
tags:
- beta
ui_idle_timeout: 10
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Orgs Setting
summary: updateOrgSettings
description: Update organization-wide settings such as automatic device assignment rules, management connectivity, packet capture, password policy, security controls, tags, and integration options.
operationId: updateOrgSettings
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/org_setting'
- description: Request Body
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/org_setting'
- description: Organization-wide feature, integration, management, and security settings
examples:
- auto_device_naming:
enable: true
rules:
- match_device: ap
prefix: MIST-
src: lldp_port_desc
auto_deviceprofile_assignment:
enable: true
rules:
- expression: string
model: string
prefix: string
src: name
subnet: string
suffix: string
value: string
auto_site_assignment:
enable: true
rules:
- expression: string
model: string
prefix: string
src: name
subnet: string
suffix: string
value: string
cacerts:
- string
cloudshark:
apitoken: string
url: string
device_cert:
cert: string
key: string
disable_pcap: true
installer:
allow_all_sites: true
extra_site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
grace_period: 0
mgmt:
mxtunnel_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
use_mxtunnel: true
use_wxtunnel: true
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
password_policy:
enabled: true
expiry_in_days: 365
min_length: 8
requires_special_char: true
requires_two_factor_auth: true
pcap:
bucket: string
max_pkt_len: 0
pcap_bucket_verified: true
remote_syslog:
enabled: true
send_to_all_servers: true
servers:
- facility: change-log
host: string
port: 0
protocol: udp
severity: critical
tag: string
security:
disable_local_ssh: true
fips_zeroize_password: string
limit_ssh_access: true
tags:
- string
ui_idle_timeout: 0
contentMediaType: application/json
examples:
Example:
value:
auto_device_naming:
enable: true
rules:
- match_device: ap
prefix: MIST-
src: lldp_port_desc
auto_deviceprofile_assignment:
enable: true
rules:
- expression: string
model: string
prefix: string
src: name
subnet: string
suffix: string
value: string
auto_site_assignment:
enable: true
rules:
- expression: string
model: string
prefix: string
src: name
subnet: string
suffix: string
value: string
cacerts:
- string
cloudshark:
apitoken: string
url: string
device_cert:
cert: string
key: string
disable_pcap: true
installer:
allow_all_sites: true
extra_site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
grace_period: 0
mgmt:
mxtunnel_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
use_mxtunnel: true
use_wxtunnel: true
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
password_policy:
enabled: true
expiry_in_days: 365
min_length: 8
requires_special_char: true
requires_two_factor_auth: true
pcap:
bucket: string
max_pkt_len: 0
pcap_bucket_verified: true
remote_syslog:
enabled: true
send_to_all_servers: true
servers:
- facility: change-log
host: string
port: 0
protocol: udp
severity: critical
tag: string
security:
disable_local_ssh: true
fips_zeroize_password: string
limit_ssh_access: true
tags:
- string
ui_idle_timeout: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/setting/blacklist:
delete:
tags:
- Orgs Setting
summary: deleteOrgWirelessClientsBlocklist
description: Clear the organization wireless client blocklist by removing all blocked client MAC addresses.
operationId: deleteOrgWirelessClientsBlocklist
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs Setting
summary: createOrgWirelessClientsBlocklist
description: Replace the organization wireless client blocklist with the supplied client MAC addresses. The list can contain up to 1000 MAC addresses; retrieve the current list from the `blacklist_url` field in organization settings.
operationId: createOrgWirelessClientsBlocklist
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/mac_addresses'
- description: Request Body
examples:
- macs:
- 18-65-90-de-f4-c6
- 84-89-ad-5d-69-0d
contentMediaType: application/json
examples:
Example:
value:
macs:
- 18-65-90-de-f4-c6
- 84-89-ad-5d-69-0d
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/mac_addresses'
- description: Request containing one or more MAC addresses
examples:
- macs:
- 18-65-90-de-f4-c6
- 84-89-ad-5d-69-0d
contentMediaType: application/json
examples:
Example:
value:
macs:
- 18-65-90-de-f4-c6
- 84-89-ad-5d-69-0d
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/mac_addresses'
- description: Request containing one or more MAC addresses
examples:
- macs:
- 18-65-90-de-f4-c6
- 84-89-ad-5d-69-0d
contentMediaType: application/vnd.api+json
examples:
Example:
value:
macs:
- 18-65-90-de-f4-c6
- 84-89-ad-5d-69-0d
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/setting/pcap_bucket/setup:
post:
tags:
- Orgs Setting
summary: setOrgCustomBucket
description: Start custom packet capture bucket setup by saving the bucket name and having Mist write a `MIST_TOKEN` file to the bucket. Complete ownership verification with the verify endpoint by submitting the token contents.
operationId: setOrgCustomBucket
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/pcap_bucket'
- description: Request Body
examples:
- bucket: company-private-pcap
contentMediaType: application/json
examples:
Example:
value:
bucket: company-private-pcap
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_pcap_bucket_config'
- description: Result of a custom packet capture bucket setup or verification operation
examples:
- '{"bucket":"company-private-pcap","detail":"failed to write bucket - 403 AccessDenied"}'
- '{}'
contentMediaType: application/json
examples:
Failed:
value:
bucket: company-private-pcap
detail: failed to write bucket - 403 AccessDenied
Success:
value: {}
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_pcap_bucket_config'
- description: Result of a custom packet capture bucket setup or verification operation
examples:
- '{"bucket":"company-private-pcap","detail":"failed to write bucket - 403 AccessDenied"}'
- '{}'
contentMediaType: application/vnd.api+json
examples:
Failed:
value:
bucket: company-private-pcap
detail: failed to write bucket - 403 AccessDenied
Success:
value: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/setting/pcap_bucket/verify:
post:
tags:
- Orgs Setting
summary: verifyOrgCustomBucket
description: Verify ownership of a custom packet capture bucket by submitting the token read from the `MIST_TOKEN` file. If verification succeeds, Mist creates a `VERIFIED` file in the bucket.
operationId: verifyOrgCustomBucket
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/pcap_bucket_verify'
- description: Request Body
examples:
- bucket: company-private-pcap
verify_token: eyJhbGciOiJIUzI1J9.eyJzdWIiOiIxMjM0joiMjgxOG5MDIyfQ.2rzcRvMA3Eg09NnjCAC-1EWMRtxAnFDM
contentMediaType: application/json
examples:
Example:
value:
bucket: company-private-pcap
verify_token: eyJhbGciOiJIUzI1J9.eyJzdWIiOiIxMjM0joiMjgxOG5MDIyfQ.2rzcRvMA3Eg09NnjCAC-1EWMRtxAnFDM
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/sitegroups:
get:
tags:
- Orgs Sitegroups
summary: listOrgSiteGroups
description: List site groups configured in the organization. A site group collects site IDs so sites can be managed or referenced as a group.
operationId: listOrgSiteGroups
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/sitegroup'
description: Site groups returned by list operations
examples:
- - created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/json
examples:
Example:
value:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/sitegroup'
description: Site groups returned by list operations
examples:
- - created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs Sitegroups
summary: createOrgSiteGroup
description: Create a site group in the organization with a display name and optional site membership.
operationId: createOrgSiteGroup
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sitegroup'
- description: Request Body
examples:
- name: string
contentMediaType: application/json
examples:
Example:
value:
name: string
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sitegroup'
- description: Group of sites within an organization
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/sitegroup'
- description: Group of sites within an organization
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/sitegroups/{sitegroup_id}:
delete:
tags:
- Orgs Sitegroups
summary: deleteOrgSiteGroup
description: Remove a site group from the organization.
operationId: deleteOrgSiteGroup
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: sitegroup_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Orgs Sitegroups
summary: getOrgSiteGroup
description: Return a site group, including its display name and the site IDs included in the group.
operationId: getOrgSiteGroup
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: sitegroup_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sitegroup'
- description: Group of sites within an organization
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/sitegroup'
- description: Group of sites within an organization
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Orgs Sitegroups
summary: updateOrgSiteGroup
description: Update the display name used to identify a site group in the organization.
operationId: updateOrgSiteGroup
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: sitegroup_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/name_string'
- description: Request Body
examples:
- name: string
contentMediaType: application/json
examples:
Example:
value:
name: string
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sitegroup'
- description: Group of sites within an organization
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/sitegroup'
- description: Group of sites within an organization
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/sites:
get:
tags:
- Orgs Sites
summary: listOrgSites
description: List sites in the organization. Site records include location metadata, timezone, site group membership, and template or policy associations.
operationId: listOrgSites
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/site'
description: Site records returned by a list response
examples:
- - address: 1601 S. Deanza Blvd., Cupertino, CA, 95014
alarmtemplate_id: 684dfc5c-fe77-2290-eb1d-ef3d677fe168
aptemplate_id: 16bdf952-ade2-4491-80b0-85ce506c760b
country_code: US
created_time: 0
gatewaytemplate_id: 6f9b2e75-9b2f-b5ae-81e3-e14c76f1a90f
id: 497f6eca-6276-5007-bfeb-53cbbbba6f19
latlng:
lat: 37.295833
lng: -122.032946
modified_time: 0
name: Mist Office
networktemplate_id: 12ae9bd2-e0ab-107b-72e8-a7a005565ec2
notes: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
rftemplate_id: bb8a9017-1e36-5d6c-6f2b-551abe8a76a2
secpolicy_id: 3bcd0beb-5d0a-4cbd-92c1-14aea91e98ef
sitegroup_ids:
- 497f6eca-6276-5008-bfeb-53cbbbba6f1a
timezone: America/Los_Angeles
contentMediaType: application/json
examples:
Example:
value:
- address: 1601 S. Deanza Blvd., Cupertino, CA, 95014
alarmtemplate_id: 684dfc5c-fe77-2290-eb1d-ef3d677fe168
aptemplate_id: 16bdf952-ade2-4491-80b0-85ce506c760b
country_code: US
created_time: 0
gatewaytemplate_id: 6f9b2e75-9b2f-b5ae-81e3-e14c76f1a90f
id: 497f6eca-6276-5007-bfeb-53cbbbba6f19
latlng:
lat: 37.295833
lng: -122.032946
modified_time: 0
name: Mist Office
networktemplate_id: 12ae9bd2-e0ab-107b-72e8-a7a005565ec2
notes: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
rftemplate_id: bb8a9017-1e36-5d6c-6f2b-551abe8a76a2
secpolicy_id: 3bcd0beb-5d0a-4cbd-92c1-14aea91e98ef
sitegroup_ids:
- 497f6eca-6276-5008-bfeb-53cbbbba6f1a
timezone: America/Los_Angeles
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/site'
description: Site records returned by a list response
examples:
- - address: 1601 S. Deanza Blvd., Cupertino, CA, 95014
alarmtemplate_id: 684dfc5c-fe77-2290-eb1d-ef3d677fe168
aptemplate_id: 16bdf952-ade2-4491-80b0-85ce506c760b
country_code: US
created_time: 0
gatewaytemplate_id: 6f9b2e75-9b2f-b5ae-81e3-e14c76f1a90f
id: 497f6eca-6276-5007-bfeb-53cbbbba6f19
latlng:
lat: 37.295833
lng: -122.032946
modified_time: 0
name: Mist Office
networktemplate_id: 12ae9bd2-e0ab-107b-72e8-a7a005565ec2
notes: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
rftemplate_id: bb8a9017-1e36-5d6c-6f2b-551abe8a76a2
secpolicy_id: 3bcd0beb-5d0a-4cbd-92c1-14aea91e98ef
sitegroup_ids:
- 497f6eca-6276-5008-bfeb-53cbbbba6f1a
timezone: America/Los_Angeles
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- address: 1601 S. Deanza Blvd., Cupertino, CA, 95014
alarmtemplate_id: 684dfc5c-fe77-2290-eb1d-ef3d677fe168
aptemplate_id: 16bdf952-ade2-4491-80b0-85ce506c760b
country_code: US
created_time: 0
gatewaytemplate_id: 6f9b2e75-9b2f-b5ae-81e3-e14c76f1a90f
id: 497f6eca-6276-5007-bfeb-53cbbbba6f19
latlng:
lat: 37.295833
lng: -122.032946
modified_time: 0
name: Mist Office
networktemplate_id: 12ae9bd2-e0ab-107b-72e8-a7a005565ec2
notes: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
rftemplate_id: bb8a9017-1e36-5d6c-6f2b-551abe8a76a2
secpolicy_id: 3bcd0beb-5d0a-4cbd-92c1-14aea91e98ef
sitegroup_ids:
- 497f6eca-6276-5008-bfeb-53cbbbba6f1a
timezone: America/Los_Angeles
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs Sites
summary: createOrgSite
description: Create a site in the organization with location metadata, timezone, site group membership, and optional template or policy associations.
operationId: createOrgSite
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/site'
- description: Request Body
examples:
- address: 1601 S. Deanza Blvd., Cupertino, CA, 95014
alarmtemplate_id: 684dfc5c-fe77-2290-eb1d-ef3d677fe168
aptemplate_id: 16bdf952-ade2-4491-80b0-85ce506c760b
country_code: US
gatewaytemplate_id: 6f9b2e75-9b2f-b5ae-81e3-e14c76f1a90f
latlng:
lat: 37.295833
lng: -122.032946
name: Mist Office
networktemplate_id: 12ae9bd2-e0ab-107b-72e8-a7a005565ec2
notes: string
rftemplate_id: bb8a9017-1e36-5d6c-6f2b-551abe8a76a2
secpolicy_id: 3bcd0beb-5d0a-4cbd-92c1-14aea91e98ef
sitegroup_ids:
- 497f6eca-6276-4997-bfeb-53cbbbba6f3b
timezone: America/Los_Angeles
contentMediaType: application/json
examples:
Example:
value:
address: 1601 S. Deanza Blvd., Cupertino, CA, 95014
alarmtemplate_id: 684dfc5c-fe77-2290-eb1d-ef3d677fe168
aptemplate_id: 16bdf952-ade2-4491-80b0-85ce506c760b
country_code: US
gatewaytemplate_id: 6f9b2e75-9b2f-b5ae-81e3-e14c76f1a90f
latlng:
lat: 37.295833
lng: -122.032946
name: Mist Office
networktemplate_id: 12ae9bd2-e0ab-107b-72e8-a7a005565ec2
notes: string
rftemplate_id: bb8a9017-1e36-5d6c-6f2b-551abe8a76a2
secpolicy_id: 3bcd0beb-5d0a-4cbd-92c1-14aea91e98ef
sitegroup_ids:
- 497f6eca-6276-4997-bfeb-53cbbbba6f3b
timezone: America/Los_Angeles
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/site'
- description: Site configuration and metadata within an organization
examples:
- address: 1601 S. Deanza Blvd., Cupertino, CA, 95014
alarmtemplate_id: 684dfc5c-fe77-2290-eb1d-ef3d677fe168
aptemplate_id: 16bdf952-ade2-4491-80b0-85ce506c760b
country_code: US
created_time: 0
gatewaytemplate_id: 6f9b2e75-9b2f-b5ae-81e3-e14c76f1a90f
id: 497f6eca-6276-5005-bfeb-53cbbbba6f17
latlng:
lat: 37.295833
lng: -122.032946
modified_time: 0
name: Mist Office
networktemplate_id: 12ae9bd2-e0ab-107b-72e8-a7a005565ec2
notes: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
rftemplate_id: bb8a9017-1e36-5d6c-6f2b-551abe8a76a2
secpolicy_id: 3bcd0beb-5d0a-4cbd-92c1-14aea91e98ef
sitegroup_ids:
- 497f6eca-6276-5006-bfeb-53cbbbba6f18
timezone: America/Los_Angeles
contentMediaType: application/json
examples:
Example:
value:
address: 1601 S. Deanza Blvd., Cupertino, CA, 95014
alarmtemplate_id: 684dfc5c-fe77-2290-eb1d-ef3d677fe168
aptemplate_id: 16bdf952-ade2-4491-80b0-85ce506c760b
country_code: US
created_time: 0
gatewaytemplate_id: 6f9b2e75-9b2f-b5ae-81e3-e14c76f1a90f
id: 497f6eca-6276-5005-bfeb-53cbbbba6f17
latlng:
lat: 37.295833
lng: -122.032946
modified_time: 0
name: Mist Office
networktemplate_id: 12ae9bd2-e0ab-107b-72e8-a7a005565ec2
notes: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
rftemplate_id: bb8a9017-1e36-5d6c-6f2b-551abe8a76a2
secpolicy_id: 3bcd0beb-5d0a-4cbd-92c1-14aea91e98ef
sitegroup_ids:
- 497f6eca-6276-5006-bfeb-53cbbbba6f18
timezone: America/Los_Angeles
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/site'
- description: Site configuration and metadata within an organization
examples:
- address: 1601 S. Deanza Blvd., Cupertino, CA, 95014
alarmtemplate_id: 684dfc5c-fe77-2290-eb1d-ef3d677fe168
aptemplate_id: 16bdf952-ade2-4491-80b0-85ce506c760b
country_code: US
created_time: 0
gatewaytemplate_id: 6f9b2e75-9b2f-b5ae-81e3-e14c76f1a90f
id: 497f6eca-6276-5005-bfeb-53cbbbba6f17
latlng:
lat: 37.295833
lng: -122.032946
modified_time: 0
name: Mist Office
networktemplate_id: 12ae9bd2-e0ab-107b-72e8-a7a005565ec2
notes: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
rftemplate_id: bb8a9017-1e36-5d6c-6f2b-551abe8a76a2
secpolicy_id: 3bcd0beb-5d0a-4cbd-92c1-14aea91e98ef
sitegroup_ids:
- 497f6eca-6276-5006-bfeb-53cbbbba6f18
timezone: America/Los_Angeles
contentMediaType: application/vnd.api+json
examples:
Example:
value:
address: 1601 S. Deanza Blvd., Cupertino, CA, 95014
alarmtemplate_id: 684dfc5c-fe77-2290-eb1d-ef3d677fe168
aptemplate_id: 16bdf952-ade2-4491-80b0-85ce506c760b
country_code: US
created_time: 0
gatewaytemplate_id: 6f9b2e75-9b2f-b5ae-81e3-e14c76f1a90f
id: 497f6eca-6276-5005-bfeb-53cbbbba6f17
latlng:
lat: 37.295833
lng: -122.032946
modified_time: 0
name: Mist Office
networktemplate_id: 12ae9bd2-e0ab-107b-72e8-a7a005565ec2
notes: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
rftemplate_id: bb8a9017-1e36-5d6c-6f2b-551abe8a76a2
secpolicy_id: 3bcd0beb-5d0a-4cbd-92c1-14aea91e98ef
sitegroup_ids:
- 497f6eca-6276-5006-bfeb-53cbbbba6f18
timezone: America/Los_Angeles
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/sites/count:
get:
tags:
- Orgs Sites
summary: countOrgSites
description: Count organization sites grouped by a distinct site attribute, such as country code, site name, feature flags, or enabled services.
operationId: countOrgSites
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field used to group this count response. enum: `analytic_enabled`, `app_waking`, `asset_enabled`, `auto_upgrade_enabled`, `auto_upgrade_version`, `country_code`, `honeypot_enabled`, `id`, `locate_unconnected`, `mesh_enabled`, `name`, `remote_syslog_enabled`, `rogue_enabled`, `rtsa_enabled`, `vna_enabled`, `wifi_enabled`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/org_sites_count_distinct'
- description: 'Field used to group this count response. enum: `analytic_enabled`, `app_waking`, `asset_enabled`, `auto_upgrade_enabled`, `auto_upgrade_version`, `country_code`, `honeypot_enabled`, `id`, `locate_unconnected`, `mesh_enabled`, `name`, `remote_syslog_enabled`, `rogue_enabled`, `rtsa_enabled`, `vna_enabled`, `wifi_enabled`'
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/sites/search:
get:
tags:
- Orgs Sites
summary: searchOrgSites
description: Search organization sites with filters for feature flags, country code, identifiers, names, upgrade settings, and other site attributes. Supports pagination and sorting.
operationId: searchOrgSites
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: analytic_enabled
in: query
description: If Advanced Analytic feature is enabled. Accepts multiple comma-separated boolean values.
style: form
explode: true
schema:
type: boolean
- name: app_waking
in: query
description: If App Waking feature is enabled
style: form
explode: true
schema:
type: boolean
- name: asset_enabled
in: query
description: If Asset Tracking is enabled. Accepts multiple comma-separated boolean values.
style: form
explode: true
schema:
type: boolean
- name: auto_upgrade_enabled
in: query
description: Filter results by whether automatic upgrades are enabled
style: form
explode: true
schema:
type: boolean
- name: auto_upgrade_version
in: query
description: Filter results by automatic upgrade version. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- custom,stable
- name: country_code
in: query
description: Filter results by country code. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- CA,FR
- name: honeypot_enabled
in: query
description: If Honeypot detection is enabled. Accepts multiple comma-separated boolean values.
style: form
explode: true
schema:
type: boolean
- name: id
in: query
description: Filter results by identifier. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- 00000000-0000-0000-0000-000000000001,00000000-0000-0000-0000-000000000002
- name: locate_unconnected
in: query
description: If unconnected client are located. Accepts multiple comma-separated boolean values.
style: form
explode: true
schema:
type: boolean
- name: mesh_enabled
in: query
description: If Mesh feature is enabled. Accepts multiple comma-separated boolean values.
style: form
explode: true
schema:
type: boolean
- name: name
in: query
description: Partial / full Site name. Case insensitive. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `my-site*` and `*site*` match `my-site-01`). Suffix-only wildcards (e.g. `*site-01`) are not supported. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- my-site-01,my-site*
- my-site-01
- my-site*
- '*site*'
examples:
Untitled Example1:
value: my-site-01,my-site*
Untitled Example2:
value: my-site-01
Untitled Example3:
value: my-site*
Untitled Example4:
value: '*site*'
- name: rogue_enabled
in: query
description: If Rogue detection is enabled. Accepts multiple comma-separated boolean values.
style: form
explode: true
schema:
type: boolean
- name: remote_syslog_enabled
in: query
description: If Remote Syslog is enabled
style: form
explode: true
schema:
type: boolean
- name: rtsa_enabled
in: query
description: If managed mobility feature is enabled. Accepts multiple comma-separated boolean values.
style: form
explode: true
schema:
type: boolean
- name: vna_enabled
in: query
description: If Virtual Network Assistant is enabled. Accepts multiple comma-separated boolean values.
style: form
explode: true
schema:
type: boolean
- name: wifi_enabled
in: query
description: If Wi-Fi feature is enabled
style: form
explode: true
schema:
type: boolean
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_site_search'
- description: Paginated response for organization site search results
examples:
- end: 0
limit: 0
next: string
results:
- auto_upgrade_enabled: true
auto_upgrade_version: string
country_code: string
honeypot_enabled: true
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
timestamp: 0
timezone: string
vna_enabled: true
wifi_enabled: true
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
end: 0
limit: 0
next: string
results:
- auto_upgrade_enabled: true
auto_upgrade_version: string
country_code: string
honeypot_enabled: true
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
timestamp: 0
timezone: string
vna_enabled: true
wifi_enabled: true
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_site_search'
- description: Paginated response for organization site search results
examples:
- end: 0
limit: 0
next: string
results:
- auto_upgrade_enabled: true
auto_upgrade_version: string
country_code: string
honeypot_enabled: true
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
timestamp: 0
timezone: string
vna_enabled: true
wifi_enabled: true
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 0
limit: 0
next: string
results:
- auto_upgrade_enabled: true
auto_upgrade_version: string
country_code: string
honeypot_enabled: true
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
timestamp: 0
timezone: string
vna_enabled: true
wifi_enabled: true
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/sitetemplates:
get:
tags:
- Orgs Site Templates
summary: listOrgSiteTemplates
description: List site templates configured in the organization. Site templates contain automatic upgrade settings and variables available to WLAN configuration.
operationId: listOrgSiteTemplates
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/site_template'
description: List of site templates
examples:
- - auto_upgrade:
day_of_week: mon
enabled: true
time_of_day: string
version: string
name: string
vars:
SSID_STR: string
VLAN_ID: string
contentMediaType: application/json
examples:
Example:
value:
- auto_upgrade:
day_of_week: mon
enabled: true
time_of_day: string
version: string
name: string
vars:
SSID_STR: string
VLAN_ID: string
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/site_template'
description: List of site templates
examples:
- - auto_upgrade:
day_of_week: mon
enabled: true
time_of_day: string
version: string
name: string
vars:
SSID_STR: string
VLAN_ID: string
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- auto_upgrade:
day_of_week: mon
enabled: true
time_of_day: string
version: string
name: string
vars:
SSID_STR: string
VLAN_ID: string
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs Site Templates
summary: createOrgSiteTemplate
description: >-
Create a site template with automatic upgrade settings and template
variables available to WLAN configuration.
To assign a Site template to a site, use the [Update Site]($e/Sites/updateSiteInfo) endpoint and specify the Site template ID in the `sitetemplate_id` field of the request body.'
operationId: createOrgSiteTemplate
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/site_template'
required: false
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/site_template'
- description: Site template containing auto-upgrade settings and template variables
examples:
- auto_upgrade:
day_of_week: mon
enabled: true
time_of_day: string
version: string
name: string
vars:
SSID_STR: string
VLAN_ID: string
contentMediaType: application/json
examples:
Example:
value:
auto_upgrade:
day_of_week: mon
enabled: true
time_of_day: string
version: string
name: string
vars:
SSID_STR: string
VLAN_ID: string
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/site_template'
- description: Site template containing auto-upgrade settings and template variables
examples:
- auto_upgrade:
day_of_week: mon
enabled: true
time_of_day: string
version: string
name: string
vars:
SSID_STR: string
VLAN_ID: string
contentMediaType: application/vnd.api+json
examples:
Example:
value:
auto_upgrade:
day_of_week: mon
enabled: true
time_of_day: string
version: string
name: string
vars:
SSID_STR: string
VLAN_ID: string
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/sitetemplates/{sitetemplate_id}:
delete:
tags:
- Orgs Site Templates
summary: deleteOrgSiteTemplate
description: Remove a site template from the organization.
operationId: deleteOrgSiteTemplate
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: sitetemplate_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Orgs Site Templates
summary: getOrgSiteTemplate
description: Return a site template, including automatic upgrade settings and template variables available to WLAN configuration.
operationId: getOrgSiteTemplate
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: sitetemplate_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/site_template'
- description: Site template containing auto-upgrade settings and template variables
examples:
- auto_upgrade:
day_of_week: mon
enabled: true
time_of_day: string
version: string
name: string
vars:
SSID_STR: string
VLAN_ID: string
contentMediaType: application/json
examples:
Example:
value:
auto_upgrade:
day_of_week: mon
enabled: true
time_of_day: string
version: string
name: string
vars:
SSID_STR: string
VLAN_ID: string
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/site_template'
- description: Site template containing auto-upgrade settings and template variables
examples:
- auto_upgrade:
day_of_week: mon
enabled: true
time_of_day: string
version: string
name: string
vars:
SSID_STR: string
VLAN_ID: string
contentMediaType: application/vnd.api+json
examples:
Example:
value:
auto_upgrade:
day_of_week: mon
enabled: true
time_of_day: string
version: string
name: string
vars:
SSID_STR: string
VLAN_ID: string
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Orgs Site Templates
summary: updateOrgSiteTemplate
description: Update a site template's automatic upgrade settings and template variables available to WLAN configuration.
operationId: updateOrgSiteTemplate
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: sitetemplate_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/site_template'
required: false
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/site_template'
- description: Site template containing auto-upgrade settings and template variables
examples:
- auto_upgrade:
day_of_week: mon
enabled: true
time_of_day: string
version: string
name: string
vars:
SSID_STR: string
VLAN_ID: string
contentMediaType: application/json
examples:
Example:
value:
auto_upgrade:
day_of_week: mon
enabled: true
time_of_day: string
version: string
name: string
vars:
SSID_STR: string
VLAN_ID: string
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/site_template'
- description: Site template containing auto-upgrade settings and template variables
examples:
- auto_upgrade:
day_of_week: mon
enabled: true
time_of_day: string
version: string
name: string
vars:
SSID_STR: string
VLAN_ID: string
contentMediaType: application/vnd.api+json
examples:
Example:
value:
auto_upgrade:
day_of_week: mon
enabled: true
time_of_day: string
version: string
name: string
vars:
SSID_STR: string
VLAN_ID: string
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/insights/sites-sle:
get:
tags:
- Orgs SLEs
summary: getOrgSitesSle
description: Return per-site Service-Level Expectation (SLE) scores for Wi-Fi, wired, or WAN service over the requested time window.
operationId: getOrgSitesSle
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: sle
in: query
description: 'Filter insights by SLE name. enum: `wan`, `wifi`, `wired`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/org_site_sle_type'
- description: 'Filter insights by SLE name. enum: `wan`, `wifi`, `wired`'
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: interval
in: query
description: Aggregation works by giving a time range plus interval (e.g. 1d, 1h, 10m) where aggregation function would be applied to.
style: form
explode: true
schema:
type: string
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_org_site_sle'
- description: Organization site SLE response for Wi-Fi, wired, or WAN
examples:
- '{"end":1651323600,"interval":3600,"limit":1,"page":2,"results":[{"application_health":0.8250000047942866,"gateway-health":1,"num_clients":65,"num_gateways":1,"site_id":"f5fcbee5-1234-5678-9101-1619ede87879","wan-link-health":0.9988471089272484}],"start":1651269600,"total":4}'
- '{"end":1651323600,"interval":3600,"limit":1,"page":2,"results":[{"ap-availability":1,"ap-health":0.6735632316819553,"capacity":0.9802900770150502,"coverage":0.812181632387686,"num_aps":3,"num_clients":24,"roaming":1,"site_id":"f5fcbee5-1234-5678-9101-1619ede87879","successful-connect":0.9535864983932881,"throughput":1,"time-to-connect":0.9791666666666666}],"start":1651269600,"total":4}'
- '{"end":1651323600,"interval":3600,"limit":1,"page":2,"results":[{"num_clients":6,"num_switches":1,"site_id":"f5fcbee5-1234-5678-9101-1619ede87879","switch-bandwidth":0.9669529756744796,"switch-health":1,"switch-throughput":1}],"start":1651269600,"total":4}'
contentMediaType: application/json
examples:
WAN SLE:
value:
end: 1651323600
interval: 3600
limit: 1
page: 2
results:
- application_health: 0.8250000047942866
gateway-health: 1
num_clients: 65
num_gateways: 1
site_id: f5fcbee5-1234-5678-9101-1619ede87879
wan-link-health: 0.9988471089272484
start: 1651269600
total: 4
Wi-Fi SLE:
value:
end: 1651323600
interval: 3600
limit: 1
page: 2
results:
- ap-availability: 1
ap-health: 0.6735632316819553
capacity: 0.9802900770150502
coverage: 0.812181632387686
num_aps: 3
num_clients: 24
roaming: 1
site_id: f5fcbee5-1234-5678-9101-1619ede87879
successful-connect: 0.9535864983932881
throughput: 1
time-to-connect: 0.9791666666666666
start: 1651269600
total: 4
Wired SLE:
value:
end: 1651323600
interval: 3600
limit: 1
page: 2
results:
- num_clients: 6
num_switches: 1
site_id: f5fcbee5-1234-5678-9101-1619ede87879
switch-bandwidth: 0.9669529756744796
switch-health: 1
switch-throughput: 1
start: 1651269600
total: 4
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_org_site_sle'
- description: Organization site SLE response for Wi-Fi, wired, or WAN
examples:
- '{"end":1651323600,"interval":3600,"limit":1,"page":2,"results":[{"application_health":0.8250000047942866,"gateway-health":1,"num_clients":65,"num_gateways":1,"site_id":"f5fcbee5-1234-5678-9101-1619ede87879","wan-link-health":0.9988471089272484}],"start":1651269600,"total":4}'
- '{"end":1651323600,"interval":3600,"limit":1,"page":2,"results":[{"ap-availability":1,"ap-health":0.6735632316819553,"capacity":0.9802900770150502,"coverage":0.812181632387686,"num_aps":3,"num_clients":24,"roaming":1,"site_id":"f5fcbee5-1234-5678-9101-1619ede87879","successful-connect":0.9535864983932881,"throughput":1,"time-to-connect":0.9791666666666666}],"start":1651269600,"total":4}'
- '{"end":1651323600,"interval":3600,"limit":1,"page":2,"results":[{"num_clients":6,"num_switches":1,"site_id":"f5fcbee5-1234-5678-9101-1619ede87879","switch-bandwidth":0.9669529756744796,"switch-health":1,"switch-throughput":1}],"start":1651269600,"total":4}'
contentMediaType: application/vnd.api+json
examples:
WAN SLE:
value:
end: 1651323600
interval: 3600
limit: 1
page: 2
results:
- application_health: 0.8250000047942866
gateway-health: 1
num_clients: 65
num_gateways: 1
site_id: f5fcbee5-1234-5678-9101-1619ede87879
wan-link-health: 0.9988471089272484
start: 1651269600
total: 4
Wi-Fi SLE:
value:
end: 1651323600
interval: 3600
limit: 1
page: 2
results:
- ap-availability: 1
ap-health: 0.6735632316819553
capacity: 0.9802900770150502
coverage: 0.812181632387686
num_aps: 3
num_clients: 24
roaming: 1
site_id: f5fcbee5-1234-5678-9101-1619ede87879
successful-connect: 0.9535864983932881
throughput: 1
time-to-connect: 0.9791666666666666
start: 1651269600
total: 4
Wired SLE:
value:
end: 1651323600
interval: 3600
limit: 1
page: 2
results:
- num_clients: 6
num_switches: 1
site_id: f5fcbee5-1234-5678-9101-1619ede87879
switch-bandwidth: 0.9669529756744796
switch-health: 1
switch-throughput: 1
start: 1651269600
total: 4
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/insights/{metric}:
get:
tags:
- Orgs SLEs
summary: getOrgSle
description: Return organization-level insight data for the selected metric, such as all or worst sites, Mist Edge insights, or other supported insight metrics, over the requested time window.
operationId: getOrgSle
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: metric
in: path
description: See [List Insight Metrics]($e/Constants%20Definitions/listInsightMetrics) for available metrics
required: true
schema:
type: string
- name: sle
in: query
description: See [List Insight Metrics]($e/Constants%20Definitions/listInsightMetrics) for more details
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: interval
in: query
description: Aggregation works by giving a time range plus interval (e.g. 1d, 1h, 10m) where aggregation function would be applied to.
style: form
explode: true
schema:
type: string
examples:
- 10m
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/insight_metrics'
- description: Insight metric response for a requested time range and aggregation interval
examples:
- end: 1643706000
interval: 3600
limit: 100
results:
- ap-availability: 0.9919400860511628
ap-health: 0.967607512909879
capacity: 0.7484652273070254
coverage: 0.91217567374857
num_aps: 13
num_clients: 12
roaming: 0.991735537682683
roaming-exp: 0.991735537682683
site_id: ab0aca7a-d45c-469b-b3bb-4fe240642d0b
successful-connect: 0.46052632135780236
throughput: 0.6775702123846302
time-to-connect: 0.9349112447196916
- ap-availability: 0.9990384613092129
ap-health: 0.48201754375507955
capacity: 0.9702673450306101
coverage: 0.8335392334930375
num_aps: 1
num_clients: 6
roaming: 1
roaming-exp: 1
site_id: 49ff76e0-a283-4e7d-b38d-041f1e9aff3c
successful-connect: 1
throughput: 0
time-to-connect: 1
- ap-availability: 1
ap-health: 0.982456140612301
capacity: 1
coverage: 0.9276041182442488
num_aps: 2
num_clients: 3
roaming: 1
roaming-exp: 1
site_id: 9b9b48f1-15a4-459e-86cc-9cbec9005983
successful-connect: 1
throughput: 1
time-to-connect: 0.8125
- ap-availability: 0.9981132070973234
ap-health: 0.9991228068084047
capacity: 1
coverage: 1
num_aps: 1
num_clients: 0
roaming: 1
roaming-exp: 1
site_id: eb0e1671-7a6b-472b-94c3-c187dafe5274
successful-connect: 1
throughput: 0
time-to-connect: 0.5
start: 1643670000
contentMediaType: application/json
examples:
Worst Sites By Sle:
value:
end: 1643706000
interval: 3600
limit: 100
results:
- ap-availability: 0.9919400860511628
ap-health: 0.967607512909879
capacity: 0.7484652273070254
coverage: 0.91217567374857
num_aps: 13
num_clients: 12
roaming: 0.991735537682683
roaming-exp: 0.991735537682683
site_id: ab0aca7a-d45c-469b-b3bb-4fe240642d0b
successful-connect: 0.46052632135780236
throughput: 0.6775702123846302
time-to-connect: 0.9349112447196916
- ap-availability: 0.9990384613092129
ap-health: 0.48201754375507955
capacity: 0.9702673450306101
coverage: 0.8335392334930375
num_aps: 1
num_clients: 6
roaming: 1
roaming-exp: 1
site_id: 49ff76e0-a283-4e7d-b38d-041f1e9aff3c
successful-connect: 1
throughput: 0
time-to-connect: 1
- ap-availability: 1
ap-health: 0.982456140612301
capacity: 1
coverage: 0.9276041182442488
num_aps: 2
num_clients: 3
roaming: 1
roaming-exp: 1
site_id: 9b9b48f1-15a4-459e-86cc-9cbec9005983
successful-connect: 1
throughput: 1
time-to-connect: 0.8125
- ap-availability: 0.9981132070973234
ap-health: 0.9991228068084047
capacity: 1
coverage: 1
num_aps: 1
num_clients: 0
roaming: 1
roaming-exp: 1
site_id: eb0e1671-7a6b-472b-94c3-c187dafe5274
successful-connect: 1
throughput: 0
time-to-connect: 0.5
start: 1643670000
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/insight_metrics'
- description: Insight metric response for a requested time range and aggregation interval
examples:
- end: 1643706000
interval: 3600
limit: 100
results:
- ap-availability: 0.9919400860511628
ap-health: 0.967607512909879
capacity: 0.7484652273070254
coverage: 0.91217567374857
num_aps: 13
num_clients: 12
roaming: 0.991735537682683
roaming-exp: 0.991735537682683
site_id: ab0aca7a-d45c-469b-b3bb-4fe240642d0b
successful-connect: 0.46052632135780236
throughput: 0.6775702123846302
time-to-connect: 0.9349112447196916
- ap-availability: 0.9990384613092129
ap-health: 0.48201754375507955
capacity: 0.9702673450306101
coverage: 0.8335392334930375
num_aps: 1
num_clients: 6
roaming: 1
roaming-exp: 1
site_id: 49ff76e0-a283-4e7d-b38d-041f1e9aff3c
successful-connect: 1
throughput: 0
time-to-connect: 1
- ap-availability: 1
ap-health: 0.982456140612301
capacity: 1
coverage: 0.9276041182442488
num_aps: 2
num_clients: 3
roaming: 1
roaming-exp: 1
site_id: 9b9b48f1-15a4-459e-86cc-9cbec9005983
successful-connect: 1
throughput: 1
time-to-connect: 0.8125
- ap-availability: 0.9981132070973234
ap-health: 0.9991228068084047
capacity: 1
coverage: 1
num_aps: 1
num_clients: 0
roaming: 1
roaming-exp: 1
site_id: eb0e1671-7a6b-472b-94c3-c187dafe5274
successful-connect: 1
throughput: 0
time-to-connect: 0.5
start: 1643670000
contentMediaType: application/vnd.api+json
examples:
Worst Sites By Sle:
value:
end: 1643706000
interval: 3600
limit: 100
results:
- ap-availability: 0.9919400860511628
ap-health: 0.967607512909879
capacity: 0.7484652273070254
coverage: 0.91217567374857
num_aps: 13
num_clients: 12
roaming: 0.991735537682683
roaming-exp: 0.991735537682683
site_id: ab0aca7a-d45c-469b-b3bb-4fe240642d0b
successful-connect: 0.46052632135780236
throughput: 0.6775702123846302
time-to-connect: 0.9349112447196916
- ap-availability: 0.9990384613092129
ap-health: 0.48201754375507955
capacity: 0.9702673450306101
coverage: 0.8335392334930375
num_aps: 1
num_clients: 6
roaming: 1
roaming-exp: 1
site_id: 49ff76e0-a283-4e7d-b38d-041f1e9aff3c
successful-connect: 1
throughput: 0
time-to-connect: 1
- ap-availability: 1
ap-health: 0.982456140612301
capacity: 1
coverage: 0.9276041182442488
num_aps: 2
num_clients: 3
roaming: 1
roaming-exp: 1
site_id: 9b9b48f1-15a4-459e-86cc-9cbec9005983
successful-connect: 1
throughput: 1
time-to-connect: 0.8125
- ap-availability: 0.9981132070973234
ap-health: 0.9991228068084047
capacity: 1
coverage: 1
num_aps: 1
num_clients: 0
roaming: 1
roaming-exp: 1
site_id: eb0e1671-7a6b-472b-94c3-c187dafe5274
successful-connect: 1
throughput: 0
time-to-connect: 0.5
start: 1643670000
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/ssoroles:
get:
tags:
- Orgs SSO Roles
summary: listOrgSsoRoles
description: List organization SSO role definitions that map identity-provider role assertions to organization, site, or site group privilege scopes.
operationId: listOrgSsoRoles
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/sso_role_org'
description: Organization SSO roles returned by the request
contentMediaType: application/json
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/sso_role_org'
description: Organization SSO roles returned by the request
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs SSO Roles
summary: createOrgSsoRole
description: Create an organization SSO role definition with a display name and the privileges granted when the role is matched during SSO.
operationId: createOrgSsoRole
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sso_role_org'
- description: Request Body
examples:
- '{"name":"string","privileges":[{"org_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","role":"admin","scope":"org"},{"role":"read","scope":"site","site_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1"},{"org_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","role":"read","scope":"sitegroup","sitegroup_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1"}]}'
contentMediaType: application/json
examples:
Example:
value:
name: string
privileges:
- org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
role: admin
scope: org
- role: read
scope: site
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
- org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
role: read
scope: sitegroup
sitegroup_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sso_role_org'
- description: Organization SSO role definition
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
privileges:
- role: admin
scope: sitegroup
sitegroup_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
privileges:
- role: admin
scope: sitegroup
sitegroup_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/sso_role_org'
- description: Organization SSO role definition
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
privileges:
- role: admin
scope: sitegroup
sitegroup_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
privileges:
- role: admin
scope: sitegroup
sitegroup_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/ssoroles/{ssorole_id}:
delete:
tags:
- Orgs SSO Roles
summary: deleteOrgSsoRole
description: Delete an organization SSO role definition so it can no longer grant privileges during SSO.
operationId: deleteOrgSsoRole
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: ssorole_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Orgs SSO Roles
summary: getOrgSsoRole
description: Return one organization SSO role definition, including its display name and granted privileges.
operationId: getOrgSsoRole
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: ssorole_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sso_role_org'
- description: Organization SSO role definition
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
privileges:
- role: admin
scope: sitegroup
sitegroup_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
privileges:
- role: admin
scope: sitegroup
sitegroup_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/sso_role_org'
- description: Organization SSO role definition
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
privileges:
- role: admin
scope: sitegroup
sitegroup_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
privileges:
- role: admin
scope: sitegroup
sitegroup_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Orgs SSO Roles
summary: updateOrgSsoRole
description: Update an organization SSO role definition, including its display name and granted privileges.
operationId: updateOrgSsoRole
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: ssorole_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sso_role_org'
- description: Request Body
examples:
- '{"name":"string","privileges":[{"org_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","role":"admin","scope":"org"},{"role":"read","scope":"site","site_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1"},{"org_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","role":"read","scope":"sitegroup","sitegroup_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1"}]}'
contentMediaType: application/json
examples:
Example:
value:
name: string
privileges:
- org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
role: admin
scope: org
- role: read
scope: site
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
- org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
role: read
scope: sitegroup
sitegroup_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sso_role_org'
- description: Organization SSO role definition
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
privileges:
- role: admin
scope: sitegroup
sitegroup_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
privileges:
- role: admin
scope: sitegroup
sitegroup_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/sso_role_org'
- description: Organization SSO role definition
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
privileges:
- role: admin
scope: sitegroup
sitegroup_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
privileges:
- role: admin
scope: sitegroup
sitegroup_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/ssos:
get:
tags:
- Orgs SSO
summary: listOrgSsos
description: List SSO identity provider configurations defined for this organization.
operationId: listOrgSsos
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/sso'
description: List of SSO configurations
examples:
- - created_time: 0
custom_logout_url: string
default_role: string
domain: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
idp_cert: string
idp_sign_algo: sha256
idp_sso_url: string
ignore_unmatched_roles: true
issuer: string
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
nameid_format: email
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
type: string
contentMediaType: application/json
examples:
Example:
value:
- created_time: 0
custom_logout_url: string
default_role: string
domain: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
idp_cert: string
idp_sign_algo: sha256
idp_sso_url: string
ignore_unmatched_roles: true
issuer: string
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
nameid_format: email
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
type: string
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/sso'
description: List of SSO configurations
examples:
- - created_time: 0
custom_logout_url: string
default_role: string
domain: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
idp_cert: string
idp_sign_algo: sha256
idp_sso_url: string
ignore_unmatched_roles: true
issuer: string
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
nameid_format: email
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
type: string
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- created_time: 0
custom_logout_url: string
default_role: string
domain: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
idp_cert: string
idp_sign_algo: sha256
idp_sso_url: string
ignore_unmatched_roles: true
issuer: string
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
nameid_format: email
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
type: string
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs SSO
summary: createOrgSso
description: Create an organization SSO identity provider configuration, including provider settings and role-handling behavior.
operationId: createOrgSso
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sso'
- description: Request Body
examples:
- custom_logout_url: string
idp_cert: string
idp_sign_algo: sha256
idp_sso_url: string
ignore_unmatched_roles: true
issuer: string
name: string
nameid_format: email
contentMediaType: application/json
examples:
Example:
value:
custom_logout_url: string
idp_cert: string
idp_sign_algo: sha256
idp_sso_url: string
ignore_unmatched_roles: true
issuer: string
name: string
nameid_format: email
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sso'
- description: Single sign-on identity provider configuration
examples:
- created_time: 0
custom_logout_url: string
default_role: string
domain: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
idp_cert: string
idp_sign_algo: sha256
idp_sso_url: string
ignore_unmatched_roles: true
issuer: string
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
nameid_format: email
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
type: string
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
custom_logout_url: string
default_role: string
domain: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
idp_cert: string
idp_sign_algo: sha256
idp_sso_url: string
ignore_unmatched_roles: true
issuer: string
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
nameid_format: email
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
type: string
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/sso'
- description: Single sign-on identity provider configuration
examples:
- created_time: 0
custom_logout_url: string
default_role: string
domain: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
idp_cert: string
idp_sign_algo: sha256
idp_sso_url: string
ignore_unmatched_roles: true
issuer: string
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
nameid_format: email
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
type: string
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
custom_logout_url: string
default_role: string
domain: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
idp_cert: string
idp_sign_algo: sha256
idp_sso_url: string
ignore_unmatched_roles: true
issuer: string
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
nameid_format: email
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
type: string
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/ssos/{sso_id}:
delete:
tags:
- Orgs SSO
summary: deleteOrgSso
description: Delete an organization SSO identity provider configuration so it can no longer be used for administrator login.
operationId: deleteOrgSso
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: sso_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Orgs SSO
summary: getOrgSso
description: Return one organization SSO identity provider configuration, including provider settings and generated SSO URLs.
operationId: getOrgSso
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: sso_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sso'
- description: Single sign-on identity provider configuration
examples:
- created_time: 0
custom_logout_url: string
default_role: string
domain: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
idp_cert: string
idp_sign_algo: sha256
idp_sso_url: string
ignore_unmatched_roles: true
issuer: string
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
nameid_format: email
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
type: string
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
custom_logout_url: string
default_role: string
domain: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
idp_cert: string
idp_sign_algo: sha256
idp_sso_url: string
ignore_unmatched_roles: true
issuer: string
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
nameid_format: email
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
type: string
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/sso'
- description: Single sign-on identity provider configuration
examples:
- created_time: 0
custom_logout_url: string
default_role: string
domain: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
idp_cert: string
idp_sign_algo: sha256
idp_sso_url: string
ignore_unmatched_roles: true
issuer: string
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
nameid_format: email
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
type: string
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
custom_logout_url: string
default_role: string
domain: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
idp_cert: string
idp_sign_algo: sha256
idp_sso_url: string
ignore_unmatched_roles: true
issuer: string
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
nameid_format: email
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
type: string
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Orgs SSO
summary: updateOrgSso
description: Update an organization SSO identity provider configuration, such as IdP URLs, certificates, issuer, NameID format, and unmatched-role handling.
operationId: updateOrgSso
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: sso_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sso'
- description: Request Body
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sso'
- description: Single sign-on identity provider configuration
examples:
- created_time: 0
custom_logout_url: string
default_role: string
domain: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
idp_cert: string
idp_sign_algo: sha256
idp_sso_url: string
ignore_unmatched_roles: true
issuer: string
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
nameid_format: email
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
type: string
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
custom_logout_url: string
default_role: string
domain: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
idp_cert: string
idp_sign_algo: sha256
idp_sso_url: string
ignore_unmatched_roles: true
issuer: string
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
nameid_format: email
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
type: string
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/sso'
- description: Single sign-on identity provider configuration
examples:
- created_time: 0
custom_logout_url: string
default_role: string
domain: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
idp_cert: string
idp_sign_algo: sha256
idp_sso_url: string
ignore_unmatched_roles: true
issuer: string
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
nameid_format: email
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
type: string
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
custom_logout_url: string
default_role: string
domain: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
idp_cert: string
idp_sign_algo: sha256
idp_sso_url: string
ignore_unmatched_roles: true
issuer: string
modified_time: 0
msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
nameid_format: email
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
type: string
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/ssos/{sso_id}/delete_admins:
post:
tags:
- Orgs SSO
summary: deleteOrgSsoAdmins
description: Remove SSO-linked organization administrator accounts by email for this SSO profile.
operationId: deleteOrgSsoAdmins
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: sso_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sso_delete_admins'
- description: Request Body
examples:
- emails:
- john@abc.com
- may@abc.com
contentMediaType: application/json
examples:
Example:
value:
emails:
- john@abc.com
- may@abc.com
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sso_delete_admins_response'
- description: Result of deleting SSO admin accounts
contentMediaType: application/json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/ssos/{sso_id}/failures:
get:
tags:
- Orgs SSO
summary: listOrgSsoLatestFailures
description: List recent authentication failures for this organization SSO configuration, including failure details and captured SAML assertion data when available.
operationId: listOrgSsoLatestFailures
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: sso_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_sso_failure_search'
- description: Response containing recent SSO authentication failure records
examples:
- results:
- detail: string
saml_assertion_xml: string
timestamp: 0
contentMediaType: application/json
examples:
Example:
value:
results:
- detail: string
saml_assertion_xml: string
timestamp: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_sso_failure_search'
- description: Response containing recent SSO authentication failure records
examples:
- results:
- detail: string
saml_assertion_xml: string
timestamp: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
results:
- detail: string
saml_assertion_xml: string
timestamp: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/ssos/{sso_id}/metadata:
get:
tags:
- Orgs SSO
summary: getOrgSamlMetadata
description: Return generated SAML service provider metadata for this organization SSO configuration as JSON.
operationId: getOrgSamlMetadata
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: sso_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/saml_metadata'
- description: Read-only SAML and SCIM metadata generated for an SSO configuration
examples:
- acs_url: https://api.mist.com/api/v1/saml/llDfa13f/login
entity_id: https://api.mist.com/api/v1/saml/llDfa13f/login
logout_url: https://api.mist.com/api/v1/saml/llDfa13f/logout
metadata: urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified
contentMediaType: application/json
examples:
Example:
value:
acs_url: https://api.mist.com/api/v1/saml/llDfa13f/login
entity_id: https://api.mist.com/api/v1/saml/llDfa13f/login
logout_url: https://api.mist.com/api/v1/saml/llDfa13f/logout
metadata: urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/saml_metadata'
- description: Read-only SAML and SCIM metadata generated for an SSO configuration
examples:
- acs_url: https://api.mist.com/api/v1/saml/llDfa13f/login
entity_id: https://api.mist.com/api/v1/saml/llDfa13f/login
logout_url: https://api.mist.com/api/v1/saml/llDfa13f/logout
metadata: urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified
contentMediaType: application/vnd.api+json
examples:
Example:
value:
acs_url: https://api.mist.com/api/v1/saml/llDfa13f/login
entity_id: https://api.mist.com/api/v1/saml/llDfa13f/login
logout_url: https://api.mist.com/api/v1/saml/llDfa13f/logout
metadata: urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/ssos/{sso_id}/metadata.xml:
get:
tags:
- Orgs SSO
summary: downloadOrgSamlMetadata
description: >-
Download generated SAML service provider metadata XML for this
organization SSO configuration. Use this XML to configure the identity provider
with Mist service-provider details such as entity ID, ACS URL, logout URL,
NameID format, and requested attributes.
Example of metadata.xml:
```xml
urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified
Mist
```
operationId: downloadOrgSamlMetadata
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: sso_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: string
description: File
contentEncoding: base64
contentMediaType: application/json
application/vnd.api+json:
schema:
type: string
description: File
contentEncoding: base64
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/templates:
get:
tags:
- Orgs WLAN Templates
summary: listOrgTemplates
description: Get List of Org WLAN Templates
operationId: listOrgTemplates
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/template'
description: WLAN template records returned by a template list response
examples:
- - applies:
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
created_time: 0
deviceprofile_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
exceptions:
site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
filter_by_deviceprofile: true
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/json
examples:
Example:
value:
- applies:
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
created_time: 0
deviceprofile_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
exceptions:
site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
filter_by_deviceprofile: true
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/template'
description: WLAN template records returned by a template list response
examples:
- - applies:
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
created_time: 0
deviceprofile_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
exceptions:
site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
filter_by_deviceprofile: true
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- applies:
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
created_time: 0
deviceprofile_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
exceptions:
site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
filter_by_deviceprofile: true
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs WLAN Templates
summary: createOrgTemplate
description: Create Org Template
operationId: createOrgTemplate
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/template'
- description: Request Body
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/template'
- description: WLAN template configuration applied across sites or site groups
examples:
- applies:
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
created_time: 0
deviceprofile_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
exceptions:
site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
filter_by_deviceprofile: true
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/json
examples:
Example:
value:
applies:
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
created_time: 0
deviceprofile_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
exceptions:
site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
filter_by_deviceprofile: true
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/template'
- description: WLAN template configuration applied across sites or site groups
examples:
- applies:
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
created_time: 0
deviceprofile_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
exceptions:
site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
filter_by_deviceprofile: true
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
applies:
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
created_time: 0
deviceprofile_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
exceptions:
site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
filter_by_deviceprofile: true
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/templates/{template_id}:
delete:
tags:
- Orgs WLAN Templates
summary: deleteOrgTemplate
description: Delete Org Template
operationId: deleteOrgTemplate
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: template_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Orgs WLAN Templates
summary: getOrgTemplate
description: Get Org Template Details
operationId: getOrgTemplate
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: template_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/template'
- description: WLAN template configuration applied across sites or site groups
examples:
- applies:
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
created_time: 0
deviceprofile_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
exceptions:
site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
filter_by_deviceprofile: true
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/json
examples:
Example:
value:
applies:
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
created_time: 0
deviceprofile_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
exceptions:
site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
filter_by_deviceprofile: true
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/template'
- description: WLAN template configuration applied across sites or site groups
examples:
- applies:
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
created_time: 0
deviceprofile_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
exceptions:
site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
filter_by_deviceprofile: true
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
applies:
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
created_time: 0
deviceprofile_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
exceptions:
site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
filter_by_deviceprofile: true
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Orgs WLAN Templates
summary: updateOrgTemplate
description: Update Org Template
operationId: updateOrgTemplate
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: template_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/template'
- description: Request Body
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/template'
- description: WLAN template configuration applied across sites or site groups
examples:
- applies:
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
created_time: 0
deviceprofile_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
exceptions:
site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
filter_by_deviceprofile: true
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/json
examples:
Example:
value:
applies:
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
created_time: 0
deviceprofile_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
exceptions:
site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
filter_by_deviceprofile: true
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/template'
- description: WLAN template configuration applied across sites or site groups
examples:
- applies:
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
created_time: 0
deviceprofile_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
exceptions:
site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
filter_by_deviceprofile: true
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
applies:
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
created_time: 0
deviceprofile_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
exceptions:
site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
filter_by_deviceprofile: true
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/templates/{template_id}/clone:
post:
tags:
- Orgs WLAN Templates
summary: cloneOrgTemplate
description: Clone Org Template
operationId: cloneOrgTemplate
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: template_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/name_string'
- description: Request Body
examples:
- name: Cloned
contentMediaType: application/json
examples:
Example:
value:
name: Cloned
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/template'
- description: WLAN template configuration applied across sites or site groups
examples:
- applies:
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
created_time: 0
deviceprofile_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
exceptions:
site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
filter_by_deviceprofile: true
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/json
examples:
Example:
value:
applies:
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
created_time: 0
deviceprofile_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
exceptions:
site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
filter_by_deviceprofile: true
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/template'
- description: WLAN template configuration applied across sites or site groups
examples:
- applies:
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
created_time: 0
deviceprofile_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
exceptions:
site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
filter_by_deviceprofile: true
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
applies:
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
created_time: 0
deviceprofile_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
exceptions:
site_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
filter_by_deviceprofile: true
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/tickets:
get:
tags:
- Orgs Tickets
summary: listOrgTickets
description: Get List of Tickets of an Org
operationId: listOrgTickets
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/ticket'
description: Support ticket records returned by a ticket list response
examples:
- - comments:
- attachments:
- content_type: string
content_url: string
author: string
comment: string
created_at: 0
created_at: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
requester: string
status: open
subject: string
type: string
updated_at: 0
contentMediaType: application/json
examples:
Example:
value:
- comments:
- attachments:
- content_type: string
content_url: string
author: string
comment: string
created_at: 0
created_at: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
requester: string
status: open
subject: string
type: string
updated_at: 0
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/ticket'
description: Support ticket records returned by a ticket list response
examples:
- - comments:
- attachments:
- content_type: string
content_url: string
author: string
comment: string
created_at: 0
created_at: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
requester: string
status: open
subject: string
type: string
updated_at: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- comments:
- attachments:
- content_type: string
content_url: string
author: string
comment: string
created_at: 0
created_at: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
requester: string
status: open
subject: string
type: string
updated_at: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs Tickets
summary: createOrgTicket
description: Create a support ticket
operationId: createOrgTicket
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ticket'
- description: Request Body
examples:
- comment: string
subject: string
type: question
contentMediaType: application/json
examples:
Example:
value:
comment: string
subject: string
type: question
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ticket'
- description: Support ticket record with status, comments, and metadata
examples:
- comments:
- attachments:
- content_type: string
content_url: string
author: string
comment: string
created_at: 0
created_at: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
requester: string
status: open
subject: string
type: string
updated_at: 0
contentMediaType: application/json
examples:
Example:
value:
comments:
- attachments:
- content_type: string
content_url: string
author: string
comment: string
created_at: 0
created_at: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
requester: string
status: open
subject: string
type: string
updated_at: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/ticket'
- description: Support ticket record with status, comments, and metadata
examples:
- comments:
- attachments:
- content_type: string
content_url: string
author: string
comment: string
created_at: 0
created_at: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
requester: string
status: open
subject: string
type: string
updated_at: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
comments:
- attachments:
- content_type: string
content_url: string
author: string
comment: string
created_at: 0
created_at: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
requester: string
status: open
subject: string
type: string
updated_at: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/tickets/count:
get:
tags:
- Orgs Tickets
summary: countOrgTickets
description: Count by Distinct Attributes of Org Tickets
operationId: countOrgTickets
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field used to group this count response. enum: `status`, `type`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/org_tickets_count_distinct'
- description: 'Field used to group this count response. enum: `status`, `type`'
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/tickets/{ticket_id}:
get:
tags:
- Orgs Tickets
summary: getOrgTicket
description: Get support ticket details
operationId: getOrgTicket
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: ticket_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ticket'
- description: Support ticket record with status, comments, and metadata
examples:
- comments:
- attachments:
- content_type: string
content_url: string
author: string
comment: string
created_at: 0
created_at: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
requester: string
status: open
subject: string
type: string
updated_at: 0
contentMediaType: application/json
examples:
Example:
value:
comments:
- attachments:
- content_type: string
content_url: string
author: string
comment: string
created_at: 0
created_at: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
requester: string
status: open
subject: string
type: string
updated_at: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/ticket'
- description: Support ticket record with status, comments, and metadata
examples:
- comments:
- attachments:
- content_type: string
content_url: string
author: string
comment: string
created_at: 0
created_at: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
requester: string
status: open
subject: string
type: string
updated_at: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
comments:
- attachments:
- content_type: string
content_url: string
author: string
comment: string
created_at: 0
created_at: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
requester: string
status: open
subject: string
type: string
updated_at: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Orgs Tickets
summary: updateOrgTicket
description: Update support ticket
operationId: updateOrgTicket
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: ticket_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ticket'
- description: Request Body
examples:
- comment: string
subject: string
type: question
contentMediaType: application/json
examples:
Example:
value:
comment: string
subject: string
type: question
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ticket'
- description: Support ticket record with status, comments, and metadata
examples:
- comments:
- attachments:
- content_type: string
content_url: string
author: string
comment: string
created_at: 0
created_at: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
requester: string
status: open
subject: string
type: string
updated_at: 0
contentMediaType: application/json
examples:
Example:
value:
comments:
- attachments:
- content_type: string
content_url: string
author: string
comment: string
created_at: 0
created_at: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
requester: string
status: open
subject: string
type: string
updated_at: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/ticket'
- description: Support ticket record with status, comments, and metadata
examples:
- comments:
- attachments:
- content_type: string
content_url: string
author: string
comment: string
created_at: 0
created_at: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
requester: string
status: open
subject: string
type: string
updated_at: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
comments:
- attachments:
- content_type: string
content_url: string
author: string
comment: string
created_at: 0
created_at: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
requester: string
status: open
subject: string
type: string
updated_at: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/tickets/{ticket_id}/attachments:
post:
tags:
- Orgs Tickets
summary: UploadOrgTicketAttachment
description: Get Org ticket Attachment
operationId: UploadOrgTicketAttachment
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: ticket_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
content:
multipart/form-data:
encoding: {}
schema:
type: object
properties:
file:
type: string
description: Ekahau or ibwave file
contentEncoding: base64
contentMediaType: multipart/form-data
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/tickets/{ticket_id}/attachments/{attachment_id}:
get:
tags:
- Orgs Tickets
summary: GetOrgTicketAttachment
description: Get Org ticket Attachment
operationId: GetOrgTicketAttachment
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: ticket_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: attachment_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ticket_attachment'
- description: Download information for a support ticket attachment
examples:
- content_url: https://api.mist.com/api/v1/forward/download?jwt=...
contentMediaType: application/json
examples:
Example:
value:
content_url: https://api.mist.com/api/v1/forward/download?jwt=...
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/ticket_attachment'
- description: Download information for a support ticket attachment
examples:
- content_url: https://api.mist.com/api/v1/forward/download?jwt=...
contentMediaType: application/vnd.api+json
examples:
Example:
value:
content_url: https://api.mist.com/api/v1/forward/download?jwt=...
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/tickets/{ticket_id}/comments:
post:
tags:
- Orgs Tickets
summary: addOrgTicketComment
description: Add Comment to support ticket
operationId: addOrgTicketComment
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: ticket_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
content:
multipart/form-data:
encoding: {}
schema:
type: object
properties:
comment:
type: string
description: Text body for the ticket comment submitted with the uploaded file
examples:
- this is urgent
file:
type: string
description: Binary file payload to attach to the ticket comment
contentEncoding: base64
contentMediaType: multipart/form-data
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ticket'
- description: Support ticket record with status, comments, and metadata
examples:
- comments:
- attachments:
- content_type: string
content_url: string
author: string
comment: string
created_at: 0
created_at: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
requester: string
status: open
subject: string
type: string
updated_at: 0
contentMediaType: application/json
examples:
Example:
value:
comments:
- attachments:
- content_type: string
content_url: string
author: string
comment: string
created_at: 0
created_at: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
requester: string
status: open
subject: string
type: string
updated_at: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/ticket'
- description: Support ticket record with status, comments, and metadata
examples:
- comments:
- attachments:
- content_type: string
content_url: string
author: string
comment: string
created_at: 0
created_at: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
requester: string
status: open
subject: string
type: string
updated_at: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
comments:
- attachments:
- content_type: string
content_url: string
author: string
comment: string
created_at: 0
created_at: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
requester: string
status: open
subject: string
type: string
updated_at: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/usermacs:
post:
tags:
- Orgs User MACs
summary: createOrgUserMac
description: "Create Org User MACs\n\n### Usermacs import CSV file format\nmac,labels,vlan,notes \n921b638445cd,\"bldg1,flor1\",vlan-100 \n721b638445ef,\"bldg2,flor2\",vlan-101,Canon Printers \n721b638445ee,\"bldg3,flor3\",vlan-102 \n921b638445ce,\"bldg4,flor4\",vlan-103 \n921b638445cf,\"bldg5,flor5\",vlan-104"
operationId: createOrgUserMac
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/user_mac'
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/user_mac'
- description: Organization user MAC entry
examples:
- id: 111cafd2-ba1b-5169-bfcb-9cdf1d473ddb
labels:
- flor1
- bld4
mac: 921b638445cd
notes: MAC address refers to Canon printers
site_ids:
- 4ac1dcf4-9d8b-7211-65c4-057819f0862b
- 52f4347e-3e4b-186c-21ca-ad5b70eb23d6
vlan: '30'
contentMediaType: application/json
examples:
Example:
value:
id: 111cafd2-ba1b-5169-bfcb-9cdf1d473ddb
labels:
- flor1
- bld4
mac: 921b638445cd
notes: MAC address refers to Canon printers
site_ids:
- 4ac1dcf4-9d8b-7211-65c4-057819f0862b
- 52f4347e-3e4b-186c-21ca-ad5b70eb23d6
vlan: '30'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/user_mac'
- description: Organization user MAC entry
examples:
- id: 111cafd2-ba1b-5169-bfcb-9cdf1d473ddb
labels:
- flor1
- bld4
mac: 921b638445cd
notes: MAC address refers to Canon printers
site_ids:
- 4ac1dcf4-9d8b-7211-65c4-057819f0862b
- 52f4347e-3e4b-186c-21ca-ad5b70eb23d6
vlan: '30'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
id: 111cafd2-ba1b-5169-bfcb-9cdf1d473ddb
labels:
- flor1
- bld4
mac: 921b638445cd
notes: MAC address refers to Canon printers
site_ids:
- 4ac1dcf4-9d8b-7211-65c4-057819f0862b
- 52f4347e-3e4b-186c-21ca-ad5b70eb23d6
vlan: '30'
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Orgs User MACs
summary: updateOrgMultipleUserMacs
description: Update Multiple Org User MACs. Accepts a JSON array of user MAC objects where `id` is required for each entry.
operationId: updateOrgMultipleUserMacs
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/user_mac'
description: ''
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/user_macs_update'
- description: Result of a bulk user MAC update
examples:
- '{"detail":"batch update in progress"}'
- '{"errors":["2feacc8e-5893-418a-acaa-4d7c1afd01fe - invalid id"],"updated":["1041c16c-ca87-4d3f-bb94-b97c5819fc09","a016cc8e-5893-418a-acaa-4d7c1af6ac0f"]}'
contentMediaType: application/json
examples:
Async:
value:
detail: batch update in progress
Sync:
value:
errors:
- 2feacc8e-5893-418a-acaa-4d7c1afd01fe - invalid id
updated:
- 1041c16c-ca87-4d3f-bb94-b97c5819fc09
- a016cc8e-5893-418a-acaa-4d7c1af6ac0f
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/user_macs_update'
- description: Result of a bulk user MAC update
examples:
- '{"detail":"batch update in progress"}'
- '{"errors":["2feacc8e-5893-418a-acaa-4d7c1afd01fe - invalid id"],"updated":["1041c16c-ca87-4d3f-bb94-b97c5819fc09","a016cc8e-5893-418a-acaa-4d7c1af6ac0f"]}'
contentMediaType: application/vnd.api+json
examples:
Async:
value:
detail: batch update in progress
Sync:
value:
errors:
- 2feacc8e-5893-418a-acaa-4d7c1afd01fe - invalid id
updated:
- 1041c16c-ca87-4d3f-bb94-b97c5819fc09
- a016cc8e-5893-418a-acaa-4d7c1af6ac0f
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/usermacs/count:
get:
tags:
- Orgs User MACs
summary: countOrgUserMacs
description: Count by Distinct Attributes of User MACs
operationId: countOrgUserMacs
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Attribute to count by. enum: `mac`, `name`, `labels`, `org_id`'
required: true
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/count_usermac_distinct'
- description: 'Attribute to count by. enum: `mac`, `name`, `labels`, `org_id`'
examples:
- org_id
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/user_macs_count'
- description: User MACs count response
examples:
- end: 1723651268
limit: 10
results:
- id: 111cafd2-ba1b-5169-bfcb-9cdf1d473ddb
labels:
- flor1
- bld4
mac: 921b638445cd
name: Printer2
notes: mac address refers to Canon printers
radius_group: VIP
site_ids:
- 4ac1dcf4-9d8b-7211-65c4-057819f0862b
- 52f4347e-3e4b-186c-21ca-ad5b70eb23d6
vlan: '30'
- id: abecafd2-ba1b-5169-bfcb-9cdf1d473123
labels:
- blgd-cupe
- old
mac: 921b638445ce
name: os mac
notes: mac devices
radius_group: rg-1
vlan: vlan-2
start: 1723651267
total: 2
contentMediaType: application/json
examples:
Example:
value:
end: 1723651268
limit: 10
results:
- id: 111cafd2-ba1b-5169-bfcb-9cdf1d473ddb
labels:
- flor1
- bld4
mac: 921b638445cd
name: Printer2
notes: mac address refers to Canon printers
radius_group: VIP
site_ids:
- 4ac1dcf4-9d8b-7211-65c4-057819f0862b
- 52f4347e-3e4b-186c-21ca-ad5b70eb23d6
vlan: '30'
- id: abecafd2-ba1b-5169-bfcb-9cdf1d473123
labels:
- blgd-cupe
- old
mac: 921b638445ce
name: os mac
notes: mac devices
radius_group: rg-1
vlan: vlan-2
start: 1723651267
total: 2
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/user_macs_count'
- description: User MACs count response
examples:
- end: 1723651268
limit: 10
results:
- id: 111cafd2-ba1b-5169-bfcb-9cdf1d473ddb
labels:
- flor1
- bld4
mac: 921b638445cd
name: Printer2
notes: mac address refers to Canon printers
radius_group: VIP
site_ids:
- 4ac1dcf4-9d8b-7211-65c4-057819f0862b
- 52f4347e-3e4b-186c-21ca-ad5b70eb23d6
vlan: '30'
- id: abecafd2-ba1b-5169-bfcb-9cdf1d473123
labels:
- blgd-cupe
- old
mac: 921b638445ce
name: os mac
notes: mac devices
radius_group: rg-1
vlan: vlan-2
start: 1723651267
total: 2
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 1723651268
limit: 10
results:
- id: 111cafd2-ba1b-5169-bfcb-9cdf1d473ddb
labels:
- flor1
- bld4
mac: 921b638445cd
name: Printer2
notes: mac address refers to Canon printers
radius_group: VIP
site_ids:
- 4ac1dcf4-9d8b-7211-65c4-057819f0862b
- 52f4347e-3e4b-186c-21ca-ad5b70eb23d6
vlan: '30'
- id: abecafd2-ba1b-5169-bfcb-9cdf1d473123
labels:
- blgd-cupe
- old
mac: 921b638445ce
name: os mac
notes: mac devices
radius_group: rg-1
vlan: vlan-2
start: 1723651267
total: 2
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/usermacs/delete:
post:
tags:
- Orgs User MACs
summary: deleteOrgMultipleUserMacs
description: Delete Multiple Org User MACs
operationId: deleteOrgMultipleUserMacs
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/usermacs_id'
- description: Request Body
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/usermacs/import:
post:
tags:
- Orgs User MACs
summary: importOrgUserMacs
description: >-
Import Org User MACs. Accepts JSON or CSV upload.
**JSON — Array form** (asynchronous by default):
```json
[
{"mac": "921b638445cd", "labels": ["label1"], "vlan": "vlan-1"},
{"mac": "721b638445ef", "labels": ["label2", "label3"], "notes": "mac address refers to Canon printers"}
]
```
**CSV upload**: multipart/form-data with `file` field.
### CSV file format
```csv
mac,labels,vlan,notes,name,radius_group
921b638445cd,"bldg1,flor1",vlan-100
721b638445ef,"bldg2,flor2",vlan-101,Canon Printers
721b638445ee,"bldg3,flor3",vlan-102,Printer2,VIP
921b638445ce,"bldg4,flor4",vlan-103
921b638445cf,"bldg5,flor5",vlan-104
```
operationId: importOrgUserMacs
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
content:
multipart/form-data:
encoding: {}
schema:
required:
- file
type: object
properties:
file:
type: string
description: CSV file containing user MAC entries to import
contentEncoding: base64
contentMediaType: multipart/form-data
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/user_mac_import'
- description: Result of importing user MAC entries
examples:
- '{"detail":"import in progress"}'
- '{"added":["921b638445cd"],"errors":["921b638445ce - mac invalid","921b638445cf - mac already provided"],"updated":["721b638445ef","721b638445ee"]}'
contentMediaType: application/json
examples:
Async:
value:
detail: import in progress
Sync:
value:
added:
- 921b638445cd
errors:
- 921b638445ce - mac invalid
- 921b638445cf - mac already provided
updated:
- 721b638445ef
- 721b638445ee
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/user_mac_import'
- description: Result of importing user MAC entries
examples:
- '{"detail":"import in progress"}'
- '{"added":["921b638445cd"],"errors":["921b638445ce - mac invalid","921b638445cf - mac already provided"],"updated":["721b638445ef","721b638445ee"]}'
contentMediaType: application/vnd.api+json
examples:
Async:
value:
detail: import in progress
Sync:
value:
added:
- 921b638445cd
errors:
- 921b638445ce - mac invalid
- 921b638445cf - mac already provided
updated:
- 721b638445ef
- 721b638445ee
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/usermacs/search:
get:
tags:
- Orgs User MACs
summary: searchOrgUserMacs
description: Search Org User MACs
operationId: searchOrgUserMacs
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: mac
in: query
description: Partial / full Client MAC address. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `aabbcc*` and `*bbcc*` match `aabbccddeeff`). Suffix-only wildcards (e.g. `*bccddeeff`) are not supported
style: form
explode: true
schema:
type: string
examples:
- aabbccddeeff
- aabbcc*
- '*bbcc*'
examples:
Untitled Example1:
value: aabbccddeeff
Untitled Example2:
value: aabbcc*
Untitled Example3:
value: '*bbcc*'
- name: labels
in: query
description: Optional, array of strings of labels
style: form
explode: true
schema:
type: array
items:
type: string
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/user_mac'
description: List of user MAC entries
examples:
- - id: 111cafd2-ba1b-5169-bfcb-9cdf1d473ddb
labels:
- flor1
- bld4
mac: 921b638445cd
notes: MAC address refers to Canon printers
site_ids:
- 4ac1dcf4-9d8b-7211-65c4-057819f0862b
- 52f4347e-3e4b-186c-21ca-ad5b70eb23d6
vlan: '30'
contentMediaType: application/json
examples:
Example:
value:
- id: 111cafd2-ba1b-5169-bfcb-9cdf1d473ddb
labels:
- flor1
- bld4
mac: 921b638445cd
notes: MAC address refers to Canon printers
site_ids:
- 4ac1dcf4-9d8b-7211-65c4-057819f0862b
- 52f4347e-3e4b-186c-21ca-ad5b70eb23d6
vlan: '30'
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/user_mac'
description: List of user MAC entries
examples:
- - id: 111cafd2-ba1b-5169-bfcb-9cdf1d473ddb
labels:
- flor1
- bld4
mac: 921b638445cd
notes: MAC address refers to Canon printers
site_ids:
- 4ac1dcf4-9d8b-7211-65c4-057819f0862b
- 52f4347e-3e4b-186c-21ca-ad5b70eb23d6
vlan: '30'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- id: 111cafd2-ba1b-5169-bfcb-9cdf1d473ddb
labels:
- flor1
- bld4
mac: 921b638445cd
notes: MAC address refers to Canon printers
site_ids:
- 4ac1dcf4-9d8b-7211-65c4-057819f0862b
- 52f4347e-3e4b-186c-21ca-ad5b70eb23d6
vlan: '30'
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/usermacs/{usermac_id}:
delete:
tags:
- Orgs User MACs
summary: deleteOrgUserMac
description: Delete Org User MAC
operationId: deleteOrgUserMac
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: usermac_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Orgs User MACs
summary: getOrgUserMac
description: Get Org User MAC
operationId: getOrgUserMac
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: usermac_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/user_mac'
- description: Organization user MAC entry
examples:
- id: 111cafd2-ba1b-5169-bfcb-9cdf1d473ddb
labels:
- flor1
- bld4
mac: 921b638445cd
notes: MAC address refers to Canon printers
site_ids:
- 4ac1dcf4-9d8b-7211-65c4-057819f0862b
- 52f4347e-3e4b-186c-21ca-ad5b70eb23d6
vlan: '30'
contentMediaType: application/json
examples:
Example:
value:
id: 111cafd2-ba1b-5169-bfcb-9cdf1d473ddb
labels:
- flor1
- bld4
mac: 921b638445cd
notes: MAC address refers to Canon printers
site_ids:
- 4ac1dcf4-9d8b-7211-65c4-057819f0862b
- 52f4347e-3e4b-186c-21ca-ad5b70eb23d6
vlan: '30'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/user_mac'
- description: Organization user MAC entry
examples:
- id: 111cafd2-ba1b-5169-bfcb-9cdf1d473ddb
labels:
- flor1
- bld4
mac: 921b638445cd
notes: MAC address refers to Canon printers
site_ids:
- 4ac1dcf4-9d8b-7211-65c4-057819f0862b
- 52f4347e-3e4b-186c-21ca-ad5b70eb23d6
vlan: '30'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
id: 111cafd2-ba1b-5169-bfcb-9cdf1d473ddb
labels:
- flor1
- bld4
mac: 921b638445cd
notes: MAC address refers to Canon printers
site_ids:
- 4ac1dcf4-9d8b-7211-65c4-057819f0862b
- 52f4347e-3e4b-186c-21ca-ad5b70eb23d6
vlan: '30'
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Orgs User MACs
summary: updateOrgUserMac
description: Update Org User MAC
operationId: updateOrgUserMac
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: usermac_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/user_mac'
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/user_mac'
- description: Organization user MAC entry
examples:
- id: 111cafd2-ba1b-5169-bfcb-9cdf1d473ddb
labels:
- flor1
- bld4
mac: 921b638445cd
notes: MAC address refers to Canon printers
site_ids:
- 4ac1dcf4-9d8b-7211-65c4-057819f0862b
- 52f4347e-3e4b-186c-21ca-ad5b70eb23d6
vlan: '30'
contentMediaType: application/json
examples:
Example:
value:
id: 111cafd2-ba1b-5169-bfcb-9cdf1d473ddb
labels:
- flor1
- bld4
mac: 921b638445cd
notes: MAC address refers to Canon printers
site_ids:
- 4ac1dcf4-9d8b-7211-65c4-057819f0862b
- 52f4347e-3e4b-186c-21ca-ad5b70eb23d6
vlan: '30'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/user_mac'
- description: Organization user MAC entry
examples:
- id: 111cafd2-ba1b-5169-bfcb-9cdf1d473ddb
labels:
- flor1
- bld4
mac: 921b638445cd
notes: MAC address refers to Canon printers
site_ids:
- 4ac1dcf4-9d8b-7211-65c4-057819f0862b
- 52f4347e-3e4b-186c-21ca-ad5b70eb23d6
vlan: '30'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
id: 111cafd2-ba1b-5169-bfcb-9cdf1d473ddb
labels:
- flor1
- bld4
mac: 921b638445cd
notes: MAC address refers to Canon printers
site_ids:
- 4ac1dcf4-9d8b-7211-65c4-057819f0862b
- 52f4347e-3e4b-186c-21ca-ad5b70eb23d6
vlan: '30'
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/vars/search:
get:
tags:
- Orgs Vars
summary: searchOrgVars
description: >-
Search vars
Example: /api/v1/orgs/{org_id}/vars/search?vars=*
operationId: searchOrgVars
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: site_id
in: query
description: Filter results by site identifier. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- 00000000-0000-0000-0000-000000000001,00000000-0000-0000-0000-000000000002
- name: var
in: query
description: Filter variable results by variable name. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- guest_end,guest_net
- name: src
in: query
description: 'Filter results by source. enum: `deviceprofile`, `site`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/var_source'
- description: 'Filter results by source. enum: `deviceprofile`, `site`'
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_search_var'
- description: Paginated response for organization variable search results
examples:
- end: 1693952979
limit: 10
results:
- created_time: 1618457655.384858
modified_time: 1693610886.477805
org_id: 0c160b7f-1027-4cd1-923b-744534c4b070
site_id: 1519f016-4e41-47c0-a396-cce4d04bac0b
src: site
var: mvp
start: 1693949379
total: 1
contentMediaType: application/json
examples:
Example:
value:
end: 1693952979
limit: 10
results:
- created_time: 1618457655.384858
modified_time: 1693610886.477805
org_id: 0c160b7f-1027-4cd1-923b-744534c4b070
site_id: 1519f016-4e41-47c0-a396-cce4d04bac0b
src: site
var: mvp
start: 1693949379
total: 1
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_search_var'
- description: Paginated response for organization variable search results
examples:
- end: 1693952979
limit: 10
results:
- created_time: 1618457655.384858
modified_time: 1693610886.477805
org_id: 0c160b7f-1027-4cd1-923b-744534c4b070
site_id: 1519f016-4e41-47c0-a396-cce4d04bac0b
src: site
var: mvp
start: 1693949379
total: 1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 1693952979
limit: 10
results:
- created_time: 1618457655.384858
modified_time: 1693610886.477805
org_id: 0c160b7f-1027-4cd1-923b-744534c4b070
site_id: 1519f016-4e41-47c0-a396-cce4d04bac0b
src: site
var: mvp
start: 1693949379
total: 1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/vpns:
get:
tags:
- Orgs VPNs
summary: listOrgVpns
description: Get List of Org VPNs
operationId: listOrgVpns
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/vpn'
description: VPN records returned by a list response
examples:
- - name: string
paths:
property1:
bfd_profile: broadband
ip: string
property2:
bfd_profile: lte
ip: string
contentMediaType: application/json
examples:
Example:
value:
- name: string
paths:
property1:
bfd_profile: broadband
ip: string
property2:
bfd_profile: lte
ip: string
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/vpn'
description: VPN records returned by a list response
examples:
- - name: string
paths:
property1:
bfd_profile: broadband
ip: string
property2:
bfd_profile: lte
ip: string
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- name: string
paths:
property1:
bfd_profile: broadband
ip: string
property2:
bfd_profile: lte
ip: string
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs VPNs
summary: createOrgVpn
description: Create Org VPN
operationId: createOrgVpn
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/vpn'
- examples:
- name: string
paths:
property1:
bfd_profile: broadband
ip: string
property2:
bfd_profile: lte
ip: string
contentMediaType: application/json
examples:
Example:
value:
name: string
paths:
property1:
bfd_profile: broadband
ip: string
property2:
bfd_profile: lte
ip: string
required: false
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/vpn'
- description: Organization VPN overlay configuration
examples:
- created_time: 0
id: 497f6eca-6276-5009-bfeb-53cbbbba6f1b
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
paths:
property1:
bfd_profile: broadband
ip: string
property2:
bfd_profile: broadband
ip: string
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
id: 497f6eca-6276-5009-bfeb-53cbbbba6f1b
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
paths:
property1:
bfd_profile: broadband
ip: string
property2:
bfd_profile: broadband
ip: string
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/vpn'
- description: Organization VPN overlay configuration
examples:
- created_time: 0
id: 497f6eca-6276-5009-bfeb-53cbbbba6f1b
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
paths:
property1:
bfd_profile: broadband
ip: string
property2:
bfd_profile: broadband
ip: string
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
id: 497f6eca-6276-5009-bfeb-53cbbbba6f1b
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
paths:
property1:
bfd_profile: broadband
ip: string
property2:
bfd_profile: broadband
ip: string
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/vpns/{vpn_id}:
delete:
tags:
- Orgs VPNs
summary: deleteOrgVpn
description: Delete Org Vpn
operationId: deleteOrgVpn
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: vpn_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Orgs VPNs
summary: getOrgVpn
description: Get Org Vpn
operationId: getOrgVpn
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: vpn_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/vpn'
- description: Organization VPN overlay configuration
examples:
- created_time: 0
id: 497f6eca-6276-5009-bfeb-53cbbbba6f1b
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
paths:
property1:
bfd_profile: broadband
ip: string
property2:
bfd_profile: broadband
ip: string
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
id: 497f6eca-6276-5009-bfeb-53cbbbba6f1b
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
paths:
property1:
bfd_profile: broadband
ip: string
property2:
bfd_profile: broadband
ip: string
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/vpn'
- description: Organization VPN overlay configuration
examples:
- created_time: 0
id: 497f6eca-6276-5009-bfeb-53cbbbba6f1b
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
paths:
property1:
bfd_profile: broadband
ip: string
property2:
bfd_profile: broadband
ip: string
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
id: 497f6eca-6276-5009-bfeb-53cbbbba6f1b
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
paths:
property1:
bfd_profile: broadband
ip: string
property2:
bfd_profile: broadband
ip: string
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Orgs VPNs
summary: updateOrgVpn
description: Update Org Vpn
operationId: updateOrgVpn
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: vpn_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/vpn'
- examples:
- name: string
paths:
property1:
bfd_profile: broadband
ip: string
property2:
bfd_profile: broadband
ip: string
contentMediaType: application/json
examples:
Example:
value:
name: string
paths:
property1:
bfd_profile: broadband
ip: string
property2:
bfd_profile: broadband
ip: string
required: false
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/vpn'
- description: Organization VPN overlay configuration
examples:
- created_time: 0
id: 497f6eca-6276-5009-bfeb-53cbbbba6f1b
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
paths:
property1:
bfd_profile: broadband
ip: string
property2:
bfd_profile: broadband
ip: string
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
id: 497f6eca-6276-5009-bfeb-53cbbbba6f1b
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
paths:
property1:
bfd_profile: broadband
ip: string
property2:
bfd_profile: broadband
ip: string
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/vpn'
- description: Organization VPN overlay configuration
examples:
- created_time: 0
id: 497f6eca-6276-5009-bfeb-53cbbbba6f1b
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
paths:
property1:
bfd_profile: broadband
ip: string
property2:
bfd_profile: broadband
ip: string
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
id: 497f6eca-6276-5009-bfeb-53cbbbba6f1b
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
paths:
property1:
bfd_profile: broadband
ip: string
property2:
bfd_profile: broadband
ip: string
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/webhooks:
get:
tags:
- Orgs Webhooks
summary: listOrgWebhooks
description: Get List of Org Webhooks
operationId: listOrgWebhooks
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/webhook'
description: Webhook configuration records returned by a list response
examples:
- - created_time: 0
enabled: true
headers: {}
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
secret: string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
splunk_token: string
topics:
- location
type: http-post
url: string
verify_cert: true
contentMediaType: application/json
examples:
Example:
value:
- created_time: 0
enabled: true
headers: {}
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
secret: string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
splunk_token: string
topics:
- location
type: http-post
url: string
verify_cert: true
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/webhook'
description: Webhook configuration records returned by a list response
examples:
- - created_time: 0
enabled: true
headers: {}
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
secret: string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
splunk_token: string
topics:
- location
type: http-post
url: string
verify_cert: true
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- created_time: 0
enabled: true
headers: {}
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
secret: string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
splunk_token: string
topics:
- location
type: http-post
url: string
verify_cert: true
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs Webhooks
summary: createOrgWebhook
description: "**N.B**. For org webhooks, only alarms/audits/client-info/client-join/client-sessions/device_events/device-updowns/mxedge_events Infrastructure topics are supported.\n\n\nWebhook defines a webhook, modeled after [github\\u2019s model](https://developer.github.com/webhooks/).\n\n\nThere is two types of webhooks:\n* webhooks ([examples](https://www.postman.com/juniper-mist/workspace/mist-systems-s-public-workspace/folder/224925-be01e694-7253-4195-8563-78e2a745e114)) \n* raw data webhooks ([examples](https://www.postman.com/juniper-mist/workspace/mist-systems-s-public-workspace/folder/224925-e2d5d5f8-4bdb-4efc-93e4-90f4b33d0b2b))\n\n\n##### Webhooks\nWebhooks can be configured at the org level (subset of topics only) and at the site level. It is possible to have multiple topics in the same webhook configuration and/or to have multiple webhooks configured at the same time.\n"
operationId: createOrgWebhook
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/webhook'
- description: Request Body
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/webhook'
- description: Webhook configuration for delivering selected Mist events to an external destination
examples:
- created_time: 0
enabled: true
headers: {}
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
secret: string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
splunk_token: string
topics:
- location
type: http-post
url: string
verify_cert: true
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
enabled: true
headers: {}
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
secret: string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
splunk_token: string
topics:
- location
type: http-post
url: string
verify_cert: true
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/webhook'
- description: Webhook configuration for delivering selected Mist events to an external destination
examples:
- created_time: 0
enabled: true
headers: {}
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
secret: string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
splunk_token: string
topics:
- location
type: http-post
url: string
verify_cert: true
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
enabled: true
headers: {}
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
secret: string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
splunk_token: string
topics:
- location
type: http-post
url: string
verify_cert: true
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400_webhook'
- description: Webhook-specific HTTP 400 bad request error response
examples:
- '{"detail":"invalid field: assetfilter_ids","reason":"contains duplicate uuids"}'
- '{"detail":"invalid field: assetfilter_ids"}'
- '{"detail":"invalid field: assetfilter_ids"}'
- '{"detail":"Webhook already configured for special location topic"}'
- '{"detail":"Only one location topic can be configured per URL"}'
- '{"detail":"invalid field: topics","reason":"filtered asset webhooks must be associated with a site"}'
contentMediaType: application/json
examples:
Duplicate_assetfilter_id:
value:
detail: 'invalid field: assetfilter_ids'
reason: contains duplicate uuids
Invalid_assetfilter_id:
value:
detail: 'invalid field: assetfilter_ids'
Malformed_assetfilter_id:
value:
detail: 'invalid field: assetfilter_ids'
RawDataWebhook_already_created:
value:
detail: Webhook already configured for special location topic
RawDataWebhook_multiple_topics:
value:
detail: Only one location topic can be configured per URL
org_level_filter_webhook:
value:
detail: 'invalid field: topics'
reason: filtered asset webhooks must be associated with a site
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400_webhook'
- description: Webhook-specific HTTP 400 bad request error response
examples:
- '{"detail":"invalid field: assetfilter_ids","reason":"contains duplicate uuids"}'
- '{"detail":"invalid field: assetfilter_ids"}'
- '{"detail":"invalid field: assetfilter_ids"}'
- '{"detail":"Webhook already configured for special location topic"}'
- '{"detail":"Only one location topic can be configured per URL"}'
- '{"detail":"invalid field: topics","reason":"filtered asset webhooks must be associated with a site"}'
contentMediaType: application/vnd.api+json
examples:
Duplicate_assetfilter_id:
value:
detail: 'invalid field: assetfilter_ids'
reason: contains duplicate uuids
Invalid_assetfilter_id:
value:
detail: 'invalid field: assetfilter_ids'
Malformed_assetfilter_id:
value:
detail: 'invalid field: assetfilter_ids'
RawDataWebhook_already_created:
value:
detail: Webhook already configured for special location topic
RawDataWebhook_multiple_topics:
value:
detail: Only one location topic can be configured per URL
org_level_filter_webhook:
value:
detail: 'invalid field: topics'
reason: filtered asset webhooks must be associated with a site
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/webhooks/{webhook_id}:
delete:
tags:
- Orgs Webhooks
summary: deleteOrgWebhook
description: Delete Org Webhook
operationId: deleteOrgWebhook
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: webhook_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Orgs Webhooks
summary: getOrgWebhook
description: Get Org Webhook Details
operationId: getOrgWebhook
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: webhook_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/webhook'
- description: Webhook configuration for delivering selected Mist events to an external destination
examples:
- created_time: 0
enabled: true
headers: {}
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
secret: string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
splunk_token: string
topics:
- location
type: http-post
url: string
verify_cert: true
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
enabled: true
headers: {}
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
secret: string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
splunk_token: string
topics:
- location
type: http-post
url: string
verify_cert: true
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/webhook'
- description: Webhook configuration for delivering selected Mist events to an external destination
examples:
- created_time: 0
enabled: true
headers: {}
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
secret: string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
splunk_token: string
topics:
- location
type: http-post
url: string
verify_cert: true
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
enabled: true
headers: {}
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
secret: string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
splunk_token: string
topics:
- location
type: http-post
url: string
verify_cert: true
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Orgs Webhooks
summary: updateOrgWebhook
description: Update Org Webhook
operationId: updateOrgWebhook
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: webhook_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/webhook'
- description: Request Body
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/webhook'
- description: Webhook configuration for delivering selected Mist events to an external destination
examples:
- created_time: 0
enabled: true
headers: {}
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
secret: string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
splunk_token: string
topics:
- location
type: http-post
url: string
verify_cert: true
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
enabled: true
headers: {}
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
secret: string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
splunk_token: string
topics:
- location
type: http-post
url: string
verify_cert: true
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/webhook'
- description: Webhook configuration for delivering selected Mist events to an external destination
examples:
- created_time: 0
enabled: true
headers: {}
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
secret: string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
splunk_token: string
topics:
- location
type: http-post
url: string
verify_cert: true
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
enabled: true
headers: {}
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
secret: string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
splunk_token: string
topics:
- location
type: http-post
url: string
verify_cert: true
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/webhooks/{webhook_id}/events/count:
get:
tags:
- Orgs Webhooks
summary: countOrgWebhooksDeliveries
description: >-
Count Org Webhooks deliveries
Topics Supported:
- alarms
- audits
- device-updowns
- occupancy-alerts
- ping
operationId: countOrgWebhooksDeliveries
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: webhook_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: error
in: query
description: Filter webhook delivery results by error message
style: form
explode: true
schema:
type: string
- name: status_code
in: query
description: Filter webhook delivery results by HTTP status code
style: form
explode: true
schema:
type: integer
contentEncoding: int32
- name: status
in: query
description: 'Webhook delivery status used to filter results. enum: `failure`, `success`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/webhook_delivery_status'
- description: 'Webhook delivery status used to filter results. enum: `failure`, `success`'
examples:
- failure
- name: topic
in: query
description: 'Webhook topic used to filter results. enum: `alarms`, `audits`, `device-updowns`, `occupancy-alerts`, `ping`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/webhook_delivery_topic'
- description: 'Webhook topic used to filter results. enum: `alarms`, `audits`, `device-updowns`, `occupancy-alerts`, `ping`'
examples:
- audits
- name: distinct
in: query
description: 'Field used to group this count response. enum: `status`, `status_code`, `topic`, `webhook_id`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/webhook_delivery_distinct'
- description: 'Field used to group this count response. enum: `status`, `status_code`, `topic`, `webhook_id`'
examples:
- webhook_id
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/webhooks/{webhook_id}/events/search:
get:
tags:
- Orgs Webhooks
summary: searchOrgWebhooksDeliveries
description: >-
Search Org Webhooks deliveries
Topics Supported:
- alarms
- audits
- device-updowns
- occupancy-alerts
- ping
operationId: searchOrgWebhooksDeliveries
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: webhook_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: error
in: query
description: Filter webhook delivery results by error message
style: form
explode: true
schema:
type: string
- name: status_code
in: query
description: Filter webhook delivery results by HTTP status code
style: form
explode: true
schema:
type: integer
contentEncoding: int32
- name: status
in: query
description: 'Webhook delivery status used to filter results. enum: `failure`, `success`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/webhook_delivery_status'
- description: 'Webhook delivery status used to filter results. enum: `failure`, `success`'
examples:
- failure
- name: topic
in: query
description: 'Webhook topic used to filter results. enum: `alarms`, `audits`, `device-updowns`, `occupancy-alerts`, `ping`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/webhook_delivery_topic'
- description: 'Webhook topic used to filter results. enum: `alarms`, `audits`, `device-updowns`, `occupancy-alerts`, `ping`'
examples:
- audits
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/search_webhook_delivery'
- description: Paginated response for webhook delivery searches
examples:
- end: 1688035193
limit: 10
results:
- error: string
id: 55b0f02f-ebf6-4ad2-8b10-200508a97581
org_id: fc7e2967-e7ef-41e6-b007-1217713de05a
req_headers: '{\"Content-Type\":[\"application/json\"],\"User-Agent\":[\"Mist-webhook\"]}'
req_payload: '{\"topic\":\"audits\",\"events\":[{\"admin_name\":\"John Doe john.doe@juniper.net\",\"after\":\"{\\"radio_config\\": {\\"band_24\\": {\\"disabled\\": false, \\"allow_rrm_disable\\": false, \\"power_min\\": null, \\"power_max\\": null, \\"power\\": 10, \\"preamble\\": \\"short\\", \\"channels\\": [1, 10], \\"bandwidth\\": 20}}}\",\"before\":\"{\\"radio_config\\": {\\"band_24\\": {\\"disabled\\": false, \\"allow_rrm_disable\\": false, \\"power_min\\": 8, \\"power_max\\": 18, \\"power\\": null, \\"preamble\\": \\"long\\", \\"channels\\": [1, 10], \\"bandwidth\\": 20}}}\",\"id\":\"737909a2-04ff-4aeb-b9da-cc924e74a4dd\",\"message\":\"Update Site Settings\",\"org_id\":\"fc7e2967-e7ef-41e6-b007-1217713de05a\",\"site_id\":\"256c3a35-9cb7-436e-bc6d-314972645d95\",\"site_name\":\"Test Site\",\"src_ip\":\"1.2.3.4\",\"timestamp\":1685956576.923601,\"user_agent\":\"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/112.0.0.0 Safari/537.36\"}]}'
req_url: https://example.com
resp_body: Ok
resp_headers: string
site_id: 256c3a35-9cb7-436e-bc6d-314972645d95
status: success
status_code: 200
timestamp: 1687962508.583656
topic: audits
webhook_id: 7a11b901-f719-4c91-8aef-deb8699a6364
start: 1687948793
total: 0
contentMediaType: application/json
examples:
Webhook Deliveries:
value:
end: 1688035193
limit: 10
results:
- error: string
id: 55b0f02f-ebf6-4ad2-8b10-200508a97581
org_id: fc7e2967-e7ef-41e6-b007-1217713de05a
req_headers: '{\"Content-Type\":[\"application/json\"],\"User-Agent\":[\"Mist-webhook\"]}'
req_payload: '{\"topic\":\"audits\",\"events\":[{\"admin_name\":\"John Doe john.doe@juniper.net\",\"after\":\"{\\"radio_config\\": {\\"band_24\\": {\\"disabled\\": false, \\"allow_rrm_disable\\": false, \\"power_min\\": null, \\"power_max\\": null, \\"power\\": 10, \\"preamble\\": \\"short\\", \\"channels\\": [1, 10], \\"bandwidth\\": 20}}}\",\"before\":\"{\\"radio_config\\": {\\"band_24\\": {\\"disabled\\": false, \\"allow_rrm_disable\\": false, \\"power_min\\": 8, \\"power_max\\": 18, \\"power\\": null, \\"preamble\\": \\"long\\", \\"channels\\": [1, 10], \\"bandwidth\\": 20}}}\",\"id\":\"737909a2-04ff-4aeb-b9da-cc924e74a4dd\",\"message\":\"Update Site Settings\",\"org_id\":\"fc7e2967-e7ef-41e6-b007-1217713de05a\",\"site_id\":\"256c3a35-9cb7-436e-bc6d-314972645d95\",\"site_name\":\"Test Site\",\"src_ip\":\"1.2.3.4\",\"timestamp\":1685956576.923601,\"user_agent\":\"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/112.0.0.0 Safari/537.36\"}]}'
req_url: https://example.com
resp_body: Ok
resp_headers: string
site_id: 256c3a35-9cb7-436e-bc6d-314972645d95
status: success
status_code: 200
timestamp: 1687962508.583656
topic: audits
webhook_id: 7a11b901-f719-4c91-8aef-deb8699a6364
start: 1687948793
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/search_webhook_delivery'
- description: Paginated response for webhook delivery searches
examples:
- end: 1688035193
limit: 10
results:
- error: string
id: 55b0f02f-ebf6-4ad2-8b10-200508a97581
org_id: fc7e2967-e7ef-41e6-b007-1217713de05a
req_headers: '{\"Content-Type\":[\"application/json\"],\"User-Agent\":[\"Mist-webhook\"]}'
req_payload: '{\"topic\":\"audits\",\"events\":[{\"admin_name\":\"John Doe john.doe@juniper.net\",\"after\":\"{\\"radio_config\\": {\\"band_24\\": {\\"disabled\\": false, \\"allow_rrm_disable\\": false, \\"power_min\\": null, \\"power_max\\": null, \\"power\\": 10, \\"preamble\\": \\"short\\", \\"channels\\": [1, 10], \\"bandwidth\\": 20}}}\",\"before\":\"{\\"radio_config\\": {\\"band_24\\": {\\"disabled\\": false, \\"allow_rrm_disable\\": false, \\"power_min\\": 8, \\"power_max\\": 18, \\"power\\": null, \\"preamble\\": \\"long\\", \\"channels\\": [1, 10], \\"bandwidth\\": 20}}}\",\"id\":\"737909a2-04ff-4aeb-b9da-cc924e74a4dd\",\"message\":\"Update Site Settings\",\"org_id\":\"fc7e2967-e7ef-41e6-b007-1217713de05a\",\"site_id\":\"256c3a35-9cb7-436e-bc6d-314972645d95\",\"site_name\":\"Test Site\",\"src_ip\":\"1.2.3.4\",\"timestamp\":1685956576.923601,\"user_agent\":\"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/112.0.0.0 Safari/537.36\"}]}'
req_url: https://example.com
resp_body: Ok
resp_headers: string
site_id: 256c3a35-9cb7-436e-bc6d-314972645d95
status: success
status_code: 200
timestamp: 1687962508.583656
topic: audits
webhook_id: 7a11b901-f719-4c91-8aef-deb8699a6364
start: 1687948793
total: 0
contentMediaType: application/vnd.api+json
examples:
Webhook Deliveries:
value:
end: 1688035193
limit: 10
results:
- error: string
id: 55b0f02f-ebf6-4ad2-8b10-200508a97581
org_id: fc7e2967-e7ef-41e6-b007-1217713de05a
req_headers: '{\"Content-Type\":[\"application/json\"],\"User-Agent\":[\"Mist-webhook\"]}'
req_payload: '{\"topic\":\"audits\",\"events\":[{\"admin_name\":\"John Doe john.doe@juniper.net\",\"after\":\"{\\"radio_config\\": {\\"band_24\\": {\\"disabled\\": false, \\"allow_rrm_disable\\": false, \\"power_min\\": null, \\"power_max\\": null, \\"power\\": 10, \\"preamble\\": \\"short\\", \\"channels\\": [1, 10], \\"bandwidth\\": 20}}}\",\"before\":\"{\\"radio_config\\": {\\"band_24\\": {\\"disabled\\": false, \\"allow_rrm_disable\\": false, \\"power_min\\": 8, \\"power_max\\": 18, \\"power\\": null, \\"preamble\\": \\"long\\", \\"channels\\": [1, 10], \\"bandwidth\\": 20}}}\",\"id\":\"737909a2-04ff-4aeb-b9da-cc924e74a4dd\",\"message\":\"Update Site Settings\",\"org_id\":\"fc7e2967-e7ef-41e6-b007-1217713de05a\",\"site_id\":\"256c3a35-9cb7-436e-bc6d-314972645d95\",\"site_name\":\"Test Site\",\"src_ip\":\"1.2.3.4\",\"timestamp\":1685956576.923601,\"user_agent\":\"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/112.0.0.0 Safari/537.36\"}]}'
req_url: https://example.com
resp_body: Ok
resp_headers: string
site_id: 256c3a35-9cb7-436e-bc6d-314972645d95
status: success
status_code: 200
timestamp: 1687962508.583656
topic: audits
webhook_id: 7a11b901-f719-4c91-8aef-deb8699a6364
start: 1687948793
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/webhooks/{webhook_id}/ping:
post:
tags:
- Orgs Webhooks
summary: pingOrgWebhook
description: Send a Ping event to the webhook
operationId: pingOrgWebhook
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: webhook_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/wlans:
get:
tags:
- Orgs Wlans
summary: listOrgWlans
description: Get List of Org Wlans
operationId: listOrgWlans
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/wlan'
description: WLAN records returned by a list response
contentMediaType: application/json
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/wlan'
description: WLAN records returned by a list response
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs Wlans
summary: createOrgWlan
description: Create Org Wlan
operationId: createOrgWlan
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/wlan'
- description: Request Body
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/wlan'
- description: '**Note**: portal_template will be forked out of wlan objects soon. To fetch portal_template, please query portal_template_url. To update portal_template, use Wlan Portal Template.'
examples:
- allow_ipv6_ndp: true
allow_mdns: false
allow_ssdp: false
arp_filter: false
band_steer: false
band_steer_force_band5: false
bands:
- '24'
- '5'
block_blacklist_clients: false
bonjour:
additional_vlan_ids: 10, 20
enabled: false
services:
airplay:
radius_groups:
- teachers
scope: same_ap
client_limit_down: 1000
client_limit_down_enabled: false
client_limit_up: 512
client_limit_up_enabled: false
disable_11ax: false
disable_ht_vht_rates: false
disable_uapsd: false
disable_v1_roam_notify: false
disable_v2_roam_notify: false
disable_wmm: false
dynamic_vlan:
default_vlan_id: 999
enabled: false
local_vlan_ids:
- 1
type: airespace-interface-name
vlans:
'131': default
'322': fast,video
enable_local_keycaching: false
enable_wireless_bridging: false
enabled: true
fast_dot1x_timers: false
hide_ssid: false
hostname_ie: false
ssid: demo
contentMediaType: application/json
examples:
Example:
value:
allow_ipv6_ndp: true
allow_mdns: false
allow_ssdp: false
arp_filter: false
band_steer: false
band_steer_force_band5: false
bands:
- '24'
- '5'
block_blacklist_clients: false
bonjour:
additional_vlan_ids: 10, 20
enabled: false
services:
airplay:
radius_groups:
- teachers
scope: same_ap
client_limit_down: 1000
client_limit_down_enabled: false
client_limit_up: 512
client_limit_up_enabled: false
disable_11ax: false
disable_ht_vht_rates: false
disable_uapsd: false
disable_v1_roam_notify: false
disable_v2_roam_notify: false
disable_wmm: false
dynamic_vlan:
default_vlan_id: 999
enabled: false
local_vlan_ids:
- 1
type: airespace-interface-name
vlans:
'131': default
'322': fast,video
enable_local_keycaching: false
enable_wireless_bridging: false
enabled: true
fast_dot1x_timers: false
hide_ssid: false
hostname_ie: false
ssid: demo
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/wlan'
- description: '**Note**: portal_template will be forked out of wlan objects soon. To fetch portal_template, please query portal_template_url. To update portal_template, use Wlan Portal Template.'
examples:
- allow_ipv6_ndp: true
allow_mdns: false
allow_ssdp: false
arp_filter: false
band_steer: false
band_steer_force_band5: false
bands:
- '24'
- '5'
block_blacklist_clients: false
bonjour:
additional_vlan_ids: 10, 20
enabled: false
services:
airplay:
radius_groups:
- teachers
scope: same_ap
client_limit_down: 1000
client_limit_down_enabled: false
client_limit_up: 512
client_limit_up_enabled: false
disable_11ax: false
disable_ht_vht_rates: false
disable_uapsd: false
disable_v1_roam_notify: false
disable_v2_roam_notify: false
disable_wmm: false
dynamic_vlan:
default_vlan_id: 999
enabled: false
local_vlan_ids:
- 1
type: airespace-interface-name
vlans:
'131': default
'322': fast,video
enable_local_keycaching: false
enable_wireless_bridging: false
enabled: true
fast_dot1x_timers: false
hide_ssid: false
hostname_ie: false
ssid: demo
contentMediaType: application/vnd.api+json
examples:
Example:
value:
allow_ipv6_ndp: true
allow_mdns: false
allow_ssdp: false
arp_filter: false
band_steer: false
band_steer_force_band5: false
bands:
- '24'
- '5'
block_blacklist_clients: false
bonjour:
additional_vlan_ids: 10, 20
enabled: false
services:
airplay:
radius_groups:
- teachers
scope: same_ap
client_limit_down: 1000
client_limit_down_enabled: false
client_limit_up: 512
client_limit_up_enabled: false
disable_11ax: false
disable_ht_vht_rates: false
disable_uapsd: false
disable_v1_roam_notify: false
disable_v2_roam_notify: false
disable_wmm: false
dynamic_vlan:
default_vlan_id: 999
enabled: false
local_vlan_ids:
- 1
type: airespace-interface-name
vlans:
'131': default
'322': fast,video
enable_local_keycaching: false
enable_wireless_bridging: false
enabled: true
fast_dot1x_timers: false
hide_ssid: false
hostname_ie: false
ssid: demo
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/wlans/{wlan_id}:
delete:
tags:
- Orgs Wlans
summary: deleteOrgWlan
description: Delete Org WLAN
operationId: deleteOrgWlan
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: wlan_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Orgs Wlans
summary: getOrgWLAN
description: Get Org Wlan Detail
operationId: getOrgWLAN
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: wlan_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/wlan'
- description: '**Note**: portal_template will be forked out of wlan objects soon. To fetch portal_template, please query portal_template_url. To update portal_template, use Wlan Portal Template.'
examples:
- allow_ipv6_ndp: true
allow_mdns: false
allow_ssdp: false
arp_filter: false
band_steer: false
band_steer_force_band5: false
bands:
- '24'
- '5'
block_blacklist_clients: false
bonjour:
additional_vlan_ids: 10, 20
enabled: false
services:
airplay:
radius_groups:
- teachers
scope: same_ap
client_limit_down: 1000
client_limit_down_enabled: false
client_limit_up: 512
client_limit_up_enabled: false
disable_11ax: false
disable_ht_vht_rates: false
disable_uapsd: false
disable_v1_roam_notify: false
disable_v2_roam_notify: false
disable_wmm: false
dynamic_vlan:
default_vlan_id: 999
enabled: false
local_vlan_ids:
- 1
type: airespace-interface-name
vlans:
'131': default
'322': fast,video
enable_local_keycaching: false
enable_wireless_bridging: false
enabled: true
fast_dot1x_timers: false
hide_ssid: false
hostname_ie: false
ssid: demo
contentMediaType: application/json
examples:
Example:
value:
allow_ipv6_ndp: true
allow_mdns: false
allow_ssdp: false
arp_filter: false
band_steer: false
band_steer_force_band5: false
bands:
- '24'
- '5'
block_blacklist_clients: false
bonjour:
additional_vlan_ids: 10, 20
enabled: false
services:
airplay:
radius_groups:
- teachers
scope: same_ap
client_limit_down: 1000
client_limit_down_enabled: false
client_limit_up: 512
client_limit_up_enabled: false
disable_11ax: false
disable_ht_vht_rates: false
disable_uapsd: false
disable_v1_roam_notify: false
disable_v2_roam_notify: false
disable_wmm: false
dynamic_vlan:
default_vlan_id: 999
enabled: false
local_vlan_ids:
- 1
type: airespace-interface-name
vlans:
'131': default
'322': fast,video
enable_local_keycaching: false
enable_wireless_bridging: false
enabled: true
fast_dot1x_timers: false
hide_ssid: false
hostname_ie: false
ssid: demo
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/wlan'
- description: '**Note**: portal_template will be forked out of wlan objects soon. To fetch portal_template, please query portal_template_url. To update portal_template, use Wlan Portal Template.'
examples:
- allow_ipv6_ndp: true
allow_mdns: false
allow_ssdp: false
arp_filter: false
band_steer: false
band_steer_force_band5: false
bands:
- '24'
- '5'
block_blacklist_clients: false
bonjour:
additional_vlan_ids: 10, 20
enabled: false
services:
airplay:
radius_groups:
- teachers
scope: same_ap
client_limit_down: 1000
client_limit_down_enabled: false
client_limit_up: 512
client_limit_up_enabled: false
disable_11ax: false
disable_ht_vht_rates: false
disable_uapsd: false
disable_v1_roam_notify: false
disable_v2_roam_notify: false
disable_wmm: false
dynamic_vlan:
default_vlan_id: 999
enabled: false
local_vlan_ids:
- 1
type: airespace-interface-name
vlans:
'131': default
'322': fast,video
enable_local_keycaching: false
enable_wireless_bridging: false
enabled: true
fast_dot1x_timers: false
hide_ssid: false
hostname_ie: false
ssid: demo
contentMediaType: application/vnd.api+json
examples:
Example:
value:
allow_ipv6_ndp: true
allow_mdns: false
allow_ssdp: false
arp_filter: false
band_steer: false
band_steer_force_band5: false
bands:
- '24'
- '5'
block_blacklist_clients: false
bonjour:
additional_vlan_ids: 10, 20
enabled: false
services:
airplay:
radius_groups:
- teachers
scope: same_ap
client_limit_down: 1000
client_limit_down_enabled: false
client_limit_up: 512
client_limit_up_enabled: false
disable_11ax: false
disable_ht_vht_rates: false
disable_uapsd: false
disable_v1_roam_notify: false
disable_v2_roam_notify: false
disable_wmm: false
dynamic_vlan:
default_vlan_id: 999
enabled: false
local_vlan_ids:
- 1
type: airespace-interface-name
vlans:
'131': default
'322': fast,video
enable_local_keycaching: false
enable_wireless_bridging: false
enabled: true
fast_dot1x_timers: false
hide_ssid: false
hostname_ie: false
ssid: demo
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Orgs Wlans
summary: updateOrgWlan
description: Update Org Wlan
operationId: updateOrgWlan
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: wlan_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/wlan'
- description: Request Body
examples:
- allow_ipv6_ndp: true
allow_mdns: false
allow_ssdp: false
arp_filter: false
band_steer: false
band_steer_force_band5: false
bands:
- '24'
- '5'
block_blacklist_clients: false
bonjour:
additional_vlan_ids: 10,20
enabled: false
services:
airplay:
radius_groups:
- teachers
scope: same_ap
client_limit_down: 1000
client_limit_down_enabled: false
client_limit_up: 512
client_limit_up_enabled: false
disable_11ax: false
disable_ht_vht_rates: false
disable_uapsd: false
disable_v1_roam_notify: false
disable_v2_roam_notify: false
disable_wmm: false
dynamic_vlan:
default_vlan_id: 999
enabled: false
local_vlan_ids:
- 1
type: airespace-interface-name
vlans:
'131': default
'322': fast,video
enable_local_keycaching: false
enable_wireless_bridging: false
enabled: true
fast_dot1x_timers: false
hide_ssid: false
hostname_ie: false
ssid: demo
contentMediaType: application/json
examples:
Example:
value:
allow_ipv6_ndp: true
allow_mdns: false
allow_ssdp: false
arp_filter: false
band_steer: false
band_steer_force_band5: false
bands:
- '24'
- '5'
block_blacklist_clients: false
bonjour:
additional_vlan_ids: 10,20
enabled: false
services:
airplay:
radius_groups:
- teachers
scope: same_ap
client_limit_down: 1000
client_limit_down_enabled: false
client_limit_up: 512
client_limit_up_enabled: false
disable_11ax: false
disable_ht_vht_rates: false
disable_uapsd: false
disable_v1_roam_notify: false
disable_v2_roam_notify: false
disable_wmm: false
dynamic_vlan:
default_vlan_id: 999
enabled: false
local_vlan_ids:
- 1
type: airespace-interface-name
vlans:
'131': default
'322': fast,video
enable_local_keycaching: false
enable_wireless_bridging: false
enabled: true
fast_dot1x_timers: false
hide_ssid: false
hostname_ie: false
ssid: demo
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/wlan'
- description: '**Note**: portal_template will be forked out of wlan objects soon. To fetch portal_template, please query portal_template_url. To update portal_template, use Wlan Portal Template.'
examples:
- allow_ipv6_ndp: true
allow_mdns: false
allow_ssdp: false
arp_filter: false
band_steer: false
band_steer_force_band5: false
bands:
- '24'
- '5'
block_blacklist_clients: false
bonjour:
additional_vlan_ids: 10, 20
enabled: false
services:
airplay:
radius_groups:
- teachers
scope: same_ap
client_limit_down: 1000
client_limit_down_enabled: false
client_limit_up: 512
client_limit_up_enabled: false
disable_11ax: false
disable_ht_vht_rates: false
disable_uapsd: false
disable_v1_roam_notify: false
disable_v2_roam_notify: false
disable_wmm: false
dynamic_vlan:
default_vlan_id: 999
enabled: false
local_vlan_ids:
- 1
type: airespace-interface-name
vlans:
'131': default
'322': fast,video
enable_local_keycaching: false
enable_wireless_bridging: false
enabled: true
fast_dot1x_timers: false
hide_ssid: false
hostname_ie: false
ssid: demo
contentMediaType: application/json
examples:
Example:
value:
allow_ipv6_ndp: true
allow_mdns: false
allow_ssdp: false
arp_filter: false
band_steer: false
band_steer_force_band5: false
bands:
- '24'
- '5'
block_blacklist_clients: false
bonjour:
additional_vlan_ids: 10, 20
enabled: false
services:
airplay:
radius_groups:
- teachers
scope: same_ap
client_limit_down: 1000
client_limit_down_enabled: false
client_limit_up: 512
client_limit_up_enabled: false
disable_11ax: false
disable_ht_vht_rates: false
disable_uapsd: false
disable_v1_roam_notify: false
disable_v2_roam_notify: false
disable_wmm: false
dynamic_vlan:
default_vlan_id: 999
enabled: false
local_vlan_ids:
- 1
type: airespace-interface-name
vlans:
'131': default
'322': fast,video
enable_local_keycaching: false
enable_wireless_bridging: false
enabled: true
fast_dot1x_timers: false
hide_ssid: false
hostname_ie: false
ssid: demo
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/wlan'
- description: '**Note**: portal_template will be forked out of wlan objects soon. To fetch portal_template, please query portal_template_url. To update portal_template, use Wlan Portal Template.'
examples:
- allow_ipv6_ndp: true
allow_mdns: false
allow_ssdp: false
arp_filter: false
band_steer: false
band_steer_force_band5: false
bands:
- '24'
- '5'
block_blacklist_clients: false
bonjour:
additional_vlan_ids: 10, 20
enabled: false
services:
airplay:
radius_groups:
- teachers
scope: same_ap
client_limit_down: 1000
client_limit_down_enabled: false
client_limit_up: 512
client_limit_up_enabled: false
disable_11ax: false
disable_ht_vht_rates: false
disable_uapsd: false
disable_v1_roam_notify: false
disable_v2_roam_notify: false
disable_wmm: false
dynamic_vlan:
default_vlan_id: 999
enabled: false
local_vlan_ids:
- 1
type: airespace-interface-name
vlans:
'131': default
'322': fast,video
enable_local_keycaching: false
enable_wireless_bridging: false
enabled: true
fast_dot1x_timers: false
hide_ssid: false
hostname_ie: false
ssid: demo
contentMediaType: application/vnd.api+json
examples:
Example:
value:
allow_ipv6_ndp: true
allow_mdns: false
allow_ssdp: false
arp_filter: false
band_steer: false
band_steer_force_band5: false
bands:
- '24'
- '5'
block_blacklist_clients: false
bonjour:
additional_vlan_ids: 10, 20
enabled: false
services:
airplay:
radius_groups:
- teachers
scope: same_ap
client_limit_down: 1000
client_limit_down_enabled: false
client_limit_up: 512
client_limit_up_enabled: false
disable_11ax: false
disable_ht_vht_rates: false
disable_uapsd: false
disable_v1_roam_notify: false
disable_v2_roam_notify: false
disable_wmm: false
dynamic_vlan:
default_vlan_id: 999
enabled: false
local_vlan_ids:
- 1
type: airespace-interface-name
vlans:
'131': default
'322': fast,video
enable_local_keycaching: false
enable_wireless_bridging: false
enabled: true
fast_dot1x_timers: false
hide_ssid: false
hostname_ie: false
ssid: demo
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/wlans/{wlan_id}/portal_image:
delete:
tags:
- Orgs Wlans
summary: deleteOrgWlanPortalImage
description: Delete Org WLAN Portal Image
operationId: deleteOrgWlanPortalImage
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: wlan_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs Wlans
summary: uploadOrgWlanPortalImage
description: Upload Org WLAN Portal Image
operationId: uploadOrgWlanPortalImage
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: wlan_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
content:
multipart/form-data:
encoding: {}
schema:
required:
- file
type: object
properties:
file:
type: string
description: Image file content uploaded as multipart form data
contentEncoding: base64
json:
type: string
description: Optional JSON metadata submitted with the image upload
contentMediaType: multipart/form-data
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/wlans/{wlan_id}/portal_template:
put:
tags:
- Orgs Wlans
summary: updateOrgWlanPortalTemplate
description: >-
Update a Portal Template
#### Sponsor Email Template
Sponsor Email Template supports following template variables:
| **Name** | **Description** |
| --- | --- |
| approve_url | Renders URL to approve the request; optionally &minutes=N query param can be appended to change the Authorization period of the guest, where N is a valid integer denoting number of minutes a guest remains authorized |
| deny_url | Renders URL to reject the request |
| guest_email | Renders Email ID of the guest |
| guest_name | Renders Name of the guest |
| field1 | Renders value of the Custom Field 1 |
| field2 | Renders value of the Custom Field 2 |
| company | Renders value of the Company field |
| sponsor_link_validity_duration | Renders validity time of the request (i.e. Approve/Deny URL) |
| auth_expire_minutes | Renders Wlan-level configured Guest Authorization Expiration time period (in minutes), If not configured then default (1 day in minutes) |
operationId: updateOrgWlanPortalTemplate
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: wlan_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/wlan_portal_template'
- description: Request Body
examples:
- portal_template:
accessCodeAlternateEmail: string
alignment: left
authButtonAmazon: string
authButtonAzure: string
authButtonEmail: string
authButtonFacebook: string
authButtonGoogle: string
authButtonMicrosoft: string
authButtonPassphrase: string
authButtonSms: string
authButtonSponsor: string
authLabel: string
backLink: string
color: string
colorDark: string
colorLight: string
company: true
companyError: string
companyLabel: string
email: true
emailAccessDomainError: string
emailCancel: string
emailCodeError: string
emailError: string
emailFieldLabel: string
emailLabel: string
emailMessage: string
emailSubmit: string
emailTitle: string
field1: true
field1Error: string
field1Label: string
field1Required: true
field2: true
field2Error: string
field2Label: string
field2Required: true
field3: true
field3Error: string
field3Label: string
field3Required: true
field4: true
field4Error: string
field4Label: string
field4Required: true
message: string
name: true
nameError: string
nameLabel: string
optout: true
optoutLabel: string
pageTitle: string
passphraseCancel: string
passphraseError: string
passphraseLabel: string
passphraseMessage: string
passphraseSubmit: string
passphraseTitle: string
poweredBy: true
requiredFieldLabel: string
signInLabel: string
smsCarrierDefault: string
smsCarrierError: string
smsCarrierFieldLabel: string
smsCodeCancel: string
smsCodeError: string
smsCodeFieldLabel: string
smsCodeMessage: string
smsCodeSubmit: string
smsCodeTitle: string
smsCountryFieldLabel: string
smsCountryFormat: string
smsHaveAccessCode: string
smsMessageFormat: string
smsNumberCancel: string
smsNumberError: string
smsNumberFieldLabel: string
smsNumberFormat: string
smsNumberMessage: string
smsNumberSubmit: string
smsNumberTitle: string
smsUsernameFormat: string
smsValidityDuration: 30
sponsorBackLink: string
sponsorCancel: string
sponsorEmail: string
sponsorEmailError: string
sponsorEmailTemplate: string
sponsorInfoApproved: string
sponsorInfoDenied: string
sponsorInfoPending: string
sponsorName: string
sponsorNameError: string
sponsorNotePending: string
sponsorStatusApproved: string
sponsorStatusDenied: string
sponsorStatusPending: string
sponsorSubmit: string
sponsorsFieldLabel: string
tos: true
tosAcceptLabel: string
tosError: string
tosLink: string
tosText: string
contentMediaType: application/json
examples:
Example:
value:
portal_template:
accessCodeAlternateEmail: string
alignment: left
authButtonAmazon: string
authButtonAzure: string
authButtonEmail: string
authButtonFacebook: string
authButtonGoogle: string
authButtonMicrosoft: string
authButtonPassphrase: string
authButtonSms: string
authButtonSponsor: string
authLabel: string
backLink: string
color: string
colorDark: string
colorLight: string
company: true
companyError: string
companyLabel: string
email: true
emailAccessDomainError: string
emailCancel: string
emailCodeError: string
emailError: string
emailFieldLabel: string
emailLabel: string
emailMessage: string
emailSubmit: string
emailTitle: string
field1: true
field1Error: string
field1Label: string
field1Required: true
field2: true
field2Error: string
field2Label: string
field2Required: true
field3: true
field3Error: string
field3Label: string
field3Required: true
field4: true
field4Error: string
field4Label: string
field4Required: true
message: string
name: true
nameError: string
nameLabel: string
optout: true
optoutLabel: string
pageTitle: string
passphraseCancel: string
passphraseError: string
passphraseLabel: string
passphraseMessage: string
passphraseSubmit: string
passphraseTitle: string
poweredBy: true
requiredFieldLabel: string
signInLabel: string
smsCarrierDefault: string
smsCarrierError: string
smsCarrierFieldLabel: string
smsCodeCancel: string
smsCodeError: string
smsCodeFieldLabel: string
smsCodeMessage: string
smsCodeSubmit: string
smsCodeTitle: string
smsCountryFieldLabel: string
smsCountryFormat: string
smsHaveAccessCode: string
smsMessageFormat: string
smsNumberCancel: string
smsNumberError: string
smsNumberFieldLabel: string
smsNumberFormat: string
smsNumberMessage: string
smsNumberSubmit: string
smsNumberTitle: string
smsUsernameFormat: string
smsValidityDuration: 30
sponsorBackLink: string
sponsorCancel: string
sponsorEmail: string
sponsorEmailError: string
sponsorEmailTemplate: string
sponsorInfoApproved: string
sponsorInfoDenied: string
sponsorInfoPending: string
sponsorName: string
sponsorNameError: string
sponsorNotePending: string
sponsorStatusApproved: string
sponsorStatusDenied: string
sponsorStatusPending: string
sponsorSubmit: string
sponsorsFieldLabel: string
tos: true
tosAcceptLabel: string
tosError: string
tosLink: string
tosText: string
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/wlan_portal_template'
- description: Guest portal template payload for a WLAN
examples:
- portal_template:
accessCodeAlternateEmail: string
alignment: left
authButtonAmazon: string
authButtonAzure: string
authButtonEmail: string
authButtonFacebook: string
authButtonGoogle: string
authButtonMicrosoft: string
authButtonPassphrase: string
authButtonSms: string
authButtonSponsor: string
authLabel: string
backLink: string
color: string
colorDark: string
colorLight: string
company: true
companyError: string
companyLabel: string
email: true
emailAccessDomainError: string
emailCancel: string
emailCodeError: string
emailError: string
emailFieldLabel: string
emailLabel: string
emailMessage: string
emailSubmit: string
emailTitle: string
field1: true
field1Error: string
field1Label: string
field1Required: true
field2: true
field2Error: string
field2Label: string
field2Required: true
field3: true
field3Error: string
field3Label: string
field3Required: true
field4: true
field4Error: string
field4Label: string
field4Required: true
message: string
name: true
nameError: string
nameLabel: string
optout: true
optoutLabel: string
pageTitle: string
passphraseCancel: string
passphraseError: string
passphraseLabel: string
passphraseMessage: string
passphraseSubmit: string
passphraseTitle: string
poweredBy: true
requiredFieldLabel: string
signInLabel: string
smsCarrierDefault: string
smsCarrierError: string
smsCarrierFieldLabel: string
smsCodeCancel: string
smsCodeError: string
smsCodeFieldLabel: string
smsCodeMessage: string
smsCodeSubmit: string
smsCodeTitle: string
smsCountryFieldLabel: string
smsCountryFormat: string
smsHaveAccessCode: string
smsMessageFormat: string
smsNumberCancel: string
smsNumberError: string
smsNumberFieldLabel: string
smsNumberFormat: string
smsNumberMessage: string
smsNumberSubmit: string
smsNumberTitle: string
smsUsernameFormat: string
smsValidityDuration: 5
sponsorBackLink: string
sponsorCancel: string
sponsorEmail: string
sponsorEmailError: string
sponsorEmailTemplate: string
sponsorInfoApproved: string
sponsorInfoDenied: string
sponsorInfoPending: string
sponsorName: string
sponsorNameError: string
sponsorNotePending: string
sponsorStatusApproved: string
sponsorStatusDenied: string
sponsorStatusPending: string
sponsorSubmit: string
tos: true
tosAcceptLabel: string
tosError: string
tosLink: string
tosText: string
contentMediaType: application/json
examples:
Example:
value:
portal_template:
accessCodeAlternateEmail: string
alignment: left
authButtonAmazon: string
authButtonAzure: string
authButtonEmail: string
authButtonFacebook: string
authButtonGoogle: string
authButtonMicrosoft: string
authButtonPassphrase: string
authButtonSms: string
authButtonSponsor: string
authLabel: string
backLink: string
color: string
colorDark: string
colorLight: string
company: true
companyError: string
companyLabel: string
email: true
emailAccessDomainError: string
emailCancel: string
emailCodeError: string
emailError: string
emailFieldLabel: string
emailLabel: string
emailMessage: string
emailSubmit: string
emailTitle: string
field1: true
field1Error: string
field1Label: string
field1Required: true
field2: true
field2Error: string
field2Label: string
field2Required: true
field3: true
field3Error: string
field3Label: string
field3Required: true
field4: true
field4Error: string
field4Label: string
field4Required: true
message: string
name: true
nameError: string
nameLabel: string
optout: true
optoutLabel: string
pageTitle: string
passphraseCancel: string
passphraseError: string
passphraseLabel: string
passphraseMessage: string
passphraseSubmit: string
passphraseTitle: string
poweredBy: true
requiredFieldLabel: string
signInLabel: string
smsCarrierDefault: string
smsCarrierError: string
smsCarrierFieldLabel: string
smsCodeCancel: string
smsCodeError: string
smsCodeFieldLabel: string
smsCodeMessage: string
smsCodeSubmit: string
smsCodeTitle: string
smsCountryFieldLabel: string
smsCountryFormat: string
smsHaveAccessCode: string
smsMessageFormat: string
smsNumberCancel: string
smsNumberError: string
smsNumberFieldLabel: string
smsNumberFormat: string
smsNumberMessage: string
smsNumberSubmit: string
smsNumberTitle: string
smsUsernameFormat: string
smsValidityDuration: 5
sponsorBackLink: string
sponsorCancel: string
sponsorEmail: string
sponsorEmailError: string
sponsorEmailTemplate: string
sponsorInfoApproved: string
sponsorInfoDenied: string
sponsorInfoPending: string
sponsorName: string
sponsorNameError: string
sponsorNotePending: string
sponsorStatusApproved: string
sponsorStatusDenied: string
sponsorStatusPending: string
sponsorSubmit: string
tos: true
tosAcceptLabel: string
tosError: string
tosLink: string
tosText: string
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/wlan_portal_template'
- description: Guest portal template payload for a WLAN
examples:
- portal_template:
accessCodeAlternateEmail: string
alignment: left
authButtonAmazon: string
authButtonAzure: string
authButtonEmail: string
authButtonFacebook: string
authButtonGoogle: string
authButtonMicrosoft: string
authButtonPassphrase: string
authButtonSms: string
authButtonSponsor: string
authLabel: string
backLink: string
color: string
colorDark: string
colorLight: string
company: true
companyError: string
companyLabel: string
email: true
emailAccessDomainError: string
emailCancel: string
emailCodeError: string
emailError: string
emailFieldLabel: string
emailLabel: string
emailMessage: string
emailSubmit: string
emailTitle: string
field1: true
field1Error: string
field1Label: string
field1Required: true
field2: true
field2Error: string
field2Label: string
field2Required: true
field3: true
field3Error: string
field3Label: string
field3Required: true
field4: true
field4Error: string
field4Label: string
field4Required: true
message: string
name: true
nameError: string
nameLabel: string
optout: true
optoutLabel: string
pageTitle: string
passphraseCancel: string
passphraseError: string
passphraseLabel: string
passphraseMessage: string
passphraseSubmit: string
passphraseTitle: string
poweredBy: true
requiredFieldLabel: string
signInLabel: string
smsCarrierDefault: string
smsCarrierError: string
smsCarrierFieldLabel: string
smsCodeCancel: string
smsCodeError: string
smsCodeFieldLabel: string
smsCodeMessage: string
smsCodeSubmit: string
smsCodeTitle: string
smsCountryFieldLabel: string
smsCountryFormat: string
smsHaveAccessCode: string
smsMessageFormat: string
smsNumberCancel: string
smsNumberError: string
smsNumberFieldLabel: string
smsNumberFormat: string
smsNumberMessage: string
smsNumberSubmit: string
smsNumberTitle: string
smsUsernameFormat: string
smsValidityDuration: 5
sponsorBackLink: string
sponsorCancel: string
sponsorEmail: string
sponsorEmailError: string
sponsorEmailTemplate: string
sponsorInfoApproved: string
sponsorInfoDenied: string
sponsorInfoPending: string
sponsorName: string
sponsorNameError: string
sponsorNotePending: string
sponsorStatusApproved: string
sponsorStatusDenied: string
sponsorStatusPending: string
sponsorSubmit: string
tos: true
tosAcceptLabel: string
tosError: string
tosLink: string
tosText: string
contentMediaType: application/vnd.api+json
examples:
Example:
value:
portal_template:
accessCodeAlternateEmail: string
alignment: left
authButtonAmazon: string
authButtonAzure: string
authButtonEmail: string
authButtonFacebook: string
authButtonGoogle: string
authButtonMicrosoft: string
authButtonPassphrase: string
authButtonSms: string
authButtonSponsor: string
authLabel: string
backLink: string
color: string
colorDark: string
colorLight: string
company: true
companyError: string
companyLabel: string
email: true
emailAccessDomainError: string
emailCancel: string
emailCodeError: string
emailError: string
emailFieldLabel: string
emailLabel: string
emailMessage: string
emailSubmit: string
emailTitle: string
field1: true
field1Error: string
field1Label: string
field1Required: true
field2: true
field2Error: string
field2Label: string
field2Required: true
field3: true
field3Error: string
field3Label: string
field3Required: true
field4: true
field4Error: string
field4Label: string
field4Required: true
message: string
name: true
nameError: string
nameLabel: string
optout: true
optoutLabel: string
pageTitle: string
passphraseCancel: string
passphraseError: string
passphraseLabel: string
passphraseMessage: string
passphraseSubmit: string
passphraseTitle: string
poweredBy: true
requiredFieldLabel: string
signInLabel: string
smsCarrierDefault: string
smsCarrierError: string
smsCarrierFieldLabel: string
smsCodeCancel: string
smsCodeError: string
smsCodeFieldLabel: string
smsCodeMessage: string
smsCodeSubmit: string
smsCodeTitle: string
smsCountryFieldLabel: string
smsCountryFormat: string
smsHaveAccessCode: string
smsMessageFormat: string
smsNumberCancel: string
smsNumberError: string
smsNumberFieldLabel: string
smsNumberFormat: string
smsNumberMessage: string
smsNumberSubmit: string
smsNumberTitle: string
smsUsernameFormat: string
smsValidityDuration: 5
sponsorBackLink: string
sponsorCancel: string
sponsorEmail: string
sponsorEmailError: string
sponsorEmailTemplate: string
sponsorInfoApproved: string
sponsorInfoDenied: string
sponsorInfoPending: string
sponsorName: string
sponsorNameError: string
sponsorNotePending: string
sponsorStatusApproved: string
sponsorStatusDenied: string
sponsorStatusPending: string
sponsorSubmit: string
tos: true
tosAcceptLabel: string
tosError: string
tosLink: string
tosText: string
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/wxrules:
get:
tags:
- Orgs WxRules
summary: listOrgWxRules
description: Get List of Org WxRules
operationId: listOrgWxRules
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: List of WxRules
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/wxlan_rule'
description: WxLAN policy rules returned by a list response
examples:
- - action: allow
apply_tags:
- c049dfcd-0c73-5014-1c64-062e9903f1e5
blocked_apps:
- mist
- all-videos
created_time: 0
dst_allow_wxtags:
- fff34466-eec0-3756-6765-381c728a6037
- eee2c7b0-d1d0-5a30-f349-e35fa43dc3b3
dst_deny_wxtags:
- aaa34466-eec0-3756-6765-381c728a6037
- bbb2c7b0-d1d0-5a30-f349-e35fa43dc3b3
enabled: true
for_site: true
id: 497f6eca-6276-4993-bfeb-53ebbbba6f08
modified_time: 0
order: 1
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
src_wxtags:
- 8bfc2490-d726-3587-038d-cb2e71bd2330
- 3aa8e73f-9f46-d827-8d6a-567bb7e67fc9
contentMediaType: application/json
examples:
Example:
value:
- action: allow
apply_tags:
- c049dfcd-0c73-5014-1c64-062e9903f1e5
blocked_apps:
- mist
- all-videos
created_time: 0
dst_allow_wxtags:
- fff34466-eec0-3756-6765-381c728a6037
- eee2c7b0-d1d0-5a30-f349-e35fa43dc3b3
dst_deny_wxtags:
- aaa34466-eec0-3756-6765-381c728a6037
- bbb2c7b0-d1d0-5a30-f349-e35fa43dc3b3
enabled: true
for_site: true
id: 497f6eca-6276-4993-bfeb-53ebbbba6f08
modified_time: 0
order: 1
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
src_wxtags:
- 8bfc2490-d726-3587-038d-cb2e71bd2330
- 3aa8e73f-9f46-d827-8d6a-567bb7e67fc9
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/wxlan_rule'
description: WxLAN policy rules returned by a list response
examples:
- - action: allow
apply_tags:
- c049dfcd-0c73-5014-1c64-062e9903f1e5
blocked_apps:
- mist
- all-videos
created_time: 0
dst_allow_wxtags:
- fff34466-eec0-3756-6765-381c728a6037
- eee2c7b0-d1d0-5a30-f349-e35fa43dc3b3
dst_deny_wxtags:
- aaa34466-eec0-3756-6765-381c728a6037
- bbb2c7b0-d1d0-5a30-f349-e35fa43dc3b3
enabled: true
for_site: true
id: 497f6eca-6276-4993-bfeb-53ebbbba6f08
modified_time: 0
order: 1
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
src_wxtags:
- 8bfc2490-d726-3587-038d-cb2e71bd2330
- 3aa8e73f-9f46-d827-8d6a-567bb7e67fc9
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- action: allow
apply_tags:
- c049dfcd-0c73-5014-1c64-062e9903f1e5
blocked_apps:
- mist
- all-videos
created_time: 0
dst_allow_wxtags:
- fff34466-eec0-3756-6765-381c728a6037
- eee2c7b0-d1d0-5a30-f349-e35fa43dc3b3
dst_deny_wxtags:
- aaa34466-eec0-3756-6765-381c728a6037
- bbb2c7b0-d1d0-5a30-f349-e35fa43dc3b3
enabled: true
for_site: true
id: 497f6eca-6276-4993-bfeb-53ebbbba6f08
modified_time: 0
order: 1
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
src_wxtags:
- 8bfc2490-d726-3587-038d-cb2e71bd2330
- 3aa8e73f-9f46-d827-8d6a-567bb7e67fc9
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs WxRules
summary: createOrgWxRule
description: Create Org WxRule
operationId: createOrgWxRule
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/wxlan_rule'
- description: Request Body
examples:
- action: allow
apply_tags:
- c049dfcd-0c73-5014-1c64-062e9903f1e5
blocked_apps:
- mist
- all-videos
dst_allow_wxtags:
- fff34466-eec0-3756-6765-381c728a6037
- eee2c7b0-d1d0-5a30-f349-e35fa43dc3b3
dst_deny_wxtags:
- aaa34466-eec0-3756-6765-381c728a6037
- bbb2c7b0-d1d0-5a30-f349-e35fa43dc3b3
enabled: true
order: 1
src_wxtags:
- 8bfc2490-d726-3587-038d-cb2e71bd2330
- 3aa8e73f-9f46-d827-8d6a-567bb7e67fc9
contentMediaType: application/json
examples:
Example:
value:
action: allow
apply_tags:
- c049dfcd-0c73-5014-1c64-062e9903f1e5
blocked_apps:
- mist
- all-videos
dst_allow_wxtags:
- fff34466-eec0-3756-6765-381c728a6037
- eee2c7b0-d1d0-5a30-f349-e35fa43dc3b3
dst_deny_wxtags:
- aaa34466-eec0-3756-6765-381c728a6037
- bbb2c7b0-d1d0-5a30-f349-e35fa43dc3b3
enabled: true
order: 1
src_wxtags:
- 8bfc2490-d726-3587-038d-cb2e71bd2330
- 3aa8e73f-9f46-d827-8d6a-567bb7e67fc9
required: false
responses:
'200':
description: Wrule
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/wxlan_rule'
- description: WxLAN policy rule controlling traffic between WxLAN tags
examples:
- action: allow
apply_tags:
- c049dfcd-0c73-5014-1c64-062e9903f1e5
blocked_apps:
- mist
- all-videos
created_time: 0
dst_allow_wxtags:
- fff34466-eec0-3756-6765-381c728a6037
- eee2c7b0-d1d0-5a30-f349-e35fa43dc3b3
dst_deny_wxtags:
- aaa34466-eec0-3756-6765-381c728a6037
- bbb2c7b0-d1d0-5a30-f349-e35fa43dc3b3
enabled: true
for_site: true
id: 497f6eca-6276-4993-9feb-53cbbbba6f08
modified_time: 0
order: 1
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
src_wxtags:
- 8bfc2490-d726-3587-038d-cb2e71bd2330
- 3aa8e73f-9f46-d827-8d6a-567bb7e67fc9
contentMediaType: application/json
examples:
Example:
value:
action: allow
apply_tags:
- c049dfcd-0c73-5014-1c64-062e9903f1e5
blocked_apps:
- mist
- all-videos
created_time: 0
dst_allow_wxtags:
- fff34466-eec0-3756-6765-381c728a6037
- eee2c7b0-d1d0-5a30-f349-e35fa43dc3b3
dst_deny_wxtags:
- aaa34466-eec0-3756-6765-381c728a6037
- bbb2c7b0-d1d0-5a30-f349-e35fa43dc3b3
enabled: true
for_site: true
id: 497f6eca-6276-4993-9feb-53cbbbba6f08
modified_time: 0
order: 1
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
src_wxtags:
- 8bfc2490-d726-3587-038d-cb2e71bd2330
- 3aa8e73f-9f46-d827-8d6a-567bb7e67fc9
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/wxlan_rule'
- description: WxLAN policy rule controlling traffic between WxLAN tags
examples:
- action: allow
apply_tags:
- c049dfcd-0c73-5014-1c64-062e9903f1e5
blocked_apps:
- mist
- all-videos
created_time: 0
dst_allow_wxtags:
- fff34466-eec0-3756-6765-381c728a6037
- eee2c7b0-d1d0-5a30-f349-e35fa43dc3b3
dst_deny_wxtags:
- aaa34466-eec0-3756-6765-381c728a6037
- bbb2c7b0-d1d0-5a30-f349-e35fa43dc3b3
enabled: true
for_site: true
id: 497f6eca-6276-4993-9feb-53cbbbba6f08
modified_time: 0
order: 1
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
src_wxtags:
- 8bfc2490-d726-3587-038d-cb2e71bd2330
- 3aa8e73f-9f46-d827-8d6a-567bb7e67fc9
contentMediaType: application/vnd.api+json
examples:
Example:
value:
action: allow
apply_tags:
- c049dfcd-0c73-5014-1c64-062e9903f1e5
blocked_apps:
- mist
- all-videos
created_time: 0
dst_allow_wxtags:
- fff34466-eec0-3756-6765-381c728a6037
- eee2c7b0-d1d0-5a30-f349-e35fa43dc3b3
dst_deny_wxtags:
- aaa34466-eec0-3756-6765-381c728a6037
- bbb2c7b0-d1d0-5a30-f349-e35fa43dc3b3
enabled: true
for_site: true
id: 497f6eca-6276-4993-9feb-53cbbbba6f08
modified_time: 0
order: 1
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
src_wxtags:
- 8bfc2490-d726-3587-038d-cb2e71bd2330
- 3aa8e73f-9f46-d827-8d6a-567bb7e67fc9
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/wxrules/{wxrule_id}:
delete:
tags:
- Orgs WxRules
summary: deleteOrgWxRule
description: Delete Org WxRule
operationId: deleteOrgWxRule
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: wxrule_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Orgs WxRules
summary: getOrgWxRule
description: Get Org WxRule Details
operationId: getOrgWxRule
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: wxrule_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: Wrule
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/wxlan_rule'
- description: WxLAN policy rule controlling traffic between WxLAN tags
examples:
- action: allow
apply_tags:
- c049dfcd-0c73-5014-1c64-062e9903f1e5
blocked_apps:
- mist
- all-videos
created_time: 0
dst_allow_wxtags:
- fff34466-eec0-3756-6765-381c728a6037
- eee2c7b0-d1d0-5a30-f349-e35fa43dc3b3
dst_deny_wxtags:
- aaa34466-eec0-3756-6765-381c728a6037
- bbb2c7b0-d1d0-5a30-f349-e35fa43dc3b3
enabled: true
for_site: true
id: 497f6eca-6276-4993-9feb-53cbbbba6f08
modified_time: 0
order: 1
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
src_wxtags:
- 8bfc2490-d726-3587-038d-cb2e71bd2330
- 3aa8e73f-9f46-d827-8d6a-567bb7e67fc9
contentMediaType: application/json
examples:
Example:
value:
action: allow
apply_tags:
- c049dfcd-0c73-5014-1c64-062e9903f1e5
blocked_apps:
- mist
- all-videos
created_time: 0
dst_allow_wxtags:
- fff34466-eec0-3756-6765-381c728a6037
- eee2c7b0-d1d0-5a30-f349-e35fa43dc3b3
dst_deny_wxtags:
- aaa34466-eec0-3756-6765-381c728a6037
- bbb2c7b0-d1d0-5a30-f349-e35fa43dc3b3
enabled: true
for_site: true
id: 497f6eca-6276-4993-9feb-53cbbbba6f08
modified_time: 0
order: 1
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
src_wxtags:
- 8bfc2490-d726-3587-038d-cb2e71bd2330
- 3aa8e73f-9f46-d827-8d6a-567bb7e67fc9
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/wxlan_rule'
- description: WxLAN policy rule controlling traffic between WxLAN tags
examples:
- action: allow
apply_tags:
- c049dfcd-0c73-5014-1c64-062e9903f1e5
blocked_apps:
- mist
- all-videos
created_time: 0
dst_allow_wxtags:
- fff34466-eec0-3756-6765-381c728a6037
- eee2c7b0-d1d0-5a30-f349-e35fa43dc3b3
dst_deny_wxtags:
- aaa34466-eec0-3756-6765-381c728a6037
- bbb2c7b0-d1d0-5a30-f349-e35fa43dc3b3
enabled: true
for_site: true
id: 497f6eca-6276-4993-9feb-53cbbbba6f08
modified_time: 0
order: 1
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
src_wxtags:
- 8bfc2490-d726-3587-038d-cb2e71bd2330
- 3aa8e73f-9f46-d827-8d6a-567bb7e67fc9
contentMediaType: application/vnd.api+json
examples:
Example:
value:
action: allow
apply_tags:
- c049dfcd-0c73-5014-1c64-062e9903f1e5
blocked_apps:
- mist
- all-videos
created_time: 0
dst_allow_wxtags:
- fff34466-eec0-3756-6765-381c728a6037
- eee2c7b0-d1d0-5a30-f349-e35fa43dc3b3
dst_deny_wxtags:
- aaa34466-eec0-3756-6765-381c728a6037
- bbb2c7b0-d1d0-5a30-f349-e35fa43dc3b3
enabled: true
for_site: true
id: 497f6eca-6276-4993-9feb-53cbbbba6f08
modified_time: 0
order: 1
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
src_wxtags:
- 8bfc2490-d726-3587-038d-cb2e71bd2330
- 3aa8e73f-9f46-d827-8d6a-567bb7e67fc9
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Orgs WxRules
summary: updateOrgWxRule
description: Update Org WxRule
operationId: updateOrgWxRule
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: wxrule_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/wxlan_rule'
- description: Request Body
examples:
- action: allow
apply_tags:
- c049dfcd-0c73-5014-1c64-062e9903f1e5
blocked_apps:
- mist
- all-videos
dst_allow_wxtags:
- fff34466-eec0-3756-6765-381c728a6037
- eee2c7b0-d1d0-5a30-f349-e35fa43dc3b3
dst_deny_wxtags:
- aaa34466-eec0-3756-6765-381c728a6037
- bbb2c7b0-d1d0-5a30-f349-e35fa43dc3b3
enabled: true
order: 1
src_wxtags:
- 8bfc2490-d726-3587-038d-cb2e71bd2330
- 3aa8e73f-9f46-d827-8d6a-567bb7e67fc9
contentMediaType: application/json
examples:
Example:
value:
action: allow
apply_tags:
- c049dfcd-0c73-5014-1c64-062e9903f1e5
blocked_apps:
- mist
- all-videos
dst_allow_wxtags:
- fff34466-eec0-3756-6765-381c728a6037
- eee2c7b0-d1d0-5a30-f349-e35fa43dc3b3
dst_deny_wxtags:
- aaa34466-eec0-3756-6765-381c728a6037
- bbb2c7b0-d1d0-5a30-f349-e35fa43dc3b3
enabled: true
order: 1
src_wxtags:
- 8bfc2490-d726-3587-038d-cb2e71bd2330
- 3aa8e73f-9f46-d827-8d6a-567bb7e67fc9
required: false
responses:
'200':
description: Wrule
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/wxlan_rule'
- description: WxLAN policy rule controlling traffic between WxLAN tags
examples:
- action: allow
apply_tags:
- c049dfcd-0c73-5014-1c64-062e9903f1e5
blocked_apps:
- mist
- all-videos
created_time: 0
dst_allow_wxtags:
- fff34466-eec0-3756-6765-381c728a6037
- eee2c7b0-d1d0-5a30-f349-e35fa43dc3b3
dst_deny_wxtags:
- aaa34466-eec0-3756-6765-381c728a6037
- bbb2c7b0-d1d0-5a30-f349-e35fa43dc3b3
enabled: true
for_site: true
id: 497f6eca-6276-4993-9feb-53cbbbba6f08
modified_time: 0
order: 1
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
src_wxtags:
- 8bfc2490-d726-3587-038d-cb2e71bd2330
- 3aa8e73f-9f46-d827-8d6a-567bb7e67fc9
contentMediaType: application/json
examples:
Example:
value:
action: allow
apply_tags:
- c049dfcd-0c73-5014-1c64-062e9903f1e5
blocked_apps:
- mist
- all-videos
created_time: 0
dst_allow_wxtags:
- fff34466-eec0-3756-6765-381c728a6037
- eee2c7b0-d1d0-5a30-f349-e35fa43dc3b3
dst_deny_wxtags:
- aaa34466-eec0-3756-6765-381c728a6037
- bbb2c7b0-d1d0-5a30-f349-e35fa43dc3b3
enabled: true
for_site: true
id: 497f6eca-6276-4993-9feb-53cbbbba6f08
modified_time: 0
order: 1
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
src_wxtags:
- 8bfc2490-d726-3587-038d-cb2e71bd2330
- 3aa8e73f-9f46-d827-8d6a-567bb7e67fc9
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/wxlan_rule'
- description: WxLAN policy rule controlling traffic between WxLAN tags
examples:
- action: allow
apply_tags:
- c049dfcd-0c73-5014-1c64-062e9903f1e5
blocked_apps:
- mist
- all-videos
created_time: 0
dst_allow_wxtags:
- fff34466-eec0-3756-6765-381c728a6037
- eee2c7b0-d1d0-5a30-f349-e35fa43dc3b3
dst_deny_wxtags:
- aaa34466-eec0-3756-6765-381c728a6037
- bbb2c7b0-d1d0-5a30-f349-e35fa43dc3b3
enabled: true
for_site: true
id: 497f6eca-6276-4993-9feb-53cbbbba6f08
modified_time: 0
order: 1
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
src_wxtags:
- 8bfc2490-d726-3587-038d-cb2e71bd2330
- 3aa8e73f-9f46-d827-8d6a-567bb7e67fc9
contentMediaType: application/vnd.api+json
examples:
Example:
value:
action: allow
apply_tags:
- c049dfcd-0c73-5014-1c64-062e9903f1e5
blocked_apps:
- mist
- all-videos
created_time: 0
dst_allow_wxtags:
- fff34466-eec0-3756-6765-381c728a6037
- eee2c7b0-d1d0-5a30-f349-e35fa43dc3b3
dst_deny_wxtags:
- aaa34466-eec0-3756-6765-381c728a6037
- bbb2c7b0-d1d0-5a30-f349-e35fa43dc3b3
enabled: true
for_site: true
id: 497f6eca-6276-4993-9feb-53cbbbba6f08
modified_time: 0
order: 1
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
src_wxtags:
- 8bfc2490-d726-3587-038d-cb2e71bd2330
- 3aa8e73f-9f46-d827-8d6a-567bb7e67fc9
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/wxtags:
get:
tags:
- Orgs WxTags
summary: listOrgWxTags
description: Get List of Org WxLAN Tags
operationId: listOrgWxTags
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/wxlan_tag'
description: WxLAN tag records returned by a list response
examples:
- - created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
last_ips:
- string
mac: string
match: wlan_id
modified_time: 0
name: string
op: in
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
resource_mac: string
services:
- string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
specs:
- port_range: string
protocol: tcp
subnets:
- string
subnet: string
type: match
values:
- string
contentMediaType: application/json
examples:
Example:
value:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
last_ips:
- string
mac: string
match: wlan_id
modified_time: 0
name: string
op: in
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
resource_mac: string
services:
- string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
specs:
- port_range: string
protocol: tcp
subnets:
- string
subnet: string
type: match
values:
- string
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/wxlan_tag'
description: WxLAN tag records returned by a list response
examples:
- - created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
last_ips:
- string
mac: string
match: wlan_id
modified_time: 0
name: string
op: in
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
resource_mac: string
services:
- string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
specs:
- port_range: string
protocol: tcp
subnets:
- string
subnet: string
type: match
values:
- string
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
last_ips:
- string
mac: string
match: wlan_id
modified_time: 0
name: string
op: in
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
resource_mac: string
services:
- string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
specs:
- port_range: string
protocol: tcp
subnets:
- string
subnet: string
type: match
values:
- string
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs WxTags
summary: createOrgWxTag
description: Create WxLAN Tag
operationId: createOrgWxTag
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/wxlan_tag'
- description: Request Body
examples:
- '{"match":"app","name":"match app","type":"match","values":["gmail","dropbox"]}'
- '{"match":"client_mac","name":"file_servers","type":"match","values":["b0c4e7001543","a0c4e7001543","00c4e7001543"]}'
- '{"match":"hostname","name":"mist","type":"match","values":["mist.com"]}'
- '{"match":"ip_range_subnet","name":"file_servers","type":"match","values":["10.1.2.1","10.2.3.4/24","10.1.2.5-10.2.3.4"]}'
- '{"match":"port","name":"web-ports","type":"match","values":["80","8000","8080"]}'
- '{"match":"psk_name","name":"VIP","type":"match","values":["test_key1","test_key2"]}'
- '{"match":"psk_role","name":"VIP","type":"match","values":["test_role"]}'
- '{"match":"radius_group","name":"VIP","type":"match","values":["vip"]}'
- '{"match":"radius_username","name":"VIP","type":"match","values":["john@abc.com","eric@abc.com"]}'
- '{"name":"protocol-subnet-port","specs":[{"port_range":"80","protocol":"tcp","subnets":["10.1.2.0/24"]}],"type":"spec"}'
- '{"name":"vlan-assignment","type":"vlan","vlan_id":1055}'
- '{"match":"wlan_id","name":"guest-wlan","type":"match","values":["be22bba78e22e1cf5185b880816fe2cf"]}'
contentMediaType: application/json
examples:
app:
value:
match: app
name: match app
type: match
values:
- gmail
- dropbox
client_mac:
value:
match: client_mac
name: file_servers
type: match
values:
- b0c4e7001543
- a0c4e7001543
- 00c4e7001543
hostnames:
value:
match: hostname
name: mist
type: match
values:
- mist.com
ip_range_subnets:
value:
match: ip_range_subnet
name: file_servers
type: match
values:
- 10.1.2.1
- 10.2.3.4/24
- 10.1.2.5-10.2.3.4
ports:
value:
match: port
name: web-ports
type: match
values:
- '80'
- '8000'
- '8080'
psk_name:
value:
match: psk_name
name: VIP
type: match
values:
- test_key1
- test_key2
psk_role:
value:
match: psk_role
name: VIP
type: match
values:
- test_role
radius_group:
value:
match: radius_group
name: VIP
type: match
values:
- vip
radius_username:
value:
match: radius_username
name: VIP
type: match
values:
- john@abc.com
- eric@abc.com
traffic-spec:
value:
name: protocol-subnet-port
specs:
- port_range: '80'
protocol: tcp
subnets:
- 10.1.2.0/24
type: spec
vlan:
value:
name: vlan-assignment
type: vlan
vlan_id: 1055
wlan_id:
value:
match: wlan_id
name: guest-wlan
type: match
values:
- be22bba78e22e1cf5185b880816fe2cf
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/wxlan_tag'
- description: >-
WxLAN Tag
* type:
* client: created manually (e.g. on wireless client table, when they spot a device of interest, they can create a wxlan tag for it
* resource: created automatically when we discover a network resource
* subnet: create automatically when a subnet is discovered
* match:
* wlan_id, ap_id: values are a list of Wlan / Device ids
* client_mac: values are a list of MAC addresses
* radius_group: this is a smart tag that matches RADIUS-Filter-ID, Airespace-ACL-Name (VendorID=14179, VendorType=6) / Aruba-User-Role (VendorID=14823, VendorType=1)
* radius_username: this matches the ATTR-User-Name(1)
* radius_class: the matches the ATTR-Class(25)
* radius_attr: the values are [ "6=1" , "26=10.2.3.4" ], this support other RADIUS attributes where we know the type
* radius_vendor: the values are [ "14179.10=1" , "14178.16=1.2.3.4" ], this matches vendor attributes and will be dynamically evaluated
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
last_ips:
- string
mac: string
match: wlan_id
modified_time: 0
name: string
op: in
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
resource_mac: string
services:
- string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
specs:
- port_range: string
protocol: tcp
subnets:
- string
subnet: string
type: match
values:
- string
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
last_ips:
- string
mac: string
match: wlan_id
modified_time: 0
name: string
op: in
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
resource_mac: string
services:
- string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
specs:
- port_range: string
protocol: tcp
subnets:
- string
subnet: string
type: match
values:
- string
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/wxlan_tag'
- description: >-
WxLAN Tag
* type:
* client: created manually (e.g. on wireless client table, when they spot a device of interest, they can create a wxlan tag for it
* resource: created automatically when we discover a network resource
* subnet: create automatically when a subnet is discovered
* match:
* wlan_id, ap_id: values are a list of Wlan / Device ids
* client_mac: values are a list of MAC addresses
* radius_group: this is a smart tag that matches RADIUS-Filter-ID, Airespace-ACL-Name (VendorID=14179, VendorType=6) / Aruba-User-Role (VendorID=14823, VendorType=1)
* radius_username: this matches the ATTR-User-Name(1)
* radius_class: the matches the ATTR-Class(25)
* radius_attr: the values are [ "6=1" , "26=10.2.3.4" ], this support other RADIUS attributes where we know the type
* radius_vendor: the values are [ "14179.10=1" , "14178.16=1.2.3.4" ], this matches vendor attributes and will be dynamically evaluated
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
last_ips:
- string
mac: string
match: wlan_id
modified_time: 0
name: string
op: in
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
resource_mac: string
services:
- string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
specs:
- port_range: string
protocol: tcp
subnets:
- string
subnet: string
type: match
values:
- string
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
last_ips:
- string
mac: string
match: wlan_id
modified_time: 0
name: string
op: in
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
resource_mac: string
services:
- string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
specs:
- port_range: string
protocol: tcp
subnets:
- string
subnet: string
type: match
values:
- string
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/wxtags/apps:
get:
tags:
- Orgs WxTags
summary: getOrgApplicationList
description: Get Application List
operationId: getOrgApplicationList
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: List of Applications
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/search_wxtag_apps_item'
description: Applications that can be referenced by WxTag rules
examples:
- - group: Emails
key: gmail
name: Gmail - web/app
contentMediaType: application/json
examples:
Example:
value:
- group: Emails
key: gmail
name: Gmail - web/app
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/search_wxtag_apps_item'
description: Applications that can be referenced by WxTag rules
examples:
- - group: Emails
key: gmail
name: Gmail - web/app
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- group: Emails
key: gmail
name: Gmail - web/app
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/wxtags/{wxtag_id}:
delete:
tags:
- Orgs WxTags
summary: deleteOrgWxTag
description: Delete WxLAN Tag
operationId: deleteOrgWxTag
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: wxtag_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Orgs WxTags
summary: getOrgWxTag
description: Get WxLAN Tag Details
operationId: getOrgWxTag
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: wxtag_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/wxlan_tag'
- description: >-
WxLAN Tag
* type:
* client: created manually (e.g. on wireless client table, when they spot a device of interest, they can create a wxlan tag for it
* resource: created automatically when we discover a network resource
* subnet: create automatically when a subnet is discovered
* match:
* wlan_id, ap_id: values are a list of Wlan / Device ids
* client_mac: values are a list of MAC addresses
* radius_group: this is a smart tag that matches RADIUS-Filter-ID, Airespace-ACL-Name (VendorID=14179, VendorType=6) / Aruba-User-Role (VendorID=14823, VendorType=1)
* radius_username: this matches the ATTR-User-Name(1)
* radius_class: the matches the ATTR-Class(25)
* radius_attr: the values are [ "6=1" , "26=10.2.3.4" ], this support other RADIUS attributes where we know the type
* radius_vendor: the values are [ "14179.10=1" , "14178.16=1.2.3.4" ], this matches vendor attributes and will be dynamically evaluated
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
last_ips:
- string
mac: string
match: wlan_id
modified_time: 0
name: string
op: in
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
resource_mac: string
services:
- string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
specs:
- port_range: string
protocol: tcp
subnets:
- string
subnet: string
type: match
values:
- string
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
last_ips:
- string
mac: string
match: wlan_id
modified_time: 0
name: string
op: in
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
resource_mac: string
services:
- string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
specs:
- port_range: string
protocol: tcp
subnets:
- string
subnet: string
type: match
values:
- string
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/wxlan_tag'
- description: >-
WxLAN Tag
* type:
* client: created manually (e.g. on wireless client table, when they spot a device of interest, they can create a wxlan tag for it
* resource: created automatically when we discover a network resource
* subnet: create automatically when a subnet is discovered
* match:
* wlan_id, ap_id: values are a list of Wlan / Device ids
* client_mac: values are a list of MAC addresses
* radius_group: this is a smart tag that matches RADIUS-Filter-ID, Airespace-ACL-Name (VendorID=14179, VendorType=6) / Aruba-User-Role (VendorID=14823, VendorType=1)
* radius_username: this matches the ATTR-User-Name(1)
* radius_class: the matches the ATTR-Class(25)
* radius_attr: the values are [ "6=1" , "26=10.2.3.4" ], this support other RADIUS attributes where we know the type
* radius_vendor: the values are [ "14179.10=1" , "14178.16=1.2.3.4" ], this matches vendor attributes and will be dynamically evaluated
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
last_ips:
- string
mac: string
match: wlan_id
modified_time: 0
name: string
op: in
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
resource_mac: string
services:
- string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
specs:
- port_range: string
protocol: tcp
subnets:
- string
subnet: string
type: match
values:
- string
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
last_ips:
- string
mac: string
match: wlan_id
modified_time: 0
name: string
op: in
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
resource_mac: string
services:
- string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
specs:
- port_range: string
protocol: tcp
subnets:
- string
subnet: string
type: match
values:
- string
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Orgs WxTags
summary: updateOrgWxTag
description: Update WxLAN Tag
operationId: updateOrgWxTag
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: wxtag_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/wxlan_tag'
- description: Request Body
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/wxlan_tag'
- description: >-
WxLAN Tag
* type:
* client: created manually (e.g. on wireless client table, when they spot a device of interest, they can create a wxlan tag for it
* resource: created automatically when we discover a network resource
* subnet: create automatically when a subnet is discovered
* match:
* wlan_id, ap_id: values are a list of Wlan / Device ids
* client_mac: values are a list of MAC addresses
* radius_group: this is a smart tag that matches RADIUS-Filter-ID, Airespace-ACL-Name (VendorID=14179, VendorType=6) / Aruba-User-Role (VendorID=14823, VendorType=1)
* radius_username: this matches the ATTR-User-Name(1)
* radius_class: the matches the ATTR-Class(25)
* radius_attr: the values are [ "6=1" , "26=10.2.3.4" ], this support other RADIUS attributes where we know the type
* radius_vendor: the values are [ "14179.10=1" , "14178.16=1.2.3.4" ], this matches vendor attributes and will be dynamically evaluated
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
last_ips:
- string
mac: string
match: wlan_id
modified_time: 0
name: string
op: in
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
resource_mac: string
services:
- string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
specs:
- port_range: string
protocol: tcp
subnets:
- string
subnet: string
type: match
values:
- string
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
last_ips:
- string
mac: string
match: wlan_id
modified_time: 0
name: string
op: in
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
resource_mac: string
services:
- string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
specs:
- port_range: string
protocol: tcp
subnets:
- string
subnet: string
type: match
values:
- string
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/wxlan_tag'
- description: >-
WxLAN Tag
* type:
* client: created manually (e.g. on wireless client table, when they spot a device of interest, they can create a wxlan tag for it
* resource: created automatically when we discover a network resource
* subnet: create automatically when a subnet is discovered
* match:
* wlan_id, ap_id: values are a list of Wlan / Device ids
* client_mac: values are a list of MAC addresses
* radius_group: this is a smart tag that matches RADIUS-Filter-ID, Airespace-ACL-Name (VendorID=14179, VendorType=6) / Aruba-User-Role (VendorID=14823, VendorType=1)
* radius_username: this matches the ATTR-User-Name(1)
* radius_class: the matches the ATTR-Class(25)
* radius_attr: the values are [ "6=1" , "26=10.2.3.4" ], this support other RADIUS attributes where we know the type
* radius_vendor: the values are [ "14179.10=1" , "14178.16=1.2.3.4" ], this matches vendor attributes and will be dynamically evaluated
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
last_ips:
- string
mac: string
match: wlan_id
modified_time: 0
name: string
op: in
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
resource_mac: string
services:
- string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
specs:
- port_range: string
protocol: tcp
subnets:
- string
subnet: string
type: match
values:
- string
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
last_ips:
- string
mac: string
match: wlan_id
modified_time: 0
name: string
op: in
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
resource_mac: string
services:
- string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
specs:
- port_range: string
protocol: tcp
subnets:
- string
subnet: string
type: match
values:
- string
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/wxtags/{wxtag_id}/clients:
get:
tags:
- Orgs WxTags
summary: getOrgCurrentMatchingClientsOfAWxTag
description: Get Current Matching Clients of a WXLAN Tag
operationId: getOrgCurrentMatchingClientsOfAWxTag
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: wxtag_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/wxtag_client'
description: Clients associated with a WxLAN tag
contentMediaType: application/json
application/vnd.api+json:
schema:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/wxtag_client'
description: Clients associated with a WxLAN tag
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/wxtunnels:
get:
tags:
- Orgs WxTunnels
summary: listOrgWxTunnels
description: Get List of Org WxLAN Tunnels
operationId: listOrgWxTunnels
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/wxlan_tunnel'
description: WxLAN tunnel records returned by a list response
examples:
- - created_time: 0
dmvpn:
enabled: true
holding_time: 0
host_routes:
- string
for_mgmt: true
hello_interval: 1
hello_retries: 3
hostname: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ipsec:
enabled: true
psk: string123
is_static: true
modified_time: 0
mtu: 1500
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
peers:
- string
router_id: string
secret: string
sessions:
- ap_as_session_id: string
comment: string
enable_cookie: true
ethertype: ethernet
local_session_id: 1
pseudo_802.1ad_enabled: true
remote_id: string
remote_session_id: 1
use_ap_as_session_ids: true
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
udp_port: 0
use_udp: true
contentMediaType: application/json
examples:
Example:
value:
- created_time: 0
dmvpn:
enabled: true
holding_time: 0
host_routes:
- string
for_mgmt: true
hello_interval: 1
hello_retries: 3
hostname: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ipsec:
enabled: true
psk: string123
is_static: true
modified_time: 0
mtu: 1500
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
peers:
- string
router_id: string
secret: string
sessions:
- ap_as_session_id: string
comment: string
enable_cookie: true
ethertype: ethernet
local_session_id: 1
pseudo_802.1ad_enabled: true
remote_id: string
remote_session_id: 1
use_ap_as_session_ids: true
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
udp_port: 0
use_udp: true
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/wxlan_tunnel'
description: WxLAN tunnel records returned by a list response
examples:
- - created_time: 0
dmvpn:
enabled: true
holding_time: 0
host_routes:
- string
for_mgmt: true
hello_interval: 1
hello_retries: 3
hostname: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ipsec:
enabled: true
psk: string123
is_static: true
modified_time: 0
mtu: 1500
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
peers:
- string
router_id: string
secret: string
sessions:
- ap_as_session_id: string
comment: string
enable_cookie: true
ethertype: ethernet
local_session_id: 1
pseudo_802.1ad_enabled: true
remote_id: string
remote_session_id: 1
use_ap_as_session_ids: true
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
udp_port: 0
use_udp: true
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- created_time: 0
dmvpn:
enabled: true
holding_time: 0
host_routes:
- string
for_mgmt: true
hello_interval: 1
hello_retries: 3
hostname: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ipsec:
enabled: true
psk: string123
is_static: true
modified_time: 0
mtu: 1500
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
peers:
- string
router_id: string
secret: string
sessions:
- ap_as_session_id: string
comment: string
enable_cookie: true
ethertype: ethernet
local_session_id: 1
pseudo_802.1ad_enabled: true
remote_id: string
remote_session_id: 1
use_ap_as_session_ids: true
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
udp_port: 0
use_udp: true
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs WxTunnels
summary: createOrgWxTunnel
description: Create Org WxAN Tunnel
operationId: createOrgWxTunnel
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/wxlan_tunnel'
- description: Request Body
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/wxlan_tunnel'
- description: WxLAN tunnel configuration for L2TPv3 or DMVPN connectivity
examples:
- created_time: 0
dmvpn:
enabled: true
holding_time: 0
host_routes:
- string
for_mgmt: true
hello_interval: 1
hello_retries: 3
hostname: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ipsec:
enabled: true
psk: string123
is_static: true
modified_time: 0
mtu: 1500
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
peers:
- string
router_id: string
secret: string
sessions:
- ap_as_session_id: string
comment: string
enable_cookie: true
ethertype: ethernet
local_session_id: 1
pseudo_802.1ad_enabled: true
remote_id: string
remote_session_id: 1
use_ap_as_session_ids: true
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
udp_port: 0
use_udp: true
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
dmvpn:
enabled: true
holding_time: 0
host_routes:
- string
for_mgmt: true
hello_interval: 1
hello_retries: 3
hostname: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ipsec:
enabled: true
psk: string123
is_static: true
modified_time: 0
mtu: 1500
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
peers:
- string
router_id: string
secret: string
sessions:
- ap_as_session_id: string
comment: string
enable_cookie: true
ethertype: ethernet
local_session_id: 1
pseudo_802.1ad_enabled: true
remote_id: string
remote_session_id: 1
use_ap_as_session_ids: true
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
udp_port: 0
use_udp: true
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/wxlan_tunnel'
- description: WxLAN tunnel configuration for L2TPv3 or DMVPN connectivity
examples:
- created_time: 0
dmvpn:
enabled: true
holding_time: 0
host_routes:
- string
for_mgmt: true
hello_interval: 1
hello_retries: 3
hostname: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ipsec:
enabled: true
psk: string123
is_static: true
modified_time: 0
mtu: 1500
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
peers:
- string
router_id: string
secret: string
sessions:
- ap_as_session_id: string
comment: string
enable_cookie: true
ethertype: ethernet
local_session_id: 1
pseudo_802.1ad_enabled: true
remote_id: string
remote_session_id: 1
use_ap_as_session_ids: true
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
udp_port: 0
use_udp: true
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
dmvpn:
enabled: true
holding_time: 0
host_routes:
- string
for_mgmt: true
hello_interval: 1
hello_retries: 3
hostname: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ipsec:
enabled: true
psk: string123
is_static: true
modified_time: 0
mtu: 1500
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
peers:
- string
router_id: string
secret: string
sessions:
- ap_as_session_id: string
comment: string
enable_cookie: true
ethertype: ethernet
local_session_id: 1
pseudo_802.1ad_enabled: true
remote_id: string
remote_session_id: 1
use_ap_as_session_ids: true
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
udp_port: 0
use_udp: true
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/wxtunnels/{wxtunnel_id}:
delete:
tags:
- Orgs WxTunnels
summary: deleteOrgWxTunnel
description: Delete Org WxLAN Tunnel
operationId: deleteOrgWxTunnel
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: wxtunnel_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Orgs WxTunnels
summary: getOrgWxTunnel
description: Get Org WxLAN Tunnel Details
operationId: getOrgWxTunnel
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: wxtunnel_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/wxlan_tunnel'
- description: WxLAN tunnel configuration for L2TPv3 or DMVPN connectivity
examples:
- created_time: 0
dmvpn:
enabled: true
holding_time: 0
host_routes:
- string
for_mgmt: true
hello_interval: 1
hello_retries: 3
hostname: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ipsec:
enabled: true
psk: string123
is_static: true
modified_time: 0
mtu: 1500
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
peers:
- string
router_id: string
secret: string
sessions:
- ap_as_session_id: string
comment: string
enable_cookie: true
ethertype: ethernet
local_session_id: 1
pseudo_802.1ad_enabled: true
remote_id: string
remote_session_id: 1
use_ap_as_session_ids: true
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
udp_port: 0
use_udp: true
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
dmvpn:
enabled: true
holding_time: 0
host_routes:
- string
for_mgmt: true
hello_interval: 1
hello_retries: 3
hostname: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ipsec:
enabled: true
psk: string123
is_static: true
modified_time: 0
mtu: 1500
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
peers:
- string
router_id: string
secret: string
sessions:
- ap_as_session_id: string
comment: string
enable_cookie: true
ethertype: ethernet
local_session_id: 1
pseudo_802.1ad_enabled: true
remote_id: string
remote_session_id: 1
use_ap_as_session_ids: true
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
udp_port: 0
use_udp: true
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/wxlan_tunnel'
- description: WxLAN tunnel configuration for L2TPv3 or DMVPN connectivity
examples:
- created_time: 0
dmvpn:
enabled: true
holding_time: 0
host_routes:
- string
for_mgmt: true
hello_interval: 1
hello_retries: 3
hostname: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ipsec:
enabled: true
psk: string123
is_static: true
modified_time: 0
mtu: 1500
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
peers:
- string
router_id: string
secret: string
sessions:
- ap_as_session_id: string
comment: string
enable_cookie: true
ethertype: ethernet
local_session_id: 1
pseudo_802.1ad_enabled: true
remote_id: string
remote_session_id: 1
use_ap_as_session_ids: true
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
udp_port: 0
use_udp: true
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
dmvpn:
enabled: true
holding_time: 0
host_routes:
- string
for_mgmt: true
hello_interval: 1
hello_retries: 3
hostname: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ipsec:
enabled: true
psk: string123
is_static: true
modified_time: 0
mtu: 1500
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
peers:
- string
router_id: string
secret: string
sessions:
- ap_as_session_id: string
comment: string
enable_cookie: true
ethertype: ethernet
local_session_id: 1
pseudo_802.1ad_enabled: true
remote_id: string
remote_session_id: 1
use_ap_as_session_ids: true
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
udp_port: 0
use_udp: true
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Orgs WxTunnels
summary: updateOrgWxTunnel
description: Update Org WxLAN Tunnel
operationId: updateOrgWxTunnel
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: wxtunnel_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/wxlan_tunnel'
- description: Request Body
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/wxlan_tunnel'
- description: WxLAN tunnel configuration for L2TPv3 or DMVPN connectivity
examples:
- created_time: 0
dmvpn:
enabled: true
holding_time: 0
host_routes:
- string
for_mgmt: true
hello_interval: 1
hello_retries: 3
hostname: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ipsec:
enabled: true
psk: string123
is_static: true
modified_time: 0
mtu: 1500
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
peers:
- string
router_id: string
secret: string
sessions:
- ap_as_session_id: string
comment: string
enable_cookie: true
ethertype: ethernet
local_session_id: 1
pseudo_802.1ad_enabled: true
remote_id: string
remote_session_id: 1
use_ap_as_session_ids: true
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
udp_port: 0
use_udp: true
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
dmvpn:
enabled: true
holding_time: 0
host_routes:
- string
for_mgmt: true
hello_interval: 1
hello_retries: 3
hostname: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ipsec:
enabled: true
psk: string123
is_static: true
modified_time: 0
mtu: 1500
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
peers:
- string
router_id: string
secret: string
sessions:
- ap_as_session_id: string
comment: string
enable_cookie: true
ethertype: ethernet
local_session_id: 1
pseudo_802.1ad_enabled: true
remote_id: string
remote_session_id: 1
use_ap_as_session_ids: true
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
udp_port: 0
use_udp: true
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/wxlan_tunnel'
- description: WxLAN tunnel configuration for L2TPv3 or DMVPN connectivity
examples:
- created_time: 0
dmvpn:
enabled: true
holding_time: 0
host_routes:
- string
for_mgmt: true
hello_interval: 1
hello_retries: 3
hostname: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ipsec:
enabled: true
psk: string123
is_static: true
modified_time: 0
mtu: 1500
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
peers:
- string
router_id: string
secret: string
sessions:
- ap_as_session_id: string
comment: string
enable_cookie: true
ethertype: ethernet
local_session_id: 1
pseudo_802.1ad_enabled: true
remote_id: string
remote_session_id: 1
use_ap_as_session_ids: true
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
udp_port: 0
use_udp: true
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
dmvpn:
enabled: true
holding_time: 0
host_routes:
- string
for_mgmt: true
hello_interval: 1
hello_retries: 3
hostname: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ipsec:
enabled: true
psk: string123
is_static: true
modified_time: 0
mtu: 1500
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
peers:
- string
router_id: string
secret: string
sessions:
- ap_as_session_id: string
comment: string
enable_cookie: true
ethertype: ethernet
local_session_id: 1
pseudo_802.1ad_enabled: true
remote_id: string
remote_session_id: 1
use_ap_as_session_ids: true
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
udp_port: 0
use_udp: true
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/analyze_spectrum:
get:
tags:
- Sites Spectrum Analysis
summary: getSiteRunningSpectrumAnalysis
description: Get the running spectrum analysis for a site
operationId: getSiteRunningSpectrumAnalysis
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_running_spectrum_analysis'
- description: Running spectrum analysis session for a site
examples:
- band: '5'
channels:
- 36
- 40
- 44
- 48
device_id: 00000000-0000-0000-1000-5c5b35bd76bb
duration: 600
format: stream
started_time: 1435080709
width: 20
contentMediaType: application/json
examples:
Example:
value:
band: '5'
channels:
- 36
- 40
- 44
- 48
device_id: 00000000-0000-0000-1000-5c5b35bd76bb
duration: 600
format: stream
started_time: 1435080709
width: 20
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_running_spectrum_analysis'
- description: Running spectrum analysis session for a site
examples:
- band: '5'
channels:
- 36
- 40
- 44
- 48
device_id: 00000000-0000-0000-1000-5c5b35bd76bb
duration: 600
format: stream
started_time: 1435080709
width: 20
contentMediaType: application/vnd.api+json
examples:
Example:
value:
band: '5'
channels:
- 36
- 40
- 44
- 48
device_id: 00000000-0000-0000-1000-5c5b35bd76bb
duration: 600
format: stream
started_time: 1435080709
width: 20
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Sites Spectrum Analysis
summary: initiateSiteAnalyzeSpectrum
description: "Initiate a spectrum analysis for a site\n\n\nThe output will be available through websocket. As there can be multiple command\nissued against the same device at the same time and the output all goes through\nthe same websocket stream, session is introduced for demux.\n\n\n\n#### Subscribe to Device Command outputs\n\n`WS /api-ws/v1/stream`\n\n\n```json { \"subscribe\": \"/sites/{site_id}/analyze_spectrum\" } ```\n\n#### Example output from ws stream\n\n```json\n{\n \"event\": \"data\",\n \"channel\": \"/sites/4ac1dcf4-9d8b-7211-65c4-057819f0862b/analyze_spectrum\",\n \"data\": {\n \"session\": \"session_id\",\n\n \"fft_samples\": [\n {\n \"frequency\": 2437.0,\n \"rssi / signal ?\": -93\n },\n ...\n ],\n\n \"channel_usage\": [\n {\n \"channel\": 36,\n \"noise\": -78,\n\n \"wifi\": 0.13,\n \"non_wifi\": 0.08\n },\n ...\n ]\n }\n} \n```\n"
operationId: initiateSiteAnalyzeSpectrum
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/spectrum_analysis'
- description: Request Body
examples:
- band: '5'
channels:
- 36
- 40
- 44
- 48
device_id: 00000000-0000-0000-1000-5c5b35bd76bb
duration: 600
format: stream
contentMediaType: application/json
examples:
Example:
value:
band: '5'
channels:
- 36
- 40
- 44
- 48
device_id: 00000000-0000-0000-1000-5c5b35bd76bb
duration: 600
format: stream
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session'
- description: Response containing the WebSocket session handle for asynchronous command output
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session'
- description: Response containing the WebSocket session handle for asynchronous command output
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/stats/analyze_spectrum:
get:
tags:
- Sites Spectrum Analysis
summary: listSiteSpectrumAnalysis
description: List the past spectrum analysis for a site
operationId: listSiteSpectrumAnalysis
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_past_spectrum_analysis'
- description: Paginated response for past site spectrum analysis records
examples:
- end: 1694708579
limit: 10
results:
- band: '5'
channel_usage:
- channel: 36
noise: -78
non_wifi: 0.08
wifi: 0.13
fft_samples:
- frequency: 2437
rssi: -92
signal7: -93
mac: 5c5b35bd76bb
org_id: f2695c32-0e83-4936-b1b2-96fc88051213
timestamp: 1694098696
start: 1694622179
total: 4
contentMediaType: application/json
examples:
Example:
value:
end: 1694708579
limit: 10
results:
- band: '5'
channel_usage:
- channel: 36
noise: -78
non_wifi: 0.08
wifi: 0.13
fft_samples:
- frequency: 2437
rssi: -92
signal7: -93
mac: 5c5b35bd76bb
org_id: f2695c32-0e83-4936-b1b2-96fc88051213
timestamp: 1694098696
start: 1694622179
total: 4
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_past_spectrum_analysis'
- description: Paginated response for past site spectrum analysis records
examples:
- end: 1694708579
limit: 10
results:
- band: '5'
channel_usage:
- channel: 36
noise: -78
non_wifi: 0.08
wifi: 0.13
fft_samples:
- frequency: 2437
rssi: -92
signal7: -93
mac: 5c5b35bd76bb
org_id: f2695c32-0e83-4936-b1b2-96fc88051213
timestamp: 1694098696
start: 1694622179
total: 4
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 1694708579
limit: 10
results:
- band: '5'
channel_usage:
- channel: 36
noise: -78
non_wifi: 0.08
wifi: 0.13
fft_samples:
- frequency: 2437
rssi: -92
signal7: -93
mac: 5c5b35bd76bb
org_id: f2695c32-0e83-4936-b1b2-96fc88051213
timestamp: 1694098696
start: 1694622179
total: 4
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}:
delete:
tags:
- Sites
summary: deleteSite
description: Delete Site
operationId: deleteSite
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Sites
summary: getSiteInfo
description: >-
Provides information about the site, including its name, address,
timezone, and associated templates. This endpoint is useful for retrieving
the current configuration and details of a specific site.
operationId: getSiteInfo
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/site'
- description: Site configuration and metadata within an organization
examples:
- address: 1601 S. Deanza Blvd., Cupertino, CA, 95014
alarmtemplate_id: 684dfc5c-fe77-2290-eb1d-ef3d677fe168
aptemplate_id: 16bdf952-ade2-4491-80b0-85ce506c760b
country_code: US
created_time: 0
gatewaytemplate_id: 6f9b2e75-9b2f-b5ae-81e3-e14c76f1a90f
id: 497f6eca-6276-5005-bfeb-53cbbbba6f17
latlng:
lat: 37.295833
lng: -122.032946
modified_time: 0
name: Mist Office
networktemplate_id: 12ae9bd2-e0ab-107b-72e8-a7a005565ec2
notes: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
rftemplate_id: bb8a9017-1e36-5d6c-6f2b-551abe8a76a2
secpolicy_id: 3bcd0beb-5d0a-4cbd-92c1-14aea91e98ef
sitegroup_ids:
- 497f6eca-6276-5006-bfeb-53cbbbba6f18
timezone: America/Los_Angeles
contentMediaType: application/json
examples:
Example:
value:
address: 1601 S. Deanza Blvd., Cupertino, CA, 95014
alarmtemplate_id: 684dfc5c-fe77-2290-eb1d-ef3d677fe168
aptemplate_id: 16bdf952-ade2-4491-80b0-85ce506c760b
country_code: US
created_time: 0
gatewaytemplate_id: 6f9b2e75-9b2f-b5ae-81e3-e14c76f1a90f
id: 497f6eca-6276-5005-bfeb-53cbbbba6f17
latlng:
lat: 37.295833
lng: -122.032946
modified_time: 0
name: Mist Office
networktemplate_id: 12ae9bd2-e0ab-107b-72e8-a7a005565ec2
notes: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
rftemplate_id: bb8a9017-1e36-5d6c-6f2b-551abe8a76a2
secpolicy_id: 3bcd0beb-5d0a-4cbd-92c1-14aea91e98ef
sitegroup_ids:
- 497f6eca-6276-5006-bfeb-53cbbbba6f18
timezone: America/Los_Angeles
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/site'
- description: Site configuration and metadata within an organization
examples:
- address: 1601 S. Deanza Blvd., Cupertino, CA, 95014
alarmtemplate_id: 684dfc5c-fe77-2290-eb1d-ef3d677fe168
aptemplate_id: 16bdf952-ade2-4491-80b0-85ce506c760b
country_code: US
created_time: 0
gatewaytemplate_id: 6f9b2e75-9b2f-b5ae-81e3-e14c76f1a90f
id: 497f6eca-6276-5005-bfeb-53cbbbba6f17
latlng:
lat: 37.295833
lng: -122.032946
modified_time: 0
name: Mist Office
networktemplate_id: 12ae9bd2-e0ab-107b-72e8-a7a005565ec2
notes: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
rftemplate_id: bb8a9017-1e36-5d6c-6f2b-551abe8a76a2
secpolicy_id: 3bcd0beb-5d0a-4cbd-92c1-14aea91e98ef
sitegroup_ids:
- 497f6eca-6276-5006-bfeb-53cbbbba6f18
timezone: America/Los_Angeles
contentMediaType: application/vnd.api+json
examples:
Example:
value:
address: 1601 S. Deanza Blvd., Cupertino, CA, 95014
alarmtemplate_id: 684dfc5c-fe77-2290-eb1d-ef3d677fe168
aptemplate_id: 16bdf952-ade2-4491-80b0-85ce506c760b
country_code: US
created_time: 0
gatewaytemplate_id: 6f9b2e75-9b2f-b5ae-81e3-e14c76f1a90f
id: 497f6eca-6276-5005-bfeb-53cbbbba6f17
latlng:
lat: 37.295833
lng: -122.032946
modified_time: 0
name: Mist Office
networktemplate_id: 12ae9bd2-e0ab-107b-72e8-a7a005565ec2
notes: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
rftemplate_id: bb8a9017-1e36-5d6c-6f2b-551abe8a76a2
secpolicy_id: 3bcd0beb-5d0a-4cbd-92c1-14aea91e98ef
sitegroup_ids:
- 497f6eca-6276-5006-bfeb-53cbbbba6f18
timezone: America/Los_Angeles
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Sites
summary: updateSiteInfo
description: "Updates the configuration and metadata for an existing site. \n\n\nThis endpoint allows modification of site properties including location details (address, coordinates, timezone), template associations (alarm, network, RF, security policy templates), site group memberships, and general information (name, notes).\n\n\nAll fields are optional and only provided fields will be updated."
operationId: updateSiteInfo
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/site'
- description: Request Body
examples:
- address: string
alarmtemplate_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
country_code: string
latlng:
lat: 0
lng: 0
name: string
networktemplate_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
notes: string
rftemplate_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
secpolicy_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
timezone: string
contentMediaType: application/json
examples:
Example:
value:
address: string
alarmtemplate_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
country_code: string
latlng:
lat: 0
lng: 0
name: string
networktemplate_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
notes: string
rftemplate_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
secpolicy_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
timezone: string
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/site'
- description: Site configuration and metadata within an organization
examples:
- address: 1601 S. Deanza Blvd., Cupertino, CA, 95014
alarmtemplate_id: 684dfc5c-fe77-2290-eb1d-ef3d677fe168
aptemplate_id: 16bdf952-ade2-4491-80b0-85ce506c760b
country_code: US
created_time: 0
gatewaytemplate_id: 6f9b2e75-9b2f-b5ae-81e3-e14c76f1a90f
id: 497f6eca-6276-5005-bfeb-53cbbbba6f17
latlng:
lat: 37.295833
lng: -122.032946
modified_time: 0
name: Mist Office
networktemplate_id: 12ae9bd2-e0ab-107b-72e8-a7a005565ec2
notes: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
rftemplate_id: bb8a9017-1e36-5d6c-6f2b-551abe8a76a2
secpolicy_id: 3bcd0beb-5d0a-4cbd-92c1-14aea91e98ef
sitegroup_ids:
- 497f6eca-6276-5006-bfeb-53cbbbba6f18
timezone: America/Los_Angeles
contentMediaType: application/json
examples:
Example:
value:
address: 1601 S. Deanza Blvd., Cupertino, CA, 95014
alarmtemplate_id: 684dfc5c-fe77-2290-eb1d-ef3d677fe168
aptemplate_id: 16bdf952-ade2-4491-80b0-85ce506c760b
country_code: US
created_time: 0
gatewaytemplate_id: 6f9b2e75-9b2f-b5ae-81e3-e14c76f1a90f
id: 497f6eca-6276-5005-bfeb-53cbbbba6f17
latlng:
lat: 37.295833
lng: -122.032946
modified_time: 0
name: Mist Office
networktemplate_id: 12ae9bd2-e0ab-107b-72e8-a7a005565ec2
notes: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
rftemplate_id: bb8a9017-1e36-5d6c-6f2b-551abe8a76a2
secpolicy_id: 3bcd0beb-5d0a-4cbd-92c1-14aea91e98ef
sitegroup_ids:
- 497f6eca-6276-5006-bfeb-53cbbbba6f18
timezone: America/Los_Angeles
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/site'
- description: Site configuration and metadata within an organization
examples:
- address: 1601 S. Deanza Blvd., Cupertino, CA, 95014
alarmtemplate_id: 684dfc5c-fe77-2290-eb1d-ef3d677fe168
aptemplate_id: 16bdf952-ade2-4491-80b0-85ce506c760b
country_code: US
created_time: 0
gatewaytemplate_id: 6f9b2e75-9b2f-b5ae-81e3-e14c76f1a90f
id: 497f6eca-6276-5005-bfeb-53cbbbba6f17
latlng:
lat: 37.295833
lng: -122.032946
modified_time: 0
name: Mist Office
networktemplate_id: 12ae9bd2-e0ab-107b-72e8-a7a005565ec2
notes: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
rftemplate_id: bb8a9017-1e36-5d6c-6f2b-551abe8a76a2
secpolicy_id: 3bcd0beb-5d0a-4cbd-92c1-14aea91e98ef
sitegroup_ids:
- 497f6eca-6276-5006-bfeb-53cbbbba6f18
timezone: America/Los_Angeles
contentMediaType: application/vnd.api+json
examples:
Example:
value:
address: 1601 S. Deanza Blvd., Cupertino, CA, 95014
alarmtemplate_id: 684dfc5c-fe77-2290-eb1d-ef3d677fe168
aptemplate_id: 16bdf952-ade2-4491-80b0-85ce506c760b
country_code: US
created_time: 0
gatewaytemplate_id: 6f9b2e75-9b2f-b5ae-81e3-e14c76f1a90f
id: 497f6eca-6276-5005-bfeb-53cbbbba6f17
latlng:
lat: 37.295833
lng: -122.032946
modified_time: 0
name: Mist Office
networktemplate_id: 12ae9bd2-e0ab-107b-72e8-a7a005565ec2
notes: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
rftemplate_id: bb8a9017-1e36-5d6c-6f2b-551abe8a76a2
secpolicy_id: 3bcd0beb-5d0a-4cbd-92c1-14aea91e98ef
sitegroup_ids:
- 497f6eca-6276-5006-bfeb-53cbbbba6f18
timezone: America/Los_Angeles
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/alarms/ack:
post:
tags:
- Sites Alarms
summary: AckSiteMultipleAlarms
description: Ack multiple Site Alarms
operationId: AckSiteMultipleAlarms
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/alarm_ack'
- description: Request Body
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/alarms/ack_all:
post:
tags:
- Sites Alarms
summary: ackSiteAllAlarms
description: >-
Ack all Site Alarms
**N.B.**: Batch size for multiple alarm ack and unack has to be less or or equal to 1000.
operationId: ackSiteAllAlarms
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/note_string'
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/alarms/count:
get:
tags:
- Sites Alarms
summary: countSiteAlarms
description: Count alarms for a site, optionally grouped by the `distinct` field and filtered by time range. Use [Count Org Alarms]($e/Orgs%20Alarms/countOrgAlarms) to count alarms across the organization.
operationId: countSiteAlarms
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field used to group this count response. enum: `acked`, `group`, `severity`, `type`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/alarm_count_distinct'
- description: 'Field used to group this count response. enum: `acked`, `group`, `severity`, `type`'
- name: ack_admin_name
in: query
description: Name of the admins who have acked the alarms; accepts multiple values separated by comma
style: form
explode: true
schema:
type: string
- name: acked
in: query
description: Filter alarm results by whether the alarm has been acknowledged
style: form
explode: true
schema:
type: boolean
- name: type
in: query
description: Key-name of the alarms; accepts multiple values separated by comma
style: form
explode: true
schema:
type: string
- name: severity
in: query
description: Alarm severity; accepts multiple values separated by comma
style: form
explode: true
schema:
type: string
- name: group
in: query
description: Alarm group name; accepts multiple values separated by comma
style: form
explode: true
schema:
type: string
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/alarms/search:
get:
tags:
- Sites Alarms
summary: searchSiteAlarms
description: Search alarms for a site with filters for alarm group, severity, type, acknowledgement state, acknowledgement admin, and time range. Use [Search Org Alarms]($e/Orgs%20Alarms/searchOrgAlarms) to search alarms across the organization.
operationId: searchSiteAlarms
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: group
in: query
description: 'Alarm group used to filter alarm results. enum: `certificate_expiry`, `infrastructure`, `marvis`, `security`. The `marvis` group is used to retrieve AI-driven network issue detections. Known Marvis alarm types include: `bad_cable`, `bad_wan_uplink`, `dns_failure`, `arp_failure`, `auth_failure`, `dhcp_failure`, `missing_vlan`, `negotiation_mismatch`, `port_flap`. Results include resolution status (`status`, `resolved_time`) and affected entity details.'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/alarm_group'
- description: 'Alarm group used to filter alarm results. enum: `certificate_expiry`, `infrastructure`, `marvis`, `security`. The `marvis` group is used to retrieve AI-driven network issue detections. Known Marvis alarm types include: `bad_cable`, `bad_wan_uplink`, `dns_failure`, `arp_failure`, `auth_failure`, `dhcp_failure`, `missing_vlan`, `negotiation_mismatch`, `port_flap`. Results include resolution status (`status`, `resolved_time`) and affected entity details.'
- name: severity
in: query
description: 'Alarm severity used to filter results. enum: `critical`, `info`, `warn`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/alarm_severity'
- description: 'Alarm severity used to filter results. enum: `critical`, `info`, `warn`'
- name: type
in: query
description: Filter alarms by alarm type. Accepts multiple values separated by comma. Use [List Alarm Definitions](/#operations/listAlarmDefinitions) to get the list of possible alarm types
style: form
explode: true
schema:
type: string
examples:
- infra_dhcp_failure,missing_vlan
- name: ack_admin_name
in: query
description: Name of the admins who have acked the alarms; accepts multiple values separated by comma
style: form
explode: true
schema:
type: string
- name: acked
in: query
description: Filter alarm results by whether the alarm has been acknowledged
style: form
explode: true
schema:
type: boolean
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/alarm_search_result'
- description: Paginated response returned by an alarm search
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/alarm_search_result'
- description: Paginated response returned by an alarm search
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/alarms/unack:
post:
tags:
- Sites Alarms
summary: unackSiteMultipleAlarms
description: Unack multiple Site Alarms
operationId: unackSiteMultipleAlarms
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/alarm_ack'
- description: Request Body
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/alarms/unack_all:
post:
tags:
- Sites Alarms
summary: unackSiteAllAlarms
description: >-
Unack all Site Alarms
**N.B.**: Batch size for multiple alarm ack and unack has to be less or or equal to 1000.
operationId: unackSiteAllAlarms
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/note_string'
- description: Request Body
examples:
- note: maintenance window
contentMediaType: application/json
examples:
Example:
value:
note: maintenance window
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/alarms/{alarm_id}/ack:
post:
tags:
- Sites Alarms
summary: ackSiteAlarm
description: Ack Site Alarm
operationId: ackSiteAlarm
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: alarm_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/note_string'
- description: Request Body
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/alarms/{alarm_id}/unack:
post:
tags:
- Sites Alarms
summary: unackSiteAlarm
description: Unack Site Alarm
operationId: unackSiteAlarm
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: alarm_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/note_string'
- description: Request Body
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/subscriptions:
delete:
tags:
- Sites Alarms
summary: UnsubscribeSiteAlarms
description: Unsubscribe to Site Alarms
operationId: UnsubscribeSiteAlarms
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Sites Alarms
summary: SubscribeSiteAlarms
description: Subscribe to Site Alarms
operationId: SubscribeSiteAlarms
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/aptemplates/derived:
get:
tags:
- Sites AP Templates
summary: listSiteApTemplatesDerived
description: Get the list of derived AP Templates for a site
operationId: listSiteApTemplatesDerived
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: resolve
in: query
description: Whether resolve the site variables
style: form
explode: true
schema:
type: boolean
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/ap_template'
description: List of AP templates
examples:
- - ap_matching:
enabled: true
rules:
- match_model: string
name: string
port_config:
eth1,eth2:
disabled: true
dynamic_vlan:
default_vlan_id: 999
enabled: true
port_vlan_id: 1
vlan_id: 9
vlan_ids: 1, 10, 50
created_time: 0
for_site: true
id: 497f6eca-6276-4993-bfeb-53cbbbba9f08
modified_time: 0
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
wifi:
cisco_enabled: true
disable_11k: false
disable_radios_when_power_constrained: true
enable_arp_spoof: true
enable_shared_radio_scanning: false
enabled: true
locate_connected: false
locate_unconnected: false
mesh_allow_dfs: false
mesh_enable_crm: true
mesh_enabled: true
proxy_arp: false
contentMediaType: application/json
examples:
Example:
value:
- ap_matching:
enabled: true
rules:
- match_model: string
name: string
port_config:
eth1,eth2:
disabled: true
dynamic_vlan:
default_vlan_id: 999
enabled: true
port_vlan_id: 1
vlan_id: 9
vlan_ids: 1, 10, 50
created_time: 0
for_site: true
id: 497f6eca-6276-4993-bfeb-53cbbbba9f08
modified_time: 0
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
wifi:
cisco_enabled: true
disable_11k: false
disable_radios_when_power_constrained: true
enable_arp_spoof: true
enable_shared_radio_scanning: false
enabled: true
locate_connected: false
locate_unconnected: false
mesh_allow_dfs: false
mesh_enable_crm: true
mesh_enabled: true
proxy_arp: false
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/ap_template'
description: List of AP templates
examples:
- - ap_matching:
enabled: true
rules:
- match_model: string
name: string
port_config:
eth1,eth2:
disabled: true
dynamic_vlan:
default_vlan_id: 999
enabled: true
port_vlan_id: 1
vlan_id: 9
vlan_ids: 1, 10, 50
created_time: 0
for_site: true
id: 497f6eca-6276-4993-bfeb-53cbbbba9f08
modified_time: 0
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
wifi:
cisco_enabled: true
disable_11k: false
disable_radios_when_power_constrained: true
enable_arp_spoof: true
enable_shared_radio_scanning: false
enabled: true
locate_connected: false
locate_unconnected: false
mesh_allow_dfs: false
mesh_enable_crm: true
mesh_enabled: true
proxy_arp: false
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- ap_matching:
enabled: true
rules:
- match_model: string
name: string
port_config:
eth1,eth2:
disabled: true
dynamic_vlan:
default_vlan_id: 999
enabled: true
port_vlan_id: 1
vlan_id: 9
vlan_ids: 1, 10, 50
created_time: 0
for_site: true
id: 497f6eca-6276-4993-bfeb-53cbbbba9f08
modified_time: 0
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
wifi:
cisco_enabled: true
disable_11k: false
disable_radios_when_power_constrained: true
enable_arp_spoof: true
enable_shared_radio_scanning: false
enabled: true
locate_connected: false
locate_unconnected: false
mesh_allow_dfs: false
mesh_enable_crm: true
mesh_enabled: true
proxy_arp: false
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/apps:
get:
tags:
- Sites Applications
summary: listSiteApps
description: Get List of Site Applications
operationId: listSiteApps
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/site_app'
description: Application summaries returned for a site
examples:
- - group: string
key: string
name: string
contentMediaType: application/json
examples:
Example:
value:
- group: string
key: string
name: string
application/vnd.api+json:
schema:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/site_app'
description: Application summaries returned for a site
examples:
- - group: string
key: string
name: string
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- group: string
key: string
name: string
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/anomaly/client/{client_mac}/{metric}:
get:
tags:
- Sites Anomaly
summary: getSiteAnomalyEventsForClient
description: Get Client Anomaly Events
operationId: getSiteAnomalyEventsForClient
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: client_mac
in: path
description: ''
required: true
schema:
pattern: ^[0-9a-fA-F]{12}$
type: string
examples:
- 0000000000ab
- name: metric
in: path
description: See [List Insight Metrics]($e/Constants%20Definitions/listInsightMetrics) for available metrics
required: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_anomaly_search'
- description: Paginated anomaly search response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_anomaly_search'
- description: Paginated anomaly search response
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/anomaly/device/{device_mac}/{metric}:
get:
tags:
- Sites Anomaly
summary: getSiteAnomalyEventsForDevice
description: Get Device Anomaly Events
operationId: getSiteAnomalyEventsForDevice
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: metric
in: path
description: See [List Insight Metrics]($e/Constants%20Definitions/listInsightMetrics) for available metrics
required: true
schema:
type: string
- name: device_mac
in: path
description: ''
required: true
schema:
pattern: ^[0-9a-fA-F]{12}$
type: string
examples:
- 0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_anomaly_search'
- description: Paginated anomaly search response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_anomaly_search'
- description: Paginated anomaly search response
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/anomaly/{metric}:
get:
tags:
- Sites Anomaly
summary: listSiteAnomalyEvents
description: List Site Anomaly Events
operationId: listSiteAnomalyEvents
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: metric
in: path
description: See [List Insight Metrics]($e/Constants%20Definitions/listInsightMetrics) for available metrics
required: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_anomaly_search'
- description: Paginated anomaly search response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_anomaly_search'
- description: Paginated anomaly search response
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/apply_auto_map_assignment:
post:
tags:
- Sites Auto Map Assignment
summary: applySiteAutoMapAssignment
description: Apply (accept) auto map assignment results for a site. Devices are associated with their assigned maps. Omit `map_ids` or provide an empty list to accept all pending assignments; provide specific `map_ids` for a partial accept.
operationId: applySiteAutoMapAssignment
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/auto_map_assignment_request'
- description: Request Body
examples:
- '{}'
- '{"map_ids":["d3c42998-9012-4859-9743-6b9bee475309","f7a21456-7891-4abc-def0-123456789abc"]}'
contentMediaType: application/json
examples:
Accept_All:
value: {}
Accept_Specific_Maps:
value:
map_ids:
- d3c42998-9012-4859-9743-6b9bee475309
- f7a21456-7891-4abc-def0-123456789abc
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_auto_map_assignment_apply'
- description: Result returned after applying accepted auto map assignments
examples:
- accepted_maps:
- d3c42998-9012-4859-9743-6b9bee475309
- f7a21456-7891-4abc-def0-123456789abc
message: "Accepted map assignments for map_ids: ['d3c42998-9012-4859-9743-6b9bee475309', 'f7a21456-7891-4abc-def0-123456789abc']"
contentMediaType: application/json
examples:
Example:
value:
accepted_maps:
- d3c42998-9012-4859-9743-6b9bee475309
- f7a21456-7891-4abc-def0-123456789abc
message: "Accepted map assignments for map_ids: ['d3c42998-9012-4859-9743-6b9bee475309', 'f7a21456-7891-4abc-def0-123456789abc']"
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_auto_map_assignment_apply'
- description: Result returned after applying accepted auto map assignments
examples:
- accepted_maps:
- d3c42998-9012-4859-9743-6b9bee475309
- f7a21456-7891-4abc-def0-123456789abc
message: "Accepted map assignments for map_ids: ['d3c42998-9012-4859-9743-6b9bee475309', 'f7a21456-7891-4abc-def0-123456789abc']"
contentMediaType: application/vnd.api+json
examples:
Example:
value:
accepted_maps:
- d3c42998-9012-4859-9743-6b9bee475309
- f7a21456-7891-4abc-def0-123456789abc
message: "Accepted map assignments for map_ids: ['d3c42998-9012-4859-9743-6b9bee475309', 'f7a21456-7891-4abc-def0-123456789abc']"
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/auto_map_assignment:
delete:
tags:
- Sites Auto Map Assignment
summary: cancelSiteAutoMapAssignment
description: Cancel an in-progress auto map assignment operation for the site. Validates that auto map assignment is currently running, notifies all APs to fetch new configuration, and sends a cancel command to the orchestration service.
operationId: cancelSiteAutoMapAssignment
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Auto map assignment not in progress
headers: {}
content: {}
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Sites Auto Map Assignment
summary: getSiteAutoMapAssignmentStatus
description: Get the current status of auto map assignment for the site.
operationId: getSiteAutoMapAssignmentStatus
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_auto_map_assignment_info'
- description: Auto map assignment status response
examples:
- est_time_left: 280.5
start_time: 1678900062
status: in_progress
time_updated: 1678900100
contentMediaType: application/json
examples:
Example:
value:
est_time_left: 280.5
start_time: 1678900062
status: in_progress
time_updated: 1678900100
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_auto_map_assignment_info'
- description: Auto map assignment status response
examples:
- est_time_left: 280.5
start_time: 1678900062
status: in_progress
time_updated: 1678900100
contentMediaType: application/vnd.api+json
examples:
Example:
value:
est_time_left: 280.5
start_time: 1678900062
status: in_progress
time_updated: 1678900100
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Sites Auto Map Assignment
summary: startSiteAutoMapAssignment
description: >-
Start the auto map assignment process for a site. The service automatically assigns APs to maps based on BLE ranging data and requires at least 3 APs with compatible firmware and model support for BLE.
Repeated POST requests while a site assignment is still running will be rejected.
operationId: startSiteAutoMapAssignment
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/auto_map_assignment'
- description: Request Body
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_auto_map_assignment'
- description: Auto map assignment start response
examples:
- devices:
5c5b35000001:
reason: Device meets the minimum requirements for auto map assignment
valid: true
5c5b35000002:
reason: Device meets the minimum requirements for auto map assignment
valid: true
5c5b35000003:
reason: Device meets the minimum requirements for auto map assignment
valid: true
estimated_runtime: 300
reason: Started auto map assignment
started: true
valid: true
contentMediaType: application/json
examples:
Example:
value:
devices:
5c5b35000001:
reason: Device meets the minimum requirements for auto map assignment
valid: true
5c5b35000002:
reason: Device meets the minimum requirements for auto map assignment
valid: true
5c5b35000003:
reason: Device meets the minimum requirements for auto map assignment
valid: true
estimated_runtime: 300
reason: Started auto map assignment
started: true
valid: true
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_auto_map_assignment'
- description: Auto map assignment start response
examples:
- devices:
5c5b35000001:
reason: Device meets the minimum requirements for auto map assignment
valid: true
5c5b35000002:
reason: Device meets the minimum requirements for auto map assignment
valid: true
5c5b35000003:
reason: Device meets the minimum requirements for auto map assignment
valid: true
estimated_runtime: 300
reason: Started auto map assignment
started: true
valid: true
contentMediaType: application/vnd.api+json
examples:
Example:
value:
devices:
5c5b35000001:
reason: Device meets the minimum requirements for auto map assignment
valid: true
5c5b35000002:
reason: Device meets the minimum requirements for auto map assignment
valid: true
5c5b35000003:
reason: Device meets the minimum requirements for auto map assignment
valid: true
estimated_runtime: 300
reason: Started auto map assignment
started: true
valid: true
'400':
description: Auto map assignment already in progress
headers: {}
content: {}
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/clear_auto_map_assignment:
post:
tags:
- Sites Auto Map Assignment
summary: clearSiteAutoMapAssignment
description: Clear (reject) auto map assignment results for a site without applying them. The cached assignment results are cleared. Omit `map_ids` or provide an empty list to reject all pending assignments; provide specific `map_ids` for a partial reject.
operationId: clearSiteAutoMapAssignment
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/auto_map_assignment_request'
- description: Request Body
examples:
- '{}'
- '{"map_ids":["d3c42998-9012-4859-9743-6b9bee475309","f7a21456-7891-4abc-def0-123456789abc"]}'
contentMediaType: application/json
examples:
Clear_All:
value: {}
Clear_Specific_Maps:
value:
map_ids:
- d3c42998-9012-4859-9743-6b9bee475309
- f7a21456-7891-4abc-def0-123456789abc
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_auto_map_assignment_clear'
- description: Result returned after clearing auto map assignment candidates
examples:
- message: "Rejected map assignments for map_ids: ['d3c42998-9012-4859-9743-6b9bee475309', 'f7a21456-7891-4abc-def0-123456789abc']"
rejected_maps:
- d3c42998-9012-4859-9743-6b9bee475309
- f7a21456-7891-4abc-def0-123456789abc
contentMediaType: application/json
examples:
Example:
value:
message: "Rejected map assignments for map_ids: ['d3c42998-9012-4859-9743-6b9bee475309', 'f7a21456-7891-4abc-def0-123456789abc']"
rejected_maps:
- d3c42998-9012-4859-9743-6b9bee475309
- f7a21456-7891-4abc-def0-123456789abc
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_auto_map_assignment_clear'
- description: Result returned after clearing auto map assignment candidates
examples:
- message: "Rejected map assignments for map_ids: ['d3c42998-9012-4859-9743-6b9bee475309', 'f7a21456-7891-4abc-def0-123456789abc']"
rejected_maps:
- d3c42998-9012-4859-9743-6b9bee475309
- f7a21456-7891-4abc-def0-123456789abc
contentMediaType: application/vnd.api+json
examples:
Example:
value:
message: "Rejected map assignments for map_ids: ['d3c42998-9012-4859-9743-6b9bee475309', 'f7a21456-7891-4abc-def0-123456789abc']"
rejected_maps:
- d3c42998-9012-4859-9743-6b9bee475309
- f7a21456-7891-4abc-def0-123456789abc
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/assetfilters:
get:
tags:
- Sites Asset Filters
summary: listSiteAssetFilters
description: Get List of Site Asset Filters
operationId: listSiteAssetFilters
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/asset_filter'
description: List of BLE asset filters
contentMediaType: application/json
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/asset_filter'
description: List of BLE asset filters
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Sites Asset Filters
summary: createSiteAssetFilter
description: Create Site Asset Filter
operationId: createSiteAssetFilter
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/asset_filter'
- description: Request Body
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/asset_filter'
- description: BLE asset filter definition; all specified criteria must match
examples:
- created_time: 0
disabled: true
eddystone_uid_namespace: string
eddystone_url: string
for_site: true
ibeacon_major: 1
ibeacon_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mfg_company_id: 0
modified_time: 0
mqtt_topic: xxxxx
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
disabled: true
eddystone_uid_namespace: string
eddystone_url: string
for_site: true
ibeacon_major: 1
ibeacon_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mfg_company_id: 0
modified_time: 0
mqtt_topic: xxxxx
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/asset_filter'
- description: BLE asset filter definition; all specified criteria must match
examples:
- created_time: 0
disabled: true
eddystone_uid_namespace: string
eddystone_url: string
for_site: true
ibeacon_major: 1
ibeacon_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mfg_company_id: 0
modified_time: 0
mqtt_topic: xxxxx
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
disabled: true
eddystone_uid_namespace: string
eddystone_url: string
for_site: true
ibeacon_major: 1
ibeacon_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mfg_company_id: 0
modified_time: 0
mqtt_topic: xxxxx
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/assetfilters/{assetfilter_id}:
delete:
tags:
- Sites Asset Filters
summary: deleteSiteAssetFilter
description: Deletes an existing BLE asset filter for the given site.
operationId: deleteSiteAssetFilter
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: assetfilter_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Sites Asset Filters
summary: getSiteAssetFilter
description: Get Site Asset Filter Details
operationId: getSiteAssetFilter
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: assetfilter_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/asset_filter'
- description: BLE asset filter definition; all specified criteria must match
examples:
- created_time: 0
disabled: true
eddystone_uid_namespace: string
eddystone_url: string
for_site: true
ibeacon_major: 1
ibeacon_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mfg_company_id: 0
modified_time: 0
mqtt_topic: xxxxx
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
disabled: true
eddystone_uid_namespace: string
eddystone_url: string
for_site: true
ibeacon_major: 1
ibeacon_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mfg_company_id: 0
modified_time: 0
mqtt_topic: xxxxx
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/asset_filter'
- description: BLE asset filter definition; all specified criteria must match
examples:
- created_time: 0
disabled: true
eddystone_uid_namespace: string
eddystone_url: string
for_site: true
ibeacon_major: 1
ibeacon_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mfg_company_id: 0
modified_time: 0
mqtt_topic: xxxxx
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
disabled: true
eddystone_uid_namespace: string
eddystone_url: string
for_site: true
ibeacon_major: 1
ibeacon_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mfg_company_id: 0
modified_time: 0
mqtt_topic: xxxxx
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Sites Asset Filters
summary: updateSiteAssetFilter
description: Updates an existing BLE asset filter for the given site.
operationId: updateSiteAssetFilter
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: assetfilter_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/asset_filter'
- description: Request Body
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/asset_filter'
- description: BLE asset filter definition; all specified criteria must match
examples:
- created_time: 0
disabled: true
eddystone_uid_namespace: string
eddystone_url: string
for_site: true
ibeacon_major: 1
ibeacon_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mfg_company_id: 0
modified_time: 0
mqtt_topic: xxxxx
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
disabled: true
eddystone_uid_namespace: string
eddystone_url: string
for_site: true
ibeacon_major: 1
ibeacon_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mfg_company_id: 0
modified_time: 0
mqtt_topic: xxxxx
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/asset_filter'
- description: BLE asset filter definition; all specified criteria must match
examples:
- created_time: 0
disabled: true
eddystone_uid_namespace: string
eddystone_url: string
for_site: true
ibeacon_major: 1
ibeacon_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mfg_company_id: 0
modified_time: 0
mqtt_topic: xxxxx
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
disabled: true
eddystone_uid_namespace: string
eddystone_url: string
for_site: true
ibeacon_major: 1
ibeacon_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mfg_company_id: 0
modified_time: 0
mqtt_topic: xxxxx
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/assets:
get:
tags:
- Sites Assets
summary: listSiteAssets
description: List assets for a site. Use [List Org Assets]($e/Orgs%20Assets/listOrgAssets) to retrieve assets across the organization.
operationId: listSiteAssets
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/asset'
description: List of named BLE asset records
contentMediaType: application/json
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/asset'
description: List of named BLE asset records
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Sites Assets
summary: createSiteAsset
description: Create Site Asset
operationId: createSiteAsset
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/asset'
- description: Request Body
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/asset'
- description: Named Bluetooth Low Energy asset record
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
tag_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
tag_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/asset'
- description: Named Bluetooth Low Energy asset record
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
tag_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
tag_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/assets/import:
post:
tags:
- Sites Assets
summary: importSiteAssets
description: "Import Site Assets. \n\nIt can be done via a CSV file or a JSON payload.\n\n## CSV File Format\n```csv\nname,mac\n\"asset_name\",5c5b53010101\n```"
operationId: importSiteAssets
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: upsert
in: query
description: 'Whether to replace existing assets with the same MAC address during import. enum: `False`, `True`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/import_site_assets_upsert'
- description: 'Whether to replace existing assets with the same MAC address during import. enum: `False`, `True`'
requestBody:
content:
multipart/form-data:
encoding: {}
schema:
type: object
properties:
file:
type: string
description: CSV file containing asset records to import
contentEncoding: base64
contentMediaType: multipart/form-data
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/assets/{asset_id}:
delete:
tags:
- Sites Assets
summary: deleteSiteAsset
description: Delete Site Asset
operationId: deleteSiteAsset
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: asset_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'201':
description: Created
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Sites Assets
summary: getSiteAsset
description: Get Site Asset Details
operationId: getSiteAsset
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: asset_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/asset'
- description: Named Bluetooth Low Energy asset record
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
tag_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
tag_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/asset'
- description: Named Bluetooth Low Energy asset record
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
tag_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
tag_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Sites Assets
summary: updateSiteAsset
description: Update Site Asset
operationId: updateSiteAsset
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: asset_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/asset'
- description: Request Body
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/asset'
- description: Named Bluetooth Low Energy asset record
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
tag_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
tag_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/asset'
- description: Named Bluetooth Low Energy asset record
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
tag_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
tag_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/assets/{asset_id}/image:
delete:
tags:
- Sites Assets
summary: deleteSiteAssetImage
description: Delete Site Asset Image
operationId: deleteSiteAssetImage
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: asset_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Sites Assets
summary: attachSiteAssetImage
description: Attach Image to Site Asset
operationId: attachSiteAssetImage
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: asset_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
content:
multipart/form-data:
encoding: {}
schema:
required:
- file
type: object
properties:
file:
type: string
description: Image file content uploaded as multipart form data
contentEncoding: base64
json:
type: string
description: Optional JSON metadata submitted with the image upload
contentMediaType: multipart/form-data
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/beacons:
get:
tags:
- Sites Beacons
summary: listSiteBeacons
description: Get List of Site Beacons
operationId: listSiteBeacons
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/beacon'
description: List of beacon configuration records
examples:
- - created_time: 0
eddystone_instance: string
eddystone_namespace: string
eddystone_url: string
ibeacon_major: 1
ibeacon_minor: 1
ibeacon_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
power: 0
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
type: eddystone-uid
x: 0
y: 0
contentMediaType: application/json
examples:
Example:
value:
- created_time: 0
eddystone_instance: string
eddystone_namespace: string
eddystone_url: string
ibeacon_major: 1
ibeacon_minor: 1
ibeacon_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
power: 0
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
type: eddystone-uid
x: 0
y: 0
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/beacon'
description: List of beacon configuration records
examples:
- - created_time: 0
eddystone_instance: string
eddystone_namespace: string
eddystone_url: string
ibeacon_major: 1
ibeacon_minor: 1
ibeacon_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
power: 0
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
type: eddystone-uid
x: 0
y: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- created_time: 0
eddystone_instance: string
eddystone_namespace: string
eddystone_url: string
ibeacon_major: 1
ibeacon_minor: 1
ibeacon_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
power: 0
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
type: eddystone-uid
x: 0
y: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Sites Beacons
summary: createSiteBeacon
description: Create Site Beacon
operationId: createSiteBeacon
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/beacon'
- description: Request Body
examples:
- eddystone_instance: string
eddystone_namespace: string
eddystone_url: string
ibeacon_major: 1
ibeacon_minor: 1
ibeacon_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
name: string
power: 0
type: eddystone-uid
x: 0
y: 0
contentMediaType: application/json
examples:
Example:
value:
eddystone_instance: string
eddystone_namespace: string
eddystone_url: string
ibeacon_major: 1
ibeacon_minor: 1
ibeacon_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
name: string
power: 0
type: eddystone-uid
x: 0
y: 0
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/beacon'
- description: Beacon configuration and placement data
examples:
- created_time: 0
eddystone_instance: string
eddystone_namespace: string
eddystone_url: string
ibeacon_major: 1
ibeacon_minor: 1
ibeacon_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
power: 0
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
type: eddystone-uid
x: 0
y: 0
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
eddystone_instance: string
eddystone_namespace: string
eddystone_url: string
ibeacon_major: 1
ibeacon_minor: 1
ibeacon_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
power: 0
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
type: eddystone-uid
x: 0
y: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/beacon'
- description: Beacon configuration and placement data
examples:
- created_time: 0
eddystone_instance: string
eddystone_namespace: string
eddystone_url: string
ibeacon_major: 1
ibeacon_minor: 1
ibeacon_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
power: 0
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
type: eddystone-uid
x: 0
y: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
eddystone_instance: string
eddystone_namespace: string
eddystone_url: string
ibeacon_major: 1
ibeacon_minor: 1
ibeacon_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
power: 0
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
type: eddystone-uid
x: 0
y: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/beacons/{beacon_id}:
delete:
tags:
- Sites Beacons
summary: deleteSiteBeacon
description: Delete Site Beacon
operationId: deleteSiteBeacon
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: beacon_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Sites Beacons
summary: getSiteBeacon
description: Get Site Beacon Details
operationId: getSiteBeacon
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: beacon_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/beacon'
- description: Beacon configuration and placement data
examples:
- created_time: 0
eddystone_instance: string
eddystone_namespace: string
eddystone_url: string
ibeacon_major: 1
ibeacon_minor: 1
ibeacon_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
power: 0
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
type: eddystone-uid
x: 0
y: 0
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
eddystone_instance: string
eddystone_namespace: string
eddystone_url: string
ibeacon_major: 1
ibeacon_minor: 1
ibeacon_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
power: 0
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
type: eddystone-uid
x: 0
y: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/beacon'
- description: Beacon configuration and placement data
examples:
- created_time: 0
eddystone_instance: string
eddystone_namespace: string
eddystone_url: string
ibeacon_major: 1
ibeacon_minor: 1
ibeacon_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
power: 0
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
type: eddystone-uid
x: 0
y: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
eddystone_instance: string
eddystone_namespace: string
eddystone_url: string
ibeacon_major: 1
ibeacon_minor: 1
ibeacon_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
power: 0
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
type: eddystone-uid
x: 0
y: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Sites Beacons
summary: updateSiteBeacon
description: Update Site Beacon
operationId: updateSiteBeacon
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: beacon_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/beacon'
- description: Request Body
examples:
- eddystone_instance: string
eddystone_namespace: string
eddystone_url: string
ibeacon_major: 1
ibeacon_minor: 1
ibeacon_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
name: string
power: 0
type: eddystone-uid
x: 0
y: 0
contentMediaType: application/json
examples:
Example:
value:
eddystone_instance: string
eddystone_namespace: string
eddystone_url: string
ibeacon_major: 1
ibeacon_minor: 1
ibeacon_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
name: string
power: 0
type: eddystone-uid
x: 0
y: 0
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/beacon'
- description: Beacon configuration and placement data
examples:
- created_time: 0
eddystone_instance: string
eddystone_namespace: string
eddystone_url: string
ibeacon_major: 1
ibeacon_minor: 1
ibeacon_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
power: 0
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
type: eddystone-uid
x: 0
y: 0
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
eddystone_instance: string
eddystone_namespace: string
eddystone_url: string
ibeacon_major: 1
ibeacon_minor: 1
ibeacon_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
power: 0
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
type: eddystone-uid
x: 0
y: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/beacon'
- description: Beacon configuration and placement data
examples:
- created_time: 0
eddystone_instance: string
eddystone_namespace: string
eddystone_url: string
ibeacon_major: 1
ibeacon_minor: 1
ibeacon_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
power: 0
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
type: eddystone-uid
x: 0
y: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
eddystone_instance: string
eddystone_namespace: string
eddystone_url: string
ibeacon_major: 1
ibeacon_minor: 1
ibeacon_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
power: 0
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
type: eddystone-uid
x: 0
y: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/nac_clients/count:
get:
tags:
- Sites Clients - NAC
summary: countSiteNacClients
description: Count NAC clients for a site, optionally grouped by the `distinct` field and filtered by authentication, identity, endpoint, network, and time attributes. Use [Count Org NAC Clients]($e/Orgs%20Clients%20-%20NAC/countOrgNacClients) to count NAC clients across the organization.
operationId: countSiteNacClients
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field used to group this count response. enum: `ap`, `auth_type`, `device_mac`, `edr_managed`, `edr_provider`, `edr_status`, `family`, `hostname`, `idp_id`, `mfg`, `mdm_compliance`, `mdm_managed`, `mdm_provider`, `model`, `mxedge_id`, `nacrule_matched`, `nacrule_name`, `nacrule_id`, `nas_ip`, `nas_vendor`, `os`, `ssid`, `status`, `type`, `usermac_label`, `username`, `vlan`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/site_nac_clients_count_distinct'
- description: 'Field used to group this count response. enum: `ap`, `auth_type`, `device_mac`, `edr_managed`, `edr_provider`, `edr_status`, `family`, `hostname`, `idp_id`, `mfg`, `mdm_compliance`, `mdm_managed`, `mdm_provider`, `model`, `mxedge_id`, `nacrule_matched`, `nacrule_name`, `nacrule_id`, `nas_ip`, `nas_vendor`, `os`, `ssid`, `status`, `type`, `usermac_label`, `username`, `vlan`'
- name: last_nacrule_id
in: query
description: NAC Policy Rule ID, if matched
style: form
explode: true
schema:
type: string
- name: nacrule_matched
in: query
description: NAC Policy Rule Matched
style: form
explode: true
schema:
type: boolean
- name: auth_type
in: query
description: Authentication type, e.g. "eap-tls", "eap-peap", "eap-ttls", "eap-teap", "mab", "psk", "device-auth"
style: form
explode: true
schema:
type: string
- name: last_vlan_id
in: query
description: Filter results by last VLAN ID
style: form
explode: true
schema:
type: string
- name: last_nas_vendor
in: query
description: Vendor of NAS device
style: form
explode: true
schema:
type: string
- name: idp_id
in: query
description: SSO ID, if present and used
style: form
explode: true
schema:
type: string
- name: last_ssid
in: query
description: Filter results by last SSID
style: form
explode: true
schema:
type: string
- name: last_username
in: query
description: Username presented by the client
style: form
explode: true
schema:
type: string
- name: last_ap
in: query
description: AP MAC connected to by client
style: form
explode: true
schema:
type: string
- name: mac
in: query
description: Filter results by MAC address
style: form
explode: true
schema:
type: string
- name: last_status
in: query
description: Connection status of client i.e "permitted", "denied, "session_ended"
style: form
explode: true
schema:
type: string
- name: type
in: query
description: Client type i.e. "wireless", "wired" etc.
style: form
explode: true
schema:
type: string
- name: mdm_compliance_status
in: query
description: MDM compliance of client i.e "compliant", "not compliant"
style: form
explode: true
schema:
type: string
- name: mdm_provider
in: query
description: MDM provider of client’s organization eg "intune", "jamf"
style: form
explode: true
schema:
type: string
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/nac_clients/events/count:
get:
tags:
- Sites Clients - NAC
summary: countSiteNacClientEvents
description: Count NAC client events for a site, optionally grouped by the `distinct` field and filtered by event type and time range. Use [Count Org NAC Client Events]($e/Orgs%20Clients%20-%20NAC/countOrgNacClientEvents) to count NAC client events across the organization.
operationId: countSiteNacClientEvents
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field used to group this count response. enum: `ap`, `auth_type`, `dryrun_nacrule_id`, `mac`, `nacrule_id`, `nas_vendor`, `ssid`, `type`, `username`, `vlan`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/site_nac_client_events_count_distinct'
- description: 'Field used to group this count response. enum: `ap`, `auth_type`, `dryrun_nacrule_id`, `mac`, `nacrule_id`, `nas_vendor`, `ssid`, `type`, `username`, `vlan`'
- name: type
in: query
description: See [List Device Events Definitions]($e/Constants%20Events/listNacEventsDefinitions)
style: form
explode: true
schema:
type: string
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/nac_clients/events/search:
get:
tags:
- Sites Clients - NAC
summary: searchSiteNacClientEvents
description: Search NAC client events for a site with filters for authentication, NAC rule, identity provider, RADIUS, network, endpoint, and time attributes. Use [Search Org NAC Client Events]($e/Orgs%20Clients%20-%20NAC/searchOrgNacClientEvents) to search NAC client events across the organization.
operationId: searchSiteNacClientEvents
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: type
in: query
description: See [List Device Events Definitions]($e/Constants%20Events/listNacEventsDefinitions)
style: form
explode: true
schema:
type: string
- name: nacrule_id
in: query
description: NAC Policy Rule ID, if matched
style: form
explode: true
schema:
type: string
contentEncoding: uuid
- name: nacrule_matched
in: query
description: NAC Policy Rule Matched
style: form
explode: true
schema:
type: boolean
- name: dryrun_nacrule_id
in: query
description: NAC Policy Dry Run Rule ID, if present and matched
style: form
explode: true
schema:
type: string
- name: dryrun_nacrule_matched
in: query
description: True - if dryrun rule present and matched with priority, False - if not matched or not present
style: form
explode: true
schema:
type: boolean
- name: auth_type
in: query
description: Authentication type, e.g. "eap-tls", "eap-peap", "eap-ttls", "eap-teap", "mab", "psk", "device-auth"
style: form
explode: true
schema:
type: string
- name: vlan
in: query
description: Filter results by VLAN ID
style: form
explode: true
schema:
type: integer
contentEncoding: int32
- name: nas_vendor
in: query
description: Vendor of NAS device
style: form
explode: true
schema:
type: string
- name: bssid
in: query
description: Filter results by BSSID
style: form
explode: true
schema:
type: string
- name: idp_id
in: query
description: SSO ID, if present and used
style: form
explode: true
schema:
type: string
contentEncoding: uuid
- name: idp_role
in: query
description: IDP returned roles/groups for the user
style: form
explode: true
schema:
type: string
- name: idp_username
in: query
description: Username presented to the Identity Provider
style: form
explode: true
schema:
type: string
- name: resp_attrs
in: query
description: RADIUS attributes returned by NAC to NAS Devive
style: form
explode: true
schema:
uniqueItems: true
type: array
items:
type: string
examples:
- - Tunnel-Type=VLAN
- Tunnel-Medium-Type=IEEE-802
- Tunnel-Private-Group-Id=750
- User-Name=anonymous
- name: ssid
in: query
description: Filter results by SSID
style: form
explode: true
schema:
type: string
- name: username
in: query
description: Filter results by username
style: form
explode: true
schema:
type: string
- name: ap
in: query
description: Filter results by AP MAC address
style: form
explode: true
schema:
type: string
- name: random_mac
in: query
description: Filter results by whether the client is using a randomized MAC address
style: form
explode: true
schema:
type: boolean
- name: mac
in: query
description: Filter results by MAC address
style: form
explode: true
schema:
type: string
- name: usermac_label
in: query
description: Labels derived from usermac entry
style: form
explode: true
schema:
type: string
- name: text
in: query
description: Partial / full MAC address, username, device_mac or ap. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `aabbcc*` and `*bbcc*` match `aabbccddeeff`). Suffix-only wildcards (e.g. `*bccddeeff`) are not supported
style: form
explode: true
schema:
type: string
- name: nas_ip
in: query
description: IP address of NAS device
style: form
explode: true
schema:
type: string
- name: ingress_vlan
in: query
description: Vendor specific VLAN ID in RADIUS requests
style: form
explode: true
schema:
type: string
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order.
style: form
explode: true
schema:
type: string
default: wxid
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: NAC Client Events
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_events_nac_client_search'
- description: Paginated response for NAC client event search results
examples:
- end: 1513176951
limit: 10
results:
- ap: 5c5b35513227
auth_type: eap-ttls
bssid: 5c5b355fafcc
dryrun_nacrule_id: 32f27e7d-ff26-4a9b-b3d1-ff9bcb264012
dryrun_nacrule_matched: true
idp_id: 912ef72e-2239-4996-b81e-469e87a27cd6
idp_role:
- itsuperusers
- vip
mac: ac3eb179e535
nacrule_id: 32f27e7d-ff26-4a9b-b3d1-ff9bcb264c62
nacrule_matched: true
nas_vendor: juniper-mist
org_id: 27547ac2-d114-4e04-beb1-f3f1e6e81ec6
random_mac: 'false'
resp_attrs:
- Tunnel-Type=VLAN
- Tunnel-Medium-Type=IEEE-802
- Tunnel-Private-Group-Id=750
- User-Name=anonymous
site_id: 441a1214-6928-442a-8e92-e1d34b8ec6a6
ssid: mist_nac
timestamp: 1691512031.358188
type: NAC_CLIENT_PERMIT
username: user@deaflyz.net
vlan: '750'
start: 1512572151
total: 1
contentMediaType: application/json
examples:
NAC-client_events:
value:
end: 1513176951
limit: 10
results:
- ap: 5c5b35513227
auth_type: eap-ttls
bssid: 5c5b355fafcc
dryrun_nacrule_id: 32f27e7d-ff26-4a9b-b3d1-ff9bcb264012
dryrun_nacrule_matched: true
idp_id: 912ef72e-2239-4996-b81e-469e87a27cd6
idp_role:
- itsuperusers
- vip
mac: ac3eb179e535
nacrule_id: 32f27e7d-ff26-4a9b-b3d1-ff9bcb264c62
nacrule_matched: true
nas_vendor: juniper-mist
org_id: 27547ac2-d114-4e04-beb1-f3f1e6e81ec6
random_mac: 'false'
resp_attrs:
- Tunnel-Type=VLAN
- Tunnel-Medium-Type=IEEE-802
- Tunnel-Private-Group-Id=750
- User-Name=anonymous
site_id: 441a1214-6928-442a-8e92-e1d34b8ec6a6
ssid: mist_nac
timestamp: 1691512031.358188
type: NAC_CLIENT_PERMIT
username: user@deaflyz.net
vlan: '750'
start: 1512572151
total: 1
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_events_nac_client_search'
- description: Paginated response for NAC client event search results
examples:
- end: 1513176951
limit: 10
results:
- ap: 5c5b35513227
auth_type: eap-ttls
bssid: 5c5b355fafcc
dryrun_nacrule_id: 32f27e7d-ff26-4a9b-b3d1-ff9bcb264012
dryrun_nacrule_matched: true
idp_id: 912ef72e-2239-4996-b81e-469e87a27cd6
idp_role:
- itsuperusers
- vip
mac: ac3eb179e535
nacrule_id: 32f27e7d-ff26-4a9b-b3d1-ff9bcb264c62
nacrule_matched: true
nas_vendor: juniper-mist
org_id: 27547ac2-d114-4e04-beb1-f3f1e6e81ec6
random_mac: 'false'
resp_attrs:
- Tunnel-Type=VLAN
- Tunnel-Medium-Type=IEEE-802
- Tunnel-Private-Group-Id=750
- User-Name=anonymous
site_id: 441a1214-6928-442a-8e92-e1d34b8ec6a6
ssid: mist_nac
timestamp: 1691512031.358188
type: NAC_CLIENT_PERMIT
username: user@deaflyz.net
vlan: '750'
start: 1512572151
total: 1
contentMediaType: application/vnd.api+json
examples:
NAC-client_events:
value:
end: 1513176951
limit: 10
results:
- ap: 5c5b35513227
auth_type: eap-ttls
bssid: 5c5b355fafcc
dryrun_nacrule_id: 32f27e7d-ff26-4a9b-b3d1-ff9bcb264012
dryrun_nacrule_matched: true
idp_id: 912ef72e-2239-4996-b81e-469e87a27cd6
idp_role:
- itsuperusers
- vip
mac: ac3eb179e535
nacrule_id: 32f27e7d-ff26-4a9b-b3d1-ff9bcb264c62
nacrule_matched: true
nas_vendor: juniper-mist
org_id: 27547ac2-d114-4e04-beb1-f3f1e6e81ec6
random_mac: 'false'
resp_attrs:
- Tunnel-Type=VLAN
- Tunnel-Medium-Type=IEEE-802
- Tunnel-Private-Group-Id=750
- User-Name=anonymous
site_id: 441a1214-6928-442a-8e92-e1d34b8ec6a6
ssid: mist_nac
timestamp: 1691512031.358188
type: NAC_CLIENT_PERMIT
username: user@deaflyz.net
vlan: '750'
start: 1512572151
total: 1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/nac_clients/search:
get:
tags:
- Sites Clients - NAC
summary: searchSiteNacClients
description: Search NAC clients for a site with filters for authentication, endpoint posture, identity, network, NAC rule, and time attributes. Use [Search Org NAC Clients]($e/Orgs%20Clients%20-%20NAC/searchOrgNacClients) to search NAC clients across the organization.
operationId: searchSiteNacClients
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: ap
in: query
description: MAC address of the AP the client is/was connected to
style: form
explode: true
schema:
type: string
- name: auth_type
in: query
description: Authentication type, e.g. "eap-tls", "eap-peap", "eap-ttls", "eap-teap", "mab", "psk", "device-auth"
style: form
explode: true
schema:
type: string
- name: cert_expiry_duration
in: query
description: Filter by certificate expiry within a specific duration from now (e.g., "7d" for 7 days, "1m" for 1 month)
style: form
explode: true
schema:
type: string
examples:
- 7d
- 1m
examples:
Untitled Example1:
value: 7d
Untitled Example2:
value: 1m
- name: edr_managed
in: query
description: Filters NAC clients that are integrated with EDR providers
style: form
explode: true
schema:
type: boolean
- name: edr_provider
in: query
description: 'EDR provider used to filter NAC clients. enum: `crowdstrike`, `sentinelone`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/edr_provider'
- description: 'EDR provider used to filter NAC clients. enum: `crowdstrike`, `sentinelone`'
- name: edr_status
in: query
description: 'EDR status used to filter NAC clients. enum: `sentinelone_healthy`, `sentinelone_infected`, `crowdstrike_low`, `crowdstrike_medium`, `crowdstrike_high`, `crowdstrike_critical`, `crowdstrike_informational`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/edr_status'
- description: 'EDR status used to filter NAC clients. enum: `sentinelone_healthy`, `sentinelone_infected`, `crowdstrike_low`, `crowdstrike_medium`, `crowdstrike_high`, `crowdstrike_critical`, `crowdstrike_informational`'
- name: family
in: query
description: Partial / full Client family (e.g. "Phone/Tablet/Wearable", "Access Point"). Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `Surveillance*` and `*urveillance*` match `Surveillance Camera`). Suffix-only wildcards (e.g. `*Camera`) are not supported
style: form
explode: true
schema:
type: string
examples:
- Surveillance Camera
- Surveillance*
- '*urveillance*'
examples:
Untitled Example1:
value: Surveillance Camera
Untitled Example2:
value: Surveillance*
Untitled Example3:
value: '*urveillance*'
- name: hostname
in: query
description: Partial / full Client hostname. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `everest*` and `*rest*` match `my-everest-client`). Suffix-only wildcards (e.g. `*everest`) are not supported
style: form
explode: true
schema:
type: string
examples:
- my-everest-client
- my-everest*
- '*everest*'
examples:
Untitled Example1:
value: my-everest-client
Untitled Example2:
value: my-everest*
Untitled Example3:
value: '*everest*'
- name: idp_id
in: query
description: SSO ID, if present and used
style: form
explode: true
schema:
type: string
- name: mac
in: query
description: Partial / full Client MAC address. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `aabbcc*` and `*bbcc*` match `aabbccddeeff`). Suffix-only wildcards (e.g. `*bccddeeff`) are not supported
style: form
explode: true
schema:
type: string
examples:
- aabbccddeeff
- aabbcc*
- '*bbcc*'
examples:
Untitled Example1:
value: aabbccddeeff
Untitled Example2:
value: aabbcc*
Untitled Example3:
value: '*bbcc*'
- name: mdm_compliance
in: query
description: MDM compliance of client i.e "compliant", "not compliant"
style: form
explode: true
schema:
type: string
- name: mdm_provider
in: query
description: MDM provider of client’s organization eg "intune", "jamf"
style: form
explode: true
schema:
type: string
- name: mdm_managed
in: query
description: Filters NAC clients that are managed by MDM providers
style: form
explode: true
schema:
type: boolean
- name: mfg
in: query
description: Partial / full Client manufacturer (e.g. "apple", "cisco", "juniper"). Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `Raspberry Pi*` and `*Pi*` match `Raspberry Pi Trading Ltd`). Suffix-only wildcards (e.g. `*Ltd`) are not supported
style: form
explode: true
schema:
type: string
examples:
- Raspberry Pi Trading Ltd
- Raspberry Pi*
- '*Pi*'
examples:
Untitled Example1:
value: Raspberry Pi Trading Ltd
Untitled Example2:
value: Raspberry Pi*
Untitled Example3:
value: '*Pi*'
- name: model
in: query
description: Client model, e.g. "iPhone 12", "MX100"
style: form
explode: true
schema:
type: string
- name: nacrule_name
in: query
description: NAC Policy Rule Name matched
style: form
explode: true
schema:
type: string
- name: nacrule_id
in: query
description: NAC Policy Rule ID, if matched
style: form
explode: true
schema:
type: string
- name: nacrule_matched
in: query
description: NAC Policy Rule Matched
style: form
explode: true
schema:
type: boolean
- name: nas_vendor
in: query
description: Vendor of NAS device
style: form
explode: true
schema:
type: string
- name: nas_ip
in: query
description: IP address of NAS device
style: form
explode: true
schema:
type: string
- name: ingress_vlan
in: query
description: Vendor specific VLAN ID in RADIUS requests
style: form
explode: true
schema:
type: string
- name: os
in: query
description: Client OS, e.g. "iOS 18.1", "Android", "Windows", "Linux"
style: form
explode: true
schema:
type: string
- name: ssid
in: query
description: Filter results by SSID
style: form
explode: true
schema:
type: string
- name: status
in: query
description: 'Client connection status used to filter results. enum: `permitted`, `session_started`, `session_stopped`, `denied`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/nac_client_last_status'
- description: 'Client connection status used to filter results. enum: `permitted`, `session_started`, `session_stopped`, `denied`'
examples:
- permitted
- name: text
in: query
description: partial / full MAC address, last_username, device_mac, nas_ip. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `aabbcc*` and `*bbcc*` match `aabbccddeeff`). Suffix-only wildcards (e.g. `*bccddeeff`) are not supported.
style: form
explode: true
schema:
type: string
- name: type
in: query
description: Client type i.e. "wireless", "wired" etc.
style: form
explode: true
schema:
type: string
- name: usermac_label
in: query
description: Labels derived from usermac entry
style: form
explode: true
schema:
uniqueItems: true
type: array
items:
type: string
- name: username
in: query
description: Filter results by username
style: form
explode: true
schema:
type: string
- name: vlan
in: query
description: Filter results by VLAN ID
style: form
explode: true
schema:
type: string
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order.
style: form
explode: true
schema:
type: string
default: wxid
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_client_nac_search'
- description: Paginated NAC client search response
examples:
- end: 1513362753
limit: 3
results:
- ap:
- 5c5b35bf16bb
- d4dc090041b4
auth_type: eap-tls
cert_cn:
- john@mycorp.net
cert_issuer:
- /C=US/ST=CA/CN=MyCorp
client_ip:
- 10.7.51.74
edr_managed: true
edr_providers:
- sentinelone
edr_status:
- sentinelone_healthy
idp_id: string
idp_role:
- string
last_ap: string
last_cert_cn: john@mycorp.net
last_cert_expiry: 1746711240
last_cert_issuer: /C=US/ST=CA/CN=MyCorp
last_cert_serial: 2c63510123456789
last_cert_subject: /C=US/O=MyCorp/CN=john@mycorp.net/emailAddress=john@mycorp.net
last_client_ip: 10.7.51.74
last_nacrule_id: 603b62db-d839-4152-9f7f-f2578443de8d
last_nacrule_name: Wireless Cert Auth
last_nas_vendor: juniper-mist
last_ssid: string
last_status: permitted
mac: string
nacrule_id:
- 603b62db-d839-4152-9f7f-f2578443de8d
nacrule_matched: true
nacrule_name:
- Wireless Cert Auth
nas_vendor:
- juniper-mist
org_id: 31f27122-68a9-47a4-b526-8fb8a62a8acb
random_mac: 'true'
site_id: 832b1d74-9531-409b-ae37-4d7f3edbde92
ssid:
- string
timestamp: 1694689718.612
type: wireless
usermac_label:
- non-compliant
- building26
- floor52
start: 1513276353
total: 2
contentMediaType: application/json
examples:
Example:
value:
end: 1513362753
limit: 3
results:
- ap:
- 5c5b35bf16bb
- d4dc090041b4
auth_type: eap-tls
cert_cn:
- john@mycorp.net
cert_issuer:
- /C=US/ST=CA/CN=MyCorp
client_ip:
- 10.7.51.74
edr_managed: true
edr_providers:
- sentinelone
edr_status:
- sentinelone_healthy
idp_id: string
idp_role:
- string
last_ap: string
last_cert_cn: john@mycorp.net
last_cert_expiry: 1746711240
last_cert_issuer: /C=US/ST=CA/CN=MyCorp
last_cert_serial: 2c63510123456789
last_cert_subject: /C=US/O=MyCorp/CN=john@mycorp.net/emailAddress=john@mycorp.net
last_client_ip: 10.7.51.74
last_nacrule_id: 603b62db-d839-4152-9f7f-f2578443de8d
last_nacrule_name: Wireless Cert Auth
last_nas_vendor: juniper-mist
last_ssid: string
last_status: permitted
mac: string
nacrule_id:
- 603b62db-d839-4152-9f7f-f2578443de8d
nacrule_matched: true
nacrule_name:
- Wireless Cert Auth
nas_vendor:
- juniper-mist
org_id: 31f27122-68a9-47a4-b526-8fb8a62a8acb
random_mac: 'true'
site_id: 832b1d74-9531-409b-ae37-4d7f3edbde92
ssid:
- string
timestamp: 1694689718.612
type: wireless
usermac_label:
- non-compliant
- building26
- floor52
start: 1513276353
total: 2
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_client_nac_search'
- description: Paginated NAC client search response
examples:
- end: 1513362753
limit: 3
results:
- ap:
- 5c5b35bf16bb
- d4dc090041b4
auth_type: eap-tls
cert_cn:
- john@mycorp.net
cert_issuer:
- /C=US/ST=CA/CN=MyCorp
client_ip:
- 10.7.51.74
edr_managed: true
edr_providers:
- sentinelone
edr_status:
- sentinelone_healthy
idp_id: string
idp_role:
- string
last_ap: string
last_cert_cn: john@mycorp.net
last_cert_expiry: 1746711240
last_cert_issuer: /C=US/ST=CA/CN=MyCorp
last_cert_serial: 2c63510123456789
last_cert_subject: /C=US/O=MyCorp/CN=john@mycorp.net/emailAddress=john@mycorp.net
last_client_ip: 10.7.51.74
last_nacrule_id: 603b62db-d839-4152-9f7f-f2578443de8d
last_nacrule_name: Wireless Cert Auth
last_nas_vendor: juniper-mist
last_ssid: string
last_status: permitted
mac: string
nacrule_id:
- 603b62db-d839-4152-9f7f-f2578443de8d
nacrule_matched: true
nacrule_name:
- Wireless Cert Auth
nas_vendor:
- juniper-mist
org_id: 31f27122-68a9-47a4-b526-8fb8a62a8acb
random_mac: 'true'
site_id: 832b1d74-9531-409b-ae37-4d7f3edbde92
ssid:
- string
timestamp: 1694689718.612
type: wireless
usermac_label:
- non-compliant
- building26
- floor52
start: 1513276353
total: 2
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 1513362753
limit: 3
results:
- ap:
- 5c5b35bf16bb
- d4dc090041b4
auth_type: eap-tls
cert_cn:
- john@mycorp.net
cert_issuer:
- /C=US/ST=CA/CN=MyCorp
client_ip:
- 10.7.51.74
edr_managed: true
edr_providers:
- sentinelone
edr_status:
- sentinelone_healthy
idp_id: string
idp_role:
- string
last_ap: string
last_cert_cn: john@mycorp.net
last_cert_expiry: 1746711240
last_cert_issuer: /C=US/ST=CA/CN=MyCorp
last_cert_serial: 2c63510123456789
last_cert_subject: /C=US/O=MyCorp/CN=john@mycorp.net/emailAddress=john@mycorp.net
last_client_ip: 10.7.51.74
last_nacrule_id: 603b62db-d839-4152-9f7f-f2578443de8d
last_nacrule_name: Wireless Cert Auth
last_nas_vendor: juniper-mist
last_ssid: string
last_status: permitted
mac: string
nacrule_id:
- 603b62db-d839-4152-9f7f-f2578443de8d
nacrule_matched: true
nacrule_name:
- Wireless Cert Auth
nas_vendor:
- juniper-mist
org_id: 31f27122-68a9-47a4-b526-8fb8a62a8acb
random_mac: 'true'
site_id: 832b1d74-9531-409b-ae37-4d7f3edbde92
ssid:
- string
timestamp: 1694689718.612
type: wireless
usermac_label:
- non-compliant
- building26
- floor52
start: 1513276353
total: 2
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/nac_clients/{client_mac}/coa:
post:
tags:
- Sites Clients - NAC
summary: sendSiteNacClientCoA
description: Sends CoA (Change of Authorization) command to a NAC client.
operationId: sendSiteNacClientCoA
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: client_mac
in: path
description: ''
required: true
schema:
pattern: ^[0-9a-fA-F]{12}$
type: string
examples:
- 0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/nac_client_coa'
- description: Request Body
contentMediaType: application/json
required: false
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/nac_client_coa_response'
- description: Response returned after sending a NAC client CoA command
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/nac_client_coa_response'
- description: Response returned after sending a NAC client CoA command
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/wan_client/events/count:
get:
tags:
- Sites Clients - Wan
summary: countSiteWanClientEvents
description: Count WAN client events for a site, optionally grouped by the `distinct` field and filtered by event type and time range. Use [Count Org WAN Client Events]($e/Orgs%20Clients%20-%20Wan/countOrgWanClientEvents) to count WAN client events across the organization.
operationId: countSiteWanClientEvents
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field used to group this count response. enum: `hostname`, `ip`, `mac`, `mfg`, `type`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/site_wan_client_events_distinct'
- description: 'Field used to group this count response. enum: `hostname`, `ip`, `mac`, `mfg`, `type`'
- name: type
in: query
description: See [List Device Events Definitions]($e/Constants%20Events/listDeviceEventsDefinitions)
style: form
explode: true
schema:
type: string
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/wan_clients/count:
get:
tags:
- Sites Clients - Wan
summary: countSiteWanClients
description: Count WAN clients for a site, optionally grouped by the `distinct` field and filtered by time range. Use [Count Org WAN Clients]($e/Orgs%20Clients%20-%20Wan/countOrgWanClients) to count WAN clients across the organization.
operationId: countSiteWanClients
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field used to group this count response. enum: `hostname`, `ip`, `mac`, `mfg`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/site_wan_clients_count_distinct'
- description: 'Field used to group this count response. enum: `hostname`, `ip`, `mac`, `mfg`'
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/wan_clients/events/search:
get:
tags:
- Sites Clients - Wan
summary: searchSiteWanClientEvents
description: Search WAN client events for a site with filters for client identity, manufacturer, NAC rule, event type, and time range. Use [Search Org WAN Client Events]($e/Orgs%20Clients%20-%20Wan/searchOrgWanClientEvents) to search WAN client events across the organization.
operationId: searchSiteWanClientEvents
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: type
in: query
description: See [List Device Events Definitions]($e/Constants%20Events/listDeviceEventsDefinitions)
style: form
explode: true
schema:
type: string
- name: mac
in: query
description: Partial / full Client MAC address. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `aabbcc*` and `*bbcc*` match `aabbccddeeff`). Suffix-only wildcards (e.g. `*bccddeeff`) are not supported
style: form
explode: true
schema:
type: string
examples:
- aabbccddeeff
- aabbcc*
- '*bbcc*'
examples:
Untitled Example1:
value: aabbccddeeff
Untitled Example2:
value: aabbcc*
Untitled Example3:
value: '*bbcc*'
- name: hostname
in: query
description: Partial / full Client hostname. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `everest*` and `*rest*` match `my-everest-client`). Suffix-only wildcards (e.g. `*everest`) are not supported
style: form
explode: true
schema:
type: string
examples:
- my-everest-client
- my-everest*
- '*everest*'
examples:
Untitled Example1:
value: my-everest-client
Untitled Example2:
value: my-everest*
Untitled Example3:
value: '*everest*'
- name: ip
in: query
description: Filter results by IP address
style: form
explode: true
schema:
type: string
examples:
- 10.4.2.4
- name: mfg
in: query
description: Filter results by manufacturer
style: form
explode: true
schema:
type: string
examples:
- Juniper
- name: nacrule_id
in: query
description: Filter results by NAC rule identifier
style: form
explode: true
schema:
type: string
examples:
- 00000000-0000-0000-0000-000000000000
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/search_events_wan_client'
- description: Paginated response for WAN client event searches
examples:
- end: 0
limit: 0
results:
- When: 2022-12-31 23:59:59.293000+00:00
ev_type: CLIENT_IP_ASSIGNED
metadata: {}
org_id: b0b9f142-aaba-11e6-aafc-0242ac110002
random_mac: true
site_id: fc656275-b157-43fd-b922-5f4f341c19bf
text: DHCP Ack IP 192.168.88.216
wcid: 62bbfb75-10d8-49d1-dec7-d2df91624287
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
end: 0
limit: 0
results:
- When: 2022-12-31 23:59:59.293000+00:00
ev_type: CLIENT_IP_ASSIGNED
metadata: {}
org_id: b0b9f142-aaba-11e6-aafc-0242ac110002
random_mac: true
site_id: fc656275-b157-43fd-b922-5f4f341c19bf
text: DHCP Ack IP 192.168.88.216
wcid: 62bbfb75-10d8-49d1-dec7-d2df91624287
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/search_events_wan_client'
- description: Paginated response for WAN client event searches
examples:
- end: 0
limit: 0
results:
- When: 2022-12-31 23:59:59.293000+00:00
ev_type: CLIENT_IP_ASSIGNED
metadata: {}
org_id: b0b9f142-aaba-11e6-aafc-0242ac110002
random_mac: true
site_id: fc656275-b157-43fd-b922-5f4f341c19bf
text: DHCP Ack IP 192.168.88.216
wcid: 62bbfb75-10d8-49d1-dec7-d2df91624287
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 0
limit: 0
results:
- When: 2022-12-31 23:59:59.293000+00:00
ev_type: CLIENT_IP_ASSIGNED
metadata: {}
org_id: b0b9f142-aaba-11e6-aafc-0242ac110002
random_mac: true
site_id: fc656275-b157-43fd-b922-5f4f341c19bf
text: DHCP Ack IP 192.168.88.216
wcid: 62bbfb75-10d8-49d1-dec7-d2df91624287
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/wan_clients/search:
get:
tags:
- Sites Clients - Wan
summary: searchSiteWanClients
description: Search WAN clients for a site with filters for hostname, IP address, source IP, MAC address, manufacturer, network, and time range. Use [Search Org WAN Clients]($e/Orgs%20Clients%20-%20Wan/searchOrgWanClients) to search WAN clients across the organization.
operationId: searchSiteWanClients
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: hostname
in: query
description: Partial / full Client hostname. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `everest*` and `*rest*` match `my-everest-client`). Suffix-only wildcards (e.g. `*everest`) are not supported
style: form
explode: true
schema:
type: string
examples:
- my-everest-client
- my-everest*
- '*everest*'
examples:
Untitled Example1:
value: my-everest-client
Untitled Example2:
value: my-everest*
Untitled Example3:
value: '*everest*'
- name: ip
in: query
description: Partial / full Client IP address. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `10.100.10.*` and `*100.10.*` match `10.100.10.54`). Suffix-only wildcards (e.g. `*.54`) are not supported
style: form
explode: true
schema:
type: string
examples:
- 10.100.10.54
- 10.100.10.*
- '*100.10.*'
examples:
Untitled Example1:
value: 10.100.10.54
Untitled Example2:
value: 10.100.10.*
Untitled Example3:
value: '*100.10.*'
- name: ip_src
in: query
description: Filter results by source IP address
style: form
explode: true
schema:
type: string
examples:
- dhcp
- name: mac
in: query
description: Filter results by MAC address
style: form
explode: true
schema:
type: string
examples:
- 5c5b53010101
- name: mfg
in: query
description: Filter results by manufacturer
style: form
explode: true
schema:
type: string
- name: network
in: query
description: Partial / full Name of the network the client is/was connected to. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `my-corp*` and `*corp*` match `my-corp-network`). Suffix-only wildcards (e.g. `*corp`) are not supported
style: form
explode: true
schema:
type: string
examples:
- my-corp-network
- my-corp*
- '*corp*'
examples:
Untitled Example1:
value: my-corp-network
Untitled Example2:
value: my-corp*
Untitled Example3:
value: '*corp*'
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/search_wan_client'
- description: Paginated response for WAN client searches
examples:
- end: 0
limit: 0
results:
- hostname:
- sonoszp
ip:
- 192.168.1.139
last_hostname: sonoszp
last_ip: 192.168.1.139
mfg: Sonos
org_id: b4e16c72-d50e-4c03-a952-a3217e231e2c
site_id: f688779c-e335-4f88-8d7c-9c5e9964528b
wcid: 8bbe7389-212b-c65d-2208-00fab2017936
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
end: 0
limit: 0
results:
- hostname:
- sonoszp
ip:
- 192.168.1.139
last_hostname: sonoszp
last_ip: 192.168.1.139
mfg: Sonos
org_id: b4e16c72-d50e-4c03-a952-a3217e231e2c
site_id: f688779c-e335-4f88-8d7c-9c5e9964528b
wcid: 8bbe7389-212b-c65d-2208-00fab2017936
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/search_wan_client'
- description: Paginated response for WAN client searches
examples:
- end: 0
limit: 0
results:
- hostname:
- sonoszp
ip:
- 192.168.1.139
last_hostname: sonoszp
last_ip: 192.168.1.139
mfg: Sonos
org_id: b4e16c72-d50e-4c03-a952-a3217e231e2c
site_id: f688779c-e335-4f88-8d7c-9c5e9964528b
wcid: 8bbe7389-212b-c65d-2208-00fab2017936
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 0
limit: 0
results:
- hostname:
- sonoszp
ip:
- 192.168.1.139
last_hostname: sonoszp
last_ip: 192.168.1.139
mfg: Sonos
org_id: b4e16c72-d50e-4c03-a952-a3217e231e2c
site_id: f688779c-e335-4f88-8d7c-9c5e9964528b
wcid: 8bbe7389-212b-c65d-2208-00fab2017936
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/wired_clients/count:
get:
tags:
- Sites Clients - Wired
summary: countSiteWiredClients
description: Count wired clients for a site, optionally grouped by the `distinct` field and filtered by MAC address, switch port, VLAN, and time range. Use [Count Org Wired Clients]($e/Orgs%20Clients%20-%20Wired/countOrgWiredClients) to count wired clients across the organization.
operationId: countSiteWiredClients
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field used to group this count response. enum: `mac`, `port_id`, `vlan`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/site_wired_clients_count_distinct'
- description: 'Field used to group this count response. enum: `mac`, `port_id`, `vlan`'
- name: mac
in: query
description: Filter results by MAC address
style: form
explode: true
schema:
type: string
examples:
- 0123456789ab
- name: device_mac
in: query
description: Filter results by device MAC address
style: form
explode: true
schema:
type: string
examples:
- 0123456789ab
- name: port_id
in: query
description: Filter results by port identifier
style: form
explode: true
schema:
type: string
examples:
- ge-1/1/1
- name: vlan
in: query
description: Filter results by VLAN ID
style: form
explode: true
schema:
type: string
examples:
- '10'
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/wired_clients/search:
get:
tags:
- Sites Clients - Wired
summary: searchSiteWiredClients
description: Search wired clients for a site with filters for device MAC address, client MAC address, IP address, switch port, VLAN, manufacturer, DHCP attributes, NAC rule, and time range. Use [Search Org Wired Clients]($e/Orgs%20Clients%20-%20Wired/searchOrgWiredClients) to search wired clients across the organization.
operationId: searchSiteWiredClients
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_mac
in: query
description: Filter results by device MAC address
style: form
explode: true
schema:
type: string
examples:
- 0123456789ab
- name: mac
in: query
description: Filter results by MAC address
style: form
explode: true
schema:
type: string
examples:
- 0123456789ab
- name: ip
in: query
description: Filter results by IP address
style: form
explode: true
schema:
type: string
examples:
- 10.3.5.12
- name: port_id
in: query
description: Filter results by port identifier
style: form
explode: true
schema:
type: string
examples:
- ge-1/1/1
- name: source
in: query
description: 'Filter results by client learning source. enum: `lldp`, `mac`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/client_info_source'
- description: 'Filter results by client learning source. enum: `lldp`, `mac`'
- name: vlan
in: query
description: Filter results by VLAN ID
style: form
explode: true
schema:
type: string
examples:
- '10'
- name: manufacture
in: query
description: Filter results by manufacturer
style: form
explode: true
schema:
type: string
examples:
- Juniper-Mist
- name: text
in: query
description: Single entry of hostname/mac
style: form
explode: true
schema:
type: string
examples:
- client-hostname
- name: nacrule_id
in: query
description: Filter results by NAC rule identifier
style: form
explode: true
schema:
type: string
examples:
- 8bfc2490-d726-3587-038d-cb2e71bd2330
- name: dhcp_hostname
in: query
description: Filter results by DHCP hostname
style: form
explode: true
schema:
type: string
examples:
- client-hostname
- name: dhcp_fqdn
in: query
description: Filter results by DHCP FQDN
style: form
explode: true
schema:
type: string
examples:
- client.example.com
- name: dhcp_client_identifier
in: query
description: Filter results by DHCP client identifier
style: form
explode: true
schema:
type: string
examples:
- 01:23:45:67:89:ab
- name: dhcp_vendor_class_identifier
in: query
description: DHCP Vendor Class Identifier
style: form
explode: true
schema:
type: string
examples:
- Juniper-Mist-AP,Juniper-Mist-Client
- name: dhcp_request_params
in: query
description: Filter results by DHCP request parameters
style: form
explode: true
schema:
type: string
examples:
- hostname,domain-name,domain-name-servers
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/search_wired_client'
- description: Paginated response for wired client searches
examples:
- end: 1648529800.8221116
limit: 1000
results:
- auth_method: mac_auth
auth_state: authenticated
device_mac:
- '001122334455'
dhcp_client_identifier: MAC address 00155df6d500
dhcp_client_options:
- code: DHO_DHCP_MESSAGE_TYPE(53)
data: DHCPREQUEST
- code: DHO_DHCP_CLIENT_IDENTIFIER(61)
data: MAC address 00155df6d500
- code: DHO_DHCP_REQUESTED_ADDRESS(50)
data: 172.17.10.255
- code: DHO_DHCP_SERVER_IDENTIFIER(54)
data: 172.17.8.1
- code: DHO_DHCP_MAX_MESSAGE_SIZE(57)
data: '1280'
- code: DHO_DHCP_PARAMETER_REQUEST_LIST(55)
data: ' 1 3 6 12 15 28 43 180'
- code: DHO_VENDOR_CLASS_IDENTIFIER(60)
data: MSFT 5.0
- code: DHO_HOST_NAME(12)
data: ITS-VMMT0-D1N02
dhcp_fqdn: ITS-VMMT0-D1N02.mgthub.local
dhcp_hostname: ITS-VMMT0-D1N02
dhcp_request_params: 1 3 6 15 31 33 43 44 46 47 119 121 249 252
dhcp_vendor_class_identifier: MSFT 5.0
mac: '112233445566'
org_id: c168ddee-c14c-11e5-8e81-1258369c38a9
port_id:
- et-0/0/1
site_id: c168ddee-c14c-11e5-8e81-1258369c38a9
timestamp: 1571174567.807
vlan:
- 0
- 1001
start: 1648443400.8221116
total: 1
contentMediaType: application/json
examples:
Example:
value:
end: 1648529800.8221116
limit: 1000
results:
- auth_method: mac_auth
auth_state: authenticated
device_mac:
- '001122334455'
dhcp_client_identifier: MAC address 00155df6d500
dhcp_client_options:
- code: DHO_DHCP_MESSAGE_TYPE(53)
data: DHCPREQUEST
- code: DHO_DHCP_CLIENT_IDENTIFIER(61)
data: MAC address 00155df6d500
- code: DHO_DHCP_REQUESTED_ADDRESS(50)
data: 172.17.10.255
- code: DHO_DHCP_SERVER_IDENTIFIER(54)
data: 172.17.8.1
- code: DHO_DHCP_MAX_MESSAGE_SIZE(57)
data: '1280'
- code: DHO_DHCP_PARAMETER_REQUEST_LIST(55)
data: ' 1 3 6 12 15 28 43 180'
- code: DHO_VENDOR_CLASS_IDENTIFIER(60)
data: MSFT 5.0
- code: DHO_HOST_NAME(12)
data: ITS-VMMT0-D1N02
dhcp_fqdn: ITS-VMMT0-D1N02.mgthub.local
dhcp_hostname: ITS-VMMT0-D1N02
dhcp_request_params: 1 3 6 15 31 33 43 44 46 47 119 121 249 252
dhcp_vendor_class_identifier: MSFT 5.0
mac: '112233445566'
org_id: c168ddee-c14c-11e5-8e81-1258369c38a9
port_id:
- et-0/0/1
site_id: c168ddee-c14c-11e5-8e81-1258369c38a9
timestamp: 1571174567.807
vlan:
- 0
- 1001
start: 1648443400.8221116
total: 1
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/search_wired_client'
- description: Paginated response for wired client searches
examples:
- end: 1648529800.8221116
limit: 1000
results:
- auth_method: mac_auth
auth_state: authenticated
device_mac:
- '001122334455'
dhcp_client_identifier: MAC address 00155df6d500
dhcp_client_options:
- code: DHO_DHCP_MESSAGE_TYPE(53)
data: DHCPREQUEST
- code: DHO_DHCP_CLIENT_IDENTIFIER(61)
data: MAC address 00155df6d500
- code: DHO_DHCP_REQUESTED_ADDRESS(50)
data: 172.17.10.255
- code: DHO_DHCP_SERVER_IDENTIFIER(54)
data: 172.17.8.1
- code: DHO_DHCP_MAX_MESSAGE_SIZE(57)
data: '1280'
- code: DHO_DHCP_PARAMETER_REQUEST_LIST(55)
data: ' 1 3 6 12 15 28 43 180'
- code: DHO_VENDOR_CLASS_IDENTIFIER(60)
data: MSFT 5.0
- code: DHO_HOST_NAME(12)
data: ITS-VMMT0-D1N02
dhcp_fqdn: ITS-VMMT0-D1N02.mgthub.local
dhcp_hostname: ITS-VMMT0-D1N02
dhcp_request_params: 1 3 6 15 31 33 43 44 46 47 119 121 249 252
dhcp_vendor_class_identifier: MSFT 5.0
mac: '112233445566'
org_id: c168ddee-c14c-11e5-8e81-1258369c38a9
port_id:
- et-0/0/1
site_id: c168ddee-c14c-11e5-8e81-1258369c38a9
timestamp: 1571174567.807
vlan:
- 0
- 1001
start: 1648443400.8221116
total: 1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 1648529800.8221116
limit: 1000
results:
- auth_method: mac_auth
auth_state: authenticated
device_mac:
- '001122334455'
dhcp_client_identifier: MAC address 00155df6d500
dhcp_client_options:
- code: DHO_DHCP_MESSAGE_TYPE(53)
data: DHCPREQUEST
- code: DHO_DHCP_CLIENT_IDENTIFIER(61)
data: MAC address 00155df6d500
- code: DHO_DHCP_REQUESTED_ADDRESS(50)
data: 172.17.10.255
- code: DHO_DHCP_SERVER_IDENTIFIER(54)
data: 172.17.8.1
- code: DHO_DHCP_MAX_MESSAGE_SIZE(57)
data: '1280'
- code: DHO_DHCP_PARAMETER_REQUEST_LIST(55)
data: ' 1 3 6 12 15 28 43 180'
- code: DHO_VENDOR_CLASS_IDENTIFIER(60)
data: MSFT 5.0
- code: DHO_HOST_NAME(12)
data: ITS-VMMT0-D1N02
dhcp_fqdn: ITS-VMMT0-D1N02.mgthub.local
dhcp_hostname: ITS-VMMT0-D1N02
dhcp_request_params: 1 3 6 15 31 33 43 44 46 47 119 121 249 252
dhcp_vendor_class_identifier: MSFT 5.0
mac: '112233445566'
org_id: c168ddee-c14c-11e5-8e81-1258369c38a9
port_id:
- et-0/0/1
site_id: c168ddee-c14c-11e5-8e81-1258369c38a9
timestamp: 1571174567.807
vlan:
- 0
- 1001
start: 1648443400.8221116
total: 1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/clients/count:
get:
tags:
- Sites Clients - Wireless
summary: countSiteWirelessClients
description: Count wireless clients for a site, optionally grouped by the `distinct` field and filtered by client attributes and time range. Use [Count Org Wireless Clients]($e/Orgs%20Clients%20-%20Wireless/countOrgWirelessClients) to count wireless clients across the organization.
operationId: countSiteWirelessClients
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field used to group this count response. enum: `ap`, `device`, `hostname`, `ip`, `model`, `os`, `ssid`, `vlan`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/site_clients_count_distinct'
- description: 'Field used to group this count response. enum: `ap`, `device`, `hostname`, `ip`, `model`, `os`, `ssid`, `vlan`'
examples:
- hostname
- name: ssid
in: query
description: Filter results by SSID
style: form
explode: true
schema:
type: string
- name: ap
in: query
description: Filter results by AP MAC address
style: form
explode: true
schema:
type: string
- name: ip
in: query
description: Filter results by IPv4 address
style: form
explode: true
schema:
type: string
contentEncoding: ipv4
examples:
- 192.168.1.1
- name: vlan
in: query
description: Filter client results by VLAN ID
style: form
explode: true
schema:
type: string
- name: hostname
in: query
description: Filter results by hostname
style: form
explode: true
schema:
type: string
- name: os
in: query
description: Filter client results by operating system
style: form
explode: true
schema:
type: string
- name: model
in: query
description: Filter results by device model
style: form
explode: true
schema:
type: string
- name: device
in: query
description: Filter client results by device type
style: form
explode: true
schema:
type: string
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/clients/events/count:
get:
tags:
- Sites Clients - Wireless
summary: countSiteWirelessClientEvents
description: Count wireless client events for a site, optionally grouped by the `distinct` field and filtered by event attributes and time range. Use [Count Org Wireless Client Events]($e/Orgs%20Clients%20-%20Wireless/countOrgWirelessClientEvents) to count wireless client events across the organization.
operationId: countSiteWirelessClientEvents
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field used to group this count response. enum: `band`, `channel`, `proto`, `ssid`, `type`, `wlan_id`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/site_client_events_count_distinct'
- description: 'Field used to group this count response. enum: `band`, `channel`, `proto`, `ssid`, `type`, `wlan_id`'
examples:
- type
- name: type
in: query
description: See [List Device Events Definitions]($e/Constants%20Events/listDeviceEventsDefinitions)
style: form
explode: true
schema:
type: string
- name: reason_code
in: query
description: Reason code filter for association and disassociation events
style: form
explode: true
schema:
type: integer
contentEncoding: int32
- name: ssid
in: query
description: Filter results by SSID
style: form
explode: true
schema:
type: string
- name: ap
in: query
description: Filter results by AP MAC address
style: form
explode: true
schema:
type: string
- name: proto
in: query
description: '802.11 protocol used to filter results. enum: `a`, `ac`, `ax`, `b`, `be`, `g`, `n`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/dot11_proto'
- description: '802.11 protocol used to filter results. enum: `a`, `ac`, `ax`, `b`, `be`, `g`, `n`'
- name: band
in: query
description: '802.11 band used to filter radio results. enum: `24`, `5`, `5-dedicated`, `5-selectable`, `6`, `6-dedicated`, `6-selectable`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/dot11_band'
- description: '802.11 band used to filter radio results. enum: `24`, `5`, `5-dedicated`, `5-selectable`, `6`, `6-dedicated`, `6-selectable`'
- name: wlan_id
in: query
description: Filter results by WLAN identifier
style: form
explode: true
schema:
type: string
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/clients/events/search:
get:
tags:
- Sites Clients - Wireless
summary: searchSiteWirelessClientEvents
description: Search wireless client events for a site with filters for event type, AP, SSID, WLAN, radio band, and time range. Use [Search Org Wireless Client Events]($e/Orgs%20Clients%20-%20Wireless/searchOrgWirelessClientEvents) to search wireless client events across the organization.
operationId: searchSiteWirelessClientEvents
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: type
in: query
description: See [List Device Events Definitions]($e/Constants%20Events/listDeviceEventsDefinitions)
style: form
explode: true
schema:
type: string
- name: reason_code
in: query
description: Reason code filter for association and disassociation events
style: form
explode: true
schema:
type: integer
contentEncoding: int32
- name: ssid
in: query
description: Filter results by SSID
style: form
explode: true
schema:
type: string
- name: ap
in: query
description: Filter results by AP MAC address
style: form
explode: true
schema:
type: string
- name: proto
in: query
description: '802.11 protocol used to filter results. enum: `a`, `ac`, `ax`, `b`, `be`, `g`, `n`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/dot11_proto'
- description: '802.11 protocol used to filter results. enum: `a`, `ac`, `ax`, `b`, `be`, `g`, `n`'
- name: band
in: query
description: '802.11 band used to filter radio results. enum: `24`, `5`, `5-dedicated`, `5-selectable`, `6`, `6-dedicated`, `6-selectable`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/dot11_band'
- description: '802.11 band used to filter radio results. enum: `24`, `5`, `5-dedicated`, `5-selectable`, `6`, `6-dedicated`, `6-selectable`'
- name: wlan_id
in: query
description: Filter results by WLAN identifier
style: form
explode: true
schema:
type: string
- name: nacrule_id
in: query
description: Filter results by NAC rule identifier
style: form
explode: true
schema:
type: string
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_events_search'
- description: Paginated response for wireless client event search results
examples:
- end: 0
limit: 0
results:
- ap: string
band: '24'
bssid: string
channel: 0
proto: a
ssid: string
text: string
timestamp: 0
type: string
type_code: 0
wlan_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
end: 0
limit: 0
results:
- ap: string
band: '24'
bssid: string
channel: 0
proto: a
ssid: string
text: string
timestamp: 0
type: string
type_code: 0
wlan_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_events_search'
- description: Paginated response for wireless client event search results
examples:
- end: 0
limit: 0
results:
- ap: string
band: '24'
bssid: string
channel: 0
proto: a
ssid: string
text: string
timestamp: 0
type: string
type_code: 0
wlan_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 0
limit: 0
results:
- ap: string
band: '24'
bssid: string
channel: 0
proto: a
ssid: string
text: string
timestamp: 0
type: string
type_code: 0
wlan_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/clients/search:
get:
tags:
- Sites Clients - Wireless
summary: searchSiteWirelessClients
description: Search wireless clients connected to a site with filters for client identity, AP, SSID, VLAN, radio band, and time range. Fuzzy matching with `*` is supported on `mac`, `hostname`, `device`, `os`, and `model`, for example `/clients/search?device=Mac*&hostname=jerry`. Use [Search Org Wireless Clients]($e/Orgs%20Clients%20-%20Wireless/searchOrgWirelessClients) to search wireless clients across the organization.
operationId: searchSiteWirelessClients
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: ap
in: query
description: Filter results by AP MAC address
style: form
explode: true
schema:
type: string
examples:
- 5c5b53010101
- name: band
in: query
description: 'Comma separated list of Radio band (e.g. `24,5`). enum: `24`, `5`, `6`'
style: form
explode: true
schema:
type: string
examples:
- '5'
- name: device
in: query
description: Comma separated list of Device type (e.g. `Mac,iPhone`). Case sensitive
style: form
explode: true
schema:
type: string
examples:
- iPhone
- name: hostname
in: query
description: Partial / full Client hostname. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `everest*` and `*rest*` match `my-everest-client`). Suffix-only wildcards (e.g. `*everest`) are not supported
style: form
explode: true
schema:
type: string
examples:
- my-everest-client
- my-everest*
- '*everest*'
examples:
Untitled Example1:
value: my-everest-client
Untitled Example2:
value: my-everest*
Untitled Example3:
value: '*everest*'
- name: ip
in: query
description: Partial / full Client IP address. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `10.100.10.*` and `*100.10.*` match `10.100.10.54`). Suffix-only wildcards (e.g. `*.54`) are not supported
style: form
explode: true
schema:
type: string
examples:
- 10.100.10.54
- 10.100.10.*
- '*100.10.*'
examples:
Untitled Example1:
value: 10.100.10.54
Untitled Example2:
value: 10.100.10.*
Untitled Example3:
value: '*100.10.*'
- name: mac
in: query
description: Partial / full Client MAC address. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `aabbcc*` and `*bbcc*` match `aabbccddeeff`). Suffix-only wildcards (e.g. `*bccddeeff`) are not supported
style: form
explode: true
schema:
type: string
examples:
- aabbccddeeff
- aabbcc*
- '*bbcc*'
examples:
Untitled Example1:
value: aabbccddeeff
Untitled Example2:
value: aabbcc*
Untitled Example3:
value: '*bbcc*'
- name: model
in: query
description: Only available for clients running the Marvis Client app, model, e.g. "MBP 15 late 2013", 6, 6s, "8+ GSM"
style: form
explode: true
schema:
type: string
examples:
- iPhone 8
- name: os
in: query
description: Only available for clients running the Marvis Client app, os, e.g. Sierra, Yosemite, Windows 10
style: form
explode: true
schema:
type: string
examples:
- Windows 10
- name: psk_id
in: query
description: PSK identifier used to filter the results
style: form
explode: true
schema:
type: string
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: psk_name
in: query
description: Only available for clients using PPSK authentication, the Name of the PSK
style: form
explode: true
schema:
type: string
examples:
- MyPPSK
- name: ssid
in: query
description: Filter results by SSID
style: form
explode: true
schema:
type: string
examples:
- MySSID
- name: text
in: query
description: Partial / full MAC address, hostname, username, psk_name or ip. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `everest*` and `*rest*` match `my-everest-client`). Suffix-only wildcards (e.g. `*client`) are not supported
style: form
explode: true
schema:
type: string
examples:
- 5c5b530
- name: username
in: query
description: Partial / full username. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `johndoe*` and `*mycorp*` match `johndoe@mycorp.com`). Suffix-only wildcards (e.g. `*mycorp.com`) are not supported
style: form
explode: true
schema:
type: string
examples:
- johndoe
- johnd*
- '*ohnd*'
examples:
Untitled Example1:
value: johndoe
Untitled Example2:
value: johnd*
Untitled Example3:
value: '*ohnd*'
- name: vlan
in: query
description: Filter results by VLAN ID
style: form
explode: true
schema:
type: string
examples:
- '10'
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_client_search'
- description: Paginated wireless client search response
examples:
- end: 17141231418.812
limit: 118
next: next8
results:
- ap:
- a83a79a947ee
- 003e73170b4c
app_version:
- 0.100.3
band: '5'
device:
- Mac
ftc: false
hardware: Apple Wi-Fi adapter
hostname:
- hostname-a
- hostname-b
ip:
- 10.5.23.43
- 192.168.0.2
last_ap: a83a79a947ee
last_device: Mac
last_firmware: 'wl0: Jan 20 2024 04:08:41 version 20.103.12.0.8.7.171 FWID 01-e09d2675'
last_hostname: hostname-a
last_ip: 10.5.23.43
last_model: MBP 16\" M1 2021
last_os: Sonoma
last_os_version: 14.4.1 (Build 23E224)
last_psk_id: abf7dc5c-bb51-4bb7-93b6-5547400ffe11
last_psk_name: iot
last_ssid: IoT SSID
last_username: user@corp.com
last_vlan: 10
last_wlan_id: e5d67b07-aae8-494b-8584-cbc20c8110aa
mac: bcd074000000
mfg: Apple
model: MBP 16\" M1 2021
org_id: 1abff1aa-4571-4c1f-a409-153a1e7a7a24
os:
- Sonoma
os_version:
- 14.4.1 (Build 23E224)
protocol: ax
psk_id:
- abf7dc5c-bb51-4bb7-93b6-5547400ffe11
psk_name:
- iot
sdk_version:
- 0.100.3
site_id: 25ff5219-9be7-4db9-907d-0c9b60445147
site_ids:
- 25ff5219-9be7-4db9-907d-0c9b60445147
ssid:
- IoT SSID
timestamp: 1714124722.113
username:
- user@corp.com
vlan:
- 10
start: 10
total: 44
contentMediaType: application/json
examples:
Example:
value:
end: 17141231418.812
limit: 118
next: next8
results:
- ap:
- a83a79a947ee
- 003e73170b4c
app_version:
- 0.100.3
band: '5'
device:
- Mac
ftc: false
hardware: Apple Wi-Fi adapter
hostname:
- hostname-a
- hostname-b
ip:
- 10.5.23.43
- 192.168.0.2
last_ap: a83a79a947ee
last_device: Mac
last_firmware: 'wl0: Jan 20 2024 04:08:41 version 20.103.12.0.8.7.171 FWID 01-e09d2675'
last_hostname: hostname-a
last_ip: 10.5.23.43
last_model: MBP 16\" M1 2021
last_os: Sonoma
last_os_version: 14.4.1 (Build 23E224)
last_psk_id: abf7dc5c-bb51-4bb7-93b6-5547400ffe11
last_psk_name: iot
last_ssid: IoT SSID
last_username: user@corp.com
last_vlan: 10
last_wlan_id: e5d67b07-aae8-494b-8584-cbc20c8110aa
mac: bcd074000000
mfg: Apple
model: MBP 16\" M1 2021
org_id: 1abff1aa-4571-4c1f-a409-153a1e7a7a24
os:
- Sonoma
os_version:
- 14.4.1 (Build 23E224)
protocol: ax
psk_id:
- abf7dc5c-bb51-4bb7-93b6-5547400ffe11
psk_name:
- iot
sdk_version:
- 0.100.3
site_id: 25ff5219-9be7-4db9-907d-0c9b60445147
site_ids:
- 25ff5219-9be7-4db9-907d-0c9b60445147
ssid:
- IoT SSID
timestamp: 1714124722.113
username:
- user@corp.com
vlan:
- 10
start: 10
total: 44
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_client_search'
- description: Paginated wireless client search response
examples:
- end: 17141231418.812
limit: 118
next: next8
results:
- ap:
- a83a79a947ee
- 003e73170b4c
app_version:
- 0.100.3
band: '5'
device:
- Mac
ftc: false
hardware: Apple Wi-Fi adapter
hostname:
- hostname-a
- hostname-b
ip:
- 10.5.23.43
- 192.168.0.2
last_ap: a83a79a947ee
last_device: Mac
last_firmware: 'wl0: Jan 20 2024 04:08:41 version 20.103.12.0.8.7.171 FWID 01-e09d2675'
last_hostname: hostname-a
last_ip: 10.5.23.43
last_model: MBP 16\" M1 2021
last_os: Sonoma
last_os_version: 14.4.1 (Build 23E224)
last_psk_id: abf7dc5c-bb51-4bb7-93b6-5547400ffe11
last_psk_name: iot
last_ssid: IoT SSID
last_username: user@corp.com
last_vlan: 10
last_wlan_id: e5d67b07-aae8-494b-8584-cbc20c8110aa
mac: bcd074000000
mfg: Apple
model: MBP 16\" M1 2021
org_id: 1abff1aa-4571-4c1f-a409-153a1e7a7a24
os:
- Sonoma
os_version:
- 14.4.1 (Build 23E224)
protocol: ax
psk_id:
- abf7dc5c-bb51-4bb7-93b6-5547400ffe11
psk_name:
- iot
sdk_version:
- 0.100.3
site_id: 25ff5219-9be7-4db9-907d-0c9b60445147
site_ids:
- 25ff5219-9be7-4db9-907d-0c9b60445147
ssid:
- IoT SSID
timestamp: 1714124722.113
username:
- user@corp.com
vlan:
- 10
start: 10
total: 44
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 17141231418.812
limit: 118
next: next8
results:
- ap:
- a83a79a947ee
- 003e73170b4c
app_version:
- 0.100.3
band: '5'
device:
- Mac
ftc: false
hardware: Apple Wi-Fi adapter
hostname:
- hostname-a
- hostname-b
ip:
- 10.5.23.43
- 192.168.0.2
last_ap: a83a79a947ee
last_device: Mac
last_firmware: 'wl0: Jan 20 2024 04:08:41 version 20.103.12.0.8.7.171 FWID 01-e09d2675'
last_hostname: hostname-a
last_ip: 10.5.23.43
last_model: MBP 16\" M1 2021
last_os: Sonoma
last_os_version: 14.4.1 (Build 23E224)
last_psk_id: abf7dc5c-bb51-4bb7-93b6-5547400ffe11
last_psk_name: iot
last_ssid: IoT SSID
last_username: user@corp.com
last_vlan: 10
last_wlan_id: e5d67b07-aae8-494b-8584-cbc20c8110aa
mac: bcd074000000
mfg: Apple
model: MBP 16\" M1 2021
org_id: 1abff1aa-4571-4c1f-a409-153a1e7a7a24
os:
- Sonoma
os_version:
- 14.4.1 (Build 23E224)
protocol: ax
psk_id:
- abf7dc5c-bb51-4bb7-93b6-5547400ffe11
psk_name:
- iot
sdk_version:
- 0.100.3
site_id: 25ff5219-9be7-4db9-907d-0c9b60445147
site_ids:
- 25ff5219-9be7-4db9-907d-0c9b60445147
ssid:
- IoT SSID
timestamp: 1714124722.113
username:
- user@corp.com
vlan:
- 10
start: 10
total: 44
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/clients/sessions/count:
get:
tags:
- Sites Clients - Wireless
summary: countSiteWirelessClientSessions
description: Count wireless client sessions for a site, optionally grouped by the `distinct` field and filtered by AP, SSID, WLAN, client attributes, and time range. Use [Count Org Wireless Client Sessions]($e/Orgs%20Clients%20-%20Wireless/countOrgWirelessClientsSessions) to count wireless client sessions across the organization.
operationId: countSiteWirelessClientSessions
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field used to group this count response. enum: `ap`, `client_family`, `client_manufacture`, `client_model`, `client_os`, `mac`, `ssid`, `wlan_id`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/site_client_sessions_count_distinct'
- description: 'Field used to group this count response. enum: `ap`, `client_family`, `client_manufacture`, `client_model`, `client_os`, `mac`, `ssid`, `wlan_id`'
- name: ap
in: query
description: Filter results by AP MAC address
style: form
explode: true
schema:
type: string
- name: band
in: query
description: '802.11 band used to filter radio results. enum: `24`, `5`, `5-dedicated`, `5-selectable`, `6`, `6-dedicated`, `6-selectable`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/dot11_band'
- description: '802.11 band used to filter radio results. enum: `24`, `5`, `5-dedicated`, `5-selectable`, `6`, `6-dedicated`, `6-selectable`'
- name: client_family
in: query
description: E.g. "Mac", "iPhone", "Apple watch"
style: form
explode: true
schema:
type: string
- name: client_manufacture
in: query
description: Filter results by client manufacturer, e.g. "Apple"
style: form
explode: true
schema:
type: string
- name: client_model
in: query
description: Filter results by client model, e.g. "8+", "XS"
style: form
explode: true
schema:
type: string
- name: client_os
in: query
description: E.g. "Mojave", "Windows 10", "Linux"
style: form
explode: true
schema:
type: string
- name: ssid
in: query
description: Filter results by SSID
style: form
explode: true
schema:
type: string
- name: wlan_id
in: query
description: Filter results by WLAN identifier
style: form
explode: true
schema:
type: string
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/clients/sessions/search:
get:
tags:
- Sites Clients - Wireless
summary: searchSiteWirelessClientSessions
description: Search wireless client sessions for a site with filters for AP, SSID, WLAN, client attributes, PSK, and time range. Use [Search Org Wireless Client Sessions]($e/Orgs%20Clients%20-%20Wireless/searchOrgWirelessClientSessions) to search wireless client sessions across the organization.
operationId: searchSiteWirelessClientSessions
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: ap
in: query
description: Filter results by AP MAC address
style: form
explode: true
schema:
type: string
- name: band
in: query
description: '802.11 band used to filter radio results. enum: `24`, `5`, `5-dedicated`, `5-selectable`, `6`, `6-dedicated`, `6-selectable`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/dot11_band'
- description: '802.11 band used to filter radio results. enum: `24`, `5`, `5-dedicated`, `5-selectable`, `6`, `6-dedicated`, `6-selectable`'
- name: client_family
in: query
description: E.g. "Mac", "iPhone", "Apple watch"
style: form
explode: true
schema:
type: string
- name: client_manufacture
in: query
description: Filter results by client manufacturer, e.g. "Apple"
style: form
explode: true
schema:
type: string
- name: client_model
in: query
description: Filter results by client model, e.g. "8+", "XS"
style: form
explode: true
schema:
type: string
- name: client_username
in: query
description: Filter results by client username
style: form
explode: true
schema:
type: string
- name: client_os
in: query
description: E.g. "Mojave", "Windows 10", "Linux"
style: form
explode: true
schema:
type: string
- name: ssid
in: query
description: Filter results by SSID
style: form
explode: true
schema:
type: string
- name: wlan_id
in: query
description: Filter results by WLAN identifier
style: form
explode: true
schema:
type: string
- name: psk_id
in: query
description: PSK identifier used to filter the results
style: form
explode: true
schema:
type: string
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: psk_name
in: query
description: Filter results by PSK name
style: form
explode: true
schema:
type: string
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_client_sessions_search'
- description: Paginated wireless client session search response
examples:
- end: 1513177200
limit: 10
results:
- ap: 5c5b350e0262
band: '5'
client_manufacture: Apple
connect: 1565208388
disconnect: 1565208448
duration: 60.09423865
mac: b019c66c8348
org_id: 3139f2c2-fac6-11e5-8156-0242ac110006
site_id: 70e0f468-fc13-11e5-85ad-0242ac110008
ssid: Dummy WLAN 2
tags:
- disassociate
timestamp: 1565208448.662
wlan_id: 99bb4c74-f954-4f36-b844-6b030faffabc
start: 1511967600
total: 100
contentMediaType: application/json
examples:
Example:
value:
end: 1513177200
limit: 10
results:
- ap: 5c5b350e0262
band: '5'
client_manufacture: Apple
connect: 1565208388
disconnect: 1565208448
duration: 60.09423865
mac: b019c66c8348
org_id: 3139f2c2-fac6-11e5-8156-0242ac110006
site_id: 70e0f468-fc13-11e5-85ad-0242ac110008
ssid: Dummy WLAN 2
tags:
- disassociate
timestamp: 1565208448.662
wlan_id: 99bb4c74-f954-4f36-b844-6b030faffabc
start: 1511967600
total: 100
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_client_sessions_search'
- description: Paginated wireless client session search response
examples:
- end: 1513177200
limit: 10
results:
- ap: 5c5b350e0262
band: '5'
client_manufacture: Apple
connect: 1565208388
disconnect: 1565208448
duration: 60.09423865
mac: b019c66c8348
org_id: 3139f2c2-fac6-11e5-8156-0242ac110006
site_id: 70e0f468-fc13-11e5-85ad-0242ac110008
ssid: Dummy WLAN 2
tags:
- disassociate
timestamp: 1565208448.662
wlan_id: 99bb4c74-f954-4f36-b844-6b030faffabc
start: 1511967600
total: 100
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 1513177200
limit: 10
results:
- ap: 5c5b350e0262
band: '5'
client_manufacture: Apple
connect: 1565208388
disconnect: 1565208448
duration: 60.09423865
mac: b019c66c8348
org_id: 3139f2c2-fac6-11e5-8156-0242ac110006
site_id: 70e0f468-fc13-11e5-85ad-0242ac110008
ssid: Dummy WLAN 2
tags:
- disassociate
timestamp: 1565208448.662
wlan_id: 99bb4c74-f954-4f36-b844-6b030faffabc
start: 1511967600
total: 100
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/clients/{client_mac}/events:
get:
tags:
- Sites Clients - Wireless
summary: getSiteEventsForClient
description: Get the list of events for a specific client
operationId: getSiteEventsForClient
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: client_mac
in: path
description: ''
required: true
schema:
pattern: ^[0-9a-fA-F]{12}$
type: string
examples:
- 0000000000ab
- name: type
in: query
description: Filter results by type, e.g. MARVIS_EVENT_CLIENT_DHCP_STUCK
style: form
explode: true
schema:
type: string
- name: proto
in: query
description: '802.11 protocol used to filter results. enum: `a`, `ac`, `ax`, `b`, `be`, `g`, `n`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/dot11_proto'
- description: '802.11 protocol used to filter results. enum: `a`, `ac`, `ax`, `b`, `be`, `g`, `n`'
- name: band
in: query
description: '802.11 band used to filter radio results. enum: `24`, `5`, `5-dedicated`, `5-selectable`, `6`, `6-dedicated`, `6-selectable`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/dot11_band'
- description: '802.11 band used to filter radio results. enum: `24`, `5`, `5-dedicated`, `5-selectable`, `6`, `6-dedicated`, `6-selectable`'
- name: channel
in: query
description: Filter available versions by release channel
style: form
explode: true
schema:
type: string
- name: wlan_id
in: query
description: Filter results by WLAN identifier
style: form
explode: true
schema:
type: string
- name: ssid
in: query
description: Filter results by SSID
style: form
explode: true
schema:
type: string
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_client_events_search'
- description: Paginated client event search response
examples:
- end: 1513176951
limit: 10
results:
- ap: 5c5b350eb31b
band: '5'
bssid: 5c5b350918f1
channel: 149
proto: ac
ssid: Guest
text: Status code 0 "Successful"
timestamp: 1513358874.667
type: CLIENT_DNS_OK
type_code: 15
wlan_id: be22bba7-8e22-e1cf-5185-b880816fe2cf
start: 1512572151
total: 1
contentMediaType: application/json
examples:
Example:
value:
end: 1513176951
limit: 10
results:
- ap: 5c5b350eb31b
band: '5'
bssid: 5c5b350918f1
channel: 149
proto: ac
ssid: Guest
text: Status code 0 "Successful"
timestamp: 1513358874.667
type: CLIENT_DNS_OK
type_code: 15
wlan_id: be22bba7-8e22-e1cf-5185-b880816fe2cf
start: 1512572151
total: 1
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_client_events_search'
- description: Paginated client event search response
examples:
- end: 1513176951
limit: 10
results:
- ap: 5c5b350eb31b
band: '5'
bssid: 5c5b350918f1
channel: 149
proto: ac
ssid: Guest
text: Status code 0 "Successful"
timestamp: 1513358874.667
type: CLIENT_DNS_OK
type_code: 15
wlan_id: be22bba7-8e22-e1cf-5185-b880816fe2cf
start: 1512572151
total: 1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 1513176951
limit: 10
results:
- ap: 5c5b350eb31b
band: '5'
bssid: 5c5b350918f1
channel: 149
proto: ac
ssid: Guest
text: Status code 0 "Successful"
timestamp: 1513358874.667
type: CLIENT_DNS_OK
type_code: 15
wlan_id: be22bba7-8e22-e1cf-5185-b880816fe2cf
start: 1512572151
total: 1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices:
get:
tags:
- Sites Devices
summary: listSiteDevices
description: List devices in a site. Use [List Org Devices]($e/Orgs%20Devices/listOrgDevices) to retrieve devices across the organization, or [Search Org Devices]($e/Orgs%20Devices/searchOrgDevices) when filters are needed.
operationId: listSiteDevices
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: type
in: query
description: Filter results by type
style: form
explode: true
schema:
type: string
default: ap
- name: name
in: query
description: Filter results by name
style: form
explode: true
schema:
type: string
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/config_device'
description: List of device configuration objects
contentMediaType: application/json
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/config_device'
description: List of device configuration objects
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/config_history/count:
get:
tags:
- Sites Devices
summary: countSiteDeviceConfigHistory
description: Counts the number of entries in device config history for distinct field with given filters
operationId: countSiteDeviceConfigHistory
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: Field used to group this count response
style: form
explode: true
schema:
type: string
- name: mac
in: query
description: Filter results by MAC address
style: form
explode: true
schema:
type: string
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/config_history/search:
get:
tags:
- Sites Devices
summary: searchSiteDeviceConfigHistory
description: Search for entries in device config history
operationId: searchSiteDeviceConfigHistory
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: type
in: query
description: 'Filter results by type. enum: `ap`, `gateway`, `switch`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/device_type_default_ap'
- description: 'Filter results by type. enum: `ap`, `gateway`, `switch`'
- name: mac
in: query
description: Filter results by MAC address
style: form
explode: true
schema:
type: string
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_config_history_search'
- description: Paginated device config history search response
examples:
- end: 1531862583
limit: 10
results:
- channel_24: 11
channel_5: 100
radio_macs:
- 5c5b352e000a
- 5c5b352e000b
- 5c5b352e000c
radios:
- band: '24'
channel: 11
- band: '5'
channel: 100
secpolicy_violated: false
ssids:
- test24
- test5
ssids_24:
- test24
ssids_5:
- test5
timestamp: 1531855856.643369
version: apfw-0.2.14754-cersei-75c8
wlans:
- auth: psk
bands:
- '24'
id: be22bba7-8e22-e1cf-5185-b880816fe2cf
ssid: test24
vlan_ids:
- '1'
- auth: psk
bands:
- '5'
id: f8c18724-4118-3487-811a-f98964988604
ssid: test5
vlan_ids:
- '1'
start: 1531776183
total: 1
contentMediaType: application/json
examples:
Example:
value:
end: 1531862583
limit: 10
results:
- channel_24: 11
channel_5: 100
radio_macs:
- 5c5b352e000a
- 5c5b352e000b
- 5c5b352e000c
radios:
- band: '24'
channel: 11
- band: '5'
channel: 100
secpolicy_violated: false
ssids:
- test24
- test5
ssids_24:
- test24
ssids_5:
- test5
timestamp: 1531855856.643369
version: apfw-0.2.14754-cersei-75c8
wlans:
- auth: psk
bands:
- '24'
id: be22bba7-8e22-e1cf-5185-b880816fe2cf
ssid: test24
vlan_ids:
- '1'
- auth: psk
bands:
- '5'
id: f8c18724-4118-3487-811a-f98964988604
ssid: test5
vlan_ids:
- '1'
start: 1531776183
total: 1
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_config_history_search'
- description: Paginated device config history search response
examples:
- end: 1531862583
limit: 10
results:
- channel_24: 11
channel_5: 100
radio_macs:
- 5c5b352e000a
- 5c5b352e000b
- 5c5b352e000c
radios:
- band: '24'
channel: 11
- band: '5'
channel: 100
secpolicy_violated: false
ssids:
- test24
- test5
ssids_24:
- test24
ssids_5:
- test5
timestamp: 1531855856.643369
version: apfw-0.2.14754-cersei-75c8
wlans:
- auth: psk
bands:
- '24'
id: be22bba7-8e22-e1cf-5185-b880816fe2cf
ssid: test24
vlan_ids:
- '1'
- auth: psk
bands:
- '5'
id: f8c18724-4118-3487-811a-f98964988604
ssid: test5
vlan_ids:
- '1'
start: 1531776183
total: 1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 1531862583
limit: 10
results:
- channel_24: 11
channel_5: 100
radio_macs:
- 5c5b352e000a
- 5c5b352e000b
- 5c5b352e000c
radios:
- band: '24'
channel: 11
- band: '5'
channel: 100
secpolicy_violated: false
ssids:
- test24
- test5
ssids_24:
- test24
ssids_5:
- test5
timestamp: 1531855856.643369
version: apfw-0.2.14754-cersei-75c8
wlans:
- auth: psk
bands:
- '24'
id: be22bba7-8e22-e1cf-5185-b880816fe2cf
ssid: test24
vlan_ids:
- '1'
- auth: psk
bands:
- '5'
id: f8c18724-4118-3487-811a-f98964988604
ssid: test5
vlan_ids:
- '1'
start: 1531776183
total: 1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/count:
get:
tags:
- Sites Devices
summary: countSiteDevices
description: Count devices for a site, optionally grouped by the `distinct` field and filtered by device inventory attributes and time range. Use [Count Org Devices]($e/Orgs%20Devices/countOrgDevices) to count devices across the organization.
operationId: countSiteDevices
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field used to group this count response. enum: `hostname`, `lldp_mgmt_addr`, `lldp_port_id`, `lldp_system_desc`, `lldp_system_name`, `map_id`, `model`, `mxedge_id`, `mxtunnel_status`, `version`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/site_devices_count_distinct'
- description: 'Field used to group this count response. enum: `hostname`, `lldp_mgmt_addr`, `lldp_port_id`, `lldp_system_desc`, `lldp_system_name`, `map_id`, `model`, `mxedge_id`, `mxtunnel_status`, `version`'
- name: hostname
in: query
description: Filter results by hostname
style: form
explode: true
schema:
type: string
- name: model
in: query
description: Filter results by device model
style: form
explode: true
schema:
type: string
- name: mac
in: query
description: Filter results by MAC address
style: form
explode: true
schema:
type: string
- name: version
in: query
description: Filter results by software version
style: form
explode: true
schema:
type: string
- name: mxtunnel_status
in: query
description: Filter AP results by Mist Tunnel status
style: form
explode: true
schema:
type: string
- name: mxedge_id
in: query
description: Filter results by Mist Edge identifier
style: form
explode: true
schema:
type: string
- name: lldp_system_name
in: query
description: Filter AP results by LLDP system name
style: form
explode: true
schema:
type: string
- name: lldp_system_desc
in: query
description: Filter AP results by LLDP system description
style: form
explode: true
schema:
type: string
- name: lldp_port_id
in: query
description: Filter AP results by LLDP port identifier
style: form
explode: true
schema:
type: string
- name: lldp_mgmt_addr
in: query
description: Filter AP results by LLDP management IP address
style: form
explode: true
schema:
type: string
- name: map_id
in: query
description: Filter results by map identifier
style: form
explode: true
schema:
type: string
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/events/count:
get:
tags:
- Sites Devices
summary: countSiteDeviceEvents
description: Count device events for a site, optionally grouped by the `distinct` field and filtered by event attributes and time range. Use [Count Org Device Events]($e/Orgs%20Devices/countOrgDeviceEvents) to count device events across the organization.
operationId: countSiteDeviceEvents
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field used to group this count response. enum: `mac`, `model`, `type`, `type_code`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/site_device_events_count_distinct'
- description: 'Field used to group this count response. enum: `mac`, `model`, `type`, `type_code`'
- name: model
in: query
description: Filter results by device model
style: form
explode: true
schema:
type: string
- name: type
in: query
description: See [List Device Events Definitions]($e/Constants%20Events/listDeviceEventsDefinitions)
style: form
explode: true
schema:
type: string
- name: type_code
in: query
description: Filter results by event type code
style: form
explode: true
schema:
type: string
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/events/search:
get:
tags:
- Sites Devices
summary: searchSiteDeviceEvents
description: Search device events for a site with filters for MAC address, model, event type, message text, and time range. Use [Search Org Device Events]($e/Orgs%20Devices/searchOrgDeviceEvents) to search device events across the organization.
operationId: searchSiteDeviceEvents
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: mac
in: query
description: Filter results by MAC address
style: form
explode: true
schema:
type: string
- name: model
in: query
description: Filter results by device model
style: form
explode: true
schema:
type: string
- name: text
in: query
description: Filter results by event message text
style: form
explode: true
schema:
type: string
examples:
- Device connected
- name: type
in: query
description: See [List Device Events Definitions]($e/Constants%20Events/listDeviceEventsDefinitions)
style: form
explode: true
schema:
type: string
- name: last_by
in: query
description: Return last/recent event for passed in field
style: form
explode: true
schema:
type: string
examples:
- port_id
- name: includes
in: query
description: Keyword to include events from additional indices (e.g. ext_tunnel for prisma events)
style: form
explode: true
schema:
type: string
examples:
- ext_tunnel
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_events_devices'
- description: Paginated response for site device event search results
examples:
- end: 1531862583
limit: 2
next: /api/v1/sites/8aaba0aa-09cc-44bd-9709-33b98040550c/devices/events/search?ap=5c5b350e0001&end=1531855849.000&limit=2&start=1531776183.0
results:
- chassis_mac: 60c78d939c0f
count: 1
device_type: switch
mac: 60c78d939c0f
model: EX4100-48MP
org_id: 9777c1a0-6ef6-11e6-8bbf-02e208b2d34f
port_id: ge-0/0/17
site_id: 978c48e6-6ef6-11e6-8bbf-02e208b2d34f
text: ifIndex 533, ifAdminStatus up(1), ifOperStatus down(2), ifName ge-0/0/17
timestamp: 1764236687.435
type: SW_PORT_DOWN
version: 23.4R2-S4.11
- ap: 5c5b35d0077b
device_type: ap
mac: 5c5b35d0077b
model: AP43
org_id: 9777c1a0-6ef6-11e6-8bbf-02e208b2d34f
site_id: 46fc665e-9706-4296-8fe2-78f42f2e67e4
timestamp: 1764235684.467825
type: AP_CONFIGURED
start: 1531776183
total: 14
contentMediaType: application/json
examples:
Example:
value:
end: 1531862583
limit: 2
next: /api/v1/sites/8aaba0aa-09cc-44bd-9709-33b98040550c/devices/events/search?ap=5c5b350e0001&end=1531855849.000&limit=2&start=1531776183.0
results:
- chassis_mac: 60c78d939c0f
count: 1
device_type: switch
mac: 60c78d939c0f
model: EX4100-48MP
org_id: 9777c1a0-6ef6-11e6-8bbf-02e208b2d34f
port_id: ge-0/0/17
site_id: 978c48e6-6ef6-11e6-8bbf-02e208b2d34f
text: ifIndex 533, ifAdminStatus up(1), ifOperStatus down(2), ifName ge-0/0/17
timestamp: 1764236687.435
type: SW_PORT_DOWN
version: 23.4R2-S4.11
- ap: 5c5b35d0077b
device_type: ap
mac: 5c5b35d0077b
model: AP43
org_id: 9777c1a0-6ef6-11e6-8bbf-02e208b2d34f
site_id: 46fc665e-9706-4296-8fe2-78f42f2e67e4
timestamp: 1764235684.467825
type: AP_CONFIGURED
start: 1531776183
total: 14
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_events_devices'
- description: Paginated response for site device event search results
examples:
- end: 1531862583
limit: 2
next: /api/v1/sites/8aaba0aa-09cc-44bd-9709-33b98040550c/devices/events/search?ap=5c5b350e0001&end=1531855849.000&limit=2&start=1531776183.0
results:
- chassis_mac: 60c78d939c0f
count: 1
device_type: switch
mac: 60c78d939c0f
model: EX4100-48MP
org_id: 9777c1a0-6ef6-11e6-8bbf-02e208b2d34f
port_id: ge-0/0/17
site_id: 978c48e6-6ef6-11e6-8bbf-02e208b2d34f
text: ifIndex 533, ifAdminStatus up(1), ifOperStatus down(2), ifName ge-0/0/17
timestamp: 1764236687.435
type: SW_PORT_DOWN
version: 23.4R2-S4.11
- ap: 5c5b35d0077b
device_type: ap
mac: 5c5b35d0077b
model: AP43
org_id: 9777c1a0-6ef6-11e6-8bbf-02e208b2d34f
site_id: 46fc665e-9706-4296-8fe2-78f42f2e67e4
timestamp: 1764235684.467825
type: AP_CONFIGURED
start: 1531776183
total: 14
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 1531862583
limit: 2
next: /api/v1/sites/8aaba0aa-09cc-44bd-9709-33b98040550c/devices/events/search?ap=5c5b350e0001&end=1531855849.000&limit=2&start=1531776183.0
results:
- chassis_mac: 60c78d939c0f
count: 1
device_type: switch
mac: 60c78d939c0f
model: EX4100-48MP
org_id: 9777c1a0-6ef6-11e6-8bbf-02e208b2d34f
port_id: ge-0/0/17
site_id: 978c48e6-6ef6-11e6-8bbf-02e208b2d34f
text: ifIndex 533, ifAdminStatus up(1), ifOperStatus down(2), ifName ge-0/0/17
timestamp: 1764236687.435
type: SW_PORT_DOWN
version: 23.4R2-S4.11
- ap: 5c5b35d0077b
device_type: ap
mac: 5c5b35d0077b
model: AP43
org_id: 9777c1a0-6ef6-11e6-8bbf-02e208b2d34f
site_id: 46fc665e-9706-4296-8fe2-78f42f2e67e4
timestamp: 1764235684.467825
type: AP_CONFIGURED
start: 1531776183
total: 14
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/export:
get:
tags:
- Sites Devices
summary: exportSiteDevices
description: To download the exported device information
operationId: exportSiteDevices
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: string
description: File
contentEncoding: base64
contentMediaType: application/json
application/vnd.api+json:
schema:
type: string
description: File
contentEncoding: base64
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/gbp_tag:
post:
tags:
- Sites Devices
summary: setSiteDevicesGbpTag
description: Set GBP Tag for multiple devices
operationId: setSiteDevicesGbpTag
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/devices_gbp_tag'
- description: Request Body
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/import:
post:
tags:
- Sites Devices
summary: importSiteDevices
description: >-
Import Information for Multiple Devices
CSV format:
```csv
mac,name,map_id,x,y,height,orientation,labels,band_24.power,band_24.bandwidth,band_24.channel,band_24.disabled,band_5.power,band_5.bandwidth,band_5.channel,band_5.disabled,band_6.power,band_6.bandwidth,band_6.channel,band_6.disabled
5c5b53010101,"AP 1",845a23bf-bed9-e43c-4c86-6fa474be7ae5,30,10,2.3,45,"guest, campus, vip",1,20,0,false,0,40,0,false,17,80,0,false
```
operationId: importSiteDevices
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
content:
multipart/form-data:
encoding: {}
schema:
required:
- file
type: object
properties:
file:
type: string
description: Binary file payload to upload with this request
contentEncoding: base64
contentMediaType: multipart/form-data
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/config_device'
description: List of device configuration objects
contentMediaType: application/json
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/config_device'
description: List of device configuration objects
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/last_config/count:
get:
tags:
- Sites Devices
summary: countSiteDeviceLastConfig
description: Counts the number of entries in device config history for distinct field with given filters
operationId: countSiteDeviceLastConfig
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field used to group this count response. enum: `mac`, `name`, `site_id`, `version`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/site_device_last_config_count_distinct'
- description: 'Field used to group this count response. enum: `mac`, `name`, `site_id`, `version`'
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/last_config/search:
get:
tags:
- Sites Devices
summary: searchSiteDeviceLastConfigs
description: Search last known device configuration records for a site with filters for device type, MAC address, name, software version, certificate expiry, and time range. Use [Search Org Device Last Configs]($e/Orgs%20Devices/searchOrgDeviceLastConfigs) to search last known device configuration records across the organization.
operationId: searchSiteDeviceLastConfigs
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: cert_expiry_duration
in: query
description: 'Duration for expiring cert queries (format: 2d/3h/172800 seconds)'
style: form
explode: true
schema:
type: string
examples:
- 2d
- name: device_type
in: query
description: 'Filter results by device type. enum: `ap`, `gateway`, `switch`, `mxedge`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/last_config_device_type'
- description: 'Filter results by device type. enum: `ap`, `gateway`, `switch`, `mxedge`'
- name: mac
in: query
description: Filter results by MAC address
style: form
explode: true
schema:
type: string
- name: version
in: query
description: Filter results by software version
style: form
explode: true
schema:
type: string
- name: name
in: query
description: Filter results by name
style: form
explode: true
schema:
type: string
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_config_history_search'
- description: Paginated device config history search response
examples:
- end: 1531862583
limit: 10
results:
- channel_24: 11
channel_5: 100
radio_macs:
- 5c5b352e000a
- 5c5b352e000b
- 5c5b352e000c
radios:
- band: '24'
channel: 11
- band: '5'
channel: 100
secpolicy_violated: false
ssids:
- test24
- test5
ssids_24:
- test24
ssids_5:
- test5
timestamp: 1531855856.643369
version: apfw-0.2.14754-cersei-75c8
wlans:
- auth: psk
bands:
- '24'
id: be22bba7-8e22-e1cf-5185-b880816fe2cf
ssid: test24
vlan_ids:
- '1'
- auth: psk
bands:
- '5'
id: f8c18724-4118-3487-811a-f98964988604
ssid: test5
vlan_ids:
- '1'
start: 1531776183
total: 1
contentMediaType: application/json
examples:
Example:
value:
end: 1531862583
limit: 10
results:
- channel_24: 11
channel_5: 100
radio_macs:
- 5c5b352e000a
- 5c5b352e000b
- 5c5b352e000c
radios:
- band: '24'
channel: 11
- band: '5'
channel: 100
secpolicy_violated: false
ssids:
- test24
- test5
ssids_24:
- test24
ssids_5:
- test5
timestamp: 1531855856.643369
version: apfw-0.2.14754-cersei-75c8
wlans:
- auth: psk
bands:
- '24'
id: be22bba7-8e22-e1cf-5185-b880816fe2cf
ssid: test24
vlan_ids:
- '1'
- auth: psk
bands:
- '5'
id: f8c18724-4118-3487-811a-f98964988604
ssid: test5
vlan_ids:
- '1'
start: 1531776183
total: 1
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_config_history_search'
- description: Paginated device config history search response
examples:
- end: 1531862583
limit: 10
results:
- channel_24: 11
channel_5: 100
radio_macs:
- 5c5b352e000a
- 5c5b352e000b
- 5c5b352e000c
radios:
- band: '24'
channel: 11
- band: '5'
channel: 100
secpolicy_violated: false
ssids:
- test24
- test5
ssids_24:
- test24
ssids_5:
- test5
timestamp: 1531855856.643369
version: apfw-0.2.14754-cersei-75c8
wlans:
- auth: psk
bands:
- '24'
id: be22bba7-8e22-e1cf-5185-b880816fe2cf
ssid: test24
vlan_ids:
- '1'
- auth: psk
bands:
- '5'
id: f8c18724-4118-3487-811a-f98964988604
ssid: test5
vlan_ids:
- '1'
start: 1531776183
total: 1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 1531862583
limit: 10
results:
- channel_24: 11
channel_5: 100
radio_macs:
- 5c5b352e000a
- 5c5b352e000b
- 5c5b352e000c
radios:
- band: '24'
channel: 11
- band: '5'
channel: 100
secpolicy_violated: false
ssids:
- test24
- test5
ssids_24:
- test24
ssids_5:
- test5
timestamp: 1531855856.643369
version: apfw-0.2.14754-cersei-75c8
wlans:
- auth: psk
bands:
- '24'
id: be22bba7-8e22-e1cf-5185-b880816fe2cf
ssid: test24
vlan_ids:
- '1'
- auth: psk
bands:
- '5'
id: f8c18724-4118-3487-811a-f98964988604
ssid: test5
vlan_ids:
- '1'
start: 1531776183
total: 1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/search:
get:
tags:
- Sites Devices
summary: searchSiteDevices
description: Search devices in a site with filters for device type, identifiers, model, software version, radio settings, LLDP details, and other inventory attributes. Use [Search Org Devices]($e/Orgs%20Devices/searchOrgDevices) to search devices across the organization.
operationId: searchSiteDevices
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: band_24_channel
in: query
description: When `type`==`ap`, Channel of band_24
style: form
explode: true
schema:
type: integer
contentEncoding: int32
- name: band_5_channel
in: query
description: When `type`==`ap`, Channel of band_5
style: form
explode: true
schema:
type: integer
contentEncoding: int32
- name: band_6_channel
in: query
description: When `type`==`ap`, Channel of band_6
style: form
explode: true
schema:
type: integer
contentEncoding: int32
- name: band_24_bandwidth
in: query
description: When `type`==`ap`, Bandwidth of band_24
style: form
explode: true
schema:
type: integer
contentEncoding: int32
- name: band_5_bandwidth
in: query
description: When `type`==`ap`, Bandwidth of band_5
style: form
explode: true
schema:
type: integer
contentEncoding: int32
- name: band_6_bandwidth
in: query
description: When `type`==`ap`, Bandwidth of band_6
style: form
explode: true
schema:
type: integer
contentEncoding: int32
- name: band_24_power
in: query
description: When `type`==`ap`, Power of band_24
style: form
explode: true
schema:
type: integer
contentEncoding: int32
- name: band_5_power
in: query
description: When `type`==`ap`, Power of band_5
style: form
explode: true
schema:
type: integer
contentEncoding: int32
- name: band_6_power
in: query
description: When `type`==`ap`, Power of band_6
style: form
explode: true
schema:
type: integer
contentEncoding: int32
- name: clustered
in: query
description: When `type`==`gateway`, true / false
style: form
explode: true
schema:
type: boolean
- name: eth0_port_speed
in: query
description: When `type`==`ap`, Port speed of eth0
style: form
explode: true
schema:
type: integer
contentEncoding: int32
examples:
- '100'
- '1000'
examples:
Untitled Example1:
value: 100
Untitled Example2:
value: 1000
- name: evpntopo_id
in: query
description: When `type`==`switch`, EVPN topology id
style: form
explode: true
schema:
type: string
contentEncoding: uuid
- name: ext_ip
in: query
description: Partial / full Device external ip. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `1.2.3.*` and `*.2.3.*` match `1.2.3.4`). Suffix-only wildcards (e.g. `*.2.3.4`) are not supported
style: form
explode: true
schema:
type: string
examples:
- 1.2.3.4
- 1.2.3.*
- '*2.3.*'
examples:
Untitled Example1:
value: 1.2.3.4
Untitled Example2:
value: 1.2.3.*
Untitled Example3:
value: '*2.3.*'
- name: hostname
in: query
description: Partial / full Device hostname. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `my-london*` and `*london*` match `my-london-1`). Suffix-only wildcards (e.g. `*london-1`) are not supported
style: form
explode: true
schema:
type: string
examples:
- my-london-1
- my-london*
- '*london*'
examples:
Untitled Example1:
value: my-london-1
Untitled Example2:
value: my-london*
Untitled Example3:
value: '*london*'
- name: ip
in: query
description: Partial / full Device IP address. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `10.100.10.*` and `*100.10.*` match `10.100.10.54`). Suffix-only wildcards (e.g. `*.54`) are not supported
style: form
explode: true
schema:
type: string
examples:
- 10.100.10.54
- 10.100.10.*
- '*100.10.*'
examples:
Untitled Example1:
value: 10.100.10.54
Untitled Example2:
value: 10.100.10.*
Untitled Example3:
value: '*100.10.*'
- name: last_config_status
in: query
description: When `type`==`switch` or `type`==`gateway`, last configuration status
style: form
explode: true
schema:
type: string
examples:
- success
- name: last_hostname
in: query
description: Last hostname of the device.
style: form
explode: true
schema:
type: string
- name: lldp_mgmt_addr
in: query
description: When `type`==`ap`, LLDP management IP address
style: form
explode: true
schema:
type: string
- name: lldp_port_id
in: query
description: When `type`==`ap`, LLDP port id. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `ge-0/0/*` and `*-0/0/*` match `ge-0/0/30`). Suffix-only wildcards (e.g. `*switch-01`) are not supported
style: form
explode: true
schema:
type: string
- name: lldp_system_desc
in: query
description: When `type`==`ap`, LLDP system description. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `Juniper Networks*` and `*Networks*` match `Juniper Networks, Inc.`). Suffix-only wildcards (e.g. `*switch-01`) are not supported
style: form
explode: true
schema:
type: string
- name: lldp_system_name
in: query
description: When `type`==`ap`, LLDP system name. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `my-switch*` and `*switch*` match `my-switch-01`). Suffix-only wildcards (e.g. `*switch-01`) are not supported
style: form
explode: true
schema:
type: string
- name: mac
in: query
description: Partial / full Device MAC address. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `001122*` and `*1122*` match `001122334455`). Suffix-only wildcards (e.g. `*4455`) are not supported
style: form
explode: true
schema:
type: string
examples:
- aabbccddeeff
- aabbcc*
- '*bbcc*'
examples:
Untitled Example1:
value: aabbccddeeff
Untitled Example2:
value: aabbcc*
Untitled Example3:
value: '*bbcc*'
- name: model
in: query
description: Partial / full Device model. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `AP4*` and `*P4*` match `AP43`). Suffix-only wildcards (e.g. `*43`) are not supported
style: form
explode: true
schema:
type: string
examples:
- AP43
- AP4*
- '*P4*'
examples:
Untitled Example1:
value: AP43
Untitled Example2:
value: AP4*
Untitled Example3:
value: '*P4*'
- name: mxedge_id
in: query
description: When `type`==`ap`, Mist Edge id, if AP is connecting to a Mist Edge
style: form
explode: true
schema:
type: string
contentEncoding: uuid
- name: mxedge_ids
in: query
description: When `type`==`ap`, Comma separated list of Mist Edge id, if AP is connecting to a Mist Edge
style: form
explode: true
schema:
type: string
- name: mxtunnel_status
in: query
description: 'When `type`==`ap`, Mist Tunnel status used to filter results. enum: `down`, `up`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/search_site_devices_mxtunnel_status'
- description: 'When `type`==`ap`, Mist Tunnel status used to filter results. enum: `down`, `up`'
- name: node
in: query
description: 'When `type`==`gateway`. enum: `node0`, `node1`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/ha_cluster_node_enum'
- description: 'When `type`==`gateway`. enum: `node0`, `node1`'
- name: node0_mac
in: query
description: When `type`==`gateway`, node0 MAC address
style: form
explode: true
schema:
type: string
- name: node1_mac
in: query
description: When `type`==`gateway`, node1 MAC address
style: form
explode: true
schema:
type: string
- name: power_constrained
in: query
description: When `type`==`ap`, whether the AP is power constrained
style: form
explode: true
schema:
type: boolean
- name: radius_stats
in: query
description: >-
When `type`==`switch` or `type`==`gateway`, Key-value pairs where the key
is the RADIUS server address and the value contains authentication statistics:
* (string): IP address of the RADIUS server as the key
* `auth_accepts` (long): Number of accepted authentication requests
* `auth_rejects` (long): Number of rejected authentication requests
* `auth_timeouts` (long): Number of authentication timeouts
* `auth_server_status` (string): Status of the server. Possible values: `up`, `down`, `unreachable`
style: form
explode: true
schema:
type: string
- name: stats
in: query
description: Whether to return device stats
style: form
explode: true
schema:
type: boolean
default: false
- name: t128agent_version
in: query
description: When `type`==`gateway` (SSR only), version of 128T agent
style: form
explode: true
schema:
type: string
- name: type
in: query
description: 'Device type used to filter results. enum: `ap`, `gateway`, `switch`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/device_type_default_ap'
- description: 'Device type used to filter results. enum: `ap`, `gateway`, `switch`'
- name: version
in: query
description: Filter results by software version
style: form
explode: true
schema:
type: string
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: sort
in: query
description: 'Field used to sort results; a leading `-` indicates descending order. enum: `mac`, `model`, `sku`, `timestamp`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/search_site_devices_sort'
- description: 'Field used to sort results; a leading `-` indicates descending order. enum: `mac`, `model`, `sku`, `timestamp`'
- name: desc_sort
in: query
description: 'Field used to sort results in descending order. enum: `mac`, `model`, `sku`, `timestamp`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/search_site_devices_desc_sort'
- description: 'Field used to sort results in descending order. enum: `mac`, `model`, `sku`, `timestamp`'
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_device_search'
- description: Paginated response for organization or site device search results
examples:
- '{"end":0,"limit":0,"next":"string","results":[{"hostname":["AP41-STB-3E5299-WH-2001","AP41-STB-3E5299-WH-50","AP41-STB-3E5299","5c5b353e5299"],"ip":"10.2.16.205","lldp_mgmt_addr":"10.2.10.139","lldp_port_desc":"GigabitEthernet1/0/1","lldp_port_id":"Gi1/0/1","lldp_system_desc":"Cisco IOS Software, C2960S Software (C2960S-UNIVERSALK9-M), Version 15.2(1)E1, RELEASE SOFTWARE (fc2)\nTechnical Support: https://www.cisco.com/techsupport\nCopyright (c) 1986-2013 by Cisco Systems, Inc.\nCompiled Fri 22-Nov-13 07:10 by prod_rel_team","lldp_system_name":"ME-DC-1-ACC-SW","mac":"5c5b353e5299","model":"AP41","mxedge_id":"00000000-0000-0000-1000-43a81f238391","mxtunnel_status":"down","org_id":"6748cfa6-4e12-11e6-9188-0242ac110007","power_constrained":false,"power_opmode":"","site_id":"a8178443-ecb5-461c-b854-f16627619ab3","sku":"AP41-US","timestamp":1596588619.007,"uptime":85280,"version":"0.7.20216","wlans":[{"id":"28c36fc7-dc22-4960-9d81-34087511c2e5","ssid":"Live-Demo-NAC"},{"id":"51b82e2b-f9e8-470b-a32a-cecde5501b0f","ssid":"Live-Demo"}]}],"start":0,"total":0}'
- '{"end":0,"limit":0,"next":"string","results":[{"clustered":true,"evpn_missing_links":false,"evpntopo_id":"","ext_ip":"250.242.0.102","hostname":["wan-teleworker","00ec77599d00","router"],"ip":"250.242.0.102","last_config_status":"success","last_hostname":"wan-teleworker","mac":"00ec77599d00","mist_configured":true,"model":"SSR120","node":"node1","node0_mac":"00ec77599d00","node1_mac":"00ec77599d01","num_members":0,"org_id":"6748cfa6-4e12-11e6-9188-0242ac110007","role":"","site_id":"a8178443-ecb5-461c-b854-f16627619ab3","t128agent_version":"3.8.0-201","time_drifted":false,"timestamp":1734001399.025,"type":"gateway","uptime":3586951,"version":"6.2.5-5.r2"}],"start":0,"total":0}'
- '{"end":0,"limit":0,"next":"string","results":[{"clustered":false,"evpn_missing_links":false,"evpntopo_id":"","ext_ip":"0.0.0.0","hostname":["ld-cup-idf-bbb"],"ip":"10.0.0.217","last_config_status":"success","last_hostname":"ld-cup-idf-bbb","last_trouble_code":"106","last_trouble_timestamp":1719540,"mac":"00c78d939c00","mist_configured":true,"model":"EX4100-48MP","num_members":1,"org_id":"6748cfa6-4e12-11e6-9188-0242ac110007","role":"","site_id":"a8178443-ecb5-461c-b854-f16627619ab3","time_drifted":false,"timestamp":1733998766.256,"type":"switch","uptime":19287811,"version":"22.4R3.25"}],"start":0,"total":0}'
contentMediaType: application/json
examples:
Ap:
value:
end: 0
limit: 0
next: string
results:
- hostname:
- AP41-STB-3E5299-WH-2001
- AP41-STB-3E5299-WH-50
- AP41-STB-3E5299
- 5c5b353e5299
ip: 10.2.16.205
lldp_mgmt_addr: 10.2.10.139
lldp_port_desc: GigabitEthernet1/0/1
lldp_port_id: Gi1/0/1
lldp_system_desc: >-
Cisco IOS Software, C2960S Software (C2960S-UNIVERSALK9-M), Version 15.2(1)E1, RELEASE SOFTWARE (fc2)
Technical Support: https://www.cisco.com/techsupport
Copyright (c) 1986-2013 by Cisco Systems, Inc.
Compiled Fri 22-Nov-13 07:10 by prod_rel_team
lldp_system_name: ME-DC-1-ACC-SW
mac: 5c5b353e5299
model: AP41
mxedge_id: 00000000-0000-0000-1000-43a81f238391
mxtunnel_status: down
org_id: 6748cfa6-4e12-11e6-9188-0242ac110007
power_constrained: false
power_opmode: ''
site_id: a8178443-ecb5-461c-b854-f16627619ab3
sku: AP41-US
timestamp: 1596588619.007
uptime: 85280
version: 0.7.20216
wlans:
- id: 28c36fc7-dc22-4960-9d81-34087511c2e5
ssid: Live-Demo-NAC
- id: 51b82e2b-f9e8-470b-a32a-cecde5501b0f
ssid: Live-Demo
start: 0
total: 0
Gateway:
value:
end: 0
limit: 0
next: string
results:
- clustered: true
evpn_missing_links: false
evpntopo_id: ''
ext_ip: 250.242.0.102
hostname:
- wan-teleworker
- 00ec77599d00
- router
ip: 250.242.0.102
last_config_status: success
last_hostname: wan-teleworker
mac: 00ec77599d00
mist_configured: true
model: SSR120
node: node1
node0_mac: 00ec77599d00
node1_mac: 00ec77599d01
num_members: 0
org_id: 6748cfa6-4e12-11e6-9188-0242ac110007
role: ''
site_id: a8178443-ecb5-461c-b854-f16627619ab3
t128agent_version: 3.8.0-201
time_drifted: false
timestamp: 1734001399.025
type: gateway
uptime: 3586951
version: 6.2.5-5.r2
start: 0
total: 0
Switch:
value:
end: 0
limit: 0
next: string
results:
- clustered: false
evpn_missing_links: false
evpntopo_id: ''
ext_ip: 0.0.0.0
hostname:
- ld-cup-idf-bbb
ip: 10.0.0.217
last_config_status: success
last_hostname: ld-cup-idf-bbb
last_trouble_code: '106'
last_trouble_timestamp: 1719540
mac: 00c78d939c00
mist_configured: true
model: EX4100-48MP
num_members: 1
org_id: 6748cfa6-4e12-11e6-9188-0242ac110007
role: ''
site_id: a8178443-ecb5-461c-b854-f16627619ab3
time_drifted: false
timestamp: 1733998766.256
type: switch
uptime: 19287811
version: 22.4R3.25
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_device_search'
- description: Paginated response for organization or site device search results
examples:
- '{"end":0,"limit":0,"next":"string","results":[{"hostname":["AP41-STB-3E5299-WH-2001","AP41-STB-3E5299-WH-50","AP41-STB-3E5299","5c5b353e5299"],"ip":"10.2.16.205","lldp_mgmt_addr":"10.2.10.139","lldp_port_desc":"GigabitEthernet1/0/1","lldp_port_id":"Gi1/0/1","lldp_system_desc":"Cisco IOS Software, C2960S Software (C2960S-UNIVERSALK9-M), Version 15.2(1)E1, RELEASE SOFTWARE (fc2)\nTechnical Support: https://www.cisco.com/techsupport\nCopyright (c) 1986-2013 by Cisco Systems, Inc.\nCompiled Fri 22-Nov-13 07:10 by prod_rel_team","lldp_system_name":"ME-DC-1-ACC-SW","mac":"5c5b353e5299","model":"AP41","mxedge_id":"00000000-0000-0000-1000-43a81f238391","mxtunnel_status":"down","org_id":"6748cfa6-4e12-11e6-9188-0242ac110007","power_constrained":false,"power_opmode":"","site_id":"a8178443-ecb5-461c-b854-f16627619ab3","sku":"AP41-US","timestamp":1596588619.007,"uptime":85280,"version":"0.7.20216","wlans":[{"id":"28c36fc7-dc22-4960-9d81-34087511c2e5","ssid":"Live-Demo-NAC"},{"id":"51b82e2b-f9e8-470b-a32a-cecde5501b0f","ssid":"Live-Demo"}]}],"start":0,"total":0}'
- '{"end":0,"limit":0,"next":"string","results":[{"clustered":true,"evpn_missing_links":false,"evpntopo_id":"","ext_ip":"250.242.0.102","hostname":["wan-teleworker","00ec77599d00","router"],"ip":"250.242.0.102","last_config_status":"success","last_hostname":"wan-teleworker","mac":"00ec77599d00","mist_configured":true,"model":"SSR120","node":"node1","node0_mac":"00ec77599d00","node1_mac":"00ec77599d01","num_members":0,"org_id":"6748cfa6-4e12-11e6-9188-0242ac110007","role":"","site_id":"a8178443-ecb5-461c-b854-f16627619ab3","t128agent_version":"3.8.0-201","time_drifted":false,"timestamp":1734001399.025,"type":"gateway","uptime":3586951,"version":"6.2.5-5.r2"}],"start":0,"total":0}'
- '{"end":0,"limit":0,"next":"string","results":[{"clustered":false,"evpn_missing_links":false,"evpntopo_id":"","ext_ip":"0.0.0.0","hostname":["ld-cup-idf-bbb"],"ip":"10.0.0.217","last_config_status":"success","last_hostname":"ld-cup-idf-bbb","last_trouble_code":"106","last_trouble_timestamp":1719540,"mac":"00c78d939c00","mist_configured":true,"model":"EX4100-48MP","num_members":1,"org_id":"6748cfa6-4e12-11e6-9188-0242ac110007","role":"","site_id":"a8178443-ecb5-461c-b854-f16627619ab3","time_drifted":false,"timestamp":1733998766.256,"type":"switch","uptime":19287811,"version":"22.4R3.25"}],"start":0,"total":0}'
contentMediaType: application/vnd.api+json
examples:
Ap:
value:
end: 0
limit: 0
next: string
results:
- hostname:
- AP41-STB-3E5299-WH-2001
- AP41-STB-3E5299-WH-50
- AP41-STB-3E5299
- 5c5b353e5299
ip: 10.2.16.205
lldp_mgmt_addr: 10.2.10.139
lldp_port_desc: GigabitEthernet1/0/1
lldp_port_id: Gi1/0/1
lldp_system_desc: >-
Cisco IOS Software, C2960S Software (C2960S-UNIVERSALK9-M), Version 15.2(1)E1, RELEASE SOFTWARE (fc2)
Technical Support: https://www.cisco.com/techsupport
Copyright (c) 1986-2013 by Cisco Systems, Inc.
Compiled Fri 22-Nov-13 07:10 by prod_rel_team
lldp_system_name: ME-DC-1-ACC-SW
mac: 5c5b353e5299
model: AP41
mxedge_id: 00000000-0000-0000-1000-43a81f238391
mxtunnel_status: down
org_id: 6748cfa6-4e12-11e6-9188-0242ac110007
power_constrained: false
power_opmode: ''
site_id: a8178443-ecb5-461c-b854-f16627619ab3
sku: AP41-US
timestamp: 1596588619.007
uptime: 85280
version: 0.7.20216
wlans:
- id: 28c36fc7-dc22-4960-9d81-34087511c2e5
ssid: Live-Demo-NAC
- id: 51b82e2b-f9e8-470b-a32a-cecde5501b0f
ssid: Live-Demo
start: 0
total: 0
Gateway:
value:
end: 0
limit: 0
next: string
results:
- clustered: true
evpn_missing_links: false
evpntopo_id: ''
ext_ip: 250.242.0.102
hostname:
- wan-teleworker
- 00ec77599d00
- router
ip: 250.242.0.102
last_config_status: success
last_hostname: wan-teleworker
mac: 00ec77599d00
mist_configured: true
model: SSR120
node: node1
node0_mac: 00ec77599d00
node1_mac: 00ec77599d01
num_members: 0
org_id: 6748cfa6-4e12-11e6-9188-0242ac110007
role: ''
site_id: a8178443-ecb5-461c-b854-f16627619ab3
t128agent_version: 3.8.0-201
time_drifted: false
timestamp: 1734001399.025
type: gateway
uptime: 3586951
version: 6.2.5-5.r2
start: 0
total: 0
Switch:
value:
end: 0
limit: 0
next: string
results:
- clustered: false
evpn_missing_links: false
evpntopo_id: ''
ext_ip: 0.0.0.0
hostname:
- ld-cup-idf-bbb
ip: 10.0.0.217
last_config_status: success
last_hostname: ld-cup-idf-bbb
last_trouble_code: '106'
last_trouble_timestamp: 1719540
mac: 00c78d939c00
mist_configured: true
model: EX4100-48MP
num_members: 1
org_id: 6748cfa6-4e12-11e6-9188-0242ac110007
role: ''
site_id: a8178443-ecb5-461c-b854-f16627619ab3
time_drifted: false
timestamp: 1733998766.256
type: switch
uptime: 19287811
version: 22.4R3.25
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}:
get:
tags:
- Sites Devices
summary: getSiteDevice
description: Get Device Configuration
operationId: getSiteDevice
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/mist_device'
- description: Mist-managed device object for an AP, switch, or gateway
examples:
- aeroscout:
enabled: false
host: aero.pvt.net
locate_connected: true
airista:
enabled: false
ble_config:
beacon_enabled: false
beacon_rate: 3
beacon_rate_mode: custom
beam_disabled:
- 1
- 3
- 6
custom_ble_packet_enabled: false
custom_ble_packet_frame: 0x........
custom_ble_packet_freq_msec: 300
eddystone_uid_adv_power: -65
eddystone_uid_beams: 2-4,7
eddystone_uid_enabled: false
eddystone_uid_freq_msec: 200
eddystone_uid_instance: 5c5b35000001
eddystone_uid_namespace: 2818e3868dec25629ede
eddystone_url_adv_power: -65
eddystone_url_beams: 2-4,7
eddystone_url_enabled: true
eddystone_url_freq_msec: 1000
eddystone_url_url: https://www.abc.com
ibeacon_adv_power: -65
ibeacon_beams: 2-4,7
ibeacon_enabled: false
ibeacon_freq_msec: 0
ibeacon_major: 13
ibeacon_minor: 138
ibeacon_uuid: f3f17139-704a-f03a-2786-0400279e37c3
power: 6
power_mode: custom
centrak:
enabled: false
client_bridge:
auth:
psk: foryoureyesonly
type: psk
enabled: false
ssid: Uplink-SSID
created_time: 0
deviceprofile_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
disable_eth1: false
disable_eth2: false
disable_eth3: false
disable_module: false
esl_config:
cacert: string
channel: 3
enabled: false
host: 1.1.1.1
port: 0
type: imagotag
verify_cert: true
vlan_id: 1
for_site: true
height: 2.75
id: 497f6eca-6276-4993-bfeb-53cbbbba6008
image1_url: string
image2_url: string
image3_url: string
iot_config:
A1:
enabled: false
name: motion
output: true
pullup: internal
value: 0
A2:
enabled: false
name: motion
output: true
pullup: internal
value: 0
A3:
enabled: false
name: motion
output: true
pullup: internal
value: 0
A4:
enabled: false
name: motion
output: true
pullup: internal
value: 0
DI1:
enabled: false
name: string
pullup: internal
DI2:
enabled: false
name: string
pullup: internal
DO:
enabled: false
name: motion
output: true
pullup: internal
value: 0
ip_config:
dns:
- 8.8.8.8
- 4.4.4.4
dns_suffix:
- .mist.local
- .mist.com
gateway: 10.2.1.254
gateway6: 2607:f8b0:4005:808::1
ip: 10.2.1.1
ip6: 2607:f8b0:4005:808::2004
mtu: 1500
netmask: 255.255.255.0
netmask6: /32
type: static
type6: static
vlan_id: 1
led:
brightness: 255
enabled: true
locked: true
map_id: 63eda950-c6da-11e4-a628-60f81dd250cc
mesh:
enabled: false
group: 1
role: base
modified_time: 0
name: conference room
notes: slightly off center
ntp_servers:
- string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
orientation: 45
poe_passthrough: false
pwr_config:
base: 2000
prefer_usb_over_wifi: false
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
type: ap
uplink_port_config:
dot1x: false
keep_wlans_up_if_down: false
usb_config:
cacert: string
channel: 3
enabled: true
host: 1.1.1.1
port: 0
type: imagotag
verify_cert: true
vlan_id: 1
vars:
RADIUS_IP1: 172.31.2.5
RADIUS_SECRET: 11s64632d
x: 53.5
y: 173.1
contentMediaType: application/json
examples:
Ap:
value:
aeroscout:
enabled: false
host: aero.pvt.net
locate_connected: true
airista:
enabled: false
ble_config:
beacon_enabled: false
beacon_rate: 3
beacon_rate_mode: custom
beam_disabled:
- 1
- 3
- 6
custom_ble_packet_enabled: false
custom_ble_packet_frame: 0x........
custom_ble_packet_freq_msec: 300
eddystone_uid_adv_power: -65
eddystone_uid_beams: 2-4,7
eddystone_uid_enabled: false
eddystone_uid_freq_msec: 200
eddystone_uid_instance: 5c5b35000001
eddystone_uid_namespace: 2818e3868dec25629ede
eddystone_url_adv_power: -65
eddystone_url_beams: 2-4,7
eddystone_url_enabled: true
eddystone_url_freq_msec: 1000
eddystone_url_url: https://www.abc.com
ibeacon_adv_power: -65
ibeacon_beams: 2-4,7
ibeacon_enabled: false
ibeacon_freq_msec: 0
ibeacon_major: 13
ibeacon_minor: 138
ibeacon_uuid: f3f17139-704a-f03a-2786-0400279e37c3
power: 6
power_mode: custom
centrak:
enabled: false
client_bridge:
auth:
psk: foryoureyesonly
type: psk
enabled: false
ssid: Uplink-SSID
created_time: 0
deviceprofile_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
disable_eth1: false
disable_eth2: false
disable_eth3: false
disable_module: false
esl_config:
cacert: string
channel: 3
enabled: false
host: 1.1.1.1
port: 0
type: imagotag
verify_cert: true
vlan_id: 1
for_site: true
height: 2.75
id: 497f6eca-6276-4993-bfeb-53cbbbba6008
image1_url: string
image2_url: string
image3_url: string
iot_config:
A1:
enabled: false
name: motion
output: true
pullup: internal
value: 0
A2:
enabled: false
name: motion
output: true
pullup: internal
value: 0
A3:
enabled: false
name: motion
output: true
pullup: internal
value: 0
A4:
enabled: false
name: motion
output: true
pullup: internal
value: 0
DI1:
enabled: false
name: string
pullup: internal
DI2:
enabled: false
name: string
pullup: internal
DO:
enabled: false
name: motion
output: true
pullup: internal
value: 0
ip_config:
dns:
- 8.8.8.8
- 4.4.4.4
dns_suffix:
- .mist.local
- .mist.com
gateway: 10.2.1.254
gateway6: 2607:f8b0:4005:808::1
ip: 10.2.1.1
ip6: 2607:f8b0:4005:808::2004
mtu: 1500
netmask: 255.255.255.0
netmask6: /32
type: static
type6: static
vlan_id: 1
led:
brightness: 255
enabled: true
locked: true
map_id: 63eda950-c6da-11e4-a628-60f81dd250cc
mesh:
enabled: false
group: 1
role: base
modified_time: 0
name: conference room
notes: slightly off center
ntp_servers:
- string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
orientation: 45
poe_passthrough: false
pwr_config:
base: 2000
prefer_usb_over_wifi: false
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
type: ap
uplink_port_config:
dot1x: false
keep_wlans_up_if_down: false
usb_config:
cacert: string
channel: 3
enabled: true
host: 1.1.1.1
port: 0
type: imagotag
verify_cert: true
vlan_id: 1
vars:
RADIUS_IP1: 172.31.2.5
RADIUS_SECRET: 11s64632d
x: 53.5
y: 173.1
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/mist_device'
- description: Mist-managed device object for an AP, switch, or gateway
examples:
- aeroscout:
enabled: false
host: aero.pvt.net
locate_connected: true
airista:
enabled: false
ble_config:
beacon_enabled: false
beacon_rate: 3
beacon_rate_mode: custom
beam_disabled:
- 1
- 3
- 6
custom_ble_packet_enabled: false
custom_ble_packet_frame: 0x........
custom_ble_packet_freq_msec: 300
eddystone_uid_adv_power: -65
eddystone_uid_beams: 2-4,7
eddystone_uid_enabled: false
eddystone_uid_freq_msec: 200
eddystone_uid_instance: 5c5b35000001
eddystone_uid_namespace: 2818e3868dec25629ede
eddystone_url_adv_power: -65
eddystone_url_beams: 2-4,7
eddystone_url_enabled: true
eddystone_url_freq_msec: 1000
eddystone_url_url: https://www.abc.com
ibeacon_adv_power: -65
ibeacon_beams: 2-4,7
ibeacon_enabled: false
ibeacon_freq_msec: 0
ibeacon_major: 13
ibeacon_minor: 138
ibeacon_uuid: f3f17139-704a-f03a-2786-0400279e37c3
power: 6
power_mode: custom
centrak:
enabled: false
client_bridge:
auth:
psk: foryoureyesonly
type: psk
enabled: false
ssid: Uplink-SSID
created_time: 0
deviceprofile_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
disable_eth1: false
disable_eth2: false
disable_eth3: false
disable_module: false
esl_config:
cacert: string
channel: 3
enabled: false
host: 1.1.1.1
port: 0
type: imagotag
verify_cert: true
vlan_id: 1
for_site: true
height: 2.75
id: 497f6eca-6276-4993-bfeb-53cbbbba6008
image1_url: string
image2_url: string
image3_url: string
iot_config:
A1:
enabled: false
name: motion
output: true
pullup: internal
value: 0
A2:
enabled: false
name: motion
output: true
pullup: internal
value: 0
A3:
enabled: false
name: motion
output: true
pullup: internal
value: 0
A4:
enabled: false
name: motion
output: true
pullup: internal
value: 0
DI1:
enabled: false
name: string
pullup: internal
DI2:
enabled: false
name: string
pullup: internal
DO:
enabled: false
name: motion
output: true
pullup: internal
value: 0
ip_config:
dns:
- 8.8.8.8
- 4.4.4.4
dns_suffix:
- .mist.local
- .mist.com
gateway: 10.2.1.254
gateway6: 2607:f8b0:4005:808::1
ip: 10.2.1.1
ip6: 2607:f8b0:4005:808::2004
mtu: 1500
netmask: 255.255.255.0
netmask6: /32
type: static
type6: static
vlan_id: 1
led:
brightness: 255
enabled: true
locked: true
map_id: 63eda950-c6da-11e4-a628-60f81dd250cc
mesh:
enabled: false
group: 1
role: base
modified_time: 0
name: conference room
notes: slightly off center
ntp_servers:
- string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
orientation: 45
poe_passthrough: false
pwr_config:
base: 2000
prefer_usb_over_wifi: false
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
type: ap
uplink_port_config:
dot1x: false
keep_wlans_up_if_down: false
usb_config:
cacert: string
channel: 3
enabled: true
host: 1.1.1.1
port: 0
type: imagotag
verify_cert: true
vlan_id: 1
vars:
RADIUS_IP1: 172.31.2.5
RADIUS_SECRET: 11s64632d
x: 53.5
y: 173.1
contentMediaType: application/vnd.api+json
examples:
Ap:
value:
aeroscout:
enabled: false
host: aero.pvt.net
locate_connected: true
airista:
enabled: false
ble_config:
beacon_enabled: false
beacon_rate: 3
beacon_rate_mode: custom
beam_disabled:
- 1
- 3
- 6
custom_ble_packet_enabled: false
custom_ble_packet_frame: 0x........
custom_ble_packet_freq_msec: 300
eddystone_uid_adv_power: -65
eddystone_uid_beams: 2-4,7
eddystone_uid_enabled: false
eddystone_uid_freq_msec: 200
eddystone_uid_instance: 5c5b35000001
eddystone_uid_namespace: 2818e3868dec25629ede
eddystone_url_adv_power: -65
eddystone_url_beams: 2-4,7
eddystone_url_enabled: true
eddystone_url_freq_msec: 1000
eddystone_url_url: https://www.abc.com
ibeacon_adv_power: -65
ibeacon_beams: 2-4,7
ibeacon_enabled: false
ibeacon_freq_msec: 0
ibeacon_major: 13
ibeacon_minor: 138
ibeacon_uuid: f3f17139-704a-f03a-2786-0400279e37c3
power: 6
power_mode: custom
centrak:
enabled: false
client_bridge:
auth:
psk: foryoureyesonly
type: psk
enabled: false
ssid: Uplink-SSID
created_time: 0
deviceprofile_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
disable_eth1: false
disable_eth2: false
disable_eth3: false
disable_module: false
esl_config:
cacert: string
channel: 3
enabled: false
host: 1.1.1.1
port: 0
type: imagotag
verify_cert: true
vlan_id: 1
for_site: true
height: 2.75
id: 497f6eca-6276-4993-bfeb-53cbbbba6008
image1_url: string
image2_url: string
image3_url: string
iot_config:
A1:
enabled: false
name: motion
output: true
pullup: internal
value: 0
A2:
enabled: false
name: motion
output: true
pullup: internal
value: 0
A3:
enabled: false
name: motion
output: true
pullup: internal
value: 0
A4:
enabled: false
name: motion
output: true
pullup: internal
value: 0
DI1:
enabled: false
name: string
pullup: internal
DI2:
enabled: false
name: string
pullup: internal
DO:
enabled: false
name: motion
output: true
pullup: internal
value: 0
ip_config:
dns:
- 8.8.8.8
- 4.4.4.4
dns_suffix:
- .mist.local
- .mist.com
gateway: 10.2.1.254
gateway6: 2607:f8b0:4005:808::1
ip: 10.2.1.1
ip6: 2607:f8b0:4005:808::2004
mtu: 1500
netmask: 255.255.255.0
netmask6: /32
type: static
type6: static
vlan_id: 1
led:
brightness: 255
enabled: true
locked: true
map_id: 63eda950-c6da-11e4-a628-60f81dd250cc
mesh:
enabled: false
group: 1
role: base
modified_time: 0
name: conference room
notes: slightly off center
ntp_servers:
- string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
orientation: 45
poe_passthrough: false
pwr_config:
base: 2000
prefer_usb_over_wifi: false
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
type: ap
uplink_port_config:
dot1x: false
keep_wlans_up_if_down: false
usb_config:
cacert: string
channel: 3
enabled: true
host: 1.1.1.1
port: 0
type: imagotag
verify_cert: true
vlan_id: 1
vars:
RADIUS_IP1: 172.31.2.5
RADIUS_SECRET: 11s64632d
x: 53.5
y: 173.1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Sites Devices
summary: updateSiteDevice
description: Update Device Configuration
operationId: updateSiteDevice
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/mist_device'
- description: Request Body
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/mist_device'
- description: Mist-managed device object for an AP, switch, or gateway
examples:
- aeroscout:
enabled: false
host: aero.pvt.net
locate_connected: true
airista:
enabled: false
ble_config:
beacon_enabled: false
beacon_rate: 3
beacon_rate_mode: custom
beam_disabled:
- 1
- 3
- 6
custom_ble_packet_enabled: false
custom_ble_packet_frame: 0x........
custom_ble_packet_freq_msec: 300
eddystone_uid_adv_power: -65
eddystone_uid_beams: 2-4,7
eddystone_uid_enabled: false
eddystone_uid_freq_msec: 200
eddystone_uid_instance: 5c5b35000001
eddystone_uid_namespace: 2818e3868dec25629ede
eddystone_url_adv_power: -65
eddystone_url_beams: 2-4,7
eddystone_url_enabled: true
eddystone_url_freq_msec: 1000
eddystone_url_url: https://www.abc.com
ibeacon_adv_power: -65
ibeacon_beams: 2-4,7
ibeacon_enabled: false
ibeacon_freq_msec: 0
ibeacon_major: 13
ibeacon_minor: 138
ibeacon_uuid: f3f17139-704a-f03a-2786-0400279e37c3
power: 6
power_mode: custom
centrak:
enabled: false
client_bridge:
auth:
psk: foryoureyesonly
type: psk
enabled: false
ssid: Uplink-SSID
created_time: 0
deviceprofile_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
disable_eth1: false
disable_eth2: false
disable_eth3: false
disable_module: false
esl_config:
cacert: string
channel: 3
enabled: false
host: 1.1.1.1
port: 0
type: imagotag
verify_cert: true
vlan_id: 1
for_site: true
height: 2.75
id: 497f6eca-6276-4993-bfeb-53cbbbba6008
image1_url: string
image2_url: string
image3_url: string
iot_config:
A1:
enabled: false
name: motion
output: true
pullup: internal
value: 0
A2:
enabled: false
name: motion
output: true
pullup: internal
value: 0
A3:
enabled: false
name: motion
output: true
pullup: internal
value: 0
A4:
enabled: false
name: motion
output: true
pullup: internal
value: 0
DI1:
enabled: false
name: string
pullup: internal
DI2:
enabled: false
name: string
pullup: internal
DO:
enabled: false
name: motion
output: true
pullup: internal
value: 0
ip_config:
dns:
- 8.8.8.8
- 4.4.4.4
dns_suffix:
- .mist.local
- .mist.com
gateway: 10.2.1.254
gateway6: 2607:f8b0:4005:808::1
ip: 10.2.1.1
ip6: 2607:f8b0:4005:808::2004
mtu: 1500
netmask: 255.255.255.0
netmask6: /32
type: static
type6: static
vlan_id: 1
led:
brightness: 255
enabled: true
locked: true
map_id: 63eda950-c6da-11e4-a628-60f81dd250cc
mesh:
enabled: false
group: 1
role: base
modified_time: 0
name: conference room
notes: slightly off center
ntp_servers:
- string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
orientation: 45
poe_passthrough: false
pwr_config:
base: 2000
prefer_usb_over_wifi: false
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
type: ap
uplink_port_config:
dot1x: false
keep_wlans_up_if_down: false
usb_config:
cacert: string
channel: 3
enabled: true
host: 1.1.1.1
port: 0
type: imagotag
verify_cert: true
vlan_id: 1
vars:
RADIUS_IP1: 172.31.2.5
RADIUS_SECRET: 11s64632d
x: 53.5
y: 173.1
contentMediaType: application/json
examples:
Ap:
value:
aeroscout:
enabled: false
host: aero.pvt.net
locate_connected: true
airista:
enabled: false
ble_config:
beacon_enabled: false
beacon_rate: 3
beacon_rate_mode: custom
beam_disabled:
- 1
- 3
- 6
custom_ble_packet_enabled: false
custom_ble_packet_frame: 0x........
custom_ble_packet_freq_msec: 300
eddystone_uid_adv_power: -65
eddystone_uid_beams: 2-4,7
eddystone_uid_enabled: false
eddystone_uid_freq_msec: 200
eddystone_uid_instance: 5c5b35000001
eddystone_uid_namespace: 2818e3868dec25629ede
eddystone_url_adv_power: -65
eddystone_url_beams: 2-4,7
eddystone_url_enabled: true
eddystone_url_freq_msec: 1000
eddystone_url_url: https://www.abc.com
ibeacon_adv_power: -65
ibeacon_beams: 2-4,7
ibeacon_enabled: false
ibeacon_freq_msec: 0
ibeacon_major: 13
ibeacon_minor: 138
ibeacon_uuid: f3f17139-704a-f03a-2786-0400279e37c3
power: 6
power_mode: custom
centrak:
enabled: false
client_bridge:
auth:
psk: foryoureyesonly
type: psk
enabled: false
ssid: Uplink-SSID
created_time: 0
deviceprofile_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
disable_eth1: false
disable_eth2: false
disable_eth3: false
disable_module: false
esl_config:
cacert: string
channel: 3
enabled: false
host: 1.1.1.1
port: 0
type: imagotag
verify_cert: true
vlan_id: 1
for_site: true
height: 2.75
id: 497f6eca-6276-4993-bfeb-53cbbbba6008
image1_url: string
image2_url: string
image3_url: string
iot_config:
A1:
enabled: false
name: motion
output: true
pullup: internal
value: 0
A2:
enabled: false
name: motion
output: true
pullup: internal
value: 0
A3:
enabled: false
name: motion
output: true
pullup: internal
value: 0
A4:
enabled: false
name: motion
output: true
pullup: internal
value: 0
DI1:
enabled: false
name: string
pullup: internal
DI2:
enabled: false
name: string
pullup: internal
DO:
enabled: false
name: motion
output: true
pullup: internal
value: 0
ip_config:
dns:
- 8.8.8.8
- 4.4.4.4
dns_suffix:
- .mist.local
- .mist.com
gateway: 10.2.1.254
gateway6: 2607:f8b0:4005:808::1
ip: 10.2.1.1
ip6: 2607:f8b0:4005:808::2004
mtu: 1500
netmask: 255.255.255.0
netmask6: /32
type: static
type6: static
vlan_id: 1
led:
brightness: 255
enabled: true
locked: true
map_id: 63eda950-c6da-11e4-a628-60f81dd250cc
mesh:
enabled: false
group: 1
role: base
modified_time: 0
name: conference room
notes: slightly off center
ntp_servers:
- string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
orientation: 45
poe_passthrough: false
pwr_config:
base: 2000
prefer_usb_over_wifi: false
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
type: ap
uplink_port_config:
dot1x: false
keep_wlans_up_if_down: false
usb_config:
cacert: string
channel: 3
enabled: true
host: 1.1.1.1
port: 0
type: imagotag
verify_cert: true
vlan_id: 1
vars:
RADIUS_IP1: 172.31.2.5
RADIUS_SECRET: 11s64632d
x: 53.5
y: 173.1
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/mist_device'
- description: Mist-managed device object for an AP, switch, or gateway
examples:
- aeroscout:
enabled: false
host: aero.pvt.net
locate_connected: true
airista:
enabled: false
ble_config:
beacon_enabled: false
beacon_rate: 3
beacon_rate_mode: custom
beam_disabled:
- 1
- 3
- 6
custom_ble_packet_enabled: false
custom_ble_packet_frame: 0x........
custom_ble_packet_freq_msec: 300
eddystone_uid_adv_power: -65
eddystone_uid_beams: 2-4,7
eddystone_uid_enabled: false
eddystone_uid_freq_msec: 200
eddystone_uid_instance: 5c5b35000001
eddystone_uid_namespace: 2818e3868dec25629ede
eddystone_url_adv_power: -65
eddystone_url_beams: 2-4,7
eddystone_url_enabled: true
eddystone_url_freq_msec: 1000
eddystone_url_url: https://www.abc.com
ibeacon_adv_power: -65
ibeacon_beams: 2-4,7
ibeacon_enabled: false
ibeacon_freq_msec: 0
ibeacon_major: 13
ibeacon_minor: 138
ibeacon_uuid: f3f17139-704a-f03a-2786-0400279e37c3
power: 6
power_mode: custom
centrak:
enabled: false
client_bridge:
auth:
psk: foryoureyesonly
type: psk
enabled: false
ssid: Uplink-SSID
created_time: 0
deviceprofile_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
disable_eth1: false
disable_eth2: false
disable_eth3: false
disable_module: false
esl_config:
cacert: string
channel: 3
enabled: false
host: 1.1.1.1
port: 0
type: imagotag
verify_cert: true
vlan_id: 1
for_site: true
height: 2.75
id: 497f6eca-6276-4993-bfeb-53cbbbba6008
image1_url: string
image2_url: string
image3_url: string
iot_config:
A1:
enabled: false
name: motion
output: true
pullup: internal
value: 0
A2:
enabled: false
name: motion
output: true
pullup: internal
value: 0
A3:
enabled: false
name: motion
output: true
pullup: internal
value: 0
A4:
enabled: false
name: motion
output: true
pullup: internal
value: 0
DI1:
enabled: false
name: string
pullup: internal
DI2:
enabled: false
name: string
pullup: internal
DO:
enabled: false
name: motion
output: true
pullup: internal
value: 0
ip_config:
dns:
- 8.8.8.8
- 4.4.4.4
dns_suffix:
- .mist.local
- .mist.com
gateway: 10.2.1.254
gateway6: 2607:f8b0:4005:808::1
ip: 10.2.1.1
ip6: 2607:f8b0:4005:808::2004
mtu: 1500
netmask: 255.255.255.0
netmask6: /32
type: static
type6: static
vlan_id: 1
led:
brightness: 255
enabled: true
locked: true
map_id: 63eda950-c6da-11e4-a628-60f81dd250cc
mesh:
enabled: false
group: 1
role: base
modified_time: 0
name: conference room
notes: slightly off center
ntp_servers:
- string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
orientation: 45
poe_passthrough: false
pwr_config:
base: 2000
prefer_usb_over_wifi: false
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
type: ap
uplink_port_config:
dot1x: false
keep_wlans_up_if_down: false
usb_config:
cacert: string
channel: 3
enabled: true
host: 1.1.1.1
port: 0
type: imagotag
verify_cert: true
vlan_id: 1
vars:
RADIUS_IP1: 172.31.2.5
RADIUS_SECRET: 11s64632d
x: 53.5
y: 173.1
contentMediaType: application/vnd.api+json
examples:
Ap:
value:
aeroscout:
enabled: false
host: aero.pvt.net
locate_connected: true
airista:
enabled: false
ble_config:
beacon_enabled: false
beacon_rate: 3
beacon_rate_mode: custom
beam_disabled:
- 1
- 3
- 6
custom_ble_packet_enabled: false
custom_ble_packet_frame: 0x........
custom_ble_packet_freq_msec: 300
eddystone_uid_adv_power: -65
eddystone_uid_beams: 2-4,7
eddystone_uid_enabled: false
eddystone_uid_freq_msec: 200
eddystone_uid_instance: 5c5b35000001
eddystone_uid_namespace: 2818e3868dec25629ede
eddystone_url_adv_power: -65
eddystone_url_beams: 2-4,7
eddystone_url_enabled: true
eddystone_url_freq_msec: 1000
eddystone_url_url: https://www.abc.com
ibeacon_adv_power: -65
ibeacon_beams: 2-4,7
ibeacon_enabled: false
ibeacon_freq_msec: 0
ibeacon_major: 13
ibeacon_minor: 138
ibeacon_uuid: f3f17139-704a-f03a-2786-0400279e37c3
power: 6
power_mode: custom
centrak:
enabled: false
client_bridge:
auth:
psk: foryoureyesonly
type: psk
enabled: false
ssid: Uplink-SSID
created_time: 0
deviceprofile_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
disable_eth1: false
disable_eth2: false
disable_eth3: false
disable_module: false
esl_config:
cacert: string
channel: 3
enabled: false
host: 1.1.1.1
port: 0
type: imagotag
verify_cert: true
vlan_id: 1
for_site: true
height: 2.75
id: 497f6eca-6276-4993-bfeb-53cbbbba6008
image1_url: string
image2_url: string
image3_url: string
iot_config:
A1:
enabled: false
name: motion
output: true
pullup: internal
value: 0
A2:
enabled: false
name: motion
output: true
pullup: internal
value: 0
A3:
enabled: false
name: motion
output: true
pullup: internal
value: 0
A4:
enabled: false
name: motion
output: true
pullup: internal
value: 0
DI1:
enabled: false
name: string
pullup: internal
DI2:
enabled: false
name: string
pullup: internal
DO:
enabled: false
name: motion
output: true
pullup: internal
value: 0
ip_config:
dns:
- 8.8.8.8
- 4.4.4.4
dns_suffix:
- .mist.local
- .mist.com
gateway: 10.2.1.254
gateway6: 2607:f8b0:4005:808::1
ip: 10.2.1.1
ip6: 2607:f8b0:4005:808::2004
mtu: 1500
netmask: 255.255.255.0
netmask6: /32
type: static
type6: static
vlan_id: 1
led:
brightness: 255
enabled: true
locked: true
map_id: 63eda950-c6da-11e4-a628-60f81dd250cc
mesh:
enabled: false
group: 1
role: base
modified_time: 0
name: conference room
notes: slightly off center
ntp_servers:
- string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
orientation: 45
poe_passthrough: false
pwr_config:
base: 2000
prefer_usb_over_wifi: false
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
type: ap
uplink_port_config:
dot1x: false
keep_wlans_up_if_down: false
usb_config:
cacert: string
channel: 3
enabled: true
host: 1.1.1.1
port: 0
type: imagotag
verify_cert: true
vlan_id: 1
vars:
RADIUS_IP1: 172.31.2.5
RADIUS_SECRET: 11s64632d
x: 53.5
y: 173.1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/image/{image_number}:
delete:
tags:
- Sites Devices
summary: deleteSiteDeviceImage
description: Delete image from a device
operationId: deleteSiteDeviceImage
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: image_number
in: path
description: ''
required: true
schema:
type: integer
contentEncoding: int32
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Sites Devices
summary: addSiteDeviceImage
description: Attach up to 3 images to a device
operationId: addSiteDeviceImage
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: image_number
in: path
description: ''
required: true
schema:
type: integer
contentEncoding: int32
requestBody:
content:
multipart/form-data:
encoding: {}
schema:
required:
- file
type: object
properties:
file:
type: string
description: Image file content uploaded as multipart form data
contentEncoding: base64
json:
type: string
description: Optional JSON metadata submitted with the image upload
contentMediaType: multipart/form-data
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/ap_channels:
get:
tags:
- Sites Devices - Wireless
summary: listSiteDeviceRadioChannels
description: Get a list of allowed channels (per channel width)
operationId: listSiteDeviceRadioChannels
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: country_code
in: query
description: Country code for the site (for AP config generation), in [two-character](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)
style: form
explode: true
schema:
type: string
examples:
- US
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_device_radio_channels'
- description: Country and regulatory-domain channel capabilities for AP radios
examples:
- band24_40mhz_allowed: false
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
certified: true
code: 840
dfs_ok: true
key: US
name: United States
uses: US_FCC
contentMediaType: application/json
examples:
Example:
value:
band24_40mhz_allowed: false
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
certified: true
code: 840
dfs_ok: true
key: US
name: United States
uses: US_FCC
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_device_radio_channels'
- description: Country and regulatory-domain channel capabilities for AP radios
examples:
- band24_40mhz_allowed: false
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
certified: true
code: 840
dfs_ok: true
key: US
name: United States
uses: US_FCC
contentMediaType: application/vnd.api+json
examples:
Example:
value:
band24_40mhz_allowed: false
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
certified: true
code: 840
dfs_ok: true
key: US
name: United States
uses: US_FCC
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/iot:
get:
tags:
- Sites Devices - Wireless
summary: getSiteDeviceIotPort
description: Returns the current state of each enabled IoT pin configured as an output.
operationId: getSiteDeviceIotPort
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: object
additionalProperties:
type: integer
format: int32
description: Property key is the IoT port name (e.g. "A1"), value is the output state (0 or 1).
examples:
- A1: 1
DO: 0
contentMediaType: application/json
examples:
Example:
value:
A1: 1
DO: 0
application/vnd.api+json:
schema:
type: object
additionalProperties:
type: integer
format: int32
description: Property key is the IoT port name (e.g. "A1"), value is the output state (0 or 1).
examples:
- A1: 1
DO: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
A1: 1
DO: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Sites Devices - Wireless
summary: setSiteDeviceIotPort
description: >-
**Note**: For each IoT pin referenced:
* The pin must be enabled using the Device `iot_config` API
* The pin must support the output direction
operationId: setSiteDeviceIotPort
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
type: object
additionalProperties:
type: integer
format: int32
description: Request Body
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: object
additionalProperties:
type: integer
format: int32
description: Property key is the IoT port name (e.g. "A1"), value is the output state (0 or 1).
examples:
- A1: 1
DO: 0
contentMediaType: application/json
examples:
Example:
value:
A1: 1
DO: 0
application/vnd.api+json:
schema:
type: object
additionalProperties:
type: integer
format: int32
description: Property key is the IoT port name (e.g. "A1"), value is the output state (0 or 1).
examples:
- A1: 1
DO: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
A1: 1
DO: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/zigbee_event_trail:
post:
tags:
- Sites Devices - Wireless
summary: startSiteDeviceZigbeeEventTrail
description: Start a Zigbee event trail session on an AP. Returns a `session` that the UI can use to stream results.
operationId: startSiteDeviceZigbeeEventTrail
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zigbee_trail_response'
- description: Response containing the session identifier for a Zigbee event or packet trail operation
examples:
- session: 7a5f7796-83ee-11e5-95c6-1258369c38a9
contentMediaType: application/json
examples:
Example:
value:
session: 7a5f7796-83ee-11e5-95c6-1258369c38a9
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/zigbee_trail_response'
- description: Response containing the session identifier for a Zigbee event or packet trail operation
examples:
- session: 7a5f7796-83ee-11e5-95c6-1258369c38a9
contentMediaType: application/vnd.api+json
examples:
Example:
value:
session: 7a5f7796-83ee-11e5-95c6-1258369c38a9
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/zigbee_join:
delete:
tags:
- Sites Devices - Wireless
summary: stopSiteDeviceZigbeeJoin
description: Stop allowing new Zigbee end devices to join the network through the specified AP.
operationId: stopSiteDeviceZigbeeJoin
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Sites Devices - Wireless
summary: enableSiteDeviceZigbeeJoin
description: >-
Allow Zigbee end devices to join the network for a configurable duration. After the duration expires, new joins will be blocked (unless `allow_join`==`always` is configured on the device).
#### Subscribe to Zigbee Join Events
`WS /api-ws/v1/stream`
```json
{
"subscribe": "/sites/{site_id}/devices/{device_id}/zigbee_join"
}
```
##### Example output from ws stream
```json
{
"event": "data",
"channel": "/sites/4ac1dcf4-9d8b-7211-65c4-057819f0862b/devices/00000000-0000-0000-1000-5c5b350e0060/cmd",
"data": {
"session": "19e73828-937f-05e6-f709-e29efdb0a82b",
"zigbee_mac": "fd05eb86c04ac04a",
"event_type": "associated",
"detail": {
"lqi": 180
}
}
}
```
operationId: enableSiteDeviceZigbeeJoin
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/utils_zigbee_join'
- description: Request Body
examples:
- duration: 600
contentMediaType: application/json
examples:
Example:
value:
duration: 600
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zigbee_join_response'
- description: Response containing the session identifier for a Zigbee join operation
examples:
- session_id: 19e73828-937f-05e6-f709-e29efdb0a82b
contentMediaType: application/json
examples:
Example:
value:
session_id: 19e73828-937f-05e6-f709-e29efdb0a82b
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/zigbee_join_response'
- description: Response containing the session identifier for a Zigbee join operation
examples:
- session_id: 19e73828-937f-05e6-f709-e29efdb0a82b
contentMediaType: application/vnd.api+json
examples:
Example:
value:
session_id: 19e73828-937f-05e6-f709-e29efdb0a82b
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/zigbee_kick:
post:
tags:
- Sites Devices - Wireless
summary: kickSiteDeviceZigbeeClients
description: Kick one or more Zigbee clients from a Zigbee-enabled AP. The AP must be connected.
operationId: kickSiteDeviceZigbeeClients
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/utils_zigbee_kick'
- description: Request Body
examples:
- macs:
- 00177a01060cae9f
- 00177a01060caea1
contentMediaType: application/json
examples:
Example:
value:
macs:
- 00177a01060cae9f
- 00177a01060caea1
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/zigbee_packet_trail:
post:
tags:
- Sites Devices - Wireless
summary: startSiteDeviceZigbeePacketTrail
description: Start a Zigbee packet trail session on an AP. Returns a `session` that the UI can use to stream results.
operationId: startSiteDeviceZigbeePacketTrail
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zigbee_trail_response'
- description: Response containing the session identifier for a Zigbee event or packet trail operation
examples:
- session: 7a5f7796-83ee-11e5-95c6-1258369c38a9
contentMediaType: application/json
examples:
Example:
value:
session: 7a5f7796-83ee-11e5-95c6-1258369c38a9
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/zigbee_trail_response'
- description: Response containing the session identifier for a Zigbee event or packet trail operation
examples:
- session: 7a5f7796-83ee-11e5-95c6-1258369c38a9
contentMediaType: application/vnd.api+json
examples:
Example:
value:
session: 7a5f7796-83ee-11e5-95c6-1258369c38a9
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/otherdevices:
get:
tags:
- Sites Devices - Others
summary: listSiteOtherDevices
description: List third-party devices in a site, such as devices discovered or tracked outside the managed Mist device inventory. Use [List Org Other Devices]($e/Orgs%20Devices%20-%20Others/listOrgOtherDevices) to retrieve third-party devices across the organization.
operationId: listSiteOtherDevices
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: vendor
in: query
description: Filter results by vendor
style: form
explode: true
schema:
type: string
- name: mac
in: query
description: Filter results by MAC address
style: form
explode: true
schema:
type: string
- name: serial
in: query
description: Filter results by device serial number
style: form
explode: true
schema:
type: string
- name: model
in: query
description: Filter results by device model
style: form
explode: true
schema:
type: string
- name: name
in: query
description: Filter results by name
style: form
explode: true
schema:
type: string
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/device_other'
description: List of third-party devices reported by external integrations
examples:
- - created_time: 1676983730
device_mac: '001122334455'
id: ae9dee49-69e7-4710-a114-5b827a777738
mac: 5c5b35000018
model: AP41
modified_time: 1676983730
name: hallway
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
serial: FXLH2015150025
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
vendor: cradlepoint
contentMediaType: application/json
examples:
Example:
value:
- created_time: 1676983730
device_mac: '001122334455'
id: ae9dee49-69e7-4710-a114-5b827a777738
mac: 5c5b35000018
model: AP41
modified_time: 1676983730
name: hallway
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
serial: FXLH2015150025
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
vendor: cradlepoint
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/device_other'
description: List of third-party devices reported by external integrations
examples:
- - created_time: 1676983730
device_mac: '001122334455'
id: ae9dee49-69e7-4710-a114-5b827a777738
mac: 5c5b35000018
model: AP41
modified_time: 1676983730
name: hallway
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
serial: FXLH2015150025
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
vendor: cradlepoint
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- created_time: 1676983730
device_mac: '001122334455'
id: ae9dee49-69e7-4710-a114-5b827a777738
mac: 5c5b35000018
model: AP41
modified_time: 1676983730
name: hallway
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
serial: FXLH2015150025
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
vendor: cradlepoint
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/otherdevices/events/count:
get:
tags:
- Sites Devices - Others
summary: countSiteOtherDeviceEvents
description: Count third-party device events for a site, optionally grouped by the `distinct` field and filtered by event type and time range. Use [Count Org Other Device Events]($e/Orgs%20Devices%20-%20Others/countOrgOtherDeviceEvents) to count third-party device events across the organization.
operationId: countSiteOtherDeviceEvents
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field used to group this count response. enum: `mac`, `site_id`, `type`, `vendor`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/site_other_device_events_count_distinct'
- description: 'Field used to group this count response. enum: `mac`, `site_id`, `type`, `vendor`'
- name: type
in: query
description: See [List Device Events Definitions]($e/Constants%20Events/listOtherDeviceEventsDefinitions)
style: form
explode: true
schema:
type: string
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/otherdevices/events/search:
get:
tags:
- Sites Devices - Others
summary: searchSiteOtherDeviceEvents
description: Search third-party device events for a site with filters for device identifiers, model, vendor, event type, and time range. Use [Search Org Other Device Events]($e/Orgs%20Devices%20-%20Others/searchOrgOtherDeviceEvents) to search third-party device events across the organization.
operationId: searchSiteOtherDeviceEvents
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: mac
in: query
description: Filter results by MAC address
style: form
explode: true
schema:
type: string
- name: device_mac
in: query
description: MAC of attached device
style: form
explode: true
schema:
type: string
- name: vendor
in: query
description: Filter results by vendor
style: form
explode: true
schema:
type: string
- name: type
in: query
description: See [List Device Events Definitions]($e/Constants%20Events/listOtherDeviceEventsDefinitions)
style: form
explode: true
schema:
type: string
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_events_other_devices_search'
- description: Paginated response for other-device event search results
examples:
- end: 0
limit: 0
results:
- device_mac: string
mac: 5c5b351e13b5
org_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862a
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
text: 'Plugged: The Internal 5GB (SIM1) has been inserted into Internal 1.'
timestamp: 547235620.89
type: CELLULAR_EDGE_MODEM_WAN_PLUGGED
vendor: cradlepoint
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
end: 0
limit: 0
results:
- device_mac: string
mac: 5c5b351e13b5
org_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862a
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
text: 'Plugged: The Internal 5GB (SIM1) has been inserted into Internal 1.'
timestamp: 547235620.89
type: CELLULAR_EDGE_MODEM_WAN_PLUGGED
vendor: cradlepoint
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_events_other_devices_search'
- description: Paginated response for other-device event search results
examples:
- end: 0
limit: 0
results:
- device_mac: string
mac: 5c5b351e13b5
org_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862a
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
text: 'Plugged: The Internal 5GB (SIM1) has been inserted into Internal 1.'
timestamp: 547235620.89
type: CELLULAR_EDGE_MODEM_WAN_PLUGGED
vendor: cradlepoint
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 0
limit: 0
results:
- device_mac: string
mac: 5c5b351e13b5
org_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862a
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
text: 'Plugged: The Internal 5GB (SIM1) has been inserted into Internal 1.'
timestamp: 547235620.89
type: CELLULAR_EDGE_MODEM_WAN_PLUGGED
vendor: cradlepoint
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/local_port_config:
delete:
tags:
- Sites Devices - Wired
summary: deleteSiteLocalSwitchPortConfig
description: "API Calls delete all the existing port config local overrides, and reapply the configured planed at the device level \n(with site / template heritance)."
operationId: deleteSiteLocalSwitchPortConfig
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Sites Devices - Wired
summary: updateSiteLocalSwitchPortConfig
description: "API Calls to add port config local overrides. This can be used by Switch Port Operators or Helpdesk administrators\nto change a Switch Port configuration without having to change the switch configuration.\n\n\nThe local overrides configured for the switchports with `no_local_overwrite`==`true` won't be applied to the switch configuration. \n\n\n> NOTE:\n>\n> When using the API Call, it is required to put send all overrides in the PUT request Payload, even the existing once. \n>\n> The current overrides can be retrieved with the API Call [Get Site Device]($e/Sites%20Devices/getSiteDevice). The local overrides will show up separately from the `port_config` in the `local_port_config` so it can be easily identified (and cleared)"
operationId: updateSiteLocalSwitchPortConfig
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
type: object
additionalProperties:
$ref: '#/components/schemas/junos_local_port_config'
examples:
- ge-0/0/0-1:
poe_disabled: true
usage: iot
contentMediaType: application/json
examples:
Example:
value:
ge-0/0/0-1:
poe_disabled: true
usage: iot
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/set_vc_port_mode:
post:
tags:
- Sites Devices - Wired - Virtual Chassis
summary: changeSiteSwitchVcPortMode
description: >-
Change VCP port mode
Some switch model allows changing VCP port behaviors, e.g. - use them as regular network ports - change vcp protocol Note, this command will reboot the switch
operationId: changeSiteSwitchVcPortMode
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/vc_port'
- description: Request Body
examples:
- mode: network
contentMediaType: application/json
examples:
Example:
value:
mode: network
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/vc:
delete:
tags:
- Sites Devices - Wired - Virtual Chassis
summary: deleteSiteVirtualChassis
description: >-
When all the member switches of VC are removed and only member ID 0 is left, the cloud would detect this situation and automatically changes the single switch to non-VC role.
For some unexpected cases that the VC is gone and disconnected, the API below could be used to change the state of VC’s switches to be standalone. After it is executed, all the switches will be shown as standalone switches under Inventory.
operationId: deleteSiteVirtualChassis
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Sites Devices - Wired - Virtual Chassis
summary: getSiteDeviceVirtualChassis
description: >-
Get VC Status
The API returns a combined view of the VC status which includes topology and stats_
operationId: getSiteDeviceVirtualChassis
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_virtual_chassis_config'
- description: Combined virtual chassis status, topology, and member statistics
examples:
- config_type: nonprovisioned
id: 00000000-0000-0000-1000-52d9107af289
mac: 52d9107af289
members:
- boot_partition: junos
cpld_version: '6'
cpu_stat:
idle: 69
interrupt: 1
load_avg:
- 0.8
- 1.09
- 1.07
system: 11
user: 19
fans:
- airflow: out
name: Fan Tray 0 Fan 0
rpm: 0
status: ok
- airflow: out
name: Fan Tray 1 Fan 0
rpm: 0
status: ok
fpc_idx: 0
mac: 52d9107af289
memory_stat:
usage: 42
model: EX2300-48P
pics:
- index: 0
model_number: EX2300-48P
port_groups:
- count: 48
type: GE
- index: 1
model_number: EX2300-48P
port_groups:
- count: 4
type: SFP/SFP+
poe:
max_power: 750
power_draw: 40.4
status: AT_MODE
poe_version: 2.1.1.19.3 (type1)
psus:
- name: Power Supply 0
status: ok
recovery_version: 21.4R3-S4.18
serial: JW0000000000
temperatures:
- celsius: 33
name: CPU Sensor
status: ok
- celsius: 29
name: PSU Sensor
status: ok
type: fpc
uboot_version: U-Boot 2016.01-rc1 (Nov 11 2016 - 14:26:00 -0800) 1.3.2
uptime: 27636720
vc_links:
- neighbor_module_idx: 1
neighbor_port_id: vcp-1/1/0
port_id: vcp-0/1/0
vc_mode: HiGiG
vc_role: master
vc_state: present
version: 21.4R3-S4.18
- boot_partition: junos
cpld_version: '6'
cpu_stat:
idle: 76
interrupt: 0
load_avg:
- 0.96
- 0.87
- 0.76
system: 6
user: 17
fans:
- airflow: out
name: Fan Tray 0 Fan 0
rpm: 0
status: ok
- airflow: out
name: Fan Tray 1 Fan 0
rpm: 0
status: ok
fpc_idx: 1
mac: d0dd4991652d
memory_stat:
usage: 18
model: EX2300-48P
pics:
- index: 0
model_number: EX2300-48P
port_groups:
- count: 48
type: GE
- index: 1
model_number: EX2300-48P
port_groups:
- count: 4
type: SFP/SFP+
poe:
max_power: 750
power_draw: 21.2
status: AT_MODE
poe_version: 2.1.1.19.3 (type1)
psus:
- name: Power Supply 0
status: ok
recovery_version: 21.4R3-S4.18
serial: JW3619300922
temperatures:
- celsius: 32
name: CPU Sensor
status: ok
- celsius: 29
name: PSU Sensor
status: ok
type: fpc
uboot_version: U-Boot 2016.01-rc1 (Nov 11 2016 - 14:26:00 -0800) 1.3.2
uptime: 27636720
vc_links:
- neighbor_module_idx: 0
neighbor_port_id: vcp-0/1/0
port_id: vcp-1/1/0
vc_mode: HiGiG
vc_role: backup
vc_state: present
version: 21.4R3-S4.18
model: EX2300-48P
num_routing_engines: 1
org_id: 1e9a61a9-bc42-42ca-bf67-1ad87443d9b8
serial: JW3619300157
site_id: ab0aca7a-d45c-469b-b3bb-4fe240642d0b
status: connected
type: switch
vc_mac: 52d9107af289
contentMediaType: application/json
examples:
Example:
value:
config_type: nonprovisioned
id: 00000000-0000-0000-1000-52d9107af289
mac: 52d9107af289
members:
- boot_partition: junos
cpld_version: '6'
cpu_stat:
idle: 69
interrupt: 1
load_avg:
- 0.8
- 1.09
- 1.07
system: 11
user: 19
fans:
- airflow: out
name: Fan Tray 0 Fan 0
rpm: 0
status: ok
- airflow: out
name: Fan Tray 1 Fan 0
rpm: 0
status: ok
fpc_idx: 0
mac: 52d9107af289
memory_stat:
usage: 42
model: EX2300-48P
pics:
- index: 0
model_number: EX2300-48P
port_groups:
- count: 48
type: GE
- index: 1
model_number: EX2300-48P
port_groups:
- count: 4
type: SFP/SFP+
poe:
max_power: 750
power_draw: 40.4
status: AT_MODE
poe_version: 2.1.1.19.3 (type1)
psus:
- name: Power Supply 0
status: ok
recovery_version: 21.4R3-S4.18
serial: JW0000000000
temperatures:
- celsius: 33
name: CPU Sensor
status: ok
- celsius: 29
name: PSU Sensor
status: ok
type: fpc
uboot_version: U-Boot 2016.01-rc1 (Nov 11 2016 - 14:26:00 -0800) 1.3.2
uptime: 27636720
vc_links:
- neighbor_module_idx: 1
neighbor_port_id: vcp-1/1/0
port_id: vcp-0/1/0
vc_mode: HiGiG
vc_role: master
vc_state: present
version: 21.4R3-S4.18
- boot_partition: junos
cpld_version: '6'
cpu_stat:
idle: 76
interrupt: 0
load_avg:
- 0.96
- 0.87
- 0.76
system: 6
user: 17
fans:
- airflow: out
name: Fan Tray 0 Fan 0
rpm: 0
status: ok
- airflow: out
name: Fan Tray 1 Fan 0
rpm: 0
status: ok
fpc_idx: 1
mac: d0dd4991652d
memory_stat:
usage: 18
model: EX2300-48P
pics:
- index: 0
model_number: EX2300-48P
port_groups:
- count: 48
type: GE
- index: 1
model_number: EX2300-48P
port_groups:
- count: 4
type: SFP/SFP+
poe:
max_power: 750
power_draw: 21.2
status: AT_MODE
poe_version: 2.1.1.19.3 (type1)
psus:
- name: Power Supply 0
status: ok
recovery_version: 21.4R3-S4.18
serial: JW3619300922
temperatures:
- celsius: 32
name: CPU Sensor
status: ok
- celsius: 29
name: PSU Sensor
status: ok
type: fpc
uboot_version: U-Boot 2016.01-rc1 (Nov 11 2016 - 14:26:00 -0800) 1.3.2
uptime: 27636720
vc_links:
- neighbor_module_idx: 0
neighbor_port_id: vcp-0/1/0
port_id: vcp-1/1/0
vc_mode: HiGiG
vc_role: backup
vc_state: present
version: 21.4R3-S4.18
model: EX2300-48P
num_routing_engines: 1
org_id: 1e9a61a9-bc42-42ca-bf67-1ad87443d9b8
serial: JW3619300157
site_id: ab0aca7a-d45c-469b-b3bb-4fe240642d0b
status: connected
type: switch
vc_mac: 52d9107af289
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_virtual_chassis_config'
- description: Combined virtual chassis status, topology, and member statistics
examples:
- config_type: nonprovisioned
id: 00000000-0000-0000-1000-52d9107af289
mac: 52d9107af289
members:
- boot_partition: junos
cpld_version: '6'
cpu_stat:
idle: 69
interrupt: 1
load_avg:
- 0.8
- 1.09
- 1.07
system: 11
user: 19
fans:
- airflow: out
name: Fan Tray 0 Fan 0
rpm: 0
status: ok
- airflow: out
name: Fan Tray 1 Fan 0
rpm: 0
status: ok
fpc_idx: 0
mac: 52d9107af289
memory_stat:
usage: 42
model: EX2300-48P
pics:
- index: 0
model_number: EX2300-48P
port_groups:
- count: 48
type: GE
- index: 1
model_number: EX2300-48P
port_groups:
- count: 4
type: SFP/SFP+
poe:
max_power: 750
power_draw: 40.4
status: AT_MODE
poe_version: 2.1.1.19.3 (type1)
psus:
- name: Power Supply 0
status: ok
recovery_version: 21.4R3-S4.18
serial: JW0000000000
temperatures:
- celsius: 33
name: CPU Sensor
status: ok
- celsius: 29
name: PSU Sensor
status: ok
type: fpc
uboot_version: U-Boot 2016.01-rc1 (Nov 11 2016 - 14:26:00 -0800) 1.3.2
uptime: 27636720
vc_links:
- neighbor_module_idx: 1
neighbor_port_id: vcp-1/1/0
port_id: vcp-0/1/0
vc_mode: HiGiG
vc_role: master
vc_state: present
version: 21.4R3-S4.18
- boot_partition: junos
cpld_version: '6'
cpu_stat:
idle: 76
interrupt: 0
load_avg:
- 0.96
- 0.87
- 0.76
system: 6
user: 17
fans:
- airflow: out
name: Fan Tray 0 Fan 0
rpm: 0
status: ok
- airflow: out
name: Fan Tray 1 Fan 0
rpm: 0
status: ok
fpc_idx: 1
mac: d0dd4991652d
memory_stat:
usage: 18
model: EX2300-48P
pics:
- index: 0
model_number: EX2300-48P
port_groups:
- count: 48
type: GE
- index: 1
model_number: EX2300-48P
port_groups:
- count: 4
type: SFP/SFP+
poe:
max_power: 750
power_draw: 21.2
status: AT_MODE
poe_version: 2.1.1.19.3 (type1)
psus:
- name: Power Supply 0
status: ok
recovery_version: 21.4R3-S4.18
serial: JW3619300922
temperatures:
- celsius: 32
name: CPU Sensor
status: ok
- celsius: 29
name: PSU Sensor
status: ok
type: fpc
uboot_version: U-Boot 2016.01-rc1 (Nov 11 2016 - 14:26:00 -0800) 1.3.2
uptime: 27636720
vc_links:
- neighbor_module_idx: 0
neighbor_port_id: vcp-0/1/0
port_id: vcp-1/1/0
vc_mode: HiGiG
vc_role: backup
vc_state: present
version: 21.4R3-S4.18
model: EX2300-48P
num_routing_engines: 1
org_id: 1e9a61a9-bc42-42ca-bf67-1ad87443d9b8
serial: JW3619300157
site_id: ab0aca7a-d45c-469b-b3bb-4fe240642d0b
status: connected
type: switch
vc_mac: 52d9107af289
contentMediaType: application/vnd.api+json
examples:
Example:
value:
config_type: nonprovisioned
id: 00000000-0000-0000-1000-52d9107af289
mac: 52d9107af289
members:
- boot_partition: junos
cpld_version: '6'
cpu_stat:
idle: 69
interrupt: 1
load_avg:
- 0.8
- 1.09
- 1.07
system: 11
user: 19
fans:
- airflow: out
name: Fan Tray 0 Fan 0
rpm: 0
status: ok
- airflow: out
name: Fan Tray 1 Fan 0
rpm: 0
status: ok
fpc_idx: 0
mac: 52d9107af289
memory_stat:
usage: 42
model: EX2300-48P
pics:
- index: 0
model_number: EX2300-48P
port_groups:
- count: 48
type: GE
- index: 1
model_number: EX2300-48P
port_groups:
- count: 4
type: SFP/SFP+
poe:
max_power: 750
power_draw: 40.4
status: AT_MODE
poe_version: 2.1.1.19.3 (type1)
psus:
- name: Power Supply 0
status: ok
recovery_version: 21.4R3-S4.18
serial: JW0000000000
temperatures:
- celsius: 33
name: CPU Sensor
status: ok
- celsius: 29
name: PSU Sensor
status: ok
type: fpc
uboot_version: U-Boot 2016.01-rc1 (Nov 11 2016 - 14:26:00 -0800) 1.3.2
uptime: 27636720
vc_links:
- neighbor_module_idx: 1
neighbor_port_id: vcp-1/1/0
port_id: vcp-0/1/0
vc_mode: HiGiG
vc_role: master
vc_state: present
version: 21.4R3-S4.18
- boot_partition: junos
cpld_version: '6'
cpu_stat:
idle: 76
interrupt: 0
load_avg:
- 0.96
- 0.87
- 0.76
system: 6
user: 17
fans:
- airflow: out
name: Fan Tray 0 Fan 0
rpm: 0
status: ok
- airflow: out
name: Fan Tray 1 Fan 0
rpm: 0
status: ok
fpc_idx: 1
mac: d0dd4991652d
memory_stat:
usage: 18
model: EX2300-48P
pics:
- index: 0
model_number: EX2300-48P
port_groups:
- count: 48
type: GE
- index: 1
model_number: EX2300-48P
port_groups:
- count: 4
type: SFP/SFP+
poe:
max_power: 750
power_draw: 21.2
status: AT_MODE
poe_version: 2.1.1.19.3 (type1)
psus:
- name: Power Supply 0
status: ok
recovery_version: 21.4R3-S4.18
serial: JW3619300922
temperatures:
- celsius: 32
name: CPU Sensor
status: ok
- celsius: 29
name: PSU Sensor
status: ok
type: fpc
uboot_version: U-Boot 2016.01-rc1 (Nov 11 2016 - 14:26:00 -0800) 1.3.2
uptime: 27636720
vc_links:
- neighbor_module_idx: 0
neighbor_port_id: vcp-0/1/0
port_id: vcp-1/1/0
vc_mode: HiGiG
vc_role: backup
vc_state: present
version: 21.4R3-S4.18
model: EX2300-48P
num_routing_engines: 1
org_id: 1e9a61a9-bc42-42ca-bf67-1ad87443d9b8
serial: JW3619300157
site_id: ab0aca7a-d45c-469b-b3bb-4fe240642d0b
status: connected
type: switch
vc_mac: 52d9107af289
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Sites Devices - Wired - Virtual Chassis
summary: createSiteVirtualChassis
description: "For models (e.g. EX3400 and up) having dedicated VC ports, it is easier to form a VC by just connecting cables with the dedicated VC ports. Cloud will detect the new VC and update the inventory. \nIn case that the user would like to choose the dedicated switch as a VC master or for EX2300-C-12P and EX2300-C-12T which doesn't have dedicated VC ports, below are procedures to automate the VC creation:\n1. Power on the switch that is chosen as the VC master first, and then powering on the other member switches.\n2. Claim or adopt all these switches under the same organization's Inventory\n3. Assign these switches into the same Site\n4. Wait for all the switches to be connected to Mist\n5. Invoke vc command on the switch chosen to be the VC master. For EX2300-C-12P, VC ports will be created automatically.\n6. Connect the cables to the VC ports for these switches\n7. Wait for the VC to be formed. The Org's inventory will be updated for the new VC."
operationId: createSiteVirtualChassis
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/virtual_chassis_config'
- description: Request Body
examples:
- '{"members":[{"mac":"aff827549235","vc_ports":["xe-0/1/0"],"vc_role":"master"},{"mac":"8396cd006c8c","vc_ports":["xe-0/1/0","xe-0/1/1"],"vc_role":"backup"},{"mac":"8396cd00888c","vc_ports":["xe-0/1/0"],"vc_role":"linecard"}]}'
- '{"members":[{"mac":"aff827549235","member_id":0,"vc_ports":["xe-0/1/0","xe-0/1/1"],"vc_role":"master"},{"mac":"8396cd006c8c","member_id":1,"vc_ports":["xe-0/1/0","xe-0/1/1"],"vc_role":"linecard"},{"mac":"8396cd00888c","member_id":2,"vc_ports":["xe-0/1/0","xe-0/1/1"],"vc_role":"backup"}],"preprovisioned":true}'
contentMediaType: application/json
examples:
create-a-VC-with-three-members:
value:
members:
- mac: aff827549235
vc_ports:
- xe-0/1/0
vc_role: master
- mac: 8396cd006c8c
vc_ports:
- xe-0/1/0
- xe-0/1/1
vc_role: backup
- mac: 8396cd00888c
vc_ports:
- xe-0/1/0
vc_role: linecard
create-a-pre-provisioned-VC-with-three-members:
value:
members:
- mac: aff827549235
member_id: 0
vc_ports:
- xe-0/1/0
- xe-0/1/1
vc_role: master
- mac: 8396cd006c8c
member_id: 1
vc_ports:
- xe-0/1/0
- xe-0/1/1
vc_role: linecard
- mac: 8396cd00888c
member_id: 2
vc_ports:
- xe-0/1/0
- xe-0/1/1
vc_role: backup
preprovisioned: true
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Sites Devices - Wired - Virtual Chassis
summary: updateSiteVirtualChassisMember
description: "The VC creation and adding member switch API will update the device' s virtual chassis config which is applied after VC is formed to create JUNOS pre-provisioned virtual chassis configuration.\n\n**Note:** Update Device's VC config can achieve similar purpose by directly modifying current virtual_chassis config. However, it cannot fulfill requests to enabling vc_ports on new members that are yet to belong to current VC.\n\n\n## Change to use preprovisioned VC\nTo switch the VC to use preprovisioned VC, enable preprovisioned in virtual_chassis config. Both vc_role master and backup will be matched to routing-engine role in Junos preprovisioned VC config.\n\nIn this config, fpc0 has to be the same as the mac of device_id. Use renumber if you want to replace fpc0 which involves device_id change.\n\n**Notice:** to configure preprovisioned VC, every member of the VC must be in the inventory.\n\n## Add new members\nFor models (e.g. EX4300 and up) having dedicated VC ports, it is easier to add new member switches into a VC by just connecting cables with the dedicated VC ports. Cloud will detect the new members and update the inventory.\n\nFor EX2300 VC, adding new members requires to follow the procedures below:\n1. Powering on the new member switches and ensuring cables are not connected to any VC ports.\n2. Claim or adopt all new member switches under the VC's organization Inventory\n3. Assign all new member switches to the same Site as the VC\n4. Invoke vc command to add switches to the VC.\n5. Connect the cables to the VC ports for these switches\n6. After a while, the Org's Inventory shows that new switches has been added into the VC.\n\n## Removing member switch\nTo remove a member switch from the VC, following the procedures below:\n\n1. Ensuring the VC is connected to the cloud first\n2. Unplug the cable from the VC port of the switch\n3. Waiting for the VC state (vc_state) of this switch is changed to not-present\n4. Invoke update_vc with remove to remove this switch from the VC\n5. The Org's Inventory shows the switch is removed.\n\nPlease notice that member ID 0 (fpc0) cannot be removed. When a VC has two switches left, unplugging the cable may result in the situation that fpc0 becomes a line card (LC). When this situation is happening, please re-plug in the cable, wait for both switches becoming present (show virtual-chassis) and then removing the cable again.\n\n## Renumber a member switch\nWhen a member switch doesn' t work properly and needed to be replaced, the renumber API could be used. The following two types of renumber are supported:\n\n1. Replace a non-fpc0 member switch\n2. Replace fpc0. When fpc0 is replaced, PAPI device config and JUNOS config will be both updated.\n\nFor renumber to work, the following procedures are needed: \n1. Ensuring the VC is connected to the cloud and the state of the member switch to be replaced must be non present. \n2. Adding the new member switch to the VC \n3. Waiting for the VC state (vc_state) of this VC to be updated to API server \n4. Invoke vc with renumber to replace\\ the new member switch from fpc X to\n\n## Perprovision VC members\nBy specifying \"preprovision\" op, you can convert the current VC to pre-provisioned mode, update VC members as well as specify vc_ports when adding new members for device models without dedicated vc ports. Use renumber for fpc0 replacement which involves device_id change.\n\nNote: \n1. vc_ports is used for adding new members and not needed if \n * the device model has dedicated vc ports, or \n * no new member is added \n2. New VC members to be added should exist in the same Site as the VC"
operationId: updateSiteVirtualChassisMember
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/virtual_chassis_update'
- description: Request Body
examples:
- '{"members":[{"mac":"aff827549235","member_id":2,"vc_ports":["xe-0/1/0","xe-0/1/1"],"vc_role":"linecard"},{"mac":"8396cd00777c","member_id":3,"vc_ports":["xe-0/1/0","xe-0/1/1"],"vc_role":"linecard"}],"op":"add"}'
- '{"members":[{"mac":"aff827549235","member_id":0,"vc_ports":["xe-0/1/0","xe-0/1/1"]},{"mac":"8396cd00777c","member_id":1,"vc_ports":["xe-0/1/0","xe-0/1/1"],"vc_role":"backup"}],"op":"preprovision"}'
- '{"members":[{"mac":"aff827549235","member_id":0,"vc_role":"master"},{"mac":"8396cd006c8c","member_id":1,"vc_role":"linecard"}],"op":"preprovision","remove_inventory":true}'
- '{"members":[{"member":2},{"member":3}],"op":"remove"}'
- '{"member":3,"new-member":2,"op":"renumber"}'
contentMediaType: application/json
examples:
adding-two-new-switches-as-line-cards-into-the-VC:
value:
members:
- mac: aff827549235
member_id: 2
vc_ports:
- xe-0/1/0
- xe-0/1/1
vc_role: linecard
- mac: 8396cd00777c
member_id: 3
vc_ports:
- xe-0/1/0
- xe-0/1/1
vc_role: linecard
op: add
convert-to-pre-provisioned-VC:
value:
members:
- mac: aff827549235
member_id: 0
vc_ports:
- xe-0/1/0
- xe-0/1/1
- mac: 8396cd00777c
member_id: 1
vc_ports:
- xe-0/1/0
- xe-0/1/1
vc_role: backup
op: preprovision
remove-preprovision-members-and-clean-up-inventory:
value:
members:
- mac: aff827549235
member_id: 0
vc_role: master
- mac: 8396cd006c8c
member_id: 1
vc_role: linecard
op: preprovision
remove_inventory: true
removing-two-switches-from-VC:
value:
members:
- member: 2
- member: 3
op: remove
renumber-member-ID-3-to-member-ID-2:
value:
member: 3
new-member: 2
op: renumber
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/vc/convert_to_virtualmac:
post:
tags:
- Sites Devices - Wired - Virtual Chassis
summary: convertSiteVirtualChassisToVirtualMac
description: >-
Converts an FPC0-based VC to a Virtualmac VC, removing the limitation where the device ID must change whenever FPC0 is renumbered or removed.
HTTP400 Error possible reasons:
- The device is not an OC device
- Virtualmac VC is disabled in the Org Knob settings
- The VC is already a Virtualmac VC
- The VC is currently disconnected
- The device is standalone
- A new FPC0 exists with its own device config, causing ambiguity.
operationId: convertSiteVirtualChassisToVirtualMac
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/vc/vc_port:
post:
tags:
- Sites Devices - Wired - Virtual Chassis
summary: setSiteVcPort
description: Set VC port
operationId: setSiteVcPort
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/virtual_chassis_port'
- examples:
- '{"members":[{"member":0,"vc_ports":["xe-0/1/1"]},{"member":2,"vc_ports":["xe-0/1/1"]}],"op":"delete"}'
- '{"members":[{"member":0,"vc_ports":["xe-0/1/1"]},{"member":2,"vc_ports":["xe-0/1/1"]}],"op":"set"}'
contentMediaType: application/json
examples:
delete-VC-port-of-xe-0/1/1-of-member-0-and-member-2:
value:
members:
- member: 0
vc_ports:
- xe-0/1/1
- member: 2
vc_ports:
- xe-0/1/1
op: delete
set-VC-port-of-xe-0/1/1-of-member-0-and-member-2:
value:
members:
- member: 0
vc_ports:
- xe-0/1/1
- member: 2
vc_ports:
- xe-0/1/1
op: set
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/ha:
delete:
tags:
- Sites Devices - WAN Cluster
summary: deleteSiteDeviceHaCluster
description: Delete HA Cluster
operationId: deleteSiteDeviceHaCluster
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Sites Devices - WAN Cluster
summary: GetSiteDeviceHaClusterNode
description: Delete HA Cluster
operationId: GetSiteDeviceHaClusterNode
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: Ok
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/gateway_cluster'
- description: Gateway HA cluster request or response body
examples:
- nodes:
- mac: aff827549235
- mac: 8396cd006c8c
contentMediaType: application/json
examples:
Gateway Cluster:
value:
nodes:
- mac: aff827549235
- mac: 8396cd006c8c
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/gateway_cluster'
- description: Gateway HA cluster request or response body
examples:
- nodes:
- mac: aff827549235
- mac: 8396cd006c8c
contentMediaType: application/vnd.api+json
examples:
Gateway Cluster:
value:
nodes:
- mac: aff827549235
- mac: 8396cd006c8c
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Sites Devices - WAN Cluster
summary: createSiteDeviceHaCluster
description: "## Create HA Cluster\nBoth nodes has to be in the same site. We expect the user to configure ha_sync / ha_data port in port_configs already\n\n### SRX cabling\n\nsee [Chassis Cluster User Guide for SRX Series Devices](https://www.juniper.net/documentation/us/en/software/junos/chassis-cluster-security-devices/topics/concept/chassis-cluster-srx-series-node-interface-understanding.html) Here’s the recommended cabling.\n\n#### SRX300\n\nFrom ZTP / default state, ge-0/0/0 and ge-0/0/7 (SFP) are default WAN ports and will get DHCP IP. However, ge-0/0/0 becomes OOB/fxp0 after cluster is enabled (i.e. using it for reach Mist is not recommended)\n\n1. form cluster in UI\n2. configure ge-0/0/7,ge-1/0/7 for WAN (reth0)\n3. configure ge-0/0/2,ge-1/0/2 for ha_data\n4. configure ge-0/0/3- for LAN or additional WAN e.g.\n \n\n``` json\n{\n \"port_config\": {\n \"ge-0/0/2,ge-1/0/2\": {\n \"usage\": \"ha_data\"\n },\n \"ge-0/0/7,ge-1/0/7\": {\n \"usage\": \"wan\",\n \"redundant\": true,\n \"reth_idx\": 0,\n \"ip_config\": {\"type\": \"dhcp\"}\n },\n }\n}\n\n```\n\n1. connect ge-0/0/1 back to back for ha_control\n2. connect ge-0/0/2 back to back for ha_data\n3. connect both ge-0/0/7 to uplink switch to WAN and to reach Mist\n4. power up both devices\n5. it takes about 30 minutes for the cluster to form\n \n\n#### SRX320\n\nFrom ZTP / default state, ge-0/0/0, ge-0/0/7 (SFP) and cl-1/0/0 (LTE) are default WAN ports and will get DHCP IP. However, ge-0/0/0 becomes OOB/fxp0 after cluster is enabled (i.e. using it for reach Mist is not recommended)\n\n##### ZTP via ge-0/0/7\n\nSimilar to SRX300\n\n##### ZTP via cl-1/0/0 (LTE)\n\n1. form cluster in UI\n2. configure cl-1/0/0, cl-3/0/0 as WAN (reth0)\n3. configure ge-0/0/2,ge-3/0/2 for ha_data\n4. same as above\n \n\n#### SRX340 / SRX345 / SRX380\n\nSRX340/SRX345 has dedicated OOB/fxp0 ports\n\n1. form cluster in UI\n2. configure ge-0/0/0,ge-5/0/0 for WAN (reth0)\n3. configure ge-0/0/2,ge-5/0/2 for ha_data\n4. configure ge-0/0/3- for LAN or additional WAN\n5. connect ge-0/0/0 to uplink switch to WAN and to reach Mist\n6. connect ge-0/0/1 back-to-back for ha_control\n7. connect ge-0/0/2 back-to-back for ha_data (fabric); or for SRX380, xe-0/0/16 if 10G SFP+ is used\n8. connect ge-0/0/3- to LAN or additional WANs\n \n\n#### SRX550\n\nge-0/0/0 becomes OOB/fxp0 after cluster is enabled, make enable oob_ip_config as dhcp to maintain cloud connectivity\n\n1. connect ge-0/0/0 to reach Mist (after cluster is fully up, this port becomes OOB/fxp0)\n2. connect ge-0/0/1 back-to-back for ha_control\n3. connect ge-0/0/2 back-to-back for ha_data (fabric)\n4. connect ge-0/0/3 to WAN (after cluster is up, intended to be used for reth0)\n5. connect ge-0/0/4- to LAN or additional WANs\n \n\n#### SRX1500\n\nSRX1500 has, additionally, dedicated HA Control port\n\n1. form cluster in UI\n2. configure ge-0/0/0,ge-5/0/0 for WAN (reth0)\n3. configure ge-0/0/1,ge-5/0/1 for ha_data\n4. configure ge-0/0/2- for LAN or additional WAN\n5. connect dedicated ha_control back-to-back\n6. connect ge-0/0/0 to uplink switch to WAN and to reach Mist\n7. connect ge-0/0/1 back-to-back for ha_data\n8. connect ge-0/0/2- to LAN or additional WANs\n \n\n#### SRX4100\n\nSRX4100 has dedicated ha_control and ha_data (fabric) ports\n\n1. connect dedicated ha_control back-to-back\n2. connect dedicated ha_data back-to-back\n3. connect xe-0/0/0 to WAN to reach Mist\n4. connect xe-0/0/1- to LAN or additional WANs\n \n\n#### VSRX\n\nWhen standalone, VSRX has fxp0 as first Network Adapter, then ge-0/0/0-N When clustered, VSRX has fxp0, em0, then ge-0/0/0-N\n\n1. connect net0 (fxp0) to WAN to reach Mist\n2. connect net1 back-to-back for ha_control\n3. connect net2 (ge-0/0/0) back-to-back for ha_data (fab0/fab1)\n4. connect net3 (ge-0/0/1) to WAN, intended to be used for reth0\n5. connect net4 (ge-0/0/2) to LAN\n \n\nSRX340/SRX345 has dedicated OOB/fxp0 ports VSRX has fxp0 as first Network Adapter, then ge-0/0/0-N\n\n1. connect ge-0/0/0 to WAN to reach Mist\n2. connect ge-0/0/1 back-to-back for ha_control\n3. connect ge-0/0/2 back-to-back for ha_data (fabric); or for SRX380, xe-0/0/16 if 10G SFP+ is used\n4. connect ge-0/0/3- to LAN or additional WANs\n \n\n#### SRX550\n\nge-0/0/0 becomes OOB/fxp0 after cluster is enabled, make enable oob_ip_config as dhcp to maintain cloud connectivity\n\n1. connect ge-0/0/0 to reach Mist (after cluster is fully up, this port becomes OOB/fxp0)\n2. connect ge-0/0/1 back-to-back for ha_control\n3. connect ge-0/0/2 back-to-back for ha_data (fabric)\n4. connect ge-0/0/3 to WAN (after cluster is up, intended to be used for reth0)\n5. connect ge-0/0/4- to LAN or additional WANs\n \n\n#### SRX1500\n\nSRX1500 has, additionally, dedicated HA Control port\n\n1. form cluster in UI\n2. configure ge-0/0/0,ge-7/0/0 for WAN (reth0)\n3. configure ge-0/0/1,ge-7/0/1 for ha_data\n4. configure ge-0/0/2- for LAN or additional WAN\n5. connect dedicated ha_control back-to-back\n6. connect ge-0/0/0 to uplink switch to WAN and to reach Mist\n7. connect ge-0/0/1 back-to-back for ha_data\n8. connect ge-0/0/2- to LAN or additional WANs\n\n \n#### SRX1600\n\nSRX1600 has, additionally, two dedicated HA Control port\n\n1. form cluster in UI\n2. configure ge-0/0/0,ge-7/0/0 for WAN (reth0)\n3. configure ge-0/0/1,ge-7/0/1 for ha_data\n4. configure ge-0/0/2- for LAN or additional WAN\n5. connect dedicated both ha_control back-to-back\n6. connect ge-0/0/0 to uplink switch to WAN and to reach Mist\n7. connect ge-0/0/1 back-to-back for ha_data\n8. connect ge-0/0/2- to LAN or additional WANs\n\n\n#### SRX4100\n\nSRX4100 has dedicated ha_control and ha_data (fabric) ports\n\n1. connect dedicated ha_control back-to-back\n2. connect dedicated ha_data back-to-back\n3. connect xe-0/0/0 to WAN to reach Mist\n4. connect xe-0/0/1- to LAN or additional WANs\n\n\n## Replace a Node in a HA Cluster\nUsually Device Replacement is done by Device Replacement API. For a HA cluster, you can also replace a node by another device in the same site."
operationId: createSiteDeviceHaCluster
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/gateway_cluster'
- examples:
- nodes:
- mac: aff827549235
- mac: 8396cd006c8c
contentMediaType: application/json
examples:
Example:
value:
nodes:
- mac: aff827549235
- mac: 8396cd006c8c
required: false
responses:
'200':
description: Ok
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/gateway_cluster'
- description: Gateway HA cluster request or response body
examples:
- nodes:
- mac: aff827549235
- mac: 8396cd006c8c
contentMediaType: application/json
examples:
Gateway Cluster:
value:
nodes:
- mac: aff827549235
- mac: 8396cd006c8c
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/gateway_cluster'
- description: Gateway HA cluster request or response body
examples:
- nodes:
- mac: aff827549235
- mac: 8396cd006c8c
contentMediaType: application/vnd.api+json
examples:
Gateway Cluster:
value:
nodes:
- mac: aff827549235
- mac: 8396cd006c8c
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/deviceprofiles/derived:
get:
tags:
- Sites Device Profiles
summary: listSiteDeviceProfilesDerived
description: Get the list of derived Device Profiles for a Site
operationId: listSiteDeviceProfilesDerived
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: resolve
in: query
description: Whether resolve the site variables
style: form
explode: true
schema:
type: boolean
default: false
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/deviceprofile'
description: List of device profile configurations
examples:
- '[{"aeroscout":{"enabled":true,"host":"string"},"created_time":0,"disable_eth1":true,"disable_module":true,"id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","ip_config":{"dns":["string"],"dns_suffix":["string"],"gateway":"192.168.0.1","gateway6":"2001:0db8:85a3:0000:0000:8a2e:0370:7334","ip":"192.168.0.1","ip6":"2001:0db8:85a3:0000:0000:8a2e:0370:7334","mtu":1500,"netmask":"192.168.0.1","netmask6":"2001:0db8:85a3:0000:0000:8a2e:0370:7334","type":"static","type6":"static","vlan_id":1},"mesh":{"enabled":true,"group":1,"role":"base"},"modified_time":0,"name":"string","org_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","poe_passthrough":true,"switch_config":{"enabled":true,"eth0":{"port_vlan_id":1,"vlan_ids":[1,10]},"eth1":{"port_vlan_id":1,"vlan_ids":[10]},"eth2":{"port_vlan_id":1,"vlan_ids":[10]},"eth3":{"port_vlan_id":1,"vlan_ids":[10]},"module":{"port_vlan_id":1,"vlan_ids":[10]},"wds":{"port_vlan_id":1,"vlan_ids":[10]}},"type":"ap","usb_config":{"cacert":"string","enabled":true,"host":"string","type":"imagotag","verify_cert":true}}]'
- '[{"created_time":1680762730,"dhcpd_config":{"Corp-Mgmt":{"dns_servers":["8.8.8.8"],"dns_suffix":["stag.one"],"gateway":"10.3.172.9","ip_end":"10.3.172.99","ip_start":"10.3.172.50","type":"local"},"Corp-lan":{"dns_servers":["8.8.8.8"],"dns_suffix":["stag.one"],"gateway":"10.3.171.9","ip_end":"10.3.171.99","ip_start":"10.3.171.50","type":"local"}},"dnsOverride":true,"dns_servers":["10.3.20.201","10.3.51.222","1.1.1.1"],"dns_suffix":["example.com"],"extra_routes":{"10.101.0.0/16":{"via":"10.3.100.10"}},"id":"4ea55b5d-7313-4a81-a292-7ee125fd4ebb","ip_configs":{"Corp-Core":{"ip":"10.3.100.9","netmask":"/24","type":"static"},"Corp-Mgmt":{"ip":"10.3.172.9","netmask":"/24","type":"static"},"Corp-lan":{"ip":"10.3.171.9","netmask":"/24","type":"static"}},"modified_time":1680762890,"name":"ITParis","ntpOverride":true,"ntp_servers":["10.3.51.222"],"org_id":"93986f10-773b-42be-9438-8d3e6d127f1a","path_preferences":{"core":{"paths":[{"networks":["Corp-Core"],"type":"local"}],"strategy":"ordered"},"lab":{"paths":[{"networks":["Corp-lan"],"type":"local"}],"strategy":"ordered"},"mgmt":{"paths":[{"networks":["Corp-Mgmt"],"type":"local"}],"strategy":"ordered"},"untrust":{"paths":[{"name":"wan","type":"wan"}],"strategy":"ordered"}},"port_config":{"ge-0/0/0":{"aggregated":false,"ip_config":{"gateway":"192.168.1.1","ip":"192.168.1.9","netmask":"/24","type":"static"},"name":"wan","redundant":false,"traffic_shaping":{"enabled":false},"usage":"wan","wan_type":"broadband"},"ge-0/0/6-7":{"ae_disable_lacp":false,"ae_idx":"0","ae_lacp_force_up":true,"aggregated":true,"networks":["Corp-lan","Corp-Mgmt","Corp-Core"],"usage":"lan"}},"service_policies":[{"action":"allow","idp":{"enabled":false},"name":"ITParis-Internal","path_preference":"core","services":["internal_dns","drive"],"tenants":["ITParis"]},{"action":"deny","idp":{"enabled":false},"name":"ITParis-internet","path_preference":"untrust","services":["internet_any"],"tenants":["ITParis"]}],"type":"gateway"}]'
contentMediaType: application/json
examples:
Deviceprofile Ap:
value:
- aeroscout:
enabled: true
host: string
created_time: 0
disable_eth1: true
disable_module: true
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ip_config:
dns:
- string
dns_suffix:
- string
gateway: 192.168.0.1
gateway6: 2001:0db8:85a3:0000:0000:8a2e:0370:7334
ip: 192.168.0.1
ip6: 2001:0db8:85a3:0000:0000:8a2e:0370:7334
mtu: 1500
netmask: 192.168.0.1
netmask6: 2001:0db8:85a3:0000:0000:8a2e:0370:7334
type: static
type6: static
vlan_id: 1
mesh:
enabled: true
group: 1
role: base
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
poe_passthrough: true
switch_config:
enabled: true
eth0:
port_vlan_id: 1
vlan_ids:
- 1
- 10
eth1:
port_vlan_id: 1
vlan_ids:
- 10
eth2:
port_vlan_id: 1
vlan_ids:
- 10
eth3:
port_vlan_id: 1
vlan_ids:
- 10
module:
port_vlan_id: 1
vlan_ids:
- 10
wds:
port_vlan_id: 1
vlan_ids:
- 10
type: ap
usb_config:
cacert: string
enabled: true
host: string
type: imagotag
verify_cert: true
Deviceprofile Hub:
value:
- created_time: 1680762730
dhcpd_config:
Corp-Mgmt:
dns_servers:
- 8.8.8.8
dns_suffix:
- stag.one
gateway: 10.3.172.9
ip_end: 10.3.172.99
ip_start: 10.3.172.50
type: local
Corp-lan:
dns_servers:
- 8.8.8.8
dns_suffix:
- stag.one
gateway: 10.3.171.9
ip_end: 10.3.171.99
ip_start: 10.3.171.50
type: local
dnsOverride: true
dns_servers:
- 10.3.20.201
- 10.3.51.222
- 1.1.1.1
dns_suffix:
- example.com
extra_routes:
10.101.0.0/16:
via: 10.3.100.10
id: 4ea55b5d-7313-4a81-a292-7ee125fd4ebb
ip_configs:
Corp-Core:
ip: 10.3.100.9
netmask: /24
type: static
Corp-Mgmt:
ip: 10.3.172.9
netmask: /24
type: static
Corp-lan:
ip: 10.3.171.9
netmask: /24
type: static
modified_time: 1680762890
name: ITParis
ntpOverride: true
ntp_servers:
- 10.3.51.222
org_id: 93986f10-773b-42be-9438-8d3e6d127f1a
path_preferences:
core:
paths:
- networks:
- Corp-Core
type: local
strategy: ordered
lab:
paths:
- networks:
- Corp-lan
type: local
strategy: ordered
mgmt:
paths:
- networks:
- Corp-Mgmt
type: local
strategy: ordered
untrust:
paths:
- name: wan
type: wan
strategy: ordered
port_config:
ge-0/0/0:
aggregated: false
ip_config:
gateway: 192.168.1.1
ip: 192.168.1.9
netmask: /24
type: static
name: wan
redundant: false
traffic_shaping:
enabled: false
usage: wan
wan_type: broadband
ge-0/0/6-7:
ae_disable_lacp: false
ae_idx: '0'
ae_lacp_force_up: true
aggregated: true
networks:
- Corp-lan
- Corp-Mgmt
- Corp-Core
usage: lan
service_policies:
- action: allow
idp:
enabled: false
name: ITParis-Internal
path_preference: core
services:
- internal_dns
- drive
tenants:
- ITParis
- action: deny
idp:
enabled: false
name: ITParis-internet
path_preference: untrust
services:
- internet_any
tenants:
- ITParis
type: gateway
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/deviceprofile'
description: List of device profile configurations
examples:
- '[{"aeroscout":{"enabled":true,"host":"string"},"created_time":0,"disable_eth1":true,"disable_module":true,"id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","ip_config":{"dns":["string"],"dns_suffix":["string"],"gateway":"192.168.0.1","gateway6":"2001:0db8:85a3:0000:0000:8a2e:0370:7334","ip":"192.168.0.1","ip6":"2001:0db8:85a3:0000:0000:8a2e:0370:7334","mtu":1500,"netmask":"192.168.0.1","netmask6":"2001:0db8:85a3:0000:0000:8a2e:0370:7334","type":"static","type6":"static","vlan_id":1},"mesh":{"enabled":true,"group":1,"role":"base"},"modified_time":0,"name":"string","org_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","poe_passthrough":true,"switch_config":{"enabled":true,"eth0":{"port_vlan_id":1,"vlan_ids":[1,10]},"eth1":{"port_vlan_id":1,"vlan_ids":[10]},"eth2":{"port_vlan_id":1,"vlan_ids":[10]},"eth3":{"port_vlan_id":1,"vlan_ids":[10]},"module":{"port_vlan_id":1,"vlan_ids":[10]},"wds":{"port_vlan_id":1,"vlan_ids":[10]}},"type":"ap","usb_config":{"cacert":"string","enabled":true,"host":"string","type":"imagotag","verify_cert":true}}]'
- '[{"created_time":1680762730,"dhcpd_config":{"Corp-Mgmt":{"dns_servers":["8.8.8.8"],"dns_suffix":["stag.one"],"gateway":"10.3.172.9","ip_end":"10.3.172.99","ip_start":"10.3.172.50","type":"local"},"Corp-lan":{"dns_servers":["8.8.8.8"],"dns_suffix":["stag.one"],"gateway":"10.3.171.9","ip_end":"10.3.171.99","ip_start":"10.3.171.50","type":"local"}},"dnsOverride":true,"dns_servers":["10.3.20.201","10.3.51.222","1.1.1.1"],"dns_suffix":["example.com"],"extra_routes":{"10.101.0.0/16":{"via":"10.3.100.10"}},"id":"4ea55b5d-7313-4a81-a292-7ee125fd4ebb","ip_configs":{"Corp-Core":{"ip":"10.3.100.9","netmask":"/24","type":"static"},"Corp-Mgmt":{"ip":"10.3.172.9","netmask":"/24","type":"static"},"Corp-lan":{"ip":"10.3.171.9","netmask":"/24","type":"static"}},"modified_time":1680762890,"name":"ITParis","ntpOverride":true,"ntp_servers":["10.3.51.222"],"org_id":"93986f10-773b-42be-9438-8d3e6d127f1a","path_preferences":{"core":{"paths":[{"networks":["Corp-Core"],"type":"local"}],"strategy":"ordered"},"lab":{"paths":[{"networks":["Corp-lan"],"type":"local"}],"strategy":"ordered"},"mgmt":{"paths":[{"networks":["Corp-Mgmt"],"type":"local"}],"strategy":"ordered"},"untrust":{"paths":[{"name":"wan","type":"wan"}],"strategy":"ordered"}},"port_config":{"ge-0/0/0":{"aggregated":false,"ip_config":{"gateway":"192.168.1.1","ip":"192.168.1.9","netmask":"/24","type":"static"},"name":"wan","redundant":false,"traffic_shaping":{"enabled":false},"usage":"wan","wan_type":"broadband"},"ge-0/0/6-7":{"ae_disable_lacp":false,"ae_idx":"0","ae_lacp_force_up":true,"aggregated":true,"networks":["Corp-lan","Corp-Mgmt","Corp-Core"],"usage":"lan"}},"service_policies":[{"action":"allow","idp":{"enabled":false},"name":"ITParis-Internal","path_preference":"core","services":["internal_dns","drive"],"tenants":["ITParis"]},{"action":"deny","idp":{"enabled":false},"name":"ITParis-internet","path_preference":"untrust","services":["internet_any"],"tenants":["ITParis"]}],"type":"gateway"}]'
contentMediaType: application/vnd.api+json
examples:
Deviceprofile Ap:
value:
- aeroscout:
enabled: true
host: string
created_time: 0
disable_eth1: true
disable_module: true
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ip_config:
dns:
- string
dns_suffix:
- string
gateway: 192.168.0.1
gateway6: 2001:0db8:85a3:0000:0000:8a2e:0370:7334
ip: 192.168.0.1
ip6: 2001:0db8:85a3:0000:0000:8a2e:0370:7334
mtu: 1500
netmask: 192.168.0.1
netmask6: 2001:0db8:85a3:0000:0000:8a2e:0370:7334
type: static
type6: static
vlan_id: 1
mesh:
enabled: true
group: 1
role: base
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
poe_passthrough: true
switch_config:
enabled: true
eth0:
port_vlan_id: 1
vlan_ids:
- 1
- 10
eth1:
port_vlan_id: 1
vlan_ids:
- 10
eth2:
port_vlan_id: 1
vlan_ids:
- 10
eth3:
port_vlan_id: 1
vlan_ids:
- 10
module:
port_vlan_id: 1
vlan_ids:
- 10
wds:
port_vlan_id: 1
vlan_ids:
- 10
type: ap
usb_config:
cacert: string
enabled: true
host: string
type: imagotag
verify_cert: true
Deviceprofile Hub:
value:
- created_time: 1680762730
dhcpd_config:
Corp-Mgmt:
dns_servers:
- 8.8.8.8
dns_suffix:
- stag.one
gateway: 10.3.172.9
ip_end: 10.3.172.99
ip_start: 10.3.172.50
type: local
Corp-lan:
dns_servers:
- 8.8.8.8
dns_suffix:
- stag.one
gateway: 10.3.171.9
ip_end: 10.3.171.99
ip_start: 10.3.171.50
type: local
dnsOverride: true
dns_servers:
- 10.3.20.201
- 10.3.51.222
- 1.1.1.1
dns_suffix:
- example.com
extra_routes:
10.101.0.0/16:
via: 10.3.100.10
id: 4ea55b5d-7313-4a81-a292-7ee125fd4ebb
ip_configs:
Corp-Core:
ip: 10.3.100.9
netmask: /24
type: static
Corp-Mgmt:
ip: 10.3.172.9
netmask: /24
type: static
Corp-lan:
ip: 10.3.171.9
netmask: /24
type: static
modified_time: 1680762890
name: ITParis
ntpOverride: true
ntp_servers:
- 10.3.51.222
org_id: 93986f10-773b-42be-9438-8d3e6d127f1a
path_preferences:
core:
paths:
- networks:
- Corp-Core
type: local
strategy: ordered
lab:
paths:
- networks:
- Corp-lan
type: local
strategy: ordered
mgmt:
paths:
- networks:
- Corp-Mgmt
type: local
strategy: ordered
untrust:
paths:
- name: wan
type: wan
strategy: ordered
port_config:
ge-0/0/0:
aggregated: false
ip_config:
gateway: 192.168.1.1
ip: 192.168.1.9
netmask: /24
type: static
name: wan
redundant: false
traffic_shaping:
enabled: false
usage: wan
wan_type: broadband
ge-0/0/6-7:
ae_disable_lacp: false
ae_idx: '0'
ae_lacp_force_up: true
aggregated: true
networks:
- Corp-lan
- Corp-Mgmt
- Corp-Core
usage: lan
service_policies:
- action: allow
idp:
enabled: false
name: ITParis-Internal
path_preference: core
services:
- internal_dns
- drive
tenants:
- ITParis
- action: deny
idp:
enabled: false
name: ITParis-internet
path_preference: untrust
services:
- internet_any
tenants:
- ITParis
type: gateway
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/events/search:
get:
tags:
- Orgs Events
summary: searchOrgEvents
description: >-
Search Org events
Supported Event Types:
- CRADLEPOINT_SYNC_FAILED
- ORG_CA_CERT_ADDED
- ORG_CA_CERT_REGENERATED
operationId: searchOrgEvents
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: type
in: query
description: Filter results by type. Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- CRADLEPOINT_MAINTENANCE_COMPLETED,CRADLEPOINT_MAINTENANCE_STARTED
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_events_orgs_search'
- description: Paginated response for organization event search results
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_events_orgs_search'
- description: Paginated response for organization event search results
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/events/system/count:
get:
tags:
- Orgs Events
summary: countOrgSystemEvents
description: Count organization system event records, optionally grouped by `distinct` and filtered by time range.
operationId: countOrgSystemEvents
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: Field used to group this count response
style: form
explode: true
schema:
type: string
examples:
- site_id
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/events/system/search:
get:
tags:
- Orgs Events
summary: searchOrgSystemEvents
description: Search organization system event records with time range, sorting, and pagination controls.
operationId: searchOrgSystemEvents
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_org_system_events_search'
- description: Paginated response for organization system event search results
examples:
- end: 1741312800
limit: 1000
results:
- change_cat: admin_action
metadata: '{"\wlan_id\": \"None\",\"admin_name\": \"API Automation api_automation@mistsys.com\",\"desc\": \"Delete WLAN \\"Automation Test\\"\"}'
org_id: 268e599f-5379-473f-b18b-4384e9b3f244
scope: org
site_id: dc47920f-52d5-499c-af72-dcd646764f84
timestamp: 1741309621
type: delete-wlan
- change_cat: admin_action
metadata: '{\"wlan_id\": \"3855dc19-63fb-4490-b113-0176dc1cc8f4\",\"admin_name\": \"API Automation api_automation@mistsys.com\",\"desc\": \"Add WLAN \\"Automation Test\\"\"}'
org_id: 268e599f-5379-473f-b18b-4384e9b3f244
scope: org
site_id: dc47920f-52d5-499c-af72-dcd646764f84
timestamp: 1741309601
type: add-wlan
- change_cat: admin_action
metadata: '{\"template_id\": \"7e49acf4-6841-4e56-ad7d-68d0801cbba8\",\"admin_name\": \"API Automation api_automation@mistsys.com\",\"desc\": \"Add Template \\"Automation template\\"\"}'
org_id: 268e599f-5379-473f-b18b-4384e9b3f244
scope: org
timestamp: 1741309280
type: add-template
start: 1741309200
total: 3
contentMediaType: application/json
examples:
Example:
value:
end: 1741312800
limit: 1000
results:
- change_cat: admin_action
metadata: '{"\wlan_id\": \"None\",\"admin_name\": \"API Automation api_automation@mistsys.com\",\"desc\": \"Delete WLAN \\"Automation Test\\"\"}'
org_id: 268e599f-5379-473f-b18b-4384e9b3f244
scope: org
site_id: dc47920f-52d5-499c-af72-dcd646764f84
timestamp: 1741309621
type: delete-wlan
- change_cat: admin_action
metadata: '{\"wlan_id\": \"3855dc19-63fb-4490-b113-0176dc1cc8f4\",\"admin_name\": \"API Automation api_automation@mistsys.com\",\"desc\": \"Add WLAN \\"Automation Test\\"\"}'
org_id: 268e599f-5379-473f-b18b-4384e9b3f244
scope: org
site_id: dc47920f-52d5-499c-af72-dcd646764f84
timestamp: 1741309601
type: add-wlan
- change_cat: admin_action
metadata: '{\"template_id\": \"7e49acf4-6841-4e56-ad7d-68d0801cbba8\",\"admin_name\": \"API Automation api_automation@mistsys.com\",\"desc\": \"Add Template \\"Automation template\\"\"}'
org_id: 268e599f-5379-473f-b18b-4384e9b3f244
scope: org
timestamp: 1741309280
type: add-template
start: 1741309200
total: 3
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_org_system_events_search'
- description: Paginated response for organization system event search results
examples:
- end: 1741312800
limit: 1000
results:
- change_cat: admin_action
metadata: '{"\wlan_id\": \"None\",\"admin_name\": \"API Automation api_automation@mistsys.com\",\"desc\": \"Delete WLAN \\"Automation Test\\"\"}'
org_id: 268e599f-5379-473f-b18b-4384e9b3f244
scope: org
site_id: dc47920f-52d5-499c-af72-dcd646764f84
timestamp: 1741309621
type: delete-wlan
- change_cat: admin_action
metadata: '{\"wlan_id\": \"3855dc19-63fb-4490-b113-0176dc1cc8f4\",\"admin_name\": \"API Automation api_automation@mistsys.com\",\"desc\": \"Add WLAN \\"Automation Test\\"\"}'
org_id: 268e599f-5379-473f-b18b-4384e9b3f244
scope: org
site_id: dc47920f-52d5-499c-af72-dcd646764f84
timestamp: 1741309601
type: add-wlan
- change_cat: admin_action
metadata: '{\"template_id\": \"7e49acf4-6841-4e56-ad7d-68d0801cbba8\",\"admin_name\": \"API Automation api_automation@mistsys.com\",\"desc\": \"Add Template \\"Automation template\\"\"}'
org_id: 268e599f-5379-473f-b18b-4384e9b3f244
scope: org
timestamp: 1741309280
type: add-template
start: 1741309200
total: 3
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 1741312800
limit: 1000
results:
- change_cat: admin_action
metadata: '{"\wlan_id\": \"None\",\"admin_name\": \"API Automation api_automation@mistsys.com\",\"desc\": \"Delete WLAN \\"Automation Test\\"\"}'
org_id: 268e599f-5379-473f-b18b-4384e9b3f244
scope: org
site_id: dc47920f-52d5-499c-af72-dcd646764f84
timestamp: 1741309621
type: delete-wlan
- change_cat: admin_action
metadata: '{\"wlan_id\": \"3855dc19-63fb-4490-b113-0176dc1cc8f4\",\"admin_name\": \"API Automation api_automation@mistsys.com\",\"desc\": \"Add WLAN \\"Automation Test\\"\"}'
org_id: 268e599f-5379-473f-b18b-4384e9b3f244
scope: org
site_id: dc47920f-52d5-499c-af72-dcd646764f84
timestamp: 1741309601
type: add-wlan
- change_cat: admin_action
metadata: '{\"template_id\": \"7e49acf4-6841-4e56-ad7d-68d0801cbba8\",\"admin_name\": \"API Automation api_automation@mistsys.com\",\"desc\": \"Add Template \\"Automation template\\"\"}'
org_id: 268e599f-5379-473f-b18b-4384e9b3f244
scope: org
timestamp: 1741309280
type: add-template
start: 1741309200
total: 3
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/events/fast_roam:
get:
tags:
- Sites Events
summary: listSiteRoamingEvents
description: List Roaming Events data
operationId: listSiteRoamingEvents
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: type
in: query
description: 'Event type used to filter results. enum: `fail`, `none`, `success`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/fast_roam_result'
- description: 'Event type used to filter results. enum: `fail`, `none`, `success`'
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_events_fastroam'
- description: Paginated response for fast roaming event results
examples:
- end: 1501023379
limit: 2
next: /api/v1/sites/dca0a44b-324c-11e6-a776-0243ad110007/events/fast_roam?type=success&start=1428939600&end=1428949600&limit=200&token=AAAAEgAIAAVVJh4hF8AAAARzc2lkAH%2F%2F%2F%2F0%3D
results:
- ap_mac: 5c5b350e040b
client_mac: dc2b2a3fb13d
fromap: 5c5b350e0569
latency: 0.1874195
ssid: marvis_test
subtype: CLIENT_AUTHENTICATED_11R
timestamp: 1501000002283782
start: 1500940800
contentMediaType: application/json
examples:
Example:
value:
end: 1501023379
limit: 2
next: /api/v1/sites/dca0a44b-324c-11e6-a776-0243ad110007/events/fast_roam?type=success&start=1428939600&end=1428949600&limit=200&token=AAAAEgAIAAVVJh4hF8AAAARzc2lkAH%2F%2F%2F%2F0%3D
results:
- ap_mac: 5c5b350e040b
client_mac: dc2b2a3fb13d
fromap: 5c5b350e0569
latency: 0.1874195
ssid: marvis_test
subtype: CLIENT_AUTHENTICATED_11R
timestamp: 1501000002283782
start: 1500940800
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_events_fastroam'
- description: Paginated response for fast roaming event results
examples:
- end: 1501023379
limit: 2
next: /api/v1/sites/dca0a44b-324c-11e6-a776-0243ad110007/events/fast_roam?type=success&start=1428939600&end=1428949600&limit=200&token=AAAAEgAIAAVVJh4hF8AAAARzc2lkAH%2F%2F%2F%2F0%3D
results:
- ap_mac: 5c5b350e040b
client_mac: dc2b2a3fb13d
fromap: 5c5b350e0569
latency: 0.1874195
ssid: marvis_test
subtype: CLIENT_AUTHENTICATED_11R
timestamp: 1501000002283782
start: 1500940800
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 1501023379
limit: 2
next: /api/v1/sites/dca0a44b-324c-11e6-a776-0243ad110007/events/fast_roam?type=success&start=1428939600&end=1428949600&limit=200&token=AAAAEgAIAAVVJh4hF8AAAARzc2lkAH%2F%2F%2F%2F0%3D
results:
- ap_mac: 5c5b350e040b
client_mac: dc2b2a3fb13d
fromap: 5c5b350e0569
latency: 0.1874195
ssid: marvis_test
subtype: CLIENT_AUTHENTICATED_11R
timestamp: 1501000002283782
start: 1500940800
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/events/system/count:
get:
tags:
- Sites Events
summary: countSiteSystemEvents
description: Count system events for a site, optionally grouped by the `distinct` field and filtered by time range. Use [Count Org System Events]($e/Orgs%20Events/countOrgSystemEvents) to count system events across the organization.
operationId: countSiteSystemEvents
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field used to group this count response. enum: `type`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/site_system_events_count_distinct'
- description: 'Field used to group this count response. enum: `type`'
- name: type
in: query
description: See [List Device Events Definitions]($e/Constants%20Events/listDeviceEventsDefinitions)
style: form
explode: true
schema:
type: string
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/events/system/search:
get:
tags:
- Sites Events
summary: searchSiteSystemEvents
description: Search system events for a site with time range, sorting, and pagination controls. Use [Search Org System Events]($e/Orgs%20Events/searchOrgSystemEvents) to search system events across the organization.
operationId: searchSiteSystemEvents
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: type
in: query
description: See [List Device Events Definitions]($e/Constants%20Events/listDeviceEventsDefinitions)
style: form
explode: true
schema:
type: string
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_device_events_search'
- description: Paginated response for device or system event search results
examples:
- end: 0
limit: 0
next: string
results:
- ap: 5c5b351e13b5
apfw: 5c5b351e13b5
model: BT11-WW
org_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862a
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
text: Succeeding DNS query from 172.29.101.134 to 172.29.101.7 for "portal.mistsys.com" on vlan 1, id 60224
timestamp: 1547235620.89
type: CLIENT_DNS_OK
- device_type: gateway
job_id: c2096de9-0ca4-4a8b-b500-d37cbe0f0baf
mac: d007ca6c6ac0
org_id: 86f0c649-06b1-4337-b3d4-25eeb887f732
site_id: 9f8d28eb-77c7-44c7-a85b-4426bf291679
status: PROVISION_IN_PROGRESS
template_id: 660e8400-e29b-41d4-a716-446655440001
timestamp: 1748987445.959
tunnel_name: zs1
type: NOTICE
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
end: 0
limit: 0
next: string
results:
- ap: 5c5b351e13b5
apfw: 5c5b351e13b5
model: BT11-WW
org_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862a
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
text: Succeeding DNS query from 172.29.101.134 to 172.29.101.7 for "portal.mistsys.com" on vlan 1, id 60224
timestamp: 1547235620.89
type: CLIENT_DNS_OK
- device_type: gateway
job_id: c2096de9-0ca4-4a8b-b500-d37cbe0f0baf
mac: d007ca6c6ac0
org_id: 86f0c649-06b1-4337-b3d4-25eeb887f732
site_id: 9f8d28eb-77c7-44c7-a85b-4426bf291679
status: PROVISION_IN_PROGRESS
template_id: 660e8400-e29b-41d4-a716-446655440001
timestamp: 1748987445.959
tunnel_name: zs1
type: NOTICE
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_device_events_search'
- description: Paginated response for device or system event search results
examples:
- end: 0
limit: 0
next: string
results:
- ap: 5c5b351e13b5
apfw: 5c5b351e13b5
model: BT11-WW
org_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862a
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
text: Succeeding DNS query from 172.29.101.134 to 172.29.101.7 for "portal.mistsys.com" on vlan 1, id 60224
timestamp: 1547235620.89
type: CLIENT_DNS_OK
- device_type: gateway
job_id: c2096de9-0ca4-4a8b-b500-d37cbe0f0baf
mac: d007ca6c6ac0
org_id: 86f0c649-06b1-4337-b3d4-25eeb887f732
site_id: 9f8d28eb-77c7-44c7-a85b-4426bf291679
status: PROVISION_IN_PROGRESS
template_id: 660e8400-e29b-41d4-a716-446655440001
timestamp: 1748987445.959
tunnel_name: zs1
type: NOTICE
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 0
limit: 0
next: string
results:
- ap: 5c5b351e13b5
apfw: 5c5b351e13b5
model: BT11-WW
org_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862a
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
text: Succeeding DNS query from 172.29.101.134 to 172.29.101.7 for "portal.mistsys.com" on vlan 1, id 60224
timestamp: 1547235620.89
type: CLIENT_DNS_OK
- device_type: gateway
job_id: c2096de9-0ca4-4a8b-b500-d37cbe0f0baf
mac: d007ca6c6ac0
org_id: 86f0c649-06b1-4337-b3d4-25eeb887f732
site_id: 9f8d28eb-77c7-44c7-a85b-4426bf291679
status: PROVISION_IN_PROGRESS
template_id: 660e8400-e29b-41d4-a716-446655440001
timestamp: 1748987445.959
tunnel_name: zs1
type: NOTICE
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/evpn_topologies:
get:
tags:
- Sites EVPN Topologies
summary: listSiteEvpnTopologies
description: Get the existing EVPN topology
operationId: listSiteEvpnTopologies
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/evpn_topology_response'
description: EVPN topology records returned by list APIs
examples:
- - created_time: 1736421230
evpn_options:
auto_loopback_subnet: 172.16.192.0/24
auto_loopback_subnet6: fd33:ab00:2::/64
auto_router_id_subnet: 172.16.254.0/23
core_as_border: true
overlay:
as: 65000
per_vlan_vga_v4_mac: false
routed_at: core
underlay:
as_base: 65001
subnet: 10.255.240.0/20
use_ipv6: false
for_site: false
id: 764fb173-94f9-447c-8454-def62e5a999f
modified_time: 1736421230
name: tert
org_id: 3a2627d7-bfbc-45af-b85d-8841581c6d63
pod_names:
'1': Pod 1
site_id: 00000000-0000-0000-0000-000000000000
contentMediaType: application/json
examples:
Example:
value:
- created_time: 1736421230
evpn_options:
auto_loopback_subnet: 172.16.192.0/24
auto_loopback_subnet6: fd33:ab00:2::/64
auto_router_id_subnet: 172.16.254.0/23
core_as_border: true
overlay:
as: 65000
per_vlan_vga_v4_mac: false
routed_at: core
underlay:
as_base: 65001
subnet: 10.255.240.0/20
use_ipv6: false
for_site: false
id: 764fb173-94f9-447c-8454-def62e5a999f
modified_time: 1736421230
name: tert
org_id: 3a2627d7-bfbc-45af-b85d-8841581c6d63
pod_names:
'1': Pod 1
site_id: 00000000-0000-0000-0000-000000000000
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/evpn_topology_response'
description: EVPN topology records returned by list APIs
examples:
- - created_time: 1736421230
evpn_options:
auto_loopback_subnet: 172.16.192.0/24
auto_loopback_subnet6: fd33:ab00:2::/64
auto_router_id_subnet: 172.16.254.0/23
core_as_border: true
overlay:
as: 65000
per_vlan_vga_v4_mac: false
routed_at: core
underlay:
as_base: 65001
subnet: 10.255.240.0/20
use_ipv6: false
for_site: false
id: 764fb173-94f9-447c-8454-def62e5a999f
modified_time: 1736421230
name: tert
org_id: 3a2627d7-bfbc-45af-b85d-8841581c6d63
pod_names:
'1': Pod 1
site_id: 00000000-0000-0000-0000-000000000000
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- created_time: 1736421230
evpn_options:
auto_loopback_subnet: 172.16.192.0/24
auto_loopback_subnet6: fd33:ab00:2::/64
auto_router_id_subnet: 172.16.254.0/23
core_as_border: true
overlay:
as: 65000
per_vlan_vga_v4_mac: false
routed_at: core
underlay:
as_base: 65001
subnet: 10.255.240.0/20
use_ipv6: false
for_site: false
id: 764fb173-94f9-447c-8454-def62e5a999f
modified_time: 1736421230
name: tert
org_id: 3a2627d7-bfbc-45af-b85d-8841581c6d63
pod_names:
'1': Pod 1
site_id: 00000000-0000-0000-0000-000000000000
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Sites EVPN Topologies
summary: createSiteEvpnTopology
description: >-
While all the `evpn_id` / `downlink_ips` can be specified by hand, the easiest way is to call the `build_vpn_topology` API, allowing you to examine the diff, and update it yourself. You can also simply call it with `overwrite=true` which will apply the updates for you.
**Notes:**
1. You can use `core` / `distribution` / `access` to create a CLOS topology
2. You can also use `core` / `distribution` to form a 2-tier EVPN topology where ESI-Lag is configured distribution to connect to access switches
3. In a small/medium campus, `collapsed-core` can be used where core switches are the inter-connected to do EVPN
operationId: createSiteEvpnTopology
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/evpn_topology'
- examples:
- name: CC
overwrite: true
pod_names:
'1': default
'2': default
switches:
- mac: 5c5b35000003
role: collapsed-core
- mac: 5c5b35000004
role: collapsed-core
contentMediaType: application/json
examples:
Example:
value:
name: CC
overwrite: true
pod_names:
'1': default
'2': default
switches:
- mac: 5c5b35000003
role: collapsed-core
- mac: 5c5b35000004
role: collapsed-core
required: false
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/evpn_topology'
- description: EVPN topology create or update payload
examples:
- id: 9197ec96-4c8d-529f-c595-035895e688b2
name: CC
overwrite: true
pod_names:
'1': default
'2': default
switches:
- deviceprofile_id: 6a1deab1-96df-4fa2-8455-d5253f943d06
downlink_ips:
- 10.255.240.6
- 10.255.240.8
downlinks:
- 5c5b35000007
- 5c5b35000008
esilaglinks:
- 5c5b3500000f
evpn_id: 1
mac: 5c5b35000003
model: QFX10002-36Q
role: collapsed-core
site_id: 1916d52a-4a90-11e5-8b45-1258369c38a9
uplinks:
- 5c5b35000005
- 5c5b35000006
contentMediaType: application/json
examples:
Example:
value:
id: 9197ec96-4c8d-529f-c595-035895e688b2
name: CC
overwrite: true
pod_names:
'1': default
'2': default
switches:
- deviceprofile_id: 6a1deab1-96df-4fa2-8455-d5253f943d06
downlink_ips:
- 10.255.240.6
- 10.255.240.8
downlinks:
- 5c5b35000007
- 5c5b35000008
esilaglinks:
- 5c5b3500000f
evpn_id: 1
mac: 5c5b35000003
model: QFX10002-36Q
role: collapsed-core
site_id: 1916d52a-4a90-11e5-8b45-1258369c38a9
uplinks:
- 5c5b35000005
- 5c5b35000006
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/evpn_topology'
- description: EVPN topology create or update payload
examples:
- id: 9197ec96-4c8d-529f-c595-035895e688b2
name: CC
overwrite: true
pod_names:
'1': default
'2': default
switches:
- deviceprofile_id: 6a1deab1-96df-4fa2-8455-d5253f943d06
downlink_ips:
- 10.255.240.6
- 10.255.240.8
downlinks:
- 5c5b35000007
- 5c5b35000008
esilaglinks:
- 5c5b3500000f
evpn_id: 1
mac: 5c5b35000003
model: QFX10002-36Q
role: collapsed-core
site_id: 1916d52a-4a90-11e5-8b45-1258369c38a9
uplinks:
- 5c5b35000005
- 5c5b35000006
contentMediaType: application/vnd.api+json
examples:
Example:
value:
id: 9197ec96-4c8d-529f-c595-035895e688b2
name: CC
overwrite: true
pod_names:
'1': default
'2': default
switches:
- deviceprofile_id: 6a1deab1-96df-4fa2-8455-d5253f943d06
downlink_ips:
- 10.255.240.6
- 10.255.240.8
downlinks:
- 5c5b35000007
- 5c5b35000008
esilaglinks:
- 5c5b3500000f
evpn_id: 1
mac: 5c5b35000003
model: QFX10002-36Q
role: collapsed-core
site_id: 1916d52a-4a90-11e5-8b45-1258369c38a9
uplinks:
- 5c5b35000005
- 5c5b35000006
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/evpn_topologies/{evpn_topology_id}:
delete:
tags:
- Sites EVPN Topologies
summary: deleteSiteEvpnTopology
description: Delete the site EVPN Topology
operationId: deleteSiteEvpnTopology
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: evpn_topology_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Sites EVPN Topologies
summary: getSiteEvpnTopology
description: Get One EVPN Topology Detail
operationId: getSiteEvpnTopology
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: evpn_topology_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/evpn_topology'
- description: EVPN topology create or update payload
examples:
- id: 9197ec96-4c8d-529f-c595-035895e688b2
name: CC
overwrite: true
pod_names:
'1': default
'2': default
switches:
- deviceprofile_id: 6a1deab1-96df-4fa2-8455-d5253f943d06
downlink_ips:
- 10.255.240.6
- 10.255.240.8
downlinks:
- 5c5b35000007
- 5c5b35000008
esilaglinks:
- 5c5b3500000f
evpn_id: 1
mac: 5c5b35000003
model: QFX10002-36Q
role: collapsed-core
site_id: 1916d52a-4a90-11e5-8b45-1258369c38a9
uplinks:
- 5c5b35000005
- 5c5b35000006
contentMediaType: application/json
examples:
Example:
value:
id: 9197ec96-4c8d-529f-c595-035895e688b2
name: CC
overwrite: true
pod_names:
'1': default
'2': default
switches:
- deviceprofile_id: 6a1deab1-96df-4fa2-8455-d5253f943d06
downlink_ips:
- 10.255.240.6
- 10.255.240.8
downlinks:
- 5c5b35000007
- 5c5b35000008
esilaglinks:
- 5c5b3500000f
evpn_id: 1
mac: 5c5b35000003
model: QFX10002-36Q
role: collapsed-core
site_id: 1916d52a-4a90-11e5-8b45-1258369c38a9
uplinks:
- 5c5b35000005
- 5c5b35000006
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/evpn_topology'
- description: EVPN topology create or update payload
examples:
- id: 9197ec96-4c8d-529f-c595-035895e688b2
name: CC
overwrite: true
pod_names:
'1': default
'2': default
switches:
- deviceprofile_id: 6a1deab1-96df-4fa2-8455-d5253f943d06
downlink_ips:
- 10.255.240.6
- 10.255.240.8
downlinks:
- 5c5b35000007
- 5c5b35000008
esilaglinks:
- 5c5b3500000f
evpn_id: 1
mac: 5c5b35000003
model: QFX10002-36Q
role: collapsed-core
site_id: 1916d52a-4a90-11e5-8b45-1258369c38a9
uplinks:
- 5c5b35000005
- 5c5b35000006
contentMediaType: application/vnd.api+json
examples:
Example:
value:
id: 9197ec96-4c8d-529f-c595-035895e688b2
name: CC
overwrite: true
pod_names:
'1': default
'2': default
switches:
- deviceprofile_id: 6a1deab1-96df-4fa2-8455-d5253f943d06
downlink_ips:
- 10.255.240.6
- 10.255.240.8
downlinks:
- 5c5b35000007
- 5c5b35000008
esilaglinks:
- 5c5b3500000f
evpn_id: 1
mac: 5c5b35000003
model: QFX10002-36Q
role: collapsed-core
site_id: 1916d52a-4a90-11e5-8b45-1258369c38a9
uplinks:
- 5c5b35000005
- 5c5b35000006
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Sites EVPN Topologies
summary: updateSiteEvpnTopology
description: Update the EVPN Topology
operationId: updateSiteEvpnTopology
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: evpn_topology_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/evpn_topology'
- examples:
- overwrite: false
switches:
- mac: 5c5b35000003
role: collapsed-core
- mac: 5c5b35000004
role: none
contentMediaType: application/json
examples:
Example:
value:
overwrite: false
switches:
- mac: 5c5b35000003
role: collapsed-core
- mac: 5c5b35000004
role: none
required: false
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/evpn_topology'
- description: EVPN topology create or update payload
examples:
- id: 9197ec96-4c8d-529f-c595-035895e688b2
name: CC
overwrite: true
pod_names:
'1': default
'2': default
switches:
- deviceprofile_id: 6a1deab1-96df-4fa2-8455-d5253f943d06
downlink_ips:
- 10.255.240.6
- 10.255.240.8
downlinks:
- 5c5b35000007
- 5c5b35000008
esilaglinks:
- 5c5b3500000f
evpn_id: 1
mac: 5c5b35000003
model: QFX10002-36Q
role: collapsed-core
site_id: 1916d52a-4a90-11e5-8b45-1258369c38a9
uplinks:
- 5c5b35000005
- 5c5b35000006
contentMediaType: application/json
examples:
Example:
value:
id: 9197ec96-4c8d-529f-c595-035895e688b2
name: CC
overwrite: true
pod_names:
'1': default
'2': default
switches:
- deviceprofile_id: 6a1deab1-96df-4fa2-8455-d5253f943d06
downlink_ips:
- 10.255.240.6
- 10.255.240.8
downlinks:
- 5c5b35000007
- 5c5b35000008
esilaglinks:
- 5c5b3500000f
evpn_id: 1
mac: 5c5b35000003
model: QFX10002-36Q
role: collapsed-core
site_id: 1916d52a-4a90-11e5-8b45-1258369c38a9
uplinks:
- 5c5b35000005
- 5c5b35000006
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/evpn_topology'
- description: EVPN topology create or update payload
examples:
- id: 9197ec96-4c8d-529f-c595-035895e688b2
name: CC
overwrite: true
pod_names:
'1': default
'2': default
switches:
- deviceprofile_id: 6a1deab1-96df-4fa2-8455-d5253f943d06
downlink_ips:
- 10.255.240.6
- 10.255.240.8
downlinks:
- 5c5b35000007
- 5c5b35000008
esilaglinks:
- 5c5b3500000f
evpn_id: 1
mac: 5c5b35000003
model: QFX10002-36Q
role: collapsed-core
site_id: 1916d52a-4a90-11e5-8b45-1258369c38a9
uplinks:
- 5c5b35000005
- 5c5b35000006
contentMediaType: application/vnd.api+json
examples:
Example:
value:
id: 9197ec96-4c8d-529f-c595-035895e688b2
name: CC
overwrite: true
pod_names:
'1': default
'2': default
switches:
- deviceprofile_id: 6a1deab1-96df-4fa2-8455-d5253f943d06
downlink_ips:
- 10.255.240.6
- 10.255.240.8
downlinks:
- 5c5b35000007
- 5c5b35000008
esilaglinks:
- 5c5b3500000f
evpn_id: 1
mac: 5c5b35000003
model: QFX10002-36Q
role: collapsed-core
site_id: 1916d52a-4a90-11e5-8b45-1258369c38a9
uplinks:
- 5c5b35000005
- 5c5b35000006
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/gatewaytemplates/derived:
get:
tags:
- Sites Gateway Templates
summary: listSiteGatewayTemplatesDerived
description: Get the list of derived Gateway Templates a Site
operationId: listSiteGatewayTemplatesDerived
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: resolve
in: query
description: Whether resolve the site variables
style: form
explode: true
schema:
type: boolean
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/gateway_template'
description: List of gateway device profiles
contentMediaType: application/json
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/gateway_template'
description: List of gateway device profiles
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/idpprofiles/derived:
get:
tags:
- Sites IDP Profiles
summary: listSiteIdpProfilesDerived
description: Get the list of derived IDP Profiles for a site
operationId: listSiteIdpProfilesDerived
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/avprofile'
description: List of antivirus scanning profiles
examples:
- - fallback_action: permit
max_filesize: 10000
mime_whitelist: []
name: av-custom
protocols:
- http
url_whitelist: []
contentMediaType: application/json
examples:
Example:
value:
- fallback_action: permit
max_filesize: 10000
mime_whitelist: []
name: av-custom
protocols:
- http
url_whitelist: []
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/avprofile'
description: List of antivirus scanning profiles
examples:
- - fallback_action: permit
max_filesize: 10000
mime_whitelist: []
name: av-custom
protocols:
- http
url_whitelist: []
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- fallback_action: permit
max_filesize: 10000
mime_whitelist: []
name: av-custom
protocols:
- http
url_whitelist: []
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/aamwprofiles/derived:
get:
tags:
- Sites Advanced Anti Malware Profiles
summary: listSiteAAMWProfilesDerived
description: Get the list of derived Advanced Anti Malware Profile (SkyAtp) for a site
operationId: listSiteAAMWProfilesDerived
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/avprofile'
description: List of antivirus scanning profiles
examples:
- - fallback_action: permit
max_filesize: 10000
mime_whitelist: []
name: av-custom
protocols:
- http
url_whitelist: []
contentMediaType: application/json
examples:
Example:
value:
- fallback_action: permit
max_filesize: 10000
mime_whitelist: []
name: av-custom
protocols:
- http
url_whitelist: []
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/avprofile'
description: List of antivirus scanning profiles
examples:
- - fallback_action: permit
max_filesize: 10000
mime_whitelist: []
name: av-custom
protocols:
- http
url_whitelist: []
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- fallback_action: permit
max_filesize: 10000
mime_whitelist: []
name: av-custom
protocols:
- http
url_whitelist: []
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/avprofiles/derived:
get:
tags:
- Sites Antivirus Profiles
summary: listSiteAntivirusProfilesDerived
description: Get the list of derived Antivirus Profiles for a site
operationId: listSiteAntivirusProfilesDerived
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/avprofile'
description: List of antivirus scanning profiles
examples:
- - fallback_action: permit
max_filesize: 10000
mime_whitelist: []
name: av-custom
protocols:
- http
url_whitelist: []
contentMediaType: application/json
examples:
Example:
value:
- fallback_action: permit
max_filesize: 10000
mime_whitelist: []
name: av-custom
protocols:
- http
url_whitelist: []
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/avprofile'
description: List of antivirus scanning profiles
examples:
- - fallback_action: permit
max_filesize: 10000
mime_whitelist: []
name: av-custom
protocols:
- http
url_whitelist: []
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- fallback_action: permit
max_filesize: 10000
mime_whitelist: []
name: av-custom
protocols:
- http
url_whitelist: []
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/guests:
get:
tags:
- Sites Guests
summary: listSiteAllGuestAuthorizations
description: Get List of Site Guest Authorizations
operationId: listSiteAllGuestAuthorizations
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: wlan_id
in: query
description: UUID of single or multiple (Comma separated) WLAN under Site `site_id` (to filter by WLAN)
style: form
explode: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/guest'
description: List of guest authorization records
examples:
- '[{"authorized":true,"authorized_expiring_time":0,"authorized_time":0,"company":"string","email":"user@example.com","field1":"string","field2":"string","field3":"string","field4":"string","mac":"string","minutes":0,"name":"string"}]'
- '[{"authorized":true,"authorized_expiring_time":1480704955,"authorized_time":1480704355,"company":"abc","email":"john@abc.com","field1":"xxx","mac":"5684dae9ac8b","name":"John Smith"}]'
contentMediaType: application/json
examples:
Example:
value:
- authorized: true
authorized_expiring_time: 0
authorized_time: 0
company: string
email: user@example.com
field1: string
field2: string
field3: string
field4: string
mac: string
minutes: 0
name: string
Example2:
value:
- authorized: true
authorized_expiring_time: 1480704955
authorized_time: 1480704355
company: abc
email: john@abc.com
field1: xxx
mac: 5684dae9ac8b
name: John Smith
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/guest'
description: List of guest authorization records
examples:
- '[{"authorized":true,"authorized_expiring_time":0,"authorized_time":0,"company":"string","email":"user@example.com","field1":"string","field2":"string","field3":"string","field4":"string","mac":"string","minutes":0,"name":"string"}]'
- '[{"authorized":true,"authorized_expiring_time":1480704955,"authorized_time":1480704355,"company":"abc","email":"john@abc.com","field1":"xxx","mac":"5684dae9ac8b","name":"John Smith"}]'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- authorized: true
authorized_expiring_time: 0
authorized_time: 0
company: string
email: user@example.com
field1: string
field2: string
field3: string
field4: string
mac: string
minutes: 0
name: string
Example2:
value:
- authorized: true
authorized_expiring_time: 1480704955
authorized_time: 1480704355
company: abc
email: john@abc.com
field1: xxx
mac: 5684dae9ac8b
name: John Smith
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/guests/count:
get:
tags:
- Sites Guests
summary: countSiteGuestAuthorizations
description: Count authorized guest records for a site, optionally grouped by the `distinct` field and filtered by time range. Use [Count Org Guest Authorizations]($e/Orgs%20Guests/countOrgGuestAuthorizations) to count authorized guest records across the organization.
operationId: countSiteGuestAuthorizations
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field used to group this count response. enum: `auth_method`, `company`, `ssid`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/site_guests_count_distinct'
- description: 'Field used to group this count response. enum: `auth_method`, `company`, `ssid`'
examples:
- auth_method
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/guests/derived:
get:
tags:
- Sites Guests
summary: listSiteAllGuestAuthorizationsDerived
description: Get the list of derived Guest Authorizations for a site
operationId: listSiteAllGuestAuthorizationsDerived
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: wlan_id
in: query
description: UUID of single or multiple (Comma separated) WLAN under Site `site_id` (to filter by WLAN)
style: form
explode: true
schema:
type: string
- name: cross_site
in: query
description: Whether to get org level guests, default is false i.e get site level guests
style: form
explode: true
schema:
type: boolean
default: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/guest'
description: List of guest authorization records
examples:
- '[{"authorized":true,"authorized_expiring_time":0,"authorized_time":0,"company":"string","email":"user@example.com","field1":"string","field2":"string","field3":"string","field4":"string","mac":"string","minutes":0,"name":"string"}]'
- '[{"authorized":true,"authorized_expiring_time":1480704955,"authorized_time":1480704355,"company":"abc","email":"john@abc.com","field1":"xxx","mac":"5684dae9ac8b","name":"John Smith"}]'
contentMediaType: application/json
examples:
Example:
value:
- authorized: true
authorized_expiring_time: 0
authorized_time: 0
company: string
email: user@example.com
field1: string
field2: string
field3: string
field4: string
mac: string
minutes: 0
name: string
Example2:
value:
- authorized: true
authorized_expiring_time: 1480704955
authorized_time: 1480704355
company: abc
email: john@abc.com
field1: xxx
mac: 5684dae9ac8b
name: John Smith
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/guest'
description: List of guest authorization records
examples:
- '[{"authorized":true,"authorized_expiring_time":0,"authorized_time":0,"company":"string","email":"user@example.com","field1":"string","field2":"string","field3":"string","field4":"string","mac":"string","minutes":0,"name":"string"}]'
- '[{"authorized":true,"authorized_expiring_time":1480704955,"authorized_time":1480704355,"company":"abc","email":"john@abc.com","field1":"xxx","mac":"5684dae9ac8b","name":"John Smith"}]'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- authorized: true
authorized_expiring_time: 0
authorized_time: 0
company: string
email: user@example.com
field1: string
field2: string
field3: string
field4: string
mac: string
minutes: 0
name: string
Example2:
value:
- authorized: true
authorized_expiring_time: 1480704955
authorized_time: 1480704355
company: abc
email: john@abc.com
field1: xxx
mac: 5684dae9ac8b
name: John Smith
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/guests/search:
get:
tags:
- Sites Guests
summary: searchSiteGuestAuthorization
description: Search authorized guest records for a site with filters for WLAN, SSID, authentication method, and time range. Use [Search Org Guest Authorization]($e/Orgs%20Guests/searchOrgGuestAuthorization) to search authorized guest records across the organization.
operationId: searchSiteGuestAuthorization
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: wlan_id
in: query
description: Filter results by WLAN identifier
style: form
explode: true
schema:
type: string
examples:
- 00000000-0000-0000-0000-000000000000
- name: auth_method
in: query
description: Filter guest results by authentication method
style: form
explode: true
schema:
type: string
- name: ssid
in: query
description: Filter results by SSID
style: form
explode: true
schema:
type: string
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_guest_search'
- description: Paginated response for guest authorization search results
examples:
- end: 1531862583
limit: 2
next: /api/v1/sites/8aaba0aa-09cc-44bd-9709-33b98040550c/guests/search?wlan_id=88ffe630-95b8-11e8-b294-346895ed1b7d&end=1531855849.000&limit=2&start=1531776183.0
results:
- ap: 5c5b350e0001
auth_method: passphrase
authorized_expiring_time: 1531810258.186273
authorized_time: 1531782218
company: mistsystems
email: user@mistsys.com
name: john
ssid: openNet
timestamp: 1531782218
- ap: 5c5b350e0001
auth_method: facebook
authorized_expiring_time: 1531810821.145
authorized_time: 1531782632
company: xyz inc.
email: cool_user@yahoo.com
name: John White
ssid: openNet
timestamp: 1531782632
start: 1531776183
total: 14
contentMediaType: application/json
examples:
Example:
value:
end: 1531862583
limit: 2
next: /api/v1/sites/8aaba0aa-09cc-44bd-9709-33b98040550c/guests/search?wlan_id=88ffe630-95b8-11e8-b294-346895ed1b7d&end=1531855849.000&limit=2&start=1531776183.0
results:
- ap: 5c5b350e0001
auth_method: passphrase
authorized_expiring_time: 1531810258.186273
authorized_time: 1531782218
company: mistsystems
email: user@mistsys.com
name: john
ssid: openNet
timestamp: 1531782218
- ap: 5c5b350e0001
auth_method: facebook
authorized_expiring_time: 1531810821.145
authorized_time: 1531782632
company: xyz inc.
email: cool_user@yahoo.com
name: John White
ssid: openNet
timestamp: 1531782632
start: 1531776183
total: 14
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_guest_search'
- description: Paginated response for guest authorization search results
examples:
- end: 1531862583
limit: 2
next: /api/v1/sites/8aaba0aa-09cc-44bd-9709-33b98040550c/guests/search?wlan_id=88ffe630-95b8-11e8-b294-346895ed1b7d&end=1531855849.000&limit=2&start=1531776183.0
results:
- ap: 5c5b350e0001
auth_method: passphrase
authorized_expiring_time: 1531810258.186273
authorized_time: 1531782218
company: mistsystems
email: user@mistsys.com
name: john
ssid: openNet
timestamp: 1531782218
- ap: 5c5b350e0001
auth_method: facebook
authorized_expiring_time: 1531810821.145
authorized_time: 1531782632
company: xyz inc.
email: cool_user@yahoo.com
name: John White
ssid: openNet
timestamp: 1531782632
start: 1531776183
total: 14
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 1531862583
limit: 2
next: /api/v1/sites/8aaba0aa-09cc-44bd-9709-33b98040550c/guests/search?wlan_id=88ffe630-95b8-11e8-b294-346895ed1b7d&end=1531855849.000&limit=2&start=1531776183.0
results:
- ap: 5c5b350e0001
auth_method: passphrase
authorized_expiring_time: 1531810258.186273
authorized_time: 1531782218
company: mistsystems
email: user@mistsys.com
name: john
ssid: openNet
timestamp: 1531782218
- ap: 5c5b350e0001
auth_method: facebook
authorized_expiring_time: 1531810821.145
authorized_time: 1531782632
company: xyz inc.
email: cool_user@yahoo.com
name: John White
ssid: openNet
timestamp: 1531782632
start: 1531776183
total: 14
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/guests/{guest_mac}:
delete:
tags:
- Sites Guests
summary: deleteSiteGuestAuthorization
description: Delete Guest Authorization
operationId: deleteSiteGuestAuthorization
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: guest_mac
in: path
description: ''
required: true
schema:
pattern: ^[0-9a-fA-F]{12}$
type: string
examples:
- 0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Sites Guests
summary: getSiteGuestAuthorization
description: Get Guest Authorization
operationId: getSiteGuestAuthorization
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: guest_mac
in: path
description: ''
required: true
schema:
pattern: ^[0-9a-fA-F]{12}$
type: string
examples:
- 0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/guest'
- description: Guest authorization record at site scope
examples:
- '{"authorized":true,"authorized_expiring_time":0,"authorized_time":0,"company":"string","email":"user@example.com","field1":"string","field2":"string","field3":"string","field4":"string","mac":"string","minutes":0,"name":"string"}'
- '{"authorized":true,"authorized_expiring_time":1480704955,"authorized_time":1480704355,"company":"abc","email":"john@abc.com","field1":"xxx","mac":"5684dae9ac8b","name":"John Smith"}'
contentMediaType: application/json
examples:
Example:
value:
authorized: true
authorized_expiring_time: 0
authorized_time: 0
company: string
email: user@example.com
field1: string
field2: string
field3: string
field4: string
mac: string
minutes: 0
name: string
Example2:
value:
authorized: true
authorized_expiring_time: 1480704955
authorized_time: 1480704355
company: abc
email: john@abc.com
field1: xxx
mac: 5684dae9ac8b
name: John Smith
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/guest'
- description: Guest authorization record at site scope
examples:
- '{"authorized":true,"authorized_expiring_time":0,"authorized_time":0,"company":"string","email":"user@example.com","field1":"string","field2":"string","field3":"string","field4":"string","mac":"string","minutes":0,"name":"string"}'
- '{"authorized":true,"authorized_expiring_time":1480704955,"authorized_time":1480704355,"company":"abc","email":"john@abc.com","field1":"xxx","mac":"5684dae9ac8b","name":"John Smith"}'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
authorized: true
authorized_expiring_time: 0
authorized_time: 0
company: string
email: user@example.com
field1: string
field2: string
field3: string
field4: string
mac: string
minutes: 0
name: string
Example2:
value:
authorized: true
authorized_expiring_time: 1480704955
authorized_time: 1480704355
company: abc
email: john@abc.com
field1: xxx
mac: 5684dae9ac8b
name: John Smith
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Sites Guests
summary: updateSiteGuestAuthorization
description: Update Guest Authorization
operationId: updateSiteGuestAuthorization
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: guest_mac
in: path
description: ''
required: true
schema:
pattern: ^[0-9a-fA-F]{12}$
type: string
examples:
- 0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/guest'
- description: Request Body
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/guest'
- description: Guest authorization record at site scope
examples:
- '{"authorized":true,"authorized_expiring_time":0,"authorized_time":0,"company":"string","email":"user@example.com","field1":"string","field2":"string","field3":"string","field4":"string","mac":"string","minutes":0,"name":"string"}'
- '{"authorized":true,"authorized_expiring_time":1480704955,"authorized_time":1480704355,"company":"abc","email":"john@abc.com","field1":"xxx","mac":"5684dae9ac8b","name":"John Smith"}'
contentMediaType: application/json
examples:
Example:
value:
authorized: true
authorized_expiring_time: 0
authorized_time: 0
company: string
email: user@example.com
field1: string
field2: string
field3: string
field4: string
mac: string
minutes: 0
name: string
Example2:
value:
authorized: true
authorized_expiring_time: 1480704955
authorized_time: 1480704355
company: abc
email: john@abc.com
field1: xxx
mac: 5684dae9ac8b
name: John Smith
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/guest'
- description: Guest authorization record at site scope
examples:
- '{"authorized":true,"authorized_expiring_time":0,"authorized_time":0,"company":"string","email":"user@example.com","field1":"string","field2":"string","field3":"string","field4":"string","mac":"string","minutes":0,"name":"string"}'
- '{"authorized":true,"authorized_expiring_time":1480704955,"authorized_time":1480704355,"company":"abc","email":"john@abc.com","field1":"xxx","mac":"5684dae9ac8b","name":"John Smith"}'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
authorized: true
authorized_expiring_time: 0
authorized_time: 0
company: string
email: user@example.com
field1: string
field2: string
field3: string
field4: string
mac: string
minutes: 0
name: string
Example2:
value:
authorized: true
authorized_expiring_time: 1480704955
authorized_time: 1480704355
company: abc
email: john@abc.com
field1: xxx
mac: 5684dae9ac8b
name: John Smith
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/insights:
get:
tags:
- Sites Insights
summary: getSiteInsightMetrics
description: Get Site Insight Metrics
operationId: getSiteInsightMetrics
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: metrics
in: query
description: Comma separated Metric names, e.g. `num_clients,num_aps`. See possible values at [List Insight Metrics](/#operations/listInsightMetrics)
required: true
style: form
explode: true
schema:
type: string
examples:
- num_clients,num_aps
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: interval
in: query
description: Aggregation works by giving a time range plus interval (e.g. 1d, 1h, 10m) where aggregation function would be applied to.
style: form
explode: true
schema:
type: string
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/insight_metrics'
- description: Insight metric response for a requested time range and aggregation interval
examples:
- end: 0
interval: 0
results:
- {}
start: 0
contentMediaType: application/json
examples:
Example:
value:
end: 0
interval: 0
results:
- {}
start: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/insight_metrics'
- description: Insight metric response for a requested time range and aggregation interval
examples:
- end: 0
interval: 0
results:
- {}
start: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 0
interval: 0
results:
- {}
start: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/insights/ap/{device_id}/stats:
get:
tags:
- Sites Insights
summary: getSiteInsightMetricsForAP
description: Get AP Insight Metrics
operationId: getSiteInsightMetricsForAP
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: metrics
in: query
description: Comma separated Metric names, e.g. `num_clients,num_stressed_clients`. See possible values at [List Insight Metrics](/#operations/listInsightMetrics)
required: true
style: form
explode: true
schema:
type: string
examples:
- num_clients,num_stressed_clients
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: interval
in: query
description: Aggregation works by giving a time range plus interval (e.g. 1d, 1h, 10m) where aggregation function would be applied to.
style: form
explode: true
schema:
type: string
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_device_metrics'
- description: Time-series insight metric response for a device
examples:
- end: 1604347200
interval: 3600
limit: 168
page: 1
results:
- 10
- 11
- 12
- 12
- 10
- 9
- 9
- 9
- 10
- 10
- 11
- 11
- 11
- 11
- 11
- 11
- 11
- 10
- 11
- 11
- 10
- 11
- 11
- 10
rt:
- 2020-11-01 20:00:00+00:00
- 2020-11-01 21:00:00+00:00
- 2020-11-01 22:00:00+00:00
- 2020-11-01 23:00:00+00:00
- 2020-11-02 00:00:00+00:00
- 2020-11-02 01:00:00+00:00
- 2020-11-02 02:00:00+00:00
- 2020-11-02 03:00:00+00:00
- 2020-11-02 04:00:00+00:00
- 2020-11-02 05:00:00+00:00
- 2020-11-02 06:00:00+00:00
- 2020-11-02 07:00:00+00:00
- 2020-11-02 08:00:00+00:00
- 2020-11-02 09:00:00+00:00
- 2020-11-02 10:00:00+00:00
- 2020-11-02 11:00:00+00:00
- 2020-11-02 12:00:00+00:00
- 2020-11-02 13:00:00+00:00
- 2020-11-02 14:00:00+00:00
- 2020-11-02 15:00:00+00:00
- 2020-11-02 16:00:00+00:00
- 2020-11-02 17:00:00+00:00
- 2020-11-02 18:00:00+00:00
- 2020-11-02 19:00:00+00:00
start: 1604260800
contentMediaType: application/json
examples:
Example:
value:
end: 1604347200
interval: 3600
limit: 168
page: 1
results:
- 10
- 11
- 12
- 12
- 10
- 9
- 9
- 9
- 10
- 10
- 11
- 11
- 11
- 11
- 11
- 11
- 11
- 10
- 11
- 11
- 10
- 11
- 11
- 10
rt:
- 2020-11-01 20:00:00+00:00
- 2020-11-01 21:00:00+00:00
- 2020-11-01 22:00:00+00:00
- 2020-11-01 23:00:00+00:00
- 2020-11-02 00:00:00+00:00
- 2020-11-02 01:00:00+00:00
- 2020-11-02 02:00:00+00:00
- 2020-11-02 03:00:00+00:00
- 2020-11-02 04:00:00+00:00
- 2020-11-02 05:00:00+00:00
- 2020-11-02 06:00:00+00:00
- 2020-11-02 07:00:00+00:00
- 2020-11-02 08:00:00+00:00
- 2020-11-02 09:00:00+00:00
- 2020-11-02 10:00:00+00:00
- 2020-11-02 11:00:00+00:00
- 2020-11-02 12:00:00+00:00
- 2020-11-02 13:00:00+00:00
- 2020-11-02 14:00:00+00:00
- 2020-11-02 15:00:00+00:00
- 2020-11-02 16:00:00+00:00
- 2020-11-02 17:00:00+00:00
- 2020-11-02 18:00:00+00:00
- 2020-11-02 19:00:00+00:00
start: 1604260800
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_device_metrics'
- description: Time-series insight metric response for a device
examples:
- end: 1604347200
interval: 3600
limit: 168
page: 1
results:
- 10
- 11
- 12
- 12
- 10
- 9
- 9
- 9
- 10
- 10
- 11
- 11
- 11
- 11
- 11
- 11
- 11
- 10
- 11
- 11
- 10
- 11
- 11
- 10
rt:
- 2020-11-01 20:00:00+00:00
- 2020-11-01 21:00:00+00:00
- 2020-11-01 22:00:00+00:00
- 2020-11-01 23:00:00+00:00
- 2020-11-02 00:00:00+00:00
- 2020-11-02 01:00:00+00:00
- 2020-11-02 02:00:00+00:00
- 2020-11-02 03:00:00+00:00
- 2020-11-02 04:00:00+00:00
- 2020-11-02 05:00:00+00:00
- 2020-11-02 06:00:00+00:00
- 2020-11-02 07:00:00+00:00
- 2020-11-02 08:00:00+00:00
- 2020-11-02 09:00:00+00:00
- 2020-11-02 10:00:00+00:00
- 2020-11-02 11:00:00+00:00
- 2020-11-02 12:00:00+00:00
- 2020-11-02 13:00:00+00:00
- 2020-11-02 14:00:00+00:00
- 2020-11-02 15:00:00+00:00
- 2020-11-02 16:00:00+00:00
- 2020-11-02 17:00:00+00:00
- 2020-11-02 18:00:00+00:00
- 2020-11-02 19:00:00+00:00
start: 1604260800
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 1604347200
interval: 3600
limit: 168
page: 1
results:
- 10
- 11
- 12
- 12
- 10
- 9
- 9
- 9
- 10
- 10
- 11
- 11
- 11
- 11
- 11
- 11
- 11
- 10
- 11
- 11
- 10
- 11
- 11
- 10
rt:
- 2020-11-01 20:00:00+00:00
- 2020-11-01 21:00:00+00:00
- 2020-11-01 22:00:00+00:00
- 2020-11-01 23:00:00+00:00
- 2020-11-02 00:00:00+00:00
- 2020-11-02 01:00:00+00:00
- 2020-11-02 02:00:00+00:00
- 2020-11-02 03:00:00+00:00
- 2020-11-02 04:00:00+00:00
- 2020-11-02 05:00:00+00:00
- 2020-11-02 06:00:00+00:00
- 2020-11-02 07:00:00+00:00
- 2020-11-02 08:00:00+00:00
- 2020-11-02 09:00:00+00:00
- 2020-11-02 10:00:00+00:00
- 2020-11-02 11:00:00+00:00
- 2020-11-02 12:00:00+00:00
- 2020-11-02 13:00:00+00:00
- 2020-11-02 14:00:00+00:00
- 2020-11-02 15:00:00+00:00
- 2020-11-02 16:00:00+00:00
- 2020-11-02 17:00:00+00:00
- 2020-11-02 18:00:00+00:00
- 2020-11-02 19:00:00+00:00
start: 1604260800
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/insights/client/{client_mac}:
get:
tags:
- Sites Insights
summary: getSiteInsightMetricsForClient
description: Get Client Insight Metrics
operationId: getSiteInsightMetricsForClient
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: client_mac
in: path
description: ''
required: true
schema:
pattern: ^[0-9a-fA-F]{12}$
type: string
examples:
- 0000000000ab
- name: metrics
in: query
description: Comma separated Metric names, e.g. `top-app-by-num_client,top-app-by-bytes`. See possible values at [List Insight Metrics](/#operations/listInsightMetrics)
required: true
style: form
explode: true
schema:
type: string
examples:
- top-app-by-num_client,top-app-by-bytes
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: interval
in: query
description: Aggregation works by giving a time range plus interval (e.g. 1d, 1h, 10m) where aggregation function would be applied to.
style: form
explode: true
schema:
type: string
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/insight_metrics'
- description: Insight metric response for a requested time range and aggregation interval
examples:
- end: 0
interval: 0
results:
- {}
start: 0
contentMediaType: application/json
examples:
Example:
value:
end: 0
interval: 0
results:
- {}
start: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/insight_metrics'
- description: Insight metric response for a requested time range and aggregation interval
examples:
- end: 0
interval: 0
results:
- {}
start: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 0
interval: 0
results:
- {}
start: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/insights/device/{device_mac}/{metric}:
get:
tags:
- Sites Insights
summary: getSiteInsightMetricsForDevice
description: >-
Get AP Insight Metrics
See metrics possibilities at [List Insight Metrics]($e/Constants%20Definitions/listInsightMetrics)
operationId: getSiteInsightMetricsForDevice
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: metric
in: path
description: See [List Insight Metrics]($e/Constants%20Definitions/listInsightMetrics) for available metrics
required: true
schema:
type: string
- name: device_mac
in: path
description: ''
required: true
schema:
pattern: ^[0-9a-fA-F]{12}$
type: string
examples:
- 0000000000ab
- name: port_id
in: query
description: Port ID of the device, e.g. `ge-0/0/1`. Can be used with metrics related to interfaces, e.g. `rx_bytes`.
style: form
explode: true
schema:
type: string
examples:
- ge-0/0/1
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: interval
in: query
description: Aggregation works by giving a time range plus interval (e.g. 1d, 1h, 10m) where aggregation function would be applied to.
style: form
explode: true
schema:
type: string
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_device_metrics'
- description: Time-series insight metric response for a device
examples:
- end: 1604347200
interval: 3600
limit: 168
page: 1
results:
- 10
- 11
- 12
- 12
- 10
- 9
- 9
- 9
- 10
- 10
- 11
- 11
- 11
- 11
- 11
- 11
- 11
- 10
- 11
- 11
- 10
- 11
- 11
- 10
rt:
- 2020-11-01 20:00:00+00:00
- 2020-11-01 21:00:00+00:00
- 2020-11-01 22:00:00+00:00
- 2020-11-01 23:00:00+00:00
- 2020-11-02 00:00:00+00:00
- 2020-11-02 01:00:00+00:00
- 2020-11-02 02:00:00+00:00
- 2020-11-02 03:00:00+00:00
- 2020-11-02 04:00:00+00:00
- 2020-11-02 05:00:00+00:00
- 2020-11-02 06:00:00+00:00
- 2020-11-02 07:00:00+00:00
- 2020-11-02 08:00:00+00:00
- 2020-11-02 09:00:00+00:00
- 2020-11-02 10:00:00+00:00
- 2020-11-02 11:00:00+00:00
- 2020-11-02 12:00:00+00:00
- 2020-11-02 13:00:00+00:00
- 2020-11-02 14:00:00+00:00
- 2020-11-02 15:00:00+00:00
- 2020-11-02 16:00:00+00:00
- 2020-11-02 17:00:00+00:00
- 2020-11-02 18:00:00+00:00
- 2020-11-02 19:00:00+00:00
start: 1604260800
contentMediaType: application/json
examples:
Example:
value:
end: 1604347200
interval: 3600
limit: 168
page: 1
results:
- 10
- 11
- 12
- 12
- 10
- 9
- 9
- 9
- 10
- 10
- 11
- 11
- 11
- 11
- 11
- 11
- 11
- 10
- 11
- 11
- 10
- 11
- 11
- 10
rt:
- 2020-11-01 20:00:00+00:00
- 2020-11-01 21:00:00+00:00
- 2020-11-01 22:00:00+00:00
- 2020-11-01 23:00:00+00:00
- 2020-11-02 00:00:00+00:00
- 2020-11-02 01:00:00+00:00
- 2020-11-02 02:00:00+00:00
- 2020-11-02 03:00:00+00:00
- 2020-11-02 04:00:00+00:00
- 2020-11-02 05:00:00+00:00
- 2020-11-02 06:00:00+00:00
- 2020-11-02 07:00:00+00:00
- 2020-11-02 08:00:00+00:00
- 2020-11-02 09:00:00+00:00
- 2020-11-02 10:00:00+00:00
- 2020-11-02 11:00:00+00:00
- 2020-11-02 12:00:00+00:00
- 2020-11-02 13:00:00+00:00
- 2020-11-02 14:00:00+00:00
- 2020-11-02 15:00:00+00:00
- 2020-11-02 16:00:00+00:00
- 2020-11-02 17:00:00+00:00
- 2020-11-02 18:00:00+00:00
- 2020-11-02 19:00:00+00:00
start: 1604260800
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_device_metrics'
- description: Time-series insight metric response for a device
examples:
- end: 1604347200
interval: 3600
limit: 168
page: 1
results:
- 10
- 11
- 12
- 12
- 10
- 9
- 9
- 9
- 10
- 10
- 11
- 11
- 11
- 11
- 11
- 11
- 11
- 10
- 11
- 11
- 10
- 11
- 11
- 10
rt:
- 2020-11-01 20:00:00+00:00
- 2020-11-01 21:00:00+00:00
- 2020-11-01 22:00:00+00:00
- 2020-11-01 23:00:00+00:00
- 2020-11-02 00:00:00+00:00
- 2020-11-02 01:00:00+00:00
- 2020-11-02 02:00:00+00:00
- 2020-11-02 03:00:00+00:00
- 2020-11-02 04:00:00+00:00
- 2020-11-02 05:00:00+00:00
- 2020-11-02 06:00:00+00:00
- 2020-11-02 07:00:00+00:00
- 2020-11-02 08:00:00+00:00
- 2020-11-02 09:00:00+00:00
- 2020-11-02 10:00:00+00:00
- 2020-11-02 11:00:00+00:00
- 2020-11-02 12:00:00+00:00
- 2020-11-02 13:00:00+00:00
- 2020-11-02 14:00:00+00:00
- 2020-11-02 15:00:00+00:00
- 2020-11-02 16:00:00+00:00
- 2020-11-02 17:00:00+00:00
- 2020-11-02 18:00:00+00:00
- 2020-11-02 19:00:00+00:00
start: 1604260800
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 1604347200
interval: 3600
limit: 168
page: 1
results:
- 10
- 11
- 12
- 12
- 10
- 9
- 9
- 9
- 10
- 10
- 11
- 11
- 11
- 11
- 11
- 11
- 11
- 10
- 11
- 11
- 10
- 11
- 11
- 10
rt:
- 2020-11-01 20:00:00+00:00
- 2020-11-01 21:00:00+00:00
- 2020-11-01 22:00:00+00:00
- 2020-11-01 23:00:00+00:00
- 2020-11-02 00:00:00+00:00
- 2020-11-02 01:00:00+00:00
- 2020-11-02 02:00:00+00:00
- 2020-11-02 03:00:00+00:00
- 2020-11-02 04:00:00+00:00
- 2020-11-02 05:00:00+00:00
- 2020-11-02 06:00:00+00:00
- 2020-11-02 07:00:00+00:00
- 2020-11-02 08:00:00+00:00
- 2020-11-02 09:00:00+00:00
- 2020-11-02 10:00:00+00:00
- 2020-11-02 11:00:00+00:00
- 2020-11-02 12:00:00+00:00
- 2020-11-02 13:00:00+00:00
- 2020-11-02 14:00:00+00:00
- 2020-11-02 15:00:00+00:00
- 2020-11-02 16:00:00+00:00
- 2020-11-02 17:00:00+00:00
- 2020-11-02 18:00:00+00:00
- 2020-11-02 19:00:00+00:00
start: 1604260800
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/insights/gateway/{device_id}/stats:
get:
tags:
- Sites Insights
summary: getSiteInsightMetricsForGateway
description: Get Gateway Insight Metrics
operationId: getSiteInsightMetricsForGateway
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: metrics
in: query
description: Comma separated Metric names, e.g. `tx_bps,rx_bps`. See possible values at [List Insight Metrics](/#operations/listInsightMetrics)
required: true
style: form
explode: true
schema:
type: string
examples:
- tx_bps,rx_bps
- name: port_id
in: query
description: Port ID of the gateway device, e.g. `ge-0/0/1`
style: form
explode: true
schema:
type: string
examples:
- ge-0/0/1
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: interval
in: query
description: Aggregation works by giving a time range plus interval (e.g. 1d, 1h, 10m) where aggregation function would be applied to.
style: form
explode: true
schema:
type: string
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_device_metrics'
- description: Time-series insight metric response for a device
examples:
- end: 1604347200
interval: 3600
limit: 168
page: 1
results:
- 10
- 11
- 12
- 12
- 10
- 9
- 9
- 9
- 10
- 10
- 11
- 11
- 11
- 11
- 11
- 11
- 11
- 10
- 11
- 11
- 10
- 11
- 11
- 10
rt:
- 2020-11-01 20:00:00+00:00
- 2020-11-01 21:00:00+00:00
- 2020-11-01 22:00:00+00:00
- 2020-11-01 23:00:00+00:00
- 2020-11-02 00:00:00+00:00
- 2020-11-02 01:00:00+00:00
- 2020-11-02 02:00:00+00:00
- 2020-11-02 03:00:00+00:00
- 2020-11-02 04:00:00+00:00
- 2020-11-02 05:00:00+00:00
- 2020-11-02 06:00:00+00:00
- 2020-11-02 07:00:00+00:00
- 2020-11-02 08:00:00+00:00
- 2020-11-02 09:00:00+00:00
- 2020-11-02 10:00:00+00:00
- 2020-11-02 11:00:00+00:00
- 2020-11-02 12:00:00+00:00
- 2020-11-02 13:00:00+00:00
- 2020-11-02 14:00:00+00:00
- 2020-11-02 15:00:00+00:00
- 2020-11-02 16:00:00+00:00
- 2020-11-02 17:00:00+00:00
- 2020-11-02 18:00:00+00:00
- 2020-11-02 19:00:00+00:00
start: 1604260800
contentMediaType: application/json
examples:
Example:
value:
end: 1604347200
interval: 3600
limit: 168
page: 1
results:
- 10
- 11
- 12
- 12
- 10
- 9
- 9
- 9
- 10
- 10
- 11
- 11
- 11
- 11
- 11
- 11
- 11
- 10
- 11
- 11
- 10
- 11
- 11
- 10
rt:
- 2020-11-01 20:00:00+00:00
- 2020-11-01 21:00:00+00:00
- 2020-11-01 22:00:00+00:00
- 2020-11-01 23:00:00+00:00
- 2020-11-02 00:00:00+00:00
- 2020-11-02 01:00:00+00:00
- 2020-11-02 02:00:00+00:00
- 2020-11-02 03:00:00+00:00
- 2020-11-02 04:00:00+00:00
- 2020-11-02 05:00:00+00:00
- 2020-11-02 06:00:00+00:00
- 2020-11-02 07:00:00+00:00
- 2020-11-02 08:00:00+00:00
- 2020-11-02 09:00:00+00:00
- 2020-11-02 10:00:00+00:00
- 2020-11-02 11:00:00+00:00
- 2020-11-02 12:00:00+00:00
- 2020-11-02 13:00:00+00:00
- 2020-11-02 14:00:00+00:00
- 2020-11-02 15:00:00+00:00
- 2020-11-02 16:00:00+00:00
- 2020-11-02 17:00:00+00:00
- 2020-11-02 18:00:00+00:00
- 2020-11-02 19:00:00+00:00
start: 1604260800
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_device_metrics'
- description: Time-series insight metric response for a device
examples:
- end: 1604347200
interval: 3600
limit: 168
page: 1
results:
- 10
- 11
- 12
- 12
- 10
- 9
- 9
- 9
- 10
- 10
- 11
- 11
- 11
- 11
- 11
- 11
- 11
- 10
- 11
- 11
- 10
- 11
- 11
- 10
rt:
- 2020-11-01 20:00:00+00:00
- 2020-11-01 21:00:00+00:00
- 2020-11-01 22:00:00+00:00
- 2020-11-01 23:00:00+00:00
- 2020-11-02 00:00:00+00:00
- 2020-11-02 01:00:00+00:00
- 2020-11-02 02:00:00+00:00
- 2020-11-02 03:00:00+00:00
- 2020-11-02 04:00:00+00:00
- 2020-11-02 05:00:00+00:00
- 2020-11-02 06:00:00+00:00
- 2020-11-02 07:00:00+00:00
- 2020-11-02 08:00:00+00:00
- 2020-11-02 09:00:00+00:00
- 2020-11-02 10:00:00+00:00
- 2020-11-02 11:00:00+00:00
- 2020-11-02 12:00:00+00:00
- 2020-11-02 13:00:00+00:00
- 2020-11-02 14:00:00+00:00
- 2020-11-02 15:00:00+00:00
- 2020-11-02 16:00:00+00:00
- 2020-11-02 17:00:00+00:00
- 2020-11-02 18:00:00+00:00
- 2020-11-02 19:00:00+00:00
start: 1604260800
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 1604347200
interval: 3600
limit: 168
page: 1
results:
- 10
- 11
- 12
- 12
- 10
- 9
- 9
- 9
- 10
- 10
- 11
- 11
- 11
- 11
- 11
- 11
- 11
- 10
- 11
- 11
- 10
- 11
- 11
- 10
rt:
- 2020-11-01 20:00:00+00:00
- 2020-11-01 21:00:00+00:00
- 2020-11-01 22:00:00+00:00
- 2020-11-01 23:00:00+00:00
- 2020-11-02 00:00:00+00:00
- 2020-11-02 01:00:00+00:00
- 2020-11-02 02:00:00+00:00
- 2020-11-02 03:00:00+00:00
- 2020-11-02 04:00:00+00:00
- 2020-11-02 05:00:00+00:00
- 2020-11-02 06:00:00+00:00
- 2020-11-02 07:00:00+00:00
- 2020-11-02 08:00:00+00:00
- 2020-11-02 09:00:00+00:00
- 2020-11-02 10:00:00+00:00
- 2020-11-02 11:00:00+00:00
- 2020-11-02 12:00:00+00:00
- 2020-11-02 13:00:00+00:00
- 2020-11-02 14:00:00+00:00
- 2020-11-02 15:00:00+00:00
- 2020-11-02 16:00:00+00:00
- 2020-11-02 17:00:00+00:00
- 2020-11-02 18:00:00+00:00
- 2020-11-02 19:00:00+00:00
start: 1604260800
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/insights/mxedge/{device_mac}/{metric}:
get:
tags:
- Sites Insights
summary: getSiteInsightMetricsForMxEdge
description: >-
Get MxEdge Insight Metrics
See metrics possibilities at [List Insight Metrics](/#operations/listInsightMetrics)
operationId: getSiteInsightMetricsForMxEdge
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: metric
in: path
description: See [List Insight Metrics]($e/Constants%20Definitions/listInsightMetrics) for available metrics
required: true
schema:
type: string
- name: device_mac
in: path
description: ''
required: true
schema:
pattern: ^[0-9a-fA-F]{12}$
type: string
examples:
- 0000000000ab
- name: port_id
in: query
description: Port ID of the MxEdge device, e.g. `port0`. Can be used with metrics related to interfaces, e.g. `rx_bytes`.
style: form
explode: true
schema:
type: string
examples:
- port0
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: interval
in: query
description: Aggregation works by giving a time range plus interval (e.g. 1d, 1h, 10m) where aggregation function would be applied to.
style: form
explode: true
schema:
type: string
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_device_metrics'
- description: Time-series insight metric response for a device
examples:
- end: 1604347200
interval: 3600
limit: 168
page: 1
results:
- 10
- 11
- 12
- 12
- 10
- 9
- 9
- 9
- 10
- 10
- 11
- 11
- 11
- 11
- 11
- 11
- 11
- 10
- 11
- 11
- 10
- 11
- 11
- 10
rt:
- 2020-11-01 20:00:00+00:00
- 2020-11-01 21:00:00+00:00
- 2020-11-01 22:00:00+00:00
- 2020-11-01 23:00:00+00:00
- 2020-11-02 00:00:00+00:00
- 2020-11-02 01:00:00+00:00
- 2020-11-02 02:00:00+00:00
- 2020-11-02 03:00:00+00:00
- 2020-11-02 04:00:00+00:00
- 2020-11-02 05:00:00+00:00
- 2020-11-02 06:00:00+00:00
- 2020-11-02 07:00:00+00:00
- 2020-11-02 08:00:00+00:00
- 2020-11-02 09:00:00+00:00
- 2020-11-02 10:00:00+00:00
- 2020-11-02 11:00:00+00:00
- 2020-11-02 12:00:00+00:00
- 2020-11-02 13:00:00+00:00
- 2020-11-02 14:00:00+00:00
- 2020-11-02 15:00:00+00:00
- 2020-11-02 16:00:00+00:00
- 2020-11-02 17:00:00+00:00
- 2020-11-02 18:00:00+00:00
- 2020-11-02 19:00:00+00:00
start: 1604260800
contentMediaType: application/json
examples:
Example:
value:
end: 1604347200
interval: 3600
limit: 168
page: 1
results:
- 10
- 11
- 12
- 12
- 10
- 9
- 9
- 9
- 10
- 10
- 11
- 11
- 11
- 11
- 11
- 11
- 11
- 10
- 11
- 11
- 10
- 11
- 11
- 10
rt:
- 2020-11-01 20:00:00+00:00
- 2020-11-01 21:00:00+00:00
- 2020-11-01 22:00:00+00:00
- 2020-11-01 23:00:00+00:00
- 2020-11-02 00:00:00+00:00
- 2020-11-02 01:00:00+00:00
- 2020-11-02 02:00:00+00:00
- 2020-11-02 03:00:00+00:00
- 2020-11-02 04:00:00+00:00
- 2020-11-02 05:00:00+00:00
- 2020-11-02 06:00:00+00:00
- 2020-11-02 07:00:00+00:00
- 2020-11-02 08:00:00+00:00
- 2020-11-02 09:00:00+00:00
- 2020-11-02 10:00:00+00:00
- 2020-11-02 11:00:00+00:00
- 2020-11-02 12:00:00+00:00
- 2020-11-02 13:00:00+00:00
- 2020-11-02 14:00:00+00:00
- 2020-11-02 15:00:00+00:00
- 2020-11-02 16:00:00+00:00
- 2020-11-02 17:00:00+00:00
- 2020-11-02 18:00:00+00:00
- 2020-11-02 19:00:00+00:00
start: 1604260800
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_device_metrics'
- description: Time-series insight metric response for a device
examples:
- end: 1604347200
interval: 3600
limit: 168
page: 1
results:
- 10
- 11
- 12
- 12
- 10
- 9
- 9
- 9
- 10
- 10
- 11
- 11
- 11
- 11
- 11
- 11
- 11
- 10
- 11
- 11
- 10
- 11
- 11
- 10
rt:
- 2020-11-01 20:00:00+00:00
- 2020-11-01 21:00:00+00:00
- 2020-11-01 22:00:00+00:00
- 2020-11-01 23:00:00+00:00
- 2020-11-02 00:00:00+00:00
- 2020-11-02 01:00:00+00:00
- 2020-11-02 02:00:00+00:00
- 2020-11-02 03:00:00+00:00
- 2020-11-02 04:00:00+00:00
- 2020-11-02 05:00:00+00:00
- 2020-11-02 06:00:00+00:00
- 2020-11-02 07:00:00+00:00
- 2020-11-02 08:00:00+00:00
- 2020-11-02 09:00:00+00:00
- 2020-11-02 10:00:00+00:00
- 2020-11-02 11:00:00+00:00
- 2020-11-02 12:00:00+00:00
- 2020-11-02 13:00:00+00:00
- 2020-11-02 14:00:00+00:00
- 2020-11-02 15:00:00+00:00
- 2020-11-02 16:00:00+00:00
- 2020-11-02 17:00:00+00:00
- 2020-11-02 18:00:00+00:00
- 2020-11-02 19:00:00+00:00
start: 1604260800
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 1604347200
interval: 3600
limit: 168
page: 1
results:
- 10
- 11
- 12
- 12
- 10
- 9
- 9
- 9
- 10
- 10
- 11
- 11
- 11
- 11
- 11
- 11
- 11
- 10
- 11
- 11
- 10
- 11
- 11
- 10
rt:
- 2020-11-01 20:00:00+00:00
- 2020-11-01 21:00:00+00:00
- 2020-11-01 22:00:00+00:00
- 2020-11-01 23:00:00+00:00
- 2020-11-02 00:00:00+00:00
- 2020-11-02 01:00:00+00:00
- 2020-11-02 02:00:00+00:00
- 2020-11-02 03:00:00+00:00
- 2020-11-02 04:00:00+00:00
- 2020-11-02 05:00:00+00:00
- 2020-11-02 06:00:00+00:00
- 2020-11-02 07:00:00+00:00
- 2020-11-02 08:00:00+00:00
- 2020-11-02 09:00:00+00:00
- 2020-11-02 10:00:00+00:00
- 2020-11-02 11:00:00+00:00
- 2020-11-02 12:00:00+00:00
- 2020-11-02 13:00:00+00:00
- 2020-11-02 14:00:00+00:00
- 2020-11-02 15:00:00+00:00
- 2020-11-02 16:00:00+00:00
- 2020-11-02 17:00:00+00:00
- 2020-11-02 18:00:00+00:00
- 2020-11-02 19:00:00+00:00
start: 1604260800
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/insights/switch/{device_mac}/{metric}:
get:
tags:
- Sites Insights
summary: getSiteInsightMetricsForSwitch
description: >-
Get Switch Insight Metrics
See metrics possibilities at [List Insight Metrics](/#operations/listInsightMetrics)
operationId: getSiteInsightMetricsForSwitch
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: metric
in: path
description: See [List Insight Metrics]($e/Constants%20Definitions/listInsightMetrics) for available metrics
required: true
schema:
type: string
- name: device_mac
in: path
description: ''
required: true
schema:
pattern: ^[0-9a-fA-F]{12}$
type: string
examples:
- 0000000000ab
- name: port_id
in: query
description: Port ID of the switch device, e.g. `ge-0/0/1`. Can be used with metrics related to interfaces, e.g. `rx_bytes`.
style: form
explode: true
schema:
type: string
examples:
- ge-0/0/1
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: interval
in: query
description: Aggregation works by giving a time range plus interval (e.g. 1d, 1h, 10m) where aggregation function would be applied to.
style: form
explode: true
schema:
type: string
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_device_metrics'
- description: Time-series insight metric response for a device
examples:
- end: 1604347200
interval: 3600
limit: 168
page: 1
results:
- 10
- 11
- 12
- 12
- 10
- 9
- 9
- 9
- 10
- 10
- 11
- 11
- 11
- 11
- 11
- 11
- 11
- 10
- 11
- 11
- 10
- 11
- 11
- 10
rt:
- 2020-11-01 20:00:00+00:00
- 2020-11-01 21:00:00+00:00
- 2020-11-01 22:00:00+00:00
- 2020-11-01 23:00:00+00:00
- 2020-11-02 00:00:00+00:00
- 2020-11-02 01:00:00+00:00
- 2020-11-02 02:00:00+00:00
- 2020-11-02 03:00:00+00:00
- 2020-11-02 04:00:00+00:00
- 2020-11-02 05:00:00+00:00
- 2020-11-02 06:00:00+00:00
- 2020-11-02 07:00:00+00:00
- 2020-11-02 08:00:00+00:00
- 2020-11-02 09:00:00+00:00
- 2020-11-02 10:00:00+00:00
- 2020-11-02 11:00:00+00:00
- 2020-11-02 12:00:00+00:00
- 2020-11-02 13:00:00+00:00
- 2020-11-02 14:00:00+00:00
- 2020-11-02 15:00:00+00:00
- 2020-11-02 16:00:00+00:00
- 2020-11-02 17:00:00+00:00
- 2020-11-02 18:00:00+00:00
- 2020-11-02 19:00:00+00:00
start: 1604260800
contentMediaType: application/json
examples:
Example:
value:
end: 1604347200
interval: 3600
limit: 168
page: 1
results:
- 10
- 11
- 12
- 12
- 10
- 9
- 9
- 9
- 10
- 10
- 11
- 11
- 11
- 11
- 11
- 11
- 11
- 10
- 11
- 11
- 10
- 11
- 11
- 10
rt:
- 2020-11-01 20:00:00+00:00
- 2020-11-01 21:00:00+00:00
- 2020-11-01 22:00:00+00:00
- 2020-11-01 23:00:00+00:00
- 2020-11-02 00:00:00+00:00
- 2020-11-02 01:00:00+00:00
- 2020-11-02 02:00:00+00:00
- 2020-11-02 03:00:00+00:00
- 2020-11-02 04:00:00+00:00
- 2020-11-02 05:00:00+00:00
- 2020-11-02 06:00:00+00:00
- 2020-11-02 07:00:00+00:00
- 2020-11-02 08:00:00+00:00
- 2020-11-02 09:00:00+00:00
- 2020-11-02 10:00:00+00:00
- 2020-11-02 11:00:00+00:00
- 2020-11-02 12:00:00+00:00
- 2020-11-02 13:00:00+00:00
- 2020-11-02 14:00:00+00:00
- 2020-11-02 15:00:00+00:00
- 2020-11-02 16:00:00+00:00
- 2020-11-02 17:00:00+00:00
- 2020-11-02 18:00:00+00:00
- 2020-11-02 19:00:00+00:00
start: 1604260800
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_device_metrics'
- description: Time-series insight metric response for a device
examples:
- end: 1604347200
interval: 3600
limit: 168
page: 1
results:
- 10
- 11
- 12
- 12
- 10
- 9
- 9
- 9
- 10
- 10
- 11
- 11
- 11
- 11
- 11
- 11
- 11
- 10
- 11
- 11
- 10
- 11
- 11
- 10
rt:
- 2020-11-01 20:00:00+00:00
- 2020-11-01 21:00:00+00:00
- 2020-11-01 22:00:00+00:00
- 2020-11-01 23:00:00+00:00
- 2020-11-02 00:00:00+00:00
- 2020-11-02 01:00:00+00:00
- 2020-11-02 02:00:00+00:00
- 2020-11-02 03:00:00+00:00
- 2020-11-02 04:00:00+00:00
- 2020-11-02 05:00:00+00:00
- 2020-11-02 06:00:00+00:00
- 2020-11-02 07:00:00+00:00
- 2020-11-02 08:00:00+00:00
- 2020-11-02 09:00:00+00:00
- 2020-11-02 10:00:00+00:00
- 2020-11-02 11:00:00+00:00
- 2020-11-02 12:00:00+00:00
- 2020-11-02 13:00:00+00:00
- 2020-11-02 14:00:00+00:00
- 2020-11-02 15:00:00+00:00
- 2020-11-02 16:00:00+00:00
- 2020-11-02 17:00:00+00:00
- 2020-11-02 18:00:00+00:00
- 2020-11-02 19:00:00+00:00
start: 1604260800
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 1604347200
interval: 3600
limit: 168
page: 1
results:
- 10
- 11
- 12
- 12
- 10
- 9
- 9
- 9
- 10
- 10
- 11
- 11
- 11
- 11
- 11
- 11
- 11
- 10
- 11
- 11
- 10
- 11
- 11
- 10
rt:
- 2020-11-01 20:00:00+00:00
- 2020-11-01 21:00:00+00:00
- 2020-11-01 22:00:00+00:00
- 2020-11-01 23:00:00+00:00
- 2020-11-02 00:00:00+00:00
- 2020-11-02 01:00:00+00:00
- 2020-11-02 02:00:00+00:00
- 2020-11-02 03:00:00+00:00
- 2020-11-02 04:00:00+00:00
- 2020-11-02 05:00:00+00:00
- 2020-11-02 06:00:00+00:00
- 2020-11-02 07:00:00+00:00
- 2020-11-02 08:00:00+00:00
- 2020-11-02 09:00:00+00:00
- 2020-11-02 10:00:00+00:00
- 2020-11-02 11:00:00+00:00
- 2020-11-02 12:00:00+00:00
- 2020-11-02 13:00:00+00:00
- 2020-11-02 14:00:00+00:00
- 2020-11-02 15:00:00+00:00
- 2020-11-02 16:00:00+00:00
- 2020-11-02 17:00:00+00:00
- 2020-11-02 18:00:00+00:00
- 2020-11-02 19:00:00+00:00
start: 1604260800
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/setting/jse/info:
get:
tags:
- Sites JSE
summary: getSiteJseInfo
description: Retrieves the list of JSE orgs associated with the account
operationId: getSiteJseInfo
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/account_jse_info'
- description: Linked Juniper Security Exchange account information
examples:
- cloud_name: devcentral.juniperclouds.net
org_names:
- Mist-Sys
- Mist-Eng
contentMediaType: application/json
examples:
Example:
value:
cloud_name: devcentral.juniperclouds.net
org_names:
- Mist-Sys
- Mist-Eng
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/account_jse_info'
- description: Linked Juniper Security Exchange account information
examples:
- cloud_name: devcentral.juniperclouds.net
org_names:
- Mist-Sys
- Mist-Eng
contentMediaType: application/vnd.api+json
examples:
Example:
value:
cloud_name: devcentral.juniperclouds.net
org_names:
- Mist-Sys
- Mist-Eng
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/licenses/usages:
get:
tags:
- Sites Licenses
summary: getSiteLicenseUsage
description: This shows license usage (i.e. needed) based on the features enabled for the site.
operationId: getSiteLicenseUsage
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: Site License Usage
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/license_usage_site'
- description: Site license usage and entitlement response
examples:
- org_entitled:
SUB-LOC: 30
SUB-MAN: 60
svna_enabled: true
trial_enabled: true
usages:
SUB-LOC: 30
SUB-MAN: 60
vna_eligible: true
vna_ui: true
wvna_eligible: true
contentMediaType: application/json
examples:
Example:
value:
org_entitled:
SUB-LOC: 30
SUB-MAN: 60
svna_enabled: true
trial_enabled: true
usages:
SUB-LOC: 30
SUB-MAN: 60
vna_eligible: true
vna_ui: true
wvna_eligible: true
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/license_usage_site'
- description: Site license usage and entitlement response
examples:
- org_entitled:
SUB-LOC: 30
SUB-MAN: 60
svna_enabled: true
trial_enabled: true
usages:
SUB-LOC: 30
SUB-MAN: 60
vna_eligible: true
vna_ui: true
wvna_eligible: true
contentMediaType: application/vnd.api+json
examples:
Example:
value:
org_entitled:
SUB-LOC: 30
SUB-MAN: 60
svna_enabled: true
trial_enabled: true
usages:
SUB-LOC: 30
SUB-MAN: 60
vna_eligible: true
vna_ui: true
wvna_eligible: true
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/location/coverage:
get:
tags:
- Sites Location
summary: getSiteBeamCoverageOverview
description: Get Beam Coverage Overview
operationId: getSiteBeamCoverageOverview
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: map_id
in: query
description: Filter results by map identifier
style: form
explode: true
schema:
type: string
examples:
- 00000000-0000-0000-0000-000000000000
- name: type
in: query
description: 'Filter results by type. enum: `asset`, `client`, `sdkclient`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/rf_client_type'
- description: 'Filter results by type. enum: `asset`, `client`, `sdkclient`'
- name: client_type
in: query
description: Filter results by client type
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: resolution
in: query
description: 'Location calculation resolution used by the query. enum: `default`, `fine`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/resolution'
- description: 'Location calculation resolution used by the query. enum: `default`, `fine`'
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_location_coverage'
- description: Beam coverage overview for a site location map
examples:
- beams_means:
- - 1
- 3
- 3.2
- - 6
- 10
- 6.5
end: 1428954000
gridsize: 1
result_def:
- x
- y
- beams_mean
- beacons_mean
- max_rssi
- avg_rssi
results:
- - 1
- 3
- 3.2
- 18.5
- -68
- -70
- - 6
- 10
- 6.5
- 30
- 1
- -72.5
- -75
start: 1428939600
contentMediaType: application/json
examples:
Example:
value:
beams_means:
- - 1
- 3
- 3.2
- - 6
- 10
- 6.5
end: 1428954000
gridsize: 1
result_def:
- x
- y
- beams_mean
- beacons_mean
- max_rssi
- avg_rssi
results:
- - 1
- 3
- 3.2
- 18.5
- -68
- -70
- - 6
- 10
- 6.5
- 30
- 1
- -72.5
- -75
start: 1428939600
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_location_coverage'
- description: Beam coverage overview for a site location map
examples:
- beams_means:
- - 1
- 3
- 3.2
- - 6
- 10
- 6.5
end: 1428954000
gridsize: 1
result_def:
- x
- y
- beams_mean
- beacons_mean
- max_rssi
- avg_rssi
results:
- - 1
- 3
- 3.2
- 18.5
- -68
- -70
- - 6
- 10
- 6.5
- 30
- 1
- -72.5
- -75
start: 1428939600
contentMediaType: application/vnd.api+json
examples:
Example:
value:
beams_means:
- - 1
- 3
- 3.2
- - 6
- 10
- 6.5
end: 1428954000
gridsize: 1
result_def:
- x
- y
- beams_mean
- beacons_mean
- max_rssi
- avg_rssi
results:
- - 1
- 3
- 3.2
- 18.5
- -68
- -70
- - 6
- 10
- 6.5
- 30
- 1
- -72.5
- -75
start: 1428939600
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/location/ml/current:
get:
tags:
- Sites Location
summary: getSiteMachineLearningCurrentStat
description: >-
Get Machine Learning Current Stat
For each VBLE AP, it has ML model parameters (e.g. Path-loss-estimate, Intercept) as well as completion indicators (Level and PercentageComplete). For the completeness, ML takes N sample to finish its first level and use N*0.25 samples to complete each successive level. When a device is moved, the completeness will be reset as it has to re-learn.
operationId: getSiteMachineLearningCurrentStat
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: map_id
in: query
description: Filter results by map identifier
style: form
explode: true
schema:
type: string
examples:
- 00000000-0000-0000-0000-000000000000
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
uniqueItems: true
type: array
items:
type: object
description: Machine-learning response records returned as opaque objects
examples:
- - current:
Android:
completed: 36
int: -6
level: 3
ple: -3
quality: '4'
src: device
timestamp: 1442854794
iOS:
completed: 16
int: -6
level: 6
ple: -3
quality: '2'
src: default
timestamp: 1442854704
iPod:
int: -10
overwrite: true
ple: -5
src: overwrite
device_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
- beacon_id: 7913f032-aab4-c3ae-e83e-5a2756ef4d40
current:
iOS:
completed: 16
int: -6
level: 6
ple: -3
quality: last
src: device
timestamp: 1442854704
contentMediaType: application/json
examples:
Example:
value:
- current:
Android:
completed: 36
int: -6
level: 3
ple: -3
quality: '4'
src: device
timestamp: 1442854794
iOS:
completed: 16
int: -6
level: 6
ple: -3
quality: '2'
src: default
timestamp: 1442854704
iPod:
int: -10
overwrite: true
ple: -5
src: overwrite
device_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
- beacon_id: 7913f032-aab4-c3ae-e83e-5a2756ef4d40
current:
iOS:
completed: 16
int: -6
level: 6
ple: -3
quality: last
src: device
timestamp: 1442854704
application/vnd.api+json:
schema:
uniqueItems: true
type: array
items:
type: object
description: Machine-learning response records returned as opaque objects
examples:
- - current:
Android:
completed: 36
int: -6
level: 3
ple: -3
quality: '4'
src: device
timestamp: 1442854794
iOS:
completed: 16
int: -6
level: 6
ple: -3
quality: '2'
src: default
timestamp: 1442854704
iPod:
int: -10
overwrite: true
ple: -5
src: overwrite
device_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
- beacon_id: 7913f032-aab4-c3ae-e83e-5a2756ef4d40
current:
iOS:
completed: 16
int: -6
level: 6
ple: -3
quality: last
src: device
timestamp: 1442854704
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- current:
Android:
completed: 36
int: -6
level: 3
ple: -3
quality: '4'
src: device
timestamp: 1442854794
iOS:
completed: 16
int: -6
level: 6
ple: -3
quality: '2'
src: default
timestamp: 1442854704
iPod:
int: -10
overwrite: true
ple: -5
src: overwrite
device_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
- beacon_id: 7913f032-aab4-c3ae-e83e-5a2756ef4d40
current:
iOS:
completed: 16
int: -6
level: 6
ple: -3
quality: last
src: device
timestamp: 1442854704
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/location/ml/defaults:
get:
tags:
- Sites Location
summary: getSiteDefaultPlfForModels
description: Get Default PLF for Models
operationId: getSiteDefaultPlfForModels
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
uniqueItems: true
type: array
items:
type: object
description: Machine-learning response records returned as opaque objects
examples:
- - current:
Android:
completed: 36
int: -6
level: 3
ple: -3
quality: '4'
src: device
timestamp: 1442854794
iOS:
completed: 16
int: -6
level: 6
ple: -3
quality: '2'
src: default
timestamp: 1442854704
iPod:
int: -10
overwrite: true
ple: -5
src: overwrite
device_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
- beacon_id: 7913f032-aab4-c3ae-e83e-5a2756ef4d40
current:
iOS:
completed: 16
int: -6
level: 6
ple: -3
quality: last
src: device
timestamp: 1442854704
contentMediaType: application/json
examples:
Example:
value:
- current:
Android:
completed: 36
int: -6
level: 3
ple: -3
quality: '4'
src: device
timestamp: 1442854794
iOS:
completed: 16
int: -6
level: 6
ple: -3
quality: '2'
src: default
timestamp: 1442854704
iPod:
int: -10
overwrite: true
ple: -5
src: overwrite
device_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
- beacon_id: 7913f032-aab4-c3ae-e83e-5a2756ef4d40
current:
iOS:
completed: 16
int: -6
level: 6
ple: -3
quality: last
src: device
timestamp: 1442854704
application/vnd.api+json:
schema:
uniqueItems: true
type: array
items:
type: object
description: Machine-learning response records returned as opaque objects
examples:
- - current:
Android:
completed: 36
int: -6
level: 3
ple: -3
quality: '4'
src: device
timestamp: 1442854794
iOS:
completed: 16
int: -6
level: 6
ple: -3
quality: '2'
src: default
timestamp: 1442854704
iPod:
int: -10
overwrite: true
ple: -5
src: overwrite
device_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
- beacon_id: 7913f032-aab4-c3ae-e83e-5a2756ef4d40
current:
iOS:
completed: 16
int: -6
level: 6
ple: -3
quality: last
src: device
timestamp: 1442854704
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- current:
Android:
completed: 36
int: -6
level: 3
ple: -3
quality: '4'
src: device
timestamp: 1442854794
iOS:
completed: 16
int: -6
level: 6
ple: -3
quality: '2'
src: default
timestamp: 1442854704
iPod:
int: -10
overwrite: true
ple: -5
src: overwrite
device_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
- beacon_id: 7913f032-aab4-c3ae-e83e-5a2756ef4d40
current:
iOS:
completed: 16
int: -6
level: 6
ple: -3
quality: last
src: device
timestamp: 1442854704
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/location/ml/device/{device_id}:
delete:
tags:
- Sites Location
summary: clearSiteMlOverwriteForDevice
description: Clear ML Overwrite for Device
operationId: clearSiteMlOverwriteForDevice
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Sites Location
summary: overwriteSiteMlForDevice
description: Overwrite ML For Device
operationId: overwriteSiteMlForDevice
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
type: object
additionalProperties:
$ref: '#/components/schemas/ml_overwrite_additional_properties'
description: Request Body
examples:
- iOS:
int: 6
ple: -3
iPod:
int: -10
ple: -5
contentMediaType: application/json
examples:
Example:
value:
iOS:
int: 6
ple: -3
iPod:
int: -10
ple: -5
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
uniqueItems: true
type: array
items:
type: object
description: Machine-learning response records returned as opaque objects
examples:
- - current:
Android:
completed: 36
int: -6
level: 3
ple: -3
quality: '4'
src: device
timestamp: 1442854794
iOS:
completed: 16
int: -6
level: 6
ple: -3
quality: '2'
src: default
timestamp: 1442854704
iPod:
int: -10
overwrite: true
ple: -5
src: overwrite
device_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
- beacon_id: 7913f032-aab4-c3ae-e83e-5a2756ef4d40
current:
iOS:
completed: 16
int: -6
level: 6
ple: -3
quality: last
src: device
timestamp: 1442854704
contentMediaType: application/json
examples:
Example:
value:
- current:
Android:
completed: 36
int: -6
level: 3
ple: -3
quality: '4'
src: device
timestamp: 1442854794
iOS:
completed: 16
int: -6
level: 6
ple: -3
quality: '2'
src: default
timestamp: 1442854704
iPod:
int: -10
overwrite: true
ple: -5
src: overwrite
device_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
- beacon_id: 7913f032-aab4-c3ae-e83e-5a2756ef4d40
current:
iOS:
completed: 16
int: -6
level: 6
ple: -3
quality: last
src: device
timestamp: 1442854704
application/vnd.api+json:
schema:
uniqueItems: true
type: array
items:
type: object
description: Machine-learning response records returned as opaque objects
examples:
- - current:
Android:
completed: 36
int: -6
level: 3
ple: -3
quality: '4'
src: device
timestamp: 1442854794
iOS:
completed: 16
int: -6
level: 6
ple: -3
quality: '2'
src: default
timestamp: 1442854704
iPod:
int: -10
overwrite: true
ple: -5
src: overwrite
device_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
- beacon_id: 7913f032-aab4-c3ae-e83e-5a2756ef4d40
current:
iOS:
completed: 16
int: -6
level: 6
ple: -3
quality: last
src: device
timestamp: 1442854704
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- current:
Android:
completed: 36
int: -6
level: 3
ple: -3
quality: '4'
src: device
timestamp: 1442854794
iOS:
completed: 16
int: -6
level: 6
ple: -3
quality: '2'
src: default
timestamp: 1442854704
iPod:
int: -10
overwrite: true
ple: -5
src: overwrite
device_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
- beacon_id: 7913f032-aab4-c3ae-e83e-5a2756ef4d40
current:
iOS:
completed: 16
int: -6
level: 6
ple: -3
quality: last
src: device
timestamp: 1442854704
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/location/ml/map/{map_id}:
delete:
tags:
- Sites Location
summary: clearSiteMlOverwriteForMap
description: Clear ML Overwrite for Map
operationId: clearSiteMlOverwriteForMap
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: map_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Sites Location
summary: overwriteSiteMlForMap
description: Overwrite ML For Map
operationId: overwriteSiteMlForMap
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: map_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
type: object
additionalProperties:
$ref: '#/components/schemas/ml_overwrite_additional_properties'
description: Request Body
examples:
- iOS:
int: 6
ple: -3
iPod:
int: -10
ple: -5
contentMediaType: application/json
examples:
Example:
value:
iOS:
int: 6
ple: -3
iPod:
int: -10
ple: -5
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
uniqueItems: true
type: array
items:
type: object
description: Machine-learning response records returned as opaque objects
examples:
- - current:
Android:
completed: 36
int: -6
level: 3
ple: -3
quality: '4'
src: device
timestamp: 1442854794
iOS:
completed: 16
int: -6
level: 6
ple: -3
quality: '2'
src: default
timestamp: 1442854704
iPod:
int: -10
overwrite: true
ple: -5
src: overwrite
device_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
- beacon_id: 7913f032-aab4-c3ae-e83e-5a2756ef4d40
current:
iOS:
completed: 16
int: -6
level: 6
ple: -3
quality: last
src: device
timestamp: 1442854704
contentMediaType: application/json
examples:
Example:
value:
- current:
Android:
completed: 36
int: -6
level: 3
ple: -3
quality: '4'
src: device
timestamp: 1442854794
iOS:
completed: 16
int: -6
level: 6
ple: -3
quality: '2'
src: default
timestamp: 1442854704
iPod:
int: -10
overwrite: true
ple: -5
src: overwrite
device_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
- beacon_id: 7913f032-aab4-c3ae-e83e-5a2756ef4d40
current:
iOS:
completed: 16
int: -6
level: 6
ple: -3
quality: last
src: device
timestamp: 1442854704
application/vnd.api+json:
schema:
uniqueItems: true
type: array
items:
type: object
description: Machine-learning response records returned as opaque objects
examples:
- - current:
Android:
completed: 36
int: -6
level: 3
ple: -3
quality: '4'
src: device
timestamp: 1442854794
iOS:
completed: 16
int: -6
level: 6
ple: -3
quality: '2'
src: default
timestamp: 1442854704
iPod:
int: -10
overwrite: true
ple: -5
src: overwrite
device_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
- beacon_id: 7913f032-aab4-c3ae-e83e-5a2756ef4d40
current:
iOS:
completed: 16
int: -6
level: 6
ple: -3
quality: last
src: device
timestamp: 1442854704
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- current:
Android:
completed: 36
int: -6
level: 3
ple: -3
quality: '4'
src: device
timestamp: 1442854794
iOS:
completed: 16
int: -6
level: 6
ple: -3
quality: '2'
src: default
timestamp: 1442854704
iPod:
int: -10
overwrite: true
ple: -5
src: overwrite
device_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
- beacon_id: 7913f032-aab4-c3ae-e83e-5a2756ef4d40
current:
iOS:
completed: 16
int: -6
level: 6
ple: -3
quality: last
src: device
timestamp: 1442854704
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/location/ml/reset/map/{map_id}:
post:
tags:
- Sites Location
summary: resetSiteMlStatsByMap
description: Reset ML Stats by Map
operationId: resetSiteMlStatsByMap
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: map_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/maps:
get:
tags:
- Sites Maps
summary: listSiteMaps
description: Get List of Site Maps
operationId: listSiteMaps
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: mapstack_id
in: query
description: Filter maps by mapstack UUID; returns only maps belonging to that mapstack
style: form
explode: true
schema:
type: string
contentEncoding: uuid
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/map'
description: Maps or floorplans returned by the API
examples:
- - created_time: 0
flags: {}
group_idx: 1
group_name: East Wing
height: 0
height_m: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
latlng_br:
lat: string
lng: string
latlng_tl:
lat: string
lng: string
locked: true
modified_time: 0
name: string
occupancy_limit: 0
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
orientation: 0
origin_x: 0
origin_y: 0
ppm: 0
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitesurvey_path:
- coordinate: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
nodes:
- edges:
N2: string
name: string
position:
x: 0
y: 0
thumbnail_url: string
type: image
url: string
view: roadmap
wall_path:
coordinate: string
nodes:
- edges:
N2: string
name: string
position:
x: 0
y: 0
wayfinding:
micello:
account_key: string
default_level_id: 0
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
snap_to_path: true
wayfinding_path:
coordinate: string
nodes:
- edges:
N2: string
name: string
position:
x: 0
y: 0
width: 0
width_m: 0
contentMediaType: application/json
examples:
Example:
value:
- created_time: 0
flags: {}
group_idx: 1
group_name: East Wing
height: 0
height_m: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
latlng_br:
lat: string
lng: string
latlng_tl:
lat: string
lng: string
locked: true
modified_time: 0
name: string
occupancy_limit: 0
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
orientation: 0
origin_x: 0
origin_y: 0
ppm: 0
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitesurvey_path:
- coordinate: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
nodes:
- edges:
N2: string
name: string
position:
x: 0
y: 0
thumbnail_url: string
type: image
url: string
view: roadmap
wall_path:
coordinate: string
nodes:
- edges:
N2: string
name: string
position:
x: 0
y: 0
wayfinding:
micello:
account_key: string
default_level_id: 0
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
snap_to_path: true
wayfinding_path:
coordinate: string
nodes:
- edges:
N2: string
name: string
position:
x: 0
y: 0
width: 0
width_m: 0
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/map'
description: Maps or floorplans returned by the API
examples:
- - created_time: 0
flags: {}
group_idx: 1
group_name: East Wing
height: 0
height_m: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
latlng_br:
lat: string
lng: string
latlng_tl:
lat: string
lng: string
locked: true
modified_time: 0
name: string
occupancy_limit: 0
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
orientation: 0
origin_x: 0
origin_y: 0
ppm: 0
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitesurvey_path:
- coordinate: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
nodes:
- edges:
N2: string
name: string
position:
x: 0
y: 0
thumbnail_url: string
type: image
url: string
view: roadmap
wall_path:
coordinate: string
nodes:
- edges:
N2: string
name: string
position:
x: 0
y: 0
wayfinding:
micello:
account_key: string
default_level_id: 0
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
snap_to_path: true
wayfinding_path:
coordinate: string
nodes:
- edges:
N2: string
name: string
position:
x: 0
y: 0
width: 0
width_m: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- created_time: 0
flags: {}
group_idx: 1
group_name: East Wing
height: 0
height_m: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
latlng_br:
lat: string
lng: string
latlng_tl:
lat: string
lng: string
locked: true
modified_time: 0
name: string
occupancy_limit: 0
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
orientation: 0
origin_x: 0
origin_y: 0
ppm: 0
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitesurvey_path:
- coordinate: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
nodes:
- edges:
N2: string
name: string
position:
x: 0
y: 0
thumbnail_url: string
type: image
url: string
view: roadmap
wall_path:
coordinate: string
nodes:
- edges:
N2: string
name: string
position:
x: 0
y: 0
wayfinding:
micello:
account_key: string
default_level_id: 0
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
snap_to_path: true
wayfinding_path:
coordinate: string
nodes:
- edges:
N2: string
name: string
position:
x: 0
y: 0
width: 0
width_m: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Sites Maps
summary: createSiteMap
description: Create Site Map
operationId: createSiteMap
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/map'
- description: Request Body
examples:
- group_idx: 0
group_name: string
height: 0
height_m: 0
latlng_br:
lat: string
lng: string
latlng_tl:
lat: string
lng: string
locked: true
name: string
occupancy_limit: 0
orientation: 0
origin_x: 0
origin_y: 0
ppm: 0
sitesurvey_path:
- coordinate: string
name: string
nodes:
- edges:
N2: string
name: string
position:
x: 0
y: 0
type: image
view: roadmap
wall_path:
coordinate: string
nodes:
- edges:
N2: string
name: string
position:
x: 0
y: 0
wayfinding:
micello:
account_key: string
default_level_id: 0
snap_to_path: true
wayfinding_path:
coordinate: string
nodes:
- edges:
N2: string
name: string
position:
x: 0
y: 0
width: 0
width_m: 0
contentMediaType: application/json
examples:
Example:
value:
group_idx: 0
group_name: string
height: 0
height_m: 0
latlng_br:
lat: string
lng: string
latlng_tl:
lat: string
lng: string
locked: true
name: string
occupancy_limit: 0
orientation: 0
origin_x: 0
origin_y: 0
ppm: 0
sitesurvey_path:
- coordinate: string
name: string
nodes:
- edges:
N2: string
name: string
position:
x: 0
y: 0
type: image
view: roadmap
wall_path:
coordinate: string
nodes:
- edges:
N2: string
name: string
position:
x: 0
y: 0
wayfinding:
micello:
account_key: string
default_level_id: 0
snap_to_path: true
wayfinding_path:
coordinate: string
nodes:
- edges:
N2: string
name: string
position:
x: 0
y: 0
width: 0
width_m: 0
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/map'
- description: Map or floorplan metadata for a site or organization
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/map'
- description: Map or floorplan metadata for a site or organization
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/maps/auto_geofences:
post:
tags:
- Sites Maps
summary: startSiteMapsAutoGeofence
description: The auto geofence service is a map parsing service that uses map image data to identify the exterior of buildings in the map image also known as "geofences". This API processes all maps for a given SiteId. The maps must have an image to parse for the auto geofence service. Repeated POST requests to this endpoint while the auto geofence service is processing the map will be rejected.
operationId: startSiteMapsAutoGeofence
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/maps/import:
post:
tags:
- Sites Maps
summary: importSiteMaps
description: >-
Import data from files is a multipart POST which has an file, an optional json, and an optional csv, to create floorplan, assign matching inventory to specific site, place ap if name or mac matches.
# Note
This endpoint (at the site level), the AP must be already assigned to the site to be placed on the floorplan. If you want to place APs from the Org inventory, it is required to use the endpoint at the Org level [importOrgMaps](#operation/importOrgMaps)
# CSV File Format
```csv
Vendor AP name,Mist AP Mac
US Office AP-2,5c:5b:35:00:00:02
US Office AP-3,5c5b35000002
```
operationId: importSiteMaps
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
content:
multipart/form-data:
encoding: {}
schema:
type: object
properties:
auto_deviceprofile_assignment:
type: boolean
description: Whether to auto assign device to deviceprofile by name
examples:
- true
csv:
type: string
description: Optional AP name-mapping CSV file
contentEncoding: base64
file:
type: string
description: Ekahau or iBwave floorplan file to import
contentEncoding: base64
json:
allOf:
- $ref: '#/components/schemas/map_import_json1'
- description: Import options for the site map file
contentMediaType: multipart/form-data
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_map_import'
- description: Result of importing map files and matching AP placements
examples:
- '{"aps":[{"action":"assigned-placed","floorplan_id":"6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9","height":3,"mac":"5c5b35000001","map_id":"845a23bf-bed9-e43c-4c86-6fa474be7ae5","orientation":45}],"floorplans":[{"action":"imported","id":"cbdb7f0b-3be0-4872-88f9-58790b509c23","map_id":"845a23bf-bed9-e43c-4c86-6fa474be7ae5","name":"map1"}],"site_id":"4ac1dcf4-9d8b-7211-65c4-057819f0862b","summary":{"num_ap_assigned":1,"num_inv_assigned":1,"num_map_assigned":1}}'
- '{"aps":[{"action":"assigned-named-placed","floorplan_id":"6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9","mac":"5c5b35000001","map_id":"845a23bf-bed9-e43c-4c86-6fa474be7ae5","orientation":45}],"floorplans":[{"action":"imported","id":"cbdb7f0b-3be0-4872-88f9-58790b509c23","map_id":"845a23bf-bed9-e43c-4c86-6fa474be7ae5","name":"map1"}],"site_id":"4ac1dcf4-9d8b-7211-65c4-057819f0862b","summary":{"num_ap_assigned":1,"num_inv_assigned":1,"num_map_assigned":1}}'
- '{"aps":[{"action":"placed","floorplan_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","height":3,"mac":"5c5b35000001","map_id":"845a23bf-bed9-e43c-4c86-6fa474be7ae5","orientation":45}],"floorplans":[{"action":"imported","id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","map_id":"845a23bf-bed9-e43c-4c86-6fa474be7ae5","name":"map1"}],"site_id":"4ac1dcf4-9d8b-7211-65c4-057819f0862b","summary":{"num_ap_assigned":1,"num_inv_assigned":1,"num_map_assigned":1}}'
contentMediaType: application/json
examples:
Assigned And Placed:
value:
aps:
- action: assigned-placed
floorplan_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
height: 3
mac: 5c5b35000001
map_id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
orientation: 45
floorplans:
- action: imported
id: cbdb7f0b-3be0-4872-88f9-58790b509c23
map_id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
name: map1
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
summary:
num_ap_assigned: 1
num_inv_assigned: 1
num_map_assigned: 1
Assigned Named And Placed:
value:
aps:
- action: assigned-named-placed
floorplan_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
mac: 5c5b35000001
map_id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
orientation: 45
floorplans:
- action: imported
id: cbdb7f0b-3be0-4872-88f9-58790b509c23
map_id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
name: map1
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
summary:
num_ap_assigned: 1
num_inv_assigned: 1
num_map_assigned: 1
Placed:
value:
aps:
- action: placed
floorplan_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
height: 3
mac: 5c5b35000001
map_id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
orientation: 45
floorplans:
- action: imported
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
map_id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
name: map1
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
summary:
num_ap_assigned: 1
num_inv_assigned: 1
num_map_assigned: 1
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_map_import'
- description: Result of importing map files and matching AP placements
examples:
- '{"aps":[{"action":"assigned-placed","floorplan_id":"6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9","height":3,"mac":"5c5b35000001","map_id":"845a23bf-bed9-e43c-4c86-6fa474be7ae5","orientation":45}],"floorplans":[{"action":"imported","id":"cbdb7f0b-3be0-4872-88f9-58790b509c23","map_id":"845a23bf-bed9-e43c-4c86-6fa474be7ae5","name":"map1"}],"site_id":"4ac1dcf4-9d8b-7211-65c4-057819f0862b","summary":{"num_ap_assigned":1,"num_inv_assigned":1,"num_map_assigned":1}}'
- '{"aps":[{"action":"assigned-named-placed","floorplan_id":"6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9","mac":"5c5b35000001","map_id":"845a23bf-bed9-e43c-4c86-6fa474be7ae5","orientation":45}],"floorplans":[{"action":"imported","id":"cbdb7f0b-3be0-4872-88f9-58790b509c23","map_id":"845a23bf-bed9-e43c-4c86-6fa474be7ae5","name":"map1"}],"site_id":"4ac1dcf4-9d8b-7211-65c4-057819f0862b","summary":{"num_ap_assigned":1,"num_inv_assigned":1,"num_map_assigned":1}}'
- '{"aps":[{"action":"placed","floorplan_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","height":3,"mac":"5c5b35000001","map_id":"845a23bf-bed9-e43c-4c86-6fa474be7ae5","orientation":45}],"floorplans":[{"action":"imported","id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","map_id":"845a23bf-bed9-e43c-4c86-6fa474be7ae5","name":"map1"}],"site_id":"4ac1dcf4-9d8b-7211-65c4-057819f0862b","summary":{"num_ap_assigned":1,"num_inv_assigned":1,"num_map_assigned":1}}'
contentMediaType: application/vnd.api+json
examples:
Assigned And Placed:
value:
aps:
- action: assigned-placed
floorplan_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
height: 3
mac: 5c5b35000001
map_id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
orientation: 45
floorplans:
- action: imported
id: cbdb7f0b-3be0-4872-88f9-58790b509c23
map_id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
name: map1
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
summary:
num_ap_assigned: 1
num_inv_assigned: 1
num_map_assigned: 1
Assigned Named And Placed:
value:
aps:
- action: assigned-named-placed
floorplan_id: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
mac: 5c5b35000001
map_id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
orientation: 45
floorplans:
- action: imported
id: cbdb7f0b-3be0-4872-88f9-58790b509c23
map_id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
name: map1
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
summary:
num_ap_assigned: 1
num_inv_assigned: 1
num_map_assigned: 1
Placed:
value:
aps:
- action: placed
floorplan_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
height: 3
mac: 5c5b35000001
map_id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
orientation: 45
floorplans:
- action: imported
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
map_id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
name: map1
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
summary:
num_ap_assigned: 1
num_inv_assigned: 1
num_map_assigned: 1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/maps/{map_id}:
delete:
tags:
- Sites Maps
summary: deleteSiteMap
description: Delete Site Map
operationId: deleteSiteMap
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: map_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Sites Maps
summary: getSiteMap
description: Get Site Map Details
operationId: getSiteMap
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: map_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/map'
- description: Map or floorplan metadata for a site or organization
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/map'
- description: Map or floorplan metadata for a site or organization
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Sites Maps
summary: updateSiteMap
description: Update Site Map
operationId: updateSiteMap
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: map_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/map'
- description: Request Body
examples:
- height: 0
height_m: 0
latlng_br:
lat: string
lng: string
latlng_tl:
lat: string
lng: string
locked: true
name: string
occupancy_limit: 0
orientation: 0
origin_x: 0
origin_y: 0
ppm: 0
sitesurvey_path:
- coordinate: string
name: string
nodes:
- edges:
N2: string
name: string
position:
x: 0
y: 0
type: image
view: roadmap
wall_path:
coordinate: string
nodes:
- edges:
N2: string
name: string
position:
x: 0
y: 0
wayfinding:
micello:
account_key: string
default_level_id: 0
snap_to_path: true
wayfinding_path:
coordinate: string
nodes:
- edges:
N2: string
name: string
position:
x: 0
y: 0
width: 0
width_m: 0
contentMediaType: application/json
examples:
Example:
value:
height: 0
height_m: 0
latlng_br:
lat: string
lng: string
latlng_tl:
lat: string
lng: string
locked: true
name: string
occupancy_limit: 0
orientation: 0
origin_x: 0
origin_y: 0
ppm: 0
sitesurvey_path:
- coordinate: string
name: string
nodes:
- edges:
N2: string
name: string
position:
x: 0
y: 0
type: image
view: roadmap
wall_path:
coordinate: string
nodes:
- edges:
N2: string
name: string
position:
x: 0
y: 0
wayfinding:
micello:
account_key: string
default_level_id: 0
snap_to_path: true
wayfinding_path:
coordinate: string
nodes:
- edges:
N2: string
name: string
position:
x: 0
y: 0
width: 0
width_m: 0
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/map'
- description: Map or floorplan metadata for a site or organization
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/map'
- description: Map or floorplan metadata for a site or organization
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/maps/{map_id}/auto_geofences:
post:
tags:
- Sites Maps
summary: startSiteMapAutoGeofence
description: The auto geofence service is a map parsing service that uses map image data to identify the exterior of buildings in the map image also known as "geofences". This API processes a single given MapId. This map must have an image to parse for the auto geofence service. Repeated POST requests to this endpoint while the auto geofence service is processing the map will be rejected.
operationId: startSiteMapAutoGeofence
parameters:
- name: map_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/maps/{map_id}/image:
delete:
tags:
- Sites Maps
summary: deleteSiteMapImage
description: Delete Site Map Image
operationId: deleteSiteMapImage
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: map_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Sites Maps
summary: addSiteMapImage
description: Add image map is a multipart POST which has an file (Image) and an optional json parameter
operationId: addSiteMapImage
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: map_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
content:
multipart/form-data:
encoding: {}
schema:
required:
- file
type: object
properties:
file:
type: string
description: Image file content uploaded as multipart form data
contentEncoding: base64
json:
type: string
description: Optional JSON metadata submitted with the image upload
contentMediaType: multipart/form-data
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/maps/{map_id}/replace:
post:
tags:
- Sites Maps
summary: replaceSiteMapImage
description: >-
Replace Map Image
This works like an PUT where the image will be replaced. If transform is provided, all the locations of the objects on the map (AP, Zone, Vbeacon, Beacon) will be transformed as well (relative to the new Map)
operationId: replaceSiteMapImage
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: map_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
content:
multipart/form-data:
encoding: {}
schema:
required:
- file
type: object
properties:
file:
type: string
description: Map image file used to replace the existing site map
contentEncoding: base64
json:
allOf:
- $ref: '#/components/schemas/map_site_replace_file_json2'
- description: Replacement transform options for the map image
contentMediaType: multipart/form-data
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/maps/{map_id}/set_map:
post:
tags:
- Sites Maps
summary: bulkAssignSiteApsToMap
description: "This API can be used to assign a list of AP Macs associated with site_id to the specified map_id. Note that map_id must be associated with corresponding site_id. This API obeys the following rules \n1. if AP is unassigned to any Map, it gets associated with map_id \n2. Any moved APs are returned in the response \n3. If the AP is considered a locked AP, no action will be taken"
operationId: bulkAssignSiteApsToMap
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: map_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/mac_addresses'
- examples:
- macs:
- 5c5b35000001
- 5c5b35584a6f
contentMediaType: application/json
examples:
Example:
value:
macs:
- 5c5b35000001
- 5c5b35584a6f
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_set_devices_map'
- description: Result of assigning APs to a site map
examples:
- locked:
- 5c5b35584a6f
moved:
- 5c5b35000001
contentMediaType: application/json
examples:
Example:
value:
locked:
- 5c5b35584a6f
moved:
- 5c5b35000001
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_set_devices_map'
- description: Result of assigning APs to a site map
examples:
- locked:
- 5c5b35584a6f
moved:
- 5c5b35000001
contentMediaType: application/vnd.api+json
examples:
Example:
value:
locked:
- 5c5b35584a6f
moved:
- 5c5b35000001
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/maps/{map_id}/wayfinding/import:
post:
tags:
- Sites Maps
summary: importSiteWayfindings
description: This imports the vendor map meta data into the Map JSON. This is required by the SDK and App in order to access/render the vendor Map properly.
operationId: importSiteWayfindings
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: map_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/wayfinding_import_json'
- description: Request Body
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/maps/{map_id}/apply_autoplacement:
post:
tags:
- Sites Maps - Auto-placement
summary: acceptSiteApLocalizationData
description: >-
Accept the cached autoplacement and auto-orientation values of a map or subset of APs on a map. Any APs that have autoplacement values are stored in cache for up to 7 days while awaiting acceptance.
Accepting the autoplacement values overwrites the existing X, Y, and orientation of the accepted APs with their cached autoplacement values.
Once a decision to accept is made, or the 7-day time-to-live (TTL) expires, the cached values are deleted.
operationId: acceptSiteApLocalizationData
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: map_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/autoplacement_localization_selector'
- description: Request Body
examples:
- for: placement
macs:
- 5c5b35000001
contentMediaType: application/json
examples:
Example:
value:
for: placement
macs:
- 5c5b35000001
required: false
responses:
'200':
description: Success
headers: {}
content: {}
'400':
description: Map does not exist or belong to specified site / Invalid localization service. Expected [placement, orientation]
headers: {}
content: {}
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/maps/{map_id}/auto_orient:
delete:
tags:
- Sites Maps - Auto-placement
summary: deleteSiteApAutoOrientation
description: This API is called to force stop auto placement for a given map
operationId: deleteSiteApAutoOrientation
parameters:
- name: map_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: Auto orient process has stopped for this map
headers: {}
content: {}
'400':
description: Autoplacement was not triggered
headers: {}
content: {}
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Sites Maps - Auto-placement
summary: getSiteApAutoOrientation
description: This API is called to view the current status of auto orient for a given map.
operationId: getSiteApAutoOrientation
parameters:
- name: map_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: Map queued for auto orientation
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_auto_orientation_info'
- description: Auto orientation status response
examples:
- '{"start_time":1678900062,"status":"done","stop_time":1678900362}'
- '{"est_time_left":300.0,"start_time":1678900062,"status":"inprogress"}'
contentMediaType: application/json
examples:
Completed:
value:
start_time: 1678900062
status: done
stop_time: 1678900362
In Progress:
value:
est_time_left: 300
start_time: 1678900062
status: inprogress
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_auto_orientation_info'
- description: Auto orientation status response
examples:
- '{"start_time":1678900062,"status":"done","stop_time":1678900362}'
- '{"est_time_left":300.0,"start_time":1678900062,"status":"inprogress"}'
contentMediaType: application/vnd.api+json
examples:
Completed:
value:
start_time: 1678900062
status: done
stop_time: 1678900362
In Progress:
value:
est_time_left: 300
start_time: 1678900062
status: inprogress
'400':
description: Autoplacement was not triggered
headers: {}
content: {}
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Sites Maps - Auto-placement
summary: startSiteApAutoOrientation
description: >-
This API is called to trigger a map for auto orient. For auto orient feature to work, BLE data needs to be collected from the APs on the map. This precess is not disruptive unlike FTM collection. Repeated POST requests to this endpoint while a map is still running will be rejected.
`force_collection` is set to `false` by default. If `force_collection`==`false`, the API attempts to start orientation with existing data. If no data exists, the API attempts to start collecting orientation data. If `force_collection`==`true`, the API attempts to start collecting orientation data.
Providing a list of device macs is optional. If provided, auto orientation suggestions will be made only for the specified devices. If no list is provided, all APs associated with the map are considered by default.
operationId: startSiteApAutoOrientation
parameters:
- name: map_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/auto_orient'
required: false
responses:
'200':
description: Map queued for auto orientation
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_auto_orientation'
- description: Auto orientation start response
examples:
- '{"devices":{"00000000001":{"reason":"Device meets the minimum requirements for auto orient","valid":true},"00000000002":{"reason":"Device meets the minimum requirements for auto orient","valid":true},"00000000003":{"reason":"Device meets the minimum requirements for auto orient","valid":true}},"estimated_runtime":300,"reason":"Map has met the minimum requirements for auto orient","valid":true,"wifi_interrupting":true}'
- '{"devices":{"00000000001":{"valid":true},"00000000002":{"valid":true},"00000000003":{"valid":true}},"estimated_runtime":300,"reason":"Map Already Enqueued","started":false,"valid":true,"wifi_interrupting":true}'
- '{"devices":{"00000000001":{"valid":true},"00000000002":{"valid":true},"00000000003":{"valid":true},"00000000004":{"reason":"Device model AP41 is not supported for auto orient","valid":false},"00000000005":{"reason":"Device firmware 0.14.28300 does not meet the minimum requirement 0.14.28310","valid":false}},"reason":"Map has APs that do not meet the minimum requirements for auto orient","started":false,"valid":false}'
- '{"devices":{"00000000001":{"valid":true},"00000000002":{"valid":true},"00000000003":{"valid":true},"00000000004":{"reason":"Device model AP32 is not supported for auto orient","valid":false},"00000000005":{"reason":"Device firmware 0.14.28300 does not meet the minimum requirement 0.14.28310","valid":false}},"estimated_runtime":300,"reason":"Started collection for auto orient","started":true,"valid":false}'
- '{"devices":{"00000000001":{"valid":true},"00000000002":{"valid":true},"00000000003":{"valid":true}},"estimated_runtime":300,"reason":"Started collection for auto orient","started":true,"valid":true}'
- '{"devices":{"00000000001":{"valid":true},"00000000002":{"valid":true},"00000000003":{"valid":true}},"estimated_runtime":300,"reason":"Unable to reach auto orient service","started":false,"valid":true,"wifi_interrupting":true}'
contentMediaType: application/json
examples:
Dryrun For Map Completed:
value:
devices:
'00000000001':
reason: Device meets the minimum requirements for auto orient
valid: true
'00000000002':
reason: Device meets the minimum requirements for auto orient
valid: true
'00000000003':
reason: Device meets the minimum requirements for auto orient
valid: true
estimated_runtime: 300
reason: Map has met the minimum requirements for auto orient
valid: true
wifi_interrupting: true
Map Failed To Start As It Had Less Than 3 APs Associated With It:
value:
devices:
'00000000001':
valid: true
'00000000002':
valid: true
'00000000003':
valid: true
estimated_runtime: 300
reason: Map Already Enqueued
started: false
valid: true
wifi_interrupting: true
Service Failed To Start Due Containing Invalid APs:
value:
devices:
'00000000001':
valid: true
'00000000002':
valid: true
'00000000003':
valid: true
'00000000004':
reason: Device model AP41 is not supported for auto orient
valid: false
'00000000005':
reason: Device firmware 0.14.28300 does not meet the minimum requirement 0.14.28310
valid: false
reason: Map has APs that do not meet the minimum requirements for auto orient
started: false
valid: false
Service Started After Override For Localization / Orient Collection:
value:
devices:
'00000000001':
valid: true
'00000000002':
valid: true
'00000000003':
valid: true
'00000000004':
reason: Device model AP32 is not supported for auto orient
valid: false
'00000000005':
reason: Device firmware 0.14.28300 does not meet the minimum requirement 0.14.28310
valid: false
estimated_runtime: 300
reason: Started collection for auto orient
started: true
valid: false
Service Started Successfully For Localization / Orient Collection:
value:
devices:
'00000000001':
valid: true
'00000000002':
valid: true
'00000000003':
valid: true
estimated_runtime: 300
reason: Started collection for auto orient
started: true
valid: true
Unable To Reach The Orient Service:
value:
devices:
'00000000001':
valid: true
'00000000002':
valid: true
'00000000003':
valid: true
estimated_runtime: 300
reason: Unable to reach auto orient service
started: false
valid: true
wifi_interrupting: true
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_auto_orientation'
- description: Auto orientation start response
examples:
- '{"devices":{"00000000001":{"reason":"Device meets the minimum requirements for auto orient","valid":true},"00000000002":{"reason":"Device meets the minimum requirements for auto orient","valid":true},"00000000003":{"reason":"Device meets the minimum requirements for auto orient","valid":true}},"estimated_runtime":300,"reason":"Map has met the minimum requirements for auto orient","valid":true,"wifi_interrupting":true}'
- '{"devices":{"00000000001":{"valid":true},"00000000002":{"valid":true},"00000000003":{"valid":true}},"estimated_runtime":300,"reason":"Map Already Enqueued","started":false,"valid":true,"wifi_interrupting":true}'
- '{"devices":{"00000000001":{"valid":true},"00000000002":{"valid":true},"00000000003":{"valid":true},"00000000004":{"reason":"Device model AP41 is not supported for auto orient","valid":false},"00000000005":{"reason":"Device firmware 0.14.28300 does not meet the minimum requirement 0.14.28310","valid":false}},"reason":"Map has APs that do not meet the minimum requirements for auto orient","started":false,"valid":false}'
- '{"devices":{"00000000001":{"valid":true},"00000000002":{"valid":true},"00000000003":{"valid":true},"00000000004":{"reason":"Device model AP32 is not supported for auto orient","valid":false},"00000000005":{"reason":"Device firmware 0.14.28300 does not meet the minimum requirement 0.14.28310","valid":false}},"estimated_runtime":300,"reason":"Started collection for auto orient","started":true,"valid":false}'
- '{"devices":{"00000000001":{"valid":true},"00000000002":{"valid":true},"00000000003":{"valid":true}},"estimated_runtime":300,"reason":"Started collection for auto orient","started":true,"valid":true}'
- '{"devices":{"00000000001":{"valid":true},"00000000002":{"valid":true},"00000000003":{"valid":true}},"estimated_runtime":300,"reason":"Unable to reach auto orient service","started":false,"valid":true,"wifi_interrupting":true}'
contentMediaType: application/vnd.api+json
examples:
Dryrun For Map Completed:
value:
devices:
'00000000001':
reason: Device meets the minimum requirements for auto orient
valid: true
'00000000002':
reason: Device meets the minimum requirements for auto orient
valid: true
'00000000003':
reason: Device meets the minimum requirements for auto orient
valid: true
estimated_runtime: 300
reason: Map has met the minimum requirements for auto orient
valid: true
wifi_interrupting: true
Map Failed To Start As It Had Less Than 3 APs Associated With It:
value:
devices:
'00000000001':
valid: true
'00000000002':
valid: true
'00000000003':
valid: true
estimated_runtime: 300
reason: Map Already Enqueued
started: false
valid: true
wifi_interrupting: true
Service Failed To Start Due Containing Invalid APs:
value:
devices:
'00000000001':
valid: true
'00000000002':
valid: true
'00000000003':
valid: true
'00000000004':
reason: Device model AP41 is not supported for auto orient
valid: false
'00000000005':
reason: Device firmware 0.14.28300 does not meet the minimum requirement 0.14.28310
valid: false
reason: Map has APs that do not meet the minimum requirements for auto orient
started: false
valid: false
Service Started After Override For Localization / Orient Collection:
value:
devices:
'00000000001':
valid: true
'00000000002':
valid: true
'00000000003':
valid: true
'00000000004':
reason: Device model AP32 is not supported for auto orient
valid: false
'00000000005':
reason: Device firmware 0.14.28300 does not meet the minimum requirement 0.14.28310
valid: false
estimated_runtime: 300
reason: Started collection for auto orient
started: true
valid: false
Service Started Successfully For Localization / Orient Collection:
value:
devices:
'00000000001':
valid: true
'00000000002':
valid: true
'00000000003':
valid: true
estimated_runtime: 300
reason: Started collection for auto orient
started: true
valid: true
Unable To Reach The Orient Service:
value:
devices:
'00000000001':
valid: true
'00000000002':
valid: true
'00000000003':
valid: true
estimated_runtime: 300
reason: Unable to reach auto orient service
started: false
valid: true
wifi_interrupting: true
'400':
description: Bad Request
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_detail_string'
- description: Response containing a human-readable detail message
examples:
- '{"detail":"Map has less than 3 APs associated with it to perform auto orient"}'
- '{"detail":"Auto AP orient is already in progress for this Map"}'
- '{"detail":"Auto orient data does not exist or has gone stale"}'
contentMediaType: application/json
examples:
Example:
value:
detail: Map has less than 3 APs associated with it to perform auto orient
Example-2:
value:
detail: Auto AP orient is already in progress for this Map
Example-3:
value:
detail: Auto orient data does not exist or has gone stale
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_detail_string'
- description: Response containing a human-readable detail message
examples:
- '{"detail":"Map has less than 3 APs associated with it to perform auto orient"}'
- '{"detail":"Auto AP orient is already in progress for this Map"}'
- '{"detail":"Auto orient data does not exist or has gone stale"}'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Map has less than 3 APs associated with it to perform auto orient
Example-2:
value:
detail: Auto AP orient is already in progress for this Map
Example-3:
value:
detail: Auto orient data does not exist or has gone stale
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/maps/{map_id}/auto_placement:
delete:
tags:
- Sites Maps - Auto-placement
summary: deleteSiteApAutoplacement
description: This API is called to force stop auto placement for a given map
operationId: deleteSiteApAutoplacement
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: map_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: Autoplacement Process has stopped for this map
headers: {}
content: {}
'400':
description: Autoplacement was not triggered
headers: {}
content: {}
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Sites Maps - Auto-placement
summary: getSiteApAutoPlacement
description: >-
This API is called to view the current status of auto placement for a given map.
#### Status Descriptions
| Status | Description |
| --- | --- |
| `pending` | Autoplacement has not been requested for this map |
| `inprogress` | Autoplacement is currently processing |
| `done` | The autoplacement process has completed |
| `data_needed` | Additional position data is required for autoplacement. Users should verify the requested anchor APs have a position on the map |
| `invalid_model` | Autoplacement is not supported on the model of the APs on the map |
| `invalid_version` | Autoplacement is not supported with the APs current firmware version |
| `error` | There was an error in the autoplacement process |
operationId: getSiteApAutoPlacement
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: map_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_auto_placement_info'
- description: Auto-placement status response with progress and validation details
examples:
- '{"end_time":1678900362,"start_time":1678900062,"status":"done"}'
- '{"end_time":1678900362,"start_time":1678900062,"status":"error"}'
- '{"est_time_left":300,"start_time":1678900062,"status":"inprogress"}'
- '{"status":"pending"}'
contentMediaType: application/json
examples:
Done:
value:
end_time: 1678900362
start_time: 1678900062
status: done
Error:
value:
end_time: 1678900362
start_time: 1678900062
status: error
In Progress:
value:
est_time_left: 300
start_time: 1678900062
status: inprogress
Pending:
value:
status: pending
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_auto_placement_info'
- description: Auto-placement status response with progress and validation details
examples:
- '{"end_time":1678900362,"start_time":1678900062,"status":"done"}'
- '{"end_time":1678900362,"start_time":1678900062,"status":"error"}'
- '{"est_time_left":300,"start_time":1678900062,"status":"inprogress"}'
- '{"status":"pending"}'
contentMediaType: application/vnd.api+json
examples:
Done:
value:
end_time: 1678900362
start_time: 1678900062
status: done
Error:
value:
end_time: 1678900362
start_time: 1678900062
status: error
In Progress:
value:
est_time_left: 300
start_time: 1678900062
status: inprogress
Pending:
value:
status: pending
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Sites Maps - Auto-placement
summary: runSiteApAutoplacement
description: "This API is called to trigger auto placement for a map. For the auto placement feature to work, RTT-FTM data needs to be collected from the APs on the map. \nThis scan is disruptive, and users must be notified of service disruption during the auto placement process. Repeated POST requests to this endpoint while a map is still running will be rejected.\n\n\n`force_collection` is set to `false` by default. If `force_collection` is set to `false`, the API attempts to start localization with existing data. If no data exists, the API attempts to start orchestration. \nIf `force_collection` is set to `true`, the API attempts to start orchestration.\n\n\nProviding a list of devices is optional. If provided, autoplacement suggestions will be made only for the specified devices. If no list is provided, all APs associated with the map are considered by default."
operationId: runSiteApAutoplacement
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: map_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/auto_placement'
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_autoplacement'
- description: Auto-placement start response returned after scheduling the run
examples:
- '{"devices":{"00000000001":{"valid":true},"00000000002":{"valid":true},"00000000003":{"valid":true}},"estimated_runtime":30,"reason":"Map Already Enqueued","started":false,"valid":true,"wifi_interrupting":true}'
- '{"devices":{"00000000001":{"valid":true},"00000000002":{"valid":true},"00000000003":{"valid":true}},"estimated_runtime":30,"reason":"Map has met the minimum requirements for auto placement","valid":true,"wifi_interrupting":true}'
- '{"devices":{},"reason":"Map has less than 3 APs associated with it to perform auto placement","started":false,"valid":false}'
- '{"devices":{"00000000001":{"valid":true},"00000000002":{"valid":true},"00000000003":{"valid":true},"00000000004":{"reason":"Device model AP41 is not supported for auto placement","valid":false},"00000000005":{"reason":"Device firmware 0.14.28300 does not meet the minimum requirement 0.14.28310","valid":false}},"reason":"Map has APs that do not meet the minimum requirements for auto placement","started":false,"valid":false}'
- '{"devices":{"00000000001":{"valid":true},"00000000002":{"valid":true},"00000000003":{"valid":true},"00000000004":{"reason":"Device model AP41 is not supported for auto placement","valid":false},"00000000005":{"reason":"Device firmware 0.14.28300 does not meet the minimum requirement 0.14.28310","valid":false}},"reason":"Started localization for auto placement","started":true,"valid":false}'
- '{"devices":{"00000000001":{"valid":true},"00000000002":{"valid":true},"00000000003":{"valid":true},"00000000004":{"reason":"Device model AP41 is not supported for auto placement","valid":false},"00000000005":{"reason":"Device firmware 0.14.28300 does not meet the minimum requirement 0.14.28310","valid":false}},"estimated_runtime":30,"reason":"Started collection for auto placement","started":true,"valid":false,"wifi_interrupting":true}'
- '{"devices":{"00000000001":{"valid":true},"00000000002":{"valid":true},"00000000003":{"valid":true}},"reason":"Started localization for auto placement","started":true,"valid":true}'
- '{"devices":{"00000000001":{"valid":true},"00000000002":{"valid":true},"00000000003":{"valid":true}},"estimated_runtime":30,"reason":"Started collection for auto placement","started":true,"valid":true,"wifi_interrupting":true}'
- '{"devices":{"00000000001":{"valid":true},"00000000002":{"valid":true},"00000000003":{"valid":true}},"estimated_runtime":30,"reason":"Unable to reach auto placement service","started":false,"valid":true,"wifi_interrupting":true}'
contentMediaType: application/json
examples:
Auto placement is already in progress for this map:
value:
devices:
'00000000001':
valid: true
'00000000002':
valid: true
'00000000003':
valid: true
estimated_runtime: 30
reason: Map Already Enqueued
started: false
valid: true
wifi_interrupting: true
Dryrun for map completed:
value:
devices:
'00000000001':
valid: true
'00000000002':
valid: true
'00000000003':
valid: true
estimated_runtime: 30
reason: Map has met the minimum requirements for auto placement
valid: true
wifi_interrupting: true
Map failed to start as it had less than 3 APs associated with it:
value:
devices: {}
reason: Map has less than 3 APs associated with it to perform auto placement
started: false
valid: false
Service failed to start due containing invalid APs:
value:
devices:
'00000000001':
valid: true
'00000000002':
valid: true
'00000000003':
valid: true
'00000000004':
reason: Device model AP41 is not supported for auto placement
valid: false
'00000000005':
reason: Device firmware 0.14.28300 does not meet the minimum requirement 0.14.28310
valid: false
reason: Map has APs that do not meet the minimum requirements for auto placement
started: false
valid: false
Service started after override for localization:
value:
devices:
'00000000001':
valid: true
'00000000002':
valid: true
'00000000003':
valid: true
'00000000004':
reason: Device model AP41 is not supported for auto placement
valid: false
'00000000005':
reason: Device firmware 0.14.28300 does not meet the minimum requirement 0.14.28310
valid: false
reason: Started localization for auto placement
started: true
valid: false
Service started after override for orchestration:
value:
devices:
'00000000001':
valid: true
'00000000002':
valid: true
'00000000003':
valid: true
'00000000004':
reason: Device model AP41 is not supported for auto placement
valid: false
'00000000005':
reason: Device firmware 0.14.28300 does not meet the minimum requirement 0.14.28310
valid: false
estimated_runtime: 30
reason: Started collection for auto placement
started: true
valid: false
wifi_interrupting: true
Service started successfully for localization:
value:
devices:
'00000000001':
valid: true
'00000000002':
valid: true
'00000000003':
valid: true
reason: Started localization for auto placement
started: true
valid: true
Service started successfully for orchestration:
value:
devices:
'00000000001':
valid: true
'00000000002':
valid: true
'00000000003':
valid: true
estimated_runtime: 30
reason: Started collection for auto placement
started: true
valid: true
wifi_interrupting: true
Unable to reach the autoplacement service:
value:
devices:
'00000000001':
valid: true
'00000000002':
valid: true
'00000000003':
valid: true
estimated_runtime: 30
reason: Unable to reach auto placement service
started: false
valid: true
wifi_interrupting: true
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_autoplacement'
- description: Auto-placement start response returned after scheduling the run
examples:
- '{"devices":{"00000000001":{"valid":true},"00000000002":{"valid":true},"00000000003":{"valid":true}},"estimated_runtime":30,"reason":"Map Already Enqueued","started":false,"valid":true,"wifi_interrupting":true}'
- '{"devices":{"00000000001":{"valid":true},"00000000002":{"valid":true},"00000000003":{"valid":true}},"estimated_runtime":30,"reason":"Map has met the minimum requirements for auto placement","valid":true,"wifi_interrupting":true}'
- '{"devices":{},"reason":"Map has less than 3 APs associated with it to perform auto placement","started":false,"valid":false}'
- '{"devices":{"00000000001":{"valid":true},"00000000002":{"valid":true},"00000000003":{"valid":true},"00000000004":{"reason":"Device model AP41 is not supported for auto placement","valid":false},"00000000005":{"reason":"Device firmware 0.14.28300 does not meet the minimum requirement 0.14.28310","valid":false}},"reason":"Map has APs that do not meet the minimum requirements for auto placement","started":false,"valid":false}'
- '{"devices":{"00000000001":{"valid":true},"00000000002":{"valid":true},"00000000003":{"valid":true},"00000000004":{"reason":"Device model AP41 is not supported for auto placement","valid":false},"00000000005":{"reason":"Device firmware 0.14.28300 does not meet the minimum requirement 0.14.28310","valid":false}},"reason":"Started localization for auto placement","started":true,"valid":false}'
- '{"devices":{"00000000001":{"valid":true},"00000000002":{"valid":true},"00000000003":{"valid":true},"00000000004":{"reason":"Device model AP41 is not supported for auto placement","valid":false},"00000000005":{"reason":"Device firmware 0.14.28300 does not meet the minimum requirement 0.14.28310","valid":false}},"estimated_runtime":30,"reason":"Started collection for auto placement","started":true,"valid":false,"wifi_interrupting":true}'
- '{"devices":{"00000000001":{"valid":true},"00000000002":{"valid":true},"00000000003":{"valid":true}},"reason":"Started localization for auto placement","started":true,"valid":true}'
- '{"devices":{"00000000001":{"valid":true},"00000000002":{"valid":true},"00000000003":{"valid":true}},"estimated_runtime":30,"reason":"Started collection for auto placement","started":true,"valid":true,"wifi_interrupting":true}'
- '{"devices":{"00000000001":{"valid":true},"00000000002":{"valid":true},"00000000003":{"valid":true}},"estimated_runtime":30,"reason":"Unable to reach auto placement service","started":false,"valid":true,"wifi_interrupting":true}'
contentMediaType: application/vnd.api+json
examples:
Auto placement is already in progress for this map:
value:
devices:
'00000000001':
valid: true
'00000000002':
valid: true
'00000000003':
valid: true
estimated_runtime: 30
reason: Map Already Enqueued
started: false
valid: true
wifi_interrupting: true
Dryrun for map completed:
value:
devices:
'00000000001':
valid: true
'00000000002':
valid: true
'00000000003':
valid: true
estimated_runtime: 30
reason: Map has met the minimum requirements for auto placement
valid: true
wifi_interrupting: true
Map failed to start as it had less than 3 APs associated with it:
value:
devices: {}
reason: Map has less than 3 APs associated with it to perform auto placement
started: false
valid: false
Service failed to start due containing invalid APs:
value:
devices:
'00000000001':
valid: true
'00000000002':
valid: true
'00000000003':
valid: true
'00000000004':
reason: Device model AP41 is not supported for auto placement
valid: false
'00000000005':
reason: Device firmware 0.14.28300 does not meet the minimum requirement 0.14.28310
valid: false
reason: Map has APs that do not meet the minimum requirements for auto placement
started: false
valid: false
Service started after override for localization:
value:
devices:
'00000000001':
valid: true
'00000000002':
valid: true
'00000000003':
valid: true
'00000000004':
reason: Device model AP41 is not supported for auto placement
valid: false
'00000000005':
reason: Device firmware 0.14.28300 does not meet the minimum requirement 0.14.28310
valid: false
reason: Started localization for auto placement
started: true
valid: false
Service started after override for orchestration:
value:
devices:
'00000000001':
valid: true
'00000000002':
valid: true
'00000000003':
valid: true
'00000000004':
reason: Device model AP41 is not supported for auto placement
valid: false
'00000000005':
reason: Device firmware 0.14.28300 does not meet the minimum requirement 0.14.28310
valid: false
estimated_runtime: 30
reason: Started collection for auto placement
started: true
valid: false
wifi_interrupting: true
Service started successfully for localization:
value:
devices:
'00000000001':
valid: true
'00000000002':
valid: true
'00000000003':
valid: true
reason: Started localization for auto placement
started: true
valid: true
Service started successfully for orchestration:
value:
devices:
'00000000001':
valid: true
'00000000002':
valid: true
'00000000003':
valid: true
estimated_runtime: 30
reason: Started collection for auto placement
started: true
valid: true
wifi_interrupting: true
Unable to reach the autoplacement service:
value:
devices:
'00000000001':
valid: true
'00000000002':
valid: true
'00000000003':
valid: true
estimated_runtime: 30
reason: Unable to reach auto placement service
started: false
valid: true
wifi_interrupting: true
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/maps/{map_id}/clear_auto_orient:
post:
tags:
- Sites Maps - Auto-placement
summary: clearSiteApAutoOrient
description: This API is used to destroy the autoorientations of a map or subset of APs on a map.
operationId: clearSiteApAutoOrient
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: map_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/mac_addresses'
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/maps/{map_id}/clear_autoplacement:
post:
tags:
- Sites Maps - Auto-placement
summary: clearSiteApAutoplacement
description: >-
Reject the cached autoplacement and auto-orientation values of a map or subset of APs on a map. Any APs that have autoplacement values are stored in cache for up to 7 days while awaiting rejection.
Rejecting the autoplacement values causes the APs to retain their current X, Y, and orientation.
Once a decision to reject is made, or the 7-day time-to-live (TTL) expires, the cached values are deleted.
operationId: clearSiteApAutoplacement
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: map_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/autoplacement_localization_selector'
- examples:
- for: placement
macs:
- 5c5b35000001
contentMediaType: application/json
examples:
Example:
value:
for: placement
macs:
- 5c5b35000001
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/maps/{map_id}/use_auto_ap_values:
post:
tags:
- Sites Maps - Auto-placement
summary: confirmSiteApLocalizationData
description: '**Deprecated** — use [Accept Site AP Autoplacement]($e/Sites%20Maps%20-%20Auto-placement/acceptSiteApLocalizationData) to accept cached values, or [Clear Site AP Autoplacement]($e/Sites%20Maps%20-%20Auto-placement/clearSiteApAutoplacement) to reject them.'
operationId: confirmSiteApLocalizationData
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: map_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/use_auto_ap_values'
- examples:
- accept: false
device_macs:
- string
for: placement
contentMediaType: application/json
examples:
Example:
value:
accept: false
device_macs:
- string
for: placement
required: false
responses:
'200':
description: Success
headers: {}
content: {}
'400':
description: Map does not exist or belong to specified site / Invalid localization service. Expected [placement, orientation]
headers: {}
content: {}
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: true
parameters: []
/api/v1/sites/{site_id}/maps/{map_id}/auto_zones:
delete:
tags:
- Sites Maps - Auto-Zone
summary: deleteSiteMapAutoZone
description: This API starts the auto zones service for a specified map. This map must have an image to parse for the auto zones service. Repeated POST requests to this endpoint while the auto zones service is processing the map or awaiting review will be rejected.
operationId: deleteSiteMapAutoZone
parameters:
- name: map_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Sites Maps - Auto-Zone
summary: getSiteMapAutoZoneStatus
description: This API provides the current status of the auto zones service for a given map
operationId: getSiteMapAutoZoneStatus
parameters:
- name: map_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: Status of Auto-Zone request
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_auto_zone'
- description: Auto zones status and suggested zone response
examples:
- status: awaiting_review
zones:
- name: zone1
vertices:
- x: 0
y: 0
- x: 0
y: 10
- x: 10
y: 10
- x: 10
y: 0
- name: zone2
vertices:
- x: 0
y: 0
- x: 0
y: 20
- x: 20
y: 20
- x: 20
y: 0
contentMediaType: application/json
examples:
Example:
value:
status: awaiting_review
zones:
- name: zone1
vertices:
- x: 0
y: 0
- x: 0
y: 10
- x: 10
y: 10
- x: 10
y: 0
- name: zone2
vertices:
- x: 0
y: 0
- x: 0
y: 20
- x: 20
y: 20
- x: 20
y: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_auto_zone'
- description: Auto zones status and suggested zone response
examples:
- status: awaiting_review
zones:
- name: zone1
vertices:
- x: 0
y: 0
- x: 0
y: 10
- x: 10
y: 10
- x: 10
y: 0
- name: zone2
vertices:
- x: 0
y: 0
- x: 0
y: 20
- x: 20
y: 20
- x: 20
y: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
status: awaiting_review
zones:
- name: zone1
vertices:
- x: 0
y: 0
- x: 0
y: 10
- x: 10
y: 10
- x: 10
y: 0
- name: zone2
vertices:
- x: 0
y: 0
- x: 0
y: 20
- x: 20
y: 20
- x: 20
y: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Sites Maps - Auto-Zone
summary: startSiteMapAutoZone
description: This API starts the auto zones service for a specified map. This map must have an image to parse for the auto zones service. Repeated POST requests to this endpoint while the auto zones service is processing the map will be rejected.
operationId: startSiteMapAutoZone
parameters:
- name: map_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/mapstacks:
get:
tags:
- Sites Map Stacks
summary: listSiteMapStacks
description: Get List of Site Map Stacks
operationId: listSiteMapStacks
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
- name: name
in: query
description: Filter by map stack name
style: form
explode: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/mapstack_response'
description: Map stacks returned by the API
examples:
- - created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: Board Room
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/json
examples:
Example:
value:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: Board Room
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/mapstack_response'
description: Map stacks returned by the API
examples:
- - created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: Board Room
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: Board Room
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Sites Map Stacks
summary: createSiteMapStack
description: Create Site Map Stack
operationId: createSiteMapStack
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/mapstack'
- description: Request Body
examples:
- name: Board Room
contentMediaType: application/json
examples:
Example:
value:
name: Board Room
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/mapstack_response'
- description: Map Stack response object
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/mapstack_response'
- description: Map Stack response object
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/marvis_configs/count:
get:
tags:
- Sites Marvis Configs
summary: countSiteMarvisConfigActions
description: Count Marvis Config Actions for a site by a distinct field.
operationId: countSiteMarvisConfigActions
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field to count by. enum: `mac`, `type`, `src`, `admin_id`, `op`, `port_id`, `reason`, `vlan_ids`'
style: form
explode: true
schema:
type: string
default: mac
- name: mac
in: query
description: Filter by device MAC address
style: form
explode: true
schema:
type: string
- name: type
in: query
description: Filter by config type (e.g. wired)
style: form
explode: true
schema:
type: string
- name: src
in: query
description: Filter by source of the config action (e.g. marvis)
style: form
explode: true
schema:
type: string
- name: admin_id
in: query
description: Filter by admin ID
style: form
explode: true
schema:
type: string
- name: op
in: query
description: Filter by operation type (e.g. disable_port, enable_port, update_mtu, add_vlans_to_port)
style: form
explode: true
schema:
type: string
- name: port_id
in: query
description: Filter by port identifier (e.g. ge-0/0/13)
style: form
explode: true
schema:
type: string
- name: vlan_ids
in: query
description: Filter by VLAN ID
style: form
explode: true
schema:
type: integer
contentEncoding: int32
- name: reason
in: query
description: Filter by reason for the config action (e.g. rogue_dhcp_server_detected)
style: form
explode: true
schema:
type: string
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
responses:
'200':
description: Count result
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/marvis_configs/search:
get:
tags:
- Sites Marvis Configs
summary: searchSiteMarvisConfigActions
description: Search Marvis Config Actions for a site.
operationId: searchSiteMarvisConfigActions
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: mac
in: query
description: Filter by device MAC address
style: form
explode: true
schema:
type: string
- name: type
in: query
description: Filter by config type (e.g. wired)
style: form
explode: true
schema:
type: string
- name: src
in: query
description: Filter by source of the config action (e.g. marvis)
style: form
explode: true
schema:
type: string
- name: admin_id
in: query
description: Filter by admin ID
style: form
explode: true
schema:
type: string
- name: op
in: query
description: Filter by operation type (e.g. disable_port, enable_port, update_mtu, add_vlans_to_port)
style: form
explode: true
schema:
type: string
- name: port_id
in: query
description: Filter by port identifier (e.g. ge-0/0/13)
style: form
explode: true
schema:
type: string
- name: vlan_ids
in: query
description: Filter by VLAN ID
style: form
explode: true
schema:
type: integer
contentEncoding: int32
- name: reason
in: query
description: Filter by reason for the config action (e.g. rogue_dhcp_server_detected)
style: form
explode: true
schema:
type: string
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
responses:
'200':
description: Paginated Marvis Config Actions search results
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/marvis_config_actions_search'
- description: Paginated list of Marvis config actions
examples:
- end: 1775122221
limit: 10
results:
- admin_id: 6d617276-0000-0000-3157-000000000000
id: 05b46288-37d4-4860-9de4-1edc6e8d5363
mac: f8c1165aba00
op: disable_port
org_id: 174260d5-cb22-4ea8-badb-c77a89acb0a9
port_id: ge-0/0/2
reason: rogue_dhcp_server_detected
site_id: 437ac5f0-fc76-4a2b-87ab-d8d1e5c00405
src: marvis
timestamp: 1775028130.405962
type: wired
vlan_ids: []
- admin_id: 6d617276-0000-0000-3157-000000000000
id: b1a81ed4-a7a2-4945-b01d-f54afe6d5cc4
mac: f8c1165aba00
op: add_vlans_to_port
org_id: 174260d5-cb22-4ea8-badb-c77a89acb0a9
port_id: ge-0/0/12
reason: missing_vlans
site_id: 437ac5f0-fc76-4a2b-87ab-d8d1e5c00405
src: marvis
timestamp: 1774866716.15723
type: wired
vlan_ids:
- 100
- 200
start: 1775118621
total: 2
contentMediaType: application/json
examples:
Example:
value:
end: 1775122221
limit: 10
results:
- admin_id: 6d617276-0000-0000-3157-000000000000
id: 05b46288-37d4-4860-9de4-1edc6e8d5363
mac: f8c1165aba00
op: disable_port
org_id: 174260d5-cb22-4ea8-badb-c77a89acb0a9
port_id: ge-0/0/2
reason: rogue_dhcp_server_detected
site_id: 437ac5f0-fc76-4a2b-87ab-d8d1e5c00405
src: marvis
timestamp: 1775028130.405962
type: wired
vlan_ids: []
- admin_id: 6d617276-0000-0000-3157-000000000000
id: b1a81ed4-a7a2-4945-b01d-f54afe6d5cc4
mac: f8c1165aba00
op: add_vlans_to_port
org_id: 174260d5-cb22-4ea8-badb-c77a89acb0a9
port_id: ge-0/0/12
reason: missing_vlans
site_id: 437ac5f0-fc76-4a2b-87ab-d8d1e5c00405
src: marvis
timestamp: 1774866716.15723
type: wired
vlan_ids:
- 100
- 200
start: 1775118621
total: 2
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/marvis_config_actions_search'
- description: Paginated list of Marvis config actions
examples:
- end: 1775122221
limit: 10
results:
- admin_id: 6d617276-0000-0000-3157-000000000000
id: 05b46288-37d4-4860-9de4-1edc6e8d5363
mac: f8c1165aba00
op: disable_port
org_id: 174260d5-cb22-4ea8-badb-c77a89acb0a9
port_id: ge-0/0/2
reason: rogue_dhcp_server_detected
site_id: 437ac5f0-fc76-4a2b-87ab-d8d1e5c00405
src: marvis
timestamp: 1775028130.405962
type: wired
vlan_ids: []
- admin_id: 6d617276-0000-0000-3157-000000000000
id: b1a81ed4-a7a2-4945-b01d-f54afe6d5cc4
mac: f8c1165aba00
op: add_vlans_to_port
org_id: 174260d5-cb22-4ea8-badb-c77a89acb0a9
port_id: ge-0/0/12
reason: missing_vlans
site_id: 437ac5f0-fc76-4a2b-87ab-d8d1e5c00405
src: marvis
timestamp: 1774866716.15723
type: wired
vlan_ids:
- 100
- 200
start: 1775118621
total: 2
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 1775122221
limit: 10
results:
- admin_id: 6d617276-0000-0000-3157-000000000000
id: 05b46288-37d4-4860-9de4-1edc6e8d5363
mac: f8c1165aba00
op: disable_port
org_id: 174260d5-cb22-4ea8-badb-c77a89acb0a9
port_id: ge-0/0/2
reason: rogue_dhcp_server_detected
site_id: 437ac5f0-fc76-4a2b-87ab-d8d1e5c00405
src: marvis
timestamp: 1775028130.405962
type: wired
vlan_ids: []
- admin_id: 6d617276-0000-0000-3157-000000000000
id: b1a81ed4-a7a2-4945-b01d-f54afe6d5cc4
mac: f8c1165aba00
op: add_vlans_to_port
org_id: 174260d5-cb22-4ea8-badb-c77a89acb0a9
port_id: ge-0/0/12
reason: missing_vlans
site_id: 437ac5f0-fc76-4a2b-87ab-d8d1e5c00405
src: marvis
timestamp: 1774866716.15723
type: wired
vlan_ids:
- 100
- 200
start: 1775118621
total: 2
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/marvis_configs/{id}:
delete:
tags:
- Sites Marvis Configs
summary: deleteSiteMarvisConfigAction
description: Delete a Marvis Config Action.
operationId: deleteSiteMarvisConfigAction
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: id
in: path
description: UUID of the Marvis Config Action
required: true
schema:
type: string
contentEncoding: uuid
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/marvis_configs/{id}/feedback:
post:
tags:
- Sites Marvis Configs
summary: submitSiteMarvisConfigFeedback
description: Submit feedback on a Marvis-injected config action (e.g. mark as invalid).
operationId: submitSiteMarvisConfigFeedback
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: id
in: path
description: UUID of the Marvis Config Action
required: true
schema:
type: string
contentEncoding: uuid
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/marvis_config_feedback'
- description: Request Body
contentMediaType: application/json
required: true
responses:
'200':
description: Marvis Config Feedback response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/marvis_config_feedback_response'
- description: Response after submitting feedback on a Marvis config action
examples:
- feedback_note: this port config is intended, do not change anymore
feedback_type: invalid
contentMediaType: application/json
examples:
Example:
value:
feedback_note: this port config is intended, do not change anymore
feedback_type: invalid
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/marvis_config_feedback_response'
- description: Response after submitting feedback on a Marvis config action
examples:
- feedback_note: this port config is intended, do not change anymore
feedback_type: invalid
contentMediaType: application/vnd.api+json
examples:
Example:
value:
feedback_note: this port config is intended, do not change anymore
feedback_type: invalid
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/mxedges:
get:
tags:
- Sites MxEdges
summary: listSiteMxEdges
description: List Mist Edges for a site. Use [List Org Mist Edges]($e/Orgs%20MxEdges/listOrgMxEdges) to retrieve Mist Edges across the organization.
operationId: listSiteMxEdges
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/mxedge'
description: List of Mist Edge appliances
examples:
- - cpu_stat:
cpus:
cpu0:
idle: 79
interrupt: 0
system: 4
usage: 20
user: 16
cpu1:
idle: 93
interrupt: 0
system: 4
usage: 6
user: 1
idle: 87
interrupt: 0
system: 5
usage: 12
user: 7
ext_ip: 116.187.144.16
id: 387804a7-3474-85ce-15a2-f9a9684c9c90
ip_stat:
ip: 172.16.5.3
ips:
ens192: 172.16.5.3/24,fe81::20c:29ff:fef8:d18e/64
lag_stat:
lag0:
active_ports:
- '0'
- '1'
last_seen: 1547437078
magic: ExNpT5gi-ADR8WTFd4EiQPY3cP5WdSoD
memory_stats:
active: 1061085184
available: 4124860416
buffers: 789495808
cached: 718016512
free: 2818838528
inactive: 458158080
swap_cached: 0
swap_free: 8161062912
swap_total: 8161062912
total: 7947616256
usage: 65
model: ME-S2019
mxagent_registered: false
mxcluster_id: 572586b7-f97b-a22b-526c-8b97a3f609c4
name: Guest
num_tunnels: 31
port_stat:
eth0:
full_duplex: true
lldp_stats:
mgmt_addr: 122.16.3.11
port_desc: GigabitEthernet4/0/16
port_id: "\x05Gi4/0/16"
system_desc: Cisco IOS Software
system_name: ME-DC2-DIS-SW
rx_bytes: 2056
rx_errors: 0
rx_pkts: 670
speed: 1000
tx_bytes: 2056
tx_pkts: 670
up: true
eth1:
up: false
module:
up: false
status: connected
tunterm_registered: false
tunterm_stat:
monitoring_failed: false
uptime: 884221
version: 0.1.2
virtualization_type: VirtualizationVMware
contentMediaType: application/json
examples:
Example:
value:
- cpu_stat:
cpus:
cpu0:
idle: 79
interrupt: 0
system: 4
usage: 20
user: 16
cpu1:
idle: 93
interrupt: 0
system: 4
usage: 6
user: 1
idle: 87
interrupt: 0
system: 5
usage: 12
user: 7
ext_ip: 116.187.144.16
id: 387804a7-3474-85ce-15a2-f9a9684c9c90
ip_stat:
ip: 172.16.5.3
ips:
ens192: 172.16.5.3/24,fe81::20c:29ff:fef8:d18e/64
lag_stat:
lag0:
active_ports:
- '0'
- '1'
last_seen: 1547437078
magic: ExNpT5gi-ADR8WTFd4EiQPY3cP5WdSoD
memory_stats:
active: 1061085184
available: 4124860416
buffers: 789495808
cached: 718016512
free: 2818838528
inactive: 458158080
swap_cached: 0
swap_free: 8161062912
swap_total: 8161062912
total: 7947616256
usage: 65
model: ME-S2019
mxagent_registered: false
mxcluster_id: 572586b7-f97b-a22b-526c-8b97a3f609c4
name: Guest
num_tunnels: 31
port_stat:
eth0:
full_duplex: true
lldp_stats:
mgmt_addr: 122.16.3.11
port_desc: GigabitEthernet4/0/16
port_id: "\x05Gi4/0/16"
system_desc: Cisco IOS Software
system_name: ME-DC2-DIS-SW
rx_bytes: 2056
rx_errors: 0
rx_pkts: 670
speed: 1000
tx_bytes: 2056
tx_pkts: 670
up: true
eth1:
up: false
module:
up: false
status: connected
tunterm_registered: false
tunterm_stat:
monitoring_failed: false
uptime: 884221
version: 0.1.2
virtualization_type: VirtualizationVMware
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/mxedge'
description: List of Mist Edge appliances
examples:
- - cpu_stat:
cpus:
cpu0:
idle: 79
interrupt: 0
system: 4
usage: 20
user: 16
cpu1:
idle: 93
interrupt: 0
system: 4
usage: 6
user: 1
idle: 87
interrupt: 0
system: 5
usage: 12
user: 7
ext_ip: 116.187.144.16
id: 387804a7-3474-85ce-15a2-f9a9684c9c90
ip_stat:
ip: 172.16.5.3
ips:
ens192: 172.16.5.3/24,fe81::20c:29ff:fef8:d18e/64
lag_stat:
lag0:
active_ports:
- '0'
- '1'
last_seen: 1547437078
magic: ExNpT5gi-ADR8WTFd4EiQPY3cP5WdSoD
memory_stats:
active: 1061085184
available: 4124860416
buffers: 789495808
cached: 718016512
free: 2818838528
inactive: 458158080
swap_cached: 0
swap_free: 8161062912
swap_total: 8161062912
total: 7947616256
usage: 65
model: ME-S2019
mxagent_registered: false
mxcluster_id: 572586b7-f97b-a22b-526c-8b97a3f609c4
name: Guest
num_tunnels: 31
port_stat:
eth0:
full_duplex: true
lldp_stats:
mgmt_addr: 122.16.3.11
port_desc: GigabitEthernet4/0/16
port_id: "\x05Gi4/0/16"
system_desc: Cisco IOS Software
system_name: ME-DC2-DIS-SW
rx_bytes: 2056
rx_errors: 0
rx_pkts: 670
speed: 1000
tx_bytes: 2056
tx_pkts: 670
up: true
eth1:
up: false
module:
up: false
status: connected
tunterm_registered: false
tunterm_stat:
monitoring_failed: false
uptime: 884221
version: 0.1.2
virtualization_type: VirtualizationVMware
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- cpu_stat:
cpus:
cpu0:
idle: 79
interrupt: 0
system: 4
usage: 20
user: 16
cpu1:
idle: 93
interrupt: 0
system: 4
usage: 6
user: 1
idle: 87
interrupt: 0
system: 5
usage: 12
user: 7
ext_ip: 116.187.144.16
id: 387804a7-3474-85ce-15a2-f9a9684c9c90
ip_stat:
ip: 172.16.5.3
ips:
ens192: 172.16.5.3/24,fe81::20c:29ff:fef8:d18e/64
lag_stat:
lag0:
active_ports:
- '0'
- '1'
last_seen: 1547437078
magic: ExNpT5gi-ADR8WTFd4EiQPY3cP5WdSoD
memory_stats:
active: 1061085184
available: 4124860416
buffers: 789495808
cached: 718016512
free: 2818838528
inactive: 458158080
swap_cached: 0
swap_free: 8161062912
swap_total: 8161062912
total: 7947616256
usage: 65
model: ME-S2019
mxagent_registered: false
mxcluster_id: 572586b7-f97b-a22b-526c-8b97a3f609c4
name: Guest
num_tunnels: 31
port_stat:
eth0:
full_duplex: true
lldp_stats:
mgmt_addr: 122.16.3.11
port_desc: GigabitEthernet4/0/16
port_id: "\x05Gi4/0/16"
system_desc: Cisco IOS Software
system_name: ME-DC2-DIS-SW
rx_bytes: 2056
rx_errors: 0
rx_pkts: 670
speed: 1000
tx_bytes: 2056
tx_pkts: 670
up: true
eth1:
up: false
module:
up: false
status: connected
tunterm_registered: false
tunterm_stat:
monitoring_failed: false
uptime: 884221
version: 0.1.2
virtualization_type: VirtualizationVMware
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/mxedges/events/count:
get:
tags:
- Sites MxEdges
summary: countSiteMxEdgeEvents
description: Count by Distinct Attributes of Mist Edge Events
operationId: countSiteMxEdgeEvents
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field used to group this count response. enum: `mxcluster_id`, `mxedge_id`, `package`, `type`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/site_mxedge_events_count_distinct'
- description: 'Field used to group this count response. enum: `mxcluster_id`, `mxedge_id`, `package`, `type`'
- name: mxedge_id
in: query
description: Filter results by Mist Edge identifier
style: form
explode: true
schema:
type: string
- name: mxcluster_id
in: query
description: Mist edge cluster id
style: form
explode: true
schema:
type: string
- name: type
in: query
description: See [List Device Events Definitions]($e/Constants%20Events/listDeviceEventsDefinitions)
style: form
explode: true
schema:
type: string
- name: service
in: query
description: Filter results by service name
style: form
explode: true
schema:
type: string
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/mxedges/events/search:
get:
tags:
- Sites MxEdges
summary: searchSiteMistEdgeEvents
description: Search Mist Edge events for a site with filters for Mist Edge, Mist Edge cluster, event type, service, component, and time range. Use [Search Org Mist Edge Events]($e/Orgs%20MxEdges/searchOrgMistEdgeEvents) to search Mist Edge events across the organization.
operationId: searchSiteMistEdgeEvents
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: mxedge_id
in: query
description: Filter results by Mist Edge identifier
style: form
explode: true
schema:
type: string
- name: mxcluster_id
in: query
description: Mist edge cluster id
style: form
explode: true
schema:
type: string
- name: type
in: query
description: See [List Device Events Definitions]($e/Constants%20Events/listDeviceEventsDefinitions)
style: form
explode: true
schema:
type: string
- name: service
in: query
description: Filter results by service name
style: form
explode: true
schema:
type: string
- name: component
in: query
description: Filter results by component name
style: form
explode: true
schema:
type: string
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 10
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_mxedge_events_search'
- description: Search response for Mist Edge event records
examples:
- end: 1694708579
limit: 10
page: 3
results:
- mxcluster_id: 2815c917-58e7-472f-a190-bfd44fb58d05
mxedge_id: 00000000-0000-0000-1000-020000dc585c
org_id: f2695c32-0e83-4936-b1b2-96fc88051213
service: tunterm
timestamp: 1694678225.927
type: ME_SERVICE_STOPPED
start: 1694622179
contentMediaType: application/json
examples:
Example:
value:
end: 1694708579
limit: 10
page: 3
results:
- mxcluster_id: 2815c917-58e7-472f-a190-bfd44fb58d05
mxedge_id: 00000000-0000-0000-1000-020000dc585c
org_id: f2695c32-0e83-4936-b1b2-96fc88051213
service: tunterm
timestamp: 1694678225.927
type: ME_SERVICE_STOPPED
start: 1694622179
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_mxedge_events_search'
- description: Search response for Mist Edge event records
examples:
- end: 1694708579
limit: 10
page: 3
results:
- mxcluster_id: 2815c917-58e7-472f-a190-bfd44fb58d05
mxedge_id: 00000000-0000-0000-1000-020000dc585c
org_id: f2695c32-0e83-4936-b1b2-96fc88051213
service: tunterm
timestamp: 1694678225.927
type: ME_SERVICE_STOPPED
start: 1694622179
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 1694708579
limit: 10
page: 3
results:
- mxcluster_id: 2815c917-58e7-472f-a190-bfd44fb58d05
mxedge_id: 00000000-0000-0000-1000-020000dc585c
org_id: f2695c32-0e83-4936-b1b2-96fc88051213
service: tunterm
timestamp: 1694678225.927
type: ME_SERVICE_STOPPED
start: 1694622179
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/mxedges/{mxedge_id}:
delete:
tags:
- Sites MxEdges
summary: deleteSiteMxEdge
description: Delete Site Mist Edge
operationId: deleteSiteMxEdge
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: mxedge_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Sites MxEdges
summary: getSiteMxEdge
description: Get Site Mist Edge
operationId: getSiteMxEdge
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: mxedge_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Sites MxEdges
summary: updateSiteMxEdge
description: Update Site Mist Edge settings
operationId: updateSiteMxEdge
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: mxedge_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/mxedge'
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/mxedge'
- description: Mist Edge appliance configuration and registration state
examples:
- id: 95ddd29a-6a3c-929e-a431-51a5b09f36a6
magic: L-NpT5gi-ADR8WTFd4EiQPY3cP5WdSoD
model: ME-100
mxagent_registered: true
mxcluster_id: 572586b7-f97b-a22b-526c-8b97a3f609c4
mxedge_mgmt:
mist_password: MIST_PASSWORD
root_password: ROOT_PASSWORD
name: Guest
ntp_servers: []
oob_ip_config:
dns:
- 8.8.8.8
- 4.4.4.4
gateway: 10.2.1.254
ip: 10.2.1.10
netmask: 255.255.255.0
type: static
tunterm_dhcpd_config:
'2':
enabled: true
servers:
- 11.2.3.44
enabled: false
servers:
- 11.2.3.4
tunterm_extra_routes:
11.0.0.0/8:
via: 10.3.3.1
tunterm_ip_config:
gateway: 10.2.1.254
ip: 10.2.1.1
netmask: 255.255.255.0
contentMediaType: application/json
examples:
Example:
value:
id: 95ddd29a-6a3c-929e-a431-51a5b09f36a6
magic: L-NpT5gi-ADR8WTFd4EiQPY3cP5WdSoD
model: ME-100
mxagent_registered: true
mxcluster_id: 572586b7-f97b-a22b-526c-8b97a3f609c4
mxedge_mgmt:
mist_password: MIST_PASSWORD
root_password: ROOT_PASSWORD
name: Guest
ntp_servers: []
oob_ip_config:
dns:
- 8.8.8.8
- 4.4.4.4
gateway: 10.2.1.254
ip: 10.2.1.10
netmask: 255.255.255.0
type: static
tunterm_dhcpd_config:
'2':
enabled: true
servers:
- 11.2.3.44
enabled: false
servers:
- 11.2.3.4
tunterm_extra_routes:
11.0.0.0/8:
via: 10.3.3.1
tunterm_ip_config:
gateway: 10.2.1.254
ip: 10.2.1.1
netmask: 255.255.255.0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/mxedge'
- description: Mist Edge appliance configuration and registration state
examples:
- id: 95ddd29a-6a3c-929e-a431-51a5b09f36a6
magic: L-NpT5gi-ADR8WTFd4EiQPY3cP5WdSoD
model: ME-100
mxagent_registered: true
mxcluster_id: 572586b7-f97b-a22b-526c-8b97a3f609c4
mxedge_mgmt:
mist_password: MIST_PASSWORD
root_password: ROOT_PASSWORD
name: Guest
ntp_servers: []
oob_ip_config:
dns:
- 8.8.8.8
- 4.4.4.4
gateway: 10.2.1.254
ip: 10.2.1.10
netmask: 255.255.255.0
type: static
tunterm_dhcpd_config:
'2':
enabled: true
servers:
- 11.2.3.44
enabled: false
servers:
- 11.2.3.4
tunterm_extra_routes:
11.0.0.0/8:
via: 10.3.3.1
tunterm_ip_config:
gateway: 10.2.1.254
ip: 10.2.1.1
netmask: 255.255.255.0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
id: 95ddd29a-6a3c-929e-a431-51a5b09f36a6
magic: L-NpT5gi-ADR8WTFd4EiQPY3cP5WdSoD
model: ME-100
mxagent_registered: true
mxcluster_id: 572586b7-f97b-a22b-526c-8b97a3f609c4
mxedge_mgmt:
mist_password: MIST_PASSWORD
root_password: ROOT_PASSWORD
name: Guest
ntp_servers: []
oob_ip_config:
dns:
- 8.8.8.8
- 4.4.4.4
gateway: 10.2.1.254
ip: 10.2.1.10
netmask: 255.255.255.0
type: static
tunterm_dhcpd_config:
'2':
enabled: true
servers:
- 11.2.3.44
enabled: false
servers:
- 11.2.3.4
tunterm_extra_routes:
11.0.0.0/8:
via: 10.3.3.1
tunterm_ip_config:
gateway: 10.2.1.254
ip: 10.2.1.1
netmask: 255.255.255.0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/mxedges/{mxedge_id}/support:
post:
tags:
- Sites MxEdges
summary: uploadSiteMxEdgeSupportFiles
description: Support / Upload Mist Edge support files
operationId: uploadSiteMxEdgeSupportFiles
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: mxedge_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/networktemplates/derived:
get:
tags:
- Sites Network Templates
summary: listSiteNetworkTemplatesDerived
description: Get the list of derived Network Templates a Site
operationId: listSiteNetworkTemplatesDerived
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: resolve
in: query
description: Whether resolve the site variables
style: form
explode: true
schema:
type: boolean
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/network_template'
- description: Network template configuration applied to sites or site groups
examples:
- additional_config_cmds:
- set snmp community public
created_time: 0
dhcp_snooping:
all_networks: true
enable_arp_spoof_check: true
enable_ip_source_guard: true
enabled: true
networks:
- string
dns_servers:
- string
dns_suffix:
- string
extra_routes:
property1:
via: string
property2:
via: string
group_tags: {}
id: 497f6eca-6276-4993-bfeb-53cbbbba6708
import_org_networks:
- ap
mist_nac:
enabled: true
network: string
modified_time: 0
name: string
networks:
property1:
subnet: 192.168.1.0/24
vlan_id: 10
property2:
subnet: 192.168.1.0/24
vlan_id: 10
ntp_servers:
- string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
port_usages:
dynamic:
mode: dynamic
reset_default_when: link_down
rules:
- equals: string
equals_any:
- string
expression: string
src: lldp_chassis_id
usage: string
property1:
all_networks: false
allow_dhcpd: true
bypass_auth_when_server_down: true
description: string
disable_autoneg: false
disabled: false
duplex: auto
enable_mac_auth: true
enable_qos: true
guest_network: string
mac_auth_only: true
mac_auth_protocol: pap
mac_limit: 0
networks:
- string
persist_mac: false
poe_disabled: false
port_auth: dot1x
port_network: string
server_reject_network: null
speed: auto
storm_control:
no_broadcast: false
no_multicast: false
no_registered_multicast: false
no_unknown_unicast: false
percentage: 80
stp_edge: true
voip_network: string
property2:
all_networks: false
allow_dhcpd: true
bypass_auth_when_server_down: true
description: string
disable_autoneg: false
disabled: false
duplex: auto
enable_mac_auth: true
enable_qos: true
guest_network: string
mac_auth_only: true
mac_auth_protocol: pap
mac_limit: 0
mode: access
networks:
- string
persist_mac: false
poe_disabled: false
port_network: string
server_reject_network: null
speed: auto
storm_control:
no_broadcast: false
no_multicast: false
no_registered_multicast: false
no_unknown_unicast: false
percentage: 80
stp_edge: true
voip_network: string
switch_mgmt:
config_revert_timer: 10
protect_re:
enabled: false
root_password: string
tacacs:
acct_servers:
- host: 198.51.100.1
port: '49'
secret: string
timeout: 10
enabled: true
network: string
tacplus_servers:
- host: 198.51.100.1
port: '49'
secret: string
timeout: 10
vrf_config:
enabled: false
vrf_instances:
property1:
extra_routes:
property1:
via: 198.51.100.1
property2:
via: 198.51.100.10
networks:
- string
property2:
extra_routes:
property1:
via: 198.51.100.1
property2:
via: 198.51.100.10
networks:
- string
contentMediaType: application/json
examples:
Example:
value:
additional_config_cmds:
- set snmp community public
created_time: 0
dhcp_snooping:
all_networks: true
enable_arp_spoof_check: true
enable_ip_source_guard: true
enabled: true
networks:
- string
dns_servers:
- string
dns_suffix:
- string
extra_routes:
property1:
via: string
property2:
via: string
group_tags: {}
id: 497f6eca-6276-4993-bfeb-53cbbbba6708
import_org_networks:
- ap
mist_nac:
enabled: true
network: string
modified_time: 0
name: string
networks:
property1:
subnet: 192.168.1.0/24
vlan_id: 10
property2:
subnet: 192.168.1.0/24
vlan_id: 10
ntp_servers:
- string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
port_usages:
dynamic:
mode: dynamic
reset_default_when: link_down
rules:
- equals: string
equals_any:
- string
expression: string
src: lldp_chassis_id
usage: string
property1:
all_networks: false
allow_dhcpd: true
bypass_auth_when_server_down: true
description: string
disable_autoneg: false
disabled: false
duplex: auto
enable_mac_auth: true
enable_qos: true
guest_network: string
mac_auth_only: true
mac_auth_protocol: pap
mac_limit: 0
networks:
- string
persist_mac: false
poe_disabled: false
port_auth: dot1x
port_network: string
server_reject_network: null
speed: auto
storm_control:
no_broadcast: false
no_multicast: false
no_registered_multicast: false
no_unknown_unicast: false
percentage: 80
stp_edge: true
voip_network: string
property2:
all_networks: false
allow_dhcpd: true
bypass_auth_when_server_down: true
description: string
disable_autoneg: false
disabled: false
duplex: auto
enable_mac_auth: true
enable_qos: true
guest_network: string
mac_auth_only: true
mac_auth_protocol: pap
mac_limit: 0
mode: access
networks:
- string
persist_mac: false
poe_disabled: false
port_network: string
server_reject_network: null
speed: auto
storm_control:
no_broadcast: false
no_multicast: false
no_registered_multicast: false
no_unknown_unicast: false
percentage: 80
stp_edge: true
voip_network: string
switch_mgmt:
config_revert_timer: 10
protect_re:
enabled: false
root_password: string
tacacs:
acct_servers:
- host: 198.51.100.1
port: '49'
secret: string
timeout: 10
enabled: true
network: string
tacplus_servers:
- host: 198.51.100.1
port: '49'
secret: string
timeout: 10
vrf_config:
enabled: false
vrf_instances:
property1:
extra_routes:
property1:
via: 198.51.100.1
property2:
via: 198.51.100.10
networks:
- string
property2:
extra_routes:
property1:
via: 198.51.100.1
property2:
via: 198.51.100.10
networks:
- string
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/network_template'
- description: Network template configuration applied to sites or site groups
examples:
- additional_config_cmds:
- set snmp community public
created_time: 0
dhcp_snooping:
all_networks: true
enable_arp_spoof_check: true
enable_ip_source_guard: true
enabled: true
networks:
- string
dns_servers:
- string
dns_suffix:
- string
extra_routes:
property1:
via: string
property2:
via: string
group_tags: {}
id: 497f6eca-6276-4993-bfeb-53cbbbba6708
import_org_networks:
- ap
mist_nac:
enabled: true
network: string
modified_time: 0
name: string
networks:
property1:
subnet: 192.168.1.0/24
vlan_id: 10
property2:
subnet: 192.168.1.0/24
vlan_id: 10
ntp_servers:
- string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
port_usages:
dynamic:
mode: dynamic
reset_default_when: link_down
rules:
- equals: string
equals_any:
- string
expression: string
src: lldp_chassis_id
usage: string
property1:
all_networks: false
allow_dhcpd: true
bypass_auth_when_server_down: true
description: string
disable_autoneg: false
disabled: false
duplex: auto
enable_mac_auth: true
enable_qos: true
guest_network: string
mac_auth_only: true
mac_auth_protocol: pap
mac_limit: 0
networks:
- string
persist_mac: false
poe_disabled: false
port_auth: dot1x
port_network: string
server_reject_network: null
speed: auto
storm_control:
no_broadcast: false
no_multicast: false
no_registered_multicast: false
no_unknown_unicast: false
percentage: 80
stp_edge: true
voip_network: string
property2:
all_networks: false
allow_dhcpd: true
bypass_auth_when_server_down: true
description: string
disable_autoneg: false
disabled: false
duplex: auto
enable_mac_auth: true
enable_qos: true
guest_network: string
mac_auth_only: true
mac_auth_protocol: pap
mac_limit: 0
mode: access
networks:
- string
persist_mac: false
poe_disabled: false
port_network: string
server_reject_network: null
speed: auto
storm_control:
no_broadcast: false
no_multicast: false
no_registered_multicast: false
no_unknown_unicast: false
percentage: 80
stp_edge: true
voip_network: string
switch_mgmt:
config_revert_timer: 10
protect_re:
enabled: false
root_password: string
tacacs:
acct_servers:
- host: 198.51.100.1
port: '49'
secret: string
timeout: 10
enabled: true
network: string
tacplus_servers:
- host: 198.51.100.1
port: '49'
secret: string
timeout: 10
vrf_config:
enabled: false
vrf_instances:
property1:
extra_routes:
property1:
via: 198.51.100.1
property2:
via: 198.51.100.10
networks:
- string
property2:
extra_routes:
property1:
via: 198.51.100.1
property2:
via: 198.51.100.10
networks:
- string
contentMediaType: application/vnd.api+json
examples:
Example:
value:
additional_config_cmds:
- set snmp community public
created_time: 0
dhcp_snooping:
all_networks: true
enable_arp_spoof_check: true
enable_ip_source_guard: true
enabled: true
networks:
- string
dns_servers:
- string
dns_suffix:
- string
extra_routes:
property1:
via: string
property2:
via: string
group_tags: {}
id: 497f6eca-6276-4993-bfeb-53cbbbba6708
import_org_networks:
- ap
mist_nac:
enabled: true
network: string
modified_time: 0
name: string
networks:
property1:
subnet: 192.168.1.0/24
vlan_id: 10
property2:
subnet: 192.168.1.0/24
vlan_id: 10
ntp_servers:
- string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
port_usages:
dynamic:
mode: dynamic
reset_default_when: link_down
rules:
- equals: string
equals_any:
- string
expression: string
src: lldp_chassis_id
usage: string
property1:
all_networks: false
allow_dhcpd: true
bypass_auth_when_server_down: true
description: string
disable_autoneg: false
disabled: false
duplex: auto
enable_mac_auth: true
enable_qos: true
guest_network: string
mac_auth_only: true
mac_auth_protocol: pap
mac_limit: 0
networks:
- string
persist_mac: false
poe_disabled: false
port_auth: dot1x
port_network: string
server_reject_network: null
speed: auto
storm_control:
no_broadcast: false
no_multicast: false
no_registered_multicast: false
no_unknown_unicast: false
percentage: 80
stp_edge: true
voip_network: string
property2:
all_networks: false
allow_dhcpd: true
bypass_auth_when_server_down: true
description: string
disable_autoneg: false
disabled: false
duplex: auto
enable_mac_auth: true
enable_qos: true
guest_network: string
mac_auth_only: true
mac_auth_protocol: pap
mac_limit: 0
mode: access
networks:
- string
persist_mac: false
poe_disabled: false
port_network: string
server_reject_network: null
speed: auto
storm_control:
no_broadcast: false
no_multicast: false
no_registered_multicast: false
no_unknown_unicast: false
percentage: 80
stp_edge: true
voip_network: string
switch_mgmt:
config_revert_timer: 10
protect_re:
enabled: false
root_password: string
tacacs:
acct_servers:
- host: 198.51.100.1
port: '49'
secret: string
timeout: 10
enabled: true
network: string
tacplus_servers:
- host: 198.51.100.1
port: '49'
secret: string
timeout: 10
vrf_config:
enabled: false
vrf_instances:
property1:
extra_routes:
property1:
via: 198.51.100.1
property2:
via: 198.51.100.10
networks:
- string
property2:
extra_routes:
property1:
via: 198.51.100.1
property2:
via: 198.51.100.10
networks:
- string
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/networks/derived:
get:
tags:
- Sites Networks
summary: listSiteNetworksDerived
description: Get the list of derived Networks for a Site
operationId: listSiteNetworksDerived
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: resolve
in: query
description: Whether resolve the site variables
style: form
explode: true
schema:
type: boolean
default: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/network'
description: List of organization network definitions
examples:
- - created_time: 0
disallow_mist_services: false
gateway: 192.168.70.1
hosts:
property1:
external_ips: 172.16.10.32-172.16.10.35
ips: 192.168.70.32-192.168.70.35
property2:
external_ips: 172.16.10.32-172.16.10.35
ips: 192.168.70.32-192.168.70.35
id: 497f6eca-6276-4993-bfeb-53cbbbba6f13
internal_access:
enabled: true
internet_access:
create_simple_service_policy: false
destination_nat:
property1:
internal_ip: 192.168.70.30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.30
name: web server
port: '443'
enabled: true
restricted: false
static_nat:
property1:
internal_ip: 192.168.70.3
name: printer-1
property2:
internal_ip: 192.168.70.3
name: printer-1
isolation: true
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
subnet: 192.168.70.0/24
tenants:
property1:
addresses:
- 10.10.10.10
property2:
addresses:
- 10.10.10.45
vlan_id: 10
vpn_access:
property1:
allow_ping: true
destination_nat:
property1:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
nat_pool: 172.16.0.0/26
routed: true
source_nat:
external_ip: 172.16.0.8/30
static_nat:
property1:
internal_ip: 192.168.70.3
name: pos_station-1
property2:
internal_ip: 192.168.70.3
name: pos_station-1
summarized_subnet: 172.16.0.0/16
property2:
allow_ping: true
destination_nat:
property1:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
nat_pool: 172.16.0.0/26
routed: true
source_nat:
external_ip: 172.16.0.8/30
static_nat:
property1:
internal_ip: 192.168.70.3
name: pos_station-1
property2:
internal_ip: 192.168.70.3
name: pos_station-1
summarized_subnet: 172.16.0.0/16
contentMediaType: application/json
examples:
Example:
value:
- created_time: 0
disallow_mist_services: false
gateway: 192.168.70.1
hosts:
property1:
external_ips: 172.16.10.32-172.16.10.35
ips: 192.168.70.32-192.168.70.35
property2:
external_ips: 172.16.10.32-172.16.10.35
ips: 192.168.70.32-192.168.70.35
id: 497f6eca-6276-4993-bfeb-53cbbbba6f13
internal_access:
enabled: true
internet_access:
create_simple_service_policy: false
destination_nat:
property1:
internal_ip: 192.168.70.30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.30
name: web server
port: '443'
enabled: true
restricted: false
static_nat:
property1:
internal_ip: 192.168.70.3
name: printer-1
property2:
internal_ip: 192.168.70.3
name: printer-1
isolation: true
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
subnet: 192.168.70.0/24
tenants:
property1:
addresses:
- 10.10.10.10
property2:
addresses:
- 10.10.10.45
vlan_id: 10
vpn_access:
property1:
allow_ping: true
destination_nat:
property1:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
nat_pool: 172.16.0.0/26
routed: true
source_nat:
external_ip: 172.16.0.8/30
static_nat:
property1:
internal_ip: 192.168.70.3
name: pos_station-1
property2:
internal_ip: 192.168.70.3
name: pos_station-1
summarized_subnet: 172.16.0.0/16
property2:
allow_ping: true
destination_nat:
property1:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
nat_pool: 172.16.0.0/26
routed: true
source_nat:
external_ip: 172.16.0.8/30
static_nat:
property1:
internal_ip: 192.168.70.3
name: pos_station-1
property2:
internal_ip: 192.168.70.3
name: pos_station-1
summarized_subnet: 172.16.0.0/16
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/network'
description: List of organization network definitions
examples:
- - created_time: 0
disallow_mist_services: false
gateway: 192.168.70.1
hosts:
property1:
external_ips: 172.16.10.32-172.16.10.35
ips: 192.168.70.32-192.168.70.35
property2:
external_ips: 172.16.10.32-172.16.10.35
ips: 192.168.70.32-192.168.70.35
id: 497f6eca-6276-4993-bfeb-53cbbbba6f13
internal_access:
enabled: true
internet_access:
create_simple_service_policy: false
destination_nat:
property1:
internal_ip: 192.168.70.30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.30
name: web server
port: '443'
enabled: true
restricted: false
static_nat:
property1:
internal_ip: 192.168.70.3
name: printer-1
property2:
internal_ip: 192.168.70.3
name: printer-1
isolation: true
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
subnet: 192.168.70.0/24
tenants:
property1:
addresses:
- 10.10.10.10
property2:
addresses:
- 10.10.10.45
vlan_id: 10
vpn_access:
property1:
allow_ping: true
destination_nat:
property1:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
nat_pool: 172.16.0.0/26
routed: true
source_nat:
external_ip: 172.16.0.8/30
static_nat:
property1:
internal_ip: 192.168.70.3
name: pos_station-1
property2:
internal_ip: 192.168.70.3
name: pos_station-1
summarized_subnet: 172.16.0.0/16
property2:
allow_ping: true
destination_nat:
property1:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
nat_pool: 172.16.0.0/26
routed: true
source_nat:
external_ip: 172.16.0.8/30
static_nat:
property1:
internal_ip: 192.168.70.3
name: pos_station-1
property2:
internal_ip: 192.168.70.3
name: pos_station-1
summarized_subnet: 172.16.0.0/16
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- created_time: 0
disallow_mist_services: false
gateway: 192.168.70.1
hosts:
property1:
external_ips: 172.16.10.32-172.16.10.35
ips: 192.168.70.32-192.168.70.35
property2:
external_ips: 172.16.10.32-172.16.10.35
ips: 192.168.70.32-192.168.70.35
id: 497f6eca-6276-4993-bfeb-53cbbbba6f13
internal_access:
enabled: true
internet_access:
create_simple_service_policy: false
destination_nat:
property1:
internal_ip: 192.168.70.30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.30
name: web server
port: '443'
enabled: true
restricted: false
static_nat:
property1:
internal_ip: 192.168.70.3
name: printer-1
property2:
internal_ip: 192.168.70.3
name: printer-1
isolation: true
modified_time: 0
name: string
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
subnet: 192.168.70.0/24
tenants:
property1:
addresses:
- 10.10.10.10
property2:
addresses:
- 10.10.10.45
vlan_id: 10
vpn_access:
property1:
allow_ping: true
destination_nat:
property1:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
nat_pool: 172.16.0.0/26
routed: true
source_nat:
external_ip: 172.16.0.8/30
static_nat:
property1:
internal_ip: 192.168.70.3
name: pos_station-1
property2:
internal_ip: 192.168.70.3
name: pos_station-1
summarized_subnet: 172.16.0.0/16
property2:
allow_ping: true
destination_nat:
property1:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
property2:
internal_ip: 192.168.70.5/30
name: web server
port: '443'
nat_pool: 172.16.0.0/26
routed: true
source_nat:
external_ip: 172.16.0.8/30
static_nat:
property1:
internal_ip: 192.168.70.3
name: pos_station-1
property2:
internal_ip: 192.168.70.3
name: pos_station-1
summarized_subnet: 172.16.0.0/16
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/psks:
get:
tags:
- Sites Psks
summary: listSitePsks
description: Get List of Site PSKs
operationId: listSitePsks
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: ssid
in: query
description: Filter results by SSID
style: form
explode: true
schema:
type: string
- name: role
in: query
description: Filter PSK results by role
style: form
explode: true
schema:
type: string
- name: name
in: query
description: Filter results by name
style: form
explode: true
schema:
type: string
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/psk'
description: List of personal PSK configurations
examples:
- - created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
passphrase: secretpsk
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ssid: string
usage: multi
vlan_id: 1
contentMediaType: application/json
examples:
Example:
value:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
passphrase: secretpsk
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ssid: string
usage: multi
vlan_id: 1
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/psk'
description: List of personal PSK configurations
examples:
- - created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
passphrase: secretpsk
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ssid: string
usage: multi
vlan_id: 1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
passphrase: secretpsk
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ssid: string
usage: multi
vlan_id: 1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Sites Psks
summary: createSitePsk
description: >-
Create Site PSK
When `usage`==`macs`, corresponding "macs" field will hold a list consisting of client MAC addresses (["xx:xx:xx:xx:xx",...]) or mac patterns(["xx:xx:*","xx*",...]) or both (["xx:xx:xx:xx:xx:xx", "xx:*", ...]). This list is capped at 5000
operationId: createSitePsk
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/psk'
- description: Request Body
examples:
- mac: string
name: string
passphrase: secretpsk
ssid: string
usage: multi
vlan_id: 1
contentMediaType: application/json
examples:
Example:
value:
mac: string
name: string
passphrase: secretpsk
ssid: string
usage: multi
vlan_id: 1
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/psk'
- description: Personal pre-shared key configuration for WLAN access
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/psk'
- description: Personal pre-shared key configuration for WLAN access
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Sites Psks
summary: updateSiteMultiplePsks
description: Update multiple PSKs
operationId: updateSiteMultiplePsks
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/psk'
description: ''
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/psk'
description: List of personal PSK configurations
examples:
- - created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
passphrase: secretpsk
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ssid: string
usage: multi
vlan_id: 1
contentMediaType: application/json
examples:
Example:
value:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
passphrase: secretpsk
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ssid: string
usage: multi
vlan_id: 1
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/psk'
description: List of personal PSK configurations
examples:
- - created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
passphrase: secretpsk
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ssid: string
usage: multi
vlan_id: 1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
passphrase: secretpsk
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ssid: string
usage: multi
vlan_id: 1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/psks/import:
post:
tags:
- Sites Psks
summary: importSitePsks
description: >-
Import PSK from CSV file or JSON
## CSV File Format
```csv
PSK Import CSV File Format:
name,ssid,passphrase,usage,vlan_id,mac
Common,warehouse,foryoureyesonly,single,35,a31425f31278
Justin,reception,visible,multi,1002
```
operationId: importSitePsks
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
content:
multipart/form-data:
encoding: {}
schema:
type: object
properties:
file:
type: string
description: Uploaded CSV or binary file containing PSKs to import
contentEncoding: base64
contentMediaType: multipart/form-data
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/psk'
description: List of personal PSK configurations
examples:
- - created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
passphrase: secretpsk
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ssid: string
usage: multi
vlan_id: 1
contentMediaType: application/json
examples:
Example:
value:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
passphrase: secretpsk
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ssid: string
usage: multi
vlan_id: 1
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/psk'
description: List of personal PSK configurations
examples:
- - created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
passphrase: secretpsk
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ssid: string
usage: multi
vlan_id: 1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
passphrase: secretpsk
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ssid: string
usage: multi
vlan_id: 1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/psks/{psk_id}:
delete:
tags:
- Sites Psks
summary: deleteSitePsk
description: Delete Site PSK
operationId: deleteSitePsk
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: psk_id
in: path
description: PSK ID
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Sites Psks
summary: getSitePsk
description: Get Site PSK Details
operationId: getSitePsk
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: psk_id
in: path
description: PSK ID
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/psk'
- description: Personal pre-shared key configuration for WLAN access
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/psk'
- description: Personal pre-shared key configuration for WLAN access
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Sites Psks
summary: updateSitePsk
description: Update Site PSK
operationId: updateSitePsk
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: psk_id
in: path
description: PSK ID
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/psk'
- description: Request Body
examples:
- mac: string
name: string
passphrase: secretpsk
ssid: string
usage: multi
vlan_id: 1
contentMediaType: application/json
examples:
Example:
value:
mac: string
name: string
passphrase: secretpsk
ssid: string
usage: multi
vlan_id: 1
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/psk'
- description: Personal pre-shared key configuration for WLAN access
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/psk'
- description: Personal pre-shared key configuration for WLAN access
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/rftemplates/derived:
get:
tags:
- Sites RF Templates
summary: listSiteRfTemplatesDerived
description: Get the list of derived RF Templates a Site
operationId: listSiteRfTemplatesDerived
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: resolve
in: query
description: Whether resolve the site variables
style: form
explode: true
schema:
type: boolean
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/rf_template'
description: List of RF templates
examples:
- - ant_gain_24: 0
ant_gain_5: 0
band_24:
allow_rrm_disable: true
ant_gain: 0
bandwidth: 20
channels:
- 1
- 6
- 11
disabled: false
power_max: 11
power_min: 3
preamble: short
band_24_usage: auto
band_5:
allow_rrm_disable: false
ant_gain: 0
bandwidth: 80
channels:
- 36
- 40
- 44
- 48
- 52
- 56
- 60
- 64
- 100
- 104
- 149
- 153
- 157
- 161
disabled: false
power_max: 16
power_min: 9
preamble: short
country_code: FR
created_time: 1594743723
enable_unii_4: false
id: b3f20330-f76a-49f1-bc65-0d8727140b1d
model_specific: {}
modified_time: 1613582192
name: Lab
org_id: 203d3d02-dbc0-4c1b-9f41-76896a3330f4
contentMediaType: application/json
examples:
Example:
value:
- ant_gain_24: 0
ant_gain_5: 0
band_24:
allow_rrm_disable: true
ant_gain: 0
bandwidth: 20
channels:
- 1
- 6
- 11
disabled: false
power_max: 11
power_min: 3
preamble: short
band_24_usage: auto
band_5:
allow_rrm_disable: false
ant_gain: 0
bandwidth: 80
channels:
- 36
- 40
- 44
- 48
- 52
- 56
- 60
- 64
- 100
- 104
- 149
- 153
- 157
- 161
disabled: false
power_max: 16
power_min: 9
preamble: short
country_code: FR
created_time: 1594743723
enable_unii_4: false
id: b3f20330-f76a-49f1-bc65-0d8727140b1d
model_specific: {}
modified_time: 1613582192
name: Lab
org_id: 203d3d02-dbc0-4c1b-9f41-76896a3330f4
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/rf_template'
description: List of RF templates
examples:
- - ant_gain_24: 0
ant_gain_5: 0
band_24:
allow_rrm_disable: true
ant_gain: 0
bandwidth: 20
channels:
- 1
- 6
- 11
disabled: false
power_max: 11
power_min: 3
preamble: short
band_24_usage: auto
band_5:
allow_rrm_disable: false
ant_gain: 0
bandwidth: 80
channels:
- 36
- 40
- 44
- 48
- 52
- 56
- 60
- 64
- 100
- 104
- 149
- 153
- 157
- 161
disabled: false
power_max: 16
power_min: 9
preamble: short
country_code: FR
created_time: 1594743723
enable_unii_4: false
id: b3f20330-f76a-49f1-bc65-0d8727140b1d
model_specific: {}
modified_time: 1613582192
name: Lab
org_id: 203d3d02-dbc0-4c1b-9f41-76896a3330f4
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- ant_gain_24: 0
ant_gain_5: 0
band_24:
allow_rrm_disable: true
ant_gain: 0
bandwidth: 20
channels:
- 1
- 6
- 11
disabled: false
power_max: 11
power_min: 3
preamble: short
band_24_usage: auto
band_5:
allow_rrm_disable: false
ant_gain: 0
bandwidth: 80
channels:
- 36
- 40
- 44
- 48
- 52
- 56
- 60
- 64
- 100
- 104
- 149
- 153
- 157
- 161
disabled: false
power_max: 16
power_min: 9
preamble: short
country_code: FR
created_time: 1594743723
enable_unii_4: false
id: b3f20330-f76a-49f1-bc65-0d8727140b1d
model_specific: {}
modified_time: 1613582192
name: Lab
org_id: 203d3d02-dbc0-4c1b-9f41-76896a3330f4
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/rfdiags:
get:
tags:
- Sites Rfdiags
summary: getSiteSiteRfdiagRecording
description: List RF Glass Recording
operationId: getSiteSiteRfdiagRecording
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
type: array
items:
$ref: '#/components/schemas/rf_diag_info_item'
description: List response containing RF diagnostic recording entry arrays
examples:
- - - asset_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
asset_name: string
client_name: string
duration: 0
end_time: 0
frame_count: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
next: string
raw_events: string
ready: true
sdkclient_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sdkclient_name: string
sdkclient_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
start_time: 0
type: sdkclient
url: string
contentMediaType: application/json
examples:
Example:
value:
- - asset_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
asset_name: string
client_name: string
duration: 0
end_time: 0
frame_count: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
next: string
raw_events: string
ready: true
sdkclient_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sdkclient_name: string
sdkclient_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
start_time: 0
type: sdkclient
url: string
application/vnd.api+json:
schema:
type: array
items:
type: array
items:
$ref: '#/components/schemas/rf_diag_info_item'
description: List response containing RF diagnostic recording entry arrays
examples:
- - - asset_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
asset_name: string
client_name: string
duration: 0
end_time: 0
frame_count: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
next: string
raw_events: string
ready: true
sdkclient_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sdkclient_name: string
sdkclient_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
start_time: 0
type: sdkclient
url: string
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- - asset_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
asset_name: string
client_name: string
duration: 0
end_time: 0
frame_count: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
next: string
raw_events: string
ready: true
sdkclient_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sdkclient_name: string
sdkclient_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
start_time: 0
type: sdkclient
url: string
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Sites Rfdiags
summary: startSiteRecording
description: Start RF Glass Recording
operationId: startSiteRecording
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/rf_diag'
- description: Request Body
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/rf_diag_info_item'
description: RF diagnostic recording response entries
examples:
- - asset_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
asset_name: string
client_name: string
duration: 0
end_time: 0
frame_count: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
next: string
raw_events: string
ready: true
sdkclient_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sdkclient_name: string
sdkclient_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
start_time: 0
type: sdkclient
url: string
contentMediaType: application/json
examples:
Example:
value:
- asset_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
asset_name: string
client_name: string
duration: 0
end_time: 0
frame_count: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
next: string
raw_events: string
ready: true
sdkclient_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sdkclient_name: string
sdkclient_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
start_time: 0
type: sdkclient
url: string
application/vnd.api+json:
schema:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/rf_diag_info_item'
description: RF diagnostic recording response entries
examples:
- - asset_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
asset_name: string
client_name: string
duration: 0
end_time: 0
frame_count: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
next: string
raw_events: string
ready: true
sdkclient_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sdkclient_name: string
sdkclient_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
start_time: 0
type: sdkclient
url: string
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- asset_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
asset_name: string
client_name: string
duration: 0
end_time: 0
frame_count: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
next: string
raw_events: string
ready: true
sdkclient_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sdkclient_name: string
sdkclient_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
start_time: 0
type: sdkclient
url: string
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/rfdiags/{rfdiag_id}:
delete:
tags:
- Sites Rfdiags
summary: deleteSiteRfdiagRecording
description: Delete Recording
operationId: deleteSiteRfdiagRecording
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: rfdiag_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Sites Rfdiags
summary: getSiteRfdiagRecording
description: Get RF Diag Recording Details
operationId: getSiteRfdiagRecording
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: rfdiag_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/rf_diag_info_item'
description: RF diagnostic recording response entries
examples:
- - asset_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
asset_name: string
client_name: string
duration: 0
end_time: 0
frame_count: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
next: string
raw_events: string
ready: true
sdkclient_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sdkclient_name: string
sdkclient_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
start_time: 0
type: sdkclient
url: string
contentMediaType: application/json
examples:
Example:
value:
- asset_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
asset_name: string
client_name: string
duration: 0
end_time: 0
frame_count: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
next: string
raw_events: string
ready: true
sdkclient_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sdkclient_name: string
sdkclient_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
start_time: 0
type: sdkclient
url: string
application/vnd.api+json:
schema:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/rf_diag_info_item'
description: RF diagnostic recording response entries
examples:
- - asset_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
asset_name: string
client_name: string
duration: 0
end_time: 0
frame_count: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
next: string
raw_events: string
ready: true
sdkclient_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sdkclient_name: string
sdkclient_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
start_time: 0
type: sdkclient
url: string
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- asset_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
asset_name: string
client_name: string
duration: 0
end_time: 0
frame_count: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
next: string
raw_events: string
ready: true
sdkclient_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sdkclient_name: string
sdkclient_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
start_time: 0
type: sdkclient
url: string
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Sites Rfdiags
summary: updateSiteRfdiagRecording
description: Update Recording
operationId: updateSiteRfdiagRecording
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: rfdiag_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/rf_diag'
- description: Request Body
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/rf_diag_info_item'
description: RF diagnostic recording response entries
examples:
- - asset_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
asset_name: string
client_name: string
duration: 0
end_time: 0
frame_count: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
next: string
raw_events: string
ready: true
sdkclient_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sdkclient_name: string
sdkclient_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
start_time: 0
type: sdkclient
url: string
contentMediaType: application/json
examples:
Example:
value:
- asset_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
asset_name: string
client_name: string
duration: 0
end_time: 0
frame_count: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
next: string
raw_events: string
ready: true
sdkclient_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sdkclient_name: string
sdkclient_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
start_time: 0
type: sdkclient
url: string
application/vnd.api+json:
schema:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/rf_diag_info_item'
description: RF diagnostic recording response entries
examples:
- - asset_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
asset_name: string
client_name: string
duration: 0
end_time: 0
frame_count: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
next: string
raw_events: string
ready: true
sdkclient_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sdkclient_name: string
sdkclient_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
start_time: 0
type: sdkclient
url: string
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- asset_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
asset_name: string
client_name: string
duration: 0
end_time: 0
frame_count: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mac: string
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
name: string
next: string
raw_events: string
ready: true
sdkclient_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sdkclient_name: string
sdkclient_uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
start_time: 0
type: sdkclient
url: string
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/rfdiags/{rfdiag_id}/download:
get:
tags:
- Sites Rfdiags
summary: downloadSiteRfdiagRecording
description: >-
Download Recording
Download raw_events blob
operationId: downloadSiteRfdiagRecording
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: rfdiag_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: string
description: File
contentEncoding: base64
contentMediaType: application/json
application/vnd.api+json:
schema:
type: string
description: File
contentEncoding: base64
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/rfdiags/{rfdiag_id}/stop:
post:
tags:
- Sites Rfdiags
summary: stopSiteRfdiagRecording
description: If the recording session is active for the given rfdiag_id, it will finish the recording. duration and end_time will be updated to reflect the correct values.
operationId: stopSiteRfdiagRecording
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: rfdiag_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/insights/rogues:
get:
tags:
- Sites Rogues
summary: listSiteRogueAPs
description: Get List of Site Rogue/Neighbor APs
operationId: listSiteRogueAPs
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: type
in: query
description: 'Rogue classification used to filter the results. enum: `honeypot`, `lan`, `others`, `spoof`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/rogue_type'
- description: 'Rogue classification used to filter the results. enum: `honeypot`, `lan`, `others`, `spoof`'
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: interval
in: query
description: Aggregation works by giving a time range plus interval (e.g. 1d, 1h, 10m) where aggregation function would be applied to.
style: form
explode: true
schema:
type: string
examples:
- 10m
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_insight_rogue'
- description: Paginated response for rogue or neighbor AP insight results
examples:
- end: 1428954000
limit: 100
next: /api/v1/sites/a3eda150-ab3f-11e4-aa18-13e21dd250cc/rogues?start=1498482000&end=1498485600&limit=10&interval=1h&type=others
results:
- ap_mac: 5c5b350e021c
avg_rssi: -72
bssid: d8-97-ba-76-b5-aa
channel: '11'
num_aps: 4
ssid: xfinitywifi
times_heard: 8
start: 1428939600
contentMediaType: application/json
examples:
Example:
value:
end: 1428954000
limit: 100
next: /api/v1/sites/a3eda150-ab3f-11e4-aa18-13e21dd250cc/rogues?start=1498482000&end=1498485600&limit=10&interval=1h&type=others
results:
- ap_mac: 5c5b350e021c
avg_rssi: -72
bssid: d8-97-ba-76-b5-aa
channel: '11'
num_aps: 4
ssid: xfinitywifi
times_heard: 8
start: 1428939600
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_insight_rogue'
- description: Paginated response for rogue or neighbor AP insight results
examples:
- end: 1428954000
limit: 100
next: /api/v1/sites/a3eda150-ab3f-11e4-aa18-13e21dd250cc/rogues?start=1498482000&end=1498485600&limit=10&interval=1h&type=others
results:
- ap_mac: 5c5b350e021c
avg_rssi: -72
bssid: d8-97-ba-76-b5-aa
channel: '11'
num_aps: 4
ssid: xfinitywifi
times_heard: 8
start: 1428939600
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 1428954000
limit: 100
next: /api/v1/sites/a3eda150-ab3f-11e4-aa18-13e21dd250cc/rogues?start=1498482000&end=1498485600&limit=10&interval=1h&type=others
results:
- ap_mac: 5c5b350e021c
avg_rssi: -72
bssid: d8-97-ba-76-b5-aa
channel: '11'
num_aps: 4
ssid: xfinitywifi
times_heard: 8
start: 1428939600
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/insights/rogues/clients:
get:
tags:
- Sites Rogues
summary: listSiteRogueClients
description: Get List of Site Rogue Clients
operationId: listSiteRogueClients
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: interval
in: query
description: Aggregation works by giving a time range plus interval (e.g. 1d, 1h, 10m) where aggregation function would be applied to.
style: form
explode: true
schema:
type: string
examples:
- 10m
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_insight_rogue_client'
- description: Paginated response for rogue client insight results
examples:
- end: 1428954000
limit: 100
next: /api/v1/sites/a3eda150-ab3f-11e4-aa18-13e21dd250cc/rogues/clients?start=1498482000&end=1498485600&limit=10&interval=1h
results:
- annotation: whitelist
ap_mac: 5c-5b-35-0e-02-1c
avg_rssi: -63.9
band: '5'
bssid: d8-97-ba-76-b5-aa
client_mac: 34-f8-32-13-57-c2
num_aps: 2
start: 1428939600
contentMediaType: application/json
examples:
Example:
value:
end: 1428954000
limit: 100
next: /api/v1/sites/a3eda150-ab3f-11e4-aa18-13e21dd250cc/rogues/clients?start=1498482000&end=1498485600&limit=10&interval=1h
results:
- annotation: whitelist
ap_mac: 5c-5b-35-0e-02-1c
avg_rssi: -63.9
band: '5'
bssid: d8-97-ba-76-b5-aa
client_mac: 34-f8-32-13-57-c2
num_aps: 2
start: 1428939600
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_insight_rogue_client'
- description: Paginated response for rogue client insight results
examples:
- end: 1428954000
limit: 100
next: /api/v1/sites/a3eda150-ab3f-11e4-aa18-13e21dd250cc/rogues/clients?start=1498482000&end=1498485600&limit=10&interval=1h
results:
- annotation: whitelist
ap_mac: 5c-5b-35-0e-02-1c
avg_rssi: -63.9
band: '5'
bssid: d8-97-ba-76-b5-aa
client_mac: 34-f8-32-13-57-c2
num_aps: 2
start: 1428939600
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 1428954000
limit: 100
next: /api/v1/sites/a3eda150-ab3f-11e4-aa18-13e21dd250cc/rogues/clients?start=1498482000&end=1498485600&limit=10&interval=1h
results:
- annotation: whitelist
ap_mac: 5c-5b-35-0e-02-1c
avg_rssi: -63.9
band: '5'
bssid: d8-97-ba-76-b5-aa
client_mac: 34-f8-32-13-57-c2
num_aps: 2
start: 1428939600
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/rogues/events/count:
get:
tags:
- Sites Rogues
summary: countSiteRogueEvents
description: Count by Distinct Attributes of Rogue Events
operationId: countSiteRogueEvents
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field used to group this count response. enum: `ap`, `bssid`, `ssid`, `type`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/site_rogue_events_count_distinct'
- description: 'Field used to group this count response. enum: `ap`, `bssid`, `ssid`, `type`'
- name: type
in: query
description: 'Rogue classification used to filter the results. enum: `honeypot`, `lan`, `others`, `spoof`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/rogue_type'
- description: 'Rogue classification used to filter the results. enum: `honeypot`, `lan`, `others`, `spoof`'
- name: ssid
in: query
description: Filter results by SSID
style: form
explode: true
schema:
type: string
- name: bssid
in: query
description: Filter results by BSSID
style: form
explode: true
schema:
type: string
- name: ap_mac
in: query
description: MAC of the device that had strongest signal strength for ssid/bssid pair
style: form
explode: true
schema:
type: string
- name: channel
in: query
description: Filter results by channel
style: form
explode: true
schema:
type: string
- name: seen_on_lan
in: query
description: Whether the reporting AP see a wireless client (on LAN) connecting to it
style: form
explode: true
schema:
type: boolean
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/rogues/events/search:
get:
tags:
- Sites Rogues
summary: searchSiteRogueEvents
description: Search Rogue Events
operationId: searchSiteRogueEvents
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: type
in: query
description: 'Rogue classification used to filter the results. enum: `honeypot`, `lan`, `others`, `spoof`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/rogue_type'
- description: 'Rogue classification used to filter the results. enum: `honeypot`, `lan`, `others`, `spoof`'
- name: ssid
in: query
description: Filter results by SSID
style: form
explode: true
schema:
type: string
- name: bssid
in: query
description: Filter results by BSSID
style: form
explode: true
schema:
type: string
- name: ap_mac
in: query
description: MAC of the device that had strongest signal strength for ssid/bssid pair
style: form
explode: true
schema:
type: string
- name: channel
in: query
description: Filter results by channel
style: form
explode: true
schema:
type: integer
contentEncoding: int32
- name: seen_on_lan
in: query
description: Whether the reporting AP see a wireless client (on LAN) connecting to it
style: form
explode: true
schema:
type: boolean
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_events_rogue_search'
- description: Paginated response for rogue AP event search results
examples:
- end: 1538074800
limit: 10
results:
- ap: 5c5b350e10030
bssid: 38ff363c8c4c
channel: 136
rssi: -54
ssid: MyHomeNetwork
timestamp: 1538074612
- ap: 5c5b350e10030
bssid: 60d02c2394cc
channel: 11
rssi: -59
ssid: Home-Office
timestamp: 1538074612
start: 1538071200
total: 2
contentMediaType: application/json
examples:
Example:
value:
end: 1538074800
limit: 10
results:
- ap: 5c5b350e10030
bssid: 38ff363c8c4c
channel: 136
rssi: -54
ssid: MyHomeNetwork
timestamp: 1538074612
- ap: 5c5b350e10030
bssid: 60d02c2394cc
channel: 11
rssi: -59
ssid: Home-Office
timestamp: 1538074612
start: 1538071200
total: 2
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_events_rogue_search'
- description: Paginated response for rogue AP event search results
examples:
- end: 1538074800
limit: 10
results:
- ap: 5c5b350e10030
bssid: 38ff363c8c4c
channel: 136
rssi: -54
ssid: MyHomeNetwork
timestamp: 1538074612
- ap: 5c5b350e10030
bssid: 60d02c2394cc
channel: 11
rssi: -59
ssid: Home-Office
timestamp: 1538074612
start: 1538071200
total: 2
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 1538074800
limit: 10
results:
- ap: 5c5b350e10030
bssid: 38ff363c8c4c
channel: 136
rssi: -54
ssid: MyHomeNetwork
timestamp: 1538074612
- ap: 5c5b350e10030
bssid: 60d02c2394cc
channel: 11
rssi: -59
ssid: Home-Office
timestamp: 1538074612
start: 1538071200
total: 2
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/rogues/{rogue_bssid}:
get:
tags:
- Sites Rogues
summary: getSiteRogueAP
description: Get Rogue AP Details
operationId: getSiteRogueAP
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: rogue_bssid
in: path
description: ''
required: true
schema:
pattern: ^[0-9a-fA-F]{12}$
type: string
examples:
- 0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/rogue_details'
- description: Rogue AP detail response
examples:
- manufacture: Intel Corporate
seen_as_client: true
contentMediaType: application/json
examples:
Example:
value:
manufacture: Intel Corporate
seen_as_client: true
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/rogue_details'
- description: Rogue AP detail response
examples:
- manufacture: Intel Corporate
seen_as_client: true
contentMediaType: application/vnd.api+json
examples:
Example:
value:
manufacture: Intel Corporate
seen_as_client: true
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/rrm/channel_scores/band/{band}:
get:
tags:
- Sites RRM
summary: getSiteChannelScores
description: Get Site Channel Scores
operationId: getSiteChannelScores
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: band
in: path
description: 802.11 Band
required: true
schema:
allOf:
- $ref: '#/components/schemas/dot11_band'
- description: 802.11 Band
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_rrm_channel_scores'
- description: Response containing RRM channel score records
examples:
- results:
- channel: 36
util_score: 0.009
util_score_noise_floor: 0.001
util_score_non_wifi: 0.003
util_score_other: 0.002
util_score_radar: 0
util_score_undecodable_wifi: 0.004
util_score_unknown_wifi: 0
contentMediaType: application/json
examples:
Example:
value:
results:
- channel: 36
util_score: 0.009
util_score_noise_floor: 0.001
util_score_non_wifi: 0.003
util_score_other: 0.002
util_score_radar: 0
util_score_undecodable_wifi: 0.004
util_score_unknown_wifi: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_rrm_channel_scores'
- description: Response containing RRM channel score records
examples:
- results:
- channel: 36
util_score: 0.009
util_score_noise_floor: 0.001
util_score_non_wifi: 0.003
util_score_other: 0.002
util_score_radar: 0
util_score_undecodable_wifi: 0.004
util_score_unknown_wifi: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
results:
- channel: 36
util_score: 0.009
util_score_noise_floor: 0.001
util_score_non_wifi: 0.003
util_score_other: 0.002
util_score_radar: 0
util_score_undecodable_wifi: 0.004
util_score_unknown_wifi: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/rrm/current:
get:
tags:
- Sites RRM
summary: getSiteCurrentChannelPlanning
description: Get Current Channel Planning
operationId: getSiteCurrentChannelPlanning
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/rrm'
- description: Current RRM channel-planning state for a site
examples:
- band_24: {}
band_24_metric:
avg_aps_per_channel: 0
channel_distribution_uniformity: 0
cochannel_neighbors: 0
density: 0
naps_by_channel: {}
naps_by_power: {}
neighbors: 0
noise: 0
band_5: {}
band_5_metric:
avg_aps_per_channel: 0
channel_distribution_uniformity: 0
cochannel_neighbors: 0
density: 0
naps_by_channel: {}
naps_by_power: {}
neighbors: 0
noise: 0
rftemplate:
band_24:
allow_rrm_disable: true
antenna_mode: default
bandwidth: 20
channels:
- 1
- 6
- 11
disabled: true
power: 5
power_max: 3
power_min: 18
preamble: auto
band_5:
allow_rrm_disable: true
antenna_mode: default
bandwidth: 20
channels:
- 36
- 40
- 44
- 48
- 52
- 56
- 60
- 64
- 100
- 104
- 108
- 112
disabled: true
power: 9
power_max: 6
power_min: 17
preamble: auto
country_code: string
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
model_specific:
property1:
band_24:
allow_rrm_disable: true
antenna_mode: default
bandwidth: 20
channels:
- 1
- 6
- 11
disabled: true
power: 9
power_max: 6
power_min: 17
preamble: auto
band_5:
allow_rrm_disable: true
antenna_mode: default
bandwidth: 20
channels:
- 36
- 40
- 44
- 48
- 52
- 56
- 60
- 64
- 100
- 104
- 108
- 112
disabled: true
power: 10
power_max: 6
power_min: 15
preamble: auto
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
rftemplate_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
rftemplate_name: string
status: updating
timestamp: 0
contentMediaType: application/json
examples:
Example:
value:
band_24: {}
band_24_metric:
avg_aps_per_channel: 0
channel_distribution_uniformity: 0
cochannel_neighbors: 0
density: 0
naps_by_channel: {}
naps_by_power: {}
neighbors: 0
noise: 0
band_5: {}
band_5_metric:
avg_aps_per_channel: 0
channel_distribution_uniformity: 0
cochannel_neighbors: 0
density: 0
naps_by_channel: {}
naps_by_power: {}
neighbors: 0
noise: 0
rftemplate:
band_24:
allow_rrm_disable: true
antenna_mode: default
bandwidth: 20
channels:
- 1
- 6
- 11
disabled: true
power: 5
power_max: 3
power_min: 18
preamble: auto
band_5:
allow_rrm_disable: true
antenna_mode: default
bandwidth: 20
channels:
- 36
- 40
- 44
- 48
- 52
- 56
- 60
- 64
- 100
- 104
- 108
- 112
disabled: true
power: 9
power_max: 6
power_min: 17
preamble: auto
country_code: string
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
model_specific:
property1:
band_24:
allow_rrm_disable: true
antenna_mode: default
bandwidth: 20
channels:
- 1
- 6
- 11
disabled: true
power: 9
power_max: 6
power_min: 17
preamble: auto
band_5:
allow_rrm_disable: true
antenna_mode: default
bandwidth: 20
channels:
- 36
- 40
- 44
- 48
- 52
- 56
- 60
- 64
- 100
- 104
- 108
- 112
disabled: true
power: 10
power_max: 6
power_min: 15
preamble: auto
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
rftemplate_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
rftemplate_name: string
status: updating
timestamp: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/rrm'
- description: Current RRM channel-planning state for a site
examples:
- band_24: {}
band_24_metric:
avg_aps_per_channel: 0
channel_distribution_uniformity: 0
cochannel_neighbors: 0
density: 0
naps_by_channel: {}
naps_by_power: {}
neighbors: 0
noise: 0
band_5: {}
band_5_metric:
avg_aps_per_channel: 0
channel_distribution_uniformity: 0
cochannel_neighbors: 0
density: 0
naps_by_channel: {}
naps_by_power: {}
neighbors: 0
noise: 0
rftemplate:
band_24:
allow_rrm_disable: true
antenna_mode: default
bandwidth: 20
channels:
- 1
- 6
- 11
disabled: true
power: 5
power_max: 3
power_min: 18
preamble: auto
band_5:
allow_rrm_disable: true
antenna_mode: default
bandwidth: 20
channels:
- 36
- 40
- 44
- 48
- 52
- 56
- 60
- 64
- 100
- 104
- 108
- 112
disabled: true
power: 9
power_max: 6
power_min: 17
preamble: auto
country_code: string
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
model_specific:
property1:
band_24:
allow_rrm_disable: true
antenna_mode: default
bandwidth: 20
channels:
- 1
- 6
- 11
disabled: true
power: 9
power_max: 6
power_min: 17
preamble: auto
band_5:
allow_rrm_disable: true
antenna_mode: default
bandwidth: 20
channels:
- 36
- 40
- 44
- 48
- 52
- 56
- 60
- 64
- 100
- 104
- 108
- 112
disabled: true
power: 10
power_max: 6
power_min: 15
preamble: auto
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
rftemplate_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
rftemplate_name: string
status: updating
timestamp: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
band_24: {}
band_24_metric:
avg_aps_per_channel: 0
channel_distribution_uniformity: 0
cochannel_neighbors: 0
density: 0
naps_by_channel: {}
naps_by_power: {}
neighbors: 0
noise: 0
band_5: {}
band_5_metric:
avg_aps_per_channel: 0
channel_distribution_uniformity: 0
cochannel_neighbors: 0
density: 0
naps_by_channel: {}
naps_by_power: {}
neighbors: 0
noise: 0
rftemplate:
band_24:
allow_rrm_disable: true
antenna_mode: default
bandwidth: 20
channels:
- 1
- 6
- 11
disabled: true
power: 5
power_max: 3
power_min: 18
preamble: auto
band_5:
allow_rrm_disable: true
antenna_mode: default
bandwidth: 20
channels:
- 36
- 40
- 44
- 48
- 52
- 56
- 60
- 64
- 100
- 104
- 108
- 112
disabled: true
power: 9
power_max: 6
power_min: 17
preamble: auto
country_code: string
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
model_specific:
property1:
band_24:
allow_rrm_disable: true
antenna_mode: default
bandwidth: 20
channels:
- 1
- 6
- 11
disabled: true
power: 9
power_max: 6
power_min: 17
preamble: auto
band_5:
allow_rrm_disable: true
antenna_mode: default
bandwidth: 20
channels:
- 36
- 40
- 44
- 48
- 52
- 56
- 60
- 64
- 100
- 104
- 108
- 112
disabled: true
power: 10
power_max: 6
power_min: 15
preamble: auto
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
rftemplate_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
rftemplate_name: string
status: updating
timestamp: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/rrm/current/devices/{device_id}/band/{band}:
get:
tags:
- Sites RRM
summary: getSiteCurrentRrmConsiderations
description: Get Current RRM Considerations for an AP on a Specific Band
operationId: getSiteCurrentRrmConsiderations
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: band
in: path
description: 802.11 Band
required: true
schema:
allOf:
- $ref: '#/components/schemas/dot11_band'
- description: 802.11 Band
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_rrm_consideration'
- description: Response containing current RRM considerations for an AP radio band
examples:
- results:
- channel: 36
noise: -78
other_rssi: -66
other_ssid: Rivendell5G
rssi: -48
util_score: 0.1
util_score_non_wifi: 0.01
util_score_other: 0.05
contentMediaType: application/json
examples:
Example:
value:
results:
- channel: 36
noise: -78
other_rssi: -66
other_ssid: Rivendell5G
rssi: -48
util_score: 0.1
util_score_non_wifi: 0.01
util_score_other: 0.05
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_rrm_consideration'
- description: Response containing current RRM considerations for an AP radio band
examples:
- results:
- channel: 36
noise: -78
other_rssi: -66
other_ssid: Rivendell5G
rssi: -48
util_score: 0.1
util_score_non_wifi: 0.01
util_score_other: 0.05
contentMediaType: application/vnd.api+json
examples:
Example:
value:
results:
- channel: 36
noise: -78
other_rssi: -66
other_ssid: Rivendell5G
rssi: -48
util_score: 0.1
util_score_non_wifi: 0.01
util_score_other: 0.05
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/rrm/events:
get:
tags:
- Sites RRM
summary: listSiteRrmEvents
description: List Site RRM Events
operationId: listSiteRrmEvents
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: band
in: query
description: '802.11 band used to filter radio results. enum: `24`, `5`, `5-dedicated`, `5-selectable`, `6`, `6-dedicated`, `6-selectable`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/dot11_band'
- description: '802.11 band used to filter radio results. enum: `24`, `5`, `5-dedicated`, `5-selectable`, `6`, `6-dedicated`, `6-selectable`'
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_events_rrm'
- description: Paginated response for RRM event results
examples:
- end: 1428954000
limit: 100
next: /api/v1/sites/dca0a44b-324c-11e6-a776-0243ad110007/events/rrm?start=1428939600&end=1428949600&limit=200&token=001a0010000000120010000005005880ec18000004776c616e007fffffeb067ab8e29c1d659b6a7c8cf698bf81490003
results:
- ap: 5c5b359e4fe0
band: '24'
bandwidth: 20
channel: 6
event: scheduled-site_rrm
power: 5
pre_bandwidth: 20
pre_channel: 1
pre_power: 11
pre_usage: '24'
timestamp: 1428939600
usage: '24'
start: 1428939600
contentMediaType: application/json
examples:
Example:
value:
end: 1428954000
limit: 100
next: /api/v1/sites/dca0a44b-324c-11e6-a776-0243ad110007/events/rrm?start=1428939600&end=1428949600&limit=200&token=001a0010000000120010000005005880ec18000004776c616e007fffffeb067ab8e29c1d659b6a7c8cf698bf81490003
results:
- ap: 5c5b359e4fe0
band: '24'
bandwidth: 20
channel: 6
event: scheduled-site_rrm
power: 5
pre_bandwidth: 20
pre_channel: 1
pre_power: 11
pre_usage: '24'
timestamp: 1428939600
usage: '24'
start: 1428939600
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_events_rrm'
- description: Paginated response for RRM event results
examples:
- end: 1428954000
limit: 100
next: /api/v1/sites/dca0a44b-324c-11e6-a776-0243ad110007/events/rrm?start=1428939600&end=1428949600&limit=200&token=001a0010000000120010000005005880ec18000004776c616e007fffffeb067ab8e29c1d659b6a7c8cf698bf81490003
results:
- ap: 5c5b359e4fe0
band: '24'
bandwidth: 20
channel: 6
event: scheduled-site_rrm
power: 5
pre_bandwidth: 20
pre_channel: 1
pre_power: 11
pre_usage: '24'
timestamp: 1428939600
usage: '24'
start: 1428939600
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 1428954000
limit: 100
next: /api/v1/sites/dca0a44b-324c-11e6-a776-0243ad110007/events/rrm?start=1428939600&end=1428949600&limit=200&token=001a0010000000120010000005005880ec18000004776c616e007fffffeb067ab8e29c1d659b6a7c8cf698bf81490003
results:
- ap: 5c5b359e4fe0
band: '24'
bandwidth: 20
channel: 6
event: scheduled-site_rrm
power: 5
pre_bandwidth: 20
pre_channel: 1
pre_power: 11
pre_usage: '24'
timestamp: 1428939600
usage: '24'
start: 1428939600
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/rrm/neighbors/band/{band}:
get:
tags:
- Sites RRM
summary: listSiteCurrentRrmNeighbors
description: List Current RRM observed neighbors
operationId: listSiteCurrentRrmNeighbors
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: band
in: path
description: 802.11 Band
required: true
schema:
allOf:
- $ref: '#/components/schemas/dot11_band'
- description: 802.11 Band
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_rrm_neighbors'
- description: Paginated response for current RRM neighbor observations
examples:
- end: 1428954000
limit: 100
next: /api/v1/sites/dca0a44b-324c-11e6-a776-0243ad110007/events/rrm?start=1428939600&end=1428949600&limit=200&token=001a0010000000120010000005005880ec18000004776c616e007fffffeb067ab8e29c1d659b6a7c8cf698bf81490003
results:
- mac: a7c7096d7b8f
neighbors:
- mac: 5c5b35000311
rssi: -75
start: 1428939600
contentMediaType: application/json
examples:
Example:
value:
end: 1428954000
limit: 100
next: /api/v1/sites/dca0a44b-324c-11e6-a776-0243ad110007/events/rrm?start=1428939600&end=1428949600&limit=200&token=001a0010000000120010000005005880ec18000004776c616e007fffffeb067ab8e29c1d659b6a7c8cf698bf81490003
results:
- mac: a7c7096d7b8f
neighbors:
- mac: 5c5b35000311
rssi: -75
start: 1428939600
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_rrm_neighbors'
- description: Paginated response for current RRM neighbor observations
examples:
- end: 1428954000
limit: 100
next: /api/v1/sites/dca0a44b-324c-11e6-a776-0243ad110007/events/rrm?start=1428939600&end=1428949600&limit=200&token=001a0010000000120010000005005880ec18000004776c616e007fffffeb067ab8e29c1d659b6a7c8cf698bf81490003
results:
- mac: a7c7096d7b8f
neighbors:
- mac: 5c5b35000311
rssi: -75
start: 1428939600
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 1428954000
limit: 100
next: /api/v1/sites/dca0a44b-324c-11e6-a776-0243ad110007/events/rrm?start=1428939600&end=1428949600&limit=200&token=001a0010000000120010000005005880ec18000004776c616e007fffffeb067ab8e29c1d659b6a7c8cf698bf81490003
results:
- mac: a7c7096d7b8f
neighbors:
- mac: 5c5b35000311
rssi: -75
start: 1428939600
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/rssizones:
get:
tags:
- Sites RSSI Zones
summary: listSiteRssiZones
description: Get List of Site RSSI Zone (RSSI-based)
operationId: listSiteRssiZones
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/rssi_zone'
description: RSSI zone configurations returned by list operations
contentMediaType: application/json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Sites RSSI Zones
summary: createSiteRssiZone
description: Create RSSI Zone
operationId: createSiteRssiZone
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/rssi_zone'
- description: Request Body
examples:
- '{"devices":[{"device_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","rssi":0}],"name":"string"}'
contentMediaType: application/json
examples:
Example:
value:
devices:
- device_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
rssi: 0
name: string
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/rssi_zone'
- description: RSSI-based zone configuration for a site
examples:
- devices:
- device_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
rssi: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/json
examples:
Example:
value:
devices:
- device_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
rssi: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/rssizones/{rssizone_id}:
delete:
tags:
- Sites RSSI Zones
summary: deleteSiteRssiZone
description: Delete Site RSSI Zone
operationId: deleteSiteRssiZone
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: rssizone_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Sites RSSI Zones
summary: getSiteRssiZone
description: Get Site RSSI Zone details
operationId: getSiteRssiZone
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: rssizone_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/rssi_zone'
description: RSSI zone configurations returned by list operations
examples:
- - created_time: 0
devices:
- device_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
rssi: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/json
examples:
Example:
value:
- created_time: 0
devices:
- device_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
rssi: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/rssi_zone'
description: RSSI zone configurations returned by list operations
examples:
- - created_time: 0
devices:
- device_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
rssi: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- created_time: 0
devices:
- device_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
rssi: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Sites RSSI Zones
summary: updateSiteRssiZone
description: Update Site RSSI Zone
operationId: updateSiteRssiZone
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: rssizone_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/rssi_zone'
- description: Request Body
examples:
- '{"devices":[{"device_id":"b069b358-4c97-5319-1f8c-7c5ca64d6ab1","rssi":0}],"name":"string"}'
contentMediaType: application/json
examples:
Example:
value:
devices:
- device_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
rssi: 0
name: string
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/rssi_zone'
- description: RSSI-based zone configuration for a site
examples:
- created_time: 0
devices:
- device_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
rssi: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
devices:
- device_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
rssi: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/rssi_zone'
- description: RSSI-based zone configuration for a site
examples:
- created_time: 0
devices:
- device_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
rssi: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
devices:
- device_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
rssi: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/services/derived:
get:
tags:
- Sites Services
summary: listSiteServicesDerived
description: Get the list of derived Services for a Site
operationId: listSiteServicesDerived
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: resolve
in: query
description: Whether resolve the site variables
style: form
explode: true
schema:
type: boolean
default: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/service'
description: Service definitions returned by list operations
examples:
- - addresses:
- string
apps:
- string
dscp: 8
hostnames:
- string
max_jitter: 0
max_latency: 0
max_loss: 0
name: string
specs:
- port_range: '0'
protocol: any
traffic_class: best_effort
traffic_type: default
type: custom
contentMediaType: application/json
examples:
Example:
value:
- addresses:
- string
apps:
- string
dscp: 8
hostnames:
- string
max_jitter: 0
max_latency: 0
max_loss: 0
name: string
specs:
- port_range: '0'
protocol: any
traffic_class: best_effort
traffic_type: default
type: custom
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/service'
description: Service definitions returned by list operations
examples:
- - addresses:
- string
apps:
- string
dscp: 8
hostnames:
- string
max_jitter: 0
max_latency: 0
max_loss: 0
name: string
specs:
- port_range: '0'
protocol: any
traffic_class: best_effort
traffic_type: default
type: custom
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- addresses:
- string
apps:
- string
dscp: 8
hostnames:
- string
max_jitter: 0
max_latency: 0
max_loss: 0
name: string
specs:
- port_range: '0'
protocol: any
traffic_class: best_effort
traffic_type: default
type: custom
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/services/events/count:
get:
tags:
- Sites Services
summary: countSiteServicePathEvents
description: Count by Distinct Attributes of Service Path Events
operationId: countSiteServicePathEvents
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field used to group this count response. enum: `mac`, `model`, `policy`, `port_id`, `site_id`, `type`, `vpn_name`, `vpn_path`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/site_service_events_count_distinct'
- description: 'Field used to group this count response. enum: `mac`, `model`, `policy`, `port_id`, `site_id`, `type`, `vpn_name`, `vpn_path`'
- name: type
in: query
description: Event type, e.g. GW_SERVICE_PATH_DOWN
style: form
explode: true
schema:
type: string
- name: text
in: query
description: Description of the event including the reason it is triggered
style: form
explode: true
schema:
type: string
- name: vpn_name
in: query
description: Filter results by vpn name
style: form
explode: true
schema:
type: string
- name: vpn_path
in: query
description: Filter results by vpn path
style: form
explode: true
schema:
type: string
- name: policy
in: query
description: Service policy associated with that specific path
style: form
explode: true
schema:
type: string
- name: port_id
in: query
description: Filter results by port identifier
style: form
explode: true
schema:
type: string
- name: model
in: query
description: Filter results by device model
style: form
explode: true
schema:
type: string
- name: version
in: query
description: Filter results by software version
style: form
explode: true
schema:
type: string
- name: mac
in: query
description: Filter results by MAC address
style: form
explode: true
schema:
type: string
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/services/events/search:
get:
tags:
- Sites Services
summary: searchSiteServicePathEvents
description: Search Service Path Events
operationId: searchSiteServicePathEvents
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: type
in: query
description: Event type, e.g. GW_SERVICE_PATH_DOWN
style: form
explode: true
schema:
type: string
- name: text
in: query
description: Description of the event including the reason it is triggered
style: form
explode: true
schema:
type: string
- name: peer_port_id
in: query
description: Port ID of the peer gateway
style: form
explode: true
schema:
type: string
- name: peer_mac
in: query
description: MAC address of the peer gateway
style: form
explode: true
schema:
type: string
- name: vpn_name
in: query
description: Filter results by vpn name
style: form
explode: true
schema:
type: string
- name: vpn_path
in: query
description: Filter results by vpn path
style: form
explode: true
schema:
type: string
- name: policy
in: query
description: Service policy associated with that specific path
style: form
explode: true
schema:
type: string
- name: port_id
in: query
description: Filter results by port identifier
style: form
explode: true
schema:
type: string
- name: model
in: query
description: Filter results by device model
style: form
explode: true
schema:
type: string
- name: version
in: query
description: Filter results by software version
style: form
explode: true
schema:
type: string
- name: mac
in: query
description: Filter results by MAC address
style: form
explode: true
schema:
type: string
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_events_path_search'
- description: Paginated response for service path event search results
examples:
- end: 1697096379
limit: 10
results:
- mac: 90ec7734b374
model: SSR120
org_id: a3c6718f-2823-4e48-bf5e-b841768a4c9b
policy: INTERNET
port_id: ge-1/0/6
site_id: 4279edbd-1d24-41ea-9505-2eb26c8590fa
text: Peer Path Down
timestamp: 1697037328.651775
type: GW_SERVICE_PATH_REMOVE
version: 6.1.5-14.lts
vpn_name: Syracuse_HUB
vpn_path: Syracuse_HUB-Wan0
start: 1697009979
total: 2
contentMediaType: application/json
examples:
Example:
value:
end: 1697096379
limit: 10
results:
- mac: 90ec7734b374
model: SSR120
org_id: a3c6718f-2823-4e48-bf5e-b841768a4c9b
policy: INTERNET
port_id: ge-1/0/6
site_id: 4279edbd-1d24-41ea-9505-2eb26c8590fa
text: Peer Path Down
timestamp: 1697037328.651775
type: GW_SERVICE_PATH_REMOVE
version: 6.1.5-14.lts
vpn_name: Syracuse_HUB
vpn_path: Syracuse_HUB-Wan0
start: 1697009979
total: 2
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_events_path_search'
- description: Paginated response for service path event search results
examples:
- end: 1697096379
limit: 10
results:
- mac: 90ec7734b374
model: SSR120
org_id: a3c6718f-2823-4e48-bf5e-b841768a4c9b
policy: INTERNET
port_id: ge-1/0/6
site_id: 4279edbd-1d24-41ea-9505-2eb26c8590fa
text: Peer Path Down
timestamp: 1697037328.651775
type: GW_SERVICE_PATH_REMOVE
version: 6.1.5-14.lts
vpn_name: Syracuse_HUB
vpn_path: Syracuse_HUB-Wan0
start: 1697009979
total: 2
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 1697096379
limit: 10
results:
- mac: 90ec7734b374
model: SSR120
org_id: a3c6718f-2823-4e48-bf5e-b841768a4c9b
policy: INTERNET
port_id: ge-1/0/6
site_id: 4279edbd-1d24-41ea-9505-2eb26c8590fa
text: Peer Path Down
timestamp: 1697037328.651775
type: GW_SERVICE_PATH_REMOVE
version: 6.1.5-14.lts
vpn_name: Syracuse_HUB
vpn_path: Syracuse_HUB-Wan0
start: 1697009979
total: 2
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/servicepolicies/derived:
get:
tags:
- Sites Service Policies
summary: listSiteServicePoliciesDerived
description: Get the list of derived Service Policies for a Site
operationId: listSiteServicePoliciesDerived
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: resolve
in: query
description: Whether resolve the site variables
style: form
explode: true
schema:
type: boolean
default: false
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/org_service_policy'
description: List of organization-level service policies
examples:
- - action: allow
created_time: 0
id: string
modified_time: 0
name: string
org_id: string
services:
- string
tenants:
- string
contentMediaType: application/json
examples:
Example:
value:
- action: allow
created_time: 0
id: string
modified_time: 0
name: string
org_id: string
services:
- string
tenants:
- string
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/org_service_policy'
description: List of organization-level service policies
examples:
- - action: allow
created_time: 0
id: string
modified_time: 0
name: string
org_id: string
services:
- string
tenants:
- string
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- action: allow
created_time: 0
id: string
modified_time: 0
name: string
org_id: string
services:
- string
tenants:
- string
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/setting:
get:
tags:
- Sites Setting
summary: getSiteSetting
description: Get the Site Settings
operationId: getSiteSetting
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/site_setting'
- description: Configuration settings applied at the site level
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/site_setting'
- description: Configuration settings applied at the site level
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Sites Setting
summary: updateSiteSettings
description: Update Site Settings
operationId: updateSiteSettings
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/site_setting'
- description: Request Body
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/site_setting'
- description: Configuration settings applied at the site level
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/site_setting'
- description: Configuration settings applied at the site level
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/setting/blacklist:
delete:
tags:
- Sites Setting
summary: deleteSiteWirelessClientsBlocklist
description: Delete Site Blacklist Station Clients
operationId: deleteSiteWirelessClientsBlocklist
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Sites Setting
summary: createSiteWirelessClientsBlocklist
description: >-
This endpoint is to provide list of client macs for annotation blacklist.
Retrieve the current clients list `blacklist_url` under Site:Setting
operationId: createSiteWirelessClientsBlocklist
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/mac_addresses'
- description: Request Body
examples:
- macs:
- 18-65-90-de-f4-c6
- 84-89-ad-5d-69-0d
contentMediaType: application/json
examples:
Example:
value:
macs:
- 18-65-90-de-f4-c6
- 84-89-ad-5d-69-0d
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/mac_addresses'
- description: Request containing one or more MAC addresses
examples:
- macs:
- 18-65-90-de-f4-c6
- 84-89-ad-5d-69-0d
contentMediaType: application/json
examples:
Example:
value:
macs:
- 18-65-90-de-f4-c6
- 84-89-ad-5d-69-0d
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/mac_addresses'
- description: Request containing one or more MAC addresses
examples:
- macs:
- 18-65-90-de-f4-c6
- 84-89-ad-5d-69-0d
contentMediaType: application/vnd.api+json
examples:
Example:
value:
macs:
- 18-65-90-de-f4-c6
- 84-89-ad-5d-69-0d
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/setting/derived:
get:
tags:
- Sites Setting
summary: getSiteSettingDerived
description: Get the Derived Site Settings, generated by merging the Org level templates (network templates, gateway templates) and the Site level configuration. If the same parameter is defined in both scopes, the Site level one is used. In addition, the Zoom and Teams accounts are also merged into the derived settings.
operationId: getSiteSettingDerived
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/site_setting_derived'
- description: Site settings with derived OAuth account integration data
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/site_setting_derived'
- description: Site settings with derived OAuth account integration data
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/setting/watched_station:
delete:
tags:
- Sites Setting
summary: deleteSiteWatchedStations
description: Delete Site Watched Station Clients
operationId: deleteSiteWatchedStations
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Sites Setting
summary: createSiteWatchedStations
description: >-
This endpoint is to provide list of client macs for annotation as watched station.
Retrieve the current clients list from `watched_station_url` under Site:Setting
operationId: createSiteWatchedStations
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/mac_addresses'
- description: Request Body
examples:
- macs:
- 18-65-90-de-f4-c6
- 84-89-ad-5d-69-0d
contentMediaType: application/json
examples:
Example:
value:
macs:
- 18-65-90-de-f4-c6
- 84-89-ad-5d-69-0d
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/mac_addresses'
- description: Request containing one or more MAC addresses
examples:
- macs:
- 18-65-90-de-f4-c6
- 84-89-ad-5d-69-0d
contentMediaType: application/json
examples:
Example:
value:
macs:
- 18-65-90-de-f4-c6
- 84-89-ad-5d-69-0d
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/mac_addresses'
- description: Request containing one or more MAC addresses
examples:
- macs:
- 18-65-90-de-f4-c6
- 84-89-ad-5d-69-0d
contentMediaType: application/vnd.api+json
examples:
Example:
value:
macs:
- 18-65-90-de-f4-c6
- 84-89-ad-5d-69-0d
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/setting/whitelist:
delete:
tags:
- Sites Setting
summary: deleteSiteWirelessClientsAllowlist
description: Delete Site Whitelist Station Clients
operationId: deleteSiteWirelessClientsAllowlist
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Sites Setting
summary: createSiteWirelessClientsAllowlist
description: >-
This endpoint is to provide list of client macs for annotation as whitelist.
Retrieve the current clients list from `whitelist_url` under Site:Setting
operationId: createSiteWirelessClientsAllowlist
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/mac_addresses'
- description: Request Body
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/mac_addresses'
- description: Request containing one or more MAC addresses
examples:
- macs:
- 18-65-90-de-f4-c6
- 84-89-ad-5d-69-0d
contentMediaType: application/json
examples:
Example:
value:
macs:
- 18-65-90-de-f4-c6
- 84-89-ad-5d-69-0d
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/mac_addresses'
- description: Request containing one or more MAC addresses
examples:
- macs:
- 18-65-90-de-f4-c6
- 84-89-ad-5d-69-0d
contentMediaType: application/vnd.api+json
examples:
Example:
value:
macs:
- 18-65-90-de-f4-c6
- 84-89-ad-5d-69-0d
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/sitetemplates/derived:
get:
tags:
- Sites Site Templates
summary: listSiteSiteTemplatesDerived
description: Get the list of derived Site Templates for Site
operationId: listSiteSiteTemplatesDerived
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: resolve
in: query
description: Whether resolve the site variables
style: form
explode: true
schema:
type: boolean
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/site_template'
description: List of site templates
examples:
- - auto_upgrade:
day_of_week: mon
enabled: true
time_of_day: string
version: string
name: string
vars:
SSID_STR: string
VLAN_ID: string
contentMediaType: application/json
examples:
Example:
value:
- auto_upgrade:
day_of_week: mon
enabled: true
time_of_day: string
version: string
name: string
vars:
SSID_STR: string
VLAN_ID: string
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/site_template'
description: List of site templates
examples:
- - auto_upgrade:
day_of_week: mon
enabled: true
time_of_day: string
version: string
name: string
vars:
SSID_STR: string
VLAN_ID: string
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- auto_upgrade:
day_of_week: mon
enabled: true
time_of_day: string
version: string
name: string
vars:
SSID_STR: string
VLAN_ID: string
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/skyatp/events/count:
get:
tags:
- Sites Skyatp
summary: countSiteSkyatpEvents
description: Count by Distinct Attributes of Skyatp Events (WIP)
operationId: countSiteSkyatpEvents
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field used to group this count response. enum: `device_mac`, `mac`, `threat_level`, `type`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/site_sky_atp_events_count_distinct'
- description: 'Field used to group this count response. enum: `device_mac`, `mac`, `threat_level`, `type`'
- name: type
in: query
description: Event type, e.g. cc, fs, mw
style: form
explode: true
schema:
type: string
- name: mac
in: query
description: Filter results by MAC address
style: form
explode: true
schema:
type: string
- name: device_mac
in: query
description: Filter results by device MAC address
style: form
explode: true
schema:
type: string
- name: threat_level
in: query
description: Filter results by threat level
style: form
explode: true
schema:
type: integer
contentEncoding: int32
- name: ip
in: query
description: Filter results by IPv4 address
style: form
explode: true
schema:
type: string
contentEncoding: ipv4
examples:
- 192.168.1.1
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/skyatp/events/search:
get:
tags:
- Sites Skyatp
summary: searchSiteSkyatpEvents
description: Search Skyatp Events (WIP)
operationId: searchSiteSkyatpEvents
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: type
in: query
description: Event type, e.g. cc, fs, mw
style: form
explode: true
schema:
type: string
- name: mac
in: query
description: Filter results by MAC address
style: form
explode: true
schema:
type: string
- name: device_mac
in: query
description: Filter results by device MAC address
style: form
explode: true
schema:
type: string
- name: threat_level
in: query
description: Filter results by threat level
style: form
explode: true
schema:
type: integer
contentEncoding: int32
- name: ip
in: query
description: Filter results by IPv4 address
style: form
explode: true
schema:
type: string
contentEncoding: ipv4
examples:
- 192.168.1.1
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_events_sky_atp_search'
- description: Paginated response for Sky ATP event search results
examples:
- end: 1513176951
limit: 10
results:
- device_mac: 658279bb1fa4
ip: 172.16.0.11
mac: b019c66c8348
org_id: 3139f2c2-fac6-11e5-8156-0242ac110006
site_id: 70e0f468-fc13-11e5-85ad-0242ac110008
threat_level: 7
timestamp: 1592524478
type: cc
start: 1512572151
total: 1
contentMediaType: application/json
examples:
Example:
value:
end: 1513176951
limit: 10
results:
- device_mac: 658279bb1fa4
ip: 172.16.0.11
mac: b019c66c8348
org_id: 3139f2c2-fac6-11e5-8156-0242ac110006
site_id: 70e0f468-fc13-11e5-85ad-0242ac110008
threat_level: 7
timestamp: 1592524478
type: cc
start: 1512572151
total: 1
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_events_sky_atp_search'
- description: Paginated response for Sky ATP event search results
examples:
- end: 1513176951
limit: 10
results:
- device_mac: 658279bb1fa4
ip: 172.16.0.11
mac: b019c66c8348
org_id: 3139f2c2-fac6-11e5-8156-0242ac110006
site_id: 70e0f468-fc13-11e5-85ad-0242ac110008
threat_level: 7
timestamp: 1592524478
type: cc
start: 1512572151
total: 1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 1513176951
limit: 10
results:
- device_mac: 658279bb1fa4
ip: 172.16.0.11
mac: b019c66c8348
org_id: 3139f2c2-fac6-11e5-8156-0242ac110006
site_id: 70e0f468-fc13-11e5-85ad-0242ac110008
threat_level: 7
timestamp: 1592524478
type: cc
start: 1512572151
total: 1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/sle/{scope}/{scope_id}/metric/{metric}/classifier/{classifier}/summary:
get:
tags:
- Sites SLEs
summary: getSiteSleClassifierDetails
description: >-
Get SLE classifier details
This API Endpoint is deprecated and replaced by [Get Site SLE Classifier Summary Trend]($e/Sites%20SLEs/getSiteSleClassifierSummaryTrend)
operationId: getSiteSleClassifierDetails
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: scope
in: path
description: ''
required: true
schema:
$ref: '#/components/schemas/sle_summary_scope'
- name: scope_id
in: path
description: >-
* site_id if `scope`==`site`
* device_id if `scope`==`ap`, `scope`==`switch` or `scope`==`gateway`
* mac if `scope`==`client`
required: true
schema:
type: string
- name: metric
in: path
description: Values from `listSiteSlesMetrics`
required: true
schema:
type: string
- name: classifier
in: path
description: ''
required: true
schema:
type: string
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sle_classifier_summary'
- description: Deprecated SLE classifier summary response
examples:
- classifier:
impact:
num_aps: 2
num_users: 17
total_aps: 3
total_users: 20
interval: 3600
name: wifi-interference
samples:
degraded:
- 0
- 0
- 210.03334
- 3.1333334
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 102.5
- 108.03333
- 0
- 0
- 201.9
- 566.48334
- 135.63333
- 0
duration:
- 0
- 0
- 210.03334
- 3.1333334
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 102.5
- 108.03333
- 0
- 0
- 201.9
- 566.48334
- 135.63333
- 0
total:
- 1302.3
- 1289.0167
- 1396.3167
- 1423.6666
- 1439.2167
- 1414.7
- 1361.0834
- 1371.5834
- 1372.0667
- 1339.1
- 1374.3667
- 1369.9
- 1352.4833
- 1382.8
- 1426.7167
- 1425.6333
- 1403.9333
- 1420.75
- 1416.8334
- 1437.3334
- 1425.1
- 1485.3667
- 1426.4333
- 444.13333
x_label: seconds
y_label: user-minutes
end: 1627312871
failures: []
impact:
num_aps: 2
num_users: 21
total_aps: 3
total_users: 26
metric: capacity
start: 1627226471
contentMediaType: application/json
examples:
Example:
value:
classifier:
impact:
num_aps: 2
num_users: 17
total_aps: 3
total_users: 20
interval: 3600
name: wifi-interference
samples:
degraded:
- 0
- 0
- 210.03334
- 3.1333334
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 102.5
- 108.03333
- 0
- 0
- 201.9
- 566.48334
- 135.63333
- 0
duration:
- 0
- 0
- 210.03334
- 3.1333334
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 102.5
- 108.03333
- 0
- 0
- 201.9
- 566.48334
- 135.63333
- 0
total:
- 1302.3
- 1289.0167
- 1396.3167
- 1423.6666
- 1439.2167
- 1414.7
- 1361.0834
- 1371.5834
- 1372.0667
- 1339.1
- 1374.3667
- 1369.9
- 1352.4833
- 1382.8
- 1426.7167
- 1425.6333
- 1403.9333
- 1420.75
- 1416.8334
- 1437.3334
- 1425.1
- 1485.3667
- 1426.4333
- 444.13333
x_label: seconds
y_label: user-minutes
end: 1627312871
failures: []
impact:
num_aps: 2
num_users: 21
total_aps: 3
total_users: 26
metric: capacity
start: 1627226471
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/sle_classifier_summary'
- description: Deprecated SLE classifier summary response
examples:
- classifier:
impact:
num_aps: 2
num_users: 17
total_aps: 3
total_users: 20
interval: 3600
name: wifi-interference
samples:
degraded:
- 0
- 0
- 210.03334
- 3.1333334
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 102.5
- 108.03333
- 0
- 0
- 201.9
- 566.48334
- 135.63333
- 0
duration:
- 0
- 0
- 210.03334
- 3.1333334
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 102.5
- 108.03333
- 0
- 0
- 201.9
- 566.48334
- 135.63333
- 0
total:
- 1302.3
- 1289.0167
- 1396.3167
- 1423.6666
- 1439.2167
- 1414.7
- 1361.0834
- 1371.5834
- 1372.0667
- 1339.1
- 1374.3667
- 1369.9
- 1352.4833
- 1382.8
- 1426.7167
- 1425.6333
- 1403.9333
- 1420.75
- 1416.8334
- 1437.3334
- 1425.1
- 1485.3667
- 1426.4333
- 444.13333
x_label: seconds
y_label: user-minutes
end: 1627312871
failures: []
impact:
num_aps: 2
num_users: 21
total_aps: 3
total_users: 26
metric: capacity
start: 1627226471
contentMediaType: application/vnd.api+json
examples:
Example:
value:
classifier:
impact:
num_aps: 2
num_users: 17
total_aps: 3
total_users: 20
interval: 3600
name: wifi-interference
samples:
degraded:
- 0
- 0
- 210.03334
- 3.1333334
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 102.5
- 108.03333
- 0
- 0
- 201.9
- 566.48334
- 135.63333
- 0
duration:
- 0
- 0
- 210.03334
- 3.1333334
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 102.5
- 108.03333
- 0
- 0
- 201.9
- 566.48334
- 135.63333
- 0
total:
- 1302.3
- 1289.0167
- 1396.3167
- 1423.6666
- 1439.2167
- 1414.7
- 1361.0834
- 1371.5834
- 1372.0667
- 1339.1
- 1374.3667
- 1369.9
- 1352.4833
- 1382.8
- 1426.7167
- 1425.6333
- 1403.9333
- 1420.75
- 1416.8334
- 1437.3334
- 1425.1
- 1485.3667
- 1426.4333
- 444.13333
x_label: seconds
y_label: user-minutes
end: 1627312871
failures: []
impact:
num_aps: 2
num_users: 21
total_aps: 3
total_users: 26
metric: capacity
start: 1627226471
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: true
parameters: []
/api/v1/sites/{site_id}/sle/{scope}/{scope_id}/metric/{metric}/classifier/{classifier}/summary-trend:
get:
tags:
- Sites SLEs
summary: getSiteSleClassifierSummaryTrend
description: Get SLE classifier Summary Trend
operationId: getSiteSleClassifierSummaryTrend
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: scope
in: path
description: ''
required: true
schema:
$ref: '#/components/schemas/sle_summary_scope'
- name: scope_id
in: path
description: >-
* site_id if `scope`==`site`
* device_id if `scope`==`ap`, `scope`==`switch` or `scope`==`gateway`
* mac if `scope`==`client`
required: true
schema:
type: string
- name: metric
in: path
description: Values from `listSiteSlesMetrics`
required: true
schema:
type: string
- name: classifier
in: path
description: ''
required: true
schema:
type: string
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sle_classifier_summary_trend'
- description: Time-series trend response for an SLE classifier
examples:
- classifier:
interval: 3600
name: wifi-interference
samples:
degraded:
- 0
- 0
- 210.03334
- 3.1333334
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 102.5
- 108.03333
- 0
- 0
- 201.9
- 566.48334
- 135.63333
- 0
duration:
- 0
- 0
- 210.03334
- 3.1333334
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 102.5
- 108.03333
- 0
- 0
- 201.9
- 566.48334
- 135.63333
- 0
total:
- 1302.3
- 1289.0167
- 1396.3167
- 1423.6666
- 1439.2167
- 1414.7
- 1361.0834
- 1371.5834
- 1372.0667
- 1339.1
- 1374.3667
- 1369.9
- 1352.4833
- 1382.8
- 1426.7167
- 1425.6333
- 1403.9333
- 1420.75
- 1416.8334
- 1437.3334
- 1425.1
- 1485.3667
- 1426.4333
- 444.13333
x_label: seconds
y_label: user-minutes
end: 1627312871
metric: capacity
start: 1627226471
contentMediaType: application/json
examples:
Example:
value:
classifier:
interval: 3600
name: wifi-interference
samples:
degraded:
- 0
- 0
- 210.03334
- 3.1333334
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 102.5
- 108.03333
- 0
- 0
- 201.9
- 566.48334
- 135.63333
- 0
duration:
- 0
- 0
- 210.03334
- 3.1333334
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 102.5
- 108.03333
- 0
- 0
- 201.9
- 566.48334
- 135.63333
- 0
total:
- 1302.3
- 1289.0167
- 1396.3167
- 1423.6666
- 1439.2167
- 1414.7
- 1361.0834
- 1371.5834
- 1372.0667
- 1339.1
- 1374.3667
- 1369.9
- 1352.4833
- 1382.8
- 1426.7167
- 1425.6333
- 1403.9333
- 1420.75
- 1416.8334
- 1437.3334
- 1425.1
- 1485.3667
- 1426.4333
- 444.13333
x_label: seconds
y_label: user-minutes
end: 1627312871
metric: capacity
start: 1627226471
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/sle_classifier_summary_trend'
- description: Time-series trend response for an SLE classifier
examples:
- classifier:
interval: 3600
name: wifi-interference
samples:
degraded:
- 0
- 0
- 210.03334
- 3.1333334
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 102.5
- 108.03333
- 0
- 0
- 201.9
- 566.48334
- 135.63333
- 0
duration:
- 0
- 0
- 210.03334
- 3.1333334
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 102.5
- 108.03333
- 0
- 0
- 201.9
- 566.48334
- 135.63333
- 0
total:
- 1302.3
- 1289.0167
- 1396.3167
- 1423.6666
- 1439.2167
- 1414.7
- 1361.0834
- 1371.5834
- 1372.0667
- 1339.1
- 1374.3667
- 1369.9
- 1352.4833
- 1382.8
- 1426.7167
- 1425.6333
- 1403.9333
- 1420.75
- 1416.8334
- 1437.3334
- 1425.1
- 1485.3667
- 1426.4333
- 444.13333
x_label: seconds
y_label: user-minutes
end: 1627312871
metric: capacity
start: 1627226471
contentMediaType: application/vnd.api+json
examples:
Example:
value:
classifier:
interval: 3600
name: wifi-interference
samples:
degraded:
- 0
- 0
- 210.03334
- 3.1333334
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 102.5
- 108.03333
- 0
- 0
- 201.9
- 566.48334
- 135.63333
- 0
duration:
- 0
- 0
- 210.03334
- 3.1333334
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 102.5
- 108.03333
- 0
- 0
- 201.9
- 566.48334
- 135.63333
- 0
total:
- 1302.3
- 1289.0167
- 1396.3167
- 1423.6666
- 1439.2167
- 1414.7
- 1361.0834
- 1371.5834
- 1372.0667
- 1339.1
- 1374.3667
- 1369.9
- 1352.4833
- 1382.8
- 1426.7167
- 1425.6333
- 1403.9333
- 1420.75
- 1416.8334
- 1437.3334
- 1425.1
- 1485.3667
- 1426.4333
- 444.13333
x_label: seconds
y_label: user-minutes
end: 1627312871
metric: capacity
start: 1627226471
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/sle/{scope}/{scope_id}/metric/{metric}/classifiers:
get:
tags:
- Sites SLEs
summary: listSiteSleMetricClassifiers
description: List classifiers for a specific metric
operationId: listSiteSleMetricClassifiers
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: scope
in: path
description: ''
required: true
schema:
$ref: '#/components/schemas/site_sle_metric_classifiers_scope_parameters'
- name: scope_id
in: path
description: >-
* site_id if `scope`==`site`
* device_id if `scope`==`ap`, `scope`==`switch` or `scope`==`gateway`
* mac if `scope`==`client`
required: true
schema:
type: string
- name: metric
in: path
description: Values from `listSiteSlesMetrics`
required: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
uniqueItems: true
type: array
items:
type: string
description: Unique string values returned or accepted by this schema
examples:
- - asymmetry-uplink
- weak-signal
- asymmetry-downlink
contentMediaType: application/json
examples:
example:
value:
- asymmetry-uplink
- weak-signal
- asymmetry-downlink
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/sle/{scope}/{scope_id}/metric/{metric}/histogram:
get:
tags:
- Sites SLEs
summary: getSiteSleHistogram
description: Get the histogram for the SLE metric
operationId: getSiteSleHistogram
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: scope
in: path
description: ''
required: true
schema:
$ref: '#/components/schemas/site_sle_histogram_scope_parameters'
- name: scope_id
in: path
description: >-
* site_id if `scope`==`site`
* device_id if `scope`==`ap`, `scope`==`switch` or `scope`==`gateway`
* mac if `scope`==`client`
required: true
schema:
type: string
- name: metric
in: path
description: Values from `listSiteSlesMetrics`
required: true
schema:
type: string
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sle_histogram'
- description: Histogram response for an SLE metric
examples:
- data:
- range:
- null
- 0
value: 0
- range:
- 0
- 10
value: 0
- range:
- 10
- 20
value: 5105
- range:
- 20
- 30
value: 10616
- range:
- 30
- 40
value: 40051
- range:
- 40
- 50
value: 141201
- range:
- 50
- 60
value: 949823
- range:
- 60
- 70
value: 686308
- range:
- 70
- 80
value: 177670
- range:
- 80
- 90
value: 689
- range:
- 90
- 100
value: 0
- range:
- 100
- null
value: 0
end: 1627055181
metric: capacity
start: 1626968781
x_label: available_bandwidth(%)
y_label: seconds
contentMediaType: application/json
examples:
Example:
value:
data:
- range:
- null
- 0
value: 0
- range:
- 0
- 10
value: 0
- range:
- 10
- 20
value: 5105
- range:
- 20
- 30
value: 10616
- range:
- 30
- 40
value: 40051
- range:
- 40
- 50
value: 141201
- range:
- 50
- 60
value: 949823
- range:
- 60
- 70
value: 686308
- range:
- 70
- 80
value: 177670
- range:
- 80
- 90
value: 689
- range:
- 90
- 100
value: 0
- range:
- 100
- null
value: 0
end: 1627055181
metric: capacity
start: 1626968781
x_label: available_bandwidth(%)
y_label: seconds
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/sle_histogram'
- description: Histogram response for an SLE metric
examples:
- data:
- range:
- null
- 0
value: 0
- range:
- 0
- 10
value: 0
- range:
- 10
- 20
value: 5105
- range:
- 20
- 30
value: 10616
- range:
- 30
- 40
value: 40051
- range:
- 40
- 50
value: 141201
- range:
- 50
- 60
value: 949823
- range:
- 60
- 70
value: 686308
- range:
- 70
- 80
value: 177670
- range:
- 80
- 90
value: 689
- range:
- 90
- 100
value: 0
- range:
- 100
- null
value: 0
end: 1627055181
metric: capacity
start: 1626968781
x_label: available_bandwidth(%)
y_label: seconds
contentMediaType: application/vnd.api+json
examples:
Example:
value:
data:
- range:
- null
- 0
value: 0
- range:
- 0
- 10
value: 0
- range:
- 10
- 20
value: 5105
- range:
- 20
- 30
value: 10616
- range:
- 30
- 40
value: 40051
- range:
- 40
- 50
value: 141201
- range:
- 50
- 60
value: 949823
- range:
- 60
- 70
value: 686308
- range:
- 70
- 80
value: 177670
- range:
- 80
- 90
value: 689
- range:
- 90
- 100
value: 0
- range:
- 100
- null
value: 0
end: 1627055181
metric: capacity
start: 1626968781
x_label: available_bandwidth(%)
y_label: seconds
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/sle/{scope}/{scope_id}/metric/{metric}/impact-summary:
get:
tags:
- Sites SLEs
summary: getSiteSleImpactSummary
description: "Get impact summary counts optionally filtered by classifier and failure type\n \n* Wireless SLE Fields: `wlan`, `device_type`, `device_os` ,`band`, `ap`, `server`, `mxedge`\n* Wired SLE Fields: `switch`, `client`, `vlan`, `interface`, `chassis`\n* WAN SLE Fields: `gateway`, `client`, `interface`, `chassis`, `peer_path`, `gateway_zones`"
operationId: getSiteSleImpactSummary
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: scope
in: path
description: ''
required: true
schema:
$ref: '#/components/schemas/site_sle_impact_summary_scope_parameters'
- name: scope_id
in: path
description: >-
* site_id if `scope`==`site`
* device_id if `scope`==`ap`, `scope`==`switch` or `scope`==`gateway`
* mac if `scope`==`client`
required: true
schema:
type: string
- name: metric
in: path
description: Values from `listSiteSlesMetrics`
required: true
schema:
type: string
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: fields
in: query
description: 'Additional response fields to include, as a comma-separated list or `*` for all fields. enum: `ap`, `band`, `chassis`, `client`, `device_os`, `device_type`, `gateway`, `gateway_zones`, `interface`, `mxedge`, `peer_path`, `server`, `switch`, `vlan`, `wlan`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/site_sle_impact_summary_fields_parameter'
- description: 'Additional response fields to include, as a comma-separated list or `*` for all fields. enum: `ap`, `band`, `chassis`, `client`, `device_os`, `device_type`, `gateway`, `gateway_zones`, `interface`, `mxedge`, `peer_path`, `server`, `switch`, `vlan`, `wlan`'
- name: classifier
in: query
description: Filter SLE impact results by classifier
style: form
explode: true
schema:
type: string
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sle_impact_summary'
- description: SLE impact summary grouped by client, device, AP, WLAN, and band dimensions
examples:
- ap:
- ap_mac: 5c5b3550bd2e
degraded: 1486
duration: 0
name: ap43-off.lab
total: 27406
- ap_mac: d420b083e17a
degraded: 3
duration: 0
name: ap33-ent.lab
total: 1193
band:
- band: '24'
degraded: 1410
duration: 0
name: '24'
total: 28536
- band: '5'
degraded: 78
duration: 0
name: '5'
total: 4679
classifier: ''
device_os:
- degraded: 1329
device_os: ''
duration: 0
name: unknown
total: 27165
- degraded: 81
device_os: Linux
duration: 0
name: Linux
total: 1437
- degraded: 36
device_os: Android 11
duration: 0
name: Android 11
total: 761
- degraded: 39
device_os: '14.6'
duration: 0
name: '14.6'
total: 2413
- degraded: 2
device_os: Catalina
duration: 0
name: Catalina
total: 1438
device_type:
- degraded: 1410
device_type: ''
duration: 0
name: unknown
total: 28603
- degraded: 2
device_type: iPhone
duration: 0
name: iPhone
total: 1263
- degraded: 36
device_type: OnePlus
duration: 0
name: OnePlus
total: 761
- degraded: 37
device_type: iPad
duration: 0
name: iPad
total: 1150
- degraded: 2
device_type: Mac
duration: 0
name: Mac
total: 1438
end: 1627312734
failure: ''
metric: capacity
start: 1627226334
wlan:
- degraded: 37
duration: 0
name: MlN.ADM
total: 1150
wlan_id: ba3f85fc-ba48-4d8f-ad89-152e5c42db18
- degraded: 1410
duration: 0
name: MlN
total: 28603
wlan_id: 649a2336-b1e0-47bd-961c-f637dbe50e7b
- degraded: 41
duration: 0
name: MlN.1X
total: 3462
wlan_id: a937da77-fe3c-4784-86c4-f2134d7b1483
contentMediaType: application/json
examples:
Example:
value:
ap:
- ap_mac: 5c5b3550bd2e
degraded: 1486
duration: 0
name: ap43-off.lab
total: 27406
- ap_mac: d420b083e17a
degraded: 3
duration: 0
name: ap33-ent.lab
total: 1193
band:
- band: '24'
degraded: 1410
duration: 0
name: '24'
total: 28536
- band: '5'
degraded: 78
duration: 0
name: '5'
total: 4679
classifier: ''
device_os:
- degraded: 1329
device_os: ''
duration: 0
name: unknown
total: 27165
- degraded: 81
device_os: Linux
duration: 0
name: Linux
total: 1437
- degraded: 36
device_os: Android 11
duration: 0
name: Android 11
total: 761
- degraded: 39
device_os: '14.6'
duration: 0
name: '14.6'
total: 2413
- degraded: 2
device_os: Catalina
duration: 0
name: Catalina
total: 1438
device_type:
- degraded: 1410
device_type: ''
duration: 0
name: unknown
total: 28603
- degraded: 2
device_type: iPhone
duration: 0
name: iPhone
total: 1263
- degraded: 36
device_type: OnePlus
duration: 0
name: OnePlus
total: 761
- degraded: 37
device_type: iPad
duration: 0
name: iPad
total: 1150
- degraded: 2
device_type: Mac
duration: 0
name: Mac
total: 1438
end: 1627312734
failure: ''
metric: capacity
start: 1627226334
wlan:
- degraded: 37
duration: 0
name: MlN.ADM
total: 1150
wlan_id: ba3f85fc-ba48-4d8f-ad89-152e5c42db18
- degraded: 1410
duration: 0
name: MlN
total: 28603
wlan_id: 649a2336-b1e0-47bd-961c-f637dbe50e7b
- degraded: 41
duration: 0
name: MlN.1X
total: 3462
wlan_id: a937da77-fe3c-4784-86c4-f2134d7b1483
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/sle_impact_summary'
- description: SLE impact summary grouped by client, device, AP, WLAN, and band dimensions
examples:
- ap:
- ap_mac: 5c5b3550bd2e
degraded: 1486
duration: 0
name: ap43-off.lab
total: 27406
- ap_mac: d420b083e17a
degraded: 3
duration: 0
name: ap33-ent.lab
total: 1193
band:
- band: '24'
degraded: 1410
duration: 0
name: '24'
total: 28536
- band: '5'
degraded: 78
duration: 0
name: '5'
total: 4679
classifier: ''
device_os:
- degraded: 1329
device_os: ''
duration: 0
name: unknown
total: 27165
- degraded: 81
device_os: Linux
duration: 0
name: Linux
total: 1437
- degraded: 36
device_os: Android 11
duration: 0
name: Android 11
total: 761
- degraded: 39
device_os: '14.6'
duration: 0
name: '14.6'
total: 2413
- degraded: 2
device_os: Catalina
duration: 0
name: Catalina
total: 1438
device_type:
- degraded: 1410
device_type: ''
duration: 0
name: unknown
total: 28603
- degraded: 2
device_type: iPhone
duration: 0
name: iPhone
total: 1263
- degraded: 36
device_type: OnePlus
duration: 0
name: OnePlus
total: 761
- degraded: 37
device_type: iPad
duration: 0
name: iPad
total: 1150
- degraded: 2
device_type: Mac
duration: 0
name: Mac
total: 1438
end: 1627312734
failure: ''
metric: capacity
start: 1627226334
wlan:
- degraded: 37
duration: 0
name: MlN.ADM
total: 1150
wlan_id: ba3f85fc-ba48-4d8f-ad89-152e5c42db18
- degraded: 1410
duration: 0
name: MlN
total: 28603
wlan_id: 649a2336-b1e0-47bd-961c-f637dbe50e7b
- degraded: 41
duration: 0
name: MlN.1X
total: 3462
wlan_id: a937da77-fe3c-4784-86c4-f2134d7b1483
contentMediaType: application/vnd.api+json
examples:
Example:
value:
ap:
- ap_mac: 5c5b3550bd2e
degraded: 1486
duration: 0
name: ap43-off.lab
total: 27406
- ap_mac: d420b083e17a
degraded: 3
duration: 0
name: ap33-ent.lab
total: 1193
band:
- band: '24'
degraded: 1410
duration: 0
name: '24'
total: 28536
- band: '5'
degraded: 78
duration: 0
name: '5'
total: 4679
classifier: ''
device_os:
- degraded: 1329
device_os: ''
duration: 0
name: unknown
total: 27165
- degraded: 81
device_os: Linux
duration: 0
name: Linux
total: 1437
- degraded: 36
device_os: Android 11
duration: 0
name: Android 11
total: 761
- degraded: 39
device_os: '14.6'
duration: 0
name: '14.6'
total: 2413
- degraded: 2
device_os: Catalina
duration: 0
name: Catalina
total: 1438
device_type:
- degraded: 1410
device_type: ''
duration: 0
name: unknown
total: 28603
- degraded: 2
device_type: iPhone
duration: 0
name: iPhone
total: 1263
- degraded: 36
device_type: OnePlus
duration: 0
name: OnePlus
total: 761
- degraded: 37
device_type: iPad
duration: 0
name: iPad
total: 1150
- degraded: 2
device_type: Mac
duration: 0
name: Mac
total: 1438
end: 1627312734
failure: ''
metric: capacity
start: 1627226334
wlan:
- degraded: 37
duration: 0
name: MlN.ADM
total: 1150
wlan_id: ba3f85fc-ba48-4d8f-ad89-152e5c42db18
- degraded: 1410
duration: 0
name: MlN
total: 28603
wlan_id: 649a2336-b1e0-47bd-961c-f637dbe50e7b
- degraded: 41
duration: 0
name: MlN.1X
total: 3462
wlan_id: a937da77-fe3c-4784-86c4-f2134d7b1483
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/sle/{scope}/{scope_id}/metric/{metric}/impacted-applications:
get:
tags:
- Sites SLEs
summary: listSiteSleImpactedApplications
description: For WAN SLEs. List the impacted interfaces optionally filtered by classifier and failure type
operationId: listSiteSleImpactedApplications
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: scope
in: path
description: ''
required: true
schema:
$ref: '#/components/schemas/site_sle_scope'
- name: scope_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
- name: metric
in: path
description: Values from `listSiteSlesMetrics`
required: true
schema:
type: string
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: classifier
in: query
description: Filter SLE impact results by classifier
style: form
explode: true
schema:
type: string
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sle_impacted_applications'
- description: Paginated list of applications impacted by an SLE metric
examples:
- apps:
- app: ZOOM
degraded: 371103
duration: 0
name: ZOOM
threshold: 173
total: 1771274
classifier: ''
end: 1668760746
failure: ''
limit: 1000
metric: application_health
page: 1
start: 1668121200
total_count: 1
contentMediaType: application/json
examples:
Example:
value:
apps:
- app: ZOOM
degraded: 371103
duration: 0
name: ZOOM
threshold: 173
total: 1771274
classifier: ''
end: 1668760746
failure: ''
limit: 1000
metric: application_health
page: 1
start: 1668121200
total_count: 1
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/sle_impacted_applications'
- description: Paginated list of applications impacted by an SLE metric
examples:
- apps:
- app: ZOOM
degraded: 371103
duration: 0
name: ZOOM
threshold: 173
total: 1771274
classifier: ''
end: 1668760746
failure: ''
limit: 1000
metric: application_health
page: 1
start: 1668121200
total_count: 1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
apps:
- app: ZOOM
degraded: 371103
duration: 0
name: ZOOM
threshold: 173
total: 1771274
classifier: ''
end: 1668760746
failure: ''
limit: 1000
metric: application_health
page: 1
start: 1668121200
total_count: 1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/sle/{scope}/{scope_id}/metric/{metric}/impacted-aps:
get:
tags:
- Sites SLEs
summary: listSiteSleImpactedAps
description: For Wireless SLEs. List the impacted APs optionally filtered by classifier and failure type
operationId: listSiteSleImpactedAps
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: scope
in: path
description: ''
required: true
schema:
$ref: '#/components/schemas/site_sle_impacted_aps_scope_parameters'
- name: scope_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
- name: metric
in: path
description: Values from `listSiteSlesMetrics`
required: true
schema:
type: string
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: classifier
in: query
description: Filter SLE impact results by classifier
style: form
explode: true
schema:
type: string
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sle_impacted_aps'
- description: Paginated list of APs impacted by an SLE metric
examples:
- aps:
- ap_mac: 5c5b35500000
degraded: 1486
duration: 0
name: ap43.lab
total: 27377
- ap_mac: d420b0830000
degraded: 3
duration: 0
name: ap33.lab
total: 1189
classifier: ''
end: 1627313016
failure: ''
limit: 1000
metric: capacity
page: 1
start: 1627226616
total_count: 2
contentMediaType: application/json
examples:
Example:
value:
aps:
- ap_mac: 5c5b35500000
degraded: 1486
duration: 0
name: ap43.lab
total: 27377
- ap_mac: d420b0830000
degraded: 3
duration: 0
name: ap33.lab
total: 1189
classifier: ''
end: 1627313016
failure: ''
limit: 1000
metric: capacity
page: 1
start: 1627226616
total_count: 2
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/sle_impacted_aps'
- description: Paginated list of APs impacted by an SLE metric
examples:
- aps:
- ap_mac: 5c5b35500000
degraded: 1486
duration: 0
name: ap43.lab
total: 27377
- ap_mac: d420b0830000
degraded: 3
duration: 0
name: ap33.lab
total: 1189
classifier: ''
end: 1627313016
failure: ''
limit: 1000
metric: capacity
page: 1
start: 1627226616
total_count: 2
contentMediaType: application/vnd.api+json
examples:
Example:
value:
aps:
- ap_mac: 5c5b35500000
degraded: 1486
duration: 0
name: ap43.lab
total: 27377
- ap_mac: d420b0830000
degraded: 3
duration: 0
name: ap33.lab
total: 1189
classifier: ''
end: 1627313016
failure: ''
limit: 1000
metric: capacity
page: 1
start: 1627226616
total_count: 2
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/sle/{scope}/{scope_id}/metric/{metric}/impacted-chassis:
get:
tags:
- Sites SLEs
summary: listSiteSleImpactedChassis
description: For Wired and WAN SLEs. List the impacted interfaces optionally filtered by classifier and failure type
operationId: listSiteSleImpactedChassis
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: scope
in: path
description: ''
required: true
schema:
$ref: '#/components/schemas/site_sle_impacted_chassis_scope_parameters'
- name: scope_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
- name: metric
in: path
description: Values from `listSiteSlesMetrics`
required: true
schema:
type: string
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: classifier
in: query
description: Filter SLE impact results by classifier
style: form
explode: true
schema:
type: string
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sle_impacted_chassis'
- description: Paginated list of chassis impacted by an SLE metric
examples:
- chassis:
- chassis: '1'
degraded: 12.283334
duration: 13655.167
role: master
switch_mac: d0dd49012345
switch_name: test-chassis
total: 13655.167
classifier: ''
end: 1668760643
failure: ''
limit: 1000
metric: switch_health
page: 1
start: 1668121200
total_count: 1
contentMediaType: application/json
examples:
Example:
value:
chassis:
- chassis: '1'
degraded: 12.283334
duration: 13655.167
role: master
switch_mac: d0dd49012345
switch_name: test-chassis
total: 13655.167
classifier: ''
end: 1668760643
failure: ''
limit: 1000
metric: switch_health
page: 1
start: 1668121200
total_count: 1
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/sle_impacted_chassis'
- description: Paginated list of chassis impacted by an SLE metric
examples:
- chassis:
- chassis: '1'
degraded: 12.283334
duration: 13655.167
role: master
switch_mac: d0dd49012345
switch_name: test-chassis
total: 13655.167
classifier: ''
end: 1668760643
failure: ''
limit: 1000
metric: switch_health
page: 1
start: 1668121200
total_count: 1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
chassis:
- chassis: '1'
degraded: 12.283334
duration: 13655.167
role: master
switch_mac: d0dd49012345
switch_name: test-chassis
total: 13655.167
classifier: ''
end: 1668760643
failure: ''
limit: 1000
metric: switch_health
page: 1
start: 1668121200
total_count: 1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/sle/{scope}/{scope_id}/metric/{metric}/impacted-clients:
get:
tags:
- Sites SLEs
summary: listSiteSleImpactedWiredClients
description: For Wired SLEs. List the impacted interfaces optionally filtered by classifier and failure type
operationId: listSiteSleImpactedWiredClients
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: scope
in: path
description: ''
required: true
schema:
$ref: '#/components/schemas/site_sle_impacted_clients_scope_parameters'
- name: scope_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
- name: metric
in: path
description: Values from `listSiteSlesMetrics`
required: true
schema:
type: string
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: classifier
in: query
description: Filter SLE impact results by classifier
style: form
explode: true
schema:
type: string
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sle_impacted_clients'
- description: Paginated list of clients impacted by an SLE metric
examples:
- classifier: ''
clients:
- degraded: 40
duration: 11014
mac: '001122334455'
name: test-device
switches:
- interfaces:
- ge-0/0/6
switch_mac: 2c2131001122
switch_name: test-ex
total: 11014
end: 1668760198
failure: ''
limit: 1000
metric: switch_throughput
page: 1
start: 1668726000
total_count: 1
contentMediaType: application/json
examples:
Example:
value:
classifier: ''
clients:
- degraded: 40
duration: 11014
mac: '001122334455'
name: test-device
switches:
- interfaces:
- ge-0/0/6
switch_mac: 2c2131001122
switch_name: test-ex
total: 11014
end: 1668760198
failure: ''
limit: 1000
metric: switch_throughput
page: 1
start: 1668726000
total_count: 1
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/sle_impacted_clients'
- description: Paginated list of clients impacted by an SLE metric
examples:
- classifier: ''
clients:
- degraded: 40
duration: 11014
mac: '001122334455'
name: test-device
switches:
- interfaces:
- ge-0/0/6
switch_mac: 2c2131001122
switch_name: test-ex
total: 11014
end: 1668760198
failure: ''
limit: 1000
metric: switch_throughput
page: 1
start: 1668726000
total_count: 1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
classifier: ''
clients:
- degraded: 40
duration: 11014
mac: '001122334455'
name: test-device
switches:
- interfaces:
- ge-0/0/6
switch_mac: 2c2131001122
switch_name: test-ex
total: 11014
end: 1668760198
failure: ''
limit: 1000
metric: switch_throughput
page: 1
start: 1668726000
total_count: 1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/sle/{scope}/{scope_id}/metric/{metric}/impacted-gateways:
get:
tags:
- Sites SLEs
summary: listSiteSleImpactedGateways
description: For WAN SLEs. List the impacted interfaces optionally filtered by classifier and failure type
operationId: listSiteSleImpactedGateways
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: scope
in: path
description: ''
required: true
schema:
$ref: '#/components/schemas/site_sle_impacted_gateways_scope_parameters'
- name: scope_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
- name: metric
in: path
description: Values from `listSiteSlesMetrics`
required: true
schema:
type: string
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: classifier
in: query
description: Filter SLE impact results by classifier
style: form
explode: true
schema:
type: string
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sle_impacted_gateways'
- description: Paginated list of gateways impacted by an SLE metric
examples:
- classifier: ''
end: 1668760746
failure: ''
gateways:
- degraded: 758573.1
duration: 2770997
gateway_mac: fc3342001122
gateway_model: SRX320
gateway_version: 20.4R1.12
name: test-SRX
total: 2770997
limit: 1000
metric: application_health
page: 1
start: 1668121200
total_count: 1
contentMediaType: application/json
examples:
Example:
value:
classifier: ''
end: 1668760746
failure: ''
gateways:
- degraded: 758573.1
duration: 2770997
gateway_mac: fc3342001122
gateway_model: SRX320
gateway_version: 20.4R1.12
name: test-SRX
total: 2770997
limit: 1000
metric: application_health
page: 1
start: 1668121200
total_count: 1
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/sle_impacted_gateways'
- description: Paginated list of gateways impacted by an SLE metric
examples:
- classifier: ''
end: 1668760746
failure: ''
gateways:
- degraded: 758573.1
duration: 2770997
gateway_mac: fc3342001122
gateway_model: SRX320
gateway_version: 20.4R1.12
name: test-SRX
total: 2770997
limit: 1000
metric: application_health
page: 1
start: 1668121200
total_count: 1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
classifier: ''
end: 1668760746
failure: ''
gateways:
- degraded: 758573.1
duration: 2770997
gateway_mac: fc3342001122
gateway_model: SRX320
gateway_version: 20.4R1.12
name: test-SRX
total: 2770997
limit: 1000
metric: application_health
page: 1
start: 1668121200
total_count: 1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/sle/{scope}/{scope_id}/metric/{metric}/impacted-interfaces:
get:
tags:
- Sites SLEs
summary: listSiteSleImpactedInterfaces
description: For Wired and WAN SLEs. List the impacted interfaces optionally filtered by classifier and failure type
operationId: listSiteSleImpactedInterfaces
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: scope
in: path
description: ''
required: true
schema:
$ref: '#/components/schemas/site_sle_impacted_interfaces_scope_parameters'
- name: scope_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
- name: metric
in: path
description: Values from `listSiteSlesMetrics`
required: true
schema:
type: string
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: classifier
in: query
description: Filter SLE impact results by classifier
style: form
explode: true
schema:
type: string
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sle_impacted_interfaces'
- description: Paginated list of interfaces impacted by an SLE metric
examples:
- classifier: ''
end: 1668760198
failure: ''
interfaces:
- degraded: 11.583333
duration: 765.4667
interface_name: ge-0/0/10
switch_mac: 2c2131001122
switch_name: test-ex
total: 765.4667
- degraded: 191.08333
duration: 13775.35
interface_name: xe-0/1/0
switch_mac: 2c2131001122
switch_name: test-ex
total: 13775.35
limit: 1000
metric: switch_throughput
page: 1
start: 1668726000
total_count: 5
contentMediaType: application/json
examples:
Example:
value:
classifier: ''
end: 1668760198
failure: ''
interfaces:
- degraded: 11.583333
duration: 765.4667
interface_name: ge-0/0/10
switch_mac: 2c2131001122
switch_name: test-ex
total: 765.4667
- degraded: 191.08333
duration: 13775.35
interface_name: xe-0/1/0
switch_mac: 2c2131001122
switch_name: test-ex
total: 13775.35
limit: 1000
metric: switch_throughput
page: 1
start: 1668726000
total_count: 5
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/sle_impacted_interfaces'
- description: Paginated list of interfaces impacted by an SLE metric
examples:
- classifier: ''
end: 1668760198
failure: ''
interfaces:
- degraded: 11.583333
duration: 765.4667
interface_name: ge-0/0/10
switch_mac: 2c2131001122
switch_name: test-ex
total: 765.4667
- degraded: 191.08333
duration: 13775.35
interface_name: xe-0/1/0
switch_mac: 2c2131001122
switch_name: test-ex
total: 13775.35
limit: 1000
metric: switch_throughput
page: 1
start: 1668726000
total_count: 5
contentMediaType: application/vnd.api+json
examples:
Example:
value:
classifier: ''
end: 1668760198
failure: ''
interfaces:
- degraded: 11.583333
duration: 765.4667
interface_name: ge-0/0/10
switch_mac: 2c2131001122
switch_name: test-ex
total: 765.4667
- degraded: 191.08333
duration: 13775.35
interface_name: xe-0/1/0
switch_mac: 2c2131001122
switch_name: test-ex
total: 13775.35
limit: 1000
metric: switch_throughput
page: 1
start: 1668726000
total_count: 5
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/sle/{scope}/{scope_id}/metric/{metric}/impacted-switches:
get:
tags:
- Sites SLEs
summary: listSiteSleImpactedSwitches
description: For Wired SLEs. List the impacted switches optionally filtered by classifier and failure type
operationId: listSiteSleImpactedSwitches
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: scope
in: path
description: ''
required: true
schema:
$ref: '#/components/schemas/site_sle_impacted_switches_scope_parameters'
- name: scope_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
- name: metric
in: path
description: Values from `listSiteSlesMetrics`
required: true
schema:
type: string
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: classifier
in: query
description: Filter SLE impact results by classifier
style: form
explode: true
schema:
type: string
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sle_impacted_switches'
- description: Paginated list of switches impacted by an SLE metric
examples:
- classifier: ''
end: 1668760198
failure: ''
limit: 1000
metric: switch_throughput
page: 1
start: 1668726000
switches:
- degraded: 109.88333
duration: 5753.75
interface:
- ge-0/0/11
- xe-0/1/0
name: test-ex
switch_mac: 2c2131001122
switch_model: EX2300-C-12P
switch_version: 20.4R3-S3.4
total: 5753.75
total_count: 1
contentMediaType: application/json
examples:
Example:
value:
classifier: ''
end: 1668760198
failure: ''
limit: 1000
metric: switch_throughput
page: 1
start: 1668726000
switches:
- degraded: 109.88333
duration: 5753.75
interface:
- ge-0/0/11
- xe-0/1/0
name: test-ex
switch_mac: 2c2131001122
switch_model: EX2300-C-12P
switch_version: 20.4R3-S3.4
total: 5753.75
total_count: 1
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/sle_impacted_switches'
- description: Paginated list of switches impacted by an SLE metric
examples:
- classifier: ''
end: 1668760198
failure: ''
limit: 1000
metric: switch_throughput
page: 1
start: 1668726000
switches:
- degraded: 109.88333
duration: 5753.75
interface:
- ge-0/0/11
- xe-0/1/0
name: test-ex
switch_mac: 2c2131001122
switch_model: EX2300-C-12P
switch_version: 20.4R3-S3.4
total: 5753.75
total_count: 1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
classifier: ''
end: 1668760198
failure: ''
limit: 1000
metric: switch_throughput
page: 1
start: 1668726000
switches:
- degraded: 109.88333
duration: 5753.75
interface:
- ge-0/0/11
- xe-0/1/0
name: test-ex
switch_mac: 2c2131001122
switch_model: EX2300-C-12P
switch_version: 20.4R3-S3.4
total: 5753.75
total_count: 1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/sle/{scope}/{scope_id}/metric/{metric}/impacted-users:
get:
tags:
- Sites SLEs
summary: listSiteSleImpactedWirelessClients
description: For Wireless SLEs. List the impacted wireless users optionally filtered by classifier and failure type
operationId: listSiteSleImpactedWirelessClients
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: scope
in: path
description: ''
required: true
schema:
$ref: '#/components/schemas/site_sle_impacted_users_scope_parameter'
- name: scope_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
- name: metric
in: path
description: Values from `listSiteSlesMetrics`
required: true
schema:
type: string
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: classifier
in: query
description: Filter SLE impact results by classifier
style: form
explode: true
schema:
type: string
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sle_impacted_users'
- description: Paginated list of users impacted by an SLE metric
examples:
- classifier: ''
end: 1627313103
failure: ''
limit: 1000
metric: capacity
page: 1
start: 1627226703
total_count: 21
users:
- ap_mac: d420b0830000
ap_name: ap33.lab
degraded: 2
device_os: '14.6'
device_type: iPhone
duration: 1270
mac: dc080f360000
name: aPhone-20973
ssid: lab.1X
total: 1270
wlan_id: a937da77-0000-0000-0000-f2134d7b1483
- ap_mac: 5c5b35500000
ap_name: ap43.lab
degraded: 36
device_os: Android 11
device_type: OnePlus
duration: 767
mac: 4c4feedc0000
name: OnePlus-8
ssid: lab.1X
total: 767
wlan_id: a937da77-0000-0000-0000-f2134d7b1483
- ap_mac: 5c5b35500000
ap_name: ap43.lab
degraded: 2
device_os: Catalina
device_type: Mac
duration: 1405
mac: a483e7390000
name: tmunzer-mbp
ssid: lab.1X
total: 1405
wlan_id: a937da77-0000-0000-0000-f2134d7b1483
- ap_mac: 5c5b35500000
ap_name: ap43.lab
degraded: 81
device_os: Linux
device_type: unknown
duration: 1403
mac: 5caafd0d0000
name: SonosZP
ssid: lab
total: 1403
wlan_id: 649a2336-0000-0000-0000-f637dbe50e7b
contentMediaType: application/json
examples:
Example:
value:
classifier: ''
end: 1627313103
failure: ''
limit: 1000
metric: capacity
page: 1
start: 1627226703
total_count: 21
users:
- ap_mac: d420b0830000
ap_name: ap33.lab
degraded: 2
device_os: '14.6'
device_type: iPhone
duration: 1270
mac: dc080f360000
name: aPhone-20973
ssid: lab.1X
total: 1270
wlan_id: a937da77-0000-0000-0000-f2134d7b1483
- ap_mac: 5c5b35500000
ap_name: ap43.lab
degraded: 36
device_os: Android 11
device_type: OnePlus
duration: 767
mac: 4c4feedc0000
name: OnePlus-8
ssid: lab.1X
total: 767
wlan_id: a937da77-0000-0000-0000-f2134d7b1483
- ap_mac: 5c5b35500000
ap_name: ap43.lab
degraded: 2
device_os: Catalina
device_type: Mac
duration: 1405
mac: a483e7390000
name: tmunzer-mbp
ssid: lab.1X
total: 1405
wlan_id: a937da77-0000-0000-0000-f2134d7b1483
- ap_mac: 5c5b35500000
ap_name: ap43.lab
degraded: 81
device_os: Linux
device_type: unknown
duration: 1403
mac: 5caafd0d0000
name: SonosZP
ssid: lab
total: 1403
wlan_id: 649a2336-0000-0000-0000-f637dbe50e7b
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/sle_impacted_users'
- description: Paginated list of users impacted by an SLE metric
examples:
- classifier: ''
end: 1627313103
failure: ''
limit: 1000
metric: capacity
page: 1
start: 1627226703
total_count: 21
users:
- ap_mac: d420b0830000
ap_name: ap33.lab
degraded: 2
device_os: '14.6'
device_type: iPhone
duration: 1270
mac: dc080f360000
name: aPhone-20973
ssid: lab.1X
total: 1270
wlan_id: a937da77-0000-0000-0000-f2134d7b1483
- ap_mac: 5c5b35500000
ap_name: ap43.lab
degraded: 36
device_os: Android 11
device_type: OnePlus
duration: 767
mac: 4c4feedc0000
name: OnePlus-8
ssid: lab.1X
total: 767
wlan_id: a937da77-0000-0000-0000-f2134d7b1483
- ap_mac: 5c5b35500000
ap_name: ap43.lab
degraded: 2
device_os: Catalina
device_type: Mac
duration: 1405
mac: a483e7390000
name: tmunzer-mbp
ssid: lab.1X
total: 1405
wlan_id: a937da77-0000-0000-0000-f2134d7b1483
- ap_mac: 5c5b35500000
ap_name: ap43.lab
degraded: 81
device_os: Linux
device_type: unknown
duration: 1403
mac: 5caafd0d0000
name: SonosZP
ssid: lab
total: 1403
wlan_id: 649a2336-0000-0000-0000-f637dbe50e7b
contentMediaType: application/vnd.api+json
examples:
Example:
value:
classifier: ''
end: 1627313103
failure: ''
limit: 1000
metric: capacity
page: 1
start: 1627226703
total_count: 21
users:
- ap_mac: d420b0830000
ap_name: ap33.lab
degraded: 2
device_os: '14.6'
device_type: iPhone
duration: 1270
mac: dc080f360000
name: aPhone-20973
ssid: lab.1X
total: 1270
wlan_id: a937da77-0000-0000-0000-f2134d7b1483
- ap_mac: 5c5b35500000
ap_name: ap43.lab
degraded: 36
device_os: Android 11
device_type: OnePlus
duration: 767
mac: 4c4feedc0000
name: OnePlus-8
ssid: lab.1X
total: 767
wlan_id: a937da77-0000-0000-0000-f2134d7b1483
- ap_mac: 5c5b35500000
ap_name: ap43.lab
degraded: 2
device_os: Catalina
device_type: Mac
duration: 1405
mac: a483e7390000
name: tmunzer-mbp
ssid: lab.1X
total: 1405
wlan_id: a937da77-0000-0000-0000-f2134d7b1483
- ap_mac: 5c5b35500000
ap_name: ap43.lab
degraded: 81
device_os: Linux
device_type: unknown
duration: 1403
mac: 5caafd0d0000
name: SonosZP
ssid: lab
total: 1403
wlan_id: 649a2336-0000-0000-0000-f637dbe50e7b
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/sle/{scope}/{scope_id}/metric/{metric}/summary:
get:
tags:
- Sites SLEs
summary: getSiteSleSummary
description: >-
Get the summary for the SLE metric
This API Endpoint is deprecated and replaced by [Get Site SLE Summary Trend]($e/Sites%20SLEs/getSiteSleSummaryTrend)
operationId: getSiteSleSummary
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: scope
in: path
description: ''
required: true
schema:
$ref: '#/components/schemas/site_sle_metric_summary_scope_parameters'
- name: scope_id
in: path
description: >-
* site_id if `scope`==`site`
* device_id if `scope`==`ap`, `scope`==`switch` or `scope`==`gateway`
* mac if `scope`==`client`
required: true
schema:
type: string
- name: metric
in: path
description: Values from `listSiteSlesMetrics`
required: true
schema:
type: string
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sle_summary'
- description: Deprecated SLE summary response for a metric window
examples:
- classifiers:
- impact:
num_aps: 1
num_users: 4
total_aps: 3
total_users: 26
interval: 3600
name: client-count
samples:
degraded:
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 5.8
- 0
- 0
- 0
- 4.65
- 0
- 7.55
- 47.55
- 13.266666
duration:
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 5.8
- 0
- 0
- 0
- 4.65
- 0
- 7.55
- 47.55
- 13.266666
total:
- 1302.3
- 1289.0167
- 1396.3167
- 1423.6666
- 1439.2167
- 1414.7
- 1361.0834
- 1371.5834
- 1372.0667
- 1339.1
- 1374.3667
- 1369.9
- 1352.4833
- 1382.8
- 1426.7167
- 1425.6333
- 1403.9333
- 1420.75
- 1416.8334
- 1437.3334
- 1425.1
- 1485.3667
- 1426.4333
- 289.83334
x_label: seconds
y_label: user-minutes
- impact:
num_aps: 2
num_users: 17
total_aps: 3
total_users: 26
interval: 3600
name: wifi-interference
samples:
degraded:
- 0
- 0
- 210.03334
- 3.1333334
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 102.5
- 108.03333
- 0
- 0
- 201.9
- 566.48334
- 135.63333
- 0
duration:
- 0
- 0
- 210.03334
- 3.1333334
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 102.5
- 108.03333
- 0
- 0
- 201.9
- 566.48334
- 135.63333
- 0
total:
- 1302.3
- 1289.0167
- 1396.3167
- 1423.6666
- 1439.2167
- 1414.7
- 1361.0834
- 1371.5834
- 1372.0667
- 1339.1
- 1374.3667
- 1369.9
- 1352.4833
- 1382.8
- 1426.7167
- 1425.6333
- 1403.9333
- 1420.75
- 1416.8334
- 1437.3334
- 1425.1
- 1485.3667
- 1426.4333
- 289.83334
x_label: seconds
y_label: user-minutes
- impact:
num_aps: 0
num_users: 0
total_aps: 3
total_users: 26
interval: 3600
name: client_usage
samples:
degraded:
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
duration:
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
total:
- 1302.3
- 1289.0167
- 1396.3167
- 1423.6666
- 1439.2167
- 1414.7
- 1361.0834
- 1371.5834
- 1372.0667
- 1339.1
- 1374.3667
- 1369.9
- 1352.4833
- 1382.8
- 1426.7167
- 1425.6333
- 1403.9333
- 1420.75
- 1416.8334
- 1437.3334
- 1425.1
- 1485.3667
- 1426.4333
- 289.83334
x_label: seconds
y_label: user-minutes
- impact:
num_aps: 1
num_users: 17
total_aps: 3
total_users: 26
interval: 3600
name: non-wifi-interference
samples:
degraded:
- 0
- 0
- 0
- 0
- 16.65
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 31.15
- 17.616667
- 17.85
- 0
- 0
- 0
- 0
duration:
- 0
- 0
- 0
- 0
- 16.65
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 31.15
- 17.616667
- 17.85
- 0
- 0
- 0
- 0
total:
- 1302.3
- 1289.0167
- 1396.3167
- 1423.6666
- 1439.2167
- 1414.7
- 1361.0834
- 1371.5834
- 1372.0667
- 1339.1
- 1374.3667
- 1369.9
- 1352.4833
- 1382.8
- 1426.7167
- 1425.6333
- 1403.9333
- 1420.75
- 1416.8334
- 1437.3334
- 1425.1
- 1485.3667
- 1426.4333
- 289.83334
x_label: seconds
y_label: user-minutes
end: 1627312606
events: []
impact:
num_aps: 2
num_users: 21
total_aps: 3
total_users: 26
sle:
interval: 3600
name: capacity
samples:
degraded:
- 0
- 0
- 210.03334
- 3.1333334
- 16.65
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 5.8
- 102.5
- 139.18333
- 17.616667
- 22.5
- 201.9
- 574.0333
- 183.18333
- 13.266666
total:
- 1302.3
- 1289.0167
- 1396.3167
- 1423.6666
- 1439.2167
- 1414.7
- 1361.0834
- 1371.5834
- 1372.0667
- 1339.1
- 1374.3667
- 1369.9
- 1352.4833
- 1382.8
- 1426.7167
- 1425.6333
- 1403.9333
- 1420.75
- 1416.8334
- 1437.3334
- 1425.1
- 1485.3667
- 1426.4333
- 289.83334
value:
- 0.6764934
- 0.6783766
- 0.641645
- 0.6934629
- 0.68676674
- 0.6834809
- 0.6961604
- 0.6979584
- 0.7033722
- 0.70410794
- 0.7025278
- 0.70305353
- 0.70292175
- 0.7009334
- 0.69344264
- 0.68596864
- 0.5952168
- 0.62183666
- 0.68161446
- 0.65352744
- 0.6183489
- 0.54178274
- 0.6044712
- 0.66845906
x_label: seconds
y_label: '%'
start: 1627226206
contentMediaType: application/json
examples:
Example:
value:
classifiers:
- impact:
num_aps: 1
num_users: 4
total_aps: 3
total_users: 26
interval: 3600
name: client-count
samples:
degraded:
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 5.8
- 0
- 0
- 0
- 4.65
- 0
- 7.55
- 47.55
- 13.266666
duration:
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 5.8
- 0
- 0
- 0
- 4.65
- 0
- 7.55
- 47.55
- 13.266666
total:
- 1302.3
- 1289.0167
- 1396.3167
- 1423.6666
- 1439.2167
- 1414.7
- 1361.0834
- 1371.5834
- 1372.0667
- 1339.1
- 1374.3667
- 1369.9
- 1352.4833
- 1382.8
- 1426.7167
- 1425.6333
- 1403.9333
- 1420.75
- 1416.8334
- 1437.3334
- 1425.1
- 1485.3667
- 1426.4333
- 289.83334
x_label: seconds
y_label: user-minutes
- impact:
num_aps: 2
num_users: 17
total_aps: 3
total_users: 26
interval: 3600
name: wifi-interference
samples:
degraded:
- 0
- 0
- 210.03334
- 3.1333334
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 102.5
- 108.03333
- 0
- 0
- 201.9
- 566.48334
- 135.63333
- 0
duration:
- 0
- 0
- 210.03334
- 3.1333334
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 102.5
- 108.03333
- 0
- 0
- 201.9
- 566.48334
- 135.63333
- 0
total:
- 1302.3
- 1289.0167
- 1396.3167
- 1423.6666
- 1439.2167
- 1414.7
- 1361.0834
- 1371.5834
- 1372.0667
- 1339.1
- 1374.3667
- 1369.9
- 1352.4833
- 1382.8
- 1426.7167
- 1425.6333
- 1403.9333
- 1420.75
- 1416.8334
- 1437.3334
- 1425.1
- 1485.3667
- 1426.4333
- 289.83334
x_label: seconds
y_label: user-minutes
- impact:
num_aps: 0
num_users: 0
total_aps: 3
total_users: 26
interval: 3600
name: client_usage
samples:
degraded:
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
duration:
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
total:
- 1302.3
- 1289.0167
- 1396.3167
- 1423.6666
- 1439.2167
- 1414.7
- 1361.0834
- 1371.5834
- 1372.0667
- 1339.1
- 1374.3667
- 1369.9
- 1352.4833
- 1382.8
- 1426.7167
- 1425.6333
- 1403.9333
- 1420.75
- 1416.8334
- 1437.3334
- 1425.1
- 1485.3667
- 1426.4333
- 289.83334
x_label: seconds
y_label: user-minutes
- impact:
num_aps: 1
num_users: 17
total_aps: 3
total_users: 26
interval: 3600
name: non-wifi-interference
samples:
degraded:
- 0
- 0
- 0
- 0
- 16.65
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 31.15
- 17.616667
- 17.85
- 0
- 0
- 0
- 0
duration:
- 0
- 0
- 0
- 0
- 16.65
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 31.15
- 17.616667
- 17.85
- 0
- 0
- 0
- 0
total:
- 1302.3
- 1289.0167
- 1396.3167
- 1423.6666
- 1439.2167
- 1414.7
- 1361.0834
- 1371.5834
- 1372.0667
- 1339.1
- 1374.3667
- 1369.9
- 1352.4833
- 1382.8
- 1426.7167
- 1425.6333
- 1403.9333
- 1420.75
- 1416.8334
- 1437.3334
- 1425.1
- 1485.3667
- 1426.4333
- 289.83334
x_label: seconds
y_label: user-minutes
end: 1627312606
events: []
impact:
num_aps: 2
num_users: 21
total_aps: 3
total_users: 26
sle:
interval: 3600
name: capacity
samples:
degraded:
- 0
- 0
- 210.03334
- 3.1333334
- 16.65
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 5.8
- 102.5
- 139.18333
- 17.616667
- 22.5
- 201.9
- 574.0333
- 183.18333
- 13.266666
total:
- 1302.3
- 1289.0167
- 1396.3167
- 1423.6666
- 1439.2167
- 1414.7
- 1361.0834
- 1371.5834
- 1372.0667
- 1339.1
- 1374.3667
- 1369.9
- 1352.4833
- 1382.8
- 1426.7167
- 1425.6333
- 1403.9333
- 1420.75
- 1416.8334
- 1437.3334
- 1425.1
- 1485.3667
- 1426.4333
- 289.83334
value:
- 0.6764934
- 0.6783766
- 0.641645
- 0.6934629
- 0.68676674
- 0.6834809
- 0.6961604
- 0.6979584
- 0.7033722
- 0.70410794
- 0.7025278
- 0.70305353
- 0.70292175
- 0.7009334
- 0.69344264
- 0.68596864
- 0.5952168
- 0.62183666
- 0.68161446
- 0.65352744
- 0.6183489
- 0.54178274
- 0.6044712
- 0.66845906
x_label: seconds
y_label: '%'
start: 1627226206
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/sle_summary'
- description: Deprecated SLE summary response for a metric window
examples:
- classifiers:
- impact:
num_aps: 1
num_users: 4
total_aps: 3
total_users: 26
interval: 3600
name: client-count
samples:
degraded:
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 5.8
- 0
- 0
- 0
- 4.65
- 0
- 7.55
- 47.55
- 13.266666
duration:
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 5.8
- 0
- 0
- 0
- 4.65
- 0
- 7.55
- 47.55
- 13.266666
total:
- 1302.3
- 1289.0167
- 1396.3167
- 1423.6666
- 1439.2167
- 1414.7
- 1361.0834
- 1371.5834
- 1372.0667
- 1339.1
- 1374.3667
- 1369.9
- 1352.4833
- 1382.8
- 1426.7167
- 1425.6333
- 1403.9333
- 1420.75
- 1416.8334
- 1437.3334
- 1425.1
- 1485.3667
- 1426.4333
- 289.83334
x_label: seconds
y_label: user-minutes
- impact:
num_aps: 2
num_users: 17
total_aps: 3
total_users: 26
interval: 3600
name: wifi-interference
samples:
degraded:
- 0
- 0
- 210.03334
- 3.1333334
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 102.5
- 108.03333
- 0
- 0
- 201.9
- 566.48334
- 135.63333
- 0
duration:
- 0
- 0
- 210.03334
- 3.1333334
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 102.5
- 108.03333
- 0
- 0
- 201.9
- 566.48334
- 135.63333
- 0
total:
- 1302.3
- 1289.0167
- 1396.3167
- 1423.6666
- 1439.2167
- 1414.7
- 1361.0834
- 1371.5834
- 1372.0667
- 1339.1
- 1374.3667
- 1369.9
- 1352.4833
- 1382.8
- 1426.7167
- 1425.6333
- 1403.9333
- 1420.75
- 1416.8334
- 1437.3334
- 1425.1
- 1485.3667
- 1426.4333
- 289.83334
x_label: seconds
y_label: user-minutes
- impact:
num_aps: 0
num_users: 0
total_aps: 3
total_users: 26
interval: 3600
name: client_usage
samples:
degraded:
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
duration:
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
total:
- 1302.3
- 1289.0167
- 1396.3167
- 1423.6666
- 1439.2167
- 1414.7
- 1361.0834
- 1371.5834
- 1372.0667
- 1339.1
- 1374.3667
- 1369.9
- 1352.4833
- 1382.8
- 1426.7167
- 1425.6333
- 1403.9333
- 1420.75
- 1416.8334
- 1437.3334
- 1425.1
- 1485.3667
- 1426.4333
- 289.83334
x_label: seconds
y_label: user-minutes
- impact:
num_aps: 1
num_users: 17
total_aps: 3
total_users: 26
interval: 3600
name: non-wifi-interference
samples:
degraded:
- 0
- 0
- 0
- 0
- 16.65
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 31.15
- 17.616667
- 17.85
- 0
- 0
- 0
- 0
duration:
- 0
- 0
- 0
- 0
- 16.65
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 31.15
- 17.616667
- 17.85
- 0
- 0
- 0
- 0
total:
- 1302.3
- 1289.0167
- 1396.3167
- 1423.6666
- 1439.2167
- 1414.7
- 1361.0834
- 1371.5834
- 1372.0667
- 1339.1
- 1374.3667
- 1369.9
- 1352.4833
- 1382.8
- 1426.7167
- 1425.6333
- 1403.9333
- 1420.75
- 1416.8334
- 1437.3334
- 1425.1
- 1485.3667
- 1426.4333
- 289.83334
x_label: seconds
y_label: user-minutes
end: 1627312606
events: []
impact:
num_aps: 2
num_users: 21
total_aps: 3
total_users: 26
sle:
interval: 3600
name: capacity
samples:
degraded:
- 0
- 0
- 210.03334
- 3.1333334
- 16.65
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 5.8
- 102.5
- 139.18333
- 17.616667
- 22.5
- 201.9
- 574.0333
- 183.18333
- 13.266666
total:
- 1302.3
- 1289.0167
- 1396.3167
- 1423.6666
- 1439.2167
- 1414.7
- 1361.0834
- 1371.5834
- 1372.0667
- 1339.1
- 1374.3667
- 1369.9
- 1352.4833
- 1382.8
- 1426.7167
- 1425.6333
- 1403.9333
- 1420.75
- 1416.8334
- 1437.3334
- 1425.1
- 1485.3667
- 1426.4333
- 289.83334
value:
- 0.6764934
- 0.6783766
- 0.641645
- 0.6934629
- 0.68676674
- 0.6834809
- 0.6961604
- 0.6979584
- 0.7033722
- 0.70410794
- 0.7025278
- 0.70305353
- 0.70292175
- 0.7009334
- 0.69344264
- 0.68596864
- 0.5952168
- 0.62183666
- 0.68161446
- 0.65352744
- 0.6183489
- 0.54178274
- 0.6044712
- 0.66845906
x_label: seconds
y_label: '%'
start: 1627226206
contentMediaType: application/vnd.api+json
examples:
Example:
value:
classifiers:
- impact:
num_aps: 1
num_users: 4
total_aps: 3
total_users: 26
interval: 3600
name: client-count
samples:
degraded:
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 5.8
- 0
- 0
- 0
- 4.65
- 0
- 7.55
- 47.55
- 13.266666
duration:
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 5.8
- 0
- 0
- 0
- 4.65
- 0
- 7.55
- 47.55
- 13.266666
total:
- 1302.3
- 1289.0167
- 1396.3167
- 1423.6666
- 1439.2167
- 1414.7
- 1361.0834
- 1371.5834
- 1372.0667
- 1339.1
- 1374.3667
- 1369.9
- 1352.4833
- 1382.8
- 1426.7167
- 1425.6333
- 1403.9333
- 1420.75
- 1416.8334
- 1437.3334
- 1425.1
- 1485.3667
- 1426.4333
- 289.83334
x_label: seconds
y_label: user-minutes
- impact:
num_aps: 2
num_users: 17
total_aps: 3
total_users: 26
interval: 3600
name: wifi-interference
samples:
degraded:
- 0
- 0
- 210.03334
- 3.1333334
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 102.5
- 108.03333
- 0
- 0
- 201.9
- 566.48334
- 135.63333
- 0
duration:
- 0
- 0
- 210.03334
- 3.1333334
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 102.5
- 108.03333
- 0
- 0
- 201.9
- 566.48334
- 135.63333
- 0
total:
- 1302.3
- 1289.0167
- 1396.3167
- 1423.6666
- 1439.2167
- 1414.7
- 1361.0834
- 1371.5834
- 1372.0667
- 1339.1
- 1374.3667
- 1369.9
- 1352.4833
- 1382.8
- 1426.7167
- 1425.6333
- 1403.9333
- 1420.75
- 1416.8334
- 1437.3334
- 1425.1
- 1485.3667
- 1426.4333
- 289.83334
x_label: seconds
y_label: user-minutes
- impact:
num_aps: 0
num_users: 0
total_aps: 3
total_users: 26
interval: 3600
name: client_usage
samples:
degraded:
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
duration:
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
total:
- 1302.3
- 1289.0167
- 1396.3167
- 1423.6666
- 1439.2167
- 1414.7
- 1361.0834
- 1371.5834
- 1372.0667
- 1339.1
- 1374.3667
- 1369.9
- 1352.4833
- 1382.8
- 1426.7167
- 1425.6333
- 1403.9333
- 1420.75
- 1416.8334
- 1437.3334
- 1425.1
- 1485.3667
- 1426.4333
- 289.83334
x_label: seconds
y_label: user-minutes
- impact:
num_aps: 1
num_users: 17
total_aps: 3
total_users: 26
interval: 3600
name: non-wifi-interference
samples:
degraded:
- 0
- 0
- 0
- 0
- 16.65
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 31.15
- 17.616667
- 17.85
- 0
- 0
- 0
- 0
duration:
- 0
- 0
- 0
- 0
- 16.65
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 31.15
- 17.616667
- 17.85
- 0
- 0
- 0
- 0
total:
- 1302.3
- 1289.0167
- 1396.3167
- 1423.6666
- 1439.2167
- 1414.7
- 1361.0834
- 1371.5834
- 1372.0667
- 1339.1
- 1374.3667
- 1369.9
- 1352.4833
- 1382.8
- 1426.7167
- 1425.6333
- 1403.9333
- 1420.75
- 1416.8334
- 1437.3334
- 1425.1
- 1485.3667
- 1426.4333
- 289.83334
x_label: seconds
y_label: user-minutes
end: 1627312606
events: []
impact:
num_aps: 2
num_users: 21
total_aps: 3
total_users: 26
sle:
interval: 3600
name: capacity
samples:
degraded:
- 0
- 0
- 210.03334
- 3.1333334
- 16.65
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 5.8
- 102.5
- 139.18333
- 17.616667
- 22.5
- 201.9
- 574.0333
- 183.18333
- 13.266666
total:
- 1302.3
- 1289.0167
- 1396.3167
- 1423.6666
- 1439.2167
- 1414.7
- 1361.0834
- 1371.5834
- 1372.0667
- 1339.1
- 1374.3667
- 1369.9
- 1352.4833
- 1382.8
- 1426.7167
- 1425.6333
- 1403.9333
- 1420.75
- 1416.8334
- 1437.3334
- 1425.1
- 1485.3667
- 1426.4333
- 289.83334
value:
- 0.6764934
- 0.6783766
- 0.641645
- 0.6934629
- 0.68676674
- 0.6834809
- 0.6961604
- 0.6979584
- 0.7033722
- 0.70410794
- 0.7025278
- 0.70305353
- 0.70292175
- 0.7009334
- 0.69344264
- 0.68596864
- 0.5952168
- 0.62183666
- 0.68161446
- 0.65352744
- 0.6183489
- 0.54178274
- 0.6044712
- 0.66845906
x_label: seconds
y_label: '%'
start: 1627226206
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: true
parameters: []
/api/v1/sites/{site_id}/sle/{scope}/{scope_id}/metric/{metric}/summary-trend:
get:
tags:
- Sites SLEs
summary: getSiteSleSummaryTrend
description: Get the summary for the SLE metric trend
operationId: getSiteSleSummaryTrend
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: scope
in: path
description: ''
required: true
schema:
$ref: '#/components/schemas/site_sle_metric_summary_scope_parameters'
- name: scope_id
in: path
description: >-
* site_id if `scope`==`site`
* device_id if `scope`==`ap`, `scope`==`switch` or `scope`==`gateway`
* mac if `scope`==`client`
required: true
schema:
type: string
- name: metric
in: path
description: Values from `listSiteSlesMetrics`
required: true
schema:
type: string
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sle_summary_trend'
- description: Time-series SLE summary trend response
examples:
- classifiers:
- interval: 3600
name: client-count
samples:
degraded:
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 5.8
- 0
- 0
- 0
- 4.65
- 0
- 7.55
- 47.55
- 13.266666
duration:
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 5.8
- 0
- 0
- 0
- 4.65
- 0
- 7.55
- 47.55
- 13.266666
total:
- 1302.3
- 1289.0167
- 1396.3167
- 1423.6666
- 1439.2167
- 1414.7
- 1361.0834
- 1371.5834
- 1372.0667
- 1339.1
- 1374.3667
- 1369.9
- 1352.4833
- 1382.8
- 1426.7167
- 1425.6333
- 1403.9333
- 1420.75
- 1416.8334
- 1437.3334
- 1425.1
- 1485.3667
- 1426.4333
- 289.83334
x_label: seconds
y_label: user-minutes
- interval: 3600
name: wifi-interference
samples:
degraded:
- 0
- 0
- 210.03334
- 3.1333334
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 102.5
- 108.03333
- 0
- 0
- 201.9
- 566.48334
- 135.63333
- 0
duration:
- 0
- 0
- 210.03334
- 3.1333334
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 102.5
- 108.03333
- 0
- 0
- 201.9
- 566.48334
- 135.63333
- 0
total:
- 1302.3
- 1289.0167
- 1396.3167
- 1423.6666
- 1439.2167
- 1414.7
- 1361.0834
- 1371.5834
- 1372.0667
- 1339.1
- 1374.3667
- 1369.9
- 1352.4833
- 1382.8
- 1426.7167
- 1425.6333
- 1403.9333
- 1420.75
- 1416.8334
- 1437.3334
- 1425.1
- 1485.3667
- 1426.4333
- 289.83334
x_label: seconds
y_label: user-minutes
- interval: 3600
name: client_usage
samples:
degraded:
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
duration:
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
total:
- 1302.3
- 1289.0167
- 1396.3167
- 1423.6666
- 1439.2167
- 1414.7
- 1361.0834
- 1371.5834
- 1372.0667
- 1339.1
- 1374.3667
- 1369.9
- 1352.4833
- 1382.8
- 1426.7167
- 1425.6333
- 1403.9333
- 1420.75
- 1416.8334
- 1437.3334
- 1425.1
- 1485.3667
- 1426.4333
- 289.83334
x_label: seconds
y_label: user-minutes
- interval: 3600
name: non-wifi-interference
samples:
degraded:
- 0
- 0
- 0
- 0
- 16.65
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 31.15
- 17.616667
- 17.85
- 0
- 0
- 0
- 0
duration:
- 0
- 0
- 0
- 0
- 16.65
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 31.15
- 17.616667
- 17.85
- 0
- 0
- 0
- 0
total:
- 1302.3
- 1289.0167
- 1396.3167
- 1423.6666
- 1439.2167
- 1414.7
- 1361.0834
- 1371.5834
- 1372.0667
- 1339.1
- 1374.3667
- 1369.9
- 1352.4833
- 1382.8
- 1426.7167
- 1425.6333
- 1403.9333
- 1420.75
- 1416.8334
- 1437.3334
- 1425.1
- 1485.3667
- 1426.4333
- 289.83334
x_label: seconds
y_label: user-minutes
end: 1627312606
sle:
interval: 3600
name: capacity
samples:
degraded:
- 0
- 0
- 210.03334
- 3.1333334
- 16.65
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 5.8
- 102.5
- 139.18333
- 17.616667
- 22.5
- 201.9
- 574.0333
- 183.18333
- 13.266666
total:
- 1302.3
- 1289.0167
- 1396.3167
- 1423.6666
- 1439.2167
- 1414.7
- 1361.0834
- 1371.5834
- 1372.0667
- 1339.1
- 1374.3667
- 1369.9
- 1352.4833
- 1382.8
- 1426.7167
- 1425.6333
- 1403.9333
- 1420.75
- 1416.8334
- 1437.3334
- 1425.1
- 1485.3667
- 1426.4333
- 289.83334
value:
- 0.6764934
- 0.6783766
- 0.641645
- 0.6934629
- 0.68676674
- 0.6834809
- 0.6961604
- 0.6979584
- 0.7033722
- 0.70410794
- 0.7025278
- 0.70305353
- 0.70292175
- 0.7009334
- 0.69344264
- 0.68596864
- 0.5952168
- 0.62183666
- 0.68161446
- 0.65352744
- 0.6183489
- 0.54178274
- 0.6044712
- 0.66845906
x_label: seconds
y_label: '%'
start: 1627226206
contentMediaType: application/json
examples:
Example:
value:
classifiers:
- interval: 3600
name: client-count
samples:
degraded:
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 5.8
- 0
- 0
- 0
- 4.65
- 0
- 7.55
- 47.55
- 13.266666
duration:
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 5.8
- 0
- 0
- 0
- 4.65
- 0
- 7.55
- 47.55
- 13.266666
total:
- 1302.3
- 1289.0167
- 1396.3167
- 1423.6666
- 1439.2167
- 1414.7
- 1361.0834
- 1371.5834
- 1372.0667
- 1339.1
- 1374.3667
- 1369.9
- 1352.4833
- 1382.8
- 1426.7167
- 1425.6333
- 1403.9333
- 1420.75
- 1416.8334
- 1437.3334
- 1425.1
- 1485.3667
- 1426.4333
- 289.83334
x_label: seconds
y_label: user-minutes
- interval: 3600
name: wifi-interference
samples:
degraded:
- 0
- 0
- 210.03334
- 3.1333334
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 102.5
- 108.03333
- 0
- 0
- 201.9
- 566.48334
- 135.63333
- 0
duration:
- 0
- 0
- 210.03334
- 3.1333334
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 102.5
- 108.03333
- 0
- 0
- 201.9
- 566.48334
- 135.63333
- 0
total:
- 1302.3
- 1289.0167
- 1396.3167
- 1423.6666
- 1439.2167
- 1414.7
- 1361.0834
- 1371.5834
- 1372.0667
- 1339.1
- 1374.3667
- 1369.9
- 1352.4833
- 1382.8
- 1426.7167
- 1425.6333
- 1403.9333
- 1420.75
- 1416.8334
- 1437.3334
- 1425.1
- 1485.3667
- 1426.4333
- 289.83334
x_label: seconds
y_label: user-minutes
- interval: 3600
name: client_usage
samples:
degraded:
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
duration:
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
total:
- 1302.3
- 1289.0167
- 1396.3167
- 1423.6666
- 1439.2167
- 1414.7
- 1361.0834
- 1371.5834
- 1372.0667
- 1339.1
- 1374.3667
- 1369.9
- 1352.4833
- 1382.8
- 1426.7167
- 1425.6333
- 1403.9333
- 1420.75
- 1416.8334
- 1437.3334
- 1425.1
- 1485.3667
- 1426.4333
- 289.83334
x_label: seconds
y_label: user-minutes
- interval: 3600
name: non-wifi-interference
samples:
degraded:
- 0
- 0
- 0
- 0
- 16.65
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 31.15
- 17.616667
- 17.85
- 0
- 0
- 0
- 0
duration:
- 0
- 0
- 0
- 0
- 16.65
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 31.15
- 17.616667
- 17.85
- 0
- 0
- 0
- 0
total:
- 1302.3
- 1289.0167
- 1396.3167
- 1423.6666
- 1439.2167
- 1414.7
- 1361.0834
- 1371.5834
- 1372.0667
- 1339.1
- 1374.3667
- 1369.9
- 1352.4833
- 1382.8
- 1426.7167
- 1425.6333
- 1403.9333
- 1420.75
- 1416.8334
- 1437.3334
- 1425.1
- 1485.3667
- 1426.4333
- 289.83334
x_label: seconds
y_label: user-minutes
end: 1627312606
sle:
interval: 3600
name: capacity
samples:
degraded:
- 0
- 0
- 210.03334
- 3.1333334
- 16.65
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 5.8
- 102.5
- 139.18333
- 17.616667
- 22.5
- 201.9
- 574.0333
- 183.18333
- 13.266666
total:
- 1302.3
- 1289.0167
- 1396.3167
- 1423.6666
- 1439.2167
- 1414.7
- 1361.0834
- 1371.5834
- 1372.0667
- 1339.1
- 1374.3667
- 1369.9
- 1352.4833
- 1382.8
- 1426.7167
- 1425.6333
- 1403.9333
- 1420.75
- 1416.8334
- 1437.3334
- 1425.1
- 1485.3667
- 1426.4333
- 289.83334
value:
- 0.6764934
- 0.6783766
- 0.641645
- 0.6934629
- 0.68676674
- 0.6834809
- 0.6961604
- 0.6979584
- 0.7033722
- 0.70410794
- 0.7025278
- 0.70305353
- 0.70292175
- 0.7009334
- 0.69344264
- 0.68596864
- 0.5952168
- 0.62183666
- 0.68161446
- 0.65352744
- 0.6183489
- 0.54178274
- 0.6044712
- 0.66845906
x_label: seconds
y_label: '%'
start: 1627226206
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/sle_summary_trend'
- description: Time-series SLE summary trend response
examples:
- classifiers:
- interval: 3600
name: client-count
samples:
degraded:
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 5.8
- 0
- 0
- 0
- 4.65
- 0
- 7.55
- 47.55
- 13.266666
duration:
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 5.8
- 0
- 0
- 0
- 4.65
- 0
- 7.55
- 47.55
- 13.266666
total:
- 1302.3
- 1289.0167
- 1396.3167
- 1423.6666
- 1439.2167
- 1414.7
- 1361.0834
- 1371.5834
- 1372.0667
- 1339.1
- 1374.3667
- 1369.9
- 1352.4833
- 1382.8
- 1426.7167
- 1425.6333
- 1403.9333
- 1420.75
- 1416.8334
- 1437.3334
- 1425.1
- 1485.3667
- 1426.4333
- 289.83334
x_label: seconds
y_label: user-minutes
- interval: 3600
name: wifi-interference
samples:
degraded:
- 0
- 0
- 210.03334
- 3.1333334
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 102.5
- 108.03333
- 0
- 0
- 201.9
- 566.48334
- 135.63333
- 0
duration:
- 0
- 0
- 210.03334
- 3.1333334
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 102.5
- 108.03333
- 0
- 0
- 201.9
- 566.48334
- 135.63333
- 0
total:
- 1302.3
- 1289.0167
- 1396.3167
- 1423.6666
- 1439.2167
- 1414.7
- 1361.0834
- 1371.5834
- 1372.0667
- 1339.1
- 1374.3667
- 1369.9
- 1352.4833
- 1382.8
- 1426.7167
- 1425.6333
- 1403.9333
- 1420.75
- 1416.8334
- 1437.3334
- 1425.1
- 1485.3667
- 1426.4333
- 289.83334
x_label: seconds
y_label: user-minutes
- interval: 3600
name: client_usage
samples:
degraded:
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
duration:
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
total:
- 1302.3
- 1289.0167
- 1396.3167
- 1423.6666
- 1439.2167
- 1414.7
- 1361.0834
- 1371.5834
- 1372.0667
- 1339.1
- 1374.3667
- 1369.9
- 1352.4833
- 1382.8
- 1426.7167
- 1425.6333
- 1403.9333
- 1420.75
- 1416.8334
- 1437.3334
- 1425.1
- 1485.3667
- 1426.4333
- 289.83334
x_label: seconds
y_label: user-minutes
- interval: 3600
name: non-wifi-interference
samples:
degraded:
- 0
- 0
- 0
- 0
- 16.65
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 31.15
- 17.616667
- 17.85
- 0
- 0
- 0
- 0
duration:
- 0
- 0
- 0
- 0
- 16.65
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 31.15
- 17.616667
- 17.85
- 0
- 0
- 0
- 0
total:
- 1302.3
- 1289.0167
- 1396.3167
- 1423.6666
- 1439.2167
- 1414.7
- 1361.0834
- 1371.5834
- 1372.0667
- 1339.1
- 1374.3667
- 1369.9
- 1352.4833
- 1382.8
- 1426.7167
- 1425.6333
- 1403.9333
- 1420.75
- 1416.8334
- 1437.3334
- 1425.1
- 1485.3667
- 1426.4333
- 289.83334
x_label: seconds
y_label: user-minutes
end: 1627312606
sle:
interval: 3600
name: capacity
samples:
degraded:
- 0
- 0
- 210.03334
- 3.1333334
- 16.65
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 5.8
- 102.5
- 139.18333
- 17.616667
- 22.5
- 201.9
- 574.0333
- 183.18333
- 13.266666
total:
- 1302.3
- 1289.0167
- 1396.3167
- 1423.6666
- 1439.2167
- 1414.7
- 1361.0834
- 1371.5834
- 1372.0667
- 1339.1
- 1374.3667
- 1369.9
- 1352.4833
- 1382.8
- 1426.7167
- 1425.6333
- 1403.9333
- 1420.75
- 1416.8334
- 1437.3334
- 1425.1
- 1485.3667
- 1426.4333
- 289.83334
value:
- 0.6764934
- 0.6783766
- 0.641645
- 0.6934629
- 0.68676674
- 0.6834809
- 0.6961604
- 0.6979584
- 0.7033722
- 0.70410794
- 0.7025278
- 0.70305353
- 0.70292175
- 0.7009334
- 0.69344264
- 0.68596864
- 0.5952168
- 0.62183666
- 0.68161446
- 0.65352744
- 0.6183489
- 0.54178274
- 0.6044712
- 0.66845906
x_label: seconds
y_label: '%'
start: 1627226206
contentMediaType: application/vnd.api+json
examples:
Example:
value:
classifiers:
- interval: 3600
name: client-count
samples:
degraded:
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 5.8
- 0
- 0
- 0
- 4.65
- 0
- 7.55
- 47.55
- 13.266666
duration:
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 5.8
- 0
- 0
- 0
- 4.65
- 0
- 7.55
- 47.55
- 13.266666
total:
- 1302.3
- 1289.0167
- 1396.3167
- 1423.6666
- 1439.2167
- 1414.7
- 1361.0834
- 1371.5834
- 1372.0667
- 1339.1
- 1374.3667
- 1369.9
- 1352.4833
- 1382.8
- 1426.7167
- 1425.6333
- 1403.9333
- 1420.75
- 1416.8334
- 1437.3334
- 1425.1
- 1485.3667
- 1426.4333
- 289.83334
x_label: seconds
y_label: user-minutes
- interval: 3600
name: wifi-interference
samples:
degraded:
- 0
- 0
- 210.03334
- 3.1333334
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 102.5
- 108.03333
- 0
- 0
- 201.9
- 566.48334
- 135.63333
- 0
duration:
- 0
- 0
- 210.03334
- 3.1333334
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 102.5
- 108.03333
- 0
- 0
- 201.9
- 566.48334
- 135.63333
- 0
total:
- 1302.3
- 1289.0167
- 1396.3167
- 1423.6666
- 1439.2167
- 1414.7
- 1361.0834
- 1371.5834
- 1372.0667
- 1339.1
- 1374.3667
- 1369.9
- 1352.4833
- 1382.8
- 1426.7167
- 1425.6333
- 1403.9333
- 1420.75
- 1416.8334
- 1437.3334
- 1425.1
- 1485.3667
- 1426.4333
- 289.83334
x_label: seconds
y_label: user-minutes
- interval: 3600
name: client_usage
samples:
degraded:
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
duration:
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
total:
- 1302.3
- 1289.0167
- 1396.3167
- 1423.6666
- 1439.2167
- 1414.7
- 1361.0834
- 1371.5834
- 1372.0667
- 1339.1
- 1374.3667
- 1369.9
- 1352.4833
- 1382.8
- 1426.7167
- 1425.6333
- 1403.9333
- 1420.75
- 1416.8334
- 1437.3334
- 1425.1
- 1485.3667
- 1426.4333
- 289.83334
x_label: seconds
y_label: user-minutes
- interval: 3600
name: non-wifi-interference
samples:
degraded:
- 0
- 0
- 0
- 0
- 16.65
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 31.15
- 17.616667
- 17.85
- 0
- 0
- 0
- 0
duration:
- 0
- 0
- 0
- 0
- 16.65
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 31.15
- 17.616667
- 17.85
- 0
- 0
- 0
- 0
total:
- 1302.3
- 1289.0167
- 1396.3167
- 1423.6666
- 1439.2167
- 1414.7
- 1361.0834
- 1371.5834
- 1372.0667
- 1339.1
- 1374.3667
- 1369.9
- 1352.4833
- 1382.8
- 1426.7167
- 1425.6333
- 1403.9333
- 1420.75
- 1416.8334
- 1437.3334
- 1425.1
- 1485.3667
- 1426.4333
- 289.83334
x_label: seconds
y_label: user-minutes
end: 1627312606
sle:
interval: 3600
name: capacity
samples:
degraded:
- 0
- 0
- 210.03334
- 3.1333334
- 16.65
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 5.8
- 102.5
- 139.18333
- 17.616667
- 22.5
- 201.9
- 574.0333
- 183.18333
- 13.266666
total:
- 1302.3
- 1289.0167
- 1396.3167
- 1423.6666
- 1439.2167
- 1414.7
- 1361.0834
- 1371.5834
- 1372.0667
- 1339.1
- 1374.3667
- 1369.9
- 1352.4833
- 1382.8
- 1426.7167
- 1425.6333
- 1403.9333
- 1420.75
- 1416.8334
- 1437.3334
- 1425.1
- 1485.3667
- 1426.4333
- 289.83334
value:
- 0.6764934
- 0.6783766
- 0.641645
- 0.6934629
- 0.68676674
- 0.6834809
- 0.6961604
- 0.6979584
- 0.7033722
- 0.70410794
- 0.7025278
- 0.70305353
- 0.70292175
- 0.7009334
- 0.69344264
- 0.68596864
- 0.5952168
- 0.62183666
- 0.68161446
- 0.65352744
- 0.6183489
- 0.54178274
- 0.6044712
- 0.66845906
x_label: seconds
y_label: '%'
start: 1627226206
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/sle/{scope}/{scope_id}/metric/{metric}/threshold:
get:
tags:
- Sites SLEs
summary: getSiteSleThreshold
description: Get the SLE threshold
operationId: getSiteSleThreshold
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: scope
in: path
description: ''
required: true
schema:
$ref: '#/components/schemas/site_sle_threshold_scope_parameter'
- name: scope_id
in: path
description: >-
* site_id if `scope`==`site`
* device_id if `scope`==`ap`, `scope`==`switch` or `scope`==`gateway`
* mac if `scope`==`client`
required: true
schema:
type: string
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: metric
in: path
description: Values from `listSiteSlesMetrics`
required: true
schema:
type: string
examples:
- asymmetry-uplink
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sle_threshold'
- description: Threshold metadata and configured value for an SLE metric
examples:
- default: -72
direction: left
maximum: -60
metric: coverage
minimum: -90
threshold: '-66'
units: dBm
contentMediaType: application/json
examples:
Example:
value:
default: -72
direction: left
maximum: -60
metric: coverage
minimum: -90
threshold: '-66'
units: dBm
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/sle_threshold'
- description: Threshold metadata and configured value for an SLE metric
examples:
- default: -72
direction: left
maximum: -60
metric: coverage
minimum: -90
threshold: '-66'
units: dBm
contentMediaType: application/vnd.api+json
examples:
Example:
value:
default: -72
direction: left
maximum: -60
metric: coverage
minimum: -90
threshold: '-66'
units: dBm
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Sites SLEs
summary: replaceSiteSleThreshold
description: Replace the SLE threshold
operationId: replaceSiteSleThreshold
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: scope
in: path
description: ''
required: true
schema:
$ref: '#/components/schemas/site_sle_threshold_scope_parameter'
- name: scope_id
in: path
description: >-
* site_id if `scope`==`site`
* device_id if `scope`==`ap`, `scope`==`switch` or `scope`==`gateway`
* mac if `scope`==`client`
required: true
schema:
type: string
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: metric
in: path
description: Values from `listSiteSlesMetrics`
required: true
schema:
type: string
examples:
- asymmetry-uplink
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sle_threshold'
- examples:
- maximum: -60
minimum: -90
contentMediaType: application/json
examples:
Example:
value:
maximum: -60
minimum: -90
required: false
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sle_threshold'
- description: Threshold metadata and configured value for an SLE metric
examples:
- default: -72
direction: left
maximum: -60
metric: coverage
minimum: -90
threshold: '-66'
units: dBm
contentMediaType: application/json
examples:
Example:
value:
default: -72
direction: left
maximum: -60
metric: coverage
minimum: -90
threshold: '-66'
units: dBm
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/sle_threshold'
- description: Threshold metadata and configured value for an SLE metric
examples:
- default: -72
direction: left
maximum: -60
metric: coverage
minimum: -90
threshold: '-66'
units: dBm
contentMediaType: application/vnd.api+json
examples:
Example:
value:
default: -72
direction: left
maximum: -60
metric: coverage
minimum: -90
threshold: '-66'
units: dBm
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Sites SLEs
summary: updateSiteSleThreshold
description: Update the SLE threshold
operationId: updateSiteSleThreshold
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: scope
in: path
description: ''
required: true
schema:
$ref: '#/components/schemas/site_sle_threshold_scope_parameter'
- name: scope_id
in: path
description: >-
* site_id if `scope`==`site`
* device_id if `scope`==`ap`, `scope`==`switch` or `scope`==`gateway`
* mac if `scope`==`client`
required: true
schema:
type: string
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: metric
in: path
description: Values from `listSiteSlesMetrics`
required: true
schema:
type: string
examples:
- asymmetry-uplink
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sle_threshold'
- examples:
- maximum: -60
minimum: -90
contentMediaType: application/json
examples:
Example:
value:
maximum: -60
minimum: -90
required: false
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sle_threshold'
- description: Threshold metadata and configured value for an SLE metric
examples:
- default: -72
direction: left
maximum: -60
metric: coverage
minimum: -90
threshold: '-66'
units: dBm
contentMediaType: application/json
examples:
Example:
value:
default: -72
direction: left
maximum: -60
metric: coverage
minimum: -90
threshold: '-66'
units: dBm
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/sle_threshold'
- description: Threshold metadata and configured value for an SLE metric
examples:
- default: -72
direction: left
maximum: -60
metric: coverage
minimum: -90
threshold: '-66'
units: dBm
contentMediaType: application/vnd.api+json
examples:
Example:
value:
default: -72
direction: left
maximum: -60
metric: coverage
minimum: -90
threshold: '-66'
units: dBm
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/sle/{scope}/{scope_id}/metrics:
get:
tags:
- Sites SLEs
summary: listSiteSlesMetrics
description: List the metrics for the given scope
operationId: listSiteSlesMetrics
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: scope
in: path
description: ''
required: true
schema:
$ref: '#/components/schemas/site_sle_metrics_scope_parameters'
- name: scope_id
in: path
description: >-
* site_id if `scope`==`site`
* device_id if `scope`==`ap`, `scope`==`switch` or `scope`==`gateway`
* mac if `scope`==`client`
required: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/site_sle_metrics'
- description: SLE metrics available for a site
examples:
- enabled:
- coverage
- capacity
- time-to-connect
- failed-to-connect
- roaming
- roaming-v2
- throughput
- switch_health
- switch_throughput
- switch_stc
- gateway-health
- application_health
- wan-link-health
- ap-availability
supported:
- coverage
- capacity
- time-to-connect
- failed-to-connect
- roaming
- roaming-v2
- location_jitter
- location_latency
- throughput
- location_dropped-requests
- switch_health
- switch_throughput
- switch_stc
- gateway-health
- application_health
- wan-link-health
- ap-availability
- location_sdk-connect-time
- location_ble-hung
contentMediaType: application/json
examples:
Example:
value:
enabled:
- coverage
- capacity
- time-to-connect
- failed-to-connect
- roaming
- roaming-v2
- throughput
- switch_health
- switch_throughput
- switch_stc
- gateway-health
- application_health
- wan-link-health
- ap-availability
supported:
- coverage
- capacity
- time-to-connect
- failed-to-connect
- roaming
- roaming-v2
- location_jitter
- location_latency
- throughput
- location_dropped-requests
- switch_health
- switch_throughput
- switch_stc
- gateway-health
- application_health
- wan-link-health
- ap-availability
- location_sdk-connect-time
- location_ble-hung
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/site_sle_metrics'
- description: SLE metrics available for a site
examples:
- enabled:
- coverage
- capacity
- time-to-connect
- failed-to-connect
- roaming
- roaming-v2
- throughput
- switch_health
- switch_throughput
- switch_stc
- gateway-health
- application_health
- wan-link-health
- ap-availability
supported:
- coverage
- capacity
- time-to-connect
- failed-to-connect
- roaming
- roaming-v2
- location_jitter
- location_latency
- throughput
- location_dropped-requests
- switch_health
- switch_throughput
- switch_stc
- gateway-health
- application_health
- wan-link-health
- ap-availability
- location_sdk-connect-time
- location_ble-hung
contentMediaType: application/vnd.api+json
examples:
Example:
value:
enabled:
- coverage
- capacity
- time-to-connect
- failed-to-connect
- roaming
- roaming-v2
- throughput
- switch_health
- switch_throughput
- switch_stc
- gateway-health
- application_health
- wan-link-health
- ap-availability
supported:
- coverage
- capacity
- time-to-connect
- failed-to-connect
- roaming
- roaming-v2
- location_jitter
- location_latency
- throughput
- location_dropped-requests
- switch_health
- switch_throughput
- switch_stc
- gateway-health
- application_health
- wan-link-health
- ap-availability
- location_sdk-connect-time
- location_ble-hung
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/check_radius_server:
post:
tags:
- Sites Synthetic Tests
summary: startSiteSwitchRadiusSyntheticTest
description: "Ping test from the AP to confirm 'reachability' of the RADIUS server. \n\nUtilize Juniper EX switch(to which an AP is connected to) radius test capabilities to get details on the RADIUS Server 'availability'.\n\n\n\n#### Subscribe to Device Command outputs\n\n`WS /api-ws/v1/stream`\n\n\n```json\n{\n \"subscribe\": \"/sites/{site_id}/devices/{device_id}/cmd\"\n}\n```\n\n#### Example output from ws stream\n\n```json\n{\n \"event\": \"data\",\n \"channel\": \"/sites/d6fb4f96-3ba4-4cf5-8af2-a8d7b85087ac/devices/00000000-0000-0000-1000-2093390b3580/cmd\",\n \"data\": \"{\\\"event\\\": \\\"data\\\", \\\"channel\\\": \\\"/sites/d6fb4f96-3ba4-4cf5-8af2-a8d7b85087ac/devices/2093390b3580/cmd\\\", \\\"data\\\": {\\\"session\\\": \\\"6043daff-884e-48bc-aa9a-810d268aceb1\\\", \\\"raw\\\": \\\" Reason : fail\\\"}}\"\n}\n{\n \"event\": \"data\",\n \"channel\": \"/sites/d6fb4f96-3ba4-4cf5-8af2-a8d7b85087ac/devices/00000000-0000-0000-1000-2093390b3580/cmd\",\n \"data\": \"{\\\"event\\\": \\\"data\\\", \\\"channel\\\": \\\"/sites/d6fb4f96-3ba4-4cf5-8af2-a8d7b85087ac/devices/2093390b3580/cmd\\\", \\\"data\\\": {\\\"session\\\": \\\"6043daff-884e-48bc-aa9a-810d268aceb1\\\", \\\"raw\\\": \\\" Test complete. Exiting\\\"}}\"\n}\n```"
operationId: startSiteSwitchRadiusSyntheticTest
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/synthetictest_radius_server'
- examples:
- password: string
profile: dot1x
user: string
contentMediaType: application/json
examples:
Example:
value:
password: string
profile: dot1x
user: string
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session'
- description: Response containing the WebSocket session handle for asynchronous command output
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session'
- description: Response containing the WebSocket session handle for asynchronous command output
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/synthetic_test:
get:
tags:
- Sites Synthetic Tests
summary: getSiteDeviceSyntheticTest
description: Get Device Synthetic Test
operationId: getSiteDeviceSyntheticTest
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: Synthetic Test Status
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/synthetictest_info'
- description: Synthetic test status or result record
examples:
- device_type: gateway
mac: 5c5b35584a6f
port_id: ge-0/0/1.100
start_time: 1675718807
status: inprogress
type: speedtest
contentMediaType: application/json
examples:
Example:
value:
device_type: gateway
mac: 5c5b35584a6f
port_id: ge-0/0/1.100
start_time: 1675718807
status: inprogress
type: speedtest
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/synthetictest_info'
- description: Synthetic test status or result record
examples:
- device_type: gateway
mac: 5c5b35584a6f
port_id: ge-0/0/1.100
start_time: 1675718807
status: inprogress
type: speedtest
contentMediaType: application/vnd.api+json
examples:
Example:
value:
device_type: gateway
mac: 5c5b35584a6f
port_id: ge-0/0/1.100
start_time: 1675718807
status: inprogress
type: speedtest
'400':
description: Device not online / Device not supported / Already in progress
headers: {}
content: {}
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Sites Synthetic Tests
summary: triggerSiteDeviceSyntheticTest
description: Trigger Device Synthetic Test
operationId: triggerSiteDeviceSyntheticTest
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/synthetictest_device'
required: false
responses:
'200':
description: Scheduled
headers: {}
content: {}
'400':
description: Device not online / Device not supported / Already in progress
headers: {}
content: {}
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/synthetic_test:
post:
tags:
- Sites Synthetic Tests
summary: triggerSiteSyntheticTest
description: Trigger Synthetic Testing
operationId: triggerSiteSyntheticTest
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/synthetictest'
- examples:
- email: test@mist.com
contentMediaType: application/json
examples:
Example:
value:
email: test@mist.com
required: false
responses:
'200':
description: Synthetic Test Started
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_synthetictest'
- description: Result returned after a site synthetic test is queued
examples:
- id: a42775f6-edc8-69b5-f979-542fa1b43ff9
message: Successfully queued synthetic test for the site.
status: string
contentMediaType: application/json
examples:
Example:
value:
id: a42775f6-edc8-69b5-f979-542fa1b43ff9
message: Successfully queued synthetic test for the site.
status: string
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_synthetictest'
- description: Result returned after a site synthetic test is queued
examples:
- id: a42775f6-edc8-69b5-f979-542fa1b43ff9
message: Successfully queued synthetic test for the site.
status: string
contentMediaType: application/vnd.api+json
examples:
Example:
value:
id: a42775f6-edc8-69b5-f979-542fa1b43ff9
message: Successfully queued synthetic test for the site.
status: string
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/synthetic_test/search:
get:
tags:
- Sites Synthetic Tests
summary: searchSiteSyntheticTest
description: Search Site Synthetic Testing
operationId: searchSiteSyntheticTest
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: mac
in: query
description: Filter results by MAC address
style: form
explode: true
schema:
type: string
examples:
- 5c5b350e0410
- name: port_id
in: query
description: Filter results by port identifier
style: form
explode: true
schema:
type: string
examples:
- ge-1/0/1
- name: vlan_id
in: query
description: Filter results by VLAN ID
style: form
explode: true
schema:
type: string
examples:
- '100'
- name: by
in: query
description: Entity who triggers the test
style: form
explode: true
schema:
type: string
examples:
- user
- name: reason
in: query
description: Filter results by reason
style: form
explode: true
schema:
type: string
examples:
- test failed
- name: type
in: query
description: 'Synthetic test type used to filter results. enum: `arp`, `curl`, `dhcp`, `dhcp6`, `dns`, `lan_connectivity`, `radius`, `speedtest`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/synthetictest_type'
- description: 'Synthetic test type used to filter results. enum: `arp`, `curl`, `dhcp`, `dhcp6`, `dns`, `lan_connectivity`, `radius`, `speedtest`'
- name: protocol
in: query
description: 'Connectivity protocol used to filter synthetic test results. enum: `ping`, `traceroute`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/synthetictest_protocol'
- description: 'Connectivity protocol used to filter synthetic test results. enum: `ping`, `traceroute`'
- name: tenant
in: query
description: Filter results by tenant network
style: form
explode: true
schema:
type: string
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: Synthetic Test Search Result
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_synthetictest_search'
- description: Paginated response for site synthetic test search results
examples:
- end: 0
limit: 0
next: string
results:
- by: user
device_type: gateway
failed: false
latency: 40
mac: aff827549235
port_id: ge-0/0/2
rx_mbps: 322
timestamp: 1706824045.059036
tx_mbps: 199
type: speedtest
vlan_id: 20
- by: marvis
device_type: gateway
failed: true
latency: 0
mac: 8396cd006c8c
port_id: ge-0/0/2
reason: interface not ready to perform test
rx_mbps: 0
timestamp: 1706824045.059036
tx_mbps: 0
type: speedtest
vlan_id: 100
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
end: 0
limit: 0
next: string
results:
- by: user
device_type: gateway
failed: false
latency: 40
mac: aff827549235
port_id: ge-0/0/2
rx_mbps: 322
timestamp: 1706824045.059036
tx_mbps: 199
type: speedtest
vlan_id: 20
- by: marvis
device_type: gateway
failed: true
latency: 0
mac: 8396cd006c8c
port_id: ge-0/0/2
reason: interface not ready to perform test
rx_mbps: 0
timestamp: 1706824045.059036
tx_mbps: 0
type: speedtest
vlan_id: 100
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_synthetictest_search'
- description: Paginated response for site synthetic test search results
examples:
- end: 0
limit: 0
next: string
results:
- by: user
device_type: gateway
failed: false
latency: 40
mac: aff827549235
port_id: ge-0/0/2
rx_mbps: 322
timestamp: 1706824045.059036
tx_mbps: 199
type: speedtest
vlan_id: 20
- by: marvis
device_type: gateway
failed: true
latency: 0
mac: 8396cd006c8c
port_id: ge-0/0/2
reason: interface not ready to perform test
rx_mbps: 0
timestamp: 1706824045.059036
tx_mbps: 0
type: speedtest
vlan_id: 100
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 0
limit: 0
next: string
results:
- by: user
device_type: gateway
failed: false
latency: 40
mac: aff827549235
port_id: ge-0/0/2
rx_mbps: 322
timestamp: 1706824045.059036
tx_mbps: 199
type: speedtest
vlan_id: 20
- by: marvis
device_type: gateway
failed: true
latency: 0
mac: 8396cd006c8c
port_id: ge-0/0/2
reason: interface not ready to perform test
rx_mbps: 0
timestamp: 1706824045.059036
tx_mbps: 0
type: speedtest
vlan_id: 100
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/uisettings:
get:
tags:
- Sites UI Settings
summary: listSiteUiSettings
description: List the Site UI settings/databoard
operationId: listSiteUiSettings
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: List of Site UI Setting
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/ui_settings'
description: Site UI settings records returned by a list response
examples:
- - created_time: 1508823803
defaultScopeId: 67970e46-4e12-11e6-9188-0242ad112847
defaultScopeType: site
defaultTimeRange:
end: 1508828400
endDate: 10/23/2017
interval: 1d
name: This Week
shortName: thisWeek
start: 1508655600
usePreset: true
description: Description of the databoard
for_site: true
id: 3bdcc7e8-c04d-4512-b4fc-093da9057eb0
isCustomDataboard: true
isScopeLinked: true
isTimeRangeLinked: true
modified_time: 0
name: New Databoard
org_id: cc079380-5029-4d4a-9125-858de85731ff
purpose: databoard
site_id: 67970e46-4e12-11e6-9188-0242ad112847
tiles:
- chartBand: 2.4 ghz
chartColor: '#00B4AD'
chartDirection: tx + rx
chartRankBy: string
chartType: timeSeries
colspan: 5
column: 1
hideEmptyRows: true
id: 7a9ab38c-cfc3-483d-b51a-0aec571fadc0
metric:
apiName: client_dhcp_latency
name: New Analysis
row: 1
rowspan: 2
scopeId: e0c767834b4c
scopeType: client
timeRange:
end: 1508823743
endDate: 10/23/2017
interval: 1d
name: Past 7 Days
shortName: 7d
start: 1508223600
usePreset: true
trendType: line
vizType: averageTimeSeriesChart
contentMediaType: application/json
examples:
Example:
value:
- created_time: 1508823803
defaultScopeId: 67970e46-4e12-11e6-9188-0242ad112847
defaultScopeType: site
defaultTimeRange:
end: 1508828400
endDate: 10/23/2017
interval: 1d
name: This Week
shortName: thisWeek
start: 1508655600
usePreset: true
description: Description of the databoard
for_site: true
id: 3bdcc7e8-c04d-4512-b4fc-093da9057eb0
isCustomDataboard: true
isScopeLinked: true
isTimeRangeLinked: true
modified_time: 0
name: New Databoard
org_id: cc079380-5029-4d4a-9125-858de85731ff
purpose: databoard
site_id: 67970e46-4e12-11e6-9188-0242ad112847
tiles:
- chartBand: 2.4 ghz
chartColor: '#00B4AD'
chartDirection: tx + rx
chartRankBy: string
chartType: timeSeries
colspan: 5
column: 1
hideEmptyRows: true
id: 7a9ab38c-cfc3-483d-b51a-0aec571fadc0
metric:
apiName: client_dhcp_latency
name: New Analysis
row: 1
rowspan: 2
scopeId: e0c767834b4c
scopeType: client
timeRange:
end: 1508823743
endDate: 10/23/2017
interval: 1d
name: Past 7 Days
shortName: 7d
start: 1508223600
usePreset: true
trendType: line
vizType: averageTimeSeriesChart
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/ui_settings'
description: Site UI settings records returned by a list response
examples:
- - created_time: 1508823803
defaultScopeId: 67970e46-4e12-11e6-9188-0242ad112847
defaultScopeType: site
defaultTimeRange:
end: 1508828400
endDate: 10/23/2017
interval: 1d
name: This Week
shortName: thisWeek
start: 1508655600
usePreset: true
description: Description of the databoard
for_site: true
id: 3bdcc7e8-c04d-4512-b4fc-093da9057eb0
isCustomDataboard: true
isScopeLinked: true
isTimeRangeLinked: true
modified_time: 0
name: New Databoard
org_id: cc079380-5029-4d4a-9125-858de85731ff
purpose: databoard
site_id: 67970e46-4e12-11e6-9188-0242ad112847
tiles:
- chartBand: 2.4 ghz
chartColor: '#00B4AD'
chartDirection: tx + rx
chartRankBy: string
chartType: timeSeries
colspan: 5
column: 1
hideEmptyRows: true
id: 7a9ab38c-cfc3-483d-b51a-0aec571fadc0
metric:
apiName: client_dhcp_latency
name: New Analysis
row: 1
rowspan: 2
scopeId: e0c767834b4c
scopeType: client
timeRange:
end: 1508823743
endDate: 10/23/2017
interval: 1d
name: Past 7 Days
shortName: 7d
start: 1508223600
usePreset: true
trendType: line
vizType: averageTimeSeriesChart
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- created_time: 1508823803
defaultScopeId: 67970e46-4e12-11e6-9188-0242ad112847
defaultScopeType: site
defaultTimeRange:
end: 1508828400
endDate: 10/23/2017
interval: 1d
name: This Week
shortName: thisWeek
start: 1508655600
usePreset: true
description: Description of the databoard
for_site: true
id: 3bdcc7e8-c04d-4512-b4fc-093da9057eb0
isCustomDataboard: true
isScopeLinked: true
isTimeRangeLinked: true
modified_time: 0
name: New Databoard
org_id: cc079380-5029-4d4a-9125-858de85731ff
purpose: databoard
site_id: 67970e46-4e12-11e6-9188-0242ad112847
tiles:
- chartBand: 2.4 ghz
chartColor: '#00B4AD'
chartDirection: tx + rx
chartRankBy: string
chartType: timeSeries
colspan: 5
column: 1
hideEmptyRows: true
id: 7a9ab38c-cfc3-483d-b51a-0aec571fadc0
metric:
apiName: client_dhcp_latency
name: New Analysis
row: 1
rowspan: 2
scopeId: e0c767834b4c
scopeType: client
timeRange:
end: 1508823743
endDate: 10/23/2017
interval: 1d
name: Past 7 Days
shortName: 7d
start: 1508223600
usePreset: true
trendType: line
vizType: averageTimeSeriesChart
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Sites UI Settings
summary: createSiteUiSettings
description: Create a Site UI settings/databoard
operationId: createSiteUiSettings
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ui_settings'
- description: Request Body
examples:
- defaultScopeId: 67970e46-4e12-11e6-9188-0242ad112847
defaultScopeType: site
defaultTimeRange:
end: 1508828400
endDate: 10/23/2017
interval: 1d
name: This Week
shortName: thisWeek
start: 1508655600
usePreset: true
description: Description of the databoard
isCustomDataboard: true
isScopeLinked: true
isTimeRangeLinked: true
name: New Databoard
purpose: databoard
tiles:
- chartBand: 2.4 ghz
chartColor: '#00B4AD'
chartDirection: tx + rx
chartRankBy: string
chartType: timeSeries
colspan: 5
column: 1
hideEmptyRows: true
metric:
apiName: client_dhcp_latency
name: New Analysis
row: 1
rowspan: 2
scopeId: e0c767834b4c
scopeType: client
timeRange:
end: 1508823743
endDate: 10/23/2017
interval: 1d
name: Past 7 Days
shortName: 7d
start: 1508223600
usePreset: true
trendType: line
vizType: averageTimeSeriesChart
contentMediaType: application/json
examples:
Example:
value:
defaultScopeId: 67970e46-4e12-11e6-9188-0242ad112847
defaultScopeType: site
defaultTimeRange:
end: 1508828400
endDate: 10/23/2017
interval: 1d
name: This Week
shortName: thisWeek
start: 1508655600
usePreset: true
description: Description of the databoard
isCustomDataboard: true
isScopeLinked: true
isTimeRangeLinked: true
name: New Databoard
purpose: databoard
tiles:
- chartBand: 2.4 ghz
chartColor: '#00B4AD'
chartDirection: tx + rx
chartRankBy: string
chartType: timeSeries
colspan: 5
column: 1
hideEmptyRows: true
metric:
apiName: client_dhcp_latency
name: New Analysis
row: 1
rowspan: 2
scopeId: e0c767834b4c
scopeType: client
timeRange:
end: 1508823743
endDate: 10/23/2017
interval: 1d
name: Past 7 Days
shortName: 7d
start: 1508223600
usePreset: true
trendType: line
vizType: averageTimeSeriesChart
required: false
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ui_settings'
- description: Site UI settings databoard
examples:
- created_time: 1508823803
defaultScopeId: 67970e46-4e12-11e6-9188-0242ad112847
defaultScopeType: site
defaultTimeRange:
end: 1508828400
endDate: 10/23/2017
interval: 1d
name: This Week
shortName: thisWeek
start: 1508655600
usePreset: true
description: Description of the databoard
for_site: true
id: 3bdcc7e8-c04d-4512-b4fc-093da9057eb0
isCustomDataboard: true
isScopeLinked: true
isTimeRangeLinked: true
modified_time: 0
name: New Databoard
org_id: cc079380-5029-4d4a-9125-858de85731ff
purpose: databoard
site_id: 67970e46-4e12-11e6-9188-0242ad112847
tiles:
- chartBand: 2.4 ghz
chartColor: '#00B4AD'
chartDirection: tx + rx
chartRankBy: string
chartType: timeSeries
colspan: 5
column: 1
hideEmptyRows: true
id: 7a9ab38c-cfc3-483d-b51a-0aec571fadc0
metric:
apiName: client_dhcp_latency
name: New Analysis
row: 1
rowspan: 2
scopeId: e0c767834b4c
scopeType: client
timeRange:
end: 1508823743
endDate: 10/23/2017
interval: 1d
name: Past 7 Days
shortName: 7d
start: 1508223600
usePreset: true
trendType: line
vizType: averageTimeSeriesChart
contentMediaType: application/json
examples:
Example:
value:
created_time: 1508823803
defaultScopeId: 67970e46-4e12-11e6-9188-0242ad112847
defaultScopeType: site
defaultTimeRange:
end: 1508828400
endDate: 10/23/2017
interval: 1d
name: This Week
shortName: thisWeek
start: 1508655600
usePreset: true
description: Description of the databoard
for_site: true
id: 3bdcc7e8-c04d-4512-b4fc-093da9057eb0
isCustomDataboard: true
isScopeLinked: true
isTimeRangeLinked: true
modified_time: 0
name: New Databoard
org_id: cc079380-5029-4d4a-9125-858de85731ff
purpose: databoard
site_id: 67970e46-4e12-11e6-9188-0242ad112847
tiles:
- chartBand: 2.4 ghz
chartColor: '#00B4AD'
chartDirection: tx + rx
chartRankBy: string
chartType: timeSeries
colspan: 5
column: 1
hideEmptyRows: true
id: 7a9ab38c-cfc3-483d-b51a-0aec571fadc0
metric:
apiName: client_dhcp_latency
name: New Analysis
row: 1
rowspan: 2
scopeId: e0c767834b4c
scopeType: client
timeRange:
end: 1508823743
endDate: 10/23/2017
interval: 1d
name: Past 7 Days
shortName: 7d
start: 1508223600
usePreset: true
trendType: line
vizType: averageTimeSeriesChart
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/ui_settings'
- description: Site UI settings databoard
examples:
- created_time: 1508823803
defaultScopeId: 67970e46-4e12-11e6-9188-0242ad112847
defaultScopeType: site
defaultTimeRange:
end: 1508828400
endDate: 10/23/2017
interval: 1d
name: This Week
shortName: thisWeek
start: 1508655600
usePreset: true
description: Description of the databoard
for_site: true
id: 3bdcc7e8-c04d-4512-b4fc-093da9057eb0
isCustomDataboard: true
isScopeLinked: true
isTimeRangeLinked: true
modified_time: 0
name: New Databoard
org_id: cc079380-5029-4d4a-9125-858de85731ff
purpose: databoard
site_id: 67970e46-4e12-11e6-9188-0242ad112847
tiles:
- chartBand: 2.4 ghz
chartColor: '#00B4AD'
chartDirection: tx + rx
chartRankBy: string
chartType: timeSeries
colspan: 5
column: 1
hideEmptyRows: true
id: 7a9ab38c-cfc3-483d-b51a-0aec571fadc0
metric:
apiName: client_dhcp_latency
name: New Analysis
row: 1
rowspan: 2
scopeId: e0c767834b4c
scopeType: client
timeRange:
end: 1508823743
endDate: 10/23/2017
interval: 1d
name: Past 7 Days
shortName: 7d
start: 1508223600
usePreset: true
trendType: line
vizType: averageTimeSeriesChart
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 1508823803
defaultScopeId: 67970e46-4e12-11e6-9188-0242ad112847
defaultScopeType: site
defaultTimeRange:
end: 1508828400
endDate: 10/23/2017
interval: 1d
name: This Week
shortName: thisWeek
start: 1508655600
usePreset: true
description: Description of the databoard
for_site: true
id: 3bdcc7e8-c04d-4512-b4fc-093da9057eb0
isCustomDataboard: true
isScopeLinked: true
isTimeRangeLinked: true
modified_time: 0
name: New Databoard
org_id: cc079380-5029-4d4a-9125-858de85731ff
purpose: databoard
site_id: 67970e46-4e12-11e6-9188-0242ad112847
tiles:
- chartBand: 2.4 ghz
chartColor: '#00B4AD'
chartDirection: tx + rx
chartRankBy: string
chartType: timeSeries
colspan: 5
column: 1
hideEmptyRows: true
id: 7a9ab38c-cfc3-483d-b51a-0aec571fadc0
metric:
apiName: client_dhcp_latency
name: New Analysis
row: 1
rowspan: 2
scopeId: e0c767834b4c
scopeType: client
timeRange:
end: 1508823743
endDate: 10/23/2017
interval: 1d
name: Past 7 Days
shortName: 7d
start: 1508223600
usePreset: true
trendType: line
vizType: averageTimeSeriesChart
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/uisettings/derived:
get:
tags:
- Sites UI Settings
summary: listSiteUiSettingDerived
description: Get both site UI settings(for_site=true) and org UI settings (for_site=false)
operationId: listSiteUiSettingDerived
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ui_settings'
- description: Site UI settings databoard
examples:
- created_time: 1508823803
defaultScopeId: 67970e46-4e12-11e6-9188-0242ad112847
defaultScopeType: site
defaultTimeRange:
end: 1508828400
endDate: 10/23/2017
interval: 1d
name: This Week
shortName: thisWeek
start: 1508655600
usePreset: true
description: Description of the databoard
for_site: true
id: 3bdcc7e8-c04d-4512-b4fc-093da9057eb0
isCustomDataboard: true
isScopeLinked: true
isTimeRangeLinked: true
modified_time: 0
name: New Databoard
org_id: cc079380-5029-4d4a-9125-858de85731ff
purpose: databoard
site_id: 67970e46-4e12-11e6-9188-0242ad112847
tiles:
- chartBand: 2.4 ghz
chartColor: '#00B4AD'
chartDirection: tx + rx
chartRankBy: string
chartType: timeSeries
colspan: 5
column: 1
hideEmptyRows: true
id: 7a9ab38c-cfc3-483d-b51a-0aec571fadc0
metric:
apiName: client_dhcp_latency
name: New Analysis
row: 1
rowspan: 2
scopeId: e0c767834b4c
scopeType: client
timeRange:
end: 1508823743
endDate: 10/23/2017
interval: 1d
name: Past 7 Days
shortName: 7d
start: 1508223600
usePreset: true
trendType: line
vizType: averageTimeSeriesChart
contentMediaType: application/json
examples:
Example:
value:
created_time: 1508823803
defaultScopeId: 67970e46-4e12-11e6-9188-0242ad112847
defaultScopeType: site
defaultTimeRange:
end: 1508828400
endDate: 10/23/2017
interval: 1d
name: This Week
shortName: thisWeek
start: 1508655600
usePreset: true
description: Description of the databoard
for_site: true
id: 3bdcc7e8-c04d-4512-b4fc-093da9057eb0
isCustomDataboard: true
isScopeLinked: true
isTimeRangeLinked: true
modified_time: 0
name: New Databoard
org_id: cc079380-5029-4d4a-9125-858de85731ff
purpose: databoard
site_id: 67970e46-4e12-11e6-9188-0242ad112847
tiles:
- chartBand: 2.4 ghz
chartColor: '#00B4AD'
chartDirection: tx + rx
chartRankBy: string
chartType: timeSeries
colspan: 5
column: 1
hideEmptyRows: true
id: 7a9ab38c-cfc3-483d-b51a-0aec571fadc0
metric:
apiName: client_dhcp_latency
name: New Analysis
row: 1
rowspan: 2
scopeId: e0c767834b4c
scopeType: client
timeRange:
end: 1508823743
endDate: 10/23/2017
interval: 1d
name: Past 7 Days
shortName: 7d
start: 1508223600
usePreset: true
trendType: line
vizType: averageTimeSeriesChart
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/ui_settings'
- description: Site UI settings databoard
examples:
- created_time: 1508823803
defaultScopeId: 67970e46-4e12-11e6-9188-0242ad112847
defaultScopeType: site
defaultTimeRange:
end: 1508828400
endDate: 10/23/2017
interval: 1d
name: This Week
shortName: thisWeek
start: 1508655600
usePreset: true
description: Description of the databoard
for_site: true
id: 3bdcc7e8-c04d-4512-b4fc-093da9057eb0
isCustomDataboard: true
isScopeLinked: true
isTimeRangeLinked: true
modified_time: 0
name: New Databoard
org_id: cc079380-5029-4d4a-9125-858de85731ff
purpose: databoard
site_id: 67970e46-4e12-11e6-9188-0242ad112847
tiles:
- chartBand: 2.4 ghz
chartColor: '#00B4AD'
chartDirection: tx + rx
chartRankBy: string
chartType: timeSeries
colspan: 5
column: 1
hideEmptyRows: true
id: 7a9ab38c-cfc3-483d-b51a-0aec571fadc0
metric:
apiName: client_dhcp_latency
name: New Analysis
row: 1
rowspan: 2
scopeId: e0c767834b4c
scopeType: client
timeRange:
end: 1508823743
endDate: 10/23/2017
interval: 1d
name: Past 7 Days
shortName: 7d
start: 1508223600
usePreset: true
trendType: line
vizType: averageTimeSeriesChart
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 1508823803
defaultScopeId: 67970e46-4e12-11e6-9188-0242ad112847
defaultScopeType: site
defaultTimeRange:
end: 1508828400
endDate: 10/23/2017
interval: 1d
name: This Week
shortName: thisWeek
start: 1508655600
usePreset: true
description: Description of the databoard
for_site: true
id: 3bdcc7e8-c04d-4512-b4fc-093da9057eb0
isCustomDataboard: true
isScopeLinked: true
isTimeRangeLinked: true
modified_time: 0
name: New Databoard
org_id: cc079380-5029-4d4a-9125-858de85731ff
purpose: databoard
site_id: 67970e46-4e12-11e6-9188-0242ad112847
tiles:
- chartBand: 2.4 ghz
chartColor: '#00B4AD'
chartDirection: tx + rx
chartRankBy: string
chartType: timeSeries
colspan: 5
column: 1
hideEmptyRows: true
id: 7a9ab38c-cfc3-483d-b51a-0aec571fadc0
metric:
apiName: client_dhcp_latency
name: New Analysis
row: 1
rowspan: 2
scopeId: e0c767834b4c
scopeType: client
timeRange:
end: 1508823743
endDate: 10/23/2017
interval: 1d
name: Past 7 Days
shortName: 7d
start: 1508223600
usePreset: true
trendType: line
vizType: averageTimeSeriesChart
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/uisettings/{uisetting_id}:
delete:
tags:
- Sites UI Settings
summary: deleteSiteUiSetting
description: Site UI settings
operationId: deleteSiteUiSetting
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: uisetting_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Sites UI Settings
summary: getSiteUiSetting
description: Site UI settings
operationId: getSiteUiSetting
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: uisetting_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ui_settings'
- description: Site UI settings databoard
examples:
- created_time: 1508823803
defaultScopeId: 67970e46-4e12-11e6-9188-0242ad112847
defaultScopeType: site
defaultTimeRange:
end: 1508828400
endDate: 10/23/2017
interval: 1d
name: This Week
shortName: thisWeek
start: 1508655600
usePreset: true
description: Description of the databoard
for_site: true
id: 3bdcc7e8-c04d-4512-b4fc-093da9057eb0
isCustomDataboard: true
isScopeLinked: true
isTimeRangeLinked: true
modified_time: 0
name: New Databoard
org_id: cc079380-5029-4d4a-9125-858de85731ff
purpose: databoard
site_id: 67970e46-4e12-11e6-9188-0242ad112847
tiles:
- chartBand: 2.4 ghz
chartColor: '#00B4AD'
chartDirection: tx + rx
chartRankBy: string
chartType: timeSeries
colspan: 5
column: 1
hideEmptyRows: true
id: 7a9ab38c-cfc3-483d-b51a-0aec571fadc0
metric:
apiName: client_dhcp_latency
name: New Analysis
row: 1
rowspan: 2
scopeId: e0c767834b4c
scopeType: client
timeRange:
end: 1508823743
endDate: 10/23/2017
interval: 1d
name: Past 7 Days
shortName: 7d
start: 1508223600
usePreset: true
trendType: line
vizType: averageTimeSeriesChart
contentMediaType: application/json
examples:
Example:
value:
created_time: 1508823803
defaultScopeId: 67970e46-4e12-11e6-9188-0242ad112847
defaultScopeType: site
defaultTimeRange:
end: 1508828400
endDate: 10/23/2017
interval: 1d
name: This Week
shortName: thisWeek
start: 1508655600
usePreset: true
description: Description of the databoard
for_site: true
id: 3bdcc7e8-c04d-4512-b4fc-093da9057eb0
isCustomDataboard: true
isScopeLinked: true
isTimeRangeLinked: true
modified_time: 0
name: New Databoard
org_id: cc079380-5029-4d4a-9125-858de85731ff
purpose: databoard
site_id: 67970e46-4e12-11e6-9188-0242ad112847
tiles:
- chartBand: 2.4 ghz
chartColor: '#00B4AD'
chartDirection: tx + rx
chartRankBy: string
chartType: timeSeries
colspan: 5
column: 1
hideEmptyRows: true
id: 7a9ab38c-cfc3-483d-b51a-0aec571fadc0
metric:
apiName: client_dhcp_latency
name: New Analysis
row: 1
rowspan: 2
scopeId: e0c767834b4c
scopeType: client
timeRange:
end: 1508823743
endDate: 10/23/2017
interval: 1d
name: Past 7 Days
shortName: 7d
start: 1508223600
usePreset: true
trendType: line
vizType: averageTimeSeriesChart
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/ui_settings'
- description: Site UI settings databoard
examples:
- created_time: 1508823803
defaultScopeId: 67970e46-4e12-11e6-9188-0242ad112847
defaultScopeType: site
defaultTimeRange:
end: 1508828400
endDate: 10/23/2017
interval: 1d
name: This Week
shortName: thisWeek
start: 1508655600
usePreset: true
description: Description of the databoard
for_site: true
id: 3bdcc7e8-c04d-4512-b4fc-093da9057eb0
isCustomDataboard: true
isScopeLinked: true
isTimeRangeLinked: true
modified_time: 0
name: New Databoard
org_id: cc079380-5029-4d4a-9125-858de85731ff
purpose: databoard
site_id: 67970e46-4e12-11e6-9188-0242ad112847
tiles:
- chartBand: 2.4 ghz
chartColor: '#00B4AD'
chartDirection: tx + rx
chartRankBy: string
chartType: timeSeries
colspan: 5
column: 1
hideEmptyRows: true
id: 7a9ab38c-cfc3-483d-b51a-0aec571fadc0
metric:
apiName: client_dhcp_latency
name: New Analysis
row: 1
rowspan: 2
scopeId: e0c767834b4c
scopeType: client
timeRange:
end: 1508823743
endDate: 10/23/2017
interval: 1d
name: Past 7 Days
shortName: 7d
start: 1508223600
usePreset: true
trendType: line
vizType: averageTimeSeriesChart
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 1508823803
defaultScopeId: 67970e46-4e12-11e6-9188-0242ad112847
defaultScopeType: site
defaultTimeRange:
end: 1508828400
endDate: 10/23/2017
interval: 1d
name: This Week
shortName: thisWeek
start: 1508655600
usePreset: true
description: Description of the databoard
for_site: true
id: 3bdcc7e8-c04d-4512-b4fc-093da9057eb0
isCustomDataboard: true
isScopeLinked: true
isTimeRangeLinked: true
modified_time: 0
name: New Databoard
org_id: cc079380-5029-4d4a-9125-858de85731ff
purpose: databoard
site_id: 67970e46-4e12-11e6-9188-0242ad112847
tiles:
- chartBand: 2.4 ghz
chartColor: '#00B4AD'
chartDirection: tx + rx
chartRankBy: string
chartType: timeSeries
colspan: 5
column: 1
hideEmptyRows: true
id: 7a9ab38c-cfc3-483d-b51a-0aec571fadc0
metric:
apiName: client_dhcp_latency
name: New Analysis
row: 1
rowspan: 2
scopeId: e0c767834b4c
scopeType: client
timeRange:
end: 1508823743
endDate: 10/23/2017
interval: 1d
name: Past 7 Days
shortName: 7d
start: 1508223600
usePreset: true
trendType: line
vizType: averageTimeSeriesChart
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Sites UI Settings
summary: updateSiteUiSetting
description: Site UI settings
operationId: updateSiteUiSetting
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: uisetting_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ui_settings'
- description: Request Body
examples:
- defaultScopeId: 67970e46-4e12-11e6-9188-0242ad112847
defaultScopeType: site
defaultTimeRange:
end: 1508828400
endDate: 10/23/2017
interval: 1d
name: This Week
shortName: thisWeek
start: 1508655600
usePreset: true
description: Description of the databoard
isCustomDataboard: true
isScopeLinked: true
isTimeRangeLinked: true
name: New Databoard
purpose: databoard
tiles:
- chartBand: 2.4 ghz
chartColor: '#00B4AD'
chartDirection: tx + rx
chartRankBy: string
chartType: timeSeries
colspan: 5
column: 1
hideEmptyRows: true
metric:
apiName: client_dhcp_latency
name: New Analysis
row: 1
rowspan: 2
scopeId: e0c767834b4c
scopeType: client
timeRange:
end: 1508823743
endDate: 10/23/2017
interval: 1d
name: Past 7 Days
shortName: 7d
start: 1508223600
usePreset: true
trendType: line
vizType: averageTimeSeriesChart
contentMediaType: application/json
examples:
Example:
value:
defaultScopeId: 67970e46-4e12-11e6-9188-0242ad112847
defaultScopeType: site
defaultTimeRange:
end: 1508828400
endDate: 10/23/2017
interval: 1d
name: This Week
shortName: thisWeek
start: 1508655600
usePreset: true
description: Description of the databoard
isCustomDataboard: true
isScopeLinked: true
isTimeRangeLinked: true
name: New Databoard
purpose: databoard
tiles:
- chartBand: 2.4 ghz
chartColor: '#00B4AD'
chartDirection: tx + rx
chartRankBy: string
chartType: timeSeries
colspan: 5
column: 1
hideEmptyRows: true
metric:
apiName: client_dhcp_latency
name: New Analysis
row: 1
rowspan: 2
scopeId: e0c767834b4c
scopeType: client
timeRange:
end: 1508823743
endDate: 10/23/2017
interval: 1d
name: Past 7 Days
shortName: 7d
start: 1508223600
usePreset: true
trendType: line
vizType: averageTimeSeriesChart
required: false
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ui_settings'
- description: Site UI settings databoard
examples:
- created_time: 1508823803
defaultScopeId: 67970e46-4e12-11e6-9188-0242ad112847
defaultScopeType: site
defaultTimeRange:
end: 1508828400
endDate: 10/23/2017
interval: 1d
name: This Week
shortName: thisWeek
start: 1508655600
usePreset: true
description: Description of the databoard
for_site: true
id: 3bdcc7e8-c04d-4512-b4fc-093da9057eb0
isCustomDataboard: true
isScopeLinked: true
isTimeRangeLinked: true
modified_time: 0
name: New Databoard
org_id: cc079380-5029-4d4a-9125-858de85731ff
purpose: databoard
site_id: 67970e46-4e12-11e6-9188-0242ad112847
tiles:
- chartBand: 2.4 ghz
chartColor: '#00B4AD'
chartDirection: tx + rx
chartRankBy: string
chartType: timeSeries
colspan: 5
column: 1
hideEmptyRows: true
id: 7a9ab38c-cfc3-483d-b51a-0aec571fadc0
metric:
apiName: client_dhcp_latency
name: New Analysis
row: 1
rowspan: 2
scopeId: e0c767834b4c
scopeType: client
timeRange:
end: 1508823743
endDate: 10/23/2017
interval: 1d
name: Past 7 Days
shortName: 7d
start: 1508223600
usePreset: true
trendType: line
vizType: averageTimeSeriesChart
contentMediaType: application/json
examples:
Example:
value:
created_time: 1508823803
defaultScopeId: 67970e46-4e12-11e6-9188-0242ad112847
defaultScopeType: site
defaultTimeRange:
end: 1508828400
endDate: 10/23/2017
interval: 1d
name: This Week
shortName: thisWeek
start: 1508655600
usePreset: true
description: Description of the databoard
for_site: true
id: 3bdcc7e8-c04d-4512-b4fc-093da9057eb0
isCustomDataboard: true
isScopeLinked: true
isTimeRangeLinked: true
modified_time: 0
name: New Databoard
org_id: cc079380-5029-4d4a-9125-858de85731ff
purpose: databoard
site_id: 67970e46-4e12-11e6-9188-0242ad112847
tiles:
- chartBand: 2.4 ghz
chartColor: '#00B4AD'
chartDirection: tx + rx
chartRankBy: string
chartType: timeSeries
colspan: 5
column: 1
hideEmptyRows: true
id: 7a9ab38c-cfc3-483d-b51a-0aec571fadc0
metric:
apiName: client_dhcp_latency
name: New Analysis
row: 1
rowspan: 2
scopeId: e0c767834b4c
scopeType: client
timeRange:
end: 1508823743
endDate: 10/23/2017
interval: 1d
name: Past 7 Days
shortName: 7d
start: 1508223600
usePreset: true
trendType: line
vizType: averageTimeSeriesChart
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/ui_settings'
- description: Site UI settings databoard
examples:
- created_time: 1508823803
defaultScopeId: 67970e46-4e12-11e6-9188-0242ad112847
defaultScopeType: site
defaultTimeRange:
end: 1508828400
endDate: 10/23/2017
interval: 1d
name: This Week
shortName: thisWeek
start: 1508655600
usePreset: true
description: Description of the databoard
for_site: true
id: 3bdcc7e8-c04d-4512-b4fc-093da9057eb0
isCustomDataboard: true
isScopeLinked: true
isTimeRangeLinked: true
modified_time: 0
name: New Databoard
org_id: cc079380-5029-4d4a-9125-858de85731ff
purpose: databoard
site_id: 67970e46-4e12-11e6-9188-0242ad112847
tiles:
- chartBand: 2.4 ghz
chartColor: '#00B4AD'
chartDirection: tx + rx
chartRankBy: string
chartType: timeSeries
colspan: 5
column: 1
hideEmptyRows: true
id: 7a9ab38c-cfc3-483d-b51a-0aec571fadc0
metric:
apiName: client_dhcp_latency
name: New Analysis
row: 1
rowspan: 2
scopeId: e0c767834b4c
scopeType: client
timeRange:
end: 1508823743
endDate: 10/23/2017
interval: 1d
name: Past 7 Days
shortName: 7d
start: 1508223600
usePreset: true
trendType: line
vizType: averageTimeSeriesChart
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 1508823803
defaultScopeId: 67970e46-4e12-11e6-9188-0242ad112847
defaultScopeType: site
defaultTimeRange:
end: 1508828400
endDate: 10/23/2017
interval: 1d
name: This Week
shortName: thisWeek
start: 1508655600
usePreset: true
description: Description of the databoard
for_site: true
id: 3bdcc7e8-c04d-4512-b4fc-093da9057eb0
isCustomDataboard: true
isScopeLinked: true
isTimeRangeLinked: true
modified_time: 0
name: New Databoard
org_id: cc079380-5029-4d4a-9125-858de85731ff
purpose: databoard
site_id: 67970e46-4e12-11e6-9188-0242ad112847
tiles:
- chartBand: 2.4 ghz
chartColor: '#00B4AD'
chartDirection: tx + rx
chartRankBy: string
chartType: timeSeries
colspan: 5
column: 1
hideEmptyRows: true
id: 7a9ab38c-cfc3-483d-b51a-0aec571fadc0
metric:
apiName: client_dhcp_latency
name: New Analysis
row: 1
rowspan: 2
scopeId: e0c767834b4c
scopeType: client
timeRange:
end: 1508823743
endDate: 10/23/2017
interval: 1d
name: Past 7 Days
shortName: 7d
start: 1508223600
usePreset: true
trendType: line
vizType: averageTimeSeriesChart
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/uisettings:
get:
tags:
- Orgs UI Settings
summary: listOrgUiSettings
description: List the Orgs UI settings/databoard
operationId: listOrgUiSettings
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: List of Org UI Setting
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/org_ui_settings'
description: List of organization UI databoards
examples:
- - created_time: 1749083436
description: AP related stats
for_site: false
id: 9a702097-0dd3-48af-909b-2be4ff94d139
isCustomDataboard: true
modified_time: 1749083436
name: AP Stats
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
purpose: marvisdashboard
site_id: 00000000-0000-0000-0000-000000000000
tiles:
- description: User typed tile descr
id: 3eef7c83-3d33-417a-a729-4772d4a1013a
isAutoTitle: true
name: List top 10 APs by bandwidth
nl_query: List top 10 APs by bandwidth
position:
col: 1
colSpan: 2
row: 1
rowSpan: 1
contentMediaType: application/json
examples:
Example:
value:
- created_time: 1749083436
description: AP related stats
for_site: false
id: 9a702097-0dd3-48af-909b-2be4ff94d139
isCustomDataboard: true
modified_time: 1749083436
name: AP Stats
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
purpose: marvisdashboard
site_id: 00000000-0000-0000-0000-000000000000
tiles:
- description: User typed tile descr
id: 3eef7c83-3d33-417a-a729-4772d4a1013a
isAutoTitle: true
name: List top 10 APs by bandwidth
nl_query: List top 10 APs by bandwidth
position:
col: 1
colSpan: 2
row: 1
rowSpan: 1
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/org_ui_settings'
description: List of organization UI databoards
examples:
- - created_time: 1749083436
description: AP related stats
for_site: false
id: 9a702097-0dd3-48af-909b-2be4ff94d139
isCustomDataboard: true
modified_time: 1749083436
name: AP Stats
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
purpose: marvisdashboard
site_id: 00000000-0000-0000-0000-000000000000
tiles:
- description: User typed tile descr
id: 3eef7c83-3d33-417a-a729-4772d4a1013a
isAutoTitle: true
name: List top 10 APs by bandwidth
nl_query: List top 10 APs by bandwidth
position:
col: 1
colSpan: 2
row: 1
rowSpan: 1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- created_time: 1749083436
description: AP related stats
for_site: false
id: 9a702097-0dd3-48af-909b-2be4ff94d139
isCustomDataboard: true
modified_time: 1749083436
name: AP Stats
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
purpose: marvisdashboard
site_id: 00000000-0000-0000-0000-000000000000
tiles:
- description: User typed tile descr
id: 3eef7c83-3d33-417a-a729-4772d4a1013a
isAutoTitle: true
name: List top 10 APs by bandwidth
nl_query: List top 10 APs by bandwidth
position:
col: 1
colSpan: 2
row: 1
rowSpan: 1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs UI Settings
summary: createOrgUiSettings
description: Create an Org UI settings/databoard
operationId: createOrgUiSettings
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/org_ui_settings'
- description: Request Body
examples:
- description: AP related stats
isCustomDataboard: true
name: AP Stats
purpose: marvisdashboard
tiles:
- description: User typed tile descr
isAutoTitle: true
name: List top 10 APs by bandwidth
nl_query: List top 10 APs by bandwidth
position:
col: 1
colSpan: 2
row: 1
rowSpan: 1
contentMediaType: application/json
examples:
Example:
value:
description: AP related stats
isCustomDataboard: true
name: AP Stats
purpose: marvisdashboard
tiles:
- description: User typed tile descr
isAutoTitle: true
name: List top 10 APs by bandwidth
nl_query: List top 10 APs by bandwidth
position:
col: 1
colSpan: 2
row: 1
rowSpan: 1
required: false
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/org_ui_settings'
- description: Organization UI settings databoard
examples:
- created_time: 1749083436
description: AP related stats
for_site: false
id: 9a702097-0dd3-48af-909b-2be4ff94d139
isCustomDataboard: true
modified_time: 1749083436
name: AP Stats
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
purpose: marvisdashboard
site_id: 00000000-0000-0000-0000-000000000000
tiles:
- description: User typed tile descr
id: 3eef7c83-3d33-417a-a729-4772d4a1013a
isAutoTitle: true
name: List top 10 APs by bandwidth
nl_query: List top 10 APs by bandwidth
position:
col: 1
colSpan: 2
row: 1
rowSpan: 1
contentMediaType: application/json
examples:
Example:
value:
created_time: 1749083436
description: AP related stats
for_site: false
id: 9a702097-0dd3-48af-909b-2be4ff94d139
isCustomDataboard: true
modified_time: 1749083436
name: AP Stats
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
purpose: marvisdashboard
site_id: 00000000-0000-0000-0000-000000000000
tiles:
- description: User typed tile descr
id: 3eef7c83-3d33-417a-a729-4772d4a1013a
isAutoTitle: true
name: List top 10 APs by bandwidth
nl_query: List top 10 APs by bandwidth
position:
col: 1
colSpan: 2
row: 1
rowSpan: 1
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/org_ui_settings'
- description: Organization UI settings databoard
examples:
- created_time: 1749083436
description: AP related stats
for_site: false
id: 9a702097-0dd3-48af-909b-2be4ff94d139
isCustomDataboard: true
modified_time: 1749083436
name: AP Stats
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
purpose: marvisdashboard
site_id: 00000000-0000-0000-0000-000000000000
tiles:
- description: User typed tile descr
id: 3eef7c83-3d33-417a-a729-4772d4a1013a
isAutoTitle: true
name: List top 10 APs by bandwidth
nl_query: List top 10 APs by bandwidth
position:
col: 1
colSpan: 2
row: 1
rowSpan: 1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 1749083436
description: AP related stats
for_site: false
id: 9a702097-0dd3-48af-909b-2be4ff94d139
isCustomDataboard: true
modified_time: 1749083436
name: AP Stats
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
purpose: marvisdashboard
site_id: 00000000-0000-0000-0000-000000000000
tiles:
- description: User typed tile descr
id: 3eef7c83-3d33-417a-a729-4772d4a1013a
isAutoTitle: true
name: List top 10 APs by bandwidth
nl_query: List top 10 APs by bandwidth
position:
col: 1
colSpan: 2
row: 1
rowSpan: 1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/uisettings/{uisetting_id}:
delete:
tags:
- Orgs UI Settings
summary: deleteOrgUiSetting
description: Delete an Org UI settings
operationId: deleteOrgUiSetting
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: uisetting_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Orgs UI Settings
summary: getOrgUiSetting
description: Get an Org UI settings/databoard
operationId: getOrgUiSetting
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: uisetting_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/org_ui_settings'
- description: Organization UI settings databoard
examples:
- created_time: 1749083436
description: AP related stats
for_site: false
id: 9a702097-0dd3-48af-909b-2be4ff94d139
isCustomDataboard: true
modified_time: 1749083436
name: AP Stats
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
purpose: marvisdashboard
site_id: 00000000-0000-0000-0000-000000000000
tiles:
- description: User typed tile descr
id: 3eef7c83-3d33-417a-a729-4772d4a1013a
isAutoTitle: true
name: List top 10 APs by bandwidth
nl_query: List top 10 APs by bandwidth
position:
col: 1
colSpan: 2
row: 1
rowSpan: 1
contentMediaType: application/json
examples:
Example:
value:
created_time: 1749083436
description: AP related stats
for_site: false
id: 9a702097-0dd3-48af-909b-2be4ff94d139
isCustomDataboard: true
modified_time: 1749083436
name: AP Stats
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
purpose: marvisdashboard
site_id: 00000000-0000-0000-0000-000000000000
tiles:
- description: User typed tile descr
id: 3eef7c83-3d33-417a-a729-4772d4a1013a
isAutoTitle: true
name: List top 10 APs by bandwidth
nl_query: List top 10 APs by bandwidth
position:
col: 1
colSpan: 2
row: 1
rowSpan: 1
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/org_ui_settings'
- description: Organization UI settings databoard
examples:
- created_time: 1749083436
description: AP related stats
for_site: false
id: 9a702097-0dd3-48af-909b-2be4ff94d139
isCustomDataboard: true
modified_time: 1749083436
name: AP Stats
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
purpose: marvisdashboard
site_id: 00000000-0000-0000-0000-000000000000
tiles:
- description: User typed tile descr
id: 3eef7c83-3d33-417a-a729-4772d4a1013a
isAutoTitle: true
name: List top 10 APs by bandwidth
nl_query: List top 10 APs by bandwidth
position:
col: 1
colSpan: 2
row: 1
rowSpan: 1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 1749083436
description: AP related stats
for_site: false
id: 9a702097-0dd3-48af-909b-2be4ff94d139
isCustomDataboard: true
modified_time: 1749083436
name: AP Stats
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
purpose: marvisdashboard
site_id: 00000000-0000-0000-0000-000000000000
tiles:
- description: User typed tile descr
id: 3eef7c83-3d33-417a-a729-4772d4a1013a
isAutoTitle: true
name: List top 10 APs by bandwidth
nl_query: List top 10 APs by bandwidth
position:
col: 1
colSpan: 2
row: 1
rowSpan: 1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Orgs UI Settings
summary: updateOrgUiSetting
description: Org UI settings/databoard
operationId: updateOrgUiSetting
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: uisetting_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/org_ui_settings'
- description: Request Body
examples:
- description: AP related stats
isCustomDataboard: true
name: AP Stats
purpose: marvisdashboard
tiles:
- description: User typed tile descr
isAutoTitle: true
name: List top 10 APs by bandwidth
nl_query: List top 10 APs by bandwidth
position:
col: 1
colSpan: 2
row: 1
rowSpan: 1
contentMediaType: application/json
examples:
Example:
value:
description: AP related stats
isCustomDataboard: true
name: AP Stats
purpose: marvisdashboard
tiles:
- description: User typed tile descr
isAutoTitle: true
name: List top 10 APs by bandwidth
nl_query: List top 10 APs by bandwidth
position:
col: 1
colSpan: 2
row: 1
rowSpan: 1
required: false
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/org_ui_settings'
- description: Organization UI settings databoard
examples:
- created_time: 1749083436
description: AP related stats
for_site: false
id: 9a702097-0dd3-48af-909b-2be4ff94d139
isCustomDataboard: true
modified_time: 1749083436
name: AP Stats
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
purpose: marvisdashboard
site_id: 00000000-0000-0000-0000-000000000000
tiles:
- description: User typed tile descr
id: 3eef7c83-3d33-417a-a729-4772d4a1013a
isAutoTitle: true
name: List top 10 APs by bandwidth
nl_query: List top 10 APs by bandwidth
position:
col: 1
colSpan: 2
row: 1
rowSpan: 1
contentMediaType: application/json
examples:
Example:
value:
created_time: 1749083436
description: AP related stats
for_site: false
id: 9a702097-0dd3-48af-909b-2be4ff94d139
isCustomDataboard: true
modified_time: 1749083436
name: AP Stats
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
purpose: marvisdashboard
site_id: 00000000-0000-0000-0000-000000000000
tiles:
- description: User typed tile descr
id: 3eef7c83-3d33-417a-a729-4772d4a1013a
isAutoTitle: true
name: List top 10 APs by bandwidth
nl_query: List top 10 APs by bandwidth
position:
col: 1
colSpan: 2
row: 1
rowSpan: 1
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/org_ui_settings'
- description: Organization UI settings databoard
examples:
- created_time: 1749083436
description: AP related stats
for_site: false
id: 9a702097-0dd3-48af-909b-2be4ff94d139
isCustomDataboard: true
modified_time: 1749083436
name: AP Stats
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
purpose: marvisdashboard
site_id: 00000000-0000-0000-0000-000000000000
tiles:
- description: User typed tile descr
id: 3eef7c83-3d33-417a-a729-4772d4a1013a
isAutoTitle: true
name: List top 10 APs by bandwidth
nl_query: List top 10 APs by bandwidth
position:
col: 1
colSpan: 2
row: 1
rowSpan: 1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 1749083436
description: AP related stats
for_site: false
id: 9a702097-0dd3-48af-909b-2be4ff94d139
isCustomDataboard: true
modified_time: 1749083436
name: AP Stats
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
purpose: marvisdashboard
site_id: 00000000-0000-0000-0000-000000000000
tiles:
- description: User typed tile descr
id: 3eef7c83-3d33-417a-a729-4772d4a1013a
isAutoTitle: true
name: List top 10 APs by bandwidth
nl_query: List top 10 APs by bandwidth
position:
col: 1
colSpan: 2
row: 1
rowSpan: 1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/vbeacons:
get:
tags:
- Sites vBeacons
summary: listSiteVBeacons
description: Get List of Site Virtual Beacons
operationId: listSiteVBeacons
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/vbeacon'
description: Virtual beacon records returned by a list response
examples:
- - created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
major: 0
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
message: string
minor: 0
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
power: 4
power_mode: default
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
url: string
uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
wayfinding_nodename: string
x: 0
y: 0
contentMediaType: application/json
examples:
Example:
value:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
major: 0
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
message: string
minor: 0
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
power: 4
power_mode: default
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
url: string
uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
wayfinding_nodename: string
x: 0
y: 0
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/vbeacon'
description: Virtual beacon records returned by a list response
examples:
- - created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
major: 0
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
message: string
minor: 0
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
power: 4
power_mode: default
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
url: string
uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
wayfinding_nodename: string
x: 0
y: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
major: 0
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
message: string
minor: 0
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
power: 4
power_mode: default
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
url: string
uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
wayfinding_nodename: string
x: 0
y: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Sites vBeacons
summary: createSiteVBeacon
description: Create Virtual Beacon
operationId: createSiteVBeacon
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/vbeacon'
- description: Request Body
examples:
- major: 0
message: string
minor: 0
name: string
power: 4
power_mode: default
url: string
uuid: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
wayfinding_nodename: string
x: 0
y: 0
contentMediaType: application/json
examples:
Example:
value:
major: 0
message: string
minor: 0
name: string
power: 4
power_mode: default
url: string
uuid: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
wayfinding_nodename: string
x: 0
y: 0
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/vbeacon'
- description: Virtual beacon configuration for SDK proximity notifications
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
major: 0
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
message: string
minor: 0
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
power: 4
power_mode: default
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
url: string
uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
wayfinding_nodename: string
x: 0
y: 0
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
major: 0
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
message: string
minor: 0
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
power: 4
power_mode: default
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
url: string
uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
wayfinding_nodename: string
x: 0
y: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/vbeacon'
- description: Virtual beacon configuration for SDK proximity notifications
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
major: 0
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
message: string
minor: 0
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
power: 4
power_mode: default
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
url: string
uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
wayfinding_nodename: string
x: 0
y: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
major: 0
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
message: string
minor: 0
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
power: 4
power_mode: default
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
url: string
uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
wayfinding_nodename: string
x: 0
y: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/vbeacons/{vbeacon_id}:
delete:
tags:
- Sites vBeacons
summary: deleteSiteVBeacon
description: Delete Site Virtual Beacon
operationId: deleteSiteVBeacon
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: vbeacon_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Sites vBeacons
summary: getSiteVBeacon
description: Get Site Virtual Beacon Details
operationId: getSiteVBeacon
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: vbeacon_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/vbeacon'
- description: Virtual beacon configuration for SDK proximity notifications
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
major: 0
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
message: string
minor: 0
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
power: 4
power_mode: default
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
url: string
uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
wayfinding_nodename: string
x: 0
y: 0
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
major: 0
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
message: string
minor: 0
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
power: 4
power_mode: default
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
url: string
uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
wayfinding_nodename: string
x: 0
y: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/vbeacon'
- description: Virtual beacon configuration for SDK proximity notifications
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
major: 0
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
message: string
minor: 0
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
power: 4
power_mode: default
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
url: string
uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
wayfinding_nodename: string
x: 0
y: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
major: 0
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
message: string
minor: 0
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
power: 4
power_mode: default
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
url: string
uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
wayfinding_nodename: string
x: 0
y: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Sites vBeacons
summary: updateSiteVBeacon
description: Update Site Virtual Beacon
operationId: updateSiteVBeacon
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: vbeacon_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/vbeacon'
- description: Request Body
examples:
- major: 0
message: string
minor: 0
name: string
power: 4
power_mode: default
url: string
uuid: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
wayfinding_nodename: string
x: 0
y: 0
contentMediaType: application/json
examples:
Example:
value:
major: 0
message: string
minor: 0
name: string
power: 4
power_mode: default
url: string
uuid: 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
wayfinding_nodename: string
x: 0
y: 0
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/vbeacon'
- description: Virtual beacon configuration for SDK proximity notifications
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
major: 0
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
message: string
minor: 0
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
power: 4
power_mode: default
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
url: string
uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
wayfinding_nodename: string
x: 0
y: 0
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
major: 0
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
message: string
minor: 0
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
power: 4
power_mode: default
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
url: string
uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
wayfinding_nodename: string
x: 0
y: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/vbeacon'
- description: Virtual beacon configuration for SDK proximity notifications
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
major: 0
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
message: string
minor: 0
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
power: 4
power_mode: default
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
url: string
uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
wayfinding_nodename: string
x: 0
y: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
major: 0
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
message: string
minor: 0
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
power: 4
power_mode: default
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
url: string
uuid: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
wayfinding_nodename: string
x: 0
y: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/vpns/derived:
get:
tags:
- Sites VPNs
summary: listSiteVpnsDerived
description: Get the list of derived VPNs for a site
operationId: listSiteVpnsDerived
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: resolve
in: query
description: Whether resolve the site variables
style: form
explode: true
schema:
type: boolean
default: false
examples:
- true
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/vpn'
description: VPN records returned by a list response
examples:
- - name: string
paths:
property1:
bfd_profile: broadband
ip: string
property2:
bfd_profile: lte
ip: string
contentMediaType: application/json
examples:
Example:
value:
- name: string
paths:
property1:
bfd_profile: broadband
ip: string
property2:
bfd_profile: lte
ip: string
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/vpn'
description: VPN records returned by a list response
examples:
- - name: string
paths:
property1:
bfd_profile: broadband
ip: string
property2:
bfd_profile: lte
ip: string
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- name: string
paths:
property1:
bfd_profile: broadband
ip: string
property2:
bfd_profile: lte
ip: string
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/wan_usages/count:
get:
tags:
- Sites WAN Usages
summary: countSiteWanUsage
description: Count Site WAN Usages
operationId: countSiteWanUsage
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: mac
in: query
description: Filter results by MAC address
style: form
explode: true
schema:
type: string
examples:
- '001122334455'
- name: peer_mac
in: query
description: Filter results by peer MAC address
style: form
explode: true
schema:
type: string
examples:
- '001122334455'
- name: port_id
in: query
description: Port ID for the device
style: form
explode: true
schema:
type: string
examples:
- ge-0/0/0
- name: peer_port_id
in: query
description: Peer Port ID for the device
style: form
explode: true
schema:
type: string
examples:
- ge-0/0/0
- name: policy
in: query
description: Filter results by WAN path policy
style: form
explode: true
schema:
type: string
- name: tenant
in: query
description: Filter results by tenant network
style: form
explode: true
schema:
type: string
- name: path_type
in: query
description: Filter results by port path type
style: form
explode: true
schema:
type: string
examples:
- primary
- name: distinct
in: query
description: 'Field used to group this count response. enum: `mac`, `path_type`, `peer_mac`, `peer_port_id`, `policy`, `port_id`, `tenant`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/wan_usages_count_distinct'
- description: 'Field used to group this count response. enum: `mac`, `path_type`, `peer_mac`, `peer_port_id`, `policy`, `port_id`, `tenant`'
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/wan_usages/search:
get:
tags:
- Sites WAN Usages
summary: searchSiteWanUsage
description: Search Site WAN Usages
operationId: searchSiteWanUsage
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: mac
in: query
description: Filter results by MAC address
style: form
explode: true
schema:
type: string
examples:
- '001122334455'
- name: peer_mac
in: query
description: Filter results by peer MAC address
style: form
explode: true
schema:
type: string
examples:
- '001122334455'
- name: port_id
in: query
description: Port ID for the device
style: form
explode: true
schema:
type: string
examples:
- ge-0/0/0
- name: peer_port_id
in: query
description: Peer Port ID for the device
style: form
explode: true
schema:
type: string
examples:
- ge-0/0/0
- name: policy
in: query
description: Filter results by WAN path policy
style: form
explode: true
schema:
type: string
examples:
- primary
- name: tenant
in: query
description: Filter results by tenant network
style: form
explode: true
schema:
type: string
- name: path_type
in: query
description: Filter results by port path type
style: form
explode: true
schema:
type: string
examples:
- primary
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/search_wan_usage'
- description: Paginated response for WAN usage searches
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/search_wan_usage'
- description: Paginated response for WAN usage searches
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/webhooks:
get:
tags:
- Sites Webhooks
summary: listSiteWebhooks
description: Get List of Site Webhooks
operationId: listSiteWebhooks
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/webhook'
description: Webhook configuration records returned by a list response
examples:
- - created_time: 0
enabled: true
headers: {}
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
secret: string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
splunk_token: string
topics:
- location
type: http-post
url: string
verify_cert: true
contentMediaType: application/json
examples:
Example:
value:
- created_time: 0
enabled: true
headers: {}
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
secret: string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
splunk_token: string
topics:
- location
type: http-post
url: string
verify_cert: true
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/webhook'
description: Webhook configuration records returned by a list response
examples:
- - created_time: 0
enabled: true
headers: {}
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
secret: string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
splunk_token: string
topics:
- location
type: http-post
url: string
verify_cert: true
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- created_time: 0
enabled: true
headers: {}
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
secret: string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
splunk_token: string
topics:
- location
type: http-post
url: string
verify_cert: true
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Sites Webhooks
summary: createSiteWebhook
description: "Webhook defines a webhook, modeled after [github\\u2019s model](https://developer.github.com/webhooks/).\n\n\nThere is two types of webhooks:\n* webhooks ([examples](https://www.postman.com/juniper-mist/workspace/mist-systems-s-public-workspace/folder/224925-be01e694-7253-4195-8563-78e2a745e114)) \n* raw data webhooks ([examples](https://www.postman.com/juniper-mist/workspace/mist-systems-s-public-workspace/folder/224925-e2d5d5f8-4bdb-4efc-93e4-90f4b33d0b2b))\n\n\n##### Webhooks\nWebhooks can be configured at the org level (subset of topics only) and at the site level. It is possible to have multiple topics in the same webhook configuration and/or to have multiple webhooks configured at the same time.\n\n##### Client Raw Data Webhooks\nRaw data webhooks are a special subset of webhooks that provide insight into raw data packets emitted by a client, identified by their advertising MAC address (assets, discovered BLE, connected Wi-Fi, unconnected Wi-Fi). The data that client raw data webhooks encompasses are reporting AP information, RSSI Data, and any special packets/telemetry packets that the client may emit. Note that client raw webhooks are the raw data coming from the client and do not contain the X,Y location data of the client. In order to get the location data for a client please see our location webhooks. Clients can be identified uniquely across these client raw data topics and location webhook topic using MAC address as the Unique identifier (client identifier).\n\n###### Client Raw Data Webhooks Topics\nTopics that correspond to client raw data for different client types. \n* `asset-raw-rssi` - Raw data from packets emitted by named and filtered assets \n* `discovered-raw-rssi` - Raw data from packets emitted by passive BLE devices \n* `wifi-conn-raw` - Raw data from packets emitted by connected devices \n* `wifi-unconn-raw` - Raw data from packets emitted by unconnected devices (passive)\n\n### Asset Filtering for Client Raw Data Webhooks\n\nThe `asset-raw-rssi` webhook topic supports filtering of raw data by incorporating asset filters in the webhook payload. \nThe filter topic allows multiple Webhooks to receive a subset of the a`asset-raw-rssi` data by assigning asset filters to a given webhook. The `asset-raw-rssi` filter topic is filtered-asset-rssi.\n\n\nA webhook assigned to a filter topic can take a list of AssetFilter IDs, which act as inclusive filters to determine which named asset and filtered asset data is sent to the assigned filter topic. Filters can be applied to multiple webhooks, and the same data can be sent to multiple filter topics.\n\n### Rules for Configuring Client Raw Data Webhooks\n\n1. Only four instances of a webhook object can contain a specific filter topic. - A site-level entry will override an org-level entry for the same client raw data webhook topic.\n2. An assigned asset filter must exist and belong to the same site as the webhook it is assigned to.\n"
operationId: createSiteWebhook
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/webhook'
- description: Request Body
examples:
- enabled: true
headers: {}
name: string
secret: string
splunk_token: string
topics:
- location
type: http-post
url: string
verify_cert: true
contentMediaType: application/json
examples:
Example:
value:
enabled: true
headers: {}
name: string
secret: string
splunk_token: string
topics:
- location
type: http-post
url: string
verify_cert: true
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/webhook'
- description: Webhook configuration for delivering selected Mist events to an external destination
examples:
- created_time: 0
enabled: true
headers: {}
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
secret: string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
splunk_token: string
topics:
- location
type: http-post
url: string
verify_cert: true
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
enabled: true
headers: {}
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
secret: string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
splunk_token: string
topics:
- location
type: http-post
url: string
verify_cert: true
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/webhook'
- description: Webhook configuration for delivering selected Mist events to an external destination
examples:
- created_time: 0
enabled: true
headers: {}
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
secret: string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
splunk_token: string
topics:
- location
type: http-post
url: string
verify_cert: true
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
enabled: true
headers: {}
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
secret: string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
splunk_token: string
topics:
- location
type: http-post
url: string
verify_cert: true
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400_webhook'
- description: Webhook-specific HTTP 400 bad request error response
examples:
- '{"detail":"invalid field: assetfilter_ids","reason":"contains duplicate uuids"}'
- '{"detail":"invalid field: assetfilter_ids"}'
- '{"detail":"invalid field: assetfilter_ids"}'
- '{"detail":"Webhook already configured for special location topic"}'
- '{"detail":"Only one location topic can be configured per URL"}'
- '{"detail":"invalid field: topics","reason":"filtered asset webhooks must be associated with a site"}'
contentMediaType: application/json
examples:
Duplicate_assetfilter_id:
value:
detail: 'invalid field: assetfilter_ids'
reason: contains duplicate uuids
Invalid_assetfilter_id:
value:
detail: 'invalid field: assetfilter_ids'
Malformed_assetfilter_id:
value:
detail: 'invalid field: assetfilter_ids'
RawDataWebhook_already_created:
value:
detail: Webhook already configured for special location topic
RawDataWebhook_multiple_topics:
value:
detail: Only one location topic can be configured per URL
org_level_filter_webhook:
value:
detail: 'invalid field: topics'
reason: filtered asset webhooks must be associated with a site
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400_webhook'
- description: Webhook-specific HTTP 400 bad request error response
examples:
- '{"detail":"invalid field: assetfilter_ids","reason":"contains duplicate uuids"}'
- '{"detail":"invalid field: assetfilter_ids"}'
- '{"detail":"invalid field: assetfilter_ids"}'
- '{"detail":"Webhook already configured for special location topic"}'
- '{"detail":"Only one location topic can be configured per URL"}'
- '{"detail":"invalid field: topics","reason":"filtered asset webhooks must be associated with a site"}'
contentMediaType: application/vnd.api+json
examples:
Duplicate_assetfilter_id:
value:
detail: 'invalid field: assetfilter_ids'
reason: contains duplicate uuids
Invalid_assetfilter_id:
value:
detail: 'invalid field: assetfilter_ids'
Malformed_assetfilter_id:
value:
detail: 'invalid field: assetfilter_ids'
RawDataWebhook_already_created:
value:
detail: Webhook already configured for special location topic
RawDataWebhook_multiple_topics:
value:
detail: Only one location topic can be configured per URL
org_level_filter_webhook:
value:
detail: 'invalid field: topics'
reason: filtered asset webhooks must be associated with a site
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/webhooks/{webhook_id}:
delete:
tags:
- Sites Webhooks
summary: deleteSiteWebhook
description: Delete Site Webhook
operationId: deleteSiteWebhook
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: webhook_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Sites Webhooks
summary: getSiteWebhook
description: Get Site Webhook Details
operationId: getSiteWebhook
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: webhook_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/webhook'
- description: Webhook configuration for delivering selected Mist events to an external destination
examples:
- created_time: 0
enabled: true
headers: {}
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
secret: string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
splunk_token: string
topics:
- location
type: http-post
url: string
verify_cert: true
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
enabled: true
headers: {}
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
secret: string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
splunk_token: string
topics:
- location
type: http-post
url: string
verify_cert: true
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/webhook'
- description: Webhook configuration for delivering selected Mist events to an external destination
examples:
- created_time: 0
enabled: true
headers: {}
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
secret: string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
splunk_token: string
topics:
- location
type: http-post
url: string
verify_cert: true
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
enabled: true
headers: {}
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
secret: string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
splunk_token: string
topics:
- location
type: http-post
url: string
verify_cert: true
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Sites Webhooks
summary: updateSiteWebhook
description: Update Site Webhook
operationId: updateSiteWebhook
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: webhook_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/webhook'
- description: Request Body
examples:
- enabled: true
headers: {}
name: string
secret: string
splunk_token: string
topics:
- location
type: http-post
url: string
verify_cert: true
contentMediaType: application/json
examples:
Example:
value:
enabled: true
headers: {}
name: string
secret: string
splunk_token: string
topics:
- location
type: http-post
url: string
verify_cert: true
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/webhook'
- description: Webhook configuration for delivering selected Mist events to an external destination
examples:
- created_time: 0
enabled: true
headers: {}
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
secret: string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
splunk_token: string
topics:
- location
type: http-post
url: string
verify_cert: true
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
enabled: true
headers: {}
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
secret: string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
splunk_token: string
topics:
- location
type: http-post
url: string
verify_cert: true
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/webhook'
- description: Webhook configuration for delivering selected Mist events to an external destination
examples:
- created_time: 0
enabled: true
headers: {}
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
secret: string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
splunk_token: string
topics:
- location
type: http-post
url: string
verify_cert: true
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
enabled: true
headers: {}
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
secret: string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
splunk_token: string
topics:
- location
type: http-post
url: string
verify_cert: true
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/webhooks/{webhook_id}/events/count:
get:
tags:
- Sites Webhooks
summary: countSiteWebhooksDeliveries
description: >-
Count Site Webhooks deliveries
Topics Supported:
- alarms
- audits
- device-updowns
- occupancy-alerts
- ping
operationId: countSiteWebhooksDeliveries
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: webhook_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: error
in: query
description: Filter webhook delivery results by error message
style: form
explode: true
schema:
type: string
examples:
- Webhook delivery failed
- name: status_code
in: query
description: Filter webhook delivery results by HTTP status code
style: form
explode: true
schema:
type: integer
contentEncoding: int32
examples:
- 200
- name: status
in: query
description: 'Webhook delivery status used to filter results. enum: `failure`, `success`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/webhook_delivery_status'
- description: 'Webhook delivery status used to filter results. enum: `failure`, `success`'
examples:
- failure
- name: topic
in: query
description: 'Webhook topic used to filter results. enum: `alarms`, `audits`, `device-updowns`, `occupancy-alerts`, `ping`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/webhook_delivery_topic'
- description: 'Webhook topic used to filter results. enum: `alarms`, `audits`, `device-updowns`, `occupancy-alerts`, `ping`'
examples:
- audits
- name: distinct
in: query
description: 'Field used to group this count response. enum: `status`, `status_code`, `topic`, `webhook_id`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/webhook_delivery_distinct'
- description: 'Field used to group this count response. enum: `status`, `status_code`, `topic`, `webhook_id`'
examples:
- webhook_id
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/webhooks/{webhook_id}/events/search:
get:
tags:
- Sites Webhooks
summary: searchSiteWebhooksDeliveries
description: >-
Search Site Webhooks deliveries
Topics Supported:
- alarms
- audits
- device-updowns
- occupancy-alerts
- ping
operationId: searchSiteWebhooksDeliveries
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: webhook_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: error
in: query
description: Filter webhook delivery results by error message
style: form
explode: true
schema:
type: string
examples:
- Webhook delivery failed
- name: status_code
in: query
description: Filter webhook delivery results by HTTP status code
style: form
explode: true
schema:
type: integer
contentEncoding: int32
examples:
- 200
- name: status
in: query
description: 'Webhook delivery status used to filter results. enum: `failure`, `success`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/webhook_delivery_status'
- description: 'Webhook delivery status used to filter results. enum: `failure`, `success`'
examples:
- failure
- name: topic
in: query
description: 'Webhook topic used to filter results. enum: `alarms`, `audits`, `device-updowns`, `occupancy-alerts`, `ping`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/webhook_delivery_topic'
- description: 'Webhook topic used to filter results. enum: `alarms`, `audits`, `device-updowns`, `occupancy-alerts`, `ping`'
examples:
- audits
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/search_webhook_delivery'
- description: Paginated response for webhook delivery searches
examples:
- end: 1688035193
limit: 10
results:
- error: string
id: 55b0f02f-ebf6-4ad2-8b10-200508a97581
org_id: fc7e2967-e7ef-41e6-b007-1217713de05a
req_headers: '{\"Content-Type\":[\"application/json\"],\"User-Agent\":[\"Mist-webhook\"]}'
req_payload: '{\"topic\":\"audits\",\"events\":[{\"admin_name\":\"John Doe john.doe@juniper.net\",\"after\":\"{\\"radio_config\\": {\\"band_24\\": {\\"disabled\\": false, \\"allow_rrm_disable\\": false, \\"power_min\\": null, \\"power_max\\": null, \\"power\\": 10, \\"preamble\\": \\"short\\", \\"channels\\": [1, 10], \\"bandwidth\\": 20}}}\",\"before\":\"{\\"radio_config\\": {\\"band_24\\": {\\"disabled\\": false, \\"allow_rrm_disable\\": false, \\"power_min\\": 8, \\"power_max\\": 18, \\"power\\": null, \\"preamble\\": \\"long\\", \\"channels\\": [1, 10], \\"bandwidth\\": 20}}}\",\"id\":\"737909a2-04ff-4aeb-b9da-cc924e74a4dd\",\"message\":\"Update Site Settings\",\"org_id\":\"fc7e2967-e7ef-41e6-b007-1217713de05a\",\"site_id\":\"256c3a35-9cb7-436e-bc6d-314972645d95\",\"site_name\":\"Test Site\",\"src_ip\":\"1.2.3.4\",\"timestamp\":1685956576.923601,\"user_agent\":\"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/112.0.0.0 Safari/537.36\"}]}'
req_url: https://example.com
resp_body: Ok
resp_headers: string
site_id: 256c3a35-9cb7-436e-bc6d-314972645d95
status: success
status_code: 200
timestamp: 1687962508.583656
topic: audits
webhook_id: 7a11b901-f719-4c91-8aef-deb8699a6364
start: 1687948793
total: 0
contentMediaType: application/json
examples:
Webhook Deliveries:
value:
end: 1688035193
limit: 10
results:
- error: string
id: 55b0f02f-ebf6-4ad2-8b10-200508a97581
org_id: fc7e2967-e7ef-41e6-b007-1217713de05a
req_headers: '{\"Content-Type\":[\"application/json\"],\"User-Agent\":[\"Mist-webhook\"]}'
req_payload: '{\"topic\":\"audits\",\"events\":[{\"admin_name\":\"John Doe john.doe@juniper.net\",\"after\":\"{\\"radio_config\\": {\\"band_24\\": {\\"disabled\\": false, \\"allow_rrm_disable\\": false, \\"power_min\\": null, \\"power_max\\": null, \\"power\\": 10, \\"preamble\\": \\"short\\", \\"channels\\": [1, 10], \\"bandwidth\\": 20}}}\",\"before\":\"{\\"radio_config\\": {\\"band_24\\": {\\"disabled\\": false, \\"allow_rrm_disable\\": false, \\"power_min\\": 8, \\"power_max\\": 18, \\"power\\": null, \\"preamble\\": \\"long\\", \\"channels\\": [1, 10], \\"bandwidth\\": 20}}}\",\"id\":\"737909a2-04ff-4aeb-b9da-cc924e74a4dd\",\"message\":\"Update Site Settings\",\"org_id\":\"fc7e2967-e7ef-41e6-b007-1217713de05a\",\"site_id\":\"256c3a35-9cb7-436e-bc6d-314972645d95\",\"site_name\":\"Test Site\",\"src_ip\":\"1.2.3.4\",\"timestamp\":1685956576.923601,\"user_agent\":\"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/112.0.0.0 Safari/537.36\"}]}'
req_url: https://example.com
resp_body: Ok
resp_headers: string
site_id: 256c3a35-9cb7-436e-bc6d-314972645d95
status: success
status_code: 200
timestamp: 1687962508.583656
topic: audits
webhook_id: 7a11b901-f719-4c91-8aef-deb8699a6364
start: 1687948793
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/search_webhook_delivery'
- description: Paginated response for webhook delivery searches
examples:
- end: 1688035193
limit: 10
results:
- error: string
id: 55b0f02f-ebf6-4ad2-8b10-200508a97581
org_id: fc7e2967-e7ef-41e6-b007-1217713de05a
req_headers: '{\"Content-Type\":[\"application/json\"],\"User-Agent\":[\"Mist-webhook\"]}'
req_payload: '{\"topic\":\"audits\",\"events\":[{\"admin_name\":\"John Doe john.doe@juniper.net\",\"after\":\"{\\"radio_config\\": {\\"band_24\\": {\\"disabled\\": false, \\"allow_rrm_disable\\": false, \\"power_min\\": null, \\"power_max\\": null, \\"power\\": 10, \\"preamble\\": \\"short\\", \\"channels\\": [1, 10], \\"bandwidth\\": 20}}}\",\"before\":\"{\\"radio_config\\": {\\"band_24\\": {\\"disabled\\": false, \\"allow_rrm_disable\\": false, \\"power_min\\": 8, \\"power_max\\": 18, \\"power\\": null, \\"preamble\\": \\"long\\", \\"channels\\": [1, 10], \\"bandwidth\\": 20}}}\",\"id\":\"737909a2-04ff-4aeb-b9da-cc924e74a4dd\",\"message\":\"Update Site Settings\",\"org_id\":\"fc7e2967-e7ef-41e6-b007-1217713de05a\",\"site_id\":\"256c3a35-9cb7-436e-bc6d-314972645d95\",\"site_name\":\"Test Site\",\"src_ip\":\"1.2.3.4\",\"timestamp\":1685956576.923601,\"user_agent\":\"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/112.0.0.0 Safari/537.36\"}]}'
req_url: https://example.com
resp_body: Ok
resp_headers: string
site_id: 256c3a35-9cb7-436e-bc6d-314972645d95
status: success
status_code: 200
timestamp: 1687962508.583656
topic: audits
webhook_id: 7a11b901-f719-4c91-8aef-deb8699a6364
start: 1687948793
total: 0
contentMediaType: application/vnd.api+json
examples:
Webhook Deliveries:
value:
end: 1688035193
limit: 10
results:
- error: string
id: 55b0f02f-ebf6-4ad2-8b10-200508a97581
org_id: fc7e2967-e7ef-41e6-b007-1217713de05a
req_headers: '{\"Content-Type\":[\"application/json\"],\"User-Agent\":[\"Mist-webhook\"]}'
req_payload: '{\"topic\":\"audits\",\"events\":[{\"admin_name\":\"John Doe john.doe@juniper.net\",\"after\":\"{\\"radio_config\\": {\\"band_24\\": {\\"disabled\\": false, \\"allow_rrm_disable\\": false, \\"power_min\\": null, \\"power_max\\": null, \\"power\\": 10, \\"preamble\\": \\"short\\", \\"channels\\": [1, 10], \\"bandwidth\\": 20}}}\",\"before\":\"{\\"radio_config\\": {\\"band_24\\": {\\"disabled\\": false, \\"allow_rrm_disable\\": false, \\"power_min\\": 8, \\"power_max\\": 18, \\"power\\": null, \\"preamble\\": \\"long\\", \\"channels\\": [1, 10], \\"bandwidth\\": 20}}}\",\"id\":\"737909a2-04ff-4aeb-b9da-cc924e74a4dd\",\"message\":\"Update Site Settings\",\"org_id\":\"fc7e2967-e7ef-41e6-b007-1217713de05a\",\"site_id\":\"256c3a35-9cb7-436e-bc6d-314972645d95\",\"site_name\":\"Test Site\",\"src_ip\":\"1.2.3.4\",\"timestamp\":1685956576.923601,\"user_agent\":\"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/112.0.0.0 Safari/537.36\"}]}'
req_url: https://example.com
resp_body: Ok
resp_headers: string
site_id: 256c3a35-9cb7-436e-bc6d-314972645d95
status: success
status_code: 200
timestamp: 1687962508.583656
topic: audits
webhook_id: 7a11b901-f719-4c91-8aef-deb8699a6364
start: 1687948793
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/webhooks/{webhook_id}/ping:
post:
tags:
- Sites Webhooks
summary: pingSiteWebhook
description: Send a Ping event to the webhook
operationId: pingSiteWebhook
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: webhook_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/wlans:
get:
tags:
- Sites Wlans
summary: listSiteWlans
description: Get List of Site WLANs
operationId: listSiteWlans
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/wlan'
description: WLAN records returned by a list response
contentMediaType: application/json
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/wlan'
description: WLAN records returned by a list response
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Sites Wlans
summary: createSiteWlan
description: Create Site WLAN
operationId: createSiteWlan
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/wlan'
- description: Request Body
examples:
- acct_immediate_update: false
acct_interim_interval: 0
acct_servers:
- host: 1.2.3.4
keywrap_enabled: true
keywrap_format: hex
keywrap_kek: '1122334455'
keywrap_mack: '1122334455'
port: 1813
secret: testing123
airwatch:
api_key: aHhlbGxvYXNkZmFzZGZhc2Rmc2RmCg=="
console_url: https://hs1.airwatchportals.com
enabled: true
password: user1
username: test123
allow_ipv6_ndp: true
allow_mdns: false
allow_ssdp: false
ap_ids:
- 497f6eca-6276-4993-bfeb-53cbbbbb6f08
app_limit:
apps:
dropbox: 300
netflix: 60
enabled: false
wxtag_ids:
f99862d9-2726-931f-7559-3dfdf5d070d3: 30
app_qos:
apps:
skype-business-video:
dscp: 32
dst_subnet: 10.2.0.0/16
src_subnet: 10.2.0.0/16
enabled: true
others:
- dscp: 32
dst_subnet: 10.2.0.0/16
port_ranges: 80,1024-6553
protocol: udp
src_subnet: 10.2.0.0/16
apply_to: site
arp_filter: false
auth:
anticlog_threshold: 16
eap_reauth: false
enable_mac_auth: false
key_idx: 1
keys:
- string
multi_psk_only: false
pairwise:
- wpa2-ccmp
private_wlan: true
psk: foryoureyesonly
type: psk
wep_as_secondary_auth: true
auth_server_selection: ordered
auth_servers:
- host: 1.2.3.4
keywrap_enabled: true
keywrap_format: hex
keywrap_kek: '1122334455'
keywrap_mack: '1122334455'
port: 1812
secret: testing123
auth_servers_nas_id: 5c5b350e0101-nas
auth_servers_nas_ip: 15.3.1.5
auth_servers_retries: 5
auth_servers_timeout: 5
band: string
band_steer: false
band_steer_force_band5: false
bands:
- '24'
- '5'
block_blacklist_clients: false
bonjour:
additional_vlan_ids: 10,20
enabled: false
services:
airplay:
radius_groups:
- teachers
scope: same_ap
cisco_cwa:
allowed_hostnames:
- snapchat.com
allowed_subnets:
- 63.5.3.0/24
blocked_subnets:
- 192.168.0.0/16
enabled: false
client_limit_down: 1000
client_limit_down_enabled: false
client_limit_up: 512
client_limit_up_enabled: false
coa_servers:
- disable_event_timestamp_check: false
enabled: false
ip: 1.2.3.4
port: 3799
secret: testing456
disable_11ax: false
disable_ht_vht_rates: false
disable_uapsd: false
disable_v1_roam_notify: false
disable_v2_roam_notify: false
disable_wmm: false
dns_server_rewrite:
enabled: false
radius_groups:
contractor: 172.1.1.1
guest: 8.8.8.8
dtim: 2
dynamic_psk:
default_psk: foryoureyesonly
default_vlan_id: 999
enabled: false
source: cloud_psks
dynamic_vlan:
default_vlan_id: 999
enabled: false
local_vlan_ids:
- 1
type: airespace-interface-name
vlans:
'131': default
'322': fast,video
enable_local_keycaching: false
enable_wireless_bridging: false
enabled: true
fast_dot1x_timers: false
hide_ssid: false
hostname_ie: false
hotspot20:
domain_name:
- mist.com
enabled: true
nai_realms:
- string
operators:
- google
- att
rcoi:
- 5A03BA0000
venue_name: some_name
interface: all
isolation: false
l2_isolation: false
legacy_overds: false
limit_bcast: false
limit_probe_response: true
max_idletime: 1800
mist_nac:
enabled: false
no_static_dns: false
no_static_ip: false
ssid: demo
contentMediaType: application/json
examples:
Example:
value:
acct_immediate_update: false
acct_interim_interval: 0
acct_servers:
- host: 1.2.3.4
keywrap_enabled: true
keywrap_format: hex
keywrap_kek: '1122334455'
keywrap_mack: '1122334455'
port: 1813
secret: testing123
airwatch:
api_key: aHhlbGxvYXNkZmFzZGZhc2Rmc2RmCg=="
console_url: https://hs1.airwatchportals.com
enabled: true
password: user1
username: test123
allow_ipv6_ndp: true
allow_mdns: false
allow_ssdp: false
ap_ids:
- 497f6eca-6276-4993-bfeb-53cbbbbb6f08
app_limit:
apps:
dropbox: 300
netflix: 60
enabled: false
wxtag_ids:
f99862d9-2726-931f-7559-3dfdf5d070d3: 30
app_qos:
apps:
skype-business-video:
dscp: 32
dst_subnet: 10.2.0.0/16
src_subnet: 10.2.0.0/16
enabled: true
others:
- dscp: 32
dst_subnet: 10.2.0.0/16
port_ranges: 80,1024-6553
protocol: udp
src_subnet: 10.2.0.0/16
apply_to: site
arp_filter: false
auth:
anticlog_threshold: 16
eap_reauth: false
enable_mac_auth: false
key_idx: 1
keys:
- string
multi_psk_only: false
pairwise:
- wpa2-ccmp
private_wlan: true
psk: foryoureyesonly
type: psk
wep_as_secondary_auth: true
auth_server_selection: ordered
auth_servers:
- host: 1.2.3.4
keywrap_enabled: true
keywrap_format: hex
keywrap_kek: '1122334455'
keywrap_mack: '1122334455'
port: 1812
secret: testing123
auth_servers_nas_id: 5c5b350e0101-nas
auth_servers_nas_ip: 15.3.1.5
auth_servers_retries: 5
auth_servers_timeout: 5
band: string
band_steer: false
band_steer_force_band5: false
bands:
- '24'
- '5'
block_blacklist_clients: false
bonjour:
additional_vlan_ids: 10,20
enabled: false
services:
airplay:
radius_groups:
- teachers
scope: same_ap
cisco_cwa:
allowed_hostnames:
- snapchat.com
allowed_subnets:
- 63.5.3.0/24
blocked_subnets:
- 192.168.0.0/16
enabled: false
client_limit_down: 1000
client_limit_down_enabled: false
client_limit_up: 512
client_limit_up_enabled: false
coa_servers:
- disable_event_timestamp_check: false
enabled: false
ip: 1.2.3.4
port: 3799
secret: testing456
disable_11ax: false
disable_ht_vht_rates: false
disable_uapsd: false
disable_v1_roam_notify: false
disable_v2_roam_notify: false
disable_wmm: false
dns_server_rewrite:
enabled: false
radius_groups:
contractor: 172.1.1.1
guest: 8.8.8.8
dtim: 2
dynamic_psk:
default_psk: foryoureyesonly
default_vlan_id: 999
enabled: false
source: cloud_psks
dynamic_vlan:
default_vlan_id: 999
enabled: false
local_vlan_ids:
- 1
type: airespace-interface-name
vlans:
'131': default
'322': fast,video
enable_local_keycaching: false
enable_wireless_bridging: false
enabled: true
fast_dot1x_timers: false
hide_ssid: false
hostname_ie: false
hotspot20:
domain_name:
- mist.com
enabled: true
nai_realms:
- string
operators:
- google
- att
rcoi:
- 5A03BA0000
venue_name: some_name
interface: all
isolation: false
l2_isolation: false
legacy_overds: false
limit_bcast: false
limit_probe_response: true
max_idletime: 1800
mist_nac:
enabled: false
no_static_dns: false
no_static_ip: false
ssid: demo
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/wlan'
- description: '**Note**: portal_template will be forked out of wlan objects soon. To fetch portal_template, please query portal_template_url. To update portal_template, use Wlan Portal Template.'
examples:
- allow_ipv6_ndp: true
allow_mdns: false
allow_ssdp: false
arp_filter: false
band_steer: false
band_steer_force_band5: false
bands:
- '24'
- '5'
block_blacklist_clients: false
bonjour:
additional_vlan_ids: 10, 20
enabled: false
services:
airplay:
radius_groups:
- teachers
scope: same_ap
client_limit_down: 1000
client_limit_down_enabled: false
client_limit_up: 512
client_limit_up_enabled: false
disable_11ax: false
disable_ht_vht_rates: false
disable_uapsd: false
disable_v1_roam_notify: false
disable_v2_roam_notify: false
disable_wmm: false
dynamic_vlan:
default_vlan_id: 999
enabled: false
local_vlan_ids:
- 1
type: airespace-interface-name
vlans:
'131': default
'322': fast,video
enable_local_keycaching: false
enable_wireless_bridging: false
enabled: true
fast_dot1x_timers: false
hide_ssid: false
hostname_ie: false
ssid: demo
contentMediaType: application/json
examples:
Example:
value:
allow_ipv6_ndp: true
allow_mdns: false
allow_ssdp: false
arp_filter: false
band_steer: false
band_steer_force_band5: false
bands:
- '24'
- '5'
block_blacklist_clients: false
bonjour:
additional_vlan_ids: 10, 20
enabled: false
services:
airplay:
radius_groups:
- teachers
scope: same_ap
client_limit_down: 1000
client_limit_down_enabled: false
client_limit_up: 512
client_limit_up_enabled: false
disable_11ax: false
disable_ht_vht_rates: false
disable_uapsd: false
disable_v1_roam_notify: false
disable_v2_roam_notify: false
disable_wmm: false
dynamic_vlan:
default_vlan_id: 999
enabled: false
local_vlan_ids:
- 1
type: airespace-interface-name
vlans:
'131': default
'322': fast,video
enable_local_keycaching: false
enable_wireless_bridging: false
enabled: true
fast_dot1x_timers: false
hide_ssid: false
hostname_ie: false
ssid: demo
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/wlan'
- description: '**Note**: portal_template will be forked out of wlan objects soon. To fetch portal_template, please query portal_template_url. To update portal_template, use Wlan Portal Template.'
examples:
- allow_ipv6_ndp: true
allow_mdns: false
allow_ssdp: false
arp_filter: false
band_steer: false
band_steer_force_band5: false
bands:
- '24'
- '5'
block_blacklist_clients: false
bonjour:
additional_vlan_ids: 10, 20
enabled: false
services:
airplay:
radius_groups:
- teachers
scope: same_ap
client_limit_down: 1000
client_limit_down_enabled: false
client_limit_up: 512
client_limit_up_enabled: false
disable_11ax: false
disable_ht_vht_rates: false
disable_uapsd: false
disable_v1_roam_notify: false
disable_v2_roam_notify: false
disable_wmm: false
dynamic_vlan:
default_vlan_id: 999
enabled: false
local_vlan_ids:
- 1
type: airespace-interface-name
vlans:
'131': default
'322': fast,video
enable_local_keycaching: false
enable_wireless_bridging: false
enabled: true
fast_dot1x_timers: false
hide_ssid: false
hostname_ie: false
ssid: demo
contentMediaType: application/vnd.api+json
examples:
Example:
value:
allow_ipv6_ndp: true
allow_mdns: false
allow_ssdp: false
arp_filter: false
band_steer: false
band_steer_force_band5: false
bands:
- '24'
- '5'
block_blacklist_clients: false
bonjour:
additional_vlan_ids: 10, 20
enabled: false
services:
airplay:
radius_groups:
- teachers
scope: same_ap
client_limit_down: 1000
client_limit_down_enabled: false
client_limit_up: 512
client_limit_up_enabled: false
disable_11ax: false
disable_ht_vht_rates: false
disable_uapsd: false
disable_v1_roam_notify: false
disable_v2_roam_notify: false
disable_wmm: false
dynamic_vlan:
default_vlan_id: 999
enabled: false
local_vlan_ids:
- 1
type: airespace-interface-name
vlans:
'131': default
'322': fast,video
enable_local_keycaching: false
enable_wireless_bridging: false
enabled: true
fast_dot1x_timers: false
hide_ssid: false
hostname_ie: false
ssid: demo
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/wlans/derived:
get:
tags:
- Sites Wlans
summary: listSiteWlansDerived
description: Get the list of derived Wlans for a Site
operationId: listSiteWlansDerived
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: resolve
in: query
description: Whether to resolve SITE_VARS
style: form
explode: true
schema:
type: boolean
default: false
examples:
- true
- name: wlan_id
in: query
description: Filter by WLAN ID
style: form
explode: true
schema:
type: string
examples:
- 8bfc2490-d726-3587-038d-cb2e71bd2330
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/wlan'
description: WLAN records returned by a list response
contentMediaType: application/json
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/wlan'
description: WLAN records returned by a list response
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/wlans/{wlan_id}:
delete:
tags:
- Sites Wlans
summary: deleteSiteWlan
description: Delete Site WLAN
operationId: deleteSiteWlan
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: wlan_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Sites Wlans
summary: getSiteWlan
description: Get Site WLAN
operationId: getSiteWlan
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: wlan_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/wlan'
- description: '**Note**: portal_template will be forked out of wlan objects soon. To fetch portal_template, please query portal_template_url. To update portal_template, use Wlan Portal Template.'
examples:
- allow_ipv6_ndp: true
allow_mdns: false
allow_ssdp: false
arp_filter: false
band_steer: false
band_steer_force_band5: false
bands:
- '24'
- '5'
block_blacklist_clients: false
bonjour:
additional_vlan_ids: 10, 20
enabled: false
services:
airplay:
radius_groups:
- teachers
scope: same_ap
client_limit_down: 1000
client_limit_down_enabled: false
client_limit_up: 512
client_limit_up_enabled: false
disable_11ax: false
disable_ht_vht_rates: false
disable_uapsd: false
disable_v1_roam_notify: false
disable_v2_roam_notify: false
disable_wmm: false
dynamic_vlan:
default_vlan_id: 999
enabled: false
local_vlan_ids:
- 1
type: airespace-interface-name
vlans:
'131': default
'322': fast,video
enable_local_keycaching: false
enable_wireless_bridging: false
enabled: true
fast_dot1x_timers: false
hide_ssid: false
hostname_ie: false
ssid: demo
contentMediaType: application/json
examples:
Example:
value:
allow_ipv6_ndp: true
allow_mdns: false
allow_ssdp: false
arp_filter: false
band_steer: false
band_steer_force_band5: false
bands:
- '24'
- '5'
block_blacklist_clients: false
bonjour:
additional_vlan_ids: 10, 20
enabled: false
services:
airplay:
radius_groups:
- teachers
scope: same_ap
client_limit_down: 1000
client_limit_down_enabled: false
client_limit_up: 512
client_limit_up_enabled: false
disable_11ax: false
disable_ht_vht_rates: false
disable_uapsd: false
disable_v1_roam_notify: false
disable_v2_roam_notify: false
disable_wmm: false
dynamic_vlan:
default_vlan_id: 999
enabled: false
local_vlan_ids:
- 1
type: airespace-interface-name
vlans:
'131': default
'322': fast,video
enable_local_keycaching: false
enable_wireless_bridging: false
enabled: true
fast_dot1x_timers: false
hide_ssid: false
hostname_ie: false
ssid: demo
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/wlan'
- description: '**Note**: portal_template will be forked out of wlan objects soon. To fetch portal_template, please query portal_template_url. To update portal_template, use Wlan Portal Template.'
examples:
- allow_ipv6_ndp: true
allow_mdns: false
allow_ssdp: false
arp_filter: false
band_steer: false
band_steer_force_band5: false
bands:
- '24'
- '5'
block_blacklist_clients: false
bonjour:
additional_vlan_ids: 10, 20
enabled: false
services:
airplay:
radius_groups:
- teachers
scope: same_ap
client_limit_down: 1000
client_limit_down_enabled: false
client_limit_up: 512
client_limit_up_enabled: false
disable_11ax: false
disable_ht_vht_rates: false
disable_uapsd: false
disable_v1_roam_notify: false
disable_v2_roam_notify: false
disable_wmm: false
dynamic_vlan:
default_vlan_id: 999
enabled: false
local_vlan_ids:
- 1
type: airespace-interface-name
vlans:
'131': default
'322': fast,video
enable_local_keycaching: false
enable_wireless_bridging: false
enabled: true
fast_dot1x_timers: false
hide_ssid: false
hostname_ie: false
ssid: demo
contentMediaType: application/vnd.api+json
examples:
Example:
value:
allow_ipv6_ndp: true
allow_mdns: false
allow_ssdp: false
arp_filter: false
band_steer: false
band_steer_force_band5: false
bands:
- '24'
- '5'
block_blacklist_clients: false
bonjour:
additional_vlan_ids: 10, 20
enabled: false
services:
airplay:
radius_groups:
- teachers
scope: same_ap
client_limit_down: 1000
client_limit_down_enabled: false
client_limit_up: 512
client_limit_up_enabled: false
disable_11ax: false
disable_ht_vht_rates: false
disable_uapsd: false
disable_v1_roam_notify: false
disable_v2_roam_notify: false
disable_wmm: false
dynamic_vlan:
default_vlan_id: 999
enabled: false
local_vlan_ids:
- 1
type: airespace-interface-name
vlans:
'131': default
'322': fast,video
enable_local_keycaching: false
enable_wireless_bridging: false
enabled: true
fast_dot1x_timers: false
hide_ssid: false
hostname_ie: false
ssid: demo
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Sites Wlans
summary: updateSiteWlan
description: Update Site WLAN
operationId: updateSiteWlan
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: wlan_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/wlan'
- description: Request Body
examples:
- acct_immediate_update: false
acct_interim_interval: 0
acct_servers:
- host: 1.2.3.4
keywrap_enabled: true
keywrap_format: hex
keywrap_kek: '1122334455'
keywrap_mack: '1122334455'
port: 1813
secret: testing123
airwatch:
api_key: aHhlbGxvYXNkZmFzZGZhc2Rmc2RmCg=="
console_url: https://hs1.airwatchportals.com
enabled: true
password: user1
username: test123
allow_ipv6_ndp: true
allow_mdns: false
allow_ssdp: false
ap_ids:
- 497f6eca-6276-4993-bfeb-53cbbbbe6f08
app_limit:
apps:
dropbox: 300
netflix: 60
enabled: false
wxtag_ids:
f99862d9-2726-931f-7559-3dfdf5d070d3: 30
app_qos:
apps:
skype-business-video:
dscp: 32
dst_subnet: 10.2.0.0/16
src_subnet: 10.2.0.0/16
enabled: true
others:
- dscp: 32
dst_subnet: 10.2.0.0/16
port_ranges: 80,1024-6553
protocol: udp
src_subnet: 10.2.0.0/16
apply_to: site
arp_filter: false
auth:
anticlog_threshold: 16
eap_reauth: false
enable_mac_auth: false
key_idx: 1
keys:
- string
multi_psk_only: false
pairwise:
- wpa2-ccmp
private_wlan: true
psk: foryoureyesonly
type: psk
wep_as_secondary_auth: true
auth_server_selection: ordered
auth_servers:
- host: 1.2.3.4
keywrap_enabled: true
keywrap_format: hex
keywrap_kek: '1122334455'
keywrap_mack: '1122334455'
port: 1812
secret: testing123
auth_servers_nas_id: 5c5b350e0101-nas
auth_servers_nas_ip: 15.3.1.5
auth_servers_retries: 5
auth_servers_timeout: 5
band: string
band_steer: false
band_steer_force_band5: false
bands:
- '24'
- '5'
block_blacklist_clients: false
bonjour:
additional_vlan_ids: 10,20
enabled: false
services:
airplay:
radius_groups:
- teachers
scope: same_ap
cisco_cwa:
allowed_hostnames:
- snapchat.com
allowed_subnets:
- 63.5.3.0/24
blocked_subnets:
- 192.168.0.0/16
enabled: false
client_limit_down: 1000
client_limit_down_enabled: false
client_limit_up: 512
client_limit_up_enabled: false
coa_servers:
- disable_event_timestamp_check: false
enabled: false
ip: 1.2.3.4
port: 3799
secret: testing456
disable_11ax: false
disable_ht_vht_rates: false
disable_uapsd: false
disable_v1_roam_notify: false
disable_v2_roam_notify: false
disable_wmm: false
dns_server_rewrite:
enabled: false
radius_groups:
contractor: 172.1.1.1
guest: 8.8.8.8
dtim: 2
dynamic_psk:
default_psk: foryoureyesonly
default_vlan_id: 999
enabled: false
source: cloud_psks
dynamic_vlan:
default_vlan_id: 999
enabled: false
local_vlan_ids:
- 1
type: airespace-interface-name
vlans:
'131': default
'322': fast,video
enable_local_keycaching: false
enable_wireless_bridging: false
enabled: true
fast_dot1x_timers: false
hide_ssid: false
hostname_ie: false
hotspot20:
domain_name:
- mist.com
enabled: true
nai_realms:
- string
operators:
- google
- att
rcoi:
- 5A03BA0000
venue_name: some_name
interface: all
isolation: false
l2_isolation: false
legacy_overds: false
limit_bcast: false
limit_probe_response: true
max_idletime: 1800
mist_nac:
enabled: false
no_static_dns: false
no_static_ip: false
ssid: demo
contentMediaType: application/json
examples:
Example:
value:
acct_immediate_update: false
acct_interim_interval: 0
acct_servers:
- host: 1.2.3.4
keywrap_enabled: true
keywrap_format: hex
keywrap_kek: '1122334455'
keywrap_mack: '1122334455'
port: 1813
secret: testing123
airwatch:
api_key: aHhlbGxvYXNkZmFzZGZhc2Rmc2RmCg=="
console_url: https://hs1.airwatchportals.com
enabled: true
password: user1
username: test123
allow_ipv6_ndp: true
allow_mdns: false
allow_ssdp: false
ap_ids:
- 497f6eca-6276-4993-bfeb-53cbbbbe6f08
app_limit:
apps:
dropbox: 300
netflix: 60
enabled: false
wxtag_ids:
f99862d9-2726-931f-7559-3dfdf5d070d3: 30
app_qos:
apps:
skype-business-video:
dscp: 32
dst_subnet: 10.2.0.0/16
src_subnet: 10.2.0.0/16
enabled: true
others:
- dscp: 32
dst_subnet: 10.2.0.0/16
port_ranges: 80,1024-6553
protocol: udp
src_subnet: 10.2.0.0/16
apply_to: site
arp_filter: false
auth:
anticlog_threshold: 16
eap_reauth: false
enable_mac_auth: false
key_idx: 1
keys:
- string
multi_psk_only: false
pairwise:
- wpa2-ccmp
private_wlan: true
psk: foryoureyesonly
type: psk
wep_as_secondary_auth: true
auth_server_selection: ordered
auth_servers:
- host: 1.2.3.4
keywrap_enabled: true
keywrap_format: hex
keywrap_kek: '1122334455'
keywrap_mack: '1122334455'
port: 1812
secret: testing123
auth_servers_nas_id: 5c5b350e0101-nas
auth_servers_nas_ip: 15.3.1.5
auth_servers_retries: 5
auth_servers_timeout: 5
band: string
band_steer: false
band_steer_force_band5: false
bands:
- '24'
- '5'
block_blacklist_clients: false
bonjour:
additional_vlan_ids: 10,20
enabled: false
services:
airplay:
radius_groups:
- teachers
scope: same_ap
cisco_cwa:
allowed_hostnames:
- snapchat.com
allowed_subnets:
- 63.5.3.0/24
blocked_subnets:
- 192.168.0.0/16
enabled: false
client_limit_down: 1000
client_limit_down_enabled: false
client_limit_up: 512
client_limit_up_enabled: false
coa_servers:
- disable_event_timestamp_check: false
enabled: false
ip: 1.2.3.4
port: 3799
secret: testing456
disable_11ax: false
disable_ht_vht_rates: false
disable_uapsd: false
disable_v1_roam_notify: false
disable_v2_roam_notify: false
disable_wmm: false
dns_server_rewrite:
enabled: false
radius_groups:
contractor: 172.1.1.1
guest: 8.8.8.8
dtim: 2
dynamic_psk:
default_psk: foryoureyesonly
default_vlan_id: 999
enabled: false
source: cloud_psks
dynamic_vlan:
default_vlan_id: 999
enabled: false
local_vlan_ids:
- 1
type: airespace-interface-name
vlans:
'131': default
'322': fast,video
enable_local_keycaching: false
enable_wireless_bridging: false
enabled: true
fast_dot1x_timers: false
hide_ssid: false
hostname_ie: false
hotspot20:
domain_name:
- mist.com
enabled: true
nai_realms:
- string
operators:
- google
- att
rcoi:
- 5A03BA0000
venue_name: some_name
interface: all
isolation: false
l2_isolation: false
legacy_overds: false
limit_bcast: false
limit_probe_response: true
max_idletime: 1800
mist_nac:
enabled: false
no_static_dns: false
no_static_ip: false
ssid: demo
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/wlan'
- description: '**Note**: portal_template will be forked out of wlan objects soon. To fetch portal_template, please query portal_template_url. To update portal_template, use Wlan Portal Template.'
examples:
- allow_ipv6_ndp: true
allow_mdns: false
allow_ssdp: false
arp_filter: false
band_steer: false
band_steer_force_band5: false
bands:
- '24'
- '5'
block_blacklist_clients: false
bonjour:
additional_vlan_ids: 10, 20
enabled: false
services:
airplay:
radius_groups:
- teachers
scope: same_ap
client_limit_down: 1000
client_limit_down_enabled: false
client_limit_up: 512
client_limit_up_enabled: false
disable_11ax: false
disable_ht_vht_rates: false
disable_uapsd: false
disable_v1_roam_notify: false
disable_v2_roam_notify: false
disable_wmm: false
dynamic_vlan:
default_vlan_id: 999
enabled: false
local_vlan_ids:
- 1
type: airespace-interface-name
vlans:
'131': default
'322': fast,video
enable_local_keycaching: false
enable_wireless_bridging: false
enabled: true
fast_dot1x_timers: false
hide_ssid: false
hostname_ie: false
ssid: demo
contentMediaType: application/json
examples:
Example:
value:
allow_ipv6_ndp: true
allow_mdns: false
allow_ssdp: false
arp_filter: false
band_steer: false
band_steer_force_band5: false
bands:
- '24'
- '5'
block_blacklist_clients: false
bonjour:
additional_vlan_ids: 10, 20
enabled: false
services:
airplay:
radius_groups:
- teachers
scope: same_ap
client_limit_down: 1000
client_limit_down_enabled: false
client_limit_up: 512
client_limit_up_enabled: false
disable_11ax: false
disable_ht_vht_rates: false
disable_uapsd: false
disable_v1_roam_notify: false
disable_v2_roam_notify: false
disable_wmm: false
dynamic_vlan:
default_vlan_id: 999
enabled: false
local_vlan_ids:
- 1
type: airespace-interface-name
vlans:
'131': default
'322': fast,video
enable_local_keycaching: false
enable_wireless_bridging: false
enabled: true
fast_dot1x_timers: false
hide_ssid: false
hostname_ie: false
ssid: demo
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/wlan'
- description: '**Note**: portal_template will be forked out of wlan objects soon. To fetch portal_template, please query portal_template_url. To update portal_template, use Wlan Portal Template.'
examples:
- allow_ipv6_ndp: true
allow_mdns: false
allow_ssdp: false
arp_filter: false
band_steer: false
band_steer_force_band5: false
bands:
- '24'
- '5'
block_blacklist_clients: false
bonjour:
additional_vlan_ids: 10, 20
enabled: false
services:
airplay:
radius_groups:
- teachers
scope: same_ap
client_limit_down: 1000
client_limit_down_enabled: false
client_limit_up: 512
client_limit_up_enabled: false
disable_11ax: false
disable_ht_vht_rates: false
disable_uapsd: false
disable_v1_roam_notify: false
disable_v2_roam_notify: false
disable_wmm: false
dynamic_vlan:
default_vlan_id: 999
enabled: false
local_vlan_ids:
- 1
type: airespace-interface-name
vlans:
'131': default
'322': fast,video
enable_local_keycaching: false
enable_wireless_bridging: false
enabled: true
fast_dot1x_timers: false
hide_ssid: false
hostname_ie: false
ssid: demo
contentMediaType: application/vnd.api+json
examples:
Example:
value:
allow_ipv6_ndp: true
allow_mdns: false
allow_ssdp: false
arp_filter: false
band_steer: false
band_steer_force_band5: false
bands:
- '24'
- '5'
block_blacklist_clients: false
bonjour:
additional_vlan_ids: 10, 20
enabled: false
services:
airplay:
radius_groups:
- teachers
scope: same_ap
client_limit_down: 1000
client_limit_down_enabled: false
client_limit_up: 512
client_limit_up_enabled: false
disable_11ax: false
disable_ht_vht_rates: false
disable_uapsd: false
disable_v1_roam_notify: false
disable_v2_roam_notify: false
disable_wmm: false
dynamic_vlan:
default_vlan_id: 999
enabled: false
local_vlan_ids:
- 1
type: airespace-interface-name
vlans:
'131': default
'322': fast,video
enable_local_keycaching: false
enable_wireless_bridging: false
enabled: true
fast_dot1x_timers: false
hide_ssid: false
hostname_ie: false
ssid: demo
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/wlans/{wlan_id}/portal_image:
delete:
tags:
- Sites Wlans
summary: deleteSiteWlanPortalImage
description: Delete Site WLAN Portal Image
operationId: deleteSiteWlanPortalImage
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: wlan_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Sites Wlans
summary: uploadSiteWlanPortalImage
description: WLAN Portal Image Upload
operationId: uploadSiteWlanPortalImage
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: wlan_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
content:
multipart/form-data:
encoding: {}
schema:
required:
- file
type: object
properties:
file:
type: string
description: Image file content uploaded as multipart form data
contentEncoding: base64
json:
type: string
description: Optional JSON metadata submitted with the image upload
contentMediaType: multipart/form-data
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/wlans/{wlan_id}/portal_template:
put:
tags:
- Sites Wlans
summary: updateSiteWlanPortalTemplate
description: >-
Update a Portal Template
#### Sponsor Email Template
Sponsor Email Template supports following template variables:
| **Name** | **Description** |
| --- | --- |
| approve_url | Renders URL to approve the request; optionally &minutes=N query param can be appended to change the Authorization period of the guest, where N is a valid integer denoting number of minutes a guest remains authorized |
| deny_url | Renders URL to reject the request |
| guest_email | Renders Email ID of the guest |
| guest_name | Renders Name of the guest |
| field1 | Renders value of the Custom Field 1 |
| field2 | Renders value of the Custom Field 2 |
| company | Renders value of the Company field |
| sponsor_link_validity_duration | Renders validity time of the request (i.e. Approve/Deny URL) |
| auth_expire_minutes | Renders Wlan-level configured Guest Authorization Expiration time period (in minutes), If not configured then default (1 day in minutes) |
operationId: updateSiteWlanPortalTemplate
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: wlan_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/wlan_portal_template'
- description: Request Body
examples:
- portal_template:
accessCodeAlternateEmail: string
alignment: left
authButtonAmazon: string
authButtonAzure: string
authButtonEmail: string
authButtonFacebook: string
authButtonGoogle: string
authButtonMicrosoft: string
authButtonPassphrase: string
authButtonSms: string
authButtonSponsor: string
authLabel: string
backLink: string
color: string
colorDark: string
colorLight: string
company: true
companyError: string
companyLabel: string
email: true
emailAccessDomainError: string
emailCancel: string
emailCodeError: string
emailError: string
emailFieldLabel: string
emailLabel: string
emailMessage: string
emailSubmit: string
emailTitle: string
field1: true
field1Error: string
field1Label: string
field1Required: true
field2: true
field2Error: string
field2Label: string
field2Required: true
field3: true
field3Error: string
field3Label: string
field3Required: true
field4: true
field4Error: string
field4Label: string
field4Required: true
message: string
name: true
nameError: string
nameLabel: string
optout: true
optoutLabel: string
pageTitle: string
passphraseCancel: string
passphraseError: string
passphraseLabel: string
passphraseMessage: string
passphraseSubmit: string
passphraseTitle: string
poweredBy: true
requiredFieldLabel: string
signInLabel: string
smsCarrierDefault: string
smsCarrierError: string
smsCarrierFieldLabel: string
smsCodeCancel: string
smsCodeError: string
smsCodeFieldLabel: string
smsCodeMessage: string
smsCodeSubmit: string
smsCodeTitle: string
smsCountryFieldLabel: string
smsCountryFormat: string
smsHaveAccessCode: string
smsMessageFormat: string
smsNumberCancel: string
smsNumberError: string
smsNumberFieldLabel: string
smsNumberFormat: string
smsNumberMessage: string
smsNumberSubmit: string
smsNumberTitle: string
smsUsernameFormat: string
smsValidityDuration: 30
sponsorBackLink: string
sponsorCancel: string
sponsorEmail: string
sponsorEmailError: string
sponsorEmailTemplate: string
sponsorInfoApproved: string
sponsorInfoDenied: string
sponsorInfoPending: string
sponsorName: string
sponsorNameError: string
sponsorNotePending: string
sponsorStatusApproved: string
sponsorStatusDenied: string
sponsorStatusPending: string
sponsorSubmit: string
sponsorsFieldLabel: string
tos: true
tosAcceptLabel: string
tosError: string
tosLink: string
tosText: string
contentMediaType: application/json
examples:
Example:
value:
portal_template:
accessCodeAlternateEmail: string
alignment: left
authButtonAmazon: string
authButtonAzure: string
authButtonEmail: string
authButtonFacebook: string
authButtonGoogle: string
authButtonMicrosoft: string
authButtonPassphrase: string
authButtonSms: string
authButtonSponsor: string
authLabel: string
backLink: string
color: string
colorDark: string
colorLight: string
company: true
companyError: string
companyLabel: string
email: true
emailAccessDomainError: string
emailCancel: string
emailCodeError: string
emailError: string
emailFieldLabel: string
emailLabel: string
emailMessage: string
emailSubmit: string
emailTitle: string
field1: true
field1Error: string
field1Label: string
field1Required: true
field2: true
field2Error: string
field2Label: string
field2Required: true
field3: true
field3Error: string
field3Label: string
field3Required: true
field4: true
field4Error: string
field4Label: string
field4Required: true
message: string
name: true
nameError: string
nameLabel: string
optout: true
optoutLabel: string
pageTitle: string
passphraseCancel: string
passphraseError: string
passphraseLabel: string
passphraseMessage: string
passphraseSubmit: string
passphraseTitle: string
poweredBy: true
requiredFieldLabel: string
signInLabel: string
smsCarrierDefault: string
smsCarrierError: string
smsCarrierFieldLabel: string
smsCodeCancel: string
smsCodeError: string
smsCodeFieldLabel: string
smsCodeMessage: string
smsCodeSubmit: string
smsCodeTitle: string
smsCountryFieldLabel: string
smsCountryFormat: string
smsHaveAccessCode: string
smsMessageFormat: string
smsNumberCancel: string
smsNumberError: string
smsNumberFieldLabel: string
smsNumberFormat: string
smsNumberMessage: string
smsNumberSubmit: string
smsNumberTitle: string
smsUsernameFormat: string
smsValidityDuration: 30
sponsorBackLink: string
sponsorCancel: string
sponsorEmail: string
sponsorEmailError: string
sponsorEmailTemplate: string
sponsorInfoApproved: string
sponsorInfoDenied: string
sponsorInfoPending: string
sponsorName: string
sponsorNameError: string
sponsorNotePending: string
sponsorStatusApproved: string
sponsorStatusDenied: string
sponsorStatusPending: string
sponsorSubmit: string
sponsorsFieldLabel: string
tos: true
tosAcceptLabel: string
tosError: string
tosLink: string
tosText: string
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/wlan_portal_template'
- description: Guest portal template payload for a WLAN
examples:
- portal_template:
accessCodeAlternateEmail: string
alignment: left
authButtonAmazon: string
authButtonAzure: string
authButtonEmail: string
authButtonFacebook: string
authButtonGoogle: string
authButtonMicrosoft: string
authButtonPassphrase: string
authButtonSms: string
authButtonSponsor: string
authLabel: string
backLink: string
color: string
colorDark: string
colorLight: string
company: true
companyError: string
companyLabel: string
email: true
emailAccessDomainError: string
emailCancel: string
emailCodeError: string
emailError: string
emailFieldLabel: string
emailLabel: string
emailMessage: string
emailSubmit: string
emailTitle: string
field1: true
field1Error: string
field1Label: string
field1Required: true
field2: true
field2Error: string
field2Label: string
field2Required: true
field3: true
field3Error: string
field3Label: string
field3Required: true
field4: true
field4Error: string
field4Label: string
field4Required: true
message: string
name: true
nameError: string
nameLabel: string
optout: true
optoutLabel: string
pageTitle: string
passphraseCancel: string
passphraseError: string
passphraseLabel: string
passphraseMessage: string
passphraseSubmit: string
passphraseTitle: string
poweredBy: true
requiredFieldLabel: string
signInLabel: string
smsCarrierDefault: string
smsCarrierError: string
smsCarrierFieldLabel: string
smsCodeCancel: string
smsCodeError: string
smsCodeFieldLabel: string
smsCodeMessage: string
smsCodeSubmit: string
smsCodeTitle: string
smsCountryFieldLabel: string
smsCountryFormat: string
smsHaveAccessCode: string
smsMessageFormat: string
smsNumberCancel: string
smsNumberError: string
smsNumberFieldLabel: string
smsNumberFormat: string
smsNumberMessage: string
smsNumberSubmit: string
smsNumberTitle: string
smsUsernameFormat: string
smsValidityDuration: 5
sponsorBackLink: string
sponsorCancel: string
sponsorEmail: string
sponsorEmailError: string
sponsorEmailTemplate: string
sponsorInfoApproved: string
sponsorInfoDenied: string
sponsorInfoPending: string
sponsorName: string
sponsorNameError: string
sponsorNotePending: string
sponsorStatusApproved: string
sponsorStatusDenied: string
sponsorStatusPending: string
sponsorSubmit: string
tos: true
tosAcceptLabel: string
tosError: string
tosLink: string
tosText: string
contentMediaType: application/json
examples:
Example:
value:
portal_template:
accessCodeAlternateEmail: string
alignment: left
authButtonAmazon: string
authButtonAzure: string
authButtonEmail: string
authButtonFacebook: string
authButtonGoogle: string
authButtonMicrosoft: string
authButtonPassphrase: string
authButtonSms: string
authButtonSponsor: string
authLabel: string
backLink: string
color: string
colorDark: string
colorLight: string
company: true
companyError: string
companyLabel: string
email: true
emailAccessDomainError: string
emailCancel: string
emailCodeError: string
emailError: string
emailFieldLabel: string
emailLabel: string
emailMessage: string
emailSubmit: string
emailTitle: string
field1: true
field1Error: string
field1Label: string
field1Required: true
field2: true
field2Error: string
field2Label: string
field2Required: true
field3: true
field3Error: string
field3Label: string
field3Required: true
field4: true
field4Error: string
field4Label: string
field4Required: true
message: string
name: true
nameError: string
nameLabel: string
optout: true
optoutLabel: string
pageTitle: string
passphraseCancel: string
passphraseError: string
passphraseLabel: string
passphraseMessage: string
passphraseSubmit: string
passphraseTitle: string
poweredBy: true
requiredFieldLabel: string
signInLabel: string
smsCarrierDefault: string
smsCarrierError: string
smsCarrierFieldLabel: string
smsCodeCancel: string
smsCodeError: string
smsCodeFieldLabel: string
smsCodeMessage: string
smsCodeSubmit: string
smsCodeTitle: string
smsCountryFieldLabel: string
smsCountryFormat: string
smsHaveAccessCode: string
smsMessageFormat: string
smsNumberCancel: string
smsNumberError: string
smsNumberFieldLabel: string
smsNumberFormat: string
smsNumberMessage: string
smsNumberSubmit: string
smsNumberTitle: string
smsUsernameFormat: string
smsValidityDuration: 5
sponsorBackLink: string
sponsorCancel: string
sponsorEmail: string
sponsorEmailError: string
sponsorEmailTemplate: string
sponsorInfoApproved: string
sponsorInfoDenied: string
sponsorInfoPending: string
sponsorName: string
sponsorNameError: string
sponsorNotePending: string
sponsorStatusApproved: string
sponsorStatusDenied: string
sponsorStatusPending: string
sponsorSubmit: string
tos: true
tosAcceptLabel: string
tosError: string
tosLink: string
tosText: string
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/wlan_portal_template'
- description: Guest portal template payload for a WLAN
examples:
- portal_template:
accessCodeAlternateEmail: string
alignment: left
authButtonAmazon: string
authButtonAzure: string
authButtonEmail: string
authButtonFacebook: string
authButtonGoogle: string
authButtonMicrosoft: string
authButtonPassphrase: string
authButtonSms: string
authButtonSponsor: string
authLabel: string
backLink: string
color: string
colorDark: string
colorLight: string
company: true
companyError: string
companyLabel: string
email: true
emailAccessDomainError: string
emailCancel: string
emailCodeError: string
emailError: string
emailFieldLabel: string
emailLabel: string
emailMessage: string
emailSubmit: string
emailTitle: string
field1: true
field1Error: string
field1Label: string
field1Required: true
field2: true
field2Error: string
field2Label: string
field2Required: true
field3: true
field3Error: string
field3Label: string
field3Required: true
field4: true
field4Error: string
field4Label: string
field4Required: true
message: string
name: true
nameError: string
nameLabel: string
optout: true
optoutLabel: string
pageTitle: string
passphraseCancel: string
passphraseError: string
passphraseLabel: string
passphraseMessage: string
passphraseSubmit: string
passphraseTitle: string
poweredBy: true
requiredFieldLabel: string
signInLabel: string
smsCarrierDefault: string
smsCarrierError: string
smsCarrierFieldLabel: string
smsCodeCancel: string
smsCodeError: string
smsCodeFieldLabel: string
smsCodeMessage: string
smsCodeSubmit: string
smsCodeTitle: string
smsCountryFieldLabel: string
smsCountryFormat: string
smsHaveAccessCode: string
smsMessageFormat: string
smsNumberCancel: string
smsNumberError: string
smsNumberFieldLabel: string
smsNumberFormat: string
smsNumberMessage: string
smsNumberSubmit: string
smsNumberTitle: string
smsUsernameFormat: string
smsValidityDuration: 5
sponsorBackLink: string
sponsorCancel: string
sponsorEmail: string
sponsorEmailError: string
sponsorEmailTemplate: string
sponsorInfoApproved: string
sponsorInfoDenied: string
sponsorInfoPending: string
sponsorName: string
sponsorNameError: string
sponsorNotePending: string
sponsorStatusApproved: string
sponsorStatusDenied: string
sponsorStatusPending: string
sponsorSubmit: string
tos: true
tosAcceptLabel: string
tosError: string
tosLink: string
tosText: string
contentMediaType: application/vnd.api+json
examples:
Example:
value:
portal_template:
accessCodeAlternateEmail: string
alignment: left
authButtonAmazon: string
authButtonAzure: string
authButtonEmail: string
authButtonFacebook: string
authButtonGoogle: string
authButtonMicrosoft: string
authButtonPassphrase: string
authButtonSms: string
authButtonSponsor: string
authLabel: string
backLink: string
color: string
colorDark: string
colorLight: string
company: true
companyError: string
companyLabel: string
email: true
emailAccessDomainError: string
emailCancel: string
emailCodeError: string
emailError: string
emailFieldLabel: string
emailLabel: string
emailMessage: string
emailSubmit: string
emailTitle: string
field1: true
field1Error: string
field1Label: string
field1Required: true
field2: true
field2Error: string
field2Label: string
field2Required: true
field3: true
field3Error: string
field3Label: string
field3Required: true
field4: true
field4Error: string
field4Label: string
field4Required: true
message: string
name: true
nameError: string
nameLabel: string
optout: true
optoutLabel: string
pageTitle: string
passphraseCancel: string
passphraseError: string
passphraseLabel: string
passphraseMessage: string
passphraseSubmit: string
passphraseTitle: string
poweredBy: true
requiredFieldLabel: string
signInLabel: string
smsCarrierDefault: string
smsCarrierError: string
smsCarrierFieldLabel: string
smsCodeCancel: string
smsCodeError: string
smsCodeFieldLabel: string
smsCodeMessage: string
smsCodeSubmit: string
smsCodeTitle: string
smsCountryFieldLabel: string
smsCountryFormat: string
smsHaveAccessCode: string
smsMessageFormat: string
smsNumberCancel: string
smsNumberError: string
smsNumberFieldLabel: string
smsNumberFormat: string
smsNumberMessage: string
smsNumberSubmit: string
smsNumberTitle: string
smsUsernameFormat: string
smsValidityDuration: 5
sponsorBackLink: string
sponsorCancel: string
sponsorEmail: string
sponsorEmailError: string
sponsorEmailTemplate: string
sponsorInfoApproved: string
sponsorInfoDenied: string
sponsorInfoPending: string
sponsorName: string
sponsorNameError: string
sponsorNotePending: string
sponsorStatusApproved: string
sponsorStatusDenied: string
sponsorStatusPending: string
sponsorSubmit: string
tos: true
tosAcceptLabel: string
tosError: string
tosLink: string
tosText: string
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/wxrules:
get:
tags:
- Sites WxRules
summary: listSiteWxRules
description: Get List of Site WxLan Rules
operationId: listSiteWxRules
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: List of WxRules
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/wxlan_rule'
description: WxLAN policy rules returned by a list response
examples:
- - action: allow
apply_tags:
- c049dfcd-0c73-5014-1c64-062e9903f1e5
blocked_apps:
- mist
- all-videos
created_time: 0
dst_allow_wxtags:
- fff34466-eec0-3756-6765-381c728a6037
- eee2c7b0-d1d0-5a30-f349-e35fa43dc3b3
dst_deny_wxtags:
- aaa34466-eec0-3756-6765-381c728a6037
- bbb2c7b0-d1d0-5a30-f349-e35fa43dc3b3
enabled: true
for_site: true
id: 497f6eca-6276-4993-bfeb-53ebbbba6f08
modified_time: 0
order: 1
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
src_wxtags:
- 8bfc2490-d726-3587-038d-cb2e71bd2330
- 3aa8e73f-9f46-d827-8d6a-567bb7e67fc9
contentMediaType: application/json
examples:
Example:
value:
- action: allow
apply_tags:
- c049dfcd-0c73-5014-1c64-062e9903f1e5
blocked_apps:
- mist
- all-videos
created_time: 0
dst_allow_wxtags:
- fff34466-eec0-3756-6765-381c728a6037
- eee2c7b0-d1d0-5a30-f349-e35fa43dc3b3
dst_deny_wxtags:
- aaa34466-eec0-3756-6765-381c728a6037
- bbb2c7b0-d1d0-5a30-f349-e35fa43dc3b3
enabled: true
for_site: true
id: 497f6eca-6276-4993-bfeb-53ebbbba6f08
modified_time: 0
order: 1
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
src_wxtags:
- 8bfc2490-d726-3587-038d-cb2e71bd2330
- 3aa8e73f-9f46-d827-8d6a-567bb7e67fc9
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/wxlan_rule'
description: WxLAN policy rules returned by a list response
examples:
- - action: allow
apply_tags:
- c049dfcd-0c73-5014-1c64-062e9903f1e5
blocked_apps:
- mist
- all-videos
created_time: 0
dst_allow_wxtags:
- fff34466-eec0-3756-6765-381c728a6037
- eee2c7b0-d1d0-5a30-f349-e35fa43dc3b3
dst_deny_wxtags:
- aaa34466-eec0-3756-6765-381c728a6037
- bbb2c7b0-d1d0-5a30-f349-e35fa43dc3b3
enabled: true
for_site: true
id: 497f6eca-6276-4993-bfeb-53ebbbba6f08
modified_time: 0
order: 1
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
src_wxtags:
- 8bfc2490-d726-3587-038d-cb2e71bd2330
- 3aa8e73f-9f46-d827-8d6a-567bb7e67fc9
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- action: allow
apply_tags:
- c049dfcd-0c73-5014-1c64-062e9903f1e5
blocked_apps:
- mist
- all-videos
created_time: 0
dst_allow_wxtags:
- fff34466-eec0-3756-6765-381c728a6037
- eee2c7b0-d1d0-5a30-f349-e35fa43dc3b3
dst_deny_wxtags:
- aaa34466-eec0-3756-6765-381c728a6037
- bbb2c7b0-d1d0-5a30-f349-e35fa43dc3b3
enabled: true
for_site: true
id: 497f6eca-6276-4993-bfeb-53ebbbba6f08
modified_time: 0
order: 1
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
src_wxtags:
- 8bfc2490-d726-3587-038d-cb2e71bd2330
- 3aa8e73f-9f46-d827-8d6a-567bb7e67fc9
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Sites WxRules
summary: createSiteWxRule
description: Create Site WxLan Rule
operationId: createSiteWxRule
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/wxlan_rule'
- description: Request Body
examples:
- action: allow
apply_tags:
- c049dfcd-0c73-5014-1c64-062e9903f1e5
blocked_apps:
- mist
- all-videos
dst_allow_wxtags:
- fff34466-eec0-3756-6765-381c728a6037
- eee2c7b0-d1d0-5a30-f349-e35fa43dc3b3
dst_deny_wxtags:
- aaa34466-eec0-3756-6765-381c728a6037
- bbb2c7b0-d1d0-5a30-f349-e35fa43dc3b3
enabled: true
order: 1
src_wxtags:
- 8bfc2490-d726-3587-038d-cb2e71bd2330
- 3aa8e73f-9f46-d827-8d6a-567bb7e67fc9
contentMediaType: application/json
examples:
Example:
value:
action: allow
apply_tags:
- c049dfcd-0c73-5014-1c64-062e9903f1e5
blocked_apps:
- mist
- all-videos
dst_allow_wxtags:
- fff34466-eec0-3756-6765-381c728a6037
- eee2c7b0-d1d0-5a30-f349-e35fa43dc3b3
dst_deny_wxtags:
- aaa34466-eec0-3756-6765-381c728a6037
- bbb2c7b0-d1d0-5a30-f349-e35fa43dc3b3
enabled: true
order: 1
src_wxtags:
- 8bfc2490-d726-3587-038d-cb2e71bd2330
- 3aa8e73f-9f46-d827-8d6a-567bb7e67fc9
required: false
responses:
'200':
description: Wrule
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/wxlan_rule'
- description: WxLAN policy rule controlling traffic between WxLAN tags
examples:
- action: allow
apply_tags:
- c049dfcd-0c73-5014-1c64-062e9903f1e5
blocked_apps:
- mist
- all-videos
created_time: 0
dst_allow_wxtags:
- fff34466-eec0-3756-6765-381c728a6037
- eee2c7b0-d1d0-5a30-f349-e35fa43dc3b3
dst_deny_wxtags:
- aaa34466-eec0-3756-6765-381c728a6037
- bbb2c7b0-d1d0-5a30-f349-e35fa43dc3b3
enabled: true
for_site: true
id: 497f6eca-6276-4993-9feb-53cbbbba6f08
modified_time: 0
order: 1
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
src_wxtags:
- 8bfc2490-d726-3587-038d-cb2e71bd2330
- 3aa8e73f-9f46-d827-8d6a-567bb7e67fc9
contentMediaType: application/json
examples:
Example:
value:
action: allow
apply_tags:
- c049dfcd-0c73-5014-1c64-062e9903f1e5
blocked_apps:
- mist
- all-videos
created_time: 0
dst_allow_wxtags:
- fff34466-eec0-3756-6765-381c728a6037
- eee2c7b0-d1d0-5a30-f349-e35fa43dc3b3
dst_deny_wxtags:
- aaa34466-eec0-3756-6765-381c728a6037
- bbb2c7b0-d1d0-5a30-f349-e35fa43dc3b3
enabled: true
for_site: true
id: 497f6eca-6276-4993-9feb-53cbbbba6f08
modified_time: 0
order: 1
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
src_wxtags:
- 8bfc2490-d726-3587-038d-cb2e71bd2330
- 3aa8e73f-9f46-d827-8d6a-567bb7e67fc9
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/wxlan_rule'
- description: WxLAN policy rule controlling traffic between WxLAN tags
examples:
- action: allow
apply_tags:
- c049dfcd-0c73-5014-1c64-062e9903f1e5
blocked_apps:
- mist
- all-videos
created_time: 0
dst_allow_wxtags:
- fff34466-eec0-3756-6765-381c728a6037
- eee2c7b0-d1d0-5a30-f349-e35fa43dc3b3
dst_deny_wxtags:
- aaa34466-eec0-3756-6765-381c728a6037
- bbb2c7b0-d1d0-5a30-f349-e35fa43dc3b3
enabled: true
for_site: true
id: 497f6eca-6276-4993-9feb-53cbbbba6f08
modified_time: 0
order: 1
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
src_wxtags:
- 8bfc2490-d726-3587-038d-cb2e71bd2330
- 3aa8e73f-9f46-d827-8d6a-567bb7e67fc9
contentMediaType: application/vnd.api+json
examples:
Example:
value:
action: allow
apply_tags:
- c049dfcd-0c73-5014-1c64-062e9903f1e5
blocked_apps:
- mist
- all-videos
created_time: 0
dst_allow_wxtags:
- fff34466-eec0-3756-6765-381c728a6037
- eee2c7b0-d1d0-5a30-f349-e35fa43dc3b3
dst_deny_wxtags:
- aaa34466-eec0-3756-6765-381c728a6037
- bbb2c7b0-d1d0-5a30-f349-e35fa43dc3b3
enabled: true
for_site: true
id: 497f6eca-6276-4993-9feb-53cbbbba6f08
modified_time: 0
order: 1
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
src_wxtags:
- 8bfc2490-d726-3587-038d-cb2e71bd2330
- 3aa8e73f-9f46-d827-8d6a-567bb7e67fc9
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/wxrules/derived:
get:
tags:
- Sites WxRules
summary: ListSiteWxRulesDerived
description: Get the list of derived WxLan Rule for a site
operationId: ListSiteWxRulesDerived
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: List of WxRules
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/wxlan_rule'
description: WxLAN policy rules returned by a list response
examples:
- - action: allow
apply_tags:
- c049dfcd-0c73-5014-1c64-062e9903f1e5
blocked_apps:
- mist
- all-videos
created_time: 0
dst_allow_wxtags:
- fff34466-eec0-3756-6765-381c728a6037
- eee2c7b0-d1d0-5a30-f349-e35fa43dc3b3
dst_deny_wxtags:
- aaa34466-eec0-3756-6765-381c728a6037
- bbb2c7b0-d1d0-5a30-f349-e35fa43dc3b3
enabled: true
for_site: true
id: 497f6eca-6276-4993-bfeb-53ebbbba6f08
modified_time: 0
order: 1
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
src_wxtags:
- 8bfc2490-d726-3587-038d-cb2e71bd2330
- 3aa8e73f-9f46-d827-8d6a-567bb7e67fc9
contentMediaType: application/json
examples:
Example:
value:
- action: allow
apply_tags:
- c049dfcd-0c73-5014-1c64-062e9903f1e5
blocked_apps:
- mist
- all-videos
created_time: 0
dst_allow_wxtags:
- fff34466-eec0-3756-6765-381c728a6037
- eee2c7b0-d1d0-5a30-f349-e35fa43dc3b3
dst_deny_wxtags:
- aaa34466-eec0-3756-6765-381c728a6037
- bbb2c7b0-d1d0-5a30-f349-e35fa43dc3b3
enabled: true
for_site: true
id: 497f6eca-6276-4993-bfeb-53ebbbba6f08
modified_time: 0
order: 1
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
src_wxtags:
- 8bfc2490-d726-3587-038d-cb2e71bd2330
- 3aa8e73f-9f46-d827-8d6a-567bb7e67fc9
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/wxlan_rule'
description: WxLAN policy rules returned by a list response
examples:
- - action: allow
apply_tags:
- c049dfcd-0c73-5014-1c64-062e9903f1e5
blocked_apps:
- mist
- all-videos
created_time: 0
dst_allow_wxtags:
- fff34466-eec0-3756-6765-381c728a6037
- eee2c7b0-d1d0-5a30-f349-e35fa43dc3b3
dst_deny_wxtags:
- aaa34466-eec0-3756-6765-381c728a6037
- bbb2c7b0-d1d0-5a30-f349-e35fa43dc3b3
enabled: true
for_site: true
id: 497f6eca-6276-4993-bfeb-53ebbbba6f08
modified_time: 0
order: 1
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
src_wxtags:
- 8bfc2490-d726-3587-038d-cb2e71bd2330
- 3aa8e73f-9f46-d827-8d6a-567bb7e67fc9
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- action: allow
apply_tags:
- c049dfcd-0c73-5014-1c64-062e9903f1e5
blocked_apps:
- mist
- all-videos
created_time: 0
dst_allow_wxtags:
- fff34466-eec0-3756-6765-381c728a6037
- eee2c7b0-d1d0-5a30-f349-e35fa43dc3b3
dst_deny_wxtags:
- aaa34466-eec0-3756-6765-381c728a6037
- bbb2c7b0-d1d0-5a30-f349-e35fa43dc3b3
enabled: true
for_site: true
id: 497f6eca-6276-4993-bfeb-53ebbbba6f08
modified_time: 0
order: 1
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
src_wxtags:
- 8bfc2490-d726-3587-038d-cb2e71bd2330
- 3aa8e73f-9f46-d827-8d6a-567bb7e67fc9
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/wxrules/{wxrule_id}:
delete:
tags:
- Sites WxRules
summary: deleteSiteWxRule
description: Delete Site WxLan Rule
operationId: deleteSiteWxRule
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: wxrule_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Sites WxRules
summary: getSiteWxRule
description: Get Site WxLan Rule Details
operationId: getSiteWxRule
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: wxrule_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: Wrule
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/wxlan_rule'
- description: WxLAN policy rule controlling traffic between WxLAN tags
examples:
- action: allow
apply_tags:
- c049dfcd-0c73-5014-1c64-062e9903f1e5
blocked_apps:
- mist
- all-videos
created_time: 0
dst_allow_wxtags:
- fff34466-eec0-3756-6765-381c728a6037
- eee2c7b0-d1d0-5a30-f349-e35fa43dc3b3
dst_deny_wxtags:
- aaa34466-eec0-3756-6765-381c728a6037
- bbb2c7b0-d1d0-5a30-f349-e35fa43dc3b3
enabled: true
for_site: true
id: 497f6eca-6276-4993-9feb-53cbbbba6f08
modified_time: 0
order: 1
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
src_wxtags:
- 8bfc2490-d726-3587-038d-cb2e71bd2330
- 3aa8e73f-9f46-d827-8d6a-567bb7e67fc9
contentMediaType: application/json
examples:
Example:
value:
action: allow
apply_tags:
- c049dfcd-0c73-5014-1c64-062e9903f1e5
blocked_apps:
- mist
- all-videos
created_time: 0
dst_allow_wxtags:
- fff34466-eec0-3756-6765-381c728a6037
- eee2c7b0-d1d0-5a30-f349-e35fa43dc3b3
dst_deny_wxtags:
- aaa34466-eec0-3756-6765-381c728a6037
- bbb2c7b0-d1d0-5a30-f349-e35fa43dc3b3
enabled: true
for_site: true
id: 497f6eca-6276-4993-9feb-53cbbbba6f08
modified_time: 0
order: 1
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
src_wxtags:
- 8bfc2490-d726-3587-038d-cb2e71bd2330
- 3aa8e73f-9f46-d827-8d6a-567bb7e67fc9
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/wxlan_rule'
- description: WxLAN policy rule controlling traffic between WxLAN tags
examples:
- action: allow
apply_tags:
- c049dfcd-0c73-5014-1c64-062e9903f1e5
blocked_apps:
- mist
- all-videos
created_time: 0
dst_allow_wxtags:
- fff34466-eec0-3756-6765-381c728a6037
- eee2c7b0-d1d0-5a30-f349-e35fa43dc3b3
dst_deny_wxtags:
- aaa34466-eec0-3756-6765-381c728a6037
- bbb2c7b0-d1d0-5a30-f349-e35fa43dc3b3
enabled: true
for_site: true
id: 497f6eca-6276-4993-9feb-53cbbbba6f08
modified_time: 0
order: 1
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
src_wxtags:
- 8bfc2490-d726-3587-038d-cb2e71bd2330
- 3aa8e73f-9f46-d827-8d6a-567bb7e67fc9
contentMediaType: application/vnd.api+json
examples:
Example:
value:
action: allow
apply_tags:
- c049dfcd-0c73-5014-1c64-062e9903f1e5
blocked_apps:
- mist
- all-videos
created_time: 0
dst_allow_wxtags:
- fff34466-eec0-3756-6765-381c728a6037
- eee2c7b0-d1d0-5a30-f349-e35fa43dc3b3
dst_deny_wxtags:
- aaa34466-eec0-3756-6765-381c728a6037
- bbb2c7b0-d1d0-5a30-f349-e35fa43dc3b3
enabled: true
for_site: true
id: 497f6eca-6276-4993-9feb-53cbbbba6f08
modified_time: 0
order: 1
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
src_wxtags:
- 8bfc2490-d726-3587-038d-cb2e71bd2330
- 3aa8e73f-9f46-d827-8d6a-567bb7e67fc9
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Sites WxRules
summary: updateSiteWxRule
description: Update Site WxLan Rule
operationId: updateSiteWxRule
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: wxrule_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/wxlan_rule'
- description: Request Body
examples:
- action: allow
apply_tags:
- c049dfcd-0c73-5014-1c64-062e9903f1e5
blocked_apps:
- mist
- all-videos
dst_allow_wxtags:
- fff34466-eec0-3756-6765-381c728a6037
- eee2c7b0-d1d0-5a30-f349-e35fa43dc3b3
dst_deny_wxtags:
- aaa34466-eec0-3756-6765-381c728a6037
- bbb2c7b0-d1d0-5a30-f349-e35fa43dc3b3
enabled: true
order: 1
src_wxtags:
- 8bfc2490-d726-3587-038d-cb2e71bd2330
- 3aa8e73f-9f46-d827-8d6a-567bb7e67fc9
contentMediaType: application/json
examples:
Example:
value:
action: allow
apply_tags:
- c049dfcd-0c73-5014-1c64-062e9903f1e5
blocked_apps:
- mist
- all-videos
dst_allow_wxtags:
- fff34466-eec0-3756-6765-381c728a6037
- eee2c7b0-d1d0-5a30-f349-e35fa43dc3b3
dst_deny_wxtags:
- aaa34466-eec0-3756-6765-381c728a6037
- bbb2c7b0-d1d0-5a30-f349-e35fa43dc3b3
enabled: true
order: 1
src_wxtags:
- 8bfc2490-d726-3587-038d-cb2e71bd2330
- 3aa8e73f-9f46-d827-8d6a-567bb7e67fc9
required: false
responses:
'200':
description: Wrule
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/wxlan_rule'
- description: WxLAN policy rule controlling traffic between WxLAN tags
examples:
- action: allow
apply_tags:
- c049dfcd-0c73-5014-1c64-062e9903f1e5
blocked_apps:
- mist
- all-videos
created_time: 0
dst_allow_wxtags:
- fff34466-eec0-3756-6765-381c728a6037
- eee2c7b0-d1d0-5a30-f349-e35fa43dc3b3
dst_deny_wxtags:
- aaa34466-eec0-3756-6765-381c728a6037
- bbb2c7b0-d1d0-5a30-f349-e35fa43dc3b3
enabled: true
for_site: true
id: 497f6eca-6276-4993-9feb-53cbbbba6f08
modified_time: 0
order: 1
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
src_wxtags:
- 8bfc2490-d726-3587-038d-cb2e71bd2330
- 3aa8e73f-9f46-d827-8d6a-567bb7e67fc9
contentMediaType: application/json
examples:
Example:
value:
action: allow
apply_tags:
- c049dfcd-0c73-5014-1c64-062e9903f1e5
blocked_apps:
- mist
- all-videos
created_time: 0
dst_allow_wxtags:
- fff34466-eec0-3756-6765-381c728a6037
- eee2c7b0-d1d0-5a30-f349-e35fa43dc3b3
dst_deny_wxtags:
- aaa34466-eec0-3756-6765-381c728a6037
- bbb2c7b0-d1d0-5a30-f349-e35fa43dc3b3
enabled: true
for_site: true
id: 497f6eca-6276-4993-9feb-53cbbbba6f08
modified_time: 0
order: 1
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
src_wxtags:
- 8bfc2490-d726-3587-038d-cb2e71bd2330
- 3aa8e73f-9f46-d827-8d6a-567bb7e67fc9
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/wxlan_rule'
- description: WxLAN policy rule controlling traffic between WxLAN tags
examples:
- action: allow
apply_tags:
- c049dfcd-0c73-5014-1c64-062e9903f1e5
blocked_apps:
- mist
- all-videos
created_time: 0
dst_allow_wxtags:
- fff34466-eec0-3756-6765-381c728a6037
- eee2c7b0-d1d0-5a30-f349-e35fa43dc3b3
dst_deny_wxtags:
- aaa34466-eec0-3756-6765-381c728a6037
- bbb2c7b0-d1d0-5a30-f349-e35fa43dc3b3
enabled: true
for_site: true
id: 497f6eca-6276-4993-9feb-53cbbbba6f08
modified_time: 0
order: 1
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
src_wxtags:
- 8bfc2490-d726-3587-038d-cb2e71bd2330
- 3aa8e73f-9f46-d827-8d6a-567bb7e67fc9
contentMediaType: application/vnd.api+json
examples:
Example:
value:
action: allow
apply_tags:
- c049dfcd-0c73-5014-1c64-062e9903f1e5
blocked_apps:
- mist
- all-videos
created_time: 0
dst_allow_wxtags:
- fff34466-eec0-3756-6765-381c728a6037
- eee2c7b0-d1d0-5a30-f349-e35fa43dc3b3
dst_deny_wxtags:
- aaa34466-eec0-3756-6765-381c728a6037
- bbb2c7b0-d1d0-5a30-f349-e35fa43dc3b3
enabled: true
for_site: true
id: 497f6eca-6276-4993-9feb-53cbbbba6f08
modified_time: 0
order: 1
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
src_wxtags:
- 8bfc2490-d726-3587-038d-cb2e71bd2330
- 3aa8e73f-9f46-d827-8d6a-567bb7e67fc9
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/wxtags:
get:
tags:
- Sites WxTags
summary: listSiteWxTags
description: Get List of Site WxTags
operationId: listSiteWxTags
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/wxlan_tag'
description: WxLAN tag records returned by a list response
examples:
- - created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
last_ips:
- string
mac: string
match: wlan_id
modified_time: 0
name: string
op: in
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
resource_mac: string
services:
- string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
specs:
- port_range: string
protocol: tcp
subnets:
- string
subnet: string
type: match
values:
- string
contentMediaType: application/json
examples:
Example:
value:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
last_ips:
- string
mac: string
match: wlan_id
modified_time: 0
name: string
op: in
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
resource_mac: string
services:
- string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
specs:
- port_range: string
protocol: tcp
subnets:
- string
subnet: string
type: match
values:
- string
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/wxlan_tag'
description: WxLAN tag records returned by a list response
examples:
- - created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
last_ips:
- string
mac: string
match: wlan_id
modified_time: 0
name: string
op: in
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
resource_mac: string
services:
- string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
specs:
- port_range: string
protocol: tcp
subnets:
- string
subnet: string
type: match
values:
- string
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
last_ips:
- string
mac: string
match: wlan_id
modified_time: 0
name: string
op: in
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
resource_mac: string
services:
- string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
specs:
- port_range: string
protocol: tcp
subnets:
- string
subnet: string
type: match
values:
- string
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Sites WxTags
summary: createSiteWxTag
description: Create Site WxTag
operationId: createSiteWxTag
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/wxlan_tag'
- description: Request Body
examples:
- '{"match":"app","name":"match app","type":"match","values":["gmail","dropbox"]}'
- '{"match":"client_mac","name":"file_servers","type":"match","values":["b0c4e7001543","a0c4e7001543","00c4e7001543"]}'
- '{"match":"hostname","name":"mist","type":"match","values":["mist.com"]}'
- '{"match":"ip_range_subnet","name":"file_servers","type":"match","values":["10.1.2.1","10.2.3.4/24","10.1.2.5-10.2.3.4"]}'
- '{"match":"port","name":"web-ports","type":"match","values":["80","8000","8080"]}'
- '{"match":"psk_name","name":"VIP","type":"match","values":["test_key1","test_key2"]}'
- '{"match":"psk_role","name":"VIP","type":"match","values":["test_role"]}'
- '{"match":"radius_group","name":"VIP","type":"match","values":["vip"]}'
- '{"match":"radius_username","name":"VIP","type":"match","values":["john@abc.com","eric@abc.com"]}'
- '{"name":"protocol-subnet-port","specs":[{"port_range":"80","protocol":"tcp","subnets":["10.1.2.0/24"]}],"type":"spec"}'
- '{"name":"vlan-assignment","type":"vlan","vlan_id":1055}'
- '{"match":"wlan_id","name":"guest-wlan","type":"match","values":["be22bba78e22e1cf5185b880816fe2cf"]}'
contentMediaType: application/json
examples:
app:
value:
match: app
name: match app
type: match
values:
- gmail
- dropbox
client_mac:
value:
match: client_mac
name: file_servers
type: match
values:
- b0c4e7001543
- a0c4e7001543
- 00c4e7001543
hostnames:
value:
match: hostname
name: mist
type: match
values:
- mist.com
ip_range_subnets:
value:
match: ip_range_subnet
name: file_servers
type: match
values:
- 10.1.2.1
- 10.2.3.4/24
- 10.1.2.5-10.2.3.4
ports:
value:
match: port
name: web-ports
type: match
values:
- '80'
- '8000'
- '8080'
psk_name:
value:
match: psk_name
name: VIP
type: match
values:
- test_key1
- test_key2
psk_role:
value:
match: psk_role
name: VIP
type: match
values:
- test_role
radius_group:
value:
match: radius_group
name: VIP
type: match
values:
- vip
radius_username:
value:
match: radius_username
name: VIP
type: match
values:
- john@abc.com
- eric@abc.com
traffic-spec:
value:
name: protocol-subnet-port
specs:
- port_range: '80'
protocol: tcp
subnets:
- 10.1.2.0/24
type: spec
vlan:
value:
name: vlan-assignment
type: vlan
vlan_id: 1055
wlan_id:
value:
match: wlan_id
name: guest-wlan
type: match
values:
- be22bba78e22e1cf5185b880816fe2cf
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/wxlan_tag'
- description: >-
WxLAN Tag
* type:
* client: created manually (e.g. on wireless client table, when they spot a device of interest, they can create a wxlan tag for it
* resource: created automatically when we discover a network resource
* subnet: create automatically when a subnet is discovered
* match:
* wlan_id, ap_id: values are a list of Wlan / Device ids
* client_mac: values are a list of MAC addresses
* radius_group: this is a smart tag that matches RADIUS-Filter-ID, Airespace-ACL-Name (VendorID=14179, VendorType=6) / Aruba-User-Role (VendorID=14823, VendorType=1)
* radius_username: this matches the ATTR-User-Name(1)
* radius_class: the matches the ATTR-Class(25)
* radius_attr: the values are [ "6=1" , "26=10.2.3.4" ], this support other RADIUS attributes where we know the type
* radius_vendor: the values are [ "14179.10=1" , "14178.16=1.2.3.4" ], this matches vendor attributes and will be dynamically evaluated
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
last_ips:
- string
mac: string
match: wlan_id
modified_time: 0
name: string
op: in
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
resource_mac: string
services:
- string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
specs:
- port_range: string
protocol: tcp
subnets:
- string
subnet: string
type: match
values:
- string
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
last_ips:
- string
mac: string
match: wlan_id
modified_time: 0
name: string
op: in
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
resource_mac: string
services:
- string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
specs:
- port_range: string
protocol: tcp
subnets:
- string
subnet: string
type: match
values:
- string
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/wxlan_tag'
- description: >-
WxLAN Tag
* type:
* client: created manually (e.g. on wireless client table, when they spot a device of interest, they can create a wxlan tag for it
* resource: created automatically when we discover a network resource
* subnet: create automatically when a subnet is discovered
* match:
* wlan_id, ap_id: values are a list of Wlan / Device ids
* client_mac: values are a list of MAC addresses
* radius_group: this is a smart tag that matches RADIUS-Filter-ID, Airespace-ACL-Name (VendorID=14179, VendorType=6) / Aruba-User-Role (VendorID=14823, VendorType=1)
* radius_username: this matches the ATTR-User-Name(1)
* radius_class: the matches the ATTR-Class(25)
* radius_attr: the values are [ "6=1" , "26=10.2.3.4" ], this support other RADIUS attributes where we know the type
* radius_vendor: the values are [ "14179.10=1" , "14178.16=1.2.3.4" ], this matches vendor attributes and will be dynamically evaluated
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
last_ips:
- string
mac: string
match: wlan_id
modified_time: 0
name: string
op: in
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
resource_mac: string
services:
- string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
specs:
- port_range: string
protocol: tcp
subnets:
- string
subnet: string
type: match
values:
- string
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
last_ips:
- string
mac: string
match: wlan_id
modified_time: 0
name: string
op: in
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
resource_mac: string
services:
- string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
specs:
- port_range: string
protocol: tcp
subnets:
- string
subnet: string
type: match
values:
- string
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/wxtags/apps:
get:
tags:
- Sites WxTags
summary: getSiteApplicationList
description: Get Application List
operationId: getSiteApplicationList
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: List of Applications
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/search_wxtag_apps_item'
description: Applications that can be referenced by WxTag rules
examples:
- - group: Emails
key: gmail
name: Gmail - web/app
contentMediaType: application/json
examples:
Example:
value:
- group: Emails
key: gmail
name: Gmail - web/app
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/search_wxtag_apps_item'
description: Applications that can be referenced by WxTag rules
examples:
- - group: Emails
key: gmail
name: Gmail - web/app
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- group: Emails
key: gmail
name: Gmail - web/app
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/wxtags/{wxtag_id}:
delete:
tags:
- Sites WxTags
summary: deleteSiteWxTag
description: Delete Site WxTag
operationId: deleteSiteWxTag
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: wxtag_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Sites WxTags
summary: getSiteWxTag
description: Get Site WxTag Details
operationId: getSiteWxTag
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: wxtag_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/wxlan_tag'
- description: >-
WxLAN Tag
* type:
* client: created manually (e.g. on wireless client table, when they spot a device of interest, they can create a wxlan tag for it
* resource: created automatically when we discover a network resource
* subnet: create automatically when a subnet is discovered
* match:
* wlan_id, ap_id: values are a list of Wlan / Device ids
* client_mac: values are a list of MAC addresses
* radius_group: this is a smart tag that matches RADIUS-Filter-ID, Airespace-ACL-Name (VendorID=14179, VendorType=6) / Aruba-User-Role (VendorID=14823, VendorType=1)
* radius_username: this matches the ATTR-User-Name(1)
* radius_class: the matches the ATTR-Class(25)
* radius_attr: the values are [ "6=1" , "26=10.2.3.4" ], this support other RADIUS attributes where we know the type
* radius_vendor: the values are [ "14179.10=1" , "14178.16=1.2.3.4" ], this matches vendor attributes and will be dynamically evaluated
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
last_ips:
- string
mac: string
match: wlan_id
modified_time: 0
name: string
op: in
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
resource_mac: string
services:
- string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
specs:
- port_range: string
protocol: tcp
subnets:
- string
subnet: string
type: match
values:
- string
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
last_ips:
- string
mac: string
match: wlan_id
modified_time: 0
name: string
op: in
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
resource_mac: string
services:
- string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
specs:
- port_range: string
protocol: tcp
subnets:
- string
subnet: string
type: match
values:
- string
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/wxlan_tag'
- description: >-
WxLAN Tag
* type:
* client: created manually (e.g. on wireless client table, when they spot a device of interest, they can create a wxlan tag for it
* resource: created automatically when we discover a network resource
* subnet: create automatically when a subnet is discovered
* match:
* wlan_id, ap_id: values are a list of Wlan / Device ids
* client_mac: values are a list of MAC addresses
* radius_group: this is a smart tag that matches RADIUS-Filter-ID, Airespace-ACL-Name (VendorID=14179, VendorType=6) / Aruba-User-Role (VendorID=14823, VendorType=1)
* radius_username: this matches the ATTR-User-Name(1)
* radius_class: the matches the ATTR-Class(25)
* radius_attr: the values are [ "6=1" , "26=10.2.3.4" ], this support other RADIUS attributes where we know the type
* radius_vendor: the values are [ "14179.10=1" , "14178.16=1.2.3.4" ], this matches vendor attributes and will be dynamically evaluated
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
last_ips:
- string
mac: string
match: wlan_id
modified_time: 0
name: string
op: in
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
resource_mac: string
services:
- string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
specs:
- port_range: string
protocol: tcp
subnets:
- string
subnet: string
type: match
values:
- string
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
last_ips:
- string
mac: string
match: wlan_id
modified_time: 0
name: string
op: in
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
resource_mac: string
services:
- string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
specs:
- port_range: string
protocol: tcp
subnets:
- string
subnet: string
type: match
values:
- string
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Sites WxTags
summary: updateSiteWxTag
description: Update Site WxTag
operationId: updateSiteWxTag
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: wxtag_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/wxlan_tag'
- description: Request Body
examples:
- '{"match":"app","name":"match app","type":"match","values":["gmail","dropbox"]}'
- '{"match":"client_mac","name":"file_servers","type":"match","values":["b0c4e7001543","a0c4e7001543","00c4e7001543"]}'
- '{"match":"hostname","name":"mist","type":"match","values":["mist.com"]}'
- '{"match":"ip_range_subnet","name":"file_servers","type":"match","values":["10.1.2.1","10.2.3.4/24","10.1.2.5-10.2.3.4"]}'
- '{"match":"port","name":"web-ports","type":"match","values":["80","8000","8080"]}'
- '{"match":"psk_name","name":"VIP","type":"match","values":["test_key1","test_key2"]}'
- '{"match":"psk_role","name":"VIP","type":"match","values":["test_role"]}'
- '{"match":"radius_group","name":"VIP","type":"match","values":["vip"]}'
- '{"match":"radius_username","name":"VIP","type":"match","values":["john@abc.com","eric@abc.com"]}'
- '{"name":"protocol-subnet-port","specs":[{"port_range":"80","protocol":"tcp","subnets":["10.1.2.0/24"]}],"type":"spec"}'
- '{"name":"vlan-assignment","type":"vlan","vlan_id":1055}'
- '{"match":"wlan_id","name":"guest-wlan","type":"match","values":["be22bba78e22e1cf5185b880816fe2cf"]}'
contentMediaType: application/json
examples:
app:
value:
match: app
name: match app
type: match
values:
- gmail
- dropbox
client_mac:
value:
match: client_mac
name: file_servers
type: match
values:
- b0c4e7001543
- a0c4e7001543
- 00c4e7001543
hostnames:
value:
match: hostname
name: mist
type: match
values:
- mist.com
ip_range_subnets:
value:
match: ip_range_subnet
name: file_servers
type: match
values:
- 10.1.2.1
- 10.2.3.4/24
- 10.1.2.5-10.2.3.4
ports:
value:
match: port
name: web-ports
type: match
values:
- '80'
- '8000'
- '8080'
psk_name:
value:
match: psk_name
name: VIP
type: match
values:
- test_key1
- test_key2
psk_role:
value:
match: psk_role
name: VIP
type: match
values:
- test_role
radius_group:
value:
match: radius_group
name: VIP
type: match
values:
- vip
radius_username:
value:
match: radius_username
name: VIP
type: match
values:
- john@abc.com
- eric@abc.com
traffic-spec:
value:
name: protocol-subnet-port
specs:
- port_range: '80'
protocol: tcp
subnets:
- 10.1.2.0/24
type: spec
vlan:
value:
name: vlan-assignment
type: vlan
vlan_id: 1055
wlan_id:
value:
match: wlan_id
name: guest-wlan
type: match
values:
- be22bba78e22e1cf5185b880816fe2cf
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/wxlan_tag'
- description: >-
WxLAN Tag
* type:
* client: created manually (e.g. on wireless client table, when they spot a device of interest, they can create a wxlan tag for it
* resource: created automatically when we discover a network resource
* subnet: create automatically when a subnet is discovered
* match:
* wlan_id, ap_id: values are a list of Wlan / Device ids
* client_mac: values are a list of MAC addresses
* radius_group: this is a smart tag that matches RADIUS-Filter-ID, Airespace-ACL-Name (VendorID=14179, VendorType=6) / Aruba-User-Role (VendorID=14823, VendorType=1)
* radius_username: this matches the ATTR-User-Name(1)
* radius_class: the matches the ATTR-Class(25)
* radius_attr: the values are [ "6=1" , "26=10.2.3.4" ], this support other RADIUS attributes where we know the type
* radius_vendor: the values are [ "14179.10=1" , "14178.16=1.2.3.4" ], this matches vendor attributes and will be dynamically evaluated
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
last_ips:
- string
mac: string
match: wlan_id
modified_time: 0
name: string
op: in
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
resource_mac: string
services:
- string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
specs:
- port_range: string
protocol: tcp
subnets:
- string
subnet: string
type: match
values:
- string
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
last_ips:
- string
mac: string
match: wlan_id
modified_time: 0
name: string
op: in
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
resource_mac: string
services:
- string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
specs:
- port_range: string
protocol: tcp
subnets:
- string
subnet: string
type: match
values:
- string
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/wxlan_tag'
- description: >-
WxLAN Tag
* type:
* client: created manually (e.g. on wireless client table, when they spot a device of interest, they can create a wxlan tag for it
* resource: created automatically when we discover a network resource
* subnet: create automatically when a subnet is discovered
* match:
* wlan_id, ap_id: values are a list of Wlan / Device ids
* client_mac: values are a list of MAC addresses
* radius_group: this is a smart tag that matches RADIUS-Filter-ID, Airespace-ACL-Name (VendorID=14179, VendorType=6) / Aruba-User-Role (VendorID=14823, VendorType=1)
* radius_username: this matches the ATTR-User-Name(1)
* radius_class: the matches the ATTR-Class(25)
* radius_attr: the values are [ "6=1" , "26=10.2.3.4" ], this support other RADIUS attributes where we know the type
* radius_vendor: the values are [ "14179.10=1" , "14178.16=1.2.3.4" ], this matches vendor attributes and will be dynamically evaluated
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
last_ips:
- string
mac: string
match: wlan_id
modified_time: 0
name: string
op: in
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
resource_mac: string
services:
- string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
specs:
- port_range: string
protocol: tcp
subnets:
- string
subnet: string
type: match
values:
- string
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
last_ips:
- string
mac: string
match: wlan_id
modified_time: 0
name: string
op: in
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
resource_mac: string
services:
- string
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
specs:
- port_range: string
protocol: tcp
subnets:
- string
subnet: string
type: match
values:
- string
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/wxtunnels:
get:
tags:
- Sites WxTunnels
summary: listSiteWxTunnels
description: Get List of Site WxLan Tunnels
operationId: listSiteWxTunnels
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/wxlan_tunnel'
description: WxLAN tunnel records returned by a list response
examples:
- - created_time: 0
dmvpn:
enabled: true
holding_time: 0
host_routes:
- string
for_mgmt: true
hello_interval: 1
hello_retries: 3
hostname: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ipsec:
enabled: true
psk: string123
is_static: true
modified_time: 0
mtu: 1500
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
peers:
- string
router_id: string
secret: string
sessions:
- ap_as_session_id: string
comment: string
enable_cookie: true
ethertype: ethernet
local_session_id: 1
pseudo_802.1ad_enabled: true
remote_id: string
remote_session_id: 1
use_ap_as_session_ids: true
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
udp_port: 0
use_udp: true
contentMediaType: application/json
examples:
Example:
value:
- created_time: 0
dmvpn:
enabled: true
holding_time: 0
host_routes:
- string
for_mgmt: true
hello_interval: 1
hello_retries: 3
hostname: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ipsec:
enabled: true
psk: string123
is_static: true
modified_time: 0
mtu: 1500
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
peers:
- string
router_id: string
secret: string
sessions:
- ap_as_session_id: string
comment: string
enable_cookie: true
ethertype: ethernet
local_session_id: 1
pseudo_802.1ad_enabled: true
remote_id: string
remote_session_id: 1
use_ap_as_session_ids: true
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
udp_port: 0
use_udp: true
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/wxlan_tunnel'
description: WxLAN tunnel records returned by a list response
examples:
- - created_time: 0
dmvpn:
enabled: true
holding_time: 0
host_routes:
- string
for_mgmt: true
hello_interval: 1
hello_retries: 3
hostname: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ipsec:
enabled: true
psk: string123
is_static: true
modified_time: 0
mtu: 1500
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
peers:
- string
router_id: string
secret: string
sessions:
- ap_as_session_id: string
comment: string
enable_cookie: true
ethertype: ethernet
local_session_id: 1
pseudo_802.1ad_enabled: true
remote_id: string
remote_session_id: 1
use_ap_as_session_ids: true
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
udp_port: 0
use_udp: true
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- created_time: 0
dmvpn:
enabled: true
holding_time: 0
host_routes:
- string
for_mgmt: true
hello_interval: 1
hello_retries: 3
hostname: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ipsec:
enabled: true
psk: string123
is_static: true
modified_time: 0
mtu: 1500
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
peers:
- string
router_id: string
secret: string
sessions:
- ap_as_session_id: string
comment: string
enable_cookie: true
ethertype: ethernet
local_session_id: 1
pseudo_802.1ad_enabled: true
remote_id: string
remote_session_id: 1
use_ap_as_session_ids: true
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
udp_port: 0
use_udp: true
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Sites WxTunnels
summary: createSiteWxTunnel
description: Create Site WxLan Tunnel
operationId: createSiteWxTunnel
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/wxlan_tunnel'
- description: Request Body
examples:
- dmvpn:
enabled: true
holding_time: 0
host_routes:
- string
for_mgmt: true
hello_interval: 1
hello_retries: 3
hostname: string
ipsec:
enabled: true
psk: string123
is_static: true
mtu: 1500
name: string
peers:
- string
router_id: string
secret: string
sessions:
- ap_as_session_id: string
comment: string
enable_cookie: true
ethertype: ethernet
local_session_id: 1
pseudo_802.1ad_enabled: true
remote_id: string
remote_session_id: 1
use_ap_as_session_ids: true
udp_port: 0
use_udp: true
contentMediaType: application/json
examples:
Example:
value:
dmvpn:
enabled: true
holding_time: 0
host_routes:
- string
for_mgmt: true
hello_interval: 1
hello_retries: 3
hostname: string
ipsec:
enabled: true
psk: string123
is_static: true
mtu: 1500
name: string
peers:
- string
router_id: string
secret: string
sessions:
- ap_as_session_id: string
comment: string
enable_cookie: true
ethertype: ethernet
local_session_id: 1
pseudo_802.1ad_enabled: true
remote_id: string
remote_session_id: 1
use_ap_as_session_ids: true
udp_port: 0
use_udp: true
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/wxlan_tunnel'
- description: WxLAN tunnel configuration for L2TPv3 or DMVPN connectivity
examples:
- created_time: 0
dmvpn:
enabled: true
holding_time: 0
host_routes:
- string
for_mgmt: true
hello_interval: 1
hello_retries: 3
hostname: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ipsec:
enabled: true
psk: string123
is_static: true
modified_time: 0
mtu: 1500
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
peers:
- string
router_id: string
secret: string
sessions:
- ap_as_session_id: string
comment: string
enable_cookie: true
ethertype: ethernet
local_session_id: 1
pseudo_802.1ad_enabled: true
remote_id: string
remote_session_id: 1
use_ap_as_session_ids: true
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
udp_port: 0
use_udp: true
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
dmvpn:
enabled: true
holding_time: 0
host_routes:
- string
for_mgmt: true
hello_interval: 1
hello_retries: 3
hostname: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ipsec:
enabled: true
psk: string123
is_static: true
modified_time: 0
mtu: 1500
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
peers:
- string
router_id: string
secret: string
sessions:
- ap_as_session_id: string
comment: string
enable_cookie: true
ethertype: ethernet
local_session_id: 1
pseudo_802.1ad_enabled: true
remote_id: string
remote_session_id: 1
use_ap_as_session_ids: true
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
udp_port: 0
use_udp: true
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/wxlan_tunnel'
- description: WxLAN tunnel configuration for L2TPv3 or DMVPN connectivity
examples:
- created_time: 0
dmvpn:
enabled: true
holding_time: 0
host_routes:
- string
for_mgmt: true
hello_interval: 1
hello_retries: 3
hostname: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ipsec:
enabled: true
psk: string123
is_static: true
modified_time: 0
mtu: 1500
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
peers:
- string
router_id: string
secret: string
sessions:
- ap_as_session_id: string
comment: string
enable_cookie: true
ethertype: ethernet
local_session_id: 1
pseudo_802.1ad_enabled: true
remote_id: string
remote_session_id: 1
use_ap_as_session_ids: true
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
udp_port: 0
use_udp: true
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
dmvpn:
enabled: true
holding_time: 0
host_routes:
- string
for_mgmt: true
hello_interval: 1
hello_retries: 3
hostname: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ipsec:
enabled: true
psk: string123
is_static: true
modified_time: 0
mtu: 1500
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
peers:
- string
router_id: string
secret: string
sessions:
- ap_as_session_id: string
comment: string
enable_cookie: true
ethertype: ethernet
local_session_id: 1
pseudo_802.1ad_enabled: true
remote_id: string
remote_session_id: 1
use_ap_as_session_ids: true
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
udp_port: 0
use_udp: true
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/wxtunnels/{wxtunnel_id}:
delete:
tags:
- Sites WxTunnels
summary: deleteSiteWxTunnel
description: Delete Site WxLan Tunnel
operationId: deleteSiteWxTunnel
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: wxtunnel_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Sites WxTunnels
summary: getSiteWxTunnel
description: Get Site WxLan tunnel Details
operationId: getSiteWxTunnel
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: wxtunnel_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/wxlan_tunnel'
- description: WxLAN tunnel configuration for L2TPv3 or DMVPN connectivity
examples:
- created_time: 0
dmvpn:
enabled: true
holding_time: 0
host_routes:
- string
for_mgmt: true
hello_interval: 1
hello_retries: 3
hostname: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ipsec:
enabled: true
psk: string123
is_static: true
modified_time: 0
mtu: 1500
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
peers:
- string
router_id: string
secret: string
sessions:
- ap_as_session_id: string
comment: string
enable_cookie: true
ethertype: ethernet
local_session_id: 1
pseudo_802.1ad_enabled: true
remote_id: string
remote_session_id: 1
use_ap_as_session_ids: true
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
udp_port: 0
use_udp: true
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
dmvpn:
enabled: true
holding_time: 0
host_routes:
- string
for_mgmt: true
hello_interval: 1
hello_retries: 3
hostname: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ipsec:
enabled: true
psk: string123
is_static: true
modified_time: 0
mtu: 1500
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
peers:
- string
router_id: string
secret: string
sessions:
- ap_as_session_id: string
comment: string
enable_cookie: true
ethertype: ethernet
local_session_id: 1
pseudo_802.1ad_enabled: true
remote_id: string
remote_session_id: 1
use_ap_as_session_ids: true
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
udp_port: 0
use_udp: true
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/wxlan_tunnel'
- description: WxLAN tunnel configuration for L2TPv3 or DMVPN connectivity
examples:
- created_time: 0
dmvpn:
enabled: true
holding_time: 0
host_routes:
- string
for_mgmt: true
hello_interval: 1
hello_retries: 3
hostname: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ipsec:
enabled: true
psk: string123
is_static: true
modified_time: 0
mtu: 1500
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
peers:
- string
router_id: string
secret: string
sessions:
- ap_as_session_id: string
comment: string
enable_cookie: true
ethertype: ethernet
local_session_id: 1
pseudo_802.1ad_enabled: true
remote_id: string
remote_session_id: 1
use_ap_as_session_ids: true
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
udp_port: 0
use_udp: true
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
dmvpn:
enabled: true
holding_time: 0
host_routes:
- string
for_mgmt: true
hello_interval: 1
hello_retries: 3
hostname: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ipsec:
enabled: true
psk: string123
is_static: true
modified_time: 0
mtu: 1500
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
peers:
- string
router_id: string
secret: string
sessions:
- ap_as_session_id: string
comment: string
enable_cookie: true
ethertype: ethernet
local_session_id: 1
pseudo_802.1ad_enabled: true
remote_id: string
remote_session_id: 1
use_ap_as_session_ids: true
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
udp_port: 0
use_udp: true
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Sites WxTunnels
summary: updateSiteWxTunnel
description: Update Site WxLan Tunnel
operationId: updateSiteWxTunnel
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: wxtunnel_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/wxlan_tunnel'
- description: Request Body
examples:
- dmvpn:
enabled: true
holding_time: 0
host_routes:
- string
for_mgmt: true
hello_interval: 1
hello_retries: 3
hostname: string
ipsec:
enabled: true
psk: string123
is_static: true
mtu: 1500
name: string
peers:
- string
router_id: string
secret: string
sessions:
- ap_as_session_id: string
comment: string
enable_cookie: true
ethertype: ethernet
local_session_id: 1
pseudo_802.1ad_enabled: true
remote_id: string
remote_session_id: 1
use_ap_as_session_ids: true
udp_port: 0
use_udp: true
contentMediaType: application/json
examples:
Example:
value:
dmvpn:
enabled: true
holding_time: 0
host_routes:
- string
for_mgmt: true
hello_interval: 1
hello_retries: 3
hostname: string
ipsec:
enabled: true
psk: string123
is_static: true
mtu: 1500
name: string
peers:
- string
router_id: string
secret: string
sessions:
- ap_as_session_id: string
comment: string
enable_cookie: true
ethertype: ethernet
local_session_id: 1
pseudo_802.1ad_enabled: true
remote_id: string
remote_session_id: 1
use_ap_as_session_ids: true
udp_port: 0
use_udp: true
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/wxlan_tunnel'
- description: WxLAN tunnel configuration for L2TPv3 or DMVPN connectivity
examples:
- created_time: 0
dmvpn:
enabled: true
holding_time: 0
host_routes:
- string
for_mgmt: true
hello_interval: 1
hello_retries: 3
hostname: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ipsec:
enabled: true
psk: string123
is_static: true
modified_time: 0
mtu: 1500
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
peers:
- string
router_id: string
secret: string
sessions:
- ap_as_session_id: string
comment: string
enable_cookie: true
ethertype: ethernet
local_session_id: 1
pseudo_802.1ad_enabled: true
remote_id: string
remote_session_id: 1
use_ap_as_session_ids: true
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
udp_port: 0
use_udp: true
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
dmvpn:
enabled: true
holding_time: 0
host_routes:
- string
for_mgmt: true
hello_interval: 1
hello_retries: 3
hostname: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ipsec:
enabled: true
psk: string123
is_static: true
modified_time: 0
mtu: 1500
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
peers:
- string
router_id: string
secret: string
sessions:
- ap_as_session_id: string
comment: string
enable_cookie: true
ethertype: ethernet
local_session_id: 1
pseudo_802.1ad_enabled: true
remote_id: string
remote_session_id: 1
use_ap_as_session_ids: true
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
udp_port: 0
use_udp: true
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/wxlan_tunnel'
- description: WxLAN tunnel configuration for L2TPv3 or DMVPN connectivity
examples:
- created_time: 0
dmvpn:
enabled: true
holding_time: 0
host_routes:
- string
for_mgmt: true
hello_interval: 1
hello_retries: 3
hostname: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ipsec:
enabled: true
psk: string123
is_static: true
modified_time: 0
mtu: 1500
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
peers:
- string
router_id: string
secret: string
sessions:
- ap_as_session_id: string
comment: string
enable_cookie: true
ethertype: ethernet
local_session_id: 1
pseudo_802.1ad_enabled: true
remote_id: string
remote_session_id: 1
use_ap_as_session_ids: true
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
udp_port: 0
use_udp: true
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
dmvpn:
enabled: true
holding_time: 0
host_routes:
- string
for_mgmt: true
hello_interval: 1
hello_retries: 3
hostname: string
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
ipsec:
enabled: true
psk: string123
is_static: true
modified_time: 0
mtu: 1500
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
peers:
- string
router_id: string
secret: string
sessions:
- ap_as_session_id: string
comment: string
enable_cookie: true
ethertype: ethernet
local_session_id: 1
pseudo_802.1ad_enabled: true
remote_id: string
remote_session_id: 1
use_ap_as_session_ids: true
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
udp_port: 0
use_udp: true
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/zones:
get:
tags:
- Sites Zones
summary: listSiteZones
description: Get List of Site Zones
operationId: listSiteZones
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/zone'
description: Zone records returned by a list response
examples:
- - created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
vertices:
- x: 0
y: 0
contentMediaType: application/json
examples:
Example:
value:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
vertices:
- x: 0
y: 0
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/zone'
description: Zone records returned by a list response
examples:
- - created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
vertices:
- x: 0
y: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
vertices:
- x: 0
y: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Sites Zones
summary: createSiteZone
description: Create Site Zone
operationId: createSiteZone
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone'
- description: Request Body
examples:
- name: string
vertices:
- x: 0
y: 0
contentMediaType: application/json
examples:
Example:
value:
name: string
vertices:
- x: 0
y: 0
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone'
- description: Zone defined on a site map
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
vertices:
- x: 0
y: 0
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
vertices:
- x: 0
y: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/zone'
- description: Zone defined on a site map
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
vertices:
- x: 0
y: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
vertices:
- x: 0
y: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/zones/{zone_id}:
delete:
tags:
- Sites Zones
summary: deleteSiteZone
description: Delete Site Zone
operationId: deleteSiteZone
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: zone_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Sites Zones
summary: getSiteZone
description: Get Site Zone Details
operationId: getSiteZone
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: zone_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone'
- description: Zone defined on a site map
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
vertices:
- x: 0
y: 0
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
vertices:
- x: 0
y: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/zone'
- description: Zone defined on a site map
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
vertices:
- x: 0
y: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
vertices:
- x: 0
y: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Sites Zones
summary: updateSiteZone
description: Update Site Zone
operationId: updateSiteZone
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: zone_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone'
- description: Request Body
examples:
- name: string
vertices:
- x: 0
y: 0
contentMediaType: application/json
examples:
Example:
value:
name: string
vertices:
- x: 0
y: 0
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/zone'
- description: Zone defined on a site map
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
vertices:
- x: 0
y: 0
contentMediaType: application/json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
vertices:
- x: 0
y: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/zone'
- description: Zone defined on a site map
examples:
- created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
vertices:
- x: 0
y: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 0
id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
map_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
modified_time: 0
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
vertices:
- x: 0
y: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/{zone_type}/count:
get:
tags:
- Sites Zones
summary: countSiteZoneSessions
description: Count by Distinct Attributes of Site Zone Sessions
operationId: countSiteZoneSessions
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: zone_type
in: path
description: ''
required: true
schema:
$ref: '#/components/schemas/zone_type'
- name: distinct
in: query
description: 'Field used to group this count response. enum: `scope`, `scope_id`, `user`, `user_type`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/site_zone_count_distinct'
- description: 'Field used to group this count response. enum: `scope`, `scope_id`, `user`, `user_type`'
examples:
- scope_id
- name: user_type
in: query
description: 'Filter results by user type. enum: `asset`, `client`, `sdkclient`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/rf_client_type'
- description: 'Filter results by user type. enum: `asset`, `client`, `sdkclient`'
- name: user
in: query
description: Client MAC / Asset MAC / SDK UUID
style: form
explode: true
schema:
type: string
examples:
- b0c4e7001543
- name: scope_id
in: query
description: If `scope`==`map`/`zone`/`rssizone`, the scope id
style: form
explode: true
schema:
type: string
examples:
- 8bfc2490-d726-3587-038d-cb2e71bd2330
- name: scope
in: query
description: 'Filter results by scope. enum: `map`, `rssizone`, `site`, `zone`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/zone_scope'
- description: 'Filter results by scope. enum: `map`, `rssizone`, `site`, `zone`'
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/{zone_type}/visits/search:
get:
tags:
- Sites Zones
summary: searchSiteZoneSessions
description: Search Zone Sessions
operationId: searchSiteZoneSessions
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: zone_type
in: path
description: ''
required: true
schema:
$ref: '#/components/schemas/zone_type'
- name: user_type
in: query
description: 'Filter results by user type. enum: `asset`, `client`, `sdkclient`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/rf_client_type'
- description: 'Filter results by user type. enum: `asset`, `client`, `sdkclient`'
- name: user
in: query
description: Client MAC / Asset MAC / SDK UUID
style: form
explode: true
schema:
type: string
examples:
- b0c4e7001543
- name: scope_id
in: query
description: If `scope`==`map`/`zone`/`rssizone`, the scope id
style: form
explode: true
schema:
type: string
examples:
- 8bfc2490-d726-3587-038d-cb2e71bd2330
- name: scope
in: query
description: 'Filter results by scope. enum: `map`, `rssizone`, `site`, `zone`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/visits_scope'
- description: 'Filter results by scope. enum: `map`, `rssizone`, `site`, `zone`'
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: Result of Search Zone Sessions
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_zone_search'
- description: Paginated response for site zone visit search results
examples:
- end: 1541705289.769911
limit: 1
next: /api/v1/sites/67970e46-4e12-11e6-9188-0242ac110007/zones/visits/search?limit=2&end=1541705247.000&scope_id=85fbba9e-4e12-11e6-9188-0242ac110007&user_type=asset&start=1541618889.77
results:
- enter: 1541705254
scope: map
timestamp: 1541705254
user: c4b301c81166
start: 1541618889.769886
total: 5892
contentMediaType: application/json
examples:
Example:
value:
end: 1541705289.769911
limit: 1
next: /api/v1/sites/67970e46-4e12-11e6-9188-0242ac110007/zones/visits/search?limit=2&end=1541705247.000&scope_id=85fbba9e-4e12-11e6-9188-0242ac110007&user_type=asset&start=1541618889.77
results:
- enter: 1541705254
scope: map
timestamp: 1541705254
user: c4b301c81166
start: 1541618889.769886
total: 5892
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_zone_search'
- description: Paginated response for site zone visit search results
examples:
- end: 1541705289.769911
limit: 1
next: /api/v1/sites/67970e46-4e12-11e6-9188-0242ac110007/zones/visits/search?limit=2&end=1541705247.000&scope_id=85fbba9e-4e12-11e6-9188-0242ac110007&user_type=asset&start=1541618889.77
results:
- enter: 1541705254
scope: map
timestamp: 1541705254
user: c4b301c81166
start: 1541618889.769886
total: 5892
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 1541705289.769911
limit: 1
next: /api/v1/sites/67970e46-4e12-11e6-9188-0242ac110007/zones/visits/search?limit=2&end=1541705247.000&scope_id=85fbba9e-4e12-11e6-9188-0242ac110007&user_type=asset&start=1541618889.77
results:
- enter: 1541705254
scope: map
timestamp: 1541705254
user: c4b301c81166
start: 1541618889.769886
total: 5892
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/stats:
get:
tags:
- Sites Stats
summary: getSiteStats
description: Get Sites Stats
operationId: getSiteStats
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/stats_site'
- description: Site metadata and aggregate device/client counts returned by organization site stats endpoints
examples:
- address: string
alarmtemplate_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
country_code: string
created_time: 0
id: 55c29ce5-7c0f-45b5-b99b-599f805fa3a1
lat: 0
latlng:
lat: 0
lng: 0
lng: 0
modified_time: 0
msp_id: dca3cad3-0c9b-439b-814f-8d5f23797972
name: string
networktemplate_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
num_ap: 0
num_ap_connected: 0
num_clients: 0
num_devices: 0
num_devices_connected: 0
num_gateway: 0
num_gateway_connected: 0
num_switch: 0
num_switch_connected: 0
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
rftemplate_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
timezone: string
tzoffset: 0
contentMediaType: application/json
examples:
Example:
value:
address: string
alarmtemplate_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
country_code: string
created_time: 0
id: 55c29ce5-7c0f-45b5-b99b-599f805fa3a1
lat: 0
latlng:
lat: 0
lng: 0
lng: 0
modified_time: 0
msp_id: dca3cad3-0c9b-439b-814f-8d5f23797972
name: string
networktemplate_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
num_ap: 0
num_ap_connected: 0
num_clients: 0
num_devices: 0
num_devices_connected: 0
num_gateway: 0
num_gateway_connected: 0
num_switch: 0
num_switch_connected: 0
org_id: a40f5d1f-d889-42e9-94ea-b9b33585fc6b
rftemplate_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
timezone: string
tzoffset: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/stats/apps/count:
get:
tags:
- Sites Stats - Apps
summary: countSiteApps
description: Count by Distinct Attributes of Applications
operationId: countSiteApps
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field used to group application statistics count results. enum: `ap`, `app`, `category`, `device_mac`, `port_id`, `service`, `src_ip`, `ssid`, `wcid`, `wlan_id`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/site_apps_count_distinct'
- description: 'Field used to group application statistics count results. enum: `ap`, `app`, `category`, `device_mac`, `port_id`, `service`, `src_ip`, `ssid`, `wcid`, `wlan_id`'
- name: device_mac
in: query
description: MAC of the device
style: form
explode: true
schema:
type: string
examples:
- '001122334455'
- name: app
in: query
description: Filter results by application name
style: form
explode: true
schema:
type: string
examples:
- Example App
- name: wired
in: query
description: If a device is wired or wireless. Default is False.
style: form
explode: true
schema:
type: string
examples:
- 'False'
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/stats/assets:
get:
tags:
- Sites Stats - Assets
summary: listSiteAssetsStats
description: List asset statistics for a site over the requested time range. Use [List Org Asset Stats]($e/Orgs%20Stats%20-%20Assets/listOrgAssetsStats) to retrieve asset statistics across the organization.
operationId: listSiteAssetsStats
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: map_id
in: query
description: Filter assets by map UUID
style: form
explode: true
schema:
type: string
contentEncoding: uuid
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/stats_asset'
description: Asset statistics returned by the request
examples:
- - _ttl: 86400
battery_voltage: 3370
by: asset
device_id: 00000000-0000-0000-1000-5c5b35000001
device_name: BLE Device
eddystone_uid_instance: 5c5b35000001
eddystone_uid_namespace: 2818e3868dec25629ede
eddystone_url_url: https://www.abc.com
ibeacon_major: 13
ibeacon_minor: 138
ibeacon_uuid: f3f17139-704a-f03a-2786-0400279e37c3
id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
last_seen: 1480716946
mac: 4a0222000e31
manufacture: Asset Manufacturer Name
map_id: 63eda950-c6da-11e4-a628-60f81dd250cc
mfg_company_id: 935
mfg_data: 648520a1020000
name: Asset Name
rssi: -45
rssizones:
- id: 478f6eca-6276-4993-bfeb-5bcbbbbacf08
since: 0
service_packets:
- data: '640'
last_rx_time: 1645855923
rx_cnt: 213065
uuid: 00003e10-0000-1000-8000-00805f9b34fb
temperature: 23.5
x: 51
y: 29
zones:
- id: 477f6eca-6276-4993-bfeb-5ccbbbbadf08
since: 0
contentMediaType: application/json
examples:
Example:
value:
- _ttl: 86400
battery_voltage: 3370
by: asset
device_id: 00000000-0000-0000-1000-5c5b35000001
device_name: BLE Device
eddystone_uid_instance: 5c5b35000001
eddystone_uid_namespace: 2818e3868dec25629ede
eddystone_url_url: https://www.abc.com
ibeacon_major: 13
ibeacon_minor: 138
ibeacon_uuid: f3f17139-704a-f03a-2786-0400279e37c3
id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
last_seen: 1480716946
mac: 4a0222000e31
manufacture: Asset Manufacturer Name
map_id: 63eda950-c6da-11e4-a628-60f81dd250cc
mfg_company_id: 935
mfg_data: 648520a1020000
name: Asset Name
rssi: -45
rssizones:
- id: 478f6eca-6276-4993-bfeb-5bcbbbbacf08
since: 0
service_packets:
- data: '640'
last_rx_time: 1645855923
rx_cnt: 213065
uuid: 00003e10-0000-1000-8000-00805f9b34fb
temperature: 23.5
x: 51
y: 29
zones:
- id: 477f6eca-6276-4993-bfeb-5ccbbbbadf08
since: 0
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/stats_asset'
description: Asset statistics returned by the request
examples:
- - _ttl: 86400
battery_voltage: 3370
by: asset
device_id: 00000000-0000-0000-1000-5c5b35000001
device_name: BLE Device
eddystone_uid_instance: 5c5b35000001
eddystone_uid_namespace: 2818e3868dec25629ede
eddystone_url_url: https://www.abc.com
ibeacon_major: 13
ibeacon_minor: 138
ibeacon_uuid: f3f17139-704a-f03a-2786-0400279e37c3
id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
last_seen: 1480716946
mac: 4a0222000e31
manufacture: Asset Manufacturer Name
map_id: 63eda950-c6da-11e4-a628-60f81dd250cc
mfg_company_id: 935
mfg_data: 648520a1020000
name: Asset Name
rssi: -45
rssizones:
- id: 478f6eca-6276-4993-bfeb-5bcbbbbacf08
since: 0
service_packets:
- data: '640'
last_rx_time: 1645855923
rx_cnt: 213065
uuid: 00003e10-0000-1000-8000-00805f9b34fb
temperature: 23.5
x: 51
y: 29
zones:
- id: 477f6eca-6276-4993-bfeb-5ccbbbbadf08
since: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- _ttl: 86400
battery_voltage: 3370
by: asset
device_id: 00000000-0000-0000-1000-5c5b35000001
device_name: BLE Device
eddystone_uid_instance: 5c5b35000001
eddystone_uid_namespace: 2818e3868dec25629ede
eddystone_url_url: https://www.abc.com
ibeacon_major: 13
ibeacon_minor: 138
ibeacon_uuid: f3f17139-704a-f03a-2786-0400279e37c3
id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
last_seen: 1480716946
mac: 4a0222000e31
manufacture: Asset Manufacturer Name
map_id: 63eda950-c6da-11e4-a628-60f81dd250cc
mfg_company_id: 935
mfg_data: 648520a1020000
name: Asset Name
rssi: -45
rssizones:
- id: 478f6eca-6276-4993-bfeb-5bcbbbbacf08
since: 0
service_packets:
- data: '640'
last_rx_time: 1645855923
rx_cnt: 213065
uuid: 00003e10-0000-1000-8000-00805f9b34fb
temperature: 23.5
x: 51
y: 29
zones:
- id: 477f6eca-6276-4993-bfeb-5ccbbbbadf08
since: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/stats/assets/count:
get:
tags:
- Sites Stats - Assets
summary: countSiteAssets
description: Count by Distinct Attributes of Site Asset
operationId: countSiteAssets
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field used to group this count response. enum: `by`, `device_name`, `eddystone_uid_instance`, `eddystone_uid_namespace`, `eddystone_url`, `ibeacon_major`, `ibeacon_minor`, `ibeacon_uuid`, `mac`, `map_id`, `name`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/site_assets_count_distinct'
- description: 'Field used to group this count response. enum: `by`, `device_name`, `eddystone_uid_instance`, `eddystone_uid_namespace`, `eddystone_url`, `ibeacon_major`, `ibeacon_minor`, `ibeacon_uuid`, `mac`, `map_id`, `name`'
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/stats/assets/search:
get:
tags:
- Sites Stats - Assets
summary: searchSiteAssets
description: Search asset statistics for a site with filters for asset identifiers, device, map, beacon, AP, RSSI, and time range. Use [Search Org Assets]($e/Orgs%20Stats%20-%20Assets/searchOrgAssets) to search asset statistics across the organization.
operationId: searchSiteAssets
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: mac
in: query
description: Filter results by MAC address
style: form
explode: true
schema:
type: string
examples:
- '001122334455'
- name: map_id
in: query
description: Filter results by map identifier
style: form
explode: true
schema:
type: string
examples:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
- name: ibeacon_uuid
in: query
description: Filter asset results by iBeacon UUID
style: form
explode: true
schema:
type: string
examples:
- 3ce2ef69-4414-469d-9d55-3ec7fcc38520
- name: ibeacon_major
in: query
description: Filter asset results by iBeacon major value
style: form
explode: true
schema:
type: integer
contentEncoding: int32
examples:
- 1
- name: ibeacon_minor
in: query
description: Filter asset results by iBeacon minor value
style: form
explode: true
schema:
type: integer
contentEncoding: int32
examples:
- 1
- name: eddystone_uid_namespace
in: query
description: Filter asset results by Eddystone UID namespace
style: form
explode: true
schema:
type: string
examples:
- 1234567890abcdef1234567890abcdef
- name: eddystone_uid_instance
in: query
description: Filter asset results by Eddystone UID instance
style: form
explode: true
schema:
type: string
examples:
- 1234567890abcdef1234567890abcdef
- name: eddystone_url
in: query
description: Filter asset results by Eddystone URL
style: form
explode: true
schema:
type: string
examples:
- https://example.com
- name: device_name
in: query
description: Filter asset results by reporting device name
style: form
explode: true
schema:
type: string
examples:
- Device Name
- name: by
in: query
description: Select how the value should be returned
style: form
explode: true
schema:
type: string
examples:
- mac
- name: name
in: query
description: Filter results by name
style: form
explode: true
schema:
type: string
examples:
- Asset Name
- name: ap_mac
in: query
description: Filter asset results by reporting AP MAC address
style: form
explode: true
schema:
type: string
examples:
- '001122334455'
- name: beam
in: query
description: Filter asset results by beam value
style: form
explode: true
schema:
type: string
examples:
- '0'
- name: rssi
in: query
description: Filter asset results by RSSI value
style: form
explode: true
schema:
type: string
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_stats_assets'
- description: Paginated response for asset statistics search results
examples:
- end: 0
limit: 0
next: string
results:
- battery_voltage: 0
eddystone_uid_instance: string
eddystone_uid_namespace: string
eddystone_url_url: string
ibeacon_major: 1
ibeacon_minor: 1
ibeacon_uuid: 1f89bc00-d0af-481b-82fe-a6629259a39f
last_seen: 0
mac: string
map_id: 09d2b626-2e4e-45ef-a3c4-e6aeb6c83db1
name: string
rssizones:
- id: 476f6eca-6276-4993-bfeb-5dcbbbbaef08
since: 0
x: 0
y: 0
zones:
- id: 475f6eca-6276-4993-bfeb-5ecbbbbf6f08
since: 0
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
end: 0
limit: 0
next: string
results:
- battery_voltage: 0
eddystone_uid_instance: string
eddystone_uid_namespace: string
eddystone_url_url: string
ibeacon_major: 1
ibeacon_minor: 1
ibeacon_uuid: 1f89bc00-d0af-481b-82fe-a6629259a39f
last_seen: 0
mac: string
map_id: 09d2b626-2e4e-45ef-a3c4-e6aeb6c83db1
name: string
rssizones:
- id: 476f6eca-6276-4993-bfeb-5dcbbbbaef08
since: 0
x: 0
y: 0
zones:
- id: 475f6eca-6276-4993-bfeb-5ecbbbbf6f08
since: 0
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_stats_assets'
- description: Paginated response for asset statistics search results
examples:
- end: 0
limit: 0
next: string
results:
- battery_voltage: 0
eddystone_uid_instance: string
eddystone_uid_namespace: string
eddystone_url_url: string
ibeacon_major: 1
ibeacon_minor: 1
ibeacon_uuid: 1f89bc00-d0af-481b-82fe-a6629259a39f
last_seen: 0
mac: string
map_id: 09d2b626-2e4e-45ef-a3c4-e6aeb6c83db1
name: string
rssizones:
- id: 476f6eca-6276-4993-bfeb-5dcbbbbaef08
since: 0
x: 0
y: 0
zones:
- id: 475f6eca-6276-4993-bfeb-5ecbbbbf6f08
since: 0
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 0
limit: 0
next: string
results:
- battery_voltage: 0
eddystone_uid_instance: string
eddystone_uid_namespace: string
eddystone_url_url: string
ibeacon_major: 1
ibeacon_minor: 1
ibeacon_uuid: 1f89bc00-d0af-481b-82fe-a6629259a39f
last_seen: 0
mac: string
map_id: 09d2b626-2e4e-45ef-a3c4-e6aeb6c83db1
name: string
rssizones:
- id: 476f6eca-6276-4993-bfeb-5dcbbbbaef08
since: 0
x: 0
y: 0
zones:
- id: 475f6eca-6276-4993-bfeb-5ecbbbbf6f08
since: 0
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/stats/assets/{asset_id}:
get:
tags:
- Sites Stats - Assets
summary: getSiteAssetStats
description: Get Site Asset Details
operationId: getSiteAssetStats
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: asset_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/stats_asset'
- description: BLE asset location and advertisement statistics
examples:
- _ttl: 86400
battery_voltage: 3370
by: asset
device_id: 00000000-0000-0000-1000-5c5b35000001
device_name: BLE Device
eddystone_uid_instance: 5c5b35000001
eddystone_uid_namespace: 2818e3868dec25629ede
eddystone_url_url: https://www.abc.com
ibeacon_major: 13
ibeacon_minor: 138
ibeacon_uuid: f3f17139-704a-f03a-2786-0400279e37c3
id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
last_seen: 1480716946
mac: 4a0222000e31
manufacture: Asset Manufacturer Name
map_id: 63eda950-c6da-11e4-a628-60f81dd250cc
mfg_company_id: 935
mfg_data: 648520a1020000
name: Asset Name
rssi: -45
rssizones:
- id: 480f6eca-6276-4993-bfeb-59cbbbbaaf08
since: 0
service_packets:
- data: '640'
last_rx_time: 1645855923
rx_cnt: 213065
uuid: 00003e10-0000-1000-8000-00805f9b34fb
temperature: 23.5
x: 51
y: 29
zones:
- id: 479f6eca-6276-4993-bfeb-5acbbbbabf08
since: 0
contentMediaType: application/json
examples:
Example:
value:
_ttl: 86400
battery_voltage: 3370
by: asset
device_id: 00000000-0000-0000-1000-5c5b35000001
device_name: BLE Device
eddystone_uid_instance: 5c5b35000001
eddystone_uid_namespace: 2818e3868dec25629ede
eddystone_url_url: https://www.abc.com
ibeacon_major: 13
ibeacon_minor: 138
ibeacon_uuid: f3f17139-704a-f03a-2786-0400279e37c3
id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
last_seen: 1480716946
mac: 4a0222000e31
manufacture: Asset Manufacturer Name
map_id: 63eda950-c6da-11e4-a628-60f81dd250cc
mfg_company_id: 935
mfg_data: 648520a1020000
name: Asset Name
rssi: -45
rssizones:
- id: 480f6eca-6276-4993-bfeb-59cbbbbaaf08
since: 0
service_packets:
- data: '640'
last_rx_time: 1645855923
rx_cnt: 213065
uuid: 00003e10-0000-1000-8000-00805f9b34fb
temperature: 23.5
x: 51
y: 29
zones:
- id: 479f6eca-6276-4993-bfeb-5acbbbbabf08
since: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/stats_asset'
- description: BLE asset location and advertisement statistics
examples:
- _ttl: 86400
battery_voltage: 3370
by: asset
device_id: 00000000-0000-0000-1000-5c5b35000001
device_name: BLE Device
eddystone_uid_instance: 5c5b35000001
eddystone_uid_namespace: 2818e3868dec25629ede
eddystone_url_url: https://www.abc.com
ibeacon_major: 13
ibeacon_minor: 138
ibeacon_uuid: f3f17139-704a-f03a-2786-0400279e37c3
id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
last_seen: 1480716946
mac: 4a0222000e31
manufacture: Asset Manufacturer Name
map_id: 63eda950-c6da-11e4-a628-60f81dd250cc
mfg_company_id: 935
mfg_data: 648520a1020000
name: Asset Name
rssi: -45
rssizones:
- id: 480f6eca-6276-4993-bfeb-59cbbbbaaf08
since: 0
service_packets:
- data: '640'
last_rx_time: 1645855923
rx_cnt: 213065
uuid: 00003e10-0000-1000-8000-00805f9b34fb
temperature: 23.5
x: 51
y: 29
zones:
- id: 479f6eca-6276-4993-bfeb-5acbbbbabf08
since: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
_ttl: 86400
battery_voltage: 3370
by: asset
device_id: 00000000-0000-0000-1000-5c5b35000001
device_name: BLE Device
eddystone_uid_instance: 5c5b35000001
eddystone_uid_namespace: 2818e3868dec25629ede
eddystone_url_url: https://www.abc.com
ibeacon_major: 13
ibeacon_minor: 138
ibeacon_uuid: f3f17139-704a-f03a-2786-0400279e37c3
id: 845a23bf-bed9-e43c-4c86-6fa474be7ae5
last_seen: 1480716946
mac: 4a0222000e31
manufacture: Asset Manufacturer Name
map_id: 63eda950-c6da-11e4-a628-60f81dd250cc
mfg_company_id: 935
mfg_data: 648520a1020000
name: Asset Name
rssi: -45
rssizones:
- id: 480f6eca-6276-4993-bfeb-59cbbbbaaf08
since: 0
service_packets:
- data: '640'
last_rx_time: 1645855923
rx_cnt: 213065
uuid: 00003e10-0000-1000-8000-00805f9b34fb
temperature: 23.5
x: 51
y: 29
zones:
- id: 479f6eca-6276-4993-bfeb-5acbbbbabf08
since: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/stats/discovered_assets:
get:
tags:
- Sites Stats - Assets
summary: listSiteDiscoveredAssets
description: Get List of Site Discovered BLE Assets that doesn’t match any of the Asset / Assetfilters
operationId: listSiteDiscoveredAssets
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/asset'
description: List of named BLE asset records
contentMediaType: application/json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/stats/filtered_assets:
get:
tags:
- Sites Stats - Assets
summary: getSiteAssetsOfInterest
description: Get a list of BLE beacons that matches Asset or AssetFilter
operationId: getSiteAssetsOfInterest
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/asset_of_interest'
description: BLE beacons that matched named assets or asset filters
examples:
- - ap_mac: string
beam: 0
by: string
curr_site: string
device_name: string
id: string
last_seen: 0
mac: string
manufacture: string
map_id: string
name: string
rssi: 0
contentMediaType: application/json
examples:
Example:
value:
- ap_mac: string
beam: 0
by: string
curr_site: string
device_name: string
id: string
last_seen: 0
mac: string
manufacture: string
map_id: string
name: string
rssi: 0
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/asset_of_interest'
description: BLE beacons that matched named assets or asset filters
examples:
- - ap_mac: string
beam: 0
by: string
curr_site: string
device_name: string
id: string
last_seen: 0
mac: string
manufacture: string
map_id: string
name: string
rssi: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- ap_mac: string
beam: 0
by: string
curr_site: string
device_name: string
id: string
last_seen: 0
mac: string
manufacture: string
map_id: string
name: string
rssi: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/stats/maps/{map_id}/discovered_assets:
get:
tags:
- Sites Stats - Assets
summary: getSiteDiscoveredAssetByMap
description: Get a list of BLE beacons that we discovered (whether they’ re defined as assets or not)
operationId: getSiteDiscoveredAssetByMap
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: map_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/stats_asset'
description: Asset statistics returned by the request
contentMediaType: application/json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/stats/beacons:
get:
tags:
- Sites Stats - Beacons
summary: listSiteBeaconsStats
description: Get List of Site Beacons Stats
operationId: listSiteBeaconsStats
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/stats_beacon'
description: BLE beacon statistics returned by the request
contentMediaType: application/json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/stats/bgp_peers/count:
get:
tags:
- Sites Stats - BGP Peers
summary: countSiteBgpStats
description: Count BGP peer statistics for a site, optionally grouped by the `distinct` field and filtered by peer state. Use [Count Org BGP Stats]($e/Orgs%20Stats%20-%20BGP%20Peers/countOrgBgpStats) to count BGP peer statistics across the organization.
operationId: countSiteBgpStats
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: state
in: query
description: Filter peer results by state
style: form
explode: true
schema:
type: string
examples:
- established
- name: distinct
in: query
description: Field used to group this count response
style: form
explode: true
schema:
type: string
examples:
- site_id
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/stats/bgp_peers/search:
get:
tags:
- Sites Stats - BGP Peers
summary: searchSiteBgpStats
description: Search BGP peer statistics for a site with filters for device, neighbor, VRF, and time range. Use [Search Org BGP Stats]($e/Orgs%20Stats%20-%20BGP%20Peers/searchOrgBgpStats) to search BGP peer statistics across the organization.
operationId: searchSiteBgpStats
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: mac
in: query
description: Filter results by MAC address
style: form
explode: true
schema:
type: string
- name: neighbor_mac
in: query
description: Filter peer results by neighbor MAC address
style: form
explode: true
schema:
type: string
- name: vrf_name
in: query
description: Filter peer results by VRF name
style: form
explode: true
schema:
type: string
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_search_bgps'
- description: Paginated response for BGP peer statistics search results
examples:
- end: 0
limit: 0
results:
- evpn_overlay: true
for_overlay: true
local_as: 65000
mac: 020001c04668
neighbor: 15.8.3.5
neighbor_as: 65000
neighbor_mac: 020001c04600
node: node0
org_id: 0c160b7f-1027-4cd1-923b-744534c4b070
rx_pkts: 63366
rx_routes: 60
site_id: 725a8d34-a126-4f2c-b990-d1219421cb75
state: established
timestamp: 1666251056.07
tx_pkts: 1735
tx_routes: 60
up: true
uptime: 31355
vrf_name: default
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
end: 0
limit: 0
results:
- evpn_overlay: true
for_overlay: true
local_as: 65000
mac: 020001c04668
neighbor: 15.8.3.5
neighbor_as: 65000
neighbor_mac: 020001c04600
node: node0
org_id: 0c160b7f-1027-4cd1-923b-744534c4b070
rx_pkts: 63366
rx_routes: 60
site_id: 725a8d34-a126-4f2c-b990-d1219421cb75
state: established
timestamp: 1666251056.07
tx_pkts: 1735
tx_routes: 60
up: true
uptime: 31355
vrf_name: default
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_search_bgps'
- description: Paginated response for BGP peer statistics search results
examples:
- end: 0
limit: 0
results:
- evpn_overlay: true
for_overlay: true
local_as: 65000
mac: 020001c04668
neighbor: 15.8.3.5
neighbor_as: 65000
neighbor_mac: 020001c04600
node: node0
org_id: 0c160b7f-1027-4cd1-923b-744534c4b070
rx_pkts: 63366
rx_routes: 60
site_id: 725a8d34-a126-4f2c-b990-d1219421cb75
state: established
timestamp: 1666251056.07
tx_pkts: 1735
tx_routes: 60
up: true
uptime: 31355
vrf_name: default
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 0
limit: 0
results:
- evpn_overlay: true
for_overlay: true
local_as: 65000
mac: 020001c04668
neighbor: 15.8.3.5
neighbor_as: 65000
neighbor_mac: 020001c04600
node: node0
org_id: 0c160b7f-1027-4cd1-923b-744534c4b070
rx_pkts: 63366
rx_routes: 60
site_id: 725a8d34-a126-4f2c-b990-d1219421cb75
state: established
timestamp: 1666251056.07
tx_pkts: 1735
tx_routes: 60
up: true
uptime: 31355
vrf_name: default
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/stats/calls/client/{client_mac}/troubleshoot:
get:
tags:
- Sites Stats - Calls
summary: troubleshootSiteCall
description: Troubleshoot a call
operationId: troubleshootSiteCall
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: client_mac
in: path
description: ''
required: true
schema:
pattern: ^[0-9a-fA-F]{12}$
type: string
examples:
- 0000000000ab
- name: meeting_id
in: query
description: Filter results by meeting identifier
required: true
style: form
explode: true
schema:
type: string
examples:
- 1234567890abcdef
- name: mac
in: query
description: Filter results by MAC address
style: form
explode: true
schema:
type: string
examples:
- '001122334455'
- name: app
in: query
description: Third party app name
style: form
explode: true
schema:
type: string
examples:
- zoom
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/call_troubleshoot'
- description: Detailed call troubleshooting response
examples:
- mac: 983a78ea4a44
meeting_id: b784d744-9a7c-4fad-9af0-f78858a319b1
results:
- ap_num_clients: -0.08802365511655807
ap_rtt: 0.09924473613500595
audio_in:
ap_num_clients: -0.6565111
ap_rtt: 0.16559607
client_cpu: 3.7028809
client_n_streams: 0.15803306
client_radio_band: 0.5576923
client_rssi: -1.0839354
client_rx_bytes: 2.2622051
client_rx_rates: 0.62357205
client_rx_retries: 0.26726437
client_tx_bytes: 0.15803306
client_tx_rates: 0.62357205
client_tx_retries: 0.77553505
client_vpn_distance: 1.6474955
client_wifi_version: 0.18267937
expected: 30.941595
radio_bandwidth: -0.06538621
radio_channel: -0.73391086
radio_tx_power: 0.10027129
radio_util: 12.770318
radio_util_interference: -3.079999
site_num_clients: 0.017364305
wan_avg_download_mbps: 1.4803165
wan_avg_upload_mbps: -0.038184267
wan_jitter: 5.9680853
wan_max_download_mbps: 1.4803165
wan_max_upload_mbps: -0.038184267
wan_rtt: 46.77899
audio_out:
ap_num_clients: -0.6565111
ap_rtt: 0.16559607
client_cpu: 3.7028809
client_n_streams: 0.15803306
client_radio_band: 0.5576923
client_rssi: -1.0839354
client_rx_bytes: 2.2622051
client_rx_rates: 0.62357205
client_rx_retries: 0.26726437
client_tx_bytes: 0.15803306
client_tx_rates: 0.62357205
client_tx_retries: 0.77553505
client_vpn_distance: 1.6474955
client_wifi_version: 0.18267937
expected: 30.941595
radio_bandwidth: -0.06538621
radio_channel: -0.73391086
radio_tx_power: 0.10027129
radio_util: 12.770318
radio_util_interference: -3.079999
site_num_clients: 0.017364305
wan_avg_download_mbps: 1.4803165
wan_avg_upload_mbps: -0.038184267
wan_jitter: 5.9680853
wan_max_download_mbps: 1.4803165
wan_max_upload_mbps: -0.038184267
wan_rtt: 46.77899
client_cpu: 0.00834270566701889
client_n_streams: 0.00734270566701889
client_radio_band: 0.5841414928436279
client_rssi: 0.7594696879386902
client_rx_bytes: 2.365511655807E-05
client_rx_rates: 0.02441493794322014
client_rx_retries: -0.14325742423534393
client_tx_bytes: 0.00102365511655807
client_tx_rates: 0.22236637771129608
client_tx_retries: 0.3308201730251312
client_vpn_distance: -0.0001660545531194657
client_wifi_version: 7.0566701889E-07
expected: -2.8630001056670187
radio_ap_change: 0.01850946433842182
radio_bandwidth: -0.021175479516386986
radio_channel: 0.11686426401138306
radio_rx_failed: 1.1782013177871704
radio_tx_power: 0.121039018034935
radio_util: 0.2452986091375351
radio_util_interference: 3.4367904663085938
site_num_clients: 0.055026158690452576
site_wan_avg_download_mbps: 3.0566701889E-07
site_wan_avg_upload_mbps: 5.566701889E-08
site_wan_download_mbps: 8.0566701889E-07
site_wan_jitter: 1.00566701889E-06
site_wan_rtt: 4.0566701889E-07
site_wan_upload_mbps: 2.0566701889E-07
timestamp: 1695425115
video_in:
ap_num_clients: -0.6565111
ap_rtt: 0.16559607
client_cpu: 3.7028809
client_n_streams: 0.15803306
client_radio_band: 0.5576923
client_rssi: -1.0839354
client_rx_bytes: 2.2622051
client_rx_rates: 0.62357205
client_rx_retries: 0.26726437
client_tx_bytes: 0.15803306
client_tx_rates: 0.62357205
client_tx_retries: 0.77553505
client_vpn_distance: 1.6474955
client_wifi_version: 0.18267937
expected: 30.941595
radio_bandwidth: -0.06538621
radio_channel: -0.73391086
radio_tx_power: 0.10027129
radio_util: 12.770318
radio_util_interference: -3.079999
site_num_clients: 0.017364305
wan_avg_download_mbps: 1.4803165
wan_avg_upload_mbps: -0.038184267
wan_jitter: 5.9680853
wan_max_download_mbps: 1.4803165
wan_max_upload_mbps: -0.038184267
wan_rtt: 46.77899
video_out:
ap_num_clients: -0.6565111
ap_rtt: 0.16559607
client_cpu: 3.7028809
client_n_streams: 0.15803306
client_radio_band: 0.5576923
client_rssi: -1.0839354
client_rx_bytes: 2.2622051
client_rx_rates: 0.62357205
client_rx_retries: 0.26726437
client_tx_bytes: 0.15803306
client_tx_rates: 0.62357205
client_tx_retries: 0.77553505
client_vpn_distance: 1.6474955
client_wifi_version: 0.18267937
expected: 30.941595
radio_bandwidth: -0.06538621
radio_channel: -0.73391086
radio_tx_power: 0.10027129
radio_util: 12.770318
radio_util_interference: -3.079999
site_num_clients: 0.017364305
wan_avg_download_mbps: 1.4803165
wan_avg_upload_mbps: -0.038184267
wan_jitter: 5.9680853
wan_max_download_mbps: 1.4803165
wan_max_upload_mbps: -0.038184267
wan_rtt: 46.77899
contentMediaType: application/json
examples:
Example:
value:
mac: 983a78ea4a44
meeting_id: b784d744-9a7c-4fad-9af0-f78858a319b1
results:
- ap_num_clients: -0.08802365511655807
ap_rtt: 0.09924473613500595
audio_in:
ap_num_clients: -0.6565111
ap_rtt: 0.16559607
client_cpu: 3.7028809
client_n_streams: 0.15803306
client_radio_band: 0.5576923
client_rssi: -1.0839354
client_rx_bytes: 2.2622051
client_rx_rates: 0.62357205
client_rx_retries: 0.26726437
client_tx_bytes: 0.15803306
client_tx_rates: 0.62357205
client_tx_retries: 0.77553505
client_vpn_distance: 1.6474955
client_wifi_version: 0.18267937
expected: 30.941595
radio_bandwidth: -0.06538621
radio_channel: -0.73391086
radio_tx_power: 0.10027129
radio_util: 12.770318
radio_util_interference: -3.079999
site_num_clients: 0.017364305
wan_avg_download_mbps: 1.4803165
wan_avg_upload_mbps: -0.038184267
wan_jitter: 5.9680853
wan_max_download_mbps: 1.4803165
wan_max_upload_mbps: -0.038184267
wan_rtt: 46.77899
audio_out:
ap_num_clients: -0.6565111
ap_rtt: 0.16559607
client_cpu: 3.7028809
client_n_streams: 0.15803306
client_radio_band: 0.5576923
client_rssi: -1.0839354
client_rx_bytes: 2.2622051
client_rx_rates: 0.62357205
client_rx_retries: 0.26726437
client_tx_bytes: 0.15803306
client_tx_rates: 0.62357205
client_tx_retries: 0.77553505
client_vpn_distance: 1.6474955
client_wifi_version: 0.18267937
expected: 30.941595
radio_bandwidth: -0.06538621
radio_channel: -0.73391086
radio_tx_power: 0.10027129
radio_util: 12.770318
radio_util_interference: -3.079999
site_num_clients: 0.017364305
wan_avg_download_mbps: 1.4803165
wan_avg_upload_mbps: -0.038184267
wan_jitter: 5.9680853
wan_max_download_mbps: 1.4803165
wan_max_upload_mbps: -0.038184267
wan_rtt: 46.77899
client_cpu: 0.00834270566701889
client_n_streams: 0.00734270566701889
client_radio_band: 0.5841414928436279
client_rssi: 0.7594696879386902
client_rx_bytes: 2.365511655807E-05
client_rx_rates: 0.02441493794322014
client_rx_retries: -0.14325742423534393
client_tx_bytes: 0.00102365511655807
client_tx_rates: 0.22236637771129608
client_tx_retries: 0.3308201730251312
client_vpn_distance: -0.0001660545531194657
client_wifi_version: 7.0566701889E-07
expected: -2.8630001056670187
radio_ap_change: 0.01850946433842182
radio_bandwidth: -0.021175479516386986
radio_channel: 0.11686426401138306
radio_rx_failed: 1.1782013177871704
radio_tx_power: 0.121039018034935
radio_util: 0.2452986091375351
radio_util_interference: 3.4367904663085938
site_num_clients: 0.055026158690452576
site_wan_avg_download_mbps: 3.0566701889E-07
site_wan_avg_upload_mbps: 5.566701889E-08
site_wan_download_mbps: 8.0566701889E-07
site_wan_jitter: 1.00566701889E-06
site_wan_rtt: 4.0566701889E-07
site_wan_upload_mbps: 2.0566701889E-07
timestamp: 1695425115
video_in:
ap_num_clients: -0.6565111
ap_rtt: 0.16559607
client_cpu: 3.7028809
client_n_streams: 0.15803306
client_radio_band: 0.5576923
client_rssi: -1.0839354
client_rx_bytes: 2.2622051
client_rx_rates: 0.62357205
client_rx_retries: 0.26726437
client_tx_bytes: 0.15803306
client_tx_rates: 0.62357205
client_tx_retries: 0.77553505
client_vpn_distance: 1.6474955
client_wifi_version: 0.18267937
expected: 30.941595
radio_bandwidth: -0.06538621
radio_channel: -0.73391086
radio_tx_power: 0.10027129
radio_util: 12.770318
radio_util_interference: -3.079999
site_num_clients: 0.017364305
wan_avg_download_mbps: 1.4803165
wan_avg_upload_mbps: -0.038184267
wan_jitter: 5.9680853
wan_max_download_mbps: 1.4803165
wan_max_upload_mbps: -0.038184267
wan_rtt: 46.77899
video_out:
ap_num_clients: -0.6565111
ap_rtt: 0.16559607
client_cpu: 3.7028809
client_n_streams: 0.15803306
client_radio_band: 0.5576923
client_rssi: -1.0839354
client_rx_bytes: 2.2622051
client_rx_rates: 0.62357205
client_rx_retries: 0.26726437
client_tx_bytes: 0.15803306
client_tx_rates: 0.62357205
client_tx_retries: 0.77553505
client_vpn_distance: 1.6474955
client_wifi_version: 0.18267937
expected: 30.941595
radio_bandwidth: -0.06538621
radio_channel: -0.73391086
radio_tx_power: 0.10027129
radio_util: 12.770318
radio_util_interference: -3.079999
site_num_clients: 0.017364305
wan_avg_download_mbps: 1.4803165
wan_avg_upload_mbps: -0.038184267
wan_jitter: 5.9680853
wan_max_download_mbps: 1.4803165
wan_max_upload_mbps: -0.038184267
wan_rtt: 46.77899
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/call_troubleshoot'
- description: Detailed call troubleshooting response
examples:
- mac: 983a78ea4a44
meeting_id: b784d744-9a7c-4fad-9af0-f78858a319b1
results:
- ap_num_clients: -0.08802365511655807
ap_rtt: 0.09924473613500595
audio_in:
ap_num_clients: -0.6565111
ap_rtt: 0.16559607
client_cpu: 3.7028809
client_n_streams: 0.15803306
client_radio_band: 0.5576923
client_rssi: -1.0839354
client_rx_bytes: 2.2622051
client_rx_rates: 0.62357205
client_rx_retries: 0.26726437
client_tx_bytes: 0.15803306
client_tx_rates: 0.62357205
client_tx_retries: 0.77553505
client_vpn_distance: 1.6474955
client_wifi_version: 0.18267937
expected: 30.941595
radio_bandwidth: -0.06538621
radio_channel: -0.73391086
radio_tx_power: 0.10027129
radio_util: 12.770318
radio_util_interference: -3.079999
site_num_clients: 0.017364305
wan_avg_download_mbps: 1.4803165
wan_avg_upload_mbps: -0.038184267
wan_jitter: 5.9680853
wan_max_download_mbps: 1.4803165
wan_max_upload_mbps: -0.038184267
wan_rtt: 46.77899
audio_out:
ap_num_clients: -0.6565111
ap_rtt: 0.16559607
client_cpu: 3.7028809
client_n_streams: 0.15803306
client_radio_band: 0.5576923
client_rssi: -1.0839354
client_rx_bytes: 2.2622051
client_rx_rates: 0.62357205
client_rx_retries: 0.26726437
client_tx_bytes: 0.15803306
client_tx_rates: 0.62357205
client_tx_retries: 0.77553505
client_vpn_distance: 1.6474955
client_wifi_version: 0.18267937
expected: 30.941595
radio_bandwidth: -0.06538621
radio_channel: -0.73391086
radio_tx_power: 0.10027129
radio_util: 12.770318
radio_util_interference: -3.079999
site_num_clients: 0.017364305
wan_avg_download_mbps: 1.4803165
wan_avg_upload_mbps: -0.038184267
wan_jitter: 5.9680853
wan_max_download_mbps: 1.4803165
wan_max_upload_mbps: -0.038184267
wan_rtt: 46.77899
client_cpu: 0.00834270566701889
client_n_streams: 0.00734270566701889
client_radio_band: 0.5841414928436279
client_rssi: 0.7594696879386902
client_rx_bytes: 2.365511655807E-05
client_rx_rates: 0.02441493794322014
client_rx_retries: -0.14325742423534393
client_tx_bytes: 0.00102365511655807
client_tx_rates: 0.22236637771129608
client_tx_retries: 0.3308201730251312
client_vpn_distance: -0.0001660545531194657
client_wifi_version: 7.0566701889E-07
expected: -2.8630001056670187
radio_ap_change: 0.01850946433842182
radio_bandwidth: -0.021175479516386986
radio_channel: 0.11686426401138306
radio_rx_failed: 1.1782013177871704
radio_tx_power: 0.121039018034935
radio_util: 0.2452986091375351
radio_util_interference: 3.4367904663085938
site_num_clients: 0.055026158690452576
site_wan_avg_download_mbps: 3.0566701889E-07
site_wan_avg_upload_mbps: 5.566701889E-08
site_wan_download_mbps: 8.0566701889E-07
site_wan_jitter: 1.00566701889E-06
site_wan_rtt: 4.0566701889E-07
site_wan_upload_mbps: 2.0566701889E-07
timestamp: 1695425115
video_in:
ap_num_clients: -0.6565111
ap_rtt: 0.16559607
client_cpu: 3.7028809
client_n_streams: 0.15803306
client_radio_band: 0.5576923
client_rssi: -1.0839354
client_rx_bytes: 2.2622051
client_rx_rates: 0.62357205
client_rx_retries: 0.26726437
client_tx_bytes: 0.15803306
client_tx_rates: 0.62357205
client_tx_retries: 0.77553505
client_vpn_distance: 1.6474955
client_wifi_version: 0.18267937
expected: 30.941595
radio_bandwidth: -0.06538621
radio_channel: -0.73391086
radio_tx_power: 0.10027129
radio_util: 12.770318
radio_util_interference: -3.079999
site_num_clients: 0.017364305
wan_avg_download_mbps: 1.4803165
wan_avg_upload_mbps: -0.038184267
wan_jitter: 5.9680853
wan_max_download_mbps: 1.4803165
wan_max_upload_mbps: -0.038184267
wan_rtt: 46.77899
video_out:
ap_num_clients: -0.6565111
ap_rtt: 0.16559607
client_cpu: 3.7028809
client_n_streams: 0.15803306
client_radio_band: 0.5576923
client_rssi: -1.0839354
client_rx_bytes: 2.2622051
client_rx_rates: 0.62357205
client_rx_retries: 0.26726437
client_tx_bytes: 0.15803306
client_tx_rates: 0.62357205
client_tx_retries: 0.77553505
client_vpn_distance: 1.6474955
client_wifi_version: 0.18267937
expected: 30.941595
radio_bandwidth: -0.06538621
radio_channel: -0.73391086
radio_tx_power: 0.10027129
radio_util: 12.770318
radio_util_interference: -3.079999
site_num_clients: 0.017364305
wan_avg_download_mbps: 1.4803165
wan_avg_upload_mbps: -0.038184267
wan_jitter: 5.9680853
wan_max_download_mbps: 1.4803165
wan_max_upload_mbps: -0.038184267
wan_rtt: 46.77899
contentMediaType: application/vnd.api+json
examples:
Example:
value:
mac: 983a78ea4a44
meeting_id: b784d744-9a7c-4fad-9af0-f78858a319b1
results:
- ap_num_clients: -0.08802365511655807
ap_rtt: 0.09924473613500595
audio_in:
ap_num_clients: -0.6565111
ap_rtt: 0.16559607
client_cpu: 3.7028809
client_n_streams: 0.15803306
client_radio_band: 0.5576923
client_rssi: -1.0839354
client_rx_bytes: 2.2622051
client_rx_rates: 0.62357205
client_rx_retries: 0.26726437
client_tx_bytes: 0.15803306
client_tx_rates: 0.62357205
client_tx_retries: 0.77553505
client_vpn_distance: 1.6474955
client_wifi_version: 0.18267937
expected: 30.941595
radio_bandwidth: -0.06538621
radio_channel: -0.73391086
radio_tx_power: 0.10027129
radio_util: 12.770318
radio_util_interference: -3.079999
site_num_clients: 0.017364305
wan_avg_download_mbps: 1.4803165
wan_avg_upload_mbps: -0.038184267
wan_jitter: 5.9680853
wan_max_download_mbps: 1.4803165
wan_max_upload_mbps: -0.038184267
wan_rtt: 46.77899
audio_out:
ap_num_clients: -0.6565111
ap_rtt: 0.16559607
client_cpu: 3.7028809
client_n_streams: 0.15803306
client_radio_band: 0.5576923
client_rssi: -1.0839354
client_rx_bytes: 2.2622051
client_rx_rates: 0.62357205
client_rx_retries: 0.26726437
client_tx_bytes: 0.15803306
client_tx_rates: 0.62357205
client_tx_retries: 0.77553505
client_vpn_distance: 1.6474955
client_wifi_version: 0.18267937
expected: 30.941595
radio_bandwidth: -0.06538621
radio_channel: -0.73391086
radio_tx_power: 0.10027129
radio_util: 12.770318
radio_util_interference: -3.079999
site_num_clients: 0.017364305
wan_avg_download_mbps: 1.4803165
wan_avg_upload_mbps: -0.038184267
wan_jitter: 5.9680853
wan_max_download_mbps: 1.4803165
wan_max_upload_mbps: -0.038184267
wan_rtt: 46.77899
client_cpu: 0.00834270566701889
client_n_streams: 0.00734270566701889
client_radio_band: 0.5841414928436279
client_rssi: 0.7594696879386902
client_rx_bytes: 2.365511655807E-05
client_rx_rates: 0.02441493794322014
client_rx_retries: -0.14325742423534393
client_tx_bytes: 0.00102365511655807
client_tx_rates: 0.22236637771129608
client_tx_retries: 0.3308201730251312
client_vpn_distance: -0.0001660545531194657
client_wifi_version: 7.0566701889E-07
expected: -2.8630001056670187
radio_ap_change: 0.01850946433842182
radio_bandwidth: -0.021175479516386986
radio_channel: 0.11686426401138306
radio_rx_failed: 1.1782013177871704
radio_tx_power: 0.121039018034935
radio_util: 0.2452986091375351
radio_util_interference: 3.4367904663085938
site_num_clients: 0.055026158690452576
site_wan_avg_download_mbps: 3.0566701889E-07
site_wan_avg_upload_mbps: 5.566701889E-08
site_wan_download_mbps: 8.0566701889E-07
site_wan_jitter: 1.00566701889E-06
site_wan_rtt: 4.0566701889E-07
site_wan_upload_mbps: 2.0566701889E-07
timestamp: 1695425115
video_in:
ap_num_clients: -0.6565111
ap_rtt: 0.16559607
client_cpu: 3.7028809
client_n_streams: 0.15803306
client_radio_band: 0.5576923
client_rssi: -1.0839354
client_rx_bytes: 2.2622051
client_rx_rates: 0.62357205
client_rx_retries: 0.26726437
client_tx_bytes: 0.15803306
client_tx_rates: 0.62357205
client_tx_retries: 0.77553505
client_vpn_distance: 1.6474955
client_wifi_version: 0.18267937
expected: 30.941595
radio_bandwidth: -0.06538621
radio_channel: -0.73391086
radio_tx_power: 0.10027129
radio_util: 12.770318
radio_util_interference: -3.079999
site_num_clients: 0.017364305
wan_avg_download_mbps: 1.4803165
wan_avg_upload_mbps: -0.038184267
wan_jitter: 5.9680853
wan_max_download_mbps: 1.4803165
wan_max_upload_mbps: -0.038184267
wan_rtt: 46.77899
video_out:
ap_num_clients: -0.6565111
ap_rtt: 0.16559607
client_cpu: 3.7028809
client_n_streams: 0.15803306
client_radio_band: 0.5576923
client_rssi: -1.0839354
client_rx_bytes: 2.2622051
client_rx_rates: 0.62357205
client_rx_retries: 0.26726437
client_tx_bytes: 0.15803306
client_tx_rates: 0.62357205
client_tx_retries: 0.77553505
client_vpn_distance: 1.6474955
client_wifi_version: 0.18267937
expected: 30.941595
radio_bandwidth: -0.06538621
radio_channel: -0.73391086
radio_tx_power: 0.10027129
radio_util: 12.770318
radio_util_interference: -3.079999
site_num_clients: 0.017364305
wan_avg_download_mbps: 1.4803165
wan_avg_upload_mbps: -0.038184267
wan_jitter: 5.9680853
wan_max_download_mbps: 1.4803165
wan_max_upload_mbps: -0.038184267
wan_rtt: 46.77899
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/stats/calls/count:
get:
tags:
- Sites Stats - Calls
summary: countSiteCalls
description: Count by Distinct Attributes of Calls
operationId: countSiteCalls
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field used to group this count response. enum: `mac`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/count_site_calls_distinct'
- description: 'Field used to group this count response. enum: `mac`'
- name: rating
in: query
description: Feedback rating (e.g. "rating=1" or "rating=1,2")
style: form
explode: true
schema:
maximum: 5
minimum: 1
type: integer
contentEncoding: int32
examples:
- 5
- name: app
in: query
description: Filter application statistics by application name
style: form
explode: true
schema:
type: string
examples:
- zoom
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/stats/calls/search:
get:
tags:
- Sites Stats - Calls
summary: searchSiteCalls
description: Search Calls
operationId: searchSiteCalls
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: mac
in: query
description: Filter results by MAC address
style: form
explode: true
schema:
type: string
examples:
- '001122334455'
- name: app
in: query
description: Third party app name
style: form
explode: true
schema:
type: string
examples:
- zoom
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_stats_calls'
- description: Paginated response for site call statistics search results
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_stats_calls'
- description: Paginated response for site call statistics search results
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/stats/calls/summary:
get:
tags:
- Sites Stats - Calls
summary: getSiteCallsSummary
description: Summarized, aggregated stats for the site calls
operationId: getSiteCallsSummary
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: ap_mac
in: query
description: Filter results by AP MAC address
style: form
explode: true
schema:
type: string
examples:
- '001122334455'
- name: app
in: query
description: Filter results by application name
style: form
explode: true
schema:
type: string
examples:
- zoom
- name: wired
in: query
description: Filter results by whether the client is wired
style: form
explode: true
schema:
type: boolean
default: false
examples:
- false
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_stats_calls_summary'
- description: Aggregated site call statistics summary
examples:
- bad_minutes: 5566
bad_minutes_client: 526
bad_minutes_site_wan: 3612
bad_minutes_wireless: 1428
num_aps: 1
num_users: 3
total_minutes: 575217
contentMediaType: application/json
examples:
Example:
value:
bad_minutes: 5566
bad_minutes_client: 526
bad_minutes_site_wan: 3612
bad_minutes_wireless: 1428
num_aps: 1
num_users: 3
total_minutes: 575217
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_stats_calls_summary'
- description: Aggregated site call statistics summary
examples:
- bad_minutes: 5566
bad_minutes_client: 526
bad_minutes_site_wan: 3612
bad_minutes_wireless: 1428
num_aps: 1
num_users: 3
total_minutes: 575217
contentMediaType: application/vnd.api+json
examples:
Example:
value:
bad_minutes: 5566
bad_minutes_client: 526
bad_minutes_site_wan: 3612
bad_minutes_wireless: 1428
num_aps: 1
num_users: 3
total_minutes: 575217
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/stats/calls/troubleshoot:
get:
tags:
- Sites Stats - Calls
summary: listSiteTroubleshootCalls
description: Summary of calls troubleshoot by site
operationId: listSiteTroubleshootCalls
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: ap
in: query
description: Filter results by AP MAC address
style: form
explode: true
schema:
type: string
examples:
- '001122334455'
- name: meeting_id
in: query
description: Filter results by meeting identifier
style: form
explode: true
schema:
type: string
examples:
- 1234567890abcdef
- name: mac
in: query
description: Filter results by MAC address
style: form
explode: true
schema:
type: string
examples:
- '001122334455'
- name: app
in: query
description: Third party app name
style: form
explode: true
schema:
type: string
examples:
- zoom
- name: wired
in: query
description: Filter results by whether the client is wired
style: form
explode: true
schema:
type: boolean
default: false
examples:
- false
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_call_troubleshoot_summary'
- description: Site call troubleshooting summary response
examples:
- mac: 983a78ea4a44
meeting_id: b784d744-9a7c-4fad-9af0-f78858a319b1
results:
- ap_num_clients: -0.08802365511655807
ap_rtt: 0.09924473613500595
audio_in:
ap_num_clients: 45.48306793636746
ap_rtt: 6.352042701509264
client_cpu: 9.323452578650581
client_radio_band: 0.5841414928436279
client_rssi: 17.251008563571506
client_tx_bytes: 1.8379177401463191
client_tx_rates: 10.668423069847954
client_tx_retries: 43.323209603627525
client_vpn_distance: 112.4420166015625
expected: 29.74261474609375
radio_bandwidth: -0.1533682727151447
radio_channel: 0.662909648484654
radio_util: 27.891777674357098
radio_util_interference: 4.38913492154744
site_num_clients: -0.2855822932389047
site_wan_avg_upload_mbps: -0.988989942603641
site_wan_jitter: 0.7875519659784105
site_wan_rtt: 15.094849904378256
site_wan_upload_mbps: -0.8131117953194512
audio_out:
ap_num_clients: 45.48306793636746
ap_rtt: 6.352042701509264
client_cpu: 9.323452578650581
client_radio_band: 0.5841414928436279
client_rssi: 17.251008563571506
client_tx_bytes: 1.8379177401463191
client_tx_rates: 10.668423069847954
client_tx_retries: 43.323209603627525
client_vpn_distance: 112.4420166015625
expected: 29.74261474609375
radio_bandwidth: -0.1533682727151447
radio_channel: 0.662909648484654
radio_util: 27.891777674357098
radio_util_interference: 4.38913492154744
site_num_clients: -0.2855822932389047
site_wan_avg_upload_mbps: -0.988989942603641
site_wan_jitter: 0.7875519659784105
site_wan_rtt: 15.094849904378256
site_wan_upload_mbps: -0.8131117953194512
client_cpu: 0.00834270566701889
client_n_streams: 0.00734270566701889
client_radio_band: 0.5841414928436279
client_rssi: 0.7594696879386902
client_rx_bytes: 2.365511655807E-05
client_rx_rates: 0.02441493794322014
client_rx_retries: -0.14325742423534393
client_tx_bytes: 0.00102365511655807
client_tx_rates: 0.22236637771129608
client_tx_retries: 0.3308201730251312
client_vpn_distance: -0.0001660545531194657
client_wifi_version: 7.0566701889E-07
expected: -2.8630001056670187
radio_ap_change: 0.01850946433842182
radio_bandwidth: -0.021175479516386986
radio_channel: 0.11686426401138306
radio_rx_failed: 1.1782013177871704
radio_tx_power: 0.121039018034935
radio_util: 0.2452986091375351
radio_util_interference: 3.4367904663085938
site_num_clients: 0.055026158690452576
site_wan_avg_download_mbps: 3.0566701889E-07
site_wan_avg_upload_mbps: 5.566701889E-08
site_wan_download_mbps: 8.0566701889E-07
site_wan_jitter: 0.7875519659784105
site_wan_rtt: 15.094849904378256
site_wan_upload_mbps: 2.0566701889E-07
timestamp: 1695425115
video_in:
ap_num_clients: 45.48306793636746
ap_rtt: 6.352042701509264
client_cpu: 9.323452578650581
client_radio_band: 0.5841414928436279
client_rssi: 17.251008563571506
client_tx_bytes: 1.8379177401463191
client_tx_rates: 10.668423069847954
client_tx_retries: 43.323209603627525
client_vpn_distance: 112.4420166015625
expected: 29.74261474609375
radio_bandwidth: -0.1533682727151447
radio_channel: 0.662909648484654
radio_util: 27.891777674357098
radio_util_interference: 4.38913492154744
site_num_clients: -0.2855822932389047
site_wan_avg_upload_mbps: -0.988989942603641
site_wan_jitter: 0.7875519659784105
site_wan_rtt: 15.094849904378256
site_wan_upload_mbps: -0.8131117953194512
video_out:
ap_num_clients: 45.48306793636746
ap_rtt: 6.352042701509264
client_cpu: 9.323452578650581
client_radio_band: 0.5841414928436279
client_rssi: 17.251008563571506
client_tx_bytes: 1.8379177401463191
client_tx_rates: 10.668423069847954
client_tx_retries: 43.323209603627525
client_vpn_distance: 112.4420166015625
expected: 29.74261474609375
radio_bandwidth: -0.1533682727151447
radio_channel: 0.662909648484654
radio_util: 27.891777674357098
radio_util_interference: 4.38913492154744
site_num_clients: -0.2855822932389047
site_wan_avg_upload_mbps: -0.988989942603641
site_wan_jitter: 0.7875519659784105
site_wan_rtt: 15.094849904378256
site_wan_upload_mbps: -0.8131117953194512
contentMediaType: application/json
examples:
Example:
value:
mac: 983a78ea4a44
meeting_id: b784d744-9a7c-4fad-9af0-f78858a319b1
results:
- ap_num_clients: -0.08802365511655807
ap_rtt: 0.09924473613500595
audio_in:
ap_num_clients: 45.48306793636746
ap_rtt: 6.352042701509264
client_cpu: 9.323452578650581
client_radio_band: 0.5841414928436279
client_rssi: 17.251008563571506
client_tx_bytes: 1.8379177401463191
client_tx_rates: 10.668423069847954
client_tx_retries: 43.323209603627525
client_vpn_distance: 112.4420166015625
expected: 29.74261474609375
radio_bandwidth: -0.1533682727151447
radio_channel: 0.662909648484654
radio_util: 27.891777674357098
radio_util_interference: 4.38913492154744
site_num_clients: -0.2855822932389047
site_wan_avg_upload_mbps: -0.988989942603641
site_wan_jitter: 0.7875519659784105
site_wan_rtt: 15.094849904378256
site_wan_upload_mbps: -0.8131117953194512
audio_out:
ap_num_clients: 45.48306793636746
ap_rtt: 6.352042701509264
client_cpu: 9.323452578650581
client_radio_band: 0.5841414928436279
client_rssi: 17.251008563571506
client_tx_bytes: 1.8379177401463191
client_tx_rates: 10.668423069847954
client_tx_retries: 43.323209603627525
client_vpn_distance: 112.4420166015625
expected: 29.74261474609375
radio_bandwidth: -0.1533682727151447
radio_channel: 0.662909648484654
radio_util: 27.891777674357098
radio_util_interference: 4.38913492154744
site_num_clients: -0.2855822932389047
site_wan_avg_upload_mbps: -0.988989942603641
site_wan_jitter: 0.7875519659784105
site_wan_rtt: 15.094849904378256
site_wan_upload_mbps: -0.8131117953194512
client_cpu: 0.00834270566701889
client_n_streams: 0.00734270566701889
client_radio_band: 0.5841414928436279
client_rssi: 0.7594696879386902
client_rx_bytes: 2.365511655807E-05
client_rx_rates: 0.02441493794322014
client_rx_retries: -0.14325742423534393
client_tx_bytes: 0.00102365511655807
client_tx_rates: 0.22236637771129608
client_tx_retries: 0.3308201730251312
client_vpn_distance: -0.0001660545531194657
client_wifi_version: 7.0566701889E-07
expected: -2.8630001056670187
radio_ap_change: 0.01850946433842182
radio_bandwidth: -0.021175479516386986
radio_channel: 0.11686426401138306
radio_rx_failed: 1.1782013177871704
radio_tx_power: 0.121039018034935
radio_util: 0.2452986091375351
radio_util_interference: 3.4367904663085938
site_num_clients: 0.055026158690452576
site_wan_avg_download_mbps: 3.0566701889E-07
site_wan_avg_upload_mbps: 5.566701889E-08
site_wan_download_mbps: 8.0566701889E-07
site_wan_jitter: 0.7875519659784105
site_wan_rtt: 15.094849904378256
site_wan_upload_mbps: 2.0566701889E-07
timestamp: 1695425115
video_in:
ap_num_clients: 45.48306793636746
ap_rtt: 6.352042701509264
client_cpu: 9.323452578650581
client_radio_band: 0.5841414928436279
client_rssi: 17.251008563571506
client_tx_bytes: 1.8379177401463191
client_tx_rates: 10.668423069847954
client_tx_retries: 43.323209603627525
client_vpn_distance: 112.4420166015625
expected: 29.74261474609375
radio_bandwidth: -0.1533682727151447
radio_channel: 0.662909648484654
radio_util: 27.891777674357098
radio_util_interference: 4.38913492154744
site_num_clients: -0.2855822932389047
site_wan_avg_upload_mbps: -0.988989942603641
site_wan_jitter: 0.7875519659784105
site_wan_rtt: 15.094849904378256
site_wan_upload_mbps: -0.8131117953194512
video_out:
ap_num_clients: 45.48306793636746
ap_rtt: 6.352042701509264
client_cpu: 9.323452578650581
client_radio_band: 0.5841414928436279
client_rssi: 17.251008563571506
client_tx_bytes: 1.8379177401463191
client_tx_rates: 10.668423069847954
client_tx_retries: 43.323209603627525
client_vpn_distance: 112.4420166015625
expected: 29.74261474609375
radio_bandwidth: -0.1533682727151447
radio_channel: 0.662909648484654
radio_util: 27.891777674357098
radio_util_interference: 4.38913492154744
site_num_clients: -0.2855822932389047
site_wan_avg_upload_mbps: -0.988989942603641
site_wan_jitter: 0.7875519659784105
site_wan_rtt: 15.094849904378256
site_wan_upload_mbps: -0.8131117953194512
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_call_troubleshoot_summary'
- description: Site call troubleshooting summary response
examples:
- mac: 983a78ea4a44
meeting_id: b784d744-9a7c-4fad-9af0-f78858a319b1
results:
- ap_num_clients: -0.08802365511655807
ap_rtt: 0.09924473613500595
audio_in:
ap_num_clients: 45.48306793636746
ap_rtt: 6.352042701509264
client_cpu: 9.323452578650581
client_radio_band: 0.5841414928436279
client_rssi: 17.251008563571506
client_tx_bytes: 1.8379177401463191
client_tx_rates: 10.668423069847954
client_tx_retries: 43.323209603627525
client_vpn_distance: 112.4420166015625
expected: 29.74261474609375
radio_bandwidth: -0.1533682727151447
radio_channel: 0.662909648484654
radio_util: 27.891777674357098
radio_util_interference: 4.38913492154744
site_num_clients: -0.2855822932389047
site_wan_avg_upload_mbps: -0.988989942603641
site_wan_jitter: 0.7875519659784105
site_wan_rtt: 15.094849904378256
site_wan_upload_mbps: -0.8131117953194512
audio_out:
ap_num_clients: 45.48306793636746
ap_rtt: 6.352042701509264
client_cpu: 9.323452578650581
client_radio_band: 0.5841414928436279
client_rssi: 17.251008563571506
client_tx_bytes: 1.8379177401463191
client_tx_rates: 10.668423069847954
client_tx_retries: 43.323209603627525
client_vpn_distance: 112.4420166015625
expected: 29.74261474609375
radio_bandwidth: -0.1533682727151447
radio_channel: 0.662909648484654
radio_util: 27.891777674357098
radio_util_interference: 4.38913492154744
site_num_clients: -0.2855822932389047
site_wan_avg_upload_mbps: -0.988989942603641
site_wan_jitter: 0.7875519659784105
site_wan_rtt: 15.094849904378256
site_wan_upload_mbps: -0.8131117953194512
client_cpu: 0.00834270566701889
client_n_streams: 0.00734270566701889
client_radio_band: 0.5841414928436279
client_rssi: 0.7594696879386902
client_rx_bytes: 2.365511655807E-05
client_rx_rates: 0.02441493794322014
client_rx_retries: -0.14325742423534393
client_tx_bytes: 0.00102365511655807
client_tx_rates: 0.22236637771129608
client_tx_retries: 0.3308201730251312
client_vpn_distance: -0.0001660545531194657
client_wifi_version: 7.0566701889E-07
expected: -2.8630001056670187
radio_ap_change: 0.01850946433842182
radio_bandwidth: -0.021175479516386986
radio_channel: 0.11686426401138306
radio_rx_failed: 1.1782013177871704
radio_tx_power: 0.121039018034935
radio_util: 0.2452986091375351
radio_util_interference: 3.4367904663085938
site_num_clients: 0.055026158690452576
site_wan_avg_download_mbps: 3.0566701889E-07
site_wan_avg_upload_mbps: 5.566701889E-08
site_wan_download_mbps: 8.0566701889E-07
site_wan_jitter: 0.7875519659784105
site_wan_rtt: 15.094849904378256
site_wan_upload_mbps: 2.0566701889E-07
timestamp: 1695425115
video_in:
ap_num_clients: 45.48306793636746
ap_rtt: 6.352042701509264
client_cpu: 9.323452578650581
client_radio_band: 0.5841414928436279
client_rssi: 17.251008563571506
client_tx_bytes: 1.8379177401463191
client_tx_rates: 10.668423069847954
client_tx_retries: 43.323209603627525
client_vpn_distance: 112.4420166015625
expected: 29.74261474609375
radio_bandwidth: -0.1533682727151447
radio_channel: 0.662909648484654
radio_util: 27.891777674357098
radio_util_interference: 4.38913492154744
site_num_clients: -0.2855822932389047
site_wan_avg_upload_mbps: -0.988989942603641
site_wan_jitter: 0.7875519659784105
site_wan_rtt: 15.094849904378256
site_wan_upload_mbps: -0.8131117953194512
video_out:
ap_num_clients: 45.48306793636746
ap_rtt: 6.352042701509264
client_cpu: 9.323452578650581
client_radio_band: 0.5841414928436279
client_rssi: 17.251008563571506
client_tx_bytes: 1.8379177401463191
client_tx_rates: 10.668423069847954
client_tx_retries: 43.323209603627525
client_vpn_distance: 112.4420166015625
expected: 29.74261474609375
radio_bandwidth: -0.1533682727151447
radio_channel: 0.662909648484654
radio_util: 27.891777674357098
radio_util_interference: 4.38913492154744
site_num_clients: -0.2855822932389047
site_wan_avg_upload_mbps: -0.988989942603641
site_wan_jitter: 0.7875519659784105
site_wan_rtt: 15.094849904378256
site_wan_upload_mbps: -0.8131117953194512
contentMediaType: application/vnd.api+json
examples:
Example:
value:
mac: 983a78ea4a44
meeting_id: b784d744-9a7c-4fad-9af0-f78858a319b1
results:
- ap_num_clients: -0.08802365511655807
ap_rtt: 0.09924473613500595
audio_in:
ap_num_clients: 45.48306793636746
ap_rtt: 6.352042701509264
client_cpu: 9.323452578650581
client_radio_band: 0.5841414928436279
client_rssi: 17.251008563571506
client_tx_bytes: 1.8379177401463191
client_tx_rates: 10.668423069847954
client_tx_retries: 43.323209603627525
client_vpn_distance: 112.4420166015625
expected: 29.74261474609375
radio_bandwidth: -0.1533682727151447
radio_channel: 0.662909648484654
radio_util: 27.891777674357098
radio_util_interference: 4.38913492154744
site_num_clients: -0.2855822932389047
site_wan_avg_upload_mbps: -0.988989942603641
site_wan_jitter: 0.7875519659784105
site_wan_rtt: 15.094849904378256
site_wan_upload_mbps: -0.8131117953194512
audio_out:
ap_num_clients: 45.48306793636746
ap_rtt: 6.352042701509264
client_cpu: 9.323452578650581
client_radio_band: 0.5841414928436279
client_rssi: 17.251008563571506
client_tx_bytes: 1.8379177401463191
client_tx_rates: 10.668423069847954
client_tx_retries: 43.323209603627525
client_vpn_distance: 112.4420166015625
expected: 29.74261474609375
radio_bandwidth: -0.1533682727151447
radio_channel: 0.662909648484654
radio_util: 27.891777674357098
radio_util_interference: 4.38913492154744
site_num_clients: -0.2855822932389047
site_wan_avg_upload_mbps: -0.988989942603641
site_wan_jitter: 0.7875519659784105
site_wan_rtt: 15.094849904378256
site_wan_upload_mbps: -0.8131117953194512
client_cpu: 0.00834270566701889
client_n_streams: 0.00734270566701889
client_radio_band: 0.5841414928436279
client_rssi: 0.7594696879386902
client_rx_bytes: 2.365511655807E-05
client_rx_rates: 0.02441493794322014
client_rx_retries: -0.14325742423534393
client_tx_bytes: 0.00102365511655807
client_tx_rates: 0.22236637771129608
client_tx_retries: 0.3308201730251312
client_vpn_distance: -0.0001660545531194657
client_wifi_version: 7.0566701889E-07
expected: -2.8630001056670187
radio_ap_change: 0.01850946433842182
radio_bandwidth: -0.021175479516386986
radio_channel: 0.11686426401138306
radio_rx_failed: 1.1782013177871704
radio_tx_power: 0.121039018034935
radio_util: 0.2452986091375351
radio_util_interference: 3.4367904663085938
site_num_clients: 0.055026158690452576
site_wan_avg_download_mbps: 3.0566701889E-07
site_wan_avg_upload_mbps: 5.566701889E-08
site_wan_download_mbps: 8.0566701889E-07
site_wan_jitter: 0.7875519659784105
site_wan_rtt: 15.094849904378256
site_wan_upload_mbps: 2.0566701889E-07
timestamp: 1695425115
video_in:
ap_num_clients: 45.48306793636746
ap_rtt: 6.352042701509264
client_cpu: 9.323452578650581
client_radio_band: 0.5841414928436279
client_rssi: 17.251008563571506
client_tx_bytes: 1.8379177401463191
client_tx_rates: 10.668423069847954
client_tx_retries: 43.323209603627525
client_vpn_distance: 112.4420166015625
expected: 29.74261474609375
radio_bandwidth: -0.1533682727151447
radio_channel: 0.662909648484654
radio_util: 27.891777674357098
radio_util_interference: 4.38913492154744
site_num_clients: -0.2855822932389047
site_wan_avg_upload_mbps: -0.988989942603641
site_wan_jitter: 0.7875519659784105
site_wan_rtt: 15.094849904378256
site_wan_upload_mbps: -0.8131117953194512
video_out:
ap_num_clients: 45.48306793636746
ap_rtt: 6.352042701509264
client_cpu: 9.323452578650581
client_radio_band: 0.5841414928436279
client_rssi: 17.251008563571506
client_tx_bytes: 1.8379177401463191
client_tx_rates: 10.668423069847954
client_tx_retries: 43.323209603627525
client_vpn_distance: 112.4420166015625
expected: 29.74261474609375
radio_bandwidth: -0.1533682727151447
radio_channel: 0.662909648484654
radio_util: 27.891777674357098
radio_util_interference: 4.38913492154744
site_num_clients: -0.2855822932389047
site_wan_avg_upload_mbps: -0.988989942603641
site_wan_jitter: 0.7875519659784105
site_wan_rtt: 15.094849904378256
site_wan_upload_mbps: -0.8131117953194512
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/stats/clients:
get:
tags:
- Sites Stats - Clients Wireless
summary: listSiteWirelessClientsStats
description: Get List of Site All Clients Stats Details
operationId: listSiteWirelessClientsStats
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: wired
in: query
description: Filter results by whether the client is wired
style: form
explode: true
schema:
type: boolean
default: false
examples:
- false
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/stats_client'
description: Client statistics records returned by a stats response
examples:
- - annotation: unknown
ap_id: 00000000-0000-0000-1000-5c5b35963d70
ap_mac: 5c5b358e6fea
assoc_time: 1741152905
band: '5'
bssid: 5c5b358298f2
channel: 157
dual_band: true
family: ''
group: ''
hostname: android-9b228dc33690
idle_time: 5
ip: 10.100.0.47
is_guest: false
key_mgmt: WPA3-SAE-FT/CCMP
last_seen: 1741257505
mac: dadbfc123456
manufacture: Unknown
map_id: ed7a0a4e-8835-4c94-ba78-6c1169c9f135
model: ''
num_locating_aps: 2
os: Android 10
proto: ac
rssi: -39
rx_bps: 0
rx_bytes: 14451780
rx_pkts: 44175
rx_rate: 6
rx_retries: 2010
site_id: 96c348a9-d6d7-4732-b4f5-23350a2843cd
snr: 47
ssid: Live_demo_only
tx_bps: 0
tx_bytes: 56364072
tx_pkts: 43685
tx_rate: 173.3
tx_retries: 5413
uptime: 104600
vlan_id: '1'
wlan_id: 497fc18a-79b5-405a-bf5a-192eed31ea60
x: 695.3357339330526
x_m: 24.086588
y: 760.6746524247893
y_m: 26.349943
contentMediaType: application/json
examples:
Example:
value:
- annotation: unknown
ap_id: 00000000-0000-0000-1000-5c5b35963d70
ap_mac: 5c5b358e6fea
assoc_time: 1741152905
band: '5'
bssid: 5c5b358298f2
channel: 157
dual_band: true
family: ''
group: ''
hostname: android-9b228dc33690
idle_time: 5
ip: 10.100.0.47
is_guest: false
key_mgmt: WPA3-SAE-FT/CCMP
last_seen: 1741257505
mac: dadbfc123456
manufacture: Unknown
map_id: ed7a0a4e-8835-4c94-ba78-6c1169c9f135
model: ''
num_locating_aps: 2
os: Android 10
proto: ac
rssi: -39
rx_bps: 0
rx_bytes: 14451780
rx_pkts: 44175
rx_rate: 6
rx_retries: 2010
site_id: 96c348a9-d6d7-4732-b4f5-23350a2843cd
snr: 47
ssid: Live_demo_only
tx_bps: 0
tx_bytes: 56364072
tx_pkts: 43685
tx_rate: 173.3
tx_retries: 5413
uptime: 104600
vlan_id: '1'
wlan_id: 497fc18a-79b5-405a-bf5a-192eed31ea60
x: 695.3357339330526
x_m: 24.086588
y: 760.6746524247893
y_m: 26.349943
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/stats_client'
description: Client statistics records returned by a stats response
examples:
- - annotation: unknown
ap_id: 00000000-0000-0000-1000-5c5b35963d70
ap_mac: 5c5b358e6fea
assoc_time: 1741152905
band: '5'
bssid: 5c5b358298f2
channel: 157
dual_band: true
family: ''
group: ''
hostname: android-9b228dc33690
idle_time: 5
ip: 10.100.0.47
is_guest: false
key_mgmt: WPA3-SAE-FT/CCMP
last_seen: 1741257505
mac: dadbfc123456
manufacture: Unknown
map_id: ed7a0a4e-8835-4c94-ba78-6c1169c9f135
model: ''
num_locating_aps: 2
os: Android 10
proto: ac
rssi: -39
rx_bps: 0
rx_bytes: 14451780
rx_pkts: 44175
rx_rate: 6
rx_retries: 2010
site_id: 96c348a9-d6d7-4732-b4f5-23350a2843cd
snr: 47
ssid: Live_demo_only
tx_bps: 0
tx_bytes: 56364072
tx_pkts: 43685
tx_rate: 173.3
tx_retries: 5413
uptime: 104600
vlan_id: '1'
wlan_id: 497fc18a-79b5-405a-bf5a-192eed31ea60
x: 695.3357339330526
x_m: 24.086588
y: 760.6746524247893
y_m: 26.349943
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- annotation: unknown
ap_id: 00000000-0000-0000-1000-5c5b35963d70
ap_mac: 5c5b358e6fea
assoc_time: 1741152905
band: '5'
bssid: 5c5b358298f2
channel: 157
dual_band: true
family: ''
group: ''
hostname: android-9b228dc33690
idle_time: 5
ip: 10.100.0.47
is_guest: false
key_mgmt: WPA3-SAE-FT/CCMP
last_seen: 1741257505
mac: dadbfc123456
manufacture: Unknown
map_id: ed7a0a4e-8835-4c94-ba78-6c1169c9f135
model: ''
num_locating_aps: 2
os: Android 10
proto: ac
rssi: -39
rx_bps: 0
rx_bytes: 14451780
rx_pkts: 44175
rx_rate: 6
rx_retries: 2010
site_id: 96c348a9-d6d7-4732-b4f5-23350a2843cd
snr: 47
ssid: Live_demo_only
tx_bps: 0
tx_bytes: 56364072
tx_pkts: 43685
tx_rate: 173.3
tx_retries: 5413
uptime: 104600
vlan_id: '1'
wlan_id: 497fc18a-79b5-405a-bf5a-192eed31ea60
x: 695.3357339330526
x_m: 24.086588
y: 760.6746524247893
y_m: 26.349943
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/stats/clients/{client_mac}:
get:
tags:
- Sites Stats - Clients Wireless
summary: getSiteWirelessClientStats
description: Get Site Client Stats Details
operationId: getSiteWirelessClientStats
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: client_mac
in: path
description: ''
required: true
schema:
pattern: ^[0-9a-fA-F]{12}$
type: string
examples:
- 0000000000ab
- name: wired
in: query
description: Filter results by whether the client is wired
style: form
explode: true
schema:
type: boolean
default: false
examples:
- false
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/stats_client'
- description: Client statistics record for a wireless or wired client
examples:
- annotation: unknown
ap_id: 00000000-0000-0000-1000-5c5b35963d70
ap_mac: 5c5b358e6fea
assoc_time: 1741152905
band: '5'
bssid: 5c5b358298f2
channel: 157
dual_band: true
family: ''
group: ''
hostname: android-9b228dc33690
idle_time: 5
ip: 10.100.0.47
is_guest: false
key_mgmt: WPA3-SAE-FT/CCMP
last_seen: 1741257505
mac: dadbfc123456
manufacture: Unknown
map_id: ed7a0a4e-8835-4c94-ba78-6c1169c9f135
model: ''
num_locating_aps: 2
os: Android 10
proto: ac
rssi: -39
rx_bps: 0
rx_bytes: 14451780
rx_pkts: 44175
rx_rate: 6
rx_retries: 2010
site_id: 96c348a9-d6d7-4732-b4f5-23350a2843cd
snr: 47
ssid: Live_demo_only
tx_bps: 0
tx_bytes: 56364072
tx_pkts: 43685
tx_rate: 173.3
tx_retries: 5413
uptime: 104600
vlan_id: '1'
wlan_id: 497fc18a-79b5-405a-bf5a-192eed31ea60
x: 695.3357339330526
x_m: 24.086588
y: 760.6746524247893
y_m: 26.349943
contentMediaType: application/json
examples:
Example:
value:
annotation: unknown
ap_id: 00000000-0000-0000-1000-5c5b35963d70
ap_mac: 5c5b358e6fea
assoc_time: 1741152905
band: '5'
bssid: 5c5b358298f2
channel: 157
dual_band: true
family: ''
group: ''
hostname: android-9b228dc33690
idle_time: 5
ip: 10.100.0.47
is_guest: false
key_mgmt: WPA3-SAE-FT/CCMP
last_seen: 1741257505
mac: dadbfc123456
manufacture: Unknown
map_id: ed7a0a4e-8835-4c94-ba78-6c1169c9f135
model: ''
num_locating_aps: 2
os: Android 10
proto: ac
rssi: -39
rx_bps: 0
rx_bytes: 14451780
rx_pkts: 44175
rx_rate: 6
rx_retries: 2010
site_id: 96c348a9-d6d7-4732-b4f5-23350a2843cd
snr: 47
ssid: Live_demo_only
tx_bps: 0
tx_bytes: 56364072
tx_pkts: 43685
tx_rate: 173.3
tx_retries: 5413
uptime: 104600
vlan_id: '1'
wlan_id: 497fc18a-79b5-405a-bf5a-192eed31ea60
x: 695.3357339330526
x_m: 24.086588
y: 760.6746524247893
y_m: 26.349943
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/stats_client'
- description: Client statistics record for a wireless or wired client
examples:
- annotation: unknown
ap_id: 00000000-0000-0000-1000-5c5b35963d70
ap_mac: 5c5b358e6fea
assoc_time: 1741152905
band: '5'
bssid: 5c5b358298f2
channel: 157
dual_band: true
family: ''
group: ''
hostname: android-9b228dc33690
idle_time: 5
ip: 10.100.0.47
is_guest: false
key_mgmt: WPA3-SAE-FT/CCMP
last_seen: 1741257505
mac: dadbfc123456
manufacture: Unknown
map_id: ed7a0a4e-8835-4c94-ba78-6c1169c9f135
model: ''
num_locating_aps: 2
os: Android 10
proto: ac
rssi: -39
rx_bps: 0
rx_bytes: 14451780
rx_pkts: 44175
rx_rate: 6
rx_retries: 2010
site_id: 96c348a9-d6d7-4732-b4f5-23350a2843cd
snr: 47
ssid: Live_demo_only
tx_bps: 0
tx_bytes: 56364072
tx_pkts: 43685
tx_rate: 173.3
tx_retries: 5413
uptime: 104600
vlan_id: '1'
wlan_id: 497fc18a-79b5-405a-bf5a-192eed31ea60
x: 695.3357339330526
x_m: 24.086588
y: 760.6746524247893
y_m: 26.349943
contentMediaType: application/vnd.api+json
examples:
Example:
value:
annotation: unknown
ap_id: 00000000-0000-0000-1000-5c5b35963d70
ap_mac: 5c5b358e6fea
assoc_time: 1741152905
band: '5'
bssid: 5c5b358298f2
channel: 157
dual_band: true
family: ''
group: ''
hostname: android-9b228dc33690
idle_time: 5
ip: 10.100.0.47
is_guest: false
key_mgmt: WPA3-SAE-FT/CCMP
last_seen: 1741257505
mac: dadbfc123456
manufacture: Unknown
map_id: ed7a0a4e-8835-4c94-ba78-6c1169c9f135
model: ''
num_locating_aps: 2
os: Android 10
proto: ac
rssi: -39
rx_bps: 0
rx_bytes: 14451780
rx_pkts: 44175
rx_rate: 6
rx_retries: 2010
site_id: 96c348a9-d6d7-4732-b4f5-23350a2843cd
snr: 47
ssid: Live_demo_only
tx_bps: 0
tx_bytes: 56364072
tx_pkts: 43685
tx_rate: 173.3
tx_retries: 5413
uptime: 104600
vlan_id: '1'
wlan_id: 497fc18a-79b5-405a-bf5a-192eed31ea60
x: 695.3357339330526
x_m: 24.086588
y: 760.6746524247893
y_m: 26.349943
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/stats/maps/{map_id}/clients:
get:
tags:
- Sites Stats - Clients Wireless
summary: getSiteWirelessClientsStatsByMap
description: Get Site Clients Stats By Map
operationId: getSiteWirelessClientsStatsByMap
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: map_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/stats_wireless_client'
description: Wireless client statistics records returned by a stats response
examples:
- - annotation: unknown
ap_id: 00000000-0000-0000-1000-5c5b35963d70
ap_mac: 5c5b358e6fea
assoc_time: 1741152905
band: '5'
bssid: 5c5b358298f2
channel: 157
dual_band: true
family: ''
group: ''
hostname: android-9b228dc33690
idle_time: 5
ip: 10.100.0.47
is_guest: false
key_mgmt: WPA3-SAE-FT/CCMP
last_seen: 1741257505
mac: dadbfc123456
manufacture: Unknown
map_id: ed7a0a4e-8835-4c94-ba78-6c1169c9f135
model: ''
num_locating_aps: 2
os: Android 10
proto: ac
rssi: -39
rx_bps: 0
rx_bytes: 14451780
rx_pkts: 44175
rx_rate: 6
rx_retries: 2010
site_id: 96c348a9-d6d7-4732-b4f5-23350a2843cd
snr: 47
ssid: Live_demo_only
tx_bps: 0
tx_bytes: 56364072
tx_pkts: 43685
tx_rate: 173.3
tx_retries: 5413
uptime: 104600
vlan_id: '1'
wlan_id: 497fc18a-79b5-405a-bf5a-192eed31ea60
x: 695.3357339330526
x_m: 24.086588
y: 760.6746524247893
y_m: 26.349943
contentMediaType: application/json
examples:
Example:
value:
- annotation: unknown
ap_id: 00000000-0000-0000-1000-5c5b35963d70
ap_mac: 5c5b358e6fea
assoc_time: 1741152905
band: '5'
bssid: 5c5b358298f2
channel: 157
dual_band: true
family: ''
group: ''
hostname: android-9b228dc33690
idle_time: 5
ip: 10.100.0.47
is_guest: false
key_mgmt: WPA3-SAE-FT/CCMP
last_seen: 1741257505
mac: dadbfc123456
manufacture: Unknown
map_id: ed7a0a4e-8835-4c94-ba78-6c1169c9f135
model: ''
num_locating_aps: 2
os: Android 10
proto: ac
rssi: -39
rx_bps: 0
rx_bytes: 14451780
rx_pkts: 44175
rx_rate: 6
rx_retries: 2010
site_id: 96c348a9-d6d7-4732-b4f5-23350a2843cd
snr: 47
ssid: Live_demo_only
tx_bps: 0
tx_bytes: 56364072
tx_pkts: 43685
tx_rate: 173.3
tx_retries: 5413
uptime: 104600
vlan_id: '1'
wlan_id: 497fc18a-79b5-405a-bf5a-192eed31ea60
x: 695.3357339330526
x_m: 24.086588
y: 760.6746524247893
y_m: 26.349943
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/stats_wireless_client'
description: Wireless client statistics records returned by a stats response
examples:
- - annotation: unknown
ap_id: 00000000-0000-0000-1000-5c5b35963d70
ap_mac: 5c5b358e6fea
assoc_time: 1741152905
band: '5'
bssid: 5c5b358298f2
channel: 157
dual_band: true
family: ''
group: ''
hostname: android-9b228dc33690
idle_time: 5
ip: 10.100.0.47
is_guest: false
key_mgmt: WPA3-SAE-FT/CCMP
last_seen: 1741257505
mac: dadbfc123456
manufacture: Unknown
map_id: ed7a0a4e-8835-4c94-ba78-6c1169c9f135
model: ''
num_locating_aps: 2
os: Android 10
proto: ac
rssi: -39
rx_bps: 0
rx_bytes: 14451780
rx_pkts: 44175
rx_rate: 6
rx_retries: 2010
site_id: 96c348a9-d6d7-4732-b4f5-23350a2843cd
snr: 47
ssid: Live_demo_only
tx_bps: 0
tx_bytes: 56364072
tx_pkts: 43685
tx_rate: 173.3
tx_retries: 5413
uptime: 104600
vlan_id: '1'
wlan_id: 497fc18a-79b5-405a-bf5a-192eed31ea60
x: 695.3357339330526
x_m: 24.086588
y: 760.6746524247893
y_m: 26.349943
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- annotation: unknown
ap_id: 00000000-0000-0000-1000-5c5b35963d70
ap_mac: 5c5b358e6fea
assoc_time: 1741152905
band: '5'
bssid: 5c5b358298f2
channel: 157
dual_band: true
family: ''
group: ''
hostname: android-9b228dc33690
idle_time: 5
ip: 10.100.0.47
is_guest: false
key_mgmt: WPA3-SAE-FT/CCMP
last_seen: 1741257505
mac: dadbfc123456
manufacture: Unknown
map_id: ed7a0a4e-8835-4c94-ba78-6c1169c9f135
model: ''
num_locating_aps: 2
os: Android 10
proto: ac
rssi: -39
rx_bps: 0
rx_bytes: 14451780
rx_pkts: 44175
rx_rate: 6
rx_retries: 2010
site_id: 96c348a9-d6d7-4732-b4f5-23350a2843cd
snr: 47
ssid: Live_demo_only
tx_bps: 0
tx_bytes: 56364072
tx_pkts: 43685
tx_rate: 173.3
tx_retries: 5413
uptime: 104600
vlan_id: '1'
wlan_id: 497fc18a-79b5-405a-bf5a-192eed31ea60
x: 695.3357339330526
x_m: 24.086588
y: 760.6746524247893
y_m: 26.349943
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/stats/maps/{map_id}/unconnected_clients:
get:
tags:
- Sites Stats - Clients Wireless
summary: listSiteUnconnectedClientStats
description: Get List of Site Unconnected Client Location
operationId: listSiteUnconnectedClientStats
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: map_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/stats_unconnected_client'
description: Unconnected Wi-Fi client location statistics returned by the request
examples:
- - ap_mac: 5c5b350e0410
last_seen: 1428939600
mac: 5684dae9ac8b
manufacture: Apple
rssi: -75
x: 60
y: 80
contentMediaType: application/json
examples:
Example:
value:
- ap_mac: 5c5b350e0410
last_seen: 1428939600
mac: 5684dae9ac8b
manufacture: Apple
rssi: -75
x: 60
y: 80
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/stats/maps/{map_id}/sdkclients:
get:
tags:
- Sites Stats - Clients SDK
summary: getSiteSdkStatsByMap
description: Get SdkClient Stats By Map
operationId: getSiteSdkStatsByMap
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: map_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/stats_sdkclient'
description: SDK client statistics records returned by a stats response
contentMediaType: application/json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/stats/sdkclients/{sdkclient_id}:
get:
tags:
- Sites Stats - Clients SDK
summary: getSiteSdkStats
description: Get Detail Stats of a SdkClient
operationId: getSiteSdkStats
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: sdkclient_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/sdkstats_wireless_client'
- description: Detailed statistics for an individual SDK client
examples:
- id: d56bd5fa-0a0a-4861-a9df-5ac83d3a2eeb
last_seen: 1428939600
name: John's iPhone
network_connection:
mac: c3-b6-e5-af-41-15
rssi: -75
signal_level: 3
type: WiFi
uuid: ada72f8f-1643-e5c6-94db-f2a5636f1a64
vbeacons:
- id: d379d29d-24b4-96c5-5dd4-6f2a2dc5aaeb
since: 1428939300
x: 60
y: 80
zones:
- id: 8ac84899-32db-6327-334c-9b6d58544cfe
since: 1428939600
contentMediaType: application/json
examples:
Example:
value:
id: d56bd5fa-0a0a-4861-a9df-5ac83d3a2eeb
last_seen: 1428939600
name: John's iPhone
network_connection:
mac: c3-b6-e5-af-41-15
rssi: -75
signal_level: 3
type: WiFi
uuid: ada72f8f-1643-e5c6-94db-f2a5636f1a64
vbeacons:
- id: d379d29d-24b4-96c5-5dd4-6f2a2dc5aaeb
since: 1428939300
x: 60
y: 80
zones:
- id: 8ac84899-32db-6327-334c-9b6d58544cfe
since: 1428939600
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/stats/devices:
get:
tags:
- Sites Stats - Devices
summary: listSiteDevicesStats
description: List device statistics for a site, including high-level status and performance fields over the requested time range. Use [List Org Device Stats]($e/Orgs%20Stats%20-%20Devices/listOrgDevicesStats) to retrieve device statistics across the organization.
operationId: listSiteDevicesStats
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: type
in: query
description: Filter results by type
style: form
explode: true
schema:
type: string
default: ap
- name: status
in: query
description: 'Filter results by status. enum: `all`, `connected`, `disconnected`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/stat_device_status_filter'
- description: 'Filter results by status. enum: `all`, `connected`, `disconnected`'
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/stats_device'
description: Device statistics records returned by a stats response
examples:
- '[{"auto_upgrade_stat":{"lastcheck":1720594762},"ble_stat":{"beacon_enabled":true,"beacon_rate":4,"eddystone_uid_enabled":false,"eddystone_uid_freq_msec":1000,"eddystone_uid_instance":"5c5b35d0077b","eddystone_uid_namespace":"9777c1a06ef611e68bbf","eddystone_url_enabled":false,"eddystone_url_freq_msec":1000,"eddystone_url_url":"","ibeacon_enabled":false,"ibeacon_freq_msec":1000,"ibeacon_major":894,"ibeacon_minor":9328,"ibeacon_uuid":"af010e2b-f829-4975-b49e-2e896ed1d627","major":894,"minors":[9328,9329,9330,9331,9332,9333,9334,9335,-1],"power":8,"rx_bytes":158500843,"rx_pkts":3549163,"tx_bytes":509640,"tx_pkts":85411,"tx_resets":0,"uuid":"af010e2b-f829-4975-b49e-2e896ed1d627"},"config_reverted":false,"cpu_system":21921854,"cpu_user":7496631,"cpu_util":5,"created_time":1718228350,"env_stat":{"accel_x":-0.092,"accel_y":0.004,"accel_z":-1.02,"ambient_temp":43,"attitude":0,"cpu_temp":53,"humidity":9,"magne_x":0,"magne_y":0,"magne_z":0,"pressure":968,"vcore_voltage":0},"ext_ip":"66.129.234.28","hw_rev":"C02","id":"00000000-0000-0000-1000-5c5b35d0077b","inactive_wired_vlans":[],"ip":"192.168.95.3","ip_stat":{"dhcp_server":"192.168.95.1","dns":["8.8.8.8"],"gateway":"192.168.95.1","ip":"192.168.95.3","ip6":"fe80:0:0:0:5e5b:35ff:fed0:77b","ips":{"vlan1":"192.168.95.3/24,fe80:0:0:0:5e5b:35ff:fed0:77b/64"},"netmask":"255.255.255.0","netmask6":"/64"},"last_seen":1720595866,"last_trouble":{"code":"07","timestamp":1720039666},"lldp_stat":{"chassis_id":"d0:07:ca:f5:21:00","lldp_med_supported":false,"mgmt_addr":"100.123.105.1","mgmt_addrs":["100.123.105.1"],"port_desc":"ge-0/0/4","port_id":"ge-0/0/4","power_allocated":0,"power_draw":0,"power_request_count":0,"power_requested":0,"system_desc":"Juniper Networks, Inc. ex4300-48t internet router, kernel JUNOS 20.4R3-S7.2, Build date: 2023-04-21 19:47:18 UTC Copyright (c) 1996-2023 Juniper Networks, Inc.","system_name":"Phoenix-Switch"},"mac":"5c5b35d0077b","mem_total_kb":505468,"mem_used_kb":202096,"model":"AP43","modified_time":1718530662,"mount":"faceup","name":"Phoenix","notes":"","num_clients":1,"org_id":"af010e2b-f829-4975-b49e-2e896ed1d627","port_stat":{"eth0":{"full_duplex":true,"rx_bytes":1284143195,"rx_errors":0,"rx_peak_bps":17585,"rx_pkts":5199816,"speed":1000,"tx_bytes":1283744961,"tx_peak_bps":26484,"tx_pkts":3990463,"up":true},"eth1":{"full_duplex":false,"rx_bytes":0,"rx_errors":0,"rx_peak_bps":0,"rx_pkts":0,"speed":0,"tx_bytes":0,"tx_peak_bps":0,"tx_pkts":0,"up":false}},"power_budget":8400,"power_constrained":false,"power_src":"DC Input","radio_config":{},"radio_stat":{"band_24":{"bandwidth":20,"channel":11,"mac":"5c5b35dea810","noise_floor":-80,"num_clients":0,"power":17,"rx_bytes":12948211,"rx_pkts":65292,"tx_bytes":19071943,"tx_pkts":76926,"usage":"24","util_all":24,"util_non_wifi":2,"util_rx_in_bss":0,"util_rx_other_bss":17,"util_tx":4,"util_undecodable_wifi":0,"util_unknown_wifi":1},"band_5":{"bandwidth":40,"channel":36,"mac":"5c5b35dea7f0","noise_floor":-90,"num_clients":1,"power":17,"rx_bytes":578362619,"rx_pkts":2687577,"tx_bytes":1199571353,"tx_pkts":2479302,"usage":"5","util_all":13,"util_non_wifi":0,"util_rx_in_bss":0,"util_rx_other_bss":10,"util_tx":1,"util_undecodable_wifi":0,"util_unknown_wifi":1}},"rx_bps":9276,"rx_bytes":591310830,"rx_pkts":2752869,"serial":"A0703200709E6","site_id":"46fc665e-9706-4296-8fe2-78f42f2e67e4","status":"connected","switch_redundancy":{"num_redundant_aps":1},"tx_bps":8067,"tx_bytes":1218643296,"tx_pkts":2556228,"type":"ap","uptime":1593120,"version":"0.14.29313"}]'
- '[{"arp_table_stats":{"arp_table_count":21,"max_entries_supported":64000},"auto_upgrade_stat":{"lastcheck":1720595477},"cert_expiry":1743292763,"cluster_config":{"configuration":"active-active","control_link_info":{"name":"fxp1","status":"Up"},"ethernet_connection":[{"name":"reth0","status":"Up"},{"name":"reth1","status":"Up"},{"name":"reth2","status":"Down"},{"name":"reth3","status":"Down"},{"name":"reth4","status":"Up"}],"fabric_link_info":{"DataPlaneNotifiedStatus":"Up","Interface":[],"InternalStatus":"Up","State":"Enabled","Status":"Enabled"},"last_status_change_reason":"No failures","operational":"active-active","primary_node_health":"Healthy","redundancy_group_information":[{"Id":0,"MonitoringFailure":"none","Threshold":255},{"Id":1,"MonitoringFailure":"interface-monitoring","Threshold":0},{"Id":2,"MonitoringFailure":"none","Threshold":255}],"secondary_node_health":"Not healthy","status":"Green"},"config_status":"COMMITED","config_timestamp":1720182848,"config_version":1720182848,"cpu2_stat":{"idle":86,"interrupt":0,"load_avg":[0.13,0.17,0.16],"system":5,"user":9},"cpu_stat":{"idle":76,"interrupt":0,"load_avg":[0.18,0.31,0.39],"system":10,"user":14},"created_time":1711756611,"deviceprofile_id":"5e5daedf-e650-4013-b41c-845f0d2b9414","deviceprofile_name":"wan_srx_tor_hub1","dhcpd_stat":{"byod_dc1":{"num_ips":100,"num_leased":0},"corp_dc1":{"num_ips":100,"num_leased":4},"guest_dc1":{"num_ips":241,"num_leased":0},"iot_dc1":{"num_ips":100,"num_leased":0},"mgmt_dc1":{"num_ips":100,"num_leased":2},"teleworker":{"num_ips":140,"num_leased":0}},"ext_ip":"69.196.157.189","fwupdate":{"progress":100,"status":"upgraded","status_id":3037,"timestamp":1718392692.580769,"will_retry":false},"has_pcap":false,"hostname":"wan_srx_tor_hub1-srx","id":"00000000-0000-0000-1000-4db14e107134","if_stat":{"ge-0/0/5.130":{"address_mode":"Unknown","nat_addresses":[],"network_name":"","port_id":"ge-0/0/5","port_usage":"lan","rx_bytes":0,"rx_pkts":0,"tx_bytes":0,"tx_pkts":0,"up":true,"vlan":0},"ge-1/0/5.120":{"address_mode":"Unknown","nat_addresses":[],"network_name":"","port_id":"ge-1/0/5","port_usage":"lan","rx_bytes":0,"rx_pkts":0,"tx_bytes":0,"tx_pkts":0,"up":true,"vlan":0}},"ip":"69.196.157.190","ip_stat":{"gateway":"69.196.157.185","ip":"69.196.157.190","ips":{"vlan1":"69.196.157.190,69.196.157.190"},"netmask":"255.255.255.255"},"is_ha":true,"last_seen":1720598726,"mac":"4db14e107134","mac_table_stats":{"mac_table_count":0,"max_mac_entries_supported":160000},"memory2_stat":{"usage":32},"memory_stat":{"usage":39},"model":"SRX300","modified_time":1720092942,"module2_stat":[{"backup_version":"21.2R3-S7.7","fans":[],"last_seen":1720598717,"mac":"ec38739270c0","model":"SRX300","psus":[{"name":"Power Supply 0","status":"ok"}],"recovery_version":"21.2R3-S7.7","serial":"CV2218AF1505","status":"connected","temperatures":[{"celsius":49,"name":"Routing Engine","status":"ok"},{"celsius":64,"name":"Routing Engine CPU","status":"ok"}],"uptime":580964,"vc_links":[{"neighbor_module_idx":0,"neighbor_port_id":"fxp1","port_id":"fxp1"}],"vc_role":"secondary","vc_state":"active","version":"21.2R3-S6.11"}],"module_stat":[{"backup_version":"21.2R3-S7.7","fans":[],"last_seen":1720598716.999985,"mac":"4db14e107134","model":"SRX300","psus":[{"name":"Power Supply 0","status":"ok"}],"recovery_version":"21.2R3-S7.7","serial":"CV0219AN0335","status":"connected","temperatures":[{"celsius":49,"name":"Routing Engine","status":"ok"},{"celsius":65,"name":"Routing Engine CPU","status":"ok"}],"uptime":1945193,"vc_links":[{"neighbor_module_idx":1,"neighbor_port_id":"fxp1","port_id":"fxp1"}],"vc_role":"primary","vc_state":"active","version":"21.2R3-S6.11"}],"name":"wan_srx_tor_hub1-srx","org_id":"af010e2b-f829-4975-b49e-2e896ed1d627","route_summary_stats":{"fib_routes":0,"max_unicast_routes_supported":1240000,"rib_routes":0,"total_routes":0},"serial":"CV0219AN0335","service_stat":{},"service_status":{"appid_status":"enabled","appid_version":3720,"ewf_status":"disabled","idp_install_result":"successful","idp_install_timestamp":"2024-07-10T06:29:11.708164029Z","idp_status":"disabled","idp_update_timestamp":"2024-07-10T06:28:28.567046244Z"},"site_id":"83c31971-ad70-4419-ae20-7f2b90748986","spu2_stat":[{"spu_cpu":0,"spu_current_session":39,"spu_max_session":32768,"spu_memory":31,"spu_pending_session":0,"spu_uptime":1944572,"spu_valid_session":0}],"spu_stat":[{"spu_cpu":1,"spu_current_session":47,"spu_max_session":32768,"spu_memory":34,"spu_pending_session":0,"spu_uptime":1944572,"spu_valid_session":0}],"status":"connected","tag_id":3550217,"tag_uuid":"af010e2b-f829-4975-b49e-2e896ed1d627","type":"gateway","uptime":581259,"version":"21.2R3-S6.11"}]'
- '[{"ap_redundancy":{"num_aps":1,"num_aps_with_switch_redundancy":1},"arp_table_stats":{"arp_table_count":16,"max_entries_supported":32000},"auto_upgrade_stat":{"lastcheck":1720600596},"cert_expiry":1743932274,"clients":[{"device_mac":"0912f561b653","mac":"001132f5ad23","port_id":"ge-1/0/11"}],"clients_stats":{"total":{"num_aps":[0,0],"num_wired_clients":13}},"config_status":"COMMITED","config_timestamp":1720552389,"config_version":1720552389,"cpu_stat":{"idle":74,"interrupt":0,"load_avg":[0.8,0.75,0.78],"system":13,"user":13},"created_time":1712346090,"dhcpd_stat":{"ifo":{"num_ips":5,"num_leased":0}},"ext_ip":"153.142.221.41","fw_versions_outofsync":false,"fwupdate":{"progress":100,"status":"upgraded","status_id":3037,"timestamp":1712409702.9714448,"will_retry":false},"has_pcap":true,"hostname":"SW-HLAB-ea2e00","hw_rev":"A","id":"00000000-0000-0000-1000-0912f561b653","if_stat":{"ge-0/0/5.0":{"port_id":"ge-0/0/5","rx_bytes":0,"rx_pkts":78110,"tx_bytes":0,"tx_pkts":61037,"up":true},"ge-1/0/0.0":{"port_id":"ge-1/0/0","rx_bytes":0,"rx_pkts":56415,"tx_bytes":0,"tx_pkts":72209,"up":true},"irb.172":{"ips":["10.3.172.41/24"],"port_id":"irb","rx_bytes":0,"rx_pkts":1291755,"servp_info":{},"tx_bytes":0,"tx_pkts":990327,"up":true,"vlan":172},"vme.0":{"port_id":"vme","rx_bytes":0,"rx_pkts":0,"tx_bytes":0,"tx_pkts":0,"up":true}},"ip":"10.3.10.10","ip_stat":{"gateway":"10.3.172.9","ip":"10.3.10.10","ips":{"vlan172":"10.3.172.41"},"netmask":"255.255.255.255"},"last_seen":1720601189,"last_trouble":{"code":"103","timestamp":1712412455215},"mac":"0912f561b653","mac_table_stats":{"mac_table_count":58,"max_mac_entries_supported":64000},"memory_stat":{"usage":16},"model":"EX4100-F-12P","modified_time":1720552388,"module_stat":[{"boot_partition":"junos","cpu_stat":{"idle":74,"interrupt":0,"load_avg":[0.8,0.75,0.78],"system":13,"user":13},"fpc_idx":0,"mac":"0912f561b653","memory_stat":{"usage":16},"model":"EX4100-F-12P","pics":[{"index":0,"model_number":"EX4100-F-12P","port_groups":[{"count":12,"type":"GE"}]},{"index":1,"model_number":"EX4100-F-12P","port_groups":[{"count":4,"type":"SFP/SFP+"}]},{"index":2,"model_number":"EX4100-F-12P","port_groups":[{"count":2,"type":"GE"}]}],"poe":{"max_power":180,"power_draw":7.3},"psus":[{"name":"Power Supply 0","status":"ok"},{"name":"Power Supply 1","status":"absent"},{"name":"Power Supply 2","status":"absent"}],"serial":"FJ0324AV0077","temperatures":[{"celsius":51,"name":"Thermal board Sensor 1","status":"ok"},{"celsius":51,"name":"Thermal board Sensor 2","status":"ok"},{"celsius":50,"name":"Thermal board Sensor 3","status":"ok"},{"celsius":57,"name":"PFE Die Sensor","status":"ok"}],"type":"fpc","uptime":1692720,"vc_links":[{"neighbor_module_idx":1,"neighbor_port_id":"vcp-1/1/1","port_id":"vcp-0/1/0"},{"neighbor_module_idx":1,"neighbor_port_id":"vcp-1/1/0","port_id":"vcp-0/1/1"}],"vc_mode":"HiGiG","vc_role":"master","vc_state":"present","version":"22.4R3.25"},{"boot_partition":"junos","cpu_stat":{"idle":79,"interrupt":0,"load_avg":[0.52,0.46,0.46],"system":6,"user":15},"fpc_idx":1,"mac":"485a0deb2380","memory_stat":{"usage":14},"model":"EX4100-F-12P","pics":[{"index":0,"model_number":"EX4100-F-12P","port_groups":[{"count":12,"type":"GE"}]},{"index":1,"model_number":"EX4100-F-12P","port_groups":[{"count":4,"type":"SFP/SFP+"}]},{"index":2,"model_number":"EX4100-F-12P","port_groups":[{"count":2,"type":"GE"}]}],"poe":{"max_power":180,"power_draw":22.1},"psus":[{"name":"Power Supply 0","status":"ok"},{"name":"Power Supply 1","status":"absent"},{"name":"Power Supply 2","status":"absent"}],"serial":"FJ0424AV0101","temperatures":[{"celsius":52,"name":"Thermal board Sensor 1","status":"ok"},{"celsius":53,"name":"Thermal board Sensor 2","status":"ok"},{"celsius":52,"name":"Thermal board Sensor 3","status":"ok"},{"celsius":59,"name":"PFE Die Sensor","status":"ok"}],"type":"fpc","uptime":1692720,"vc_links":[{"neighbor_module_idx":0,"neighbor_port_id":"vcp-0/1/1","port_id":"vcp-1/1/0"},{"neighbor_module_idx":0,"neighbor_port_id":"vcp-0/1/0","port_id":"vcp-1/1/1"}],"vc_mode":"HiGiG","vc_role":"backup","vc_state":"present","version":"22.4R3.25"}],"name":"SW-HLAB-ea2e00","org_id":"c5324060-19da-48fa-af28-2b530bd08765","route_summary_stats":{"fib_routes":7,"max_unicast_routes_supported":32150,"rib_routes":40,"total_routes":3},"serial":"FJ0324AV0077","site_id":"a0e43ffb-94a6-4f27-92aa-9cf832e1143d","status":"connected","tag_id":3564806,"tag_uuid":"507604a4-6b34-449c-acb3-87955430b006","type":"switch","uptime":1692720,"vc_mac":"0912f561b653","vc_setup_info":{"config_type":"nonprovisioned","err_missing_dev_id_fpc":false},"version":"22.4R3.25"}]'
contentMediaType: application/json
examples:
Access Point Stats:
value:
- auto_upgrade_stat:
lastcheck: 1720594762
ble_stat:
beacon_enabled: true
beacon_rate: 4
eddystone_uid_enabled: false
eddystone_uid_freq_msec: 1000
eddystone_uid_instance: 5c5b35d0077b
eddystone_uid_namespace: 9777c1a06ef611e68bbf
eddystone_url_enabled: false
eddystone_url_freq_msec: 1000
eddystone_url_url: ''
ibeacon_enabled: false
ibeacon_freq_msec: 1000
ibeacon_major: 894
ibeacon_minor: 9328
ibeacon_uuid: af010e2b-f829-4975-b49e-2e896ed1d627
major: 894
minors:
- 9328
- 9329
- 9330
- 9331
- 9332
- 9333
- 9334
- 9335
- -1
power: 8
rx_bytes: 158500843
rx_pkts: 3549163
tx_bytes: 509640
tx_pkts: 85411
tx_resets: 0
uuid: af010e2b-f829-4975-b49e-2e896ed1d627
config_reverted: false
cpu_system: 21921854
cpu_user: 7496631
cpu_util: 5
created_time: 1718228350
env_stat:
accel_x: -0.092
accel_y: 0.004
accel_z: -1.02
ambient_temp: 43
attitude: 0
cpu_temp: 53
humidity: 9
magne_x: 0
magne_y: 0
magne_z: 0
pressure: 968
vcore_voltage: 0
ext_ip: 66.129.234.28
hw_rev: C02
id: 00000000-0000-0000-1000-5c5b35d0077b
inactive_wired_vlans: []
ip: 192.168.95.3
ip_stat:
dhcp_server: 192.168.95.1
dns:
- 8.8.8.8
gateway: 192.168.95.1
ip: 192.168.95.3
ip6: fe80:0:0:0:5e5b:35ff:fed0:77b
ips:
vlan1: 192.168.95.3/24,fe80:0:0:0:5e5b:35ff:fed0:77b/64
netmask: 255.255.255.0
netmask6: /64
last_seen: 1720595866
last_trouble:
code: '07'
timestamp: 1720039666
lldp_stat:
chassis_id: d0:07:ca:f5:21:00
lldp_med_supported: false
mgmt_addr: 100.123.105.1
mgmt_addrs:
- 100.123.105.1
port_desc: ge-0/0/4
port_id: ge-0/0/4
power_allocated: 0
power_draw: 0
power_request_count: 0
power_requested: 0
system_desc: 'Juniper Networks, Inc. ex4300-48t internet router, kernel JUNOS 20.4R3-S7.2, Build date: 2023-04-21 19:47:18 UTC Copyright (c) 1996-2023 Juniper Networks, Inc.'
system_name: Phoenix-Switch
mac: 5c5b35d0077b
mem_total_kb: 505468
mem_used_kb: 202096
model: AP43
modified_time: 1718530662
mount: faceup
name: Phoenix
notes: ''
num_clients: 1
org_id: af010e2b-f829-4975-b49e-2e896ed1d627
port_stat:
eth0:
full_duplex: true
rx_bytes: 1284143195
rx_errors: 0
rx_peak_bps: 17585
rx_pkts: 5199816
speed: 1000
tx_bytes: 1283744961
tx_peak_bps: 26484
tx_pkts: 3990463
up: true
eth1:
full_duplex: false
rx_bytes: 0
rx_errors: 0
rx_peak_bps: 0
rx_pkts: 0
speed: 0
tx_bytes: 0
tx_peak_bps: 0
tx_pkts: 0
up: false
power_budget: 8400
power_constrained: false
power_src: DC Input
radio_config: {}
radio_stat:
band_24:
bandwidth: 20
channel: 11
mac: 5c5b35dea810
noise_floor: -80
num_clients: 0
power: 17
rx_bytes: 12948211
rx_pkts: 65292
tx_bytes: 19071943
tx_pkts: 76926
usage: '24'
util_all: 24
util_non_wifi: 2
util_rx_in_bss: 0
util_rx_other_bss: 17
util_tx: 4
util_undecodable_wifi: 0
util_unknown_wifi: 1
band_5:
bandwidth: 40
channel: 36
mac: 5c5b35dea7f0
noise_floor: -90
num_clients: 1
power: 17
rx_bytes: 578362619
rx_pkts: 2687577
tx_bytes: 1199571353
tx_pkts: 2479302
usage: '5'
util_all: 13
util_non_wifi: 0
util_rx_in_bss: 0
util_rx_other_bss: 10
util_tx: 1
util_undecodable_wifi: 0
util_unknown_wifi: 1
rx_bps: 9276
rx_bytes: 591310830
rx_pkts: 2752869
serial: A0703200709E6
site_id: 46fc665e-9706-4296-8fe2-78f42f2e67e4
status: connected
switch_redundancy:
num_redundant_aps: 1
tx_bps: 8067
tx_bytes: 1218643296
tx_pkts: 2556228
type: ap
uptime: 1593120
version: 0.14.29313
Gateway Stats:
value:
- arp_table_stats:
arp_table_count: 21
max_entries_supported: 64000
auto_upgrade_stat:
lastcheck: 1720595477
cert_expiry: 1743292763
cluster_config:
configuration: active-active
control_link_info:
name: fxp1
status: Up
ethernet_connection:
- name: reth0
status: Up
- name: reth1
status: Up
- name: reth2
status: Down
- name: reth3
status: Down
- name: reth4
status: Up
fabric_link_info:
DataPlaneNotifiedStatus: Up
Interface: []
InternalStatus: Up
State: Enabled
Status: Enabled
last_status_change_reason: No failures
operational: active-active
primary_node_health: Healthy
redundancy_group_information:
- Id: 0
MonitoringFailure: none
Threshold: 255
- Id: 1
MonitoringFailure: interface-monitoring
Threshold: 0
- Id: 2
MonitoringFailure: none
Threshold: 255
secondary_node_health: Not healthy
status: Green
config_status: COMMITED
config_timestamp: 1720182848
config_version: 1720182848
cpu2_stat:
idle: 86
interrupt: 0
load_avg:
- 0.13
- 0.17
- 0.16
system: 5
user: 9
cpu_stat:
idle: 76
interrupt: 0
load_avg:
- 0.18
- 0.31
- 0.39
system: 10
user: 14
created_time: 1711756611
deviceprofile_id: 5e5daedf-e650-4013-b41c-845f0d2b9414
deviceprofile_name: wan_srx_tor_hub1
dhcpd_stat:
byod_dc1:
num_ips: 100
num_leased: 0
corp_dc1:
num_ips: 100
num_leased: 4
guest_dc1:
num_ips: 241
num_leased: 0
iot_dc1:
num_ips: 100
num_leased: 0
mgmt_dc1:
num_ips: 100
num_leased: 2
teleworker:
num_ips: 140
num_leased: 0
ext_ip: 69.196.157.189
fwupdate:
progress: 100
status: upgraded
status_id: 3037
timestamp: 1718392692.580769
will_retry: false
has_pcap: false
hostname: wan_srx_tor_hub1-srx
id: 00000000-0000-0000-1000-4db14e107134
if_stat:
ge-0/0/5.130:
address_mode: Unknown
nat_addresses: []
network_name: ''
port_id: ge-0/0/5
port_usage: lan
rx_bytes: 0
rx_pkts: 0
tx_bytes: 0
tx_pkts: 0
up: true
vlan: 0
ge-1/0/5.120:
address_mode: Unknown
nat_addresses: []
network_name: ''
port_id: ge-1/0/5
port_usage: lan
rx_bytes: 0
rx_pkts: 0
tx_bytes: 0
tx_pkts: 0
up: true
vlan: 0
ip: 69.196.157.190
ip_stat:
gateway: 69.196.157.185
ip: 69.196.157.190
ips:
vlan1: 69.196.157.190,69.196.157.190
netmask: 255.255.255.255
is_ha: true
last_seen: 1720598726
mac: 4db14e107134
mac_table_stats:
mac_table_count: 0
max_mac_entries_supported: 160000
memory2_stat:
usage: 32
memory_stat:
usage: 39
model: SRX300
modified_time: 1720092942
module2_stat:
- backup_version: 21.2R3-S7.7
fans: []
last_seen: 1720598717
mac: ec38739270c0
model: SRX300
psus:
- name: Power Supply 0
status: ok
recovery_version: 21.2R3-S7.7
serial: CV2218AF1505
status: connected
temperatures:
- celsius: 49
name: Routing Engine
status: ok
- celsius: 64
name: Routing Engine CPU
status: ok
uptime: 580964
vc_links:
- neighbor_module_idx: 0
neighbor_port_id: fxp1
port_id: fxp1
vc_role: secondary
vc_state: active
version: 21.2R3-S6.11
module_stat:
- backup_version: 21.2R3-S7.7
fans: []
last_seen: 1720598716.999985
mac: 4db14e107134
model: SRX300
psus:
- name: Power Supply 0
status: ok
recovery_version: 21.2R3-S7.7
serial: CV0219AN0335
status: connected
temperatures:
- celsius: 49
name: Routing Engine
status: ok
- celsius: 65
name: Routing Engine CPU
status: ok
uptime: 1945193
vc_links:
- neighbor_module_idx: 1
neighbor_port_id: fxp1
port_id: fxp1
vc_role: primary
vc_state: active
version: 21.2R3-S6.11
name: wan_srx_tor_hub1-srx
org_id: af010e2b-f829-4975-b49e-2e896ed1d627
route_summary_stats:
fib_routes: 0
max_unicast_routes_supported: 1240000
rib_routes: 0
total_routes: 0
serial: CV0219AN0335
service_stat: {}
service_status:
appid_status: enabled
appid_version: 3720
ewf_status: disabled
idp_install_result: successful
idp_install_timestamp: 2024-07-10T06:29:11.708164029Z
idp_status: disabled
idp_update_timestamp: 2024-07-10T06:28:28.567046244Z
site_id: 83c31971-ad70-4419-ae20-7f2b90748986
spu2_stat:
- spu_cpu: 0
spu_current_session: 39
spu_max_session: 32768
spu_memory: 31
spu_pending_session: 0
spu_uptime: 1944572
spu_valid_session: 0
spu_stat:
- spu_cpu: 1
spu_current_session: 47
spu_max_session: 32768
spu_memory: 34
spu_pending_session: 0
spu_uptime: 1944572
spu_valid_session: 0
status: connected
tag_id: 3550217
tag_uuid: af010e2b-f829-4975-b49e-2e896ed1d627
type: gateway
uptime: 581259
version: 21.2R3-S6.11
Switch:
value:
- ap_redundancy:
num_aps: 1
num_aps_with_switch_redundancy: 1
arp_table_stats:
arp_table_count: 16
max_entries_supported: 32000
auto_upgrade_stat:
lastcheck: 1720600596
cert_expiry: 1743932274
clients:
- device_mac: 0912f561b653
mac: 001132f5ad23
port_id: ge-1/0/11
clients_stats:
total:
num_aps:
- 0
- 0
num_wired_clients: 13
config_status: COMMITED
config_timestamp: 1720552389
config_version: 1720552389
cpu_stat:
idle: 74
interrupt: 0
load_avg:
- 0.8
- 0.75
- 0.78
system: 13
user: 13
created_time: 1712346090
dhcpd_stat:
ifo:
num_ips: 5
num_leased: 0
ext_ip: 153.142.221.41
fw_versions_outofsync: false
fwupdate:
progress: 100
status: upgraded
status_id: 3037
timestamp: 1712409702.9714448
will_retry: false
has_pcap: true
hostname: SW-HLAB-ea2e00
hw_rev: A
id: 00000000-0000-0000-1000-0912f561b653
if_stat:
ge-0/0/5.0:
port_id: ge-0/0/5
rx_bytes: 0
rx_pkts: 78110
tx_bytes: 0
tx_pkts: 61037
up: true
ge-1/0/0.0:
port_id: ge-1/0/0
rx_bytes: 0
rx_pkts: 56415
tx_bytes: 0
tx_pkts: 72209
up: true
irb.172:
ips:
- 10.3.172.41/24
port_id: irb
rx_bytes: 0
rx_pkts: 1291755
servp_info: {}
tx_bytes: 0
tx_pkts: 990327
up: true
vlan: 172
vme.0:
port_id: vme
rx_bytes: 0
rx_pkts: 0
tx_bytes: 0
tx_pkts: 0
up: true
ip: 10.3.10.10
ip_stat:
gateway: 10.3.172.9
ip: 10.3.10.10
ips:
vlan172: 10.3.172.41
netmask: 255.255.255.255
last_seen: 1720601189
last_trouble:
code: '103'
timestamp: 1712412455215
mac: 0912f561b653
mac_table_stats:
mac_table_count: 58
max_mac_entries_supported: 64000
memory_stat:
usage: 16
model: EX4100-F-12P
modified_time: 1720552388
module_stat:
- boot_partition: junos
cpu_stat:
idle: 74
interrupt: 0
load_avg:
- 0.8
- 0.75
- 0.78
system: 13
user: 13
fpc_idx: 0
mac: 0912f561b653
memory_stat:
usage: 16
model: EX4100-F-12P
pics:
- index: 0
model_number: EX4100-F-12P
port_groups:
- count: 12
type: GE
- index: 1
model_number: EX4100-F-12P
port_groups:
- count: 4
type: SFP/SFP+
- index: 2
model_number: EX4100-F-12P
port_groups:
- count: 2
type: GE
poe:
max_power: 180
power_draw: 7.3
psus:
- name: Power Supply 0
status: ok
- name: Power Supply 1
status: absent
- name: Power Supply 2
status: absent
serial: FJ0324AV0077
temperatures:
- celsius: 51
name: Thermal board Sensor 1
status: ok
- celsius: 51
name: Thermal board Sensor 2
status: ok
- celsius: 50
name: Thermal board Sensor 3
status: ok
- celsius: 57
name: PFE Die Sensor
status: ok
type: fpc
uptime: 1692720
vc_links:
- neighbor_module_idx: 1
neighbor_port_id: vcp-1/1/1
port_id: vcp-0/1/0
- neighbor_module_idx: 1
neighbor_port_id: vcp-1/1/0
port_id: vcp-0/1/1
vc_mode: HiGiG
vc_role: master
vc_state: present
version: 22.4R3.25
- boot_partition: junos
cpu_stat:
idle: 79
interrupt: 0
load_avg:
- 0.52
- 0.46
- 0.46
system: 6
user: 15
fpc_idx: 1
mac: 485a0deb2380
memory_stat:
usage: 14
model: EX4100-F-12P
pics:
- index: 0
model_number: EX4100-F-12P
port_groups:
- count: 12
type: GE
- index: 1
model_number: EX4100-F-12P
port_groups:
- count: 4
type: SFP/SFP+
- index: 2
model_number: EX4100-F-12P
port_groups:
- count: 2
type: GE
poe:
max_power: 180
power_draw: 22.1
psus:
- name: Power Supply 0
status: ok
- name: Power Supply 1
status: absent
- name: Power Supply 2
status: absent
serial: FJ0424AV0101
temperatures:
- celsius: 52
name: Thermal board Sensor 1
status: ok
- celsius: 53
name: Thermal board Sensor 2
status: ok
- celsius: 52
name: Thermal board Sensor 3
status: ok
- celsius: 59
name: PFE Die Sensor
status: ok
type: fpc
uptime: 1692720
vc_links:
- neighbor_module_idx: 0
neighbor_port_id: vcp-0/1/1
port_id: vcp-1/1/0
- neighbor_module_idx: 0
neighbor_port_id: vcp-0/1/0
port_id: vcp-1/1/1
vc_mode: HiGiG
vc_role: backup
vc_state: present
version: 22.4R3.25
name: SW-HLAB-ea2e00
org_id: c5324060-19da-48fa-af28-2b530bd08765
route_summary_stats:
fib_routes: 7
max_unicast_routes_supported: 32150
rib_routes: 40
total_routes: 3
serial: FJ0324AV0077
site_id: a0e43ffb-94a6-4f27-92aa-9cf832e1143d
status: connected
tag_id: 3564806
tag_uuid: 507604a4-6b34-449c-acb3-87955430b006
type: switch
uptime: 1692720
vc_mac: 0912f561b653
vc_setup_info:
config_type: nonprovisioned
err_missing_dev_id_fpc: false
version: 22.4R3.25
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/stats_device'
description: Device statistics records returned by a stats response
examples:
- '[{"auto_upgrade_stat":{"lastcheck":1720594762},"ble_stat":{"beacon_enabled":true,"beacon_rate":4,"eddystone_uid_enabled":false,"eddystone_uid_freq_msec":1000,"eddystone_uid_instance":"5c5b35d0077b","eddystone_uid_namespace":"9777c1a06ef611e68bbf","eddystone_url_enabled":false,"eddystone_url_freq_msec":1000,"eddystone_url_url":"","ibeacon_enabled":false,"ibeacon_freq_msec":1000,"ibeacon_major":894,"ibeacon_minor":9328,"ibeacon_uuid":"af010e2b-f829-4975-b49e-2e896ed1d627","major":894,"minors":[9328,9329,9330,9331,9332,9333,9334,9335,-1],"power":8,"rx_bytes":158500843,"rx_pkts":3549163,"tx_bytes":509640,"tx_pkts":85411,"tx_resets":0,"uuid":"af010e2b-f829-4975-b49e-2e896ed1d627"},"config_reverted":false,"cpu_system":21921854,"cpu_user":7496631,"cpu_util":5,"created_time":1718228350,"env_stat":{"accel_x":-0.092,"accel_y":0.004,"accel_z":-1.02,"ambient_temp":43,"attitude":0,"cpu_temp":53,"humidity":9,"magne_x":0,"magne_y":0,"magne_z":0,"pressure":968,"vcore_voltage":0},"ext_ip":"66.129.234.28","hw_rev":"C02","id":"00000000-0000-0000-1000-5c5b35d0077b","inactive_wired_vlans":[],"ip":"192.168.95.3","ip_stat":{"dhcp_server":"192.168.95.1","dns":["8.8.8.8"],"gateway":"192.168.95.1","ip":"192.168.95.3","ip6":"fe80:0:0:0:5e5b:35ff:fed0:77b","ips":{"vlan1":"192.168.95.3/24,fe80:0:0:0:5e5b:35ff:fed0:77b/64"},"netmask":"255.255.255.0","netmask6":"/64"},"last_seen":1720595866,"last_trouble":{"code":"07","timestamp":1720039666},"lldp_stat":{"chassis_id":"d0:07:ca:f5:21:00","lldp_med_supported":false,"mgmt_addr":"100.123.105.1","mgmt_addrs":["100.123.105.1"],"port_desc":"ge-0/0/4","port_id":"ge-0/0/4","power_allocated":0,"power_draw":0,"power_request_count":0,"power_requested":0,"system_desc":"Juniper Networks, Inc. ex4300-48t internet router, kernel JUNOS 20.4R3-S7.2, Build date: 2023-04-21 19:47:18 UTC Copyright (c) 1996-2023 Juniper Networks, Inc.","system_name":"Phoenix-Switch"},"mac":"5c5b35d0077b","mem_total_kb":505468,"mem_used_kb":202096,"model":"AP43","modified_time":1718530662,"mount":"faceup","name":"Phoenix","notes":"","num_clients":1,"org_id":"af010e2b-f829-4975-b49e-2e896ed1d627","port_stat":{"eth0":{"full_duplex":true,"rx_bytes":1284143195,"rx_errors":0,"rx_peak_bps":17585,"rx_pkts":5199816,"speed":1000,"tx_bytes":1283744961,"tx_peak_bps":26484,"tx_pkts":3990463,"up":true},"eth1":{"full_duplex":false,"rx_bytes":0,"rx_errors":0,"rx_peak_bps":0,"rx_pkts":0,"speed":0,"tx_bytes":0,"tx_peak_bps":0,"tx_pkts":0,"up":false}},"power_budget":8400,"power_constrained":false,"power_src":"DC Input","radio_config":{},"radio_stat":{"band_24":{"bandwidth":20,"channel":11,"mac":"5c5b35dea810","noise_floor":-80,"num_clients":0,"power":17,"rx_bytes":12948211,"rx_pkts":65292,"tx_bytes":19071943,"tx_pkts":76926,"usage":"24","util_all":24,"util_non_wifi":2,"util_rx_in_bss":0,"util_rx_other_bss":17,"util_tx":4,"util_undecodable_wifi":0,"util_unknown_wifi":1},"band_5":{"bandwidth":40,"channel":36,"mac":"5c5b35dea7f0","noise_floor":-90,"num_clients":1,"power":17,"rx_bytes":578362619,"rx_pkts":2687577,"tx_bytes":1199571353,"tx_pkts":2479302,"usage":"5","util_all":13,"util_non_wifi":0,"util_rx_in_bss":0,"util_rx_other_bss":10,"util_tx":1,"util_undecodable_wifi":0,"util_unknown_wifi":1}},"rx_bps":9276,"rx_bytes":591310830,"rx_pkts":2752869,"serial":"A0703200709E6","site_id":"46fc665e-9706-4296-8fe2-78f42f2e67e4","status":"connected","switch_redundancy":{"num_redundant_aps":1},"tx_bps":8067,"tx_bytes":1218643296,"tx_pkts":2556228,"type":"ap","uptime":1593120,"version":"0.14.29313"}]'
- '[{"arp_table_stats":{"arp_table_count":21,"max_entries_supported":64000},"auto_upgrade_stat":{"lastcheck":1720595477},"cert_expiry":1743292763,"cluster_config":{"configuration":"active-active","control_link_info":{"name":"fxp1","status":"Up"},"ethernet_connection":[{"name":"reth0","status":"Up"},{"name":"reth1","status":"Up"},{"name":"reth2","status":"Down"},{"name":"reth3","status":"Down"},{"name":"reth4","status":"Up"}],"fabric_link_info":{"DataPlaneNotifiedStatus":"Up","Interface":[],"InternalStatus":"Up","State":"Enabled","Status":"Enabled"},"last_status_change_reason":"No failures","operational":"active-active","primary_node_health":"Healthy","redundancy_group_information":[{"Id":0,"MonitoringFailure":"none","Threshold":255},{"Id":1,"MonitoringFailure":"interface-monitoring","Threshold":0},{"Id":2,"MonitoringFailure":"none","Threshold":255}],"secondary_node_health":"Not healthy","status":"Green"},"config_status":"COMMITED","config_timestamp":1720182848,"config_version":1720182848,"cpu2_stat":{"idle":86,"interrupt":0,"load_avg":[0.13,0.17,0.16],"system":5,"user":9},"cpu_stat":{"idle":76,"interrupt":0,"load_avg":[0.18,0.31,0.39],"system":10,"user":14},"created_time":1711756611,"deviceprofile_id":"5e5daedf-e650-4013-b41c-845f0d2b9414","deviceprofile_name":"wan_srx_tor_hub1","dhcpd_stat":{"byod_dc1":{"num_ips":100,"num_leased":0},"corp_dc1":{"num_ips":100,"num_leased":4},"guest_dc1":{"num_ips":241,"num_leased":0},"iot_dc1":{"num_ips":100,"num_leased":0},"mgmt_dc1":{"num_ips":100,"num_leased":2},"teleworker":{"num_ips":140,"num_leased":0}},"ext_ip":"69.196.157.189","fwupdate":{"progress":100,"status":"upgraded","status_id":3037,"timestamp":1718392692.580769,"will_retry":false},"has_pcap":false,"hostname":"wan_srx_tor_hub1-srx","id":"00000000-0000-0000-1000-4db14e107134","if_stat":{"ge-0/0/5.130":{"address_mode":"Unknown","nat_addresses":[],"network_name":"","port_id":"ge-0/0/5","port_usage":"lan","rx_bytes":0,"rx_pkts":0,"tx_bytes":0,"tx_pkts":0,"up":true,"vlan":0},"ge-1/0/5.120":{"address_mode":"Unknown","nat_addresses":[],"network_name":"","port_id":"ge-1/0/5","port_usage":"lan","rx_bytes":0,"rx_pkts":0,"tx_bytes":0,"tx_pkts":0,"up":true,"vlan":0}},"ip":"69.196.157.190","ip_stat":{"gateway":"69.196.157.185","ip":"69.196.157.190","ips":{"vlan1":"69.196.157.190,69.196.157.190"},"netmask":"255.255.255.255"},"is_ha":true,"last_seen":1720598726,"mac":"4db14e107134","mac_table_stats":{"mac_table_count":0,"max_mac_entries_supported":160000},"memory2_stat":{"usage":32},"memory_stat":{"usage":39},"model":"SRX300","modified_time":1720092942,"module2_stat":[{"backup_version":"21.2R3-S7.7","fans":[],"last_seen":1720598717,"mac":"ec38739270c0","model":"SRX300","psus":[{"name":"Power Supply 0","status":"ok"}],"recovery_version":"21.2R3-S7.7","serial":"CV2218AF1505","status":"connected","temperatures":[{"celsius":49,"name":"Routing Engine","status":"ok"},{"celsius":64,"name":"Routing Engine CPU","status":"ok"}],"uptime":580964,"vc_links":[{"neighbor_module_idx":0,"neighbor_port_id":"fxp1","port_id":"fxp1"}],"vc_role":"secondary","vc_state":"active","version":"21.2R3-S6.11"}],"module_stat":[{"backup_version":"21.2R3-S7.7","fans":[],"last_seen":1720598716.999985,"mac":"4db14e107134","model":"SRX300","psus":[{"name":"Power Supply 0","status":"ok"}],"recovery_version":"21.2R3-S7.7","serial":"CV0219AN0335","status":"connected","temperatures":[{"celsius":49,"name":"Routing Engine","status":"ok"},{"celsius":65,"name":"Routing Engine CPU","status":"ok"}],"uptime":1945193,"vc_links":[{"neighbor_module_idx":1,"neighbor_port_id":"fxp1","port_id":"fxp1"}],"vc_role":"primary","vc_state":"active","version":"21.2R3-S6.11"}],"name":"wan_srx_tor_hub1-srx","org_id":"af010e2b-f829-4975-b49e-2e896ed1d627","route_summary_stats":{"fib_routes":0,"max_unicast_routes_supported":1240000,"rib_routes":0,"total_routes":0},"serial":"CV0219AN0335","service_stat":{},"service_status":{"appid_status":"enabled","appid_version":3720,"ewf_status":"disabled","idp_install_result":"successful","idp_install_timestamp":"2024-07-10T06:29:11.708164029Z","idp_status":"disabled","idp_update_timestamp":"2024-07-10T06:28:28.567046244Z"},"site_id":"83c31971-ad70-4419-ae20-7f2b90748986","spu2_stat":[{"spu_cpu":0,"spu_current_session":39,"spu_max_session":32768,"spu_memory":31,"spu_pending_session":0,"spu_uptime":1944572,"spu_valid_session":0}],"spu_stat":[{"spu_cpu":1,"spu_current_session":47,"spu_max_session":32768,"spu_memory":34,"spu_pending_session":0,"spu_uptime":1944572,"spu_valid_session":0}],"status":"connected","tag_id":3550217,"tag_uuid":"af010e2b-f829-4975-b49e-2e896ed1d627","type":"gateway","uptime":581259,"version":"21.2R3-S6.11"}]'
- '[{"ap_redundancy":{"num_aps":1,"num_aps_with_switch_redundancy":1},"arp_table_stats":{"arp_table_count":16,"max_entries_supported":32000},"auto_upgrade_stat":{"lastcheck":1720600596},"cert_expiry":1743932274,"clients":[{"device_mac":"0912f561b653","mac":"001132f5ad23","port_id":"ge-1/0/11"}],"clients_stats":{"total":{"num_aps":[0,0],"num_wired_clients":13}},"config_status":"COMMITED","config_timestamp":1720552389,"config_version":1720552389,"cpu_stat":{"idle":74,"interrupt":0,"load_avg":[0.8,0.75,0.78],"system":13,"user":13},"created_time":1712346090,"dhcpd_stat":{"ifo":{"num_ips":5,"num_leased":0}},"ext_ip":"153.142.221.41","fw_versions_outofsync":false,"fwupdate":{"progress":100,"status":"upgraded","status_id":3037,"timestamp":1712409702.9714448,"will_retry":false},"has_pcap":true,"hostname":"SW-HLAB-ea2e00","hw_rev":"A","id":"00000000-0000-0000-1000-0912f561b653","if_stat":{"ge-0/0/5.0":{"port_id":"ge-0/0/5","rx_bytes":0,"rx_pkts":78110,"tx_bytes":0,"tx_pkts":61037,"up":true},"ge-1/0/0.0":{"port_id":"ge-1/0/0","rx_bytes":0,"rx_pkts":56415,"tx_bytes":0,"tx_pkts":72209,"up":true},"irb.172":{"ips":["10.3.172.41/24"],"port_id":"irb","rx_bytes":0,"rx_pkts":1291755,"servp_info":{},"tx_bytes":0,"tx_pkts":990327,"up":true,"vlan":172},"vme.0":{"port_id":"vme","rx_bytes":0,"rx_pkts":0,"tx_bytes":0,"tx_pkts":0,"up":true}},"ip":"10.3.10.10","ip_stat":{"gateway":"10.3.172.9","ip":"10.3.10.10","ips":{"vlan172":"10.3.172.41"},"netmask":"255.255.255.255"},"last_seen":1720601189,"last_trouble":{"code":"103","timestamp":1712412455215},"mac":"0912f561b653","mac_table_stats":{"mac_table_count":58,"max_mac_entries_supported":64000},"memory_stat":{"usage":16},"model":"EX4100-F-12P","modified_time":1720552388,"module_stat":[{"boot_partition":"junos","cpu_stat":{"idle":74,"interrupt":0,"load_avg":[0.8,0.75,0.78],"system":13,"user":13},"fpc_idx":0,"mac":"0912f561b653","memory_stat":{"usage":16},"model":"EX4100-F-12P","pics":[{"index":0,"model_number":"EX4100-F-12P","port_groups":[{"count":12,"type":"GE"}]},{"index":1,"model_number":"EX4100-F-12P","port_groups":[{"count":4,"type":"SFP/SFP+"}]},{"index":2,"model_number":"EX4100-F-12P","port_groups":[{"count":2,"type":"GE"}]}],"poe":{"max_power":180,"power_draw":7.3},"psus":[{"name":"Power Supply 0","status":"ok"},{"name":"Power Supply 1","status":"absent"},{"name":"Power Supply 2","status":"absent"}],"serial":"FJ0324AV0077","temperatures":[{"celsius":51,"name":"Thermal board Sensor 1","status":"ok"},{"celsius":51,"name":"Thermal board Sensor 2","status":"ok"},{"celsius":50,"name":"Thermal board Sensor 3","status":"ok"},{"celsius":57,"name":"PFE Die Sensor","status":"ok"}],"type":"fpc","uptime":1692720,"vc_links":[{"neighbor_module_idx":1,"neighbor_port_id":"vcp-1/1/1","port_id":"vcp-0/1/0"},{"neighbor_module_idx":1,"neighbor_port_id":"vcp-1/1/0","port_id":"vcp-0/1/1"}],"vc_mode":"HiGiG","vc_role":"master","vc_state":"present","version":"22.4R3.25"},{"boot_partition":"junos","cpu_stat":{"idle":79,"interrupt":0,"load_avg":[0.52,0.46,0.46],"system":6,"user":15},"fpc_idx":1,"mac":"485a0deb2380","memory_stat":{"usage":14},"model":"EX4100-F-12P","pics":[{"index":0,"model_number":"EX4100-F-12P","port_groups":[{"count":12,"type":"GE"}]},{"index":1,"model_number":"EX4100-F-12P","port_groups":[{"count":4,"type":"SFP/SFP+"}]},{"index":2,"model_number":"EX4100-F-12P","port_groups":[{"count":2,"type":"GE"}]}],"poe":{"max_power":180,"power_draw":22.1},"psus":[{"name":"Power Supply 0","status":"ok"},{"name":"Power Supply 1","status":"absent"},{"name":"Power Supply 2","status":"absent"}],"serial":"FJ0424AV0101","temperatures":[{"celsius":52,"name":"Thermal board Sensor 1","status":"ok"},{"celsius":53,"name":"Thermal board Sensor 2","status":"ok"},{"celsius":52,"name":"Thermal board Sensor 3","status":"ok"},{"celsius":59,"name":"PFE Die Sensor","status":"ok"}],"type":"fpc","uptime":1692720,"vc_links":[{"neighbor_module_idx":0,"neighbor_port_id":"vcp-0/1/1","port_id":"vcp-1/1/0"},{"neighbor_module_idx":0,"neighbor_port_id":"vcp-0/1/0","port_id":"vcp-1/1/1"}],"vc_mode":"HiGiG","vc_role":"backup","vc_state":"present","version":"22.4R3.25"}],"name":"SW-HLAB-ea2e00","org_id":"c5324060-19da-48fa-af28-2b530bd08765","route_summary_stats":{"fib_routes":7,"max_unicast_routes_supported":32150,"rib_routes":40,"total_routes":3},"serial":"FJ0324AV0077","site_id":"a0e43ffb-94a6-4f27-92aa-9cf832e1143d","status":"connected","tag_id":3564806,"tag_uuid":"507604a4-6b34-449c-acb3-87955430b006","type":"switch","uptime":1692720,"vc_mac":"0912f561b653","vc_setup_info":{"config_type":"nonprovisioned","err_missing_dev_id_fpc":false},"version":"22.4R3.25"}]'
contentMediaType: application/vnd.api+json
examples:
Access Point Stats:
value:
- auto_upgrade_stat:
lastcheck: 1720594762
ble_stat:
beacon_enabled: true
beacon_rate: 4
eddystone_uid_enabled: false
eddystone_uid_freq_msec: 1000
eddystone_uid_instance: 5c5b35d0077b
eddystone_uid_namespace: 9777c1a06ef611e68bbf
eddystone_url_enabled: false
eddystone_url_freq_msec: 1000
eddystone_url_url: ''
ibeacon_enabled: false
ibeacon_freq_msec: 1000
ibeacon_major: 894
ibeacon_minor: 9328
ibeacon_uuid: af010e2b-f829-4975-b49e-2e896ed1d627
major: 894
minors:
- 9328
- 9329
- 9330
- 9331
- 9332
- 9333
- 9334
- 9335
- -1
power: 8
rx_bytes: 158500843
rx_pkts: 3549163
tx_bytes: 509640
tx_pkts: 85411
tx_resets: 0
uuid: af010e2b-f829-4975-b49e-2e896ed1d627
config_reverted: false
cpu_system: 21921854
cpu_user: 7496631
cpu_util: 5
created_time: 1718228350
env_stat:
accel_x: -0.092
accel_y: 0.004
accel_z: -1.02
ambient_temp: 43
attitude: 0
cpu_temp: 53
humidity: 9
magne_x: 0
magne_y: 0
magne_z: 0
pressure: 968
vcore_voltage: 0
ext_ip: 66.129.234.28
hw_rev: C02
id: 00000000-0000-0000-1000-5c5b35d0077b
inactive_wired_vlans: []
ip: 192.168.95.3
ip_stat:
dhcp_server: 192.168.95.1
dns:
- 8.8.8.8
gateway: 192.168.95.1
ip: 192.168.95.3
ip6: fe80:0:0:0:5e5b:35ff:fed0:77b
ips:
vlan1: 192.168.95.3/24,fe80:0:0:0:5e5b:35ff:fed0:77b/64
netmask: 255.255.255.0
netmask6: /64
last_seen: 1720595866
last_trouble:
code: '07'
timestamp: 1720039666
lldp_stat:
chassis_id: d0:07:ca:f5:21:00
lldp_med_supported: false
mgmt_addr: 100.123.105.1
mgmt_addrs:
- 100.123.105.1
port_desc: ge-0/0/4
port_id: ge-0/0/4
power_allocated: 0
power_draw: 0
power_request_count: 0
power_requested: 0
system_desc: 'Juniper Networks, Inc. ex4300-48t internet router, kernel JUNOS 20.4R3-S7.2, Build date: 2023-04-21 19:47:18 UTC Copyright (c) 1996-2023 Juniper Networks, Inc.'
system_name: Phoenix-Switch
mac: 5c5b35d0077b
mem_total_kb: 505468
mem_used_kb: 202096
model: AP43
modified_time: 1718530662
mount: faceup
name: Phoenix
notes: ''
num_clients: 1
org_id: af010e2b-f829-4975-b49e-2e896ed1d627
port_stat:
eth0:
full_duplex: true
rx_bytes: 1284143195
rx_errors: 0
rx_peak_bps: 17585
rx_pkts: 5199816
speed: 1000
tx_bytes: 1283744961
tx_peak_bps: 26484
tx_pkts: 3990463
up: true
eth1:
full_duplex: false
rx_bytes: 0
rx_errors: 0
rx_peak_bps: 0
rx_pkts: 0
speed: 0
tx_bytes: 0
tx_peak_bps: 0
tx_pkts: 0
up: false
power_budget: 8400
power_constrained: false
power_src: DC Input
radio_config: {}
radio_stat:
band_24:
bandwidth: 20
channel: 11
mac: 5c5b35dea810
noise_floor: -80
num_clients: 0
power: 17
rx_bytes: 12948211
rx_pkts: 65292
tx_bytes: 19071943
tx_pkts: 76926
usage: '24'
util_all: 24
util_non_wifi: 2
util_rx_in_bss: 0
util_rx_other_bss: 17
util_tx: 4
util_undecodable_wifi: 0
util_unknown_wifi: 1
band_5:
bandwidth: 40
channel: 36
mac: 5c5b35dea7f0
noise_floor: -90
num_clients: 1
power: 17
rx_bytes: 578362619
rx_pkts: 2687577
tx_bytes: 1199571353
tx_pkts: 2479302
usage: '5'
util_all: 13
util_non_wifi: 0
util_rx_in_bss: 0
util_rx_other_bss: 10
util_tx: 1
util_undecodable_wifi: 0
util_unknown_wifi: 1
rx_bps: 9276
rx_bytes: 591310830
rx_pkts: 2752869
serial: A0703200709E6
site_id: 46fc665e-9706-4296-8fe2-78f42f2e67e4
status: connected
switch_redundancy:
num_redundant_aps: 1
tx_bps: 8067
tx_bytes: 1218643296
tx_pkts: 2556228
type: ap
uptime: 1593120
version: 0.14.29313
Gateway Stats:
value:
- arp_table_stats:
arp_table_count: 21
max_entries_supported: 64000
auto_upgrade_stat:
lastcheck: 1720595477
cert_expiry: 1743292763
cluster_config:
configuration: active-active
control_link_info:
name: fxp1
status: Up
ethernet_connection:
- name: reth0
status: Up
- name: reth1
status: Up
- name: reth2
status: Down
- name: reth3
status: Down
- name: reth4
status: Up
fabric_link_info:
DataPlaneNotifiedStatus: Up
Interface: []
InternalStatus: Up
State: Enabled
Status: Enabled
last_status_change_reason: No failures
operational: active-active
primary_node_health: Healthy
redundancy_group_information:
- Id: 0
MonitoringFailure: none
Threshold: 255
- Id: 1
MonitoringFailure: interface-monitoring
Threshold: 0
- Id: 2
MonitoringFailure: none
Threshold: 255
secondary_node_health: Not healthy
status: Green
config_status: COMMITED
config_timestamp: 1720182848
config_version: 1720182848
cpu2_stat:
idle: 86
interrupt: 0
load_avg:
- 0.13
- 0.17
- 0.16
system: 5
user: 9
cpu_stat:
idle: 76
interrupt: 0
load_avg:
- 0.18
- 0.31
- 0.39
system: 10
user: 14
created_time: 1711756611
deviceprofile_id: 5e5daedf-e650-4013-b41c-845f0d2b9414
deviceprofile_name: wan_srx_tor_hub1
dhcpd_stat:
byod_dc1:
num_ips: 100
num_leased: 0
corp_dc1:
num_ips: 100
num_leased: 4
guest_dc1:
num_ips: 241
num_leased: 0
iot_dc1:
num_ips: 100
num_leased: 0
mgmt_dc1:
num_ips: 100
num_leased: 2
teleworker:
num_ips: 140
num_leased: 0
ext_ip: 69.196.157.189
fwupdate:
progress: 100
status: upgraded
status_id: 3037
timestamp: 1718392692.580769
will_retry: false
has_pcap: false
hostname: wan_srx_tor_hub1-srx
id: 00000000-0000-0000-1000-4db14e107134
if_stat:
ge-0/0/5.130:
address_mode: Unknown
nat_addresses: []
network_name: ''
port_id: ge-0/0/5
port_usage: lan
rx_bytes: 0
rx_pkts: 0
tx_bytes: 0
tx_pkts: 0
up: true
vlan: 0
ge-1/0/5.120:
address_mode: Unknown
nat_addresses: []
network_name: ''
port_id: ge-1/0/5
port_usage: lan
rx_bytes: 0
rx_pkts: 0
tx_bytes: 0
tx_pkts: 0
up: true
vlan: 0
ip: 69.196.157.190
ip_stat:
gateway: 69.196.157.185
ip: 69.196.157.190
ips:
vlan1: 69.196.157.190,69.196.157.190
netmask: 255.255.255.255
is_ha: true
last_seen: 1720598726
mac: 4db14e107134
mac_table_stats:
mac_table_count: 0
max_mac_entries_supported: 160000
memory2_stat:
usage: 32
memory_stat:
usage: 39
model: SRX300
modified_time: 1720092942
module2_stat:
- backup_version: 21.2R3-S7.7
fans: []
last_seen: 1720598717
mac: ec38739270c0
model: SRX300
psus:
- name: Power Supply 0
status: ok
recovery_version: 21.2R3-S7.7
serial: CV2218AF1505
status: connected
temperatures:
- celsius: 49
name: Routing Engine
status: ok
- celsius: 64
name: Routing Engine CPU
status: ok
uptime: 580964
vc_links:
- neighbor_module_idx: 0
neighbor_port_id: fxp1
port_id: fxp1
vc_role: secondary
vc_state: active
version: 21.2R3-S6.11
module_stat:
- backup_version: 21.2R3-S7.7
fans: []
last_seen: 1720598716.999985
mac: 4db14e107134
model: SRX300
psus:
- name: Power Supply 0
status: ok
recovery_version: 21.2R3-S7.7
serial: CV0219AN0335
status: connected
temperatures:
- celsius: 49
name: Routing Engine
status: ok
- celsius: 65
name: Routing Engine CPU
status: ok
uptime: 1945193
vc_links:
- neighbor_module_idx: 1
neighbor_port_id: fxp1
port_id: fxp1
vc_role: primary
vc_state: active
version: 21.2R3-S6.11
name: wan_srx_tor_hub1-srx
org_id: af010e2b-f829-4975-b49e-2e896ed1d627
route_summary_stats:
fib_routes: 0
max_unicast_routes_supported: 1240000
rib_routes: 0
total_routes: 0
serial: CV0219AN0335
service_stat: {}
service_status:
appid_status: enabled
appid_version: 3720
ewf_status: disabled
idp_install_result: successful
idp_install_timestamp: 2024-07-10T06:29:11.708164029Z
idp_status: disabled
idp_update_timestamp: 2024-07-10T06:28:28.567046244Z
site_id: 83c31971-ad70-4419-ae20-7f2b90748986
spu2_stat:
- spu_cpu: 0
spu_current_session: 39
spu_max_session: 32768
spu_memory: 31
spu_pending_session: 0
spu_uptime: 1944572
spu_valid_session: 0
spu_stat:
- spu_cpu: 1
spu_current_session: 47
spu_max_session: 32768
spu_memory: 34
spu_pending_session: 0
spu_uptime: 1944572
spu_valid_session: 0
status: connected
tag_id: 3550217
tag_uuid: af010e2b-f829-4975-b49e-2e896ed1d627
type: gateway
uptime: 581259
version: 21.2R3-S6.11
Switch:
value:
- ap_redundancy:
num_aps: 1
num_aps_with_switch_redundancy: 1
arp_table_stats:
arp_table_count: 16
max_entries_supported: 32000
auto_upgrade_stat:
lastcheck: 1720600596
cert_expiry: 1743932274
clients:
- device_mac: 0912f561b653
mac: 001132f5ad23
port_id: ge-1/0/11
clients_stats:
total:
num_aps:
- 0
- 0
num_wired_clients: 13
config_status: COMMITED
config_timestamp: 1720552389
config_version: 1720552389
cpu_stat:
idle: 74
interrupt: 0
load_avg:
- 0.8
- 0.75
- 0.78
system: 13
user: 13
created_time: 1712346090
dhcpd_stat:
ifo:
num_ips: 5
num_leased: 0
ext_ip: 153.142.221.41
fw_versions_outofsync: false
fwupdate:
progress: 100
status: upgraded
status_id: 3037
timestamp: 1712409702.9714448
will_retry: false
has_pcap: true
hostname: SW-HLAB-ea2e00
hw_rev: A
id: 00000000-0000-0000-1000-0912f561b653
if_stat:
ge-0/0/5.0:
port_id: ge-0/0/5
rx_bytes: 0
rx_pkts: 78110
tx_bytes: 0
tx_pkts: 61037
up: true
ge-1/0/0.0:
port_id: ge-1/0/0
rx_bytes: 0
rx_pkts: 56415
tx_bytes: 0
tx_pkts: 72209
up: true
irb.172:
ips:
- 10.3.172.41/24
port_id: irb
rx_bytes: 0
rx_pkts: 1291755
servp_info: {}
tx_bytes: 0
tx_pkts: 990327
up: true
vlan: 172
vme.0:
port_id: vme
rx_bytes: 0
rx_pkts: 0
tx_bytes: 0
tx_pkts: 0
up: true
ip: 10.3.10.10
ip_stat:
gateway: 10.3.172.9
ip: 10.3.10.10
ips:
vlan172: 10.3.172.41
netmask: 255.255.255.255
last_seen: 1720601189
last_trouble:
code: '103'
timestamp: 1712412455215
mac: 0912f561b653
mac_table_stats:
mac_table_count: 58
max_mac_entries_supported: 64000
memory_stat:
usage: 16
model: EX4100-F-12P
modified_time: 1720552388
module_stat:
- boot_partition: junos
cpu_stat:
idle: 74
interrupt: 0
load_avg:
- 0.8
- 0.75
- 0.78
system: 13
user: 13
fpc_idx: 0
mac: 0912f561b653
memory_stat:
usage: 16
model: EX4100-F-12P
pics:
- index: 0
model_number: EX4100-F-12P
port_groups:
- count: 12
type: GE
- index: 1
model_number: EX4100-F-12P
port_groups:
- count: 4
type: SFP/SFP+
- index: 2
model_number: EX4100-F-12P
port_groups:
- count: 2
type: GE
poe:
max_power: 180
power_draw: 7.3
psus:
- name: Power Supply 0
status: ok
- name: Power Supply 1
status: absent
- name: Power Supply 2
status: absent
serial: FJ0324AV0077
temperatures:
- celsius: 51
name: Thermal board Sensor 1
status: ok
- celsius: 51
name: Thermal board Sensor 2
status: ok
- celsius: 50
name: Thermal board Sensor 3
status: ok
- celsius: 57
name: PFE Die Sensor
status: ok
type: fpc
uptime: 1692720
vc_links:
- neighbor_module_idx: 1
neighbor_port_id: vcp-1/1/1
port_id: vcp-0/1/0
- neighbor_module_idx: 1
neighbor_port_id: vcp-1/1/0
port_id: vcp-0/1/1
vc_mode: HiGiG
vc_role: master
vc_state: present
version: 22.4R3.25
- boot_partition: junos
cpu_stat:
idle: 79
interrupt: 0
load_avg:
- 0.52
- 0.46
- 0.46
system: 6
user: 15
fpc_idx: 1
mac: 485a0deb2380
memory_stat:
usage: 14
model: EX4100-F-12P
pics:
- index: 0
model_number: EX4100-F-12P
port_groups:
- count: 12
type: GE
- index: 1
model_number: EX4100-F-12P
port_groups:
- count: 4
type: SFP/SFP+
- index: 2
model_number: EX4100-F-12P
port_groups:
- count: 2
type: GE
poe:
max_power: 180
power_draw: 22.1
psus:
- name: Power Supply 0
status: ok
- name: Power Supply 1
status: absent
- name: Power Supply 2
status: absent
serial: FJ0424AV0101
temperatures:
- celsius: 52
name: Thermal board Sensor 1
status: ok
- celsius: 53
name: Thermal board Sensor 2
status: ok
- celsius: 52
name: Thermal board Sensor 3
status: ok
- celsius: 59
name: PFE Die Sensor
status: ok
type: fpc
uptime: 1692720
vc_links:
- neighbor_module_idx: 0
neighbor_port_id: vcp-0/1/1
port_id: vcp-1/1/0
- neighbor_module_idx: 0
neighbor_port_id: vcp-0/1/0
port_id: vcp-1/1/1
vc_mode: HiGiG
vc_role: backup
vc_state: present
version: 22.4R3.25
name: SW-HLAB-ea2e00
org_id: c5324060-19da-48fa-af28-2b530bd08765
route_summary_stats:
fib_routes: 7
max_unicast_routes_supported: 32150
rib_routes: 40
total_routes: 3
serial: FJ0324AV0077
site_id: a0e43ffb-94a6-4f27-92aa-9cf832e1143d
status: connected
tag_id: 3564806
tag_uuid: 507604a4-6b34-449c-acb3-87955430b006
type: switch
uptime: 1692720
vc_mac: 0912f561b653
vc_setup_info:
config_type: nonprovisioned
err_missing_dev_id_fpc: false
version: 22.4R3.25
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/stats/devices/{device_id}:
get:
tags:
- Sites Stats - Devices
summary: getSiteDeviceStats
description: Get Site Device Stats Details
operationId: getSiteDeviceStats
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: fields
in: query
description: List of additional fields requests, comma separated, or `fields=*` for all of them
style: form
explode: true
schema:
type: string
examples:
- field1,field2
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/stats_device'
- description: Device statistics record for an AP, switch, or gateway
examples:
- auto_upgrade_stat:
lastcheck: 1720594762
ble_stat:
beacon_enabled: true
beacon_rate: 4
eddystone_uid_enabled: false
eddystone_uid_freq_msec: 1000
eddystone_uid_instance: 5c5b35d0077b
eddystone_uid_namespace: 9777c1a06ef611e68bbf
eddystone_url_enabled: false
eddystone_url_freq_msec: 1000
eddystone_url_url: ''
ibeacon_enabled: false
ibeacon_freq_msec: 1000
ibeacon_major: 894
ibeacon_minor: 9328
ibeacon_uuid: af010e2b-f829-4975-b49e-2e896ed1d627
major: 894
minors:
- 9328
- 9329
- 9330
- 9331
- 9332
- 9333
- 9334
- 9335
- -1
power: 8
rx_bytes: 158500843
rx_pkts: 3549163
tx_bytes: 509640
tx_pkts: 85411
tx_resets: 0
uuid: af010e2b-f829-4975-b49e-2e896ed1d627
config_reverted: false
cpu_system: 21921854
cpu_user: 7496631
cpu_util: 5
created_time: 1718228350
env_stat:
accel_x: -0.092
accel_y: 0.004
accel_z: -1.02
ambient_temp: 43
attitude: 0
cpu_temp: 53
humidity: 9
magne_x: 0
magne_y: 0
magne_z: 0
pressure: 968
vcore_voltage: 0
ext_ip: 66.129.234.28
hw_rev: C02
id: 00000000-0000-0000-1000-5c5b35d0077b
inactive_wired_vlans: []
ip: 192.168.95.3
ip_stat:
dhcp_server: 192.168.95.1
dns:
- 8.8.8.8
gateway: 192.168.95.1
ip: 192.168.95.3
ip6: fe80:0:0:0:5e5b:35ff:fed0:77b
ips:
vlan1: 192.168.95.3/24,fe80:0:0:0:5e5b:35ff:fed0:77b/64
netmask: 255.255.255.0
netmask6: /64
last_seen: 1720595866
last_trouble:
code: '07'
timestamp: 1720039666
lldp_stat:
chassis_id: d0:07:ca:f5:21:00
lldp_med_supported: false
mgmt_addr: 100.123.105.1
mgmt_addrs:
- 100.123.105.1
port_desc: ge-0/0/4
port_id: ge-0/0/4
power_allocated: 0
power_draw: 0
power_request_count: 0
power_requested: 0
system_desc: 'Juniper Networks, Inc. ex4300-48t internet router, kernel JUNOS 20.4R3-S7.2, Build date: 2023-04-21 19:47:18 UTC Copyright (c) 1996-2023 Juniper Networks, Inc.'
system_name: Phoenix-Switch
mac: 5c5b35d0077b
mem_total_kb: 505468
mem_used_kb: 202096
model: AP43
modified_time: 1718530662
mount: faceup
name: Phoenix
notes: ''
num_clients: 1
org_id: af010e2b-f829-4975-b49e-2e896ed1d627
port_stat:
eth0:
full_duplex: true
rx_bytes: 1284143195
rx_errors: 0
rx_peak_bps: 17585
rx_pkts: 5199816
speed: 1000
tx_bytes: 1283744961
tx_peak_bps: 26484
tx_pkts: 3990463
up: true
eth1:
full_duplex: false
rx_bytes: 0
rx_errors: 0
rx_peak_bps: 0
rx_pkts: 0
speed: 0
tx_bytes: 0
tx_peak_bps: 0
tx_pkts: 0
up: false
power_budget: 8400
power_constrained: false
power_src: DC Input
radio_config: {}
radio_stat:
band_24:
bandwidth: 20
channel: 11
mac: 5c5b35dea810
noise_floor: -80
num_clients: 0
power: 17
rx_bytes: 12948211
rx_pkts: 65292
tx_bytes: 19071943
tx_pkts: 76926
usage: '24'
util_all: 24
util_non_wifi: 2
util_rx_in_bss: 0
util_rx_other_bss: 17
util_tx: 4
util_undecodable_wifi: 0
util_unknown_wifi: 1
band_5:
bandwidth: 40
channel: 36
mac: 5c5b35dea7f0
noise_floor: -90
num_clients: 1
power: 17
rx_bytes: 578362619
rx_pkts: 2687577
tx_bytes: 1199571353
tx_pkts: 2479302
usage: '5'
util_all: 13
util_non_wifi: 0
util_rx_in_bss: 0
util_rx_other_bss: 10
util_tx: 1
util_undecodable_wifi: 0
util_unknown_wifi: 1
rx_bps: 9276
rx_bytes: 591310830
rx_pkts: 2752869
serial: A0703200709E6
site_id: 46fc665e-9706-4296-8fe2-78f42f2e67e4
status: connected
switch_redundancy:
num_redundant_aps: 1
tx_bps: 8067
tx_bytes: 1218643296
tx_pkts: 2556228
type: ap
uptime: 1593120
version: 0.14.29313
contentMediaType: application/json
examples:
Access Point Stats:
value:
auto_upgrade_stat:
lastcheck: 1720594762
ble_stat:
beacon_enabled: true
beacon_rate: 4
eddystone_uid_enabled: false
eddystone_uid_freq_msec: 1000
eddystone_uid_instance: 5c5b35d0077b
eddystone_uid_namespace: 9777c1a06ef611e68bbf
eddystone_url_enabled: false
eddystone_url_freq_msec: 1000
eddystone_url_url: ''
ibeacon_enabled: false
ibeacon_freq_msec: 1000
ibeacon_major: 894
ibeacon_minor: 9328
ibeacon_uuid: af010e2b-f829-4975-b49e-2e896ed1d627
major: 894
minors:
- 9328
- 9329
- 9330
- 9331
- 9332
- 9333
- 9334
- 9335
- -1
power: 8
rx_bytes: 158500843
rx_pkts: 3549163
tx_bytes: 509640
tx_pkts: 85411
tx_resets: 0
uuid: af010e2b-f829-4975-b49e-2e896ed1d627
config_reverted: false
cpu_system: 21921854
cpu_user: 7496631
cpu_util: 5
created_time: 1718228350
env_stat:
accel_x: -0.092
accel_y: 0.004
accel_z: -1.02
ambient_temp: 43
attitude: 0
cpu_temp: 53
humidity: 9
magne_x: 0
magne_y: 0
magne_z: 0
pressure: 968
vcore_voltage: 0
ext_ip: 66.129.234.28
hw_rev: C02
id: 00000000-0000-0000-1000-5c5b35d0077b
inactive_wired_vlans: []
ip: 192.168.95.3
ip_stat:
dhcp_server: 192.168.95.1
dns:
- 8.8.8.8
gateway: 192.168.95.1
ip: 192.168.95.3
ip6: fe80:0:0:0:5e5b:35ff:fed0:77b
ips:
vlan1: 192.168.95.3/24,fe80:0:0:0:5e5b:35ff:fed0:77b/64
netmask: 255.255.255.0
netmask6: /64
last_seen: 1720595866
last_trouble:
code: '07'
timestamp: 1720039666
lldp_stat:
chassis_id: d0:07:ca:f5:21:00
lldp_med_supported: false
mgmt_addr: 100.123.105.1
mgmt_addrs:
- 100.123.105.1
port_desc: ge-0/0/4
port_id: ge-0/0/4
power_allocated: 0
power_draw: 0
power_request_count: 0
power_requested: 0
system_desc: 'Juniper Networks, Inc. ex4300-48t internet router, kernel JUNOS 20.4R3-S7.2, Build date: 2023-04-21 19:47:18 UTC Copyright (c) 1996-2023 Juniper Networks, Inc.'
system_name: Phoenix-Switch
mac: 5c5b35d0077b
mem_total_kb: 505468
mem_used_kb: 202096
model: AP43
modified_time: 1718530662
mount: faceup
name: Phoenix
notes: ''
num_clients: 1
org_id: af010e2b-f829-4975-b49e-2e896ed1d627
port_stat:
eth0:
full_duplex: true
rx_bytes: 1284143195
rx_errors: 0
rx_peak_bps: 17585
rx_pkts: 5199816
speed: 1000
tx_bytes: 1283744961
tx_peak_bps: 26484
tx_pkts: 3990463
up: true
eth1:
full_duplex: false
rx_bytes: 0
rx_errors: 0
rx_peak_bps: 0
rx_pkts: 0
speed: 0
tx_bytes: 0
tx_peak_bps: 0
tx_pkts: 0
up: false
power_budget: 8400
power_constrained: false
power_src: DC Input
radio_config: {}
radio_stat:
band_24:
bandwidth: 20
channel: 11
mac: 5c5b35dea810
noise_floor: -80
num_clients: 0
power: 17
rx_bytes: 12948211
rx_pkts: 65292
tx_bytes: 19071943
tx_pkts: 76926
usage: '24'
util_all: 24
util_non_wifi: 2
util_rx_in_bss: 0
util_rx_other_bss: 17
util_tx: 4
util_undecodable_wifi: 0
util_unknown_wifi: 1
band_5:
bandwidth: 40
channel: 36
mac: 5c5b35dea7f0
noise_floor: -90
num_clients: 1
power: 17
rx_bytes: 578362619
rx_pkts: 2687577
tx_bytes: 1199571353
tx_pkts: 2479302
usage: '5'
util_all: 13
util_non_wifi: 0
util_rx_in_bss: 0
util_rx_other_bss: 10
util_tx: 1
util_undecodable_wifi: 0
util_unknown_wifi: 1
rx_bps: 9276
rx_bytes: 591310830
rx_pkts: 2752869
serial: A0703200709E6
site_id: 46fc665e-9706-4296-8fe2-78f42f2e67e4
status: connected
switch_redundancy:
num_redundant_aps: 1
tx_bps: 8067
tx_bytes: 1218643296
tx_pkts: 2556228
type: ap
uptime: 1593120
version: 0.14.29313
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/stats_device'
- description: Device statistics record for an AP, switch, or gateway
examples:
- auto_upgrade_stat:
lastcheck: 1720594762
ble_stat:
beacon_enabled: true
beacon_rate: 4
eddystone_uid_enabled: false
eddystone_uid_freq_msec: 1000
eddystone_uid_instance: 5c5b35d0077b
eddystone_uid_namespace: 9777c1a06ef611e68bbf
eddystone_url_enabled: false
eddystone_url_freq_msec: 1000
eddystone_url_url: ''
ibeacon_enabled: false
ibeacon_freq_msec: 1000
ibeacon_major: 894
ibeacon_minor: 9328
ibeacon_uuid: af010e2b-f829-4975-b49e-2e896ed1d627
major: 894
minors:
- 9328
- 9329
- 9330
- 9331
- 9332
- 9333
- 9334
- 9335
- -1
power: 8
rx_bytes: 158500843
rx_pkts: 3549163
tx_bytes: 509640
tx_pkts: 85411
tx_resets: 0
uuid: af010e2b-f829-4975-b49e-2e896ed1d627
config_reverted: false
cpu_system: 21921854
cpu_user: 7496631
cpu_util: 5
created_time: 1718228350
env_stat:
accel_x: -0.092
accel_y: 0.004
accel_z: -1.02
ambient_temp: 43
attitude: 0
cpu_temp: 53
humidity: 9
magne_x: 0
magne_y: 0
magne_z: 0
pressure: 968
vcore_voltage: 0
ext_ip: 66.129.234.28
hw_rev: C02
id: 00000000-0000-0000-1000-5c5b35d0077b
inactive_wired_vlans: []
ip: 192.168.95.3
ip_stat:
dhcp_server: 192.168.95.1
dns:
- 8.8.8.8
gateway: 192.168.95.1
ip: 192.168.95.3
ip6: fe80:0:0:0:5e5b:35ff:fed0:77b
ips:
vlan1: 192.168.95.3/24,fe80:0:0:0:5e5b:35ff:fed0:77b/64
netmask: 255.255.255.0
netmask6: /64
last_seen: 1720595866
last_trouble:
code: '07'
timestamp: 1720039666
lldp_stat:
chassis_id: d0:07:ca:f5:21:00
lldp_med_supported: false
mgmt_addr: 100.123.105.1
mgmt_addrs:
- 100.123.105.1
port_desc: ge-0/0/4
port_id: ge-0/0/4
power_allocated: 0
power_draw: 0
power_request_count: 0
power_requested: 0
system_desc: 'Juniper Networks, Inc. ex4300-48t internet router, kernel JUNOS 20.4R3-S7.2, Build date: 2023-04-21 19:47:18 UTC Copyright (c) 1996-2023 Juniper Networks, Inc.'
system_name: Phoenix-Switch
mac: 5c5b35d0077b
mem_total_kb: 505468
mem_used_kb: 202096
model: AP43
modified_time: 1718530662
mount: faceup
name: Phoenix
notes: ''
num_clients: 1
org_id: af010e2b-f829-4975-b49e-2e896ed1d627
port_stat:
eth0:
full_duplex: true
rx_bytes: 1284143195
rx_errors: 0
rx_peak_bps: 17585
rx_pkts: 5199816
speed: 1000
tx_bytes: 1283744961
tx_peak_bps: 26484
tx_pkts: 3990463
up: true
eth1:
full_duplex: false
rx_bytes: 0
rx_errors: 0
rx_peak_bps: 0
rx_pkts: 0
speed: 0
tx_bytes: 0
tx_peak_bps: 0
tx_pkts: 0
up: false
power_budget: 8400
power_constrained: false
power_src: DC Input
radio_config: {}
radio_stat:
band_24:
bandwidth: 20
channel: 11
mac: 5c5b35dea810
noise_floor: -80
num_clients: 0
power: 17
rx_bytes: 12948211
rx_pkts: 65292
tx_bytes: 19071943
tx_pkts: 76926
usage: '24'
util_all: 24
util_non_wifi: 2
util_rx_in_bss: 0
util_rx_other_bss: 17
util_tx: 4
util_undecodable_wifi: 0
util_unknown_wifi: 1
band_5:
bandwidth: 40
channel: 36
mac: 5c5b35dea7f0
noise_floor: -90
num_clients: 1
power: 17
rx_bytes: 578362619
rx_pkts: 2687577
tx_bytes: 1199571353
tx_pkts: 2479302
usage: '5'
util_all: 13
util_non_wifi: 0
util_rx_in_bss: 0
util_rx_other_bss: 10
util_tx: 1
util_undecodable_wifi: 0
util_unknown_wifi: 1
rx_bps: 9276
rx_bytes: 591310830
rx_pkts: 2752869
serial: A0703200709E6
site_id: 46fc665e-9706-4296-8fe2-78f42f2e67e4
status: connected
switch_redundancy:
num_redundant_aps: 1
tx_bps: 8067
tx_bytes: 1218643296
tx_pkts: 2556228
type: ap
uptime: 1593120
version: 0.14.29313
contentMediaType: application/vnd.api+json
examples:
Access Point Stats:
value:
auto_upgrade_stat:
lastcheck: 1720594762
ble_stat:
beacon_enabled: true
beacon_rate: 4
eddystone_uid_enabled: false
eddystone_uid_freq_msec: 1000
eddystone_uid_instance: 5c5b35d0077b
eddystone_uid_namespace: 9777c1a06ef611e68bbf
eddystone_url_enabled: false
eddystone_url_freq_msec: 1000
eddystone_url_url: ''
ibeacon_enabled: false
ibeacon_freq_msec: 1000
ibeacon_major: 894
ibeacon_minor: 9328
ibeacon_uuid: af010e2b-f829-4975-b49e-2e896ed1d627
major: 894
minors:
- 9328
- 9329
- 9330
- 9331
- 9332
- 9333
- 9334
- 9335
- -1
power: 8
rx_bytes: 158500843
rx_pkts: 3549163
tx_bytes: 509640
tx_pkts: 85411
tx_resets: 0
uuid: af010e2b-f829-4975-b49e-2e896ed1d627
config_reverted: false
cpu_system: 21921854
cpu_user: 7496631
cpu_util: 5
created_time: 1718228350
env_stat:
accel_x: -0.092
accel_y: 0.004
accel_z: -1.02
ambient_temp: 43
attitude: 0
cpu_temp: 53
humidity: 9
magne_x: 0
magne_y: 0
magne_z: 0
pressure: 968
vcore_voltage: 0
ext_ip: 66.129.234.28
hw_rev: C02
id: 00000000-0000-0000-1000-5c5b35d0077b
inactive_wired_vlans: []
ip: 192.168.95.3
ip_stat:
dhcp_server: 192.168.95.1
dns:
- 8.8.8.8
gateway: 192.168.95.1
ip: 192.168.95.3
ip6: fe80:0:0:0:5e5b:35ff:fed0:77b
ips:
vlan1: 192.168.95.3/24,fe80:0:0:0:5e5b:35ff:fed0:77b/64
netmask: 255.255.255.0
netmask6: /64
last_seen: 1720595866
last_trouble:
code: '07'
timestamp: 1720039666
lldp_stat:
chassis_id: d0:07:ca:f5:21:00
lldp_med_supported: false
mgmt_addr: 100.123.105.1
mgmt_addrs:
- 100.123.105.1
port_desc: ge-0/0/4
port_id: ge-0/0/4
power_allocated: 0
power_draw: 0
power_request_count: 0
power_requested: 0
system_desc: 'Juniper Networks, Inc. ex4300-48t internet router, kernel JUNOS 20.4R3-S7.2, Build date: 2023-04-21 19:47:18 UTC Copyright (c) 1996-2023 Juniper Networks, Inc.'
system_name: Phoenix-Switch
mac: 5c5b35d0077b
mem_total_kb: 505468
mem_used_kb: 202096
model: AP43
modified_time: 1718530662
mount: faceup
name: Phoenix
notes: ''
num_clients: 1
org_id: af010e2b-f829-4975-b49e-2e896ed1d627
port_stat:
eth0:
full_duplex: true
rx_bytes: 1284143195
rx_errors: 0
rx_peak_bps: 17585
rx_pkts: 5199816
speed: 1000
tx_bytes: 1283744961
tx_peak_bps: 26484
tx_pkts: 3990463
up: true
eth1:
full_duplex: false
rx_bytes: 0
rx_errors: 0
rx_peak_bps: 0
rx_pkts: 0
speed: 0
tx_bytes: 0
tx_peak_bps: 0
tx_pkts: 0
up: false
power_budget: 8400
power_constrained: false
power_src: DC Input
radio_config: {}
radio_stat:
band_24:
bandwidth: 20
channel: 11
mac: 5c5b35dea810
noise_floor: -80
num_clients: 0
power: 17
rx_bytes: 12948211
rx_pkts: 65292
tx_bytes: 19071943
tx_pkts: 76926
usage: '24'
util_all: 24
util_non_wifi: 2
util_rx_in_bss: 0
util_rx_other_bss: 17
util_tx: 4
util_undecodable_wifi: 0
util_unknown_wifi: 1
band_5:
bandwidth: 40
channel: 36
mac: 5c5b35dea7f0
noise_floor: -90
num_clients: 1
power: 17
rx_bytes: 578362619
rx_pkts: 2687577
tx_bytes: 1199571353
tx_pkts: 2479302
usage: '5'
util_all: 13
util_non_wifi: 0
util_rx_in_bss: 0
util_rx_other_bss: 10
util_tx: 1
util_undecodable_wifi: 0
util_unknown_wifi: 1
rx_bps: 9276
rx_bytes: 591310830
rx_pkts: 2752869
serial: A0703200709E6
site_id: 46fc665e-9706-4296-8fe2-78f42f2e67e4
status: connected
switch_redundancy:
num_redundant_aps: 1
tx_bps: 8067
tx_bytes: 1218643296
tx_pkts: 2556228
type: ap
uptime: 1593120
version: 0.14.29313
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/stats/devices/{device_id}/clients:
get:
tags:
- Sites Stats - Devices
summary: getSiteAllClientsStatsByDevice
description: Get wireless client stat by Device
operationId: getSiteAllClientsStatsByDevice
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/stats_wireless_client'
description: Wireless client statistics records returned by a stats response
contentMediaType: application/json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/stats/gateways/metrics:
get:
tags:
- Sites Stats - Devices
summary: getSiteGatewayMetrics
description: Get Site Gateway Metrics
operationId: getSiteGatewayMetrics
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/gateway_metrics'
- description: Gateway metric scores returned by the site gateway metrics API
examples:
- config_success: 99.9
version_compliance:
major_version:
SRX320:
major_count: 0
major_version: 19.4R2-S1.2
score: 99.9
type: gateway
contentMediaType: application/json
examples:
Example:
value:
config_success: 99.9
version_compliance:
major_version:
SRX320:
major_count: 0
major_version: 19.4R2-S1.2
score: 99.9
type: gateway
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/gateway_metrics'
- description: Gateway metric scores returned by the site gateway metrics API
examples:
- config_success: 99.9
version_compliance:
major_version:
SRX320:
major_count: 0
major_version: 19.4R2-S1.2
score: 99.9
type: gateway
contentMediaType: application/vnd.api+json
examples:
Example:
value:
config_success: 99.9
version_compliance:
major_version:
SRX320:
major_count: 0
major_version: 19.4R2-S1.2
score: 99.9
type: gateway
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/stats/switches/metrics:
get:
tags:
- Sites Stats - Devices
summary: getSiteSwitchesMetrics
description: Get version compliance metrics for managed or monitored switches
operationId: getSiteSwitchesMetrics
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: type
in: query
description: 'Filter results by type. enum: `active_ports_summary`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/switch_metric_type'
- description: 'Filter results by type. enum: `active_ports_summary`'
- name: scope
in: query
description: 'Filter results by scope. enum: `site`, `switch`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/switch_metric_scope'
- description: 'Filter results by scope. enum: `site`, `switch`'
- name: switch_mac
in: query
description: Switch mac, used only with metric `type`==`active_ports_summary`
style: form
explode: true
schema:
type: string
examples:
- 5c5b350e0410
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_switch_metrics'
- description: Switch metrics returned for the requested site or switch scope
examples:
- '{"active_ports_summary":{"details":{"active_port_count":4,"total_port_count":4},"score":100,"total_switch_count":2},"config_success":{"details":{"config_success_count":2},"score":100,"total_switch_count":2},"version_compliance":{"details":{"major_versions":[{"major_count":1,"major_version":"21.4R3.5","model":"EX2300-C-12P","system_names":[]},{"major_count":1,"major_version":"6.0.4-11","model":"SSR120","system_names":[]}]},"score":100,"total_switch_count":2}}'
- '{"active_ports_summary":{"details":{"active_port_count":1,"total_port_count":2},"score":50,"total_switch_count":1}}'
contentMediaType: application/json
examples:
Site Scoped:
value:
active_ports_summary:
details:
active_port_count: 4
total_port_count: 4
score: 100
total_switch_count: 2
config_success:
details:
config_success_count: 2
score: 100
total_switch_count: 2
version_compliance:
details:
major_versions:
- major_count: 1
major_version: 21.4R3.5
model: EX2300-C-12P
system_names: []
- major_count: 1
major_version: 6.0.4-11
model: SSR120
system_names: []
score: 100
total_switch_count: 2
Switch Scoped:
value:
active_ports_summary:
details:
active_port_count: 1
total_port_count: 2
score: 50
total_switch_count: 1
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_switch_metrics'
- description: Switch metrics returned for the requested site or switch scope
examples:
- '{"active_ports_summary":{"details":{"active_port_count":4,"total_port_count":4},"score":100,"total_switch_count":2},"config_success":{"details":{"config_success_count":2},"score":100,"total_switch_count":2},"version_compliance":{"details":{"major_versions":[{"major_count":1,"major_version":"21.4R3.5","model":"EX2300-C-12P","system_names":[]},{"major_count":1,"major_version":"6.0.4-11","model":"SSR120","system_names":[]}]},"score":100,"total_switch_count":2}}'
- '{"active_ports_summary":{"details":{"active_port_count":1,"total_port_count":2},"score":50,"total_switch_count":1}}'
contentMediaType: application/vnd.api+json
examples:
Site Scoped:
value:
active_ports_summary:
details:
active_port_count: 4
total_port_count: 4
score: 100
total_switch_count: 2
config_success:
details:
config_success_count: 2
score: 100
total_switch_count: 2
version_compliance:
details:
major_versions:
- major_count: 1
major_version: 21.4R3.5
model: EX2300-C-12P
system_names: []
- major_count: 1
major_version: 6.0.4-11
model: SSR120
system_names: []
score: 100
total_switch_count: 2
Switch Scoped:
value:
active_ports_summary:
details:
active_port_count: 1
total_port_count: 2
score: 50
total_switch_count: 1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/stats/mxedges:
get:
tags:
- Sites Stats - MxEdges
summary: listSiteMxEdgesStats
description: List Mist Edge statistics for a site over the requested time range. Use [List Org Mist Edge Stats]($e/Orgs%20Stats%20-%20MxEdges/listOrgMxEdgesStats) to retrieve Mist Edge statistics across the organization.
operationId: listSiteMxEdgesStats
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: List of MxEdge Stats
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/stats_mxedge'
description: Mist Edge statistics records returned by a stats response
examples:
- - cpu_stat:
cpus:
cpu0:
idle: 89
interrupt: 0
system: 8
usage: 10
user: 1
cpu1:
idle: 81
interrupt: 0
system: 4
usage: 18
user: 13
cpu2:
idle: 81
interrupt: 0
system: 4
usage: 18
user: 13
cpu3:
idle: 2
interrupt: 0
system: 50
usage: 97
user: 46
idle: 62
interrupt: 0
system: 17
usage: 37
user: 19
created_time: 1632684398
for_site: false
id: 00000000-0000-0000-1000-020000a80cb4
ip_stat:
ip: 192.168.1.244
ips:
ens18: 192.168.1.244/24,fe80::104c:ffff:fee0:caf8/64
macs:
ens18: e4434b217044
lag_stat:
lacp0:
active_ports:
- port0
- port1
last_seen: 1633721215
mac: 020000a80cb4
memory_stat:
active: 394936320
available: 4699291648
buffers: 107646976
cached: 478060544
free: 4330659840
inactive: 211980288
swap_cached: 0
swap_free: 1022357504
swap_total: 1022357504
total: 8365957120
usage: 48
model: ME-VM
modified_time: 1633643629
mxagent_registered: true
mxcluster_id: 678bc339-7635-4556-bbc0-e77ad493ef8b
name: me-vm-1
num_tunnels: 0
oob_ip_config:
dns:
- 8.8.8.8
- 1.1.1.1
gateway: 10.0.0.1
ip: 10.0.0.10
netmask: 255.255.255.0
type: static
org_id: 11b08247-b1ee-4152-9b25-312b323ce480
port_stat:
port0:
full_duplex: true
mac: 9e294e49091d
rx_bytes: 646898375700
rx_errors: 0
rx_pkts: 8784449574
speed: 10000
state: forwarding
tx_bytes: 647200748038
tx_errors: 0
tx_pkts: 8788647466
up: true
port1:
full_duplex: true
mac: a270fe53437e
rx_bytes: 647200437652
rx_errors: 0
rx_pkts: 8788644886
speed: 10000
state: forwarding
tx_bytes: 646898681650
tx_errors: 0
tx_pkts: 8784452092
up: true
serial: string
service_stat:
mxagent:
ext_ip: 99.0.86.164
last_seen: 1633721215
package_state: Installed
package_version: 3.1.1037-1
running_state: Running
uptime: 21240
tunterm:
ext_ip: 99.0.86.164
last_seen: 1633721203
package_state: Installed
package_version: 0.1.2449+deb10
running_state: Running
uptime: 76261
services:
- tunterm
site_id: 00000000-0000-0000-0000-000000000000
status: connected
tunterm_ip_config:
gateway: 192.168.11.1
ip: 192.168.11.91
netmask: 255.255.255.0
tunterm_port_config:
downstream_ports:
- '0'
- '1'
separate_upstream_downstream: false
upstream_ports:
- '0'
- '1'
tunterm_registered: true
tunterm_stat:
monitoring_failed: false
uptime: 76281
virtualization_type: KVM
contentMediaType: application/json
examples:
Example:
value:
- cpu_stat:
cpus:
cpu0:
idle: 89
interrupt: 0
system: 8
usage: 10
user: 1
cpu1:
idle: 81
interrupt: 0
system: 4
usage: 18
user: 13
cpu2:
idle: 81
interrupt: 0
system: 4
usage: 18
user: 13
cpu3:
idle: 2
interrupt: 0
system: 50
usage: 97
user: 46
idle: 62
interrupt: 0
system: 17
usage: 37
user: 19
created_time: 1632684398
for_site: false
id: 00000000-0000-0000-1000-020000a80cb4
ip_stat:
ip: 192.168.1.244
ips:
ens18: 192.168.1.244/24,fe80::104c:ffff:fee0:caf8/64
macs:
ens18: e4434b217044
lag_stat:
lacp0:
active_ports:
- port0
- port1
last_seen: 1633721215
mac: 020000a80cb4
memory_stat:
active: 394936320
available: 4699291648
buffers: 107646976
cached: 478060544
free: 4330659840
inactive: 211980288
swap_cached: 0
swap_free: 1022357504
swap_total: 1022357504
total: 8365957120
usage: 48
model: ME-VM
modified_time: 1633643629
mxagent_registered: true
mxcluster_id: 678bc339-7635-4556-bbc0-e77ad493ef8b
name: me-vm-1
num_tunnels: 0
oob_ip_config:
dns:
- 8.8.8.8
- 1.1.1.1
gateway: 10.0.0.1
ip: 10.0.0.10
netmask: 255.255.255.0
type: static
org_id: 11b08247-b1ee-4152-9b25-312b323ce480
port_stat:
port0:
full_duplex: true
mac: 9e294e49091d
rx_bytes: 646898375700
rx_errors: 0
rx_pkts: 8784449574
speed: 10000
state: forwarding
tx_bytes: 647200748038
tx_errors: 0
tx_pkts: 8788647466
up: true
port1:
full_duplex: true
mac: a270fe53437e
rx_bytes: 647200437652
rx_errors: 0
rx_pkts: 8788644886
speed: 10000
state: forwarding
tx_bytes: 646898681650
tx_errors: 0
tx_pkts: 8784452092
up: true
serial: string
service_stat:
mxagent:
ext_ip: 99.0.86.164
last_seen: 1633721215
package_state: Installed
package_version: 3.1.1037-1
running_state: Running
uptime: 21240
tunterm:
ext_ip: 99.0.86.164
last_seen: 1633721203
package_state: Installed
package_version: 0.1.2449+deb10
running_state: Running
uptime: 76261
services:
- tunterm
site_id: 00000000-0000-0000-0000-000000000000
status: connected
tunterm_ip_config:
gateway: 192.168.11.1
ip: 192.168.11.91
netmask: 255.255.255.0
tunterm_port_config:
downstream_ports:
- '0'
- '1'
separate_upstream_downstream: false
upstream_ports:
- '0'
- '1'
tunterm_registered: true
tunterm_stat:
monitoring_failed: false
uptime: 76281
virtualization_type: KVM
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/stats_mxedge'
description: Mist Edge statistics records returned by a stats response
examples:
- - cpu_stat:
cpus:
cpu0:
idle: 89
interrupt: 0
system: 8
usage: 10
user: 1
cpu1:
idle: 81
interrupt: 0
system: 4
usage: 18
user: 13
cpu2:
idle: 81
interrupt: 0
system: 4
usage: 18
user: 13
cpu3:
idle: 2
interrupt: 0
system: 50
usage: 97
user: 46
idle: 62
interrupt: 0
system: 17
usage: 37
user: 19
created_time: 1632684398
for_site: false
id: 00000000-0000-0000-1000-020000a80cb4
ip_stat:
ip: 192.168.1.244
ips:
ens18: 192.168.1.244/24,fe80::104c:ffff:fee0:caf8/64
macs:
ens18: e4434b217044
lag_stat:
lacp0:
active_ports:
- port0
- port1
last_seen: 1633721215
mac: 020000a80cb4
memory_stat:
active: 394936320
available: 4699291648
buffers: 107646976
cached: 478060544
free: 4330659840
inactive: 211980288
swap_cached: 0
swap_free: 1022357504
swap_total: 1022357504
total: 8365957120
usage: 48
model: ME-VM
modified_time: 1633643629
mxagent_registered: true
mxcluster_id: 678bc339-7635-4556-bbc0-e77ad493ef8b
name: me-vm-1
num_tunnels: 0
oob_ip_config:
dns:
- 8.8.8.8
- 1.1.1.1
gateway: 10.0.0.1
ip: 10.0.0.10
netmask: 255.255.255.0
type: static
org_id: 11b08247-b1ee-4152-9b25-312b323ce480
port_stat:
port0:
full_duplex: true
mac: 9e294e49091d
rx_bytes: 646898375700
rx_errors: 0
rx_pkts: 8784449574
speed: 10000
state: forwarding
tx_bytes: 647200748038
tx_errors: 0
tx_pkts: 8788647466
up: true
port1:
full_duplex: true
mac: a270fe53437e
rx_bytes: 647200437652
rx_errors: 0
rx_pkts: 8788644886
speed: 10000
state: forwarding
tx_bytes: 646898681650
tx_errors: 0
tx_pkts: 8784452092
up: true
serial: string
service_stat:
mxagent:
ext_ip: 99.0.86.164
last_seen: 1633721215
package_state: Installed
package_version: 3.1.1037-1
running_state: Running
uptime: 21240
tunterm:
ext_ip: 99.0.86.164
last_seen: 1633721203
package_state: Installed
package_version: 0.1.2449+deb10
running_state: Running
uptime: 76261
services:
- tunterm
site_id: 00000000-0000-0000-0000-000000000000
status: connected
tunterm_ip_config:
gateway: 192.168.11.1
ip: 192.168.11.91
netmask: 255.255.255.0
tunterm_port_config:
downstream_ports:
- '0'
- '1'
separate_upstream_downstream: false
upstream_ports:
- '0'
- '1'
tunterm_registered: true
tunterm_stat:
monitoring_failed: false
uptime: 76281
virtualization_type: KVM
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- cpu_stat:
cpus:
cpu0:
idle: 89
interrupt: 0
system: 8
usage: 10
user: 1
cpu1:
idle: 81
interrupt: 0
system: 4
usage: 18
user: 13
cpu2:
idle: 81
interrupt: 0
system: 4
usage: 18
user: 13
cpu3:
idle: 2
interrupt: 0
system: 50
usage: 97
user: 46
idle: 62
interrupt: 0
system: 17
usage: 37
user: 19
created_time: 1632684398
for_site: false
id: 00000000-0000-0000-1000-020000a80cb4
ip_stat:
ip: 192.168.1.244
ips:
ens18: 192.168.1.244/24,fe80::104c:ffff:fee0:caf8/64
macs:
ens18: e4434b217044
lag_stat:
lacp0:
active_ports:
- port0
- port1
last_seen: 1633721215
mac: 020000a80cb4
memory_stat:
active: 394936320
available: 4699291648
buffers: 107646976
cached: 478060544
free: 4330659840
inactive: 211980288
swap_cached: 0
swap_free: 1022357504
swap_total: 1022357504
total: 8365957120
usage: 48
model: ME-VM
modified_time: 1633643629
mxagent_registered: true
mxcluster_id: 678bc339-7635-4556-bbc0-e77ad493ef8b
name: me-vm-1
num_tunnels: 0
oob_ip_config:
dns:
- 8.8.8.8
- 1.1.1.1
gateway: 10.0.0.1
ip: 10.0.0.10
netmask: 255.255.255.0
type: static
org_id: 11b08247-b1ee-4152-9b25-312b323ce480
port_stat:
port0:
full_duplex: true
mac: 9e294e49091d
rx_bytes: 646898375700
rx_errors: 0
rx_pkts: 8784449574
speed: 10000
state: forwarding
tx_bytes: 647200748038
tx_errors: 0
tx_pkts: 8788647466
up: true
port1:
full_duplex: true
mac: a270fe53437e
rx_bytes: 647200437652
rx_errors: 0
rx_pkts: 8788644886
speed: 10000
state: forwarding
tx_bytes: 646898681650
tx_errors: 0
tx_pkts: 8784452092
up: true
serial: string
service_stat:
mxagent:
ext_ip: 99.0.86.164
last_seen: 1633721215
package_state: Installed
package_version: 3.1.1037-1
running_state: Running
uptime: 21240
tunterm:
ext_ip: 99.0.86.164
last_seen: 1633721203
package_state: Installed
package_version: 0.1.2449+deb10
running_state: Running
uptime: 76261
services:
- tunterm
site_id: 00000000-0000-0000-0000-000000000000
status: connected
tunterm_ip_config:
gateway: 192.168.11.1
ip: 192.168.11.91
netmask: 255.255.255.0
tunterm_port_config:
downstream_ports:
- '0'
- '1'
separate_upstream_downstream: false
upstream_ports:
- '0'
- '1'
tunterm_registered: true
tunterm_stat:
monitoring_failed: false
uptime: 76281
virtualization_type: KVM
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/stats/mxedges/{mxedge_id}:
get:
tags:
- Sites Stats - MxEdges
summary: getSiteMxEdgeStats
description: Get One Site MxEdge Stats
operationId: getSiteMxEdgeStats
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: mxedge_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
responses:
'200':
description: MxEdge Stats
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/stats_mxedge'
- description: Statistics for a Mist Edge appliance returned by stats endpoints
examples:
- cpu_stat:
cpus:
cpu0:
idle: 89
interrupt: 0
system: 8
usage: 10
user: 1
cpu1:
idle: 81
interrupt: 0
system: 4
usage: 18
user: 13
cpu2:
idle: 81
interrupt: 0
system: 4
usage: 18
user: 13
cpu3:
idle: 2
interrupt: 0
system: 50
usage: 97
user: 46
idle: 62
interrupt: 0
system: 17
usage: 37
user: 19
created_time: 1632684398
for_site: false
id: 00000000-0000-0000-1000-020000a80cb4
inactive_vlan_strs:
wired:
- '100'
- 102-106
ip_stat:
ip: 192.168.1.244
ips:
ens18: 192.168.1.244/24,fe80::104c:ffff:fee0:caf8/64
macs:
ens18: e4434b217044
lag_stat:
lacp0:
active_ports:
- port0
- port1
last_seen: 1633721215
mac: 020000a80cb4
memory_stat:
active: 394936320
available: 4699291648
buffers: 107646976
cached: 478060544
free: 4330659840
inactive: 211980288
swap_cached: 0
swap_free: 1022357504
swap_total: 1022357504
total: 8365957120
usage: 48
model: ME-VM
modified_time: 1633643629
mxagent_registered: true
mxcluster_id: 678bc339-7635-4556-bbc0-e77ad493ef8b
name: me-vm-1
num_tunnels: 0
oob_ip_config:
dns:
- 8.8.8.8
- 1.1.1.1
gateway: 10.0.0.1
ip: 10.0.0.10
netmask: 255.255.255.0
type: static
org_id: 11b08247-b1ee-4152-9b25-312b323ce480
port_stat:
port0:
full_duplex: true
mac: 9e294e49091d
rx_bytes: 646898375700
rx_errors: 0
rx_pkts: 8784449574
speed: 10000
state: forwarding
tx_bytes: 647200748038
tx_errors: 0
tx_pkts: 8788647466
up: true
port1:
full_duplex: true
mac: a270fe53437e
rx_bytes: 647200437652
rx_errors: 0
rx_pkts: 8788644886
speed: 10000
state: forwarding
tx_bytes: 646898681650
tx_errors: 0
tx_pkts: 8784452092
up: true
serial: string
service_stat:
mxagent:
ext_ip: 99.0.86.164
last_seen: 1633721215
package_state: Installed
package_version: 3.1.1037-1
running_state: Running
uptime: 21240
tunterm:
ext_ip: 99.0.86.164
last_seen: 1633721203
package_state: Installed
package_version: 0.1.2449+deb10
running_state: Running
uptime: 76261
services:
- tunterm
site_id: 00000000-0000-0000-0000-000000000000
status: connected
tunterm_ip_config:
gateway: 192.168.11.1
ip: 192.168.11.91
netmask: 255.255.255.0
tunterm_port_config:
downstream_ports:
- '0'
- '1'
separate_upstream_downstream: false
upstream_ports:
- '0'
- '1'
tunterm_registered: true
tunterm_stat:
monitoring_failed: false
uptime: 76281
virtualization_type: KVM
contentMediaType: application/json
examples:
Example:
value:
cpu_stat:
cpus:
cpu0:
idle: 89
interrupt: 0
system: 8
usage: 10
user: 1
cpu1:
idle: 81
interrupt: 0
system: 4
usage: 18
user: 13
cpu2:
idle: 81
interrupt: 0
system: 4
usage: 18
user: 13
cpu3:
idle: 2
interrupt: 0
system: 50
usage: 97
user: 46
idle: 62
interrupt: 0
system: 17
usage: 37
user: 19
created_time: 1632684398
for_site: false
id: 00000000-0000-0000-1000-020000a80cb4
inactive_vlan_strs:
wired:
- '100'
- 102-106
ip_stat:
ip: 192.168.1.244
ips:
ens18: 192.168.1.244/24,fe80::104c:ffff:fee0:caf8/64
macs:
ens18: e4434b217044
lag_stat:
lacp0:
active_ports:
- port0
- port1
last_seen: 1633721215
mac: 020000a80cb4
memory_stat:
active: 394936320
available: 4699291648
buffers: 107646976
cached: 478060544
free: 4330659840
inactive: 211980288
swap_cached: 0
swap_free: 1022357504
swap_total: 1022357504
total: 8365957120
usage: 48
model: ME-VM
modified_time: 1633643629
mxagent_registered: true
mxcluster_id: 678bc339-7635-4556-bbc0-e77ad493ef8b
name: me-vm-1
num_tunnels: 0
oob_ip_config:
dns:
- 8.8.8.8
- 1.1.1.1
gateway: 10.0.0.1
ip: 10.0.0.10
netmask: 255.255.255.0
type: static
org_id: 11b08247-b1ee-4152-9b25-312b323ce480
port_stat:
port0:
full_duplex: true
mac: 9e294e49091d
rx_bytes: 646898375700
rx_errors: 0
rx_pkts: 8784449574
speed: 10000
state: forwarding
tx_bytes: 647200748038
tx_errors: 0
tx_pkts: 8788647466
up: true
port1:
full_duplex: true
mac: a270fe53437e
rx_bytes: 647200437652
rx_errors: 0
rx_pkts: 8788644886
speed: 10000
state: forwarding
tx_bytes: 646898681650
tx_errors: 0
tx_pkts: 8784452092
up: true
serial: string
service_stat:
mxagent:
ext_ip: 99.0.86.164
last_seen: 1633721215
package_state: Installed
package_version: 3.1.1037-1
running_state: Running
uptime: 21240
tunterm:
ext_ip: 99.0.86.164
last_seen: 1633721203
package_state: Installed
package_version: 0.1.2449+deb10
running_state: Running
uptime: 76261
services:
- tunterm
site_id: 00000000-0000-0000-0000-000000000000
status: connected
tunterm_ip_config:
gateway: 192.168.11.1
ip: 192.168.11.91
netmask: 255.255.255.0
tunterm_port_config:
downstream_ports:
- '0'
- '1'
separate_upstream_downstream: false
upstream_ports:
- '0'
- '1'
tunterm_registered: true
tunterm_stat:
monitoring_failed: false
uptime: 76281
virtualization_type: KVM
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/stats_mxedge'
- description: Statistics for a Mist Edge appliance returned by stats endpoints
examples:
- cpu_stat:
cpus:
cpu0:
idle: 89
interrupt: 0
system: 8
usage: 10
user: 1
cpu1:
idle: 81
interrupt: 0
system: 4
usage: 18
user: 13
cpu2:
idle: 81
interrupt: 0
system: 4
usage: 18
user: 13
cpu3:
idle: 2
interrupt: 0
system: 50
usage: 97
user: 46
idle: 62
interrupt: 0
system: 17
usage: 37
user: 19
created_time: 1632684398
for_site: false
id: 00000000-0000-0000-1000-020000a80cb4
inactive_vlan_strs:
wired:
- '100'
- 102-106
ip_stat:
ip: 192.168.1.244
ips:
ens18: 192.168.1.244/24,fe80::104c:ffff:fee0:caf8/64
macs:
ens18: e4434b217044
lag_stat:
lacp0:
active_ports:
- port0
- port1
last_seen: 1633721215
mac: 020000a80cb4
memory_stat:
active: 394936320
available: 4699291648
buffers: 107646976
cached: 478060544
free: 4330659840
inactive: 211980288
swap_cached: 0
swap_free: 1022357504
swap_total: 1022357504
total: 8365957120
usage: 48
model: ME-VM
modified_time: 1633643629
mxagent_registered: true
mxcluster_id: 678bc339-7635-4556-bbc0-e77ad493ef8b
name: me-vm-1
num_tunnels: 0
oob_ip_config:
dns:
- 8.8.8.8
- 1.1.1.1
gateway: 10.0.0.1
ip: 10.0.0.10
netmask: 255.255.255.0
type: static
org_id: 11b08247-b1ee-4152-9b25-312b323ce480
port_stat:
port0:
full_duplex: true
mac: 9e294e49091d
rx_bytes: 646898375700
rx_errors: 0
rx_pkts: 8784449574
speed: 10000
state: forwarding
tx_bytes: 647200748038
tx_errors: 0
tx_pkts: 8788647466
up: true
port1:
full_duplex: true
mac: a270fe53437e
rx_bytes: 647200437652
rx_errors: 0
rx_pkts: 8788644886
speed: 10000
state: forwarding
tx_bytes: 646898681650
tx_errors: 0
tx_pkts: 8784452092
up: true
serial: string
service_stat:
mxagent:
ext_ip: 99.0.86.164
last_seen: 1633721215
package_state: Installed
package_version: 3.1.1037-1
running_state: Running
uptime: 21240
tunterm:
ext_ip: 99.0.86.164
last_seen: 1633721203
package_state: Installed
package_version: 0.1.2449+deb10
running_state: Running
uptime: 76261
services:
- tunterm
site_id: 00000000-0000-0000-0000-000000000000
status: connected
tunterm_ip_config:
gateway: 192.168.11.1
ip: 192.168.11.91
netmask: 255.255.255.0
tunterm_port_config:
downstream_ports:
- '0'
- '1'
separate_upstream_downstream: false
upstream_ports:
- '0'
- '1'
tunterm_registered: true
tunterm_stat:
monitoring_failed: false
uptime: 76281
virtualization_type: KVM
contentMediaType: application/vnd.api+json
examples:
Example:
value:
cpu_stat:
cpus:
cpu0:
idle: 89
interrupt: 0
system: 8
usage: 10
user: 1
cpu1:
idle: 81
interrupt: 0
system: 4
usage: 18
user: 13
cpu2:
idle: 81
interrupt: 0
system: 4
usage: 18
user: 13
cpu3:
idle: 2
interrupt: 0
system: 50
usage: 97
user: 46
idle: 62
interrupt: 0
system: 17
usage: 37
user: 19
created_time: 1632684398
for_site: false
id: 00000000-0000-0000-1000-020000a80cb4
inactive_vlan_strs:
wired:
- '100'
- 102-106
ip_stat:
ip: 192.168.1.244
ips:
ens18: 192.168.1.244/24,fe80::104c:ffff:fee0:caf8/64
macs:
ens18: e4434b217044
lag_stat:
lacp0:
active_ports:
- port0
- port1
last_seen: 1633721215
mac: 020000a80cb4
memory_stat:
active: 394936320
available: 4699291648
buffers: 107646976
cached: 478060544
free: 4330659840
inactive: 211980288
swap_cached: 0
swap_free: 1022357504
swap_total: 1022357504
total: 8365957120
usage: 48
model: ME-VM
modified_time: 1633643629
mxagent_registered: true
mxcluster_id: 678bc339-7635-4556-bbc0-e77ad493ef8b
name: me-vm-1
num_tunnels: 0
oob_ip_config:
dns:
- 8.8.8.8
- 1.1.1.1
gateway: 10.0.0.1
ip: 10.0.0.10
netmask: 255.255.255.0
type: static
org_id: 11b08247-b1ee-4152-9b25-312b323ce480
port_stat:
port0:
full_duplex: true
mac: 9e294e49091d
rx_bytes: 646898375700
rx_errors: 0
rx_pkts: 8784449574
speed: 10000
state: forwarding
tx_bytes: 647200748038
tx_errors: 0
tx_pkts: 8788647466
up: true
port1:
full_duplex: true
mac: a270fe53437e
rx_bytes: 647200437652
rx_errors: 0
rx_pkts: 8788644886
speed: 10000
state: forwarding
tx_bytes: 646898681650
tx_errors: 0
tx_pkts: 8784452092
up: true
serial: string
service_stat:
mxagent:
ext_ip: 99.0.86.164
last_seen: 1633721215
package_state: Installed
package_version: 3.1.1037-1
running_state: Running
uptime: 21240
tunterm:
ext_ip: 99.0.86.164
last_seen: 1633721203
package_state: Installed
package_version: 0.1.2449+deb10
running_state: Running
uptime: 76261
services:
- tunterm
site_id: 00000000-0000-0000-0000-000000000000
status: connected
tunterm_ip_config:
gateway: 192.168.11.1
ip: 192.168.11.91
netmask: 255.255.255.0
tunterm_port_config:
downstream_ports:
- '0'
- '1'
separate_upstream_downstream: false
upstream_ports:
- '0'
- '1'
tunterm_registered: true
tunterm_stat:
monitoring_failed: false
uptime: 76281
virtualization_type: KVM
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/stats/ospf_peers/count:
get:
tags:
- Sites Stats - Ospf
summary: countSiteOspfStats
description: Count OSPF peer statistics for a site, optionally grouped by the `distinct` field and filtered by time range. Use [Count Org OSPF Stats]($e/Orgs%20Stats%20-%20Ospf/countOrgOspfStats) to count OSPF peer statistics across the organization.
operationId: countSiteOspfStats
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field used to group this count response. enum: `site_id`, `org_id`, `mac`, `peer_ip`, `port_id`, `state`, `vrf_name`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/ospf_peer_stats_count_distinct'
- description: 'Field used to group this count response. enum: `site_id`, `org_id`, `mac`, `peer_ip`, `port_id`, `state`, `vrf_name`'
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/stats/ospf_peers/search:
get:
tags:
- Sites Stats - Ospf
summary: searchSiteOspfStats
description: Search OSPF peer statistics for a site with filters for device, VRF, peer IP, and time range. Use [Search Org OSPF Stats]($e/Orgs%20Stats%20-%20Ospf/searchOrgOspfStats) to search OSPF peer statistics across the organization.
operationId: searchSiteOspfStats
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: mac
in: query
description: Filter results by MAC address
style: form
explode: true
schema:
type: string
- name: vrf_name
in: query
description: Filter peer results by VRF name
style: form
explode: true
schema:
type: string
- name: peer_ip
in: query
description: Filter peer results by peer IP address
style: form
explode: true
schema:
type: string
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ospf_peer_stats_search_result'
- description: Paginated OSPF peer statistics search result
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/ospf_peer_stats_search_result'
- description: Paginated OSPF peer statistics search result
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/stats/ports/count:
get:
tags:
- Sites Stats - Ports
summary: countSiteSwOrGwPorts
description: Count switch and gateway port statistics for a site, optionally grouped by the `distinct` field and filtered by port, neighbor, PoE, STP, traffic, and time attributes. Use [Count Org Switch/Gateway Ports]($e/Orgs%20Stats%20-%20Ports/countOrgSwOrGwPorts) to count switch and gateway port statistics across the organization.
operationId: countSiteSwOrGwPorts
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field used to group this count response. enum: `full_duplex`, `mac`, `neighbor_mac`, `neighbor_port_desc`, `neighbor_system_name`, `poe_disabled`, `poe_mode`, `poe_on`, `port_id`, `port_mac`, `speed`, `up`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/site_ports_count_distinct'
- description: 'Field used to group this count response. enum: `full_duplex`, `mac`, `neighbor_mac`, `neighbor_port_desc`, `neighbor_system_name`, `poe_disabled`, `poe_mode`, `poe_on`, `port_id`, `port_mac`, `speed`, `up`'
- name: full_duplex
in: query
description: Indicates full or half duplex
style: form
explode: true
schema:
type: boolean
examples:
- true
- name: mac
in: query
description: Filter results by MAC address
style: form
explode: true
schema:
type: string
examples:
- 5c5b350e0410
- name: neighbor_mac
in: query
description: Chassis identifier of the chassis type listed
style: form
explode: true
schema:
type: string
examples:
- 5c5b350e0410
- name: neighbor_port_desc
in: query
description: Description supplied by the system on the interface E.g. "GigabitEthernet2/0/39"
style: form
explode: true
schema:
type: string
examples:
- ge-2/0/39
- name: neighbor_system_name
in: query
description: Name supplied by the system on the interface E.g. neighbor system name E.g. "Kumar-Acc-SW.mist.local"
style: form
explode: true
schema:
type: string
examples:
- Kumar-Acc-SW.mist.local
- name: poe_disabled
in: query
description: Is the POE configured not be disabled.
style: form
explode: true
schema:
type: boolean
examples:
- false
- name: poe_mode
in: query
description: POE mode depending on class E.g. "802.3at"
style: form
explode: true
schema:
type: string
examples:
- 802.3at
- name: poe_on
in: query
description: Is the device attached to POE
style: form
explode: true
schema:
type: boolean
examples:
- true
- name: port_id
in: query
description: Filter results by port identifier
style: form
explode: true
schema:
type: string
examples:
- ge-2/0/39
- name: port_mac
in: query
description: Filter results by port MAC address
style: form
explode: true
schema:
type: string
examples:
- 5c5b350e0410
- name: power_draw
in: query
description: Amount of power being used by the interface at the time the command is executed. Unit in watts.
style: form
explode: true
schema:
type: number
contentEncoding: double
examples:
- 15.4
- name: tx_pkts
in: query
description: Filter results by transmitted packet count
style: form
explode: true
schema:
type: integer
contentEncoding: int32
examples:
- 1000000
- name: rx_pkts
in: query
description: Filter results by received packet count
style: form
explode: true
schema:
type: integer
contentEncoding: int32
examples:
- 1000000
- name: rx_bytes
in: query
description: Filter results by received byte count
style: form
explode: true
schema:
type: integer
contentEncoding: int32
examples:
- 1000000
- name: tx_bps
in: query
description: Filter results by transmit rate
style: form
explode: true
schema:
type: integer
contentEncoding: int32
examples:
- 1000000
- name: rx_bps
in: query
description: Filter results by receive rate
style: form
explode: true
schema:
type: integer
contentEncoding: int32
examples:
- 1000000
- name: tx_mcast_pkts
in: query
description: Filter results by transmitted multicast packet count
style: form
explode: true
schema:
type: integer
contentEncoding: int32
examples:
- 1000000
- name: tx_bcast_pkts
in: query
description: Filter results by transmitted broadcast packet count
style: form
explode: true
schema:
type: integer
contentEncoding: int32
examples:
- 1000000
- name: rx_mcast_pkts
in: query
description: Filter results by received multicast packet count
style: form
explode: true
schema:
type: integer
contentEncoding: int32
examples:
- 1000000
- name: rx_bcast_pkts
in: query
description: Filter results by received broadcast packet count
style: form
explode: true
schema:
type: integer
contentEncoding: int32
examples:
- 1000000
- name: speed
in: query
description: Filter results by port speed
style: form
explode: true
schema:
type: integer
contentEncoding: int32
examples:
- 1000000000
- name: stp_state
in: query
description: 'STP state used to filter port results when `up`==`true`. enum: `""`, `blocking`, `disabled`, `forwarding`, `learning`, `listening`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/port_stp_state'
- description: 'STP state used to filter port results when `up`==`true`. enum: `""`, `blocking`, `disabled`, `forwarding`, `learning`, `listening`'
- name: stp_role
in: query
description: 'STP role used to filter port results when `up`==`true`. enum: `""`, `alternate`, `backup`, `designated`, `disabled`, `root`, `root-prevented`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/port_stp_role'
- description: 'STP role used to filter port results when `up`==`true`. enum: `""`, `alternate`, `backup`, `designated`, `disabled`, `root`, `root-prevented`'
- name: auth_state
in: query
description: 'Authentication state used to filter port results when `up`==`true` and the port has an authenticator role. enum: `""`, `authenticated`, `authenticating`, `held`, `init`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/port_auth_state'
- description: 'Authentication state used to filter port results when `up`==`true` and the port has an authenticator role. enum: `""`, `authenticated`, `authenticating`, `held`, `init`'
- name: up
in: query
description: Indicates if interface is up
style: form
explode: true
schema:
type: boolean
examples:
- true
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/stats/ports/search:
get:
tags:
- Sites Stats - Ports
summary: searchSiteSwOrGwPorts
description: >-
Search switch and gateway port statistics for a site.
Returns ports that match the search criteria, including current or most recent port status and statistics within the hour.
Traffic information (Tx/Rx) is reported as cumulative counters since the last device reboot. Use [Search Org Switch/Gateway Ports]($e/Orgs%20Stats%20-%20Ports/searchOrgSwOrGwPorts) to search switch and gateway port statistics across the organization.
operationId: searchSiteSwOrGwPorts
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_type
in: query
description: 'Type of device. enum: `switch`, `gateway`, `all`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/search_org_sw_or_gw_ports_type'
- description: 'Type of device. enum: `switch`, `gateway`, `all`'
- name: auth_state
in: query
description: 'Authentication state used to filter port results when `up`==`true` and the port has an authenticator role. enum: `""`, `authenticated`, `authenticating`, `held`, `init`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/port_auth_state'
- description: 'Authentication state used to filter port results when `up`==`true` and the port has an authenticator role. enum: `""`, `authenticated`, `authenticating`, `held`, `init`'
- name: full_duplex
in: query
description: Indicates full or half duplex
style: form
explode: true
schema:
type: boolean
- name: lte_imsi
in: query
description: LTE IMSI value, Check for null/empty
style: form
explode: true
schema:
type: string
examples:
- '310260000000001'
- name: lte_iccid
in: query
description: LTE ICCID value, Check for null/empty
style: form
explode: true
schema:
type: string
examples:
- '89014103211118510720'
- name: lte_imei
in: query
description: LTE IMEI value, Check for null/empty
style: form
explode: true
schema:
type: string
examples:
- '123456789012345'
- name: mac
in: query
description: Filter results by MAC address
style: form
explode: true
schema:
type: string
- name: neighbor_mac
in: query
description: Chassis identifier of the chassis type listed
style: form
explode: true
schema:
type: string
- name: neighbor_port_desc
in: query
description: Description supplied by the system on the interface E.g. "GigabitEthernet2/0/39"
style: form
explode: true
schema:
type: string
- name: neighbor_system_name
in: query
description: Name supplied by the system on the interface E.g. neighbor system name E.g. "Kumar-Acc-SW.mist.local"
style: form
explode: true
schema:
type: string
- name: poe_disabled
in: query
description: Is the POE configured not be disabled.
style: form
explode: true
schema:
type: boolean
- name: poe_mode
in: query
description: POE mode depending on class E.g. "802.3at"
style: form
explode: true
schema:
type: string
- name: poe_on
in: query
description: Is the device attached to POE
style: form
explode: true
schema:
type: boolean
- name: poe_priority
in: query
description: 'PoE priority used to filter switch port results. enum: `low`, `high`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/poe_priority'
- description: 'PoE priority used to filter switch port results. enum: `low`, `high`'
- name: port_id
in: query
description: Filter results by port identifier
style: form
explode: true
schema:
type: string
- name: port_mac
in: query
description: Filter results by port MAC address
style: form
explode: true
schema:
type: string
- name: speed
in: query
description: Filter results by port speed
style: form
explode: true
schema:
type: integer
contentEncoding: int32
- name: stp_state
in: query
description: 'STP state used to filter port results when `up`==`true`. enum: `""`, `blocking`, `disabled`, `forwarding`, `learning`, `listening`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/port_stp_state'
- description: 'STP state used to filter port results when `up`==`true`. enum: `""`, `blocking`, `disabled`, `forwarding`, `learning`, `listening`'
- name: stp_role
in: query
description: 'STP role used to filter port results when `up`==`true`. enum: `""`, `alternate`, `backup`, `designated`, `disabled`, `root`, `root-prevented`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/port_stp_role'
- description: 'STP role used to filter port results when `up`==`true`. enum: `""`, `alternate`, `backup`, `designated`, `disabled`, `root`, `root-prevented`'
- name: up
in: query
description: Indicates if interface is up
style: form
explode: true
schema:
type: boolean
- name: xcvr_part_number
in: query
description: Optic Slot Partnumber, Check for null/empty
style: form
explode: true
schema:
type: string
examples:
- SFP-10G-SR
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: List of Switch Ports Stats
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_switch_port_search'
- description: Paginated response for switch and gateway port statistics search results
examples:
- end: 1513177200
limit: 10
results:
- active: true
auth_state: init
for_site: true
full_duplex: true
jitter: 0
latency: 0
loss: 0
lte_iccid: string
lte_imei: string
lte_imsi: string
mac: 5c4527a96580
mac_count: 0
mac_limit: 0
neighbor_mac: 64d814353400
neighbor_port_desc: GigabitEthernet1/0/21
neighbor_system_name: CORP-D-SW-2
org_id: c168ddee-c14c-11e5-8e81-1258369c38a9
poe_disabled: true
poe_mode: 802.3af
poe_on: true
port_id: ge-0/0/0
port_mac: 5c4527a96580
port_usage: lan
power_draw: 0
rx_bcast_pkts: 0
rx_bps: 0
rx_bytes: 4563443626
rx_errors: 0
rx_mcast_pkts: 0
rx_pkts: 0
site_id: c1698122-c14c-11e5-8e81-1258369c38a9
speed: 1000
stp_role: designated
stp_state: forwarding
tx_bcast_pkts: 0
tx_bps: 0
tx_bytes: 11299516780
tx_errors: 0
tx_mcast_pkts: 0
tx_pkts: 492176
type: gateway
up: true
xcvr_part_number: string
start: 1511967600
total: 100
contentMediaType: application/json
examples:
Example:
value:
end: 1513177200
limit: 10
results:
- active: true
auth_state: init
for_site: true
full_duplex: true
jitter: 0
latency: 0
loss: 0
lte_iccid: string
lte_imei: string
lte_imsi: string
mac: 5c4527a96580
mac_count: 0
mac_limit: 0
neighbor_mac: 64d814353400
neighbor_port_desc: GigabitEthernet1/0/21
neighbor_system_name: CORP-D-SW-2
org_id: c168ddee-c14c-11e5-8e81-1258369c38a9
poe_disabled: true
poe_mode: 802.3af
poe_on: true
port_id: ge-0/0/0
port_mac: 5c4527a96580
port_usage: lan
power_draw: 0
rx_bcast_pkts: 0
rx_bps: 0
rx_bytes: 4563443626
rx_errors: 0
rx_mcast_pkts: 0
rx_pkts: 0
site_id: c1698122-c14c-11e5-8e81-1258369c38a9
speed: 1000
stp_role: designated
stp_state: forwarding
tx_bcast_pkts: 0
tx_bps: 0
tx_bytes: 11299516780
tx_errors: 0
tx_mcast_pkts: 0
tx_pkts: 492176
type: gateway
up: true
xcvr_part_number: string
start: 1511967600
total: 100
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_switch_port_search'
- description: Paginated response for switch and gateway port statistics search results
examples:
- end: 1513177200
limit: 10
results:
- active: true
auth_state: init
for_site: true
full_duplex: true
jitter: 0
latency: 0
loss: 0
lte_iccid: string
lte_imei: string
lte_imsi: string
mac: 5c4527a96580
mac_count: 0
mac_limit: 0
neighbor_mac: 64d814353400
neighbor_port_desc: GigabitEthernet1/0/21
neighbor_system_name: CORP-D-SW-2
org_id: c168ddee-c14c-11e5-8e81-1258369c38a9
poe_disabled: true
poe_mode: 802.3af
poe_on: true
port_id: ge-0/0/0
port_mac: 5c4527a96580
port_usage: lan
power_draw: 0
rx_bcast_pkts: 0
rx_bps: 0
rx_bytes: 4563443626
rx_errors: 0
rx_mcast_pkts: 0
rx_pkts: 0
site_id: c1698122-c14c-11e5-8e81-1258369c38a9
speed: 1000
stp_role: designated
stp_state: forwarding
tx_bcast_pkts: 0
tx_bps: 0
tx_bytes: 11299516780
tx_errors: 0
tx_mcast_pkts: 0
tx_pkts: 492176
type: gateway
up: true
xcvr_part_number: string
start: 1511967600
total: 100
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 1513177200
limit: 10
results:
- active: true
auth_state: init
for_site: true
full_duplex: true
jitter: 0
latency: 0
loss: 0
lte_iccid: string
lte_imei: string
lte_imsi: string
mac: 5c4527a96580
mac_count: 0
mac_limit: 0
neighbor_mac: 64d814353400
neighbor_port_desc: GigabitEthernet1/0/21
neighbor_system_name: CORP-D-SW-2
org_id: c168ddee-c14c-11e5-8e81-1258369c38a9
poe_disabled: true
poe_mode: 802.3af
poe_on: true
port_id: ge-0/0/0
port_mac: 5c4527a96580
port_usage: lan
power_draw: 0
rx_bcast_pkts: 0
rx_bps: 0
rx_bytes: 4563443626
rx_errors: 0
rx_mcast_pkts: 0
rx_pkts: 0
site_id: c1698122-c14c-11e5-8e81-1258369c38a9
speed: 1000
stp_role: designated
stp_state: forwarding
tx_bcast_pkts: 0
tx_bps: 0
tx_bytes: 11299516780
tx_errors: 0
tx_mcast_pkts: 0
tx_pkts: 492176
type: gateway
up: true
xcvr_part_number: string
start: 1511967600
total: 100
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/stats/wxrules:
get:
tags:
- Sites Stats - WxRules
summary: getSiteWxRulesUsage
description: Get Wxlan Rule usage
operationId: getSiteWxRulesUsage
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: WxRule Stats
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/stats_wxrule'
description: WxLAN rule usage statistics returned by the request
examples:
- - action: allow
client_mac:
- 3bbbf819bb6f
- bd96cbc4910f
dst_allow_wxtags:
- fff34466-eec0-3756-6765-381c728a6037
- eee2c7b0-d1d0-5a30-f349-e35fa43dc3b3
dst_deny_wxtags:
- aaa34466-eec0-3756-6765-381c728a6037
- bbb2c7b0-d1d0-5a30-f349-e35fa43dc3b3
dst_wxtags:
- d4134466-eec0-3756-6765-381c728a6037
- 1a42c7b0-d1d0-5a30-f349-e35fa43dc3b3
name: Guest
order: 1
src_wxtags:
- 8bfc2490-d726-3587-038d-cb2e71bd2330
- 3aa8e73f-9f46-d827-8d6a-567bb7e67fc9
usage:
1a42c7b0-d1d0-5a30-f349-e35fa43dc3b3:
num_flows: 60
d4134466-eec0-3756-6765-381c728a6037:
num_flows: 60
contentMediaType: application/json
examples:
Example:
value:
- action: allow
client_mac:
- 3bbbf819bb6f
- bd96cbc4910f
dst_allow_wxtags:
- fff34466-eec0-3756-6765-381c728a6037
- eee2c7b0-d1d0-5a30-f349-e35fa43dc3b3
dst_deny_wxtags:
- aaa34466-eec0-3756-6765-381c728a6037
- bbb2c7b0-d1d0-5a30-f349-e35fa43dc3b3
dst_wxtags:
- d4134466-eec0-3756-6765-381c728a6037
- 1a42c7b0-d1d0-5a30-f349-e35fa43dc3b3
name: Guest
order: 1
src_wxtags:
- 8bfc2490-d726-3587-038d-cb2e71bd2330
- 3aa8e73f-9f46-d827-8d6a-567bb7e67fc9
usage:
1a42c7b0-d1d0-5a30-f349-e35fa43dc3b3:
num_flows: 60
d4134466-eec0-3756-6765-381c728a6037:
num_flows: 60
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/stats_wxrule'
description: WxLAN rule usage statistics returned by the request
examples:
- - action: allow
client_mac:
- 3bbbf819bb6f
- bd96cbc4910f
dst_allow_wxtags:
- fff34466-eec0-3756-6765-381c728a6037
- eee2c7b0-d1d0-5a30-f349-e35fa43dc3b3
dst_deny_wxtags:
- aaa34466-eec0-3756-6765-381c728a6037
- bbb2c7b0-d1d0-5a30-f349-e35fa43dc3b3
dst_wxtags:
- d4134466-eec0-3756-6765-381c728a6037
- 1a42c7b0-d1d0-5a30-f349-e35fa43dc3b3
name: Guest
order: 1
src_wxtags:
- 8bfc2490-d726-3587-038d-cb2e71bd2330
- 3aa8e73f-9f46-d827-8d6a-567bb7e67fc9
usage:
1a42c7b0-d1d0-5a30-f349-e35fa43dc3b3:
num_flows: 60
d4134466-eec0-3756-6765-381c728a6037:
num_flows: 60
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- action: allow
client_mac:
- 3bbbf819bb6f
- bd96cbc4910f
dst_allow_wxtags:
- fff34466-eec0-3756-6765-381c728a6037
- eee2c7b0-d1d0-5a30-f349-e35fa43dc3b3
dst_deny_wxtags:
- aaa34466-eec0-3756-6765-381c728a6037
- bbb2c7b0-d1d0-5a30-f349-e35fa43dc3b3
dst_wxtags:
- d4134466-eec0-3756-6765-381c728a6037
- 1a42c7b0-d1d0-5a30-f349-e35fa43dc3b3
name: Guest
order: 1
src_wxtags:
- 8bfc2490-d726-3587-038d-cb2e71bd2330
- 3aa8e73f-9f46-d827-8d6a-567bb7e67fc9
usage:
1a42c7b0-d1d0-5a30-f349-e35fa43dc3b3:
num_flows: 60
d4134466-eec0-3756-6765-381c728a6037:
num_flows: 60
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/stats/rssizones:
get:
tags:
- Sites Stats - Zones
summary: listSiteRssiZonesStats
description: Get List of Site RSSI Zones Stats
operationId: listSiteRssiZonesStats
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/stats_rssi_zone'
description: RSSI-based zone statistics returned by the request
examples:
- - assets_wait:
avg: 0
max: 0
min: 0
p95: 0
clients_wait:
avg: 39259.333333333336
max: 58361
min: 12376
p95: 58361
created_time: 1733864928
devices:
- device_id: 00000000-0000-0000-1000-c8786708bb5d
rssi: -70
discovered_assets_wait:
avg: 0
max: 0
min: 0
p95: 0
id: 17ef7169-e000-4dcd-abc7-f721f0a8ffda
modified_time: 1733864928
name: proximity openspace
num_assets: 0
num_clients: 3
num_discovered_assets: 0
num_sdkclients: 0
num_unconnected_clients: 7
org_id: c5fbc9e4-12bf-436e-98c4-1c842c66ab6c
sdkclients_wait:
avg: 0
max: 0
min: 0
p95: 0
site_id: 079fafd3-ef5c-4b23-90f0-9fcebec0023a
unconnected_clients_wait:
avg: 37552.857142857145
max: 68342
min: 6649
p95: 68342
contentMediaType: application/json
examples:
Example-1:
value:
- assets_wait:
avg: 0
max: 0
min: 0
p95: 0
clients_wait:
avg: 39259.333333333336
max: 58361
min: 12376
p95: 58361
created_time: 1733864928
devices:
- device_id: 00000000-0000-0000-1000-c8786708bb5d
rssi: -70
discovered_assets_wait:
avg: 0
max: 0
min: 0
p95: 0
id: 17ef7169-e000-4dcd-abc7-f721f0a8ffda
modified_time: 1733864928
name: proximity openspace
num_assets: 0
num_clients: 3
num_discovered_assets: 0
num_sdkclients: 0
num_unconnected_clients: 7
org_id: c5fbc9e4-12bf-436e-98c4-1c842c66ab6c
sdkclients_wait:
avg: 0
max: 0
min: 0
p95: 0
site_id: 079fafd3-ef5c-4b23-90f0-9fcebec0023a
unconnected_clients_wait:
avg: 37552.857142857145
max: 68342
min: 6649
p95: 68342
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/stats_rssi_zone'
description: RSSI-based zone statistics returned by the request
examples:
- - assets_wait:
avg: 0
max: 0
min: 0
p95: 0
clients_wait:
avg: 39259.333333333336
max: 58361
min: 12376
p95: 58361
created_time: 1733864928
devices:
- device_id: 00000000-0000-0000-1000-c8786708bb5d
rssi: -70
discovered_assets_wait:
avg: 0
max: 0
min: 0
p95: 0
id: 17ef7169-e000-4dcd-abc7-f721f0a8ffda
modified_time: 1733864928
name: proximity openspace
num_assets: 0
num_clients: 3
num_discovered_assets: 0
num_sdkclients: 0
num_unconnected_clients: 7
org_id: c5fbc9e4-12bf-436e-98c4-1c842c66ab6c
sdkclients_wait:
avg: 0
max: 0
min: 0
p95: 0
site_id: 079fafd3-ef5c-4b23-90f0-9fcebec0023a
unconnected_clients_wait:
avg: 37552.857142857145
max: 68342
min: 6649
p95: 68342
contentMediaType: application/vnd.api+json
examples:
Example-1:
value:
- assets_wait:
avg: 0
max: 0
min: 0
p95: 0
clients_wait:
avg: 39259.333333333336
max: 58361
min: 12376
p95: 58361
created_time: 1733864928
devices:
- device_id: 00000000-0000-0000-1000-c8786708bb5d
rssi: -70
discovered_assets_wait:
avg: 0
max: 0
min: 0
p95: 0
id: 17ef7169-e000-4dcd-abc7-f721f0a8ffda
modified_time: 1733864928
name: proximity openspace
num_assets: 0
num_clients: 3
num_discovered_assets: 0
num_sdkclients: 0
num_unconnected_clients: 7
org_id: c5fbc9e4-12bf-436e-98c4-1c842c66ab6c
sdkclients_wait:
avg: 0
max: 0
min: 0
p95: 0
site_id: 079fafd3-ef5c-4b23-90f0-9fcebec0023a
unconnected_clients_wait:
avg: 37552.857142857145
max: 68342
min: 6649
p95: 68342
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/stats/rssizones/{zone_id}:
get:
tags:
- Sites Stats - Zones
summary: getSiteRssiZoneStats
description: Get Detail RSSI Zone Stats
operationId: getSiteRssiZoneStats
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: zone_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: Zone Stats
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/stats_zone_details'
- description: Detailed zone statistics and occupants for a site map zone
examples:
- assets:
- df8dff06ae90
client_waits:
avg: 1200
max: 3610
min: 600
p95: 2800
clients:
- 5684dae9ac8b
id: 8ac84899-32db-6327-334c-9b6d58544cfe
map_id: 63eda950-c6da-11e4-a628-60f81dd250cc
name: Board Room
num_clients: 80
num_sdkclients: 0
sdkclients:
- 7e2b463d-c91c-ff7d-f3c0-6eccc6949ff8
contentMediaType: application/json
examples:
Example:
value:
assets:
- df8dff06ae90
client_waits:
avg: 1200
max: 3610
min: 600
p95: 2800
clients:
- 5684dae9ac8b
id: 8ac84899-32db-6327-334c-9b6d58544cfe
map_id: 63eda950-c6da-11e4-a628-60f81dd250cc
name: Board Room
num_clients: 80
num_sdkclients: 0
sdkclients:
- 7e2b463d-c91c-ff7d-f3c0-6eccc6949ff8
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/stats_zone_details'
- description: Detailed zone statistics and occupants for a site map zone
examples:
- assets:
- df8dff06ae90
client_waits:
avg: 1200
max: 3610
min: 600
p95: 2800
clients:
- 5684dae9ac8b
id: 8ac84899-32db-6327-334c-9b6d58544cfe
map_id: 63eda950-c6da-11e4-a628-60f81dd250cc
name: Board Room
num_clients: 80
num_sdkclients: 0
sdkclients:
- 7e2b463d-c91c-ff7d-f3c0-6eccc6949ff8
contentMediaType: application/vnd.api+json
examples:
Example:
value:
assets:
- df8dff06ae90
client_waits:
avg: 1200
max: 3610
min: 600
p95: 2800
clients:
- 5684dae9ac8b
id: 8ac84899-32db-6327-334c-9b6d58544cfe
map_id: 63eda950-c6da-11e4-a628-60f81dd250cc
name: Board Room
num_clients: 80
num_sdkclients: 0
sdkclients:
- 7e2b463d-c91c-ff7d-f3c0-6eccc6949ff8
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/stats/zones:
get:
tags:
- Sites Stats - Zones
summary: listSiteZonesStats
description: Get List of Site Zones Stats
operationId: listSiteZonesStats
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: map_id
in: query
description: Filter results by map identifier
style: form
explode: true
schema:
type: string
examples:
- 00000000-0000-0000-0000-000000000000
- name: min_duration
in: query
description: Filter results by minimum duration
style: form
explode: true
schema:
type: integer
contentEncoding: int32
examples:
- 120
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/stats_zone'
description: Zone statistics records returned by a stats response
examples:
- '[{"assets_wait":{"avg":0,"max":0,"min":0,"p95":0},"clients_wait":{"avg":1200,"max":3610,"min":600,"p95":2800},"created_time":1616625211,"id":"123470c7-5d9d-424a-8475-8b344c621234","map_id":"123449d4-d12f-4feb-b40f-5be0e2ae1234","modified_time":1616625211,"name":"Zone A","num_assets":0,"num_clients":80,"num_sdkclients":10,"occupancy_limit":4,"org_id":"1234c1a0-6ef6-11e6-8bbf-02e208b21234","sdkclients_wait":{"avg":1200,"max":3610,"min":600,"p95":2800},"site_id":"123448e6-6ef6-11e6-8bbf-02e208b21234","vertices":[{"x":732,"y":1821},{"x":732.5,"y":1731},{"x":837.5,"y":1731.5},{"x":839,"y":1821}],"vertices_m":[{"x":24.1983341951072,"y":60.198314985369144},{"x":24.21486311190714,"y":57.22310996138056},{"x":27.685935639893827,"y":57.23963887818049},{"x":27.73552239029364,"y":60.198314985369144}]}]'
- '[{"created_time":1616625211,"id":"123470c7-5d9d-424a-8475-8b344c621234","map_id":"123449d4-d12f-4feb-b40f-5be0e2ae1234","modified_time":1616625211,"name":"Zone A","occupancy_limit":4,"org_id":"1234c1a0-6ef6-11e6-8bbf-02e208b21234","site_id":"123448e6-6ef6-11e6-8bbf-02e208b21234","vertices":[{"x":732,"y":1821},{"x":732.5,"y":1731},{"x":837.5,"y":1731.5},{"x":839,"y":1821}],"vertices_m":[{"x":24.1983341951072,"y":60.198314985369144},{"x":24.21486311190714,"y":57.22310996138056},{"x":27.685935639893827,"y":57.23963887818049},{"x":27.73552239029364,"y":60.198314985369144}]}]'
contentMediaType: application/json
examples:
Example-1:
value:
- assets_wait:
avg: 0
max: 0
min: 0
p95: 0
clients_wait:
avg: 1200
max: 3610
min: 600
p95: 2800
created_time: 1616625211
id: 123470c7-5d9d-424a-8475-8b344c621234
map_id: 123449d4-d12f-4feb-b40f-5be0e2ae1234
modified_time: 1616625211
name: Zone A
num_assets: 0
num_clients: 80
num_sdkclients: 10
occupancy_limit: 4
org_id: 1234c1a0-6ef6-11e6-8bbf-02e208b21234
sdkclients_wait:
avg: 1200
max: 3610
min: 600
p95: 2800
site_id: 123448e6-6ef6-11e6-8bbf-02e208b21234
vertices:
- x: 732
y: 1821
- x: 732.5
y: 1731
- x: 837.5
y: 1731.5
- x: 839
y: 1821
vertices_m:
- x: 24.1983341951072
y: 60.198314985369144
- x: 24.21486311190714
y: 57.22310996138056
- x: 27.685935639893827
y: 57.23963887818049
- x: 27.73552239029364
y: 60.198314985369144
without-map_id-query-param:
value:
- created_time: 1616625211
id: 123470c7-5d9d-424a-8475-8b344c621234
map_id: 123449d4-d12f-4feb-b40f-5be0e2ae1234
modified_time: 1616625211
name: Zone A
occupancy_limit: 4
org_id: 1234c1a0-6ef6-11e6-8bbf-02e208b21234
site_id: 123448e6-6ef6-11e6-8bbf-02e208b21234
vertices:
- x: 732
y: 1821
- x: 732.5
y: 1731
- x: 837.5
y: 1731.5
- x: 839
y: 1821
vertices_m:
- x: 24.1983341951072
y: 60.198314985369144
- x: 24.21486311190714
y: 57.22310996138056
- x: 27.685935639893827
y: 57.23963887818049
- x: 27.73552239029364
y: 60.198314985369144
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/stats_zone'
description: Zone statistics records returned by a stats response
examples:
- '[{"assets_wait":{"avg":0,"max":0,"min":0,"p95":0},"clients_wait":{"avg":1200,"max":3610,"min":600,"p95":2800},"created_time":1616625211,"id":"123470c7-5d9d-424a-8475-8b344c621234","map_id":"123449d4-d12f-4feb-b40f-5be0e2ae1234","modified_time":1616625211,"name":"Zone A","num_assets":0,"num_clients":80,"num_sdkclients":10,"occupancy_limit":4,"org_id":"1234c1a0-6ef6-11e6-8bbf-02e208b21234","sdkclients_wait":{"avg":1200,"max":3610,"min":600,"p95":2800},"site_id":"123448e6-6ef6-11e6-8bbf-02e208b21234","vertices":[{"x":732,"y":1821},{"x":732.5,"y":1731},{"x":837.5,"y":1731.5},{"x":839,"y":1821}],"vertices_m":[{"x":24.1983341951072,"y":60.198314985369144},{"x":24.21486311190714,"y":57.22310996138056},{"x":27.685935639893827,"y":57.23963887818049},{"x":27.73552239029364,"y":60.198314985369144}]}]'
- '[{"created_time":1616625211,"id":"123470c7-5d9d-424a-8475-8b344c621234","map_id":"123449d4-d12f-4feb-b40f-5be0e2ae1234","modified_time":1616625211,"name":"Zone A","occupancy_limit":4,"org_id":"1234c1a0-6ef6-11e6-8bbf-02e208b21234","site_id":"123448e6-6ef6-11e6-8bbf-02e208b21234","vertices":[{"x":732,"y":1821},{"x":732.5,"y":1731},{"x":837.5,"y":1731.5},{"x":839,"y":1821}],"vertices_m":[{"x":24.1983341951072,"y":60.198314985369144},{"x":24.21486311190714,"y":57.22310996138056},{"x":27.685935639893827,"y":57.23963887818049},{"x":27.73552239029364,"y":60.198314985369144}]}]'
contentMediaType: application/vnd.api+json
examples:
Example-1:
value:
- assets_wait:
avg: 0
max: 0
min: 0
p95: 0
clients_wait:
avg: 1200
max: 3610
min: 600
p95: 2800
created_time: 1616625211
id: 123470c7-5d9d-424a-8475-8b344c621234
map_id: 123449d4-d12f-4feb-b40f-5be0e2ae1234
modified_time: 1616625211
name: Zone A
num_assets: 0
num_clients: 80
num_sdkclients: 10
occupancy_limit: 4
org_id: 1234c1a0-6ef6-11e6-8bbf-02e208b21234
sdkclients_wait:
avg: 1200
max: 3610
min: 600
p95: 2800
site_id: 123448e6-6ef6-11e6-8bbf-02e208b21234
vertices:
- x: 732
y: 1821
- x: 732.5
y: 1731
- x: 837.5
y: 1731.5
- x: 839
y: 1821
vertices_m:
- x: 24.1983341951072
y: 60.198314985369144
- x: 24.21486311190714
y: 57.22310996138056
- x: 27.685935639893827
y: 57.23963887818049
- x: 27.73552239029364
y: 60.198314985369144
without-map_id-query-param:
value:
- created_time: 1616625211
id: 123470c7-5d9d-424a-8475-8b344c621234
map_id: 123449d4-d12f-4feb-b40f-5be0e2ae1234
modified_time: 1616625211
name: Zone A
occupancy_limit: 4
org_id: 1234c1a0-6ef6-11e6-8bbf-02e208b21234
site_id: 123448e6-6ef6-11e6-8bbf-02e208b21234
vertices:
- x: 732
y: 1821
- x: 732.5
y: 1731
- x: 837.5
y: 1731.5
- x: 839
y: 1821
vertices_m:
- x: 24.1983341951072
y: 60.198314985369144
- x: 24.21486311190714
y: 57.22310996138056
- x: 27.685935639893827
y: 57.23963887818049
- x: 27.73552239029364
y: 60.198314985369144
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/stats/zones/{zone_id}:
get:
tags:
- Sites Stats - Zones
summary: getSiteZoneStats
description: Get Detail Zone Stats
operationId: getSiteZoneStats
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: zone_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: Zone Stats
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/stats_zone_details'
- description: Detailed zone statistics and occupants for a site map zone
examples:
- assets:
- df8dff06ae90
client_waits:
avg: 1200
max: 3610
min: 600
p95: 2800
clients:
- 5684dae9ac8b
id: 8ac84899-32db-6327-334c-9b6d58544cfe
map_id: 63eda950-c6da-11e4-a628-60f81dd250cc
name: Board Room
num_clients: 80
num_sdkclients: 0
sdkclients:
- 7e2b463d-c91c-ff7d-f3c0-6eccc6949ff8
contentMediaType: application/json
examples:
Example:
value:
assets:
- df8dff06ae90
client_waits:
avg: 1200
max: 3610
min: 600
p95: 2800
clients:
- 5684dae9ac8b
id: 8ac84899-32db-6327-334c-9b6d58544cfe
map_id: 63eda950-c6da-11e4-a628-60f81dd250cc
name: Board Room
num_clients: 80
num_sdkclients: 0
sdkclients:
- 7e2b463d-c91c-ff7d-f3c0-6eccc6949ff8
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/stats_zone_details'
- description: Detailed zone statistics and occupants for a site map zone
examples:
- assets:
- df8dff06ae90
client_waits:
avg: 1200
max: 3610
min: 600
p95: 2800
clients:
- 5684dae9ac8b
id: 8ac84899-32db-6327-334c-9b6d58544cfe
map_id: 63eda950-c6da-11e4-a628-60f81dd250cc
name: Board Room
num_clients: 80
num_sdkclients: 0
sdkclients:
- 7e2b463d-c91c-ff7d-f3c0-6eccc6949ff8
contentMediaType: application/vnd.api+json
examples:
Example:
value:
assets:
- df8dff06ae90
client_waits:
avg: 1200
max: 3610
min: 600
p95: 2800
clients:
- 5684dae9ac8b
id: 8ac84899-32db-6327-334c-9b6d58544cfe
map_id: 63eda950-c6da-11e4-a628-60f81dd250cc
name: Board Room
num_clients: 80
num_sdkclients: 0
sdkclients:
- 7e2b463d-c91c-ff7d-f3c0-6eccc6949ff8
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/stats/discovered_switch_metrics/search:
get:
tags:
- Sites Stats - Discovered Switches
summary: searchSiteDiscoveredSwitchesMetrics
description: Search Discovered Switch Metrics
operationId: searchSiteDiscoveredSwitchesMetrics
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: scope
in: query
description: 'Filter results by scope. enum: `site`, `switch`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/discovered_switches_metric_scope'
- description: 'Filter results by scope. enum: `site`, `switch`'
- name: type
in: query
description: 'Metric type. enum: `inactive_wired_vlans`, `poe_compliance`, `switch_ap_affinity`, `version_compliance`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/discovered_switch_metric_type'
- description: 'Metric type. enum: `inactive_wired_vlans`, `poe_compliance`, `switch_ap_affinity`, `version_compliance`'
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_discovered_switch_metrics'
- description: Paginated response for discovered switch metric search results
examples:
- end: 1675193686.0191767
limit: 1
next: /api/v1/sites/f5fcbee5-fbca-45b3-8bf1-1619ede87879/stats/discovered_switch_metrics/search?end=1675193686.0191767&limit=1&search_after=%5B1675193400000%5D&start=1675107286.0191767
results:
- org_id: 203d3d02-dbc0-4c1b-9f41-76896a3330f4
scope: site
score: 100
site_id: f5fcbee5-fbca-45b3-8bf1-1619ede87879
timestamp: 1675193400
type: inactive_wired_vlans
start: 1675107286.0191767
total: 3
contentMediaType: application/json
examples:
Example:
value:
end: 1675193686.0191767
limit: 1
next: /api/v1/sites/f5fcbee5-fbca-45b3-8bf1-1619ede87879/stats/discovered_switch_metrics/search?end=1675193686.0191767&limit=1&search_after=%5B1675193400000%5D&start=1675107286.0191767
results:
- org_id: 203d3d02-dbc0-4c1b-9f41-76896a3330f4
scope: site
score: 100
site_id: f5fcbee5-fbca-45b3-8bf1-1619ede87879
timestamp: 1675193400
type: inactive_wired_vlans
start: 1675107286.0191767
total: 3
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_discovered_switch_metrics'
- description: Paginated response for discovered switch metric search results
examples:
- end: 1675193686.0191767
limit: 1
next: /api/v1/sites/f5fcbee5-fbca-45b3-8bf1-1619ede87879/stats/discovered_switch_metrics/search?end=1675193686.0191767&limit=1&search_after=%5B1675193400000%5D&start=1675107286.0191767
results:
- org_id: 203d3d02-dbc0-4c1b-9f41-76896a3330f4
scope: site
score: 100
site_id: f5fcbee5-fbca-45b3-8bf1-1619ede87879
timestamp: 1675193400
type: inactive_wired_vlans
start: 1675107286.0191767
total: 3
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 1675193686.0191767
limit: 1
next: /api/v1/sites/f5fcbee5-fbca-45b3-8bf1-1619ede87879/stats/discovered_switch_metrics/search?end=1675193686.0191767&limit=1&search_after=%5B1675193400000%5D&start=1675107286.0191767
results:
- org_id: 203d3d02-dbc0-4c1b-9f41-76896a3330f4
scope: site
score: 100
site_id: f5fcbee5-fbca-45b3-8bf1-1619ede87879
timestamp: 1675193400
type: inactive_wired_vlans
start: 1675107286.0191767
total: 3
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/stats/discovered_switches/count:
get:
tags:
- Sites Stats - Discovered Switches
summary: countSiteDiscoveredSwitches
description: Count Discovered Switches
operationId: countSiteDiscoveredSwitches
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field used to group this count response. enum: `mgmt_addr`, `model`, `system_name`, `version`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/site_discovered_switches_count_distinct'
- description: 'Field used to group this count response. enum: `mgmt_addr`, `model`, `system_name`, `version`'
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/stats/discovered_switches/metrics:
get:
tags:
- Sites Stats - Discovered Switches
summary: listSiteDiscoveredSwitchesMetrics
description: Discovered switches related metrics, lists related switch system names & details if not compliant
operationId: listSiteDiscoveredSwitchesMetrics
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: threshold
in: query
description: 'Configurable # ap per switch threshold, default 12'
style: form
explode: true
schema:
type: string
examples:
- '12'
- name: system_name
in: query
description: System name for switch level metrics, optional
style: form
explode: true
schema:
type: string
examples:
- switch1.example.com
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_dswitches_metrics'
- description: Metrics summary returned for discovered switch compliance checks
examples:
- inactive_wired_vlans:
details: {}
score: 100
poe_compliance:
details:
total_aps: 63
total_power: 981500
score: 100
switch_ap_affinity:
details:
system_name:
- mist-lab-ex2300c
- switch1
threshold: 12
score: 33.3333
version_compliance:
details:
major_versions:
- major_count: 2
model: EX2300-C-12P
system_names:
- switch1
- mist-lab-ex2300c
- major_count: 1
model: EX4300-48P
system_names: []
total_switch_count: 5
score: 75
contentMediaType: application/json
examples:
Example:
value:
inactive_wired_vlans:
details: {}
score: 100
poe_compliance:
details:
total_aps: 63
total_power: 981500
score: 100
switch_ap_affinity:
details:
system_name:
- mist-lab-ex2300c
- switch1
threshold: 12
score: 33.3333
version_compliance:
details:
major_versions:
- major_count: 2
model: EX2300-C-12P
system_names:
- switch1
- mist-lab-ex2300c
- major_count: 1
model: EX4300-48P
system_names: []
total_switch_count: 5
score: 75
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_dswitches_metrics'
- description: Metrics summary returned for discovered switch compliance checks
examples:
- inactive_wired_vlans:
details: {}
score: 100
poe_compliance:
details:
total_aps: 63
total_power: 981500
score: 100
switch_ap_affinity:
details:
system_name:
- mist-lab-ex2300c
- switch1
threshold: 12
score: 33.3333
version_compliance:
details:
major_versions:
- major_count: 2
model: EX2300-C-12P
system_names:
- switch1
- mist-lab-ex2300c
- major_count: 1
model: EX4300-48P
system_names: []
total_switch_count: 5
score: 75
contentMediaType: application/vnd.api+json
examples:
Example:
value:
inactive_wired_vlans:
details: {}
score: 100
poe_compliance:
details:
total_aps: 63
total_power: 981500
score: 100
switch_ap_affinity:
details:
system_name:
- mist-lab-ex2300c
- switch1
threshold: 12
score: 33.3333
version_compliance:
details:
major_versions:
- major_count: 2
model: EX2300-C-12P
system_names:
- switch1
- mist-lab-ex2300c
- major_count: 1
model: EX4300-48P
system_names: []
total_switch_count: 5
score: 75
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/stats/discovered_switches/search:
get:
tags:
- Sites Stats - Discovered Switches
summary: searchSiteDiscoveredSwitches
description: Search Discovered Switches
operationId: searchSiteDiscoveredSwitches
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: adopted
in: query
description: Filter results by whether the device is adopted
style: form
explode: true
schema:
type: boolean
examples:
- true
- name: system_name
in: query
description: Filter discovered switch results by system name
style: form
explode: true
schema:
type: string
examples:
- switch1.example.com
- name: hostname
in: query
description: Filter results by hostname
style: form
explode: true
schema:
type: string
examples:
- switch1
- name: vendor
in: query
description: Filter results by vendor
style: form
explode: true
schema:
type: string
examples:
- Cisco
- name: model
in: query
description: Filter results by device model
style: form
explode: true
schema:
type: string
examples:
- WS-C3850-24P
- name: version
in: query
description: Filter results by software version
style: form
explode: true
schema:
type: string
examples:
- 1.0.0
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_discovered_switches'
- description: Paginated response for discovered switch search results
examples:
- end: 1604496474.8978634
limit: 1000
results:
- aps:
- hostname: ap41nearlab
inactive_wired_vlans: []
mac: 5c5b352e2001
poe_status: true
when: 2019-06-13T19:53:16.870+0000
mgmt_addr: 10.1.1.1
model: EX2300-C-12P
org_id: 6748cfa6-4e12-11e6-9188-0242ac110007
site_id: 67970e46-4e12-11e6-9188-0242ac110007
system_desc: 'Juniper Networks, Inc. ex2300-c-12p Ethernet Switch, kernel JUNOS 18.2R2.6, Build date: 2018-12-07 13:19:04 UTC Copyright (c) 1996-2018 Juniper Networks, Inc.'
system_name: mist-lab-ex2300c
timestamp: 1560457177.037
vendor: Juniper Networks
version: 18.2R2.6
start: 1604410074.8978484
total: 1
contentMediaType: application/json
examples:
Example:
value:
end: 1604496474.8978634
limit: 1000
results:
- aps:
- hostname: ap41nearlab
inactive_wired_vlans: []
mac: 5c5b352e2001
poe_status: true
when: 2019-06-13T19:53:16.870+0000
mgmt_addr: 10.1.1.1
model: EX2300-C-12P
org_id: 6748cfa6-4e12-11e6-9188-0242ac110007
site_id: 67970e46-4e12-11e6-9188-0242ac110007
system_desc: 'Juniper Networks, Inc. ex2300-c-12p Ethernet Switch, kernel JUNOS 18.2R2.6, Build date: 2018-12-07 13:19:04 UTC Copyright (c) 1996-2018 Juniper Networks, Inc.'
system_name: mist-lab-ex2300c
timestamp: 1560457177.037
vendor: Juniper Networks
version: 18.2R2.6
start: 1604410074.8978484
total: 1
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_discovered_switches'
- description: Paginated response for discovered switch search results
examples:
- end: 1604496474.8978634
limit: 1000
results:
- aps:
- hostname: ap41nearlab
inactive_wired_vlans: []
mac: 5c5b352e2001
poe_status: true
when: 2019-06-13T19:53:16.870+0000
mgmt_addr: 10.1.1.1
model: EX2300-C-12P
org_id: 6748cfa6-4e12-11e6-9188-0242ac110007
site_id: 67970e46-4e12-11e6-9188-0242ac110007
system_desc: 'Juniper Networks, Inc. ex2300-c-12p Ethernet Switch, kernel JUNOS 18.2R2.6, Build date: 2018-12-07 13:19:04 UTC Copyright (c) 1996-2018 Juniper Networks, Inc.'
system_name: mist-lab-ex2300c
timestamp: 1560457177.037
vendor: Juniper Networks
version: 18.2R2.6
start: 1604410074.8978484
total: 1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 1604496474.8978634
limit: 1000
results:
- aps:
- hostname: ap41nearlab
inactive_wired_vlans: []
mac: 5c5b352e2001
poe_status: true
when: 2019-06-13T19:53:16.870+0000
mgmt_addr: 10.1.1.1
model: EX2300-C-12P
org_id: 6748cfa6-4e12-11e6-9188-0242ac110007
site_id: 67970e46-4e12-11e6-9188-0242ac110007
system_desc: 'Juniper Networks, Inc. ex2300-c-12p Ethernet Switch, kernel JUNOS 18.2R2.6, Build date: 2018-12-07 13:19:04 UTC Copyright (c) 1996-2018 Juniper Networks, Inc.'
system_name: mist-lab-ex2300c
timestamp: 1560457177.037
vendor: Juniper Networks
version: 18.2R2.6
start: 1604410074.8978484
total: 1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/iotendpoints/count:
get:
tags:
- Sites Stats - IoT Endpoints
summary: countSiteIotEndpoints
description: Count IoT Endpoints
operationId: countSiteIotEndpoints
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: distinct
in: query
description: 'Field used to group this count response. enum: `ap_mac`, `mac`, `site_id`, `type`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/site_iotendpoints_count_distinct'
- description: 'Field used to group this count response. enum: `ap_mac`, `mac`, `site_id`, `type`'
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
responses:
'200':
description: Result of Count
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_count'
- description: Distinct count response for time-bounded search results
examples:
- distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
contentMediaType: application/vnd.api+json
examples:
Example:
value:
distinct: string
end: 0
limit: 0
results:
- count: 0
property: string
start: 0
total: 0
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/iotendpoints/search:
get:
tags:
- Sites Stats - IoT Endpoints
summary: searchSiteIotEndpoints
description: Search IoT Endpoints
operationId: searchSiteIotEndpoints
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: ap_mac
in: query
description: Filter results by AP MAC address
style: form
explode: true
schema:
type: string
examples:
- 5c5b350e0001
- name: mac
in: query
description: Filter results by MAC address
style: form
explode: true
schema:
type: string
examples:
- 63f9e299182b63f9
- name: type
in: query
description: 'IoT endpoint type. enum: `zigbee`'
style: form
explode: true
schema:
type: string
examples:
- zigbee
- name: mfg
in: query
description: Filter results by manufacturer
style: form
explode: true
schema:
type: string
examples:
- Assa Abloy
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_iot_endpoints_search'
- description: Time-bounded response for IoT endpoint search results
examples:
- end: 1531862583
results:
- ap_mac: 5c5b350e0001
id: 63f9e299182b63f9
lqi: 178
mac: 63f9e299182b63f9
mfg: Assa Abloy
model: Assa Abloy
timestamp: 1531782218
type: zigbee
start: 1531776183
total: 2
contentMediaType: application/json
examples:
Example:
value:
end: 1531862583
results:
- ap_mac: 5c5b350e0001
id: 63f9e299182b63f9
lqi: 178
mac: 63f9e299182b63f9
mfg: Assa Abloy
model: Assa Abloy
timestamp: 1531782218
type: zigbee
start: 1531776183
total: 2
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_iot_endpoints_search'
- description: Time-bounded response for IoT endpoint search results
examples:
- end: 1531862583
results:
- ap_mac: 5c5b350e0001
id: 63f9e299182b63f9
lqi: 178
mac: 63f9e299182b63f9
mfg: Assa Abloy
model: Assa Abloy
timestamp: 1531782218
type: zigbee
start: 1531776183
total: 2
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 1531862583
results:
- ap_mac: 5c5b350e0001
id: 63f9e299182b63f9
lqi: 178
mac: 63f9e299182b63f9
mfg: Assa Abloy
model: Assa Abloy
timestamp: 1531782218
type: zigbee
start: 1531776183
total: 2
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/iotendpoints/{id}/zigbee_rejoin:
post:
tags:
- Sites Stats - IoT Endpoints
summary: rejoinSiteIotEndpointZigbee
description: Trigger a Zigbee endpoint to rejoin the network
operationId: rejoinSiteIotEndpointZigbee
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: id
in: path
description: ID of the IoT Endpoint
required: true
schema:
type: string
contentEncoding: uuid
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/const/ap_channels:
get:
tags:
- Constants Definitions
summary: listApChannels
description: Return supported AP radio channels for the requested country code, based on the regulatory domain used by Mist AP configuration.
operationId: listApChannels
parameters:
- name: country_code
in: query
description: Country code, in two-character
style: form
explode: true
schema:
pattern: ^[a-zA-Z]{2}$
type: string
examples:
- US
responses:
'200':
description: AP Channels
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/const_ap_channel'
- description: Country and regulatory-domain channel capabilities for AP radios
examples:
- 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
contentMediaType: application/json
examples:
Example:
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
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/const_ap_channel'
- description: Country and regulatory-domain channel capabilities for AP radios
examples:
- 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
contentMediaType: application/vnd.api+json
examples:
Example:
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
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/const/ap_esl_versions:
get:
tags:
- Constants Definitions
summary: listApLEslVersions
description: Return Electronic Shelf Label (ESL) firmware versions available per AP model.
operationId: listApLEslVersions
parameters: []
responses:
'200':
description: List of Available AP ESL Versions
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/const_ap_esl_version'
description: Supported Electronic Shelf Label versions by AP model
examples:
- - esl_version: 2.5.1
model: AP34
- esl_version: 2.5.0
model: AP43
contentMediaType: application/json
examples:
Example:
value:
- esl_version: 2.5.1
model: AP34
- esl_version: 2.5.0
model: AP43
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/const_ap_esl_version'
description: Supported Electronic Shelf Label versions by AP model
examples:
- - esl_version: 2.5.1
model: AP34
- esl_version: 2.5.0
model: AP43
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- esl_version: 2.5.1
model: AP34
- esl_version: 2.5.0
model: AP43
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/const/ap_led_status:
get:
tags:
- Constants Definitions
summary: listApLedDefinition
description: Return AP LED status definitions, including the values used to describe LED behavior and the corresponding `error_code` value.
operationId: listApLedDefinition
parameters: []
responses:
'200':
description: List of AP Led Status
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/const_ap_led'
description: AP LED status and trouble-code definitions returned by the constants API
examples:
- - code: '01'
description: LED not working
key: LED_FAILURE
name: LED Failure
contentMediaType: application/json
examples:
Example:
value:
- code: '01'
description: LED not working
key: LED_FAILURE
name: LED Failure
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/const_ap_led'
description: AP LED status and trouble-code definitions returned by the constants API
examples:
- - code: '01'
description: LED not working
key: LED_FAILURE
name: LED Failure
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- code: '01'
description: LED not working
key: LED_FAILURE
name: LED Failure
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/const/app_categories:
get:
tags:
- Constants Definitions
summary: listAppCategoryDefinitions
description: Return supported application categories used for application identification, traffic classification, and policy matching.
operationId: listAppCategoryDefinitions
parameters: []
responses:
'200':
description: List of Application Categories Definitions
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/const_app_category_definition'
description: Application category definitions returned by the constants API
examples:
- - 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
contentMediaType: application/json
examples:
Example:
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
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/const_app_category_definition'
description: Application category definitions returned by the constants API
examples:
- - 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
contentMediaType: application/vnd.api+json
examples:
Example:
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
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/const/app_subcategories:
get:
tags:
- Constants Definitions
summary: listAppSubCategoryDefinitions
description: Return supported application subcategories used for application identification, traffic classification, and policy matching.
operationId: listAppSubCategoryDefinitions
parameters: []
responses:
'200':
description: List of Application Sub-categories Definitions
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/const_app_subcategory_definition'
description: Application subcategory definitions returned by the constants API
examples:
- - display: Office Documents
key: Office_Documents
traffic_type: data_interactive
contentMediaType: application/json
examples:
Example:
value:
- display: Office Documents
key: Office_Documents
traffic_type: data_interactive
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/const_app_subcategory_definition'
description: Application subcategory definitions returned by the constants API
examples:
- - display: Office Documents
key: Office_Documents
traffic_type: data_interactive
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- display: Office Documents
key: Office_Documents
traffic_type: data_interactive
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/const/applications:
get:
tags:
- Constants Definitions
summary: listApplications
description: Return applications recognized by Juniper Mist devices for traffic classification and application analytics.
operationId: listApplications
parameters: []
responses:
'200':
description: List of Applications
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/const_application_definition'
description: Application definitions returned by the constants API
examples:
- - 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
contentMediaType: application/json
examples:
Example:
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
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/const_application_definition'
description: Application definitions returned by the constants API
examples:
- - 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
contentMediaType: application/vnd.api+json
examples:
Example:
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
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/const/countries:
get:
tags:
- Constants Definitions
summary: listCountryCodes
description: Return supported country codes for Mist configuration. Set `extend=true` to include additional country codes when available.
operationId: listCountryCodes
parameters:
- name: extend
in: query
description: Will include more country codes if true
style: form
explode: true
schema:
type: boolean
default: false
responses:
'200':
description: List of Countries
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/const_country'
description: Country definitions returned by the constants API
examples:
- - alpha2: FR
certified: true
name: France
numeric: 250
contentMediaType: application/json
examples:
Example:
value:
- alpha2: FR
certified: true
name: France
numeric: 250
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/const_country'
description: Country definitions returned by the constants API
examples:
- - alpha2: FR
certified: true
name: France
numeric: 250
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- alpha2: FR
certified: true
name: France
numeric: 250
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/const/fingerprint_types:
get:
tags:
- Constants Definitions
summary: listFingerprintTypes
description: Return supported client fingerprint attribute values (`family`, `model`, `mfg`, and `os_type`) that can be used in [Mist NAC Rules]($h/Orgs%20NAC%20Rules/_overview) `matching` conditions.
operationId: listFingerprintTypes
parameters: []
responses:
'200':
description: List of Fingerprint Types
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/const_fingerprint_types'
- description: Supported client fingerprint values for NAC matching
examples:
- 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
contentMediaType: application/json
examples:
Example:
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
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/const_fingerprint_types'
- description: Supported client fingerprint values for NAC matching
examples:
- 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
contentMediaType: application/vnd.api+json
examples:
Example:
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
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/const/gateway_applications:
get:
tags:
- Constants Definitions
summary: listGatewayApplications
description: Return applications recognized by Mist gateways for traffic classification.
operationId: listGatewayApplications
parameters: []
responses:
'200':
description: List of Alarm Definitions
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/const_gateway_applications_definition'
description: Gateway application definitions returned by the constants API
examples:
- - app_id: true
key: 4shared
name: 4shared
ssr_app_id: true
contentMediaType: application/json
examples:
Example:
value:
- app_id: true
key: 4shared
name: 4shared
ssr_app_id: true
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/const_gateway_applications_definition'
description: Gateway application definitions returned by the constants API
examples:
- - app_id: true
key: 4shared
name: 4shared
ssr_app_id: true
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- app_id: true
key: 4shared
name: 4shared
ssr_app_id: true
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/const/insight_metrics:
get:
tags:
- Constants Definitions
summary: listInsightMetrics
description: Return supported insight metric names and metadata used by insight and SLE APIs.
operationId: listInsightMetrics
parameters: []
responses:
'200':
description: Insight Metrics Definition
headers: {}
content:
application/json:
schema:
type: object
additionalProperties:
$ref: '#/components/schemas/const_insight_metrics_property'
description: Property key is the metric name
contentMediaType: application/json
application/vnd.api+json:
schema:
type: object
additionalProperties:
$ref: '#/components/schemas/const_insight_metrics_property'
description: Property key is the metric name
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/const/languages:
get:
tags:
- Constants Definitions
summary: listSiteLanguages
description: Return supported language codes for localized Mist configuration and user-facing portals.
operationId: listSiteLanguages
parameters: []
responses:
'200':
description: List of Languages
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/const_language'
description: Language options returned by the constants API
examples:
- - display: English (US)
display_native: English (US)
key: en-US
contentMediaType: application/json
examples:
Example:
value:
- display: English (US)
display_native: English (US)
key: en-US
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/const_language'
description: Language options returned by the constants API
examples:
- - display: English (US)
display_native: English (US)
key: en-US
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- display: English (US)
display_native: English (US)
key: en-US
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/const/license_types:
get:
tags:
- Constants Definitions
summary: listLicenseTypes
description: Return Mist license type definitions used by inventory and subscription APIs.
operationId: listLicenseTypes
parameters: []
responses:
'200':
description: List of License Types
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/const_license_type'
description: License type definitions returned by the constants API
examples:
- - description: Wired Assurance 12
includes:
- sub_ex12a
- sub_ex12p
key: sub_ex12
name: SUB-EX12
contentMediaType: application/json
examples:
Example:
value:
- description: Wired Assurance 12
includes:
- sub_ex12a
- sub_ex12p
key: sub_ex12
name: SUB-EX12
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/const_license_type'
description: License type definitions returned by the constants API
examples:
- - description: Wired Assurance 12
includes:
- sub_ex12a
- sub_ex12p
key: sub_ex12
name: SUB-EX12
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- description: Wired Assurance 12
includes:
- sub_ex12a
- sub_ex12p
key: sub_ex12
name: SUB-EX12
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/const/marvisclient_events:
get:
tags:
- Constants Definitions
summary: listMarvisClientEventsDefinitions
description: Return Marvis Client event type definitions used by the Marvis Client event search and count APIs.
operationId: listMarvisClientEventsDefinitions
parameters: []
responses:
'200':
description: List of Marvis Client event type definitions
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/const_marvisclient_event'
description: Marvis Client event type definitions returned by the constants API
examples:
- - display: Marvis Client Roamed
key: MARVISCLIENT_ROAMED
contentMediaType: application/json
examples:
Example:
value:
- display: Marvis Client Roamed
key: MARVISCLIENT_ROAMED
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/const_marvisclient_event'
description: Marvis Client event type definitions returned by the constants API
examples:
- - display: Marvis Client Roamed
key: MARVISCLIENT_ROAMED
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- display: Marvis Client Roamed
key: MARVISCLIENT_ROAMED
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/const/marvisclient_versions:
get:
tags:
- Constants Definitions
summary: listMarvisClientVersions
description: Return available Marvis Client application versions for tracking or managing Marvis Client deployments.
operationId: listMarvisClientVersions
parameters: []
responses:
'200':
description: List of Webhook Topics
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/const_marvis_client_version'
description: Marvis Client installer versions returned by the constants API
examples:
- - label: latest
notes: ''
os: android
url: https://mobile.mist.com/installers/marvisclient/android/1.1.9/marvisclient-installer.apk
version: 1.1.9
- label: rc1
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
contentMediaType: application/json
examples:
Example:
value:
- label: latest
notes: ''
os: android
url: https://mobile.mist.com/installers/marvisclient/android/1.1.9/marvisclient-installer.apk
version: 1.1.9
- label: rc1
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
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/const_marvis_client_version'
description: Marvis Client installer versions returned by the constants API
examples:
- - label: latest
notes: ''
os: android
url: https://mobile.mist.com/installers/marvisclient/android/1.1.9/marvisclient-installer.apk
version: 1.1.9
- label: rc1
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
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- label: latest
notes: ''
os: android
url: https://mobile.mist.com/installers/marvisclient/android/1.1.9/marvisclient-installer.apk
version: 1.1.9
- label: rc1
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
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/const/states:
get:
tags:
- Constants Definitions
summary: listStates
description: Return ISO state or province codes for the supplied country code.
operationId: listStates
parameters:
- name: country_code
in: query
description: Country code, in [two-character]($e/Constants%20Definitions/listCountryCodes)
required: true
style: form
explode: true
schema:
type: string
examples:
- US
responses:
'200':
description: List of Countries
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/const_state'
description: State and territory definitions returned by the constants API
examples:
- - 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
contentMediaType: application/json
examples:
Example:
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
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/const_state'
description: State and territory definitions returned by the constants API
examples:
- - 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
contentMediaType: application/vnd.api+json
examples:
Example:
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
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/const/traffic_types:
get:
tags:
- Constants Definitions
summary: listTrafficTypes
description: Return traffic type definitions used to classify recognized network traffic.
operationId: listTrafficTypes
parameters: []
responses:
'200':
description: List of Traffic Types
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/const_traffic_type'
description: Traffic type definitions returned by the constants API
examples:
- - display: VoIP Video
dscp: 32
failover_policy: non_revertible
max_jitter: 250
max_latency: 1500
max_loss: 35
name: voip_video
traffic_class: medium
contentMediaType: application/json
examples:
Example:
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
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/const_traffic_type'
description: Traffic type definitions returned by the constants API
examples:
- - display: VoIP Video
dscp: 32
failover_policy: non_revertible
max_jitter: 250
max_latency: 1500
max_loss: 35
name: voip_video
traffic_class: medium
contentMediaType: application/vnd.api+json
examples:
Example:
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
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/const/webhook_topics:
get:
tags:
- Constants Definitions
summary: listWebhookTopics
description: Return webhook topic definitions that can be subscribed to in webhook configuration.
operationId: listWebhookTopics
parameters: []
responses:
'200':
description: List of Webhook Topics
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/const_webhook_topic'
description: Webhook topic definitions returned by the constants API
examples:
- - 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
contentMediaType: application/json
examples:
Example:
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
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/const_webhook_topic'
description: Webhook topic definitions returned by the constants API
examples:
- - 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
contentMediaType: application/vnd.api+json
examples:
Example:
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
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/const/alarm_defs:
get:
tags:
- Constants Events
summary: listAlarmDefinitions
description: >-
Return alarm type definitions used by alarm search results, alarm templates, and the `alarm` webhook topic. The `example` field shows representative webhook payload content.
HA cluster node names are returned in the `node` field, when applicable.
operationId: listAlarmDefinitions
parameters: []
responses:
'200':
description: List of Alarm Definitions
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/const_alarm_definition'
description: Alarm type definitions returned by the constants API
examples:
- - display: Device offline
example:
aps:
- d420b02000fa
count: 1
group: infrastructure
hostnames:
- Vendor_AP2
id: e70c308f-7007-4866-9ecd-0d01842979ea
last_seen: 1629753888
org_id: 09dac91f-6e73-4100-89f7-698e0fafbb1b
severity: warn
site_id: dcfb31a1-d615-4361-8c95-b9dde05aa704
timestamp: 1629753888
type: device_down
fields:
- aps
- hostnames
group: infrastructure
key: device_down
marvis_suggestion_category: string
severity: warn
contentMediaType: application/json
examples:
Example:
value:
- display: Device offline
example:
aps:
- d420b02000fa
count: 1
group: infrastructure
hostnames:
- Vendor_AP2
id: e70c308f-7007-4866-9ecd-0d01842979ea
last_seen: 1629753888
org_id: 09dac91f-6e73-4100-89f7-698e0fafbb1b
severity: warn
site_id: dcfb31a1-d615-4361-8c95-b9dde05aa704
timestamp: 1629753888
type: device_down
fields:
- aps
- hostnames
group: infrastructure
key: device_down
marvis_suggestion_category: string
severity: warn
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/const_alarm_definition'
description: Alarm type definitions returned by the constants API
examples:
- - display: Device offline
example:
aps:
- d420b02000fa
count: 1
group: infrastructure
hostnames:
- Vendor_AP2
id: e70c308f-7007-4866-9ecd-0d01842979ea
last_seen: 1629753888
org_id: 09dac91f-6e73-4100-89f7-698e0fafbb1b
severity: warn
site_id: dcfb31a1-d615-4361-8c95-b9dde05aa704
timestamp: 1629753888
type: device_down
fields:
- aps
- hostnames
group: infrastructure
key: device_down
marvis_suggestion_category: string
severity: warn
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- display: Device offline
example:
aps:
- d420b02000fa
count: 1
group: infrastructure
hostnames:
- Vendor_AP2
id: e70c308f-7007-4866-9ecd-0d01842979ea
last_seen: 1629753888
org_id: 09dac91f-6e73-4100-89f7-698e0fafbb1b
severity: warn
site_id: dcfb31a1-d615-4361-8c95-b9dde05aa704
timestamp: 1629753888
type: device_down
fields:
- aps
- hostnames
group: infrastructure
key: device_down
marvis_suggestion_category: string
severity: warn
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/const/client_events:
get:
tags:
- Constants Events
summary: listClientEventsDefinitions
description: Return client event definitions used by client event search and count APIs, including event keys and metadata.
operationId: listClientEventsDefinitions
parameters: []
responses:
'200':
description: List of Client Events definitions
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/const_event'
description: Event type definitions returned by the constants API
examples:
- - display: 11r Association
key: CLIENT_AUTH_ASSOCIATION_11R
contentMediaType: application/json
examples:
Example:
value:
- display: 11r Association
key: CLIENT_AUTH_ASSOCIATION_11R
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/const_event'
description: Event type definitions returned by the constants API
examples:
- - display: 11r Association
key: CLIENT_AUTH_ASSOCIATION_11R
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- display: 11r Association
key: CLIENT_AUTH_ASSOCIATION_11R
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/const/device_events:
get:
tags:
- Constants Events
summary: listDeviceEventsDefinitions
description: Return device event definitions used by device event search and count APIs and the `device-events` webhook topic, including event keys and metadata.
operationId: listDeviceEventsDefinitions
parameters: []
responses:
'200':
description: List of Device Events Definitions
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/const_event'
description: Event type definitions returned by the constants API
examples:
- - description: AP was assigned to a site
display: AP Assigned
example:
ap: 5c5b35000001
audit_id: e9a88814-fa81-5bdc-34b0-84e8735420e5
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
timestamp: 1552408871
type: AP_ASSIGNED
key: AP_ASSIGNED
contentMediaType: application/json
examples:
Example:
value:
- description: AP was assigned to a site
display: AP Assigned
example:
ap: 5c5b35000001
audit_id: e9a88814-fa81-5bdc-34b0-84e8735420e5
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
timestamp: 1552408871
type: AP_ASSIGNED
key: AP_ASSIGNED
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/const_event'
description: Event type definitions returned by the constants API
examples:
- - description: AP was assigned to a site
display: AP Assigned
example:
ap: 5c5b35000001
audit_id: e9a88814-fa81-5bdc-34b0-84e8735420e5
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
timestamp: 1552408871
type: AP_ASSIGNED
key: AP_ASSIGNED
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- description: AP was assigned to a site
display: AP Assigned
example:
ap: 5c5b35000001
audit_id: e9a88814-fa81-5bdc-34b0-84e8735420e5
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
timestamp: 1552408871
type: AP_ASSIGNED
key: AP_ASSIGNED
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/const/mxedge_events:
get:
tags:
- Constants Events
summary: listMxEdgeEventsDefinitions
description: Return Mist Edge event definitions used by Mist Edge event search and count APIs, and `mexedge-events` webhook topic.
operationId: listMxEdgeEventsDefinitions
parameters: []
responses:
'200':
description: List of MxEdge Events definitions
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/const_event'
description: Event type definitions returned by the constants API
examples:
- - description: Config change on ME was triggered as a result of change made by user
display: ME Config changed by user
example:
audit_id: e9a88814-fa81-5bdc-34b0-84e8735420e5
mxcluster_id: ed4665ed-c9ad-4835-8ca5-dda642765ad3
mxedge_id: 387804a7-3474-85ce-15a2-f9a9684c9c9
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
service: mxagent
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
timestamp: 1552408871
type: ME_CONFIG_CHANGED_BY_USER
key: ME_CONFIG_CHANGED_BY_USER
contentMediaType: application/json
examples:
Example:
value:
- description: Config change on ME was triggered as a result of change made by user
display: ME Config changed by user
example:
audit_id: e9a88814-fa81-5bdc-34b0-84e8735420e5
mxcluster_id: ed4665ed-c9ad-4835-8ca5-dda642765ad3
mxedge_id: 387804a7-3474-85ce-15a2-f9a9684c9c9
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
service: mxagent
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
timestamp: 1552408871
type: ME_CONFIG_CHANGED_BY_USER
key: ME_CONFIG_CHANGED_BY_USER
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/const_event'
description: Event type definitions returned by the constants API
examples:
- - description: Config change on ME was triggered as a result of change made by user
display: ME Config changed by user
example:
audit_id: e9a88814-fa81-5bdc-34b0-84e8735420e5
mxcluster_id: ed4665ed-c9ad-4835-8ca5-dda642765ad3
mxedge_id: 387804a7-3474-85ce-15a2-f9a9684c9c9
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
service: mxagent
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
timestamp: 1552408871
type: ME_CONFIG_CHANGED_BY_USER
key: ME_CONFIG_CHANGED_BY_USER
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- description: Config change on ME was triggered as a result of change made by user
display: ME Config changed by user
example:
audit_id: e9a88814-fa81-5bdc-34b0-84e8735420e5
mxcluster_id: ed4665ed-c9ad-4835-8ca5-dda642765ad3
mxedge_id: 387804a7-3474-85ce-15a2-f9a9684c9c9
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
service: mxagent
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
timestamp: 1552408871
type: ME_CONFIG_CHANGED_BY_USER
key: ME_CONFIG_CHANGED_BY_USER
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/const/nac_events:
get:
tags:
- Constants Events
summary: listNacEventsDefinitions
description: Return NAC client event definitions used by NAC client event search and count APIs, and `nac-events` webhook topic.
operationId: listNacEventsDefinitions
parameters: []
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/const_nac_event'
description: NAC event example payloads returned by the constants API
examples:
- - ap: 5c5b355008c0
bssid: 5c5b35548892
cert_cn: suriyas
cert_expiry: 1711557441
cert_issuer: /DC=net/DC=jnpr/CN=Juniper Networks Issuing AWS1 CA
cert_san_upn:
- suriyas@juniper.net
cert_serial: 1300103d29e56ef083797bedc2000100103d29
cert_subject: /CN=suriyas/emailAddress=suriyas@juniper.net
eap_type: EAP-TLS
nas_vendor: Mist
org_id: 94de66e8-556a-4d56-8780-a114620a5c42
random_mac: true
site_id: b5a005ab-47d4-41f7-97bf-733f9cc252dd
ssid: Test_Suriya-SSID
timestamp: 1685658478.438995
type: NAC_CLIENT_CERT_CHECK_SUCCESS
username: suriyas@juniper.net
wcid: b43637b0-f0d9-0a1d-1ec2-73c394a9f679
contentMediaType: application/json
examples:
Example:
value:
- ap: 5c5b355008c0
bssid: 5c5b35548892
cert_cn: suriyas
cert_expiry: 1711557441
cert_issuer: /DC=net/DC=jnpr/CN=Juniper Networks Issuing AWS1 CA
cert_san_upn:
- suriyas@juniper.net
cert_serial: 1300103d29e56ef083797bedc2000100103d29
cert_subject: /CN=suriyas/emailAddress=suriyas@juniper.net
eap_type: EAP-TLS
nas_vendor: Mist
org_id: 94de66e8-556a-4d56-8780-a114620a5c42
random_mac: true
site_id: b5a005ab-47d4-41f7-97bf-733f9cc252dd
ssid: Test_Suriya-SSID
timestamp: 1685658478.438995
type: NAC_CLIENT_CERT_CHECK_SUCCESS
username: suriyas@juniper.net
wcid: b43637b0-f0d9-0a1d-1ec2-73c394a9f679
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/const_nac_event'
description: NAC event example payloads returned by the constants API
examples:
- - ap: 5c5b355008c0
bssid: 5c5b35548892
cert_cn: suriyas
cert_expiry: 1711557441
cert_issuer: /DC=net/DC=jnpr/CN=Juniper Networks Issuing AWS1 CA
cert_san_upn:
- suriyas@juniper.net
cert_serial: 1300103d29e56ef083797bedc2000100103d29
cert_subject: /CN=suriyas/emailAddress=suriyas@juniper.net
eap_type: EAP-TLS
nas_vendor: Mist
org_id: 94de66e8-556a-4d56-8780-a114620a5c42
random_mac: true
site_id: b5a005ab-47d4-41f7-97bf-733f9cc252dd
ssid: Test_Suriya-SSID
timestamp: 1685658478.438995
type: NAC_CLIENT_CERT_CHECK_SUCCESS
username: suriyas@juniper.net
wcid: b43637b0-f0d9-0a1d-1ec2-73c394a9f679
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- ap: 5c5b355008c0
bssid: 5c5b35548892
cert_cn: suriyas
cert_expiry: 1711557441
cert_issuer: /DC=net/DC=jnpr/CN=Juniper Networks Issuing AWS1 CA
cert_san_upn:
- suriyas@juniper.net
cert_serial: 1300103d29e56ef083797bedc2000100103d29
cert_subject: /CN=suriyas/emailAddress=suriyas@juniper.net
eap_type: EAP-TLS
nas_vendor: Mist
org_id: 94de66e8-556a-4d56-8780-a114620a5c42
random_mac: true
site_id: b5a005ab-47d4-41f7-97bf-733f9cc252dd
ssid: Test_Suriya-SSID
timestamp: 1685658478.438995
type: NAC_CLIENT_CERT_CHECK_SUCCESS
username: suriyas@juniper.net
wcid: b43637b0-f0d9-0a1d-1ec2-73c394a9f679
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/const/otherdevice_events:
get:
tags:
- Constants Events
summary: listOtherDeviceEventsDefinitions
description: Return event definitions for other or third-party devices managed or monitored by Mist.
operationId: listOtherDeviceEventsDefinitions
parameters: []
responses:
'200':
description: List of Other Device Events definitions
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/const_event'
description: Event type definitions returned by the constants API
examples:
- - display: Connected to NCM
example:
device_mac: 5c5b351e13b5
mac: 0030447771c0
org_id: c080ce4d-4e35-4373-bdc4-08df15d257f5
site_id: 1df889ad-9111-4c0e-a00b-8a008b83eb68
text: Connected to NCM
timestamp: 1675827825.765
type: CELLULAR_EDGE_CONNECTED_TO_NCM
vendor: cradlepoint
key: CELLULAR_EDGE_CONNECTED_TO_NCM
contentMediaType: application/json
examples:
Example:
value:
- display: Connected to NCM
example:
device_mac: 5c5b351e13b5
mac: 0030447771c0
org_id: c080ce4d-4e35-4373-bdc4-08df15d257f5
site_id: 1df889ad-9111-4c0e-a00b-8a008b83eb68
text: Connected to NCM
timestamp: 1675827825.765
type: CELLULAR_EDGE_CONNECTED_TO_NCM
vendor: cradlepoint
key: CELLULAR_EDGE_CONNECTED_TO_NCM
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/const_event'
description: Event type definitions returned by the constants API
examples:
- - display: Connected to NCM
example:
device_mac: 5c5b351e13b5
mac: 0030447771c0
org_id: c080ce4d-4e35-4373-bdc4-08df15d257f5
site_id: 1df889ad-9111-4c0e-a00b-8a008b83eb68
text: Connected to NCM
timestamp: 1675827825.765
type: CELLULAR_EDGE_CONNECTED_TO_NCM
vendor: cradlepoint
key: CELLULAR_EDGE_CONNECTED_TO_NCM
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- display: Connected to NCM
example:
device_mac: 5c5b351e13b5
mac: 0030447771c0
org_id: c080ce4d-4e35-4373-bdc4-08df15d257f5
site_id: 1df889ad-9111-4c0e-a00b-8a008b83eb68
text: Connected to NCM
timestamp: 1675827825.765
type: CELLULAR_EDGE_CONNECTED_TO_NCM
vendor: cradlepoint
key: CELLULAR_EDGE_CONNECTED_TO_NCM
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/const/system_events:
get:
tags:
- Constants Events
summary: listSystemEventsDefinitions
description: Return system event definitions used by system event search APIs.
operationId: listSystemEventsDefinitions
parameters: []
responses:
'200':
description: List of System Events definitions
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/const_event'
description: Event type definitions returned by the constants API
examples:
- - display: AP Disconnect
group: ap_health
key: ap_disconnected
contentMediaType: application/json
examples:
Example:
value:
- display: AP Disconnect
group: ap_health
key: ap_disconnected
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/const_event'
description: Event type definitions returned by the constants API
examples:
- - display: AP Disconnect
group: ap_health
key: ap_disconnected
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- display: AP Disconnect
group: ap_health
key: ap_disconnected
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/const/default_gateway_config:
get:
tags:
- Constants Models
summary: getGatewayDefaultConfig
description: Generate the default gateway configuration for the requested model and HA mode.
operationId: getGatewayDefaultConfig
parameters:
- name: model
in: query
description: Device model for which to generate the default gateway config.
required: true
style: form
explode: true
schema:
type: string
examples:
- srx550
- name: ha
in: query
description: Whether the config is intended for HA
style: form
explode: true
schema:
type: string
examples:
- 'false'
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: object
examples:
- dhcpd_config:
lan:
ip_end: 192.168.1.254
ip_start: 192.168.1.2
ip_configs:
lan:
ip: 192.168.1.1
type: static
networks:
lan:
name: lan
subnet: 192.168.1.0/24
vlan_id: 1
path_preferences:
wan:
paths:
- name: wan
type: wan
port_config:
cl-1/0/0:
ip_config:
type: dhcp
name: lte
usage: wan
wan_type: lte
ge-0/0/0,ge-0/0/7:
ip_config:
type: dhcp
name: wan
usage: wan
ge-0/0/1-6:
port_network: lan
usage: lan
service_policies:
- action: allow
name: Internet
path_preference: wan
services:
- any
tenants:
- lan
contentMediaType: application/json
examples:
Example:
value:
dhcpd_config:
lan:
ip_end: 192.168.1.254
ip_start: 192.168.1.2
ip_configs:
lan:
ip: 192.168.1.1
type: static
networks:
lan:
name: lan
subnet: 192.168.1.0/24
vlan_id: 1
path_preferences:
wan:
paths:
- name: wan
type: wan
port_config:
cl-1/0/0:
ip_config:
type: dhcp
name: lte
usage: wan
wan_type: lte
ge-0/0/0,ge-0/0/7:
ip_config:
type: dhcp
name: wan
usage: wan
ge-0/0/1-6:
port_network: lan
usage: lan
service_policies:
- action: allow
name: Internet
path_preference: wan
services:
- any
tenants:
- lan
application/vnd.api+json:
schema:
type: object
examples:
- dhcpd_config:
lan:
ip_end: 192.168.1.254
ip_start: 192.168.1.2
ip_configs:
lan:
ip: 192.168.1.1
type: static
networks:
lan:
name: lan
subnet: 192.168.1.0/24
vlan_id: 1
path_preferences:
wan:
paths:
- name: wan
type: wan
port_config:
cl-1/0/0:
ip_config:
type: dhcp
name: lte
usage: wan
wan_type: lte
ge-0/0/0,ge-0/0/7:
ip_config:
type: dhcp
name: wan
usage: wan
ge-0/0/1-6:
port_network: lan
usage: lan
service_policies:
- action: allow
name: Internet
path_preference: wan
services:
- any
tenants:
- lan
contentMediaType: application/vnd.api+json
examples:
Example:
value:
dhcpd_config:
lan:
ip_end: 192.168.1.254
ip_start: 192.168.1.2
ip_configs:
lan:
ip: 192.168.1.1
type: static
networks:
lan:
name: lan
subnet: 192.168.1.0/24
vlan_id: 1
path_preferences:
wan:
paths:
- name: wan
type: wan
port_config:
cl-1/0/0:
ip_config:
type: dhcp
name: lte
usage: wan
wan_type: lte
ge-0/0/0,ge-0/0/7:
ip_config:
type: dhcp
name: wan
usage: wan
ge-0/0/1-6:
port_network: lan
usage: lan
service_policies:
- action: allow
name: Internet
path_preference: wan
services:
- any
tenants:
- lan
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/const/device_models:
get:
tags:
- Constants Models
summary: listDeviceModels
description: Return AP, Switch and Gateway device models supported by Mist, including their features and capabilities.
operationId: listDeviceModels
parameters: []
responses:
'200':
description: List of supported device models
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/const_device_model'
description: Device model definitions returned by the constants API
examples:
- '[{"defaults":{"ha_control_port":"ge-0/0/1","ha_data_ports":"ge-0/0/2,ge-3/0/2","ha_fxp0_port":"ge-0/0/0","ha_lan_ports":"ge-0/0/4,ge-3/0/4","ha_wan_ports":"ge-0/0/3,ge-3/0/3","lan_ports":"ge-0/0/1-6","lte_wan_ports":"cl-1/0/0","wan_ports":"ge-0/0/0,ge-0/0/7"},"description":"Juniper SRX320 Series","fans_pluggable":false,"ha_node0_fpc":3,"ha_node1_fpc":3,"has_bgp":true,"has_fxp0":false,"has_ha_control":false,"has_ha_data":false,"has_irb":true,"has_poe_out":true,"has_snapshot":true,"irb_disabled_by_default":false,"model":"SRX320","number_fans":1,"oc_device":true,"pic":{"0":"ge*6, sfp*2"},"sub_required":"wan1","type":"gateway"}]'
- '[{"alias":"EX4100-48P-CHAS","defaults":{"_ports":"ge-0/0/0-47, et-0/1/0-3, xe-0/2/0-3, ge-0/2/0-3"},"description":"Juniper EX4100 Series","display":"EX4100-48P","evolved_os":false,"evpn_ri_type":"mac-vrf","fans_pluggable":true,"has_bgp":true,"has_ets":true,"has_evpn":true,"has_irb":true,"has_poe_out":true,"model":"EX4100-48P","modular":true,"number_fans":2,"oc_device":true,"oob_interface":"re0:mgmt-0, re1:mgmt-0","pic":{"0":"ge*48","1":"qsfp+*4","2":"sfp+*4 (uplink)"},"sub_required":"string","type":"switch"}]'
contentMediaType: application/json
examples:
Gateway:
value:
- defaults:
ha_control_port: ge-0/0/1
ha_data_ports: ge-0/0/2,ge-3/0/2
ha_fxp0_port: ge-0/0/0
ha_lan_ports: ge-0/0/4,ge-3/0/4
ha_wan_ports: ge-0/0/3,ge-3/0/3
lan_ports: ge-0/0/1-6
lte_wan_ports: cl-1/0/0
wan_ports: ge-0/0/0,ge-0/0/7
description: Juniper SRX320 Series
fans_pluggable: false
ha_node0_fpc: 3
ha_node1_fpc: 3
has_bgp: true
has_fxp0: false
has_ha_control: false
has_ha_data: false
has_irb: true
has_poe_out: true
has_snapshot: true
irb_disabled_by_default: false
model: SRX320
number_fans: 1
oc_device: true
pic:
'0': ge*6, sfp*2
sub_required: wan1
type: gateway
Switch:
value:
- alias: EX4100-48P-CHAS
defaults:
_ports: ge-0/0/0-47, et-0/1/0-3, xe-0/2/0-3, ge-0/2/0-3
description: Juniper EX4100 Series
display: EX4100-48P
evolved_os: false
evpn_ri_type: mac-vrf
fans_pluggable: true
has_bgp: true
has_ets: true
has_evpn: true
has_irb: true
has_poe_out: true
model: EX4100-48P
modular: true
number_fans: 2
oc_device: true
oob_interface: re0:mgmt-0, re1:mgmt-0
pic:
'0': ge*48
'1': qsfp+*4
'2': sfp+*4 (uplink)
sub_required: string
type: switch
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/const_device_model'
description: Device model definitions returned by the constants API
examples:
- '[{"defaults":{"ha_control_port":"ge-0/0/1","ha_data_ports":"ge-0/0/2,ge-3/0/2","ha_fxp0_port":"ge-0/0/0","ha_lan_ports":"ge-0/0/4,ge-3/0/4","ha_wan_ports":"ge-0/0/3,ge-3/0/3","lan_ports":"ge-0/0/1-6","lte_wan_ports":"cl-1/0/0","wan_ports":"ge-0/0/0,ge-0/0/7"},"description":"Juniper SRX320 Series","fans_pluggable":false,"ha_node0_fpc":3,"ha_node1_fpc":3,"has_bgp":true,"has_fxp0":false,"has_ha_control":false,"has_ha_data":false,"has_irb":true,"has_poe_out":true,"has_snapshot":true,"irb_disabled_by_default":false,"model":"SRX320","number_fans":1,"oc_device":true,"pic":{"0":"ge*6, sfp*2"},"sub_required":"wan1","type":"gateway"}]'
- '[{"alias":"EX4100-48P-CHAS","defaults":{"_ports":"ge-0/0/0-47, et-0/1/0-3, xe-0/2/0-3, ge-0/2/0-3"},"description":"Juniper EX4100 Series","display":"EX4100-48P","evolved_os":false,"evpn_ri_type":"mac-vrf","fans_pluggable":true,"has_bgp":true,"has_ets":true,"has_evpn":true,"has_irb":true,"has_poe_out":true,"model":"EX4100-48P","modular":true,"number_fans":2,"oc_device":true,"oob_interface":"re0:mgmt-0, re1:mgmt-0","pic":{"0":"ge*48","1":"qsfp+*4","2":"sfp+*4 (uplink)"},"sub_required":"string","type":"switch"}]'
contentMediaType: application/vnd.api+json
examples:
Gateway:
value:
- defaults:
ha_control_port: ge-0/0/1
ha_data_ports: ge-0/0/2,ge-3/0/2
ha_fxp0_port: ge-0/0/0
ha_lan_ports: ge-0/0/4,ge-3/0/4
ha_wan_ports: ge-0/0/3,ge-3/0/3
lan_ports: ge-0/0/1-6
lte_wan_ports: cl-1/0/0
wan_ports: ge-0/0/0,ge-0/0/7
description: Juniper SRX320 Series
fans_pluggable: false
ha_node0_fpc: 3
ha_node1_fpc: 3
has_bgp: true
has_fxp0: false
has_ha_control: false
has_ha_data: false
has_irb: true
has_poe_out: true
has_snapshot: true
irb_disabled_by_default: false
model: SRX320
number_fans: 1
oc_device: true
pic:
'0': ge*6, sfp*2
sub_required: wan1
type: gateway
Switch:
value:
- alias: EX4100-48P-CHAS
defaults:
_ports: ge-0/0/0-47, et-0/1/0-3, xe-0/2/0-3, ge-0/2/0-3
description: Juniper EX4100 Series
display: EX4100-48P
evolved_os: false
evpn_ri_type: mac-vrf
fans_pluggable: true
has_bgp: true
has_ets: true
has_evpn: true
has_irb: true
has_poe_out: true
model: EX4100-48P
modular: true
number_fans: 2
oc_device: true
oob_interface: re0:mgmt-0, re1:mgmt-0
pic:
'0': ge*48
'1': qsfp+*4
'2': sfp+*4 (uplink)
sub_required: string
type: switch
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/const/mxedge_models:
get:
tags:
- Constants Models
summary: listMxEdgeModels
description: Return Mist Edge models supported by Mist, including their capabilities.
operationId: listMxEdgeModels
parameters: []
responses:
'200':
description: List of MxEdge Models
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/const_mxedge_model'
description: Mist Edge model definitions returned by the constants API
examples:
- - display: X10
model: ME-X10
ports:
'0':
display: xe0
speed: 10000
'1':
display: xe1
speed: 10000
'2':
display: xe2
speed: 10000
'3':
display: xe3
speed: 10000
contentMediaType: application/json
examples:
Example:
value:
- display: X10
model: ME-X10
ports:
'0':
display: xe0
speed: 10000
'1':
display: xe1
speed: 10000
'2':
display: xe2
speed: 10000
'3':
display: xe3
speed: 10000
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/const_mxedge_model'
description: Mist Edge model definitions returned by the constants API
examples:
- - display: X10
model: ME-X10
ports:
'0':
display: xe0
speed: 10000
'1':
display: xe1
speed: 10000
'2':
display: xe2
speed: 10000
'3':
display: xe3
speed: 10000
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- display: X10
model: ME-X10
ports:
'0':
display: xe0
speed: 10000
'1':
display: xe1
speed: 10000
'2':
display: xe2
speed: 10000
'3':
display: xe3
speed: 10000
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/const/otherdevice_models:
get:
tags:
- Constants Models
summary: listSupportedOtherDeviceModels
description: Return supported models for other or third-party devices.
operationId: listSupportedOtherDeviceModels
parameters: []
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/const_other_device_model'
description: Other-device model definitions returned by the constants API
examples:
- - _vendor_model_id: '65'
display: W1850
model: W1850
type: router
vendor: cradlepoint
contentMediaType: application/json
examples:
Example:
value:
- _vendor_model_id: '65'
display: W1850
model: W1850
type: router
vendor: cradlepoint
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/const_other_device_model'
description: Other-device model definitions returned by the constants API
examples:
- - _vendor_model_id: '65'
display: W1850
model: W1850
type: router
vendor: cradlepoint
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- _vendor_model_id: '65'
display: W1850
model: W1850
type: router
vendor: cradlepoint
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/self:
delete:
tags:
- Self Account
summary: deleteSelf
description: >-
To delete ones account and every associated with it. The effects:
the account would be deleted
any orphaned Org (that only has this account as admin) will be deleted
along with all data with Org (sites, wlans, devices) will be gone.
operationId: deleteSelf
parameters: []
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Request
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/error_delete_failed'
- description: Error response returned when an organization delete request is blocked
examples:
- detail: inventory not empty
org_id: 424f6eca-7276-4993-bfeb-53cbbbba6f05
contentMediaType: application/json
examples:
If Any Of The Org To Be Deleted Still Has Inventory:
value:
detail: inventory not empty
org_id: 424f6eca-7276-4993-bfeb-53cbbbba6f05
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/error_delete_failed'
- description: Error response returned when an organization delete request is blocked
examples:
- detail: inventory not empty
org_id: 424f6eca-7276-4993-bfeb-53cbbbba6f05
contentMediaType: application/vnd.api+json
examples:
If Any Of The Org To Be Deleted Still Has Inventory:
value:
detail: inventory not empty
org_id: 424f6eca-7276-4993-bfeb-53cbbbba6f05
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Self Account
summary: getSelf
description: Get ‘whoami’ and privileges (which org and which sites I have access to)
operationId: getSelf
parameters: []
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/admin'
- description: Mist administrator account or organization API token details
examples:
- admin_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
email: user@example.com
first_name: string
last_name: string
password_modified_time: 1656353525
privileges:
- msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
msp_name: string
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
org_name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
role: admin
scope: org
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
contentMediaType: application/json
examples:
Example:
value:
admin_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
email: user@example.com
first_name: string
last_name: string
password_modified_time: 1656353525
privileges:
- msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
msp_name: string
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
org_name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
role: admin
scope: org
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/admin'
- description: Mist administrator account or organization API token details
examples:
- admin_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
email: user@example.com
first_name: string
last_name: string
password_modified_time: 1656353525
privileges:
- msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
msp_name: string
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
org_name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
role: admin
scope: org
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
contentMediaType: application/vnd.api+json
examples:
Example:
value:
admin_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
email: user@example.com
first_name: string
last_name: string
password_modified_time: 1656353525
privileges:
- msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
msp_name: string
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
org_name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
role: admin
scope: org
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Self Account
summary: updateSelf
description: Update Account Information
operationId: updateSelf
parameters: []
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/admin'
- description: Request Body
examples:
- email: john.smith@mycorp.net
first_name: John
last_name: Smith
persona: security
phone: '14081112222'
phone2: '14083334444'
contentMediaType: application/json
examples:
Example:
value:
email: john.smith@mycorp.net
first_name: John
last_name: Smith
persona: security
phone: '14081112222'
phone2: '14083334444'
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/admin'
- description: Mist administrator account or organization API token details
examples:
- admin_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
email: user@example.com
first_name: string
last_name: string
password_modified_time: 1656353525
privileges:
- msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
msp_name: string
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
org_name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
role: admin
scope: org
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
contentMediaType: application/json
examples:
Example:
value:
admin_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
email: user@example.com
first_name: string
last_name: string
password_modified_time: 1656353525
privileges:
- msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
msp_name: string
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
org_name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
role: admin
scope: org
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/admin'
- description: Mist administrator account or organization API token details
examples:
- admin_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
email: user@example.com
first_name: string
last_name: string
password_modified_time: 1656353525
privileges:
- msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
msp_name: string
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
org_name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
role: admin
scope: org
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
contentMediaType: application/vnd.api+json
examples:
Example:
value:
admin_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
email: user@example.com
first_name: string
last_name: string
password_modified_time: 1656353525
privileges:
- msp_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
msp_name: string
name: string
org_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
org_name: string
orggroup_ids:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
role: admin
scope: org
site_id: b069b358-4c97-5319-1f8c-7c5ca64d6ab1
sitegroup_ids:
- 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/self/login_failures:
get:
tags:
- Self Account
summary: getSelfLoginFailures
description: Get a list of failed login attempts across all Orgs for the current admin
operationId: getSelfLoginFailures
parameters: []
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/login_failures'
- description: Failed login attempt summary with source IPs and user agents
examples:
- email: admin@test.com
last_failure_at: 1509161968
num_attempts: 40
src_ips:
- 192.168.1.39
- 192.168.1.38
- 192.168.1.37
user_agents:
- Test UA 39
- Test UA 38
- Test UA 37
contentMediaType: application/json
examples:
Example:
value:
email: admin@test.com
last_failure_at: 1509161968
num_attempts: 40
src_ips:
- 192.168.1.39
- 192.168.1.38
- 192.168.1.37
user_agents:
- Test UA 39
- Test UA 38
- Test UA 37
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/login_failures'
- description: Failed login attempt summary with source IPs and user agents
examples:
- email: admin@test.com
last_failure_at: 1509161968
num_attempts: 40
src_ips:
- 192.168.1.39
- 192.168.1.38
- 192.168.1.37
user_agents:
- Test UA 39
- Test UA 38
- Test UA 37
contentMediaType: application/vnd.api+json
examples:
Example:
value:
email: admin@test.com
last_failure_at: 1509161968
num_attempts: 40
src_ips:
- 192.168.1.39
- 192.168.1.38
- 192.168.1.37
user_agents:
- Test UA 39
- Test UA 38
- Test UA 37
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/self/update:
post:
tags:
- Self Account
summary: updateSelfEmail
description: >-
Change Email
We require the user to verify that they actually own the email address they intend to change it to.
After the API call, the user will receive an email to the new email address with a link like https://manage.mist.com/verify/update?expire=:exp_time&email=:admin_email&token=:token
Upon clicking the link, the user is provided with a login page to authenticate using existing credentials. After successful login, the email address of the user gets updated
**Note**: The request parameter email can be used by UI to validate that the current session (if any) belongs to the admin or provide a login page (by pre-populating the email on login screen). UI can also use the request parameter expire to validate token expiry.
operationId: updateSelfEmail
parameters: []
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/email_string'
- description: Request Body
examples:
- email: new@mistsys.com
contentMediaType: application/json
examples:
Example:
value:
email: new@mistsys.com
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Invalid email address or new email address already exists
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_detail_string'
- description: Response containing a human-readable detail message
examples:
- '{}'
- '{"detail":"email already existed"}'
contentMediaType: application/json
examples:
Invalid Email Address:
value: {}
New Email Address Already Exists:
value:
detail: email already existed
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_detail_string'
- description: Response containing a human-readable detail message
examples:
- '{}'
- '{"detail":"email already existed"}'
contentMediaType: application/vnd.api+json
examples:
Invalid Email Address:
value: {}
New Email Address Already Exists:
value:
detail: email already existed
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/self/update/verify/{token}:
get:
tags:
- Self Account
summary: verifySelfEmail
description: Verify Email change
operationId: verifySelfEmail
parameters:
- name: token
in: path
description: ''
required: true
schema:
type: string
responses:
'200':
description: With correct verification, the email address of the user will be updated
headers: {}
content: {}
'400':
description: Bad Request
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_detail_string'
- description: Response containing a human-readable detail message
examples:
- '{"detail":"invalid token"}'
- '{"detail":"email already existed"}'
- '{"detail":"invalid token"}'
contentMediaType: application/json
examples:
Invalid Or Expired Token:
value:
detail: invalid token
New Email Address Already Exists:
value:
detail: email already existed
Request Comes From Authenticated Users Other Than Admin:
value:
detail: invalid token
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_detail_string'
- description: Response containing a human-readable detail message
examples:
- '{"detail":"invalid token"}'
- '{"detail":"email already existed"}'
- '{"detail":"invalid token"}'
contentMediaType: application/vnd.api+json
examples:
Invalid Or Expired Token:
value:
detail: invalid token
New Email Address Already Exists:
value:
detail: email already existed
Request Comes From Authenticated Users Other Than Admin:
value:
detail: invalid token
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/self/usage:
get:
tags:
- Self Account
summary: getSelfApiUsage
description: Get the status of the API usage for the current user or API Token
operationId: getSelfApiUsage
parameters: []
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/api_usage'
- description: API rate-limit usage status for the current user or API token
examples:
- request_limit: 5000
requests: 5
contentMediaType: application/json
examples:
Example:
value:
request_limit: 5000
requests: 5
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/api_usage'
- description: API rate-limit usage status for the current user or API token
examples:
- request_limit: 5000
requests: 5
contentMediaType: application/vnd.api+json
examples:
Example:
value:
request_limit: 5000
requests: 5
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/self/apitokens:
get:
tags:
- Self API Token
summary: listApiTokens
description: Get List of Current User API Tokens
operationId: listApiTokens
parameters: []
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/user_apitoken'
description: List of user API tokens
examples:
- - created_time: 1626875902
id: 864f351a-1377-4ad9-83f8-72f3fe6199ba
key: 1qkb...QQCL
last_used: 1690115110
name: org_token_xyz
contentMediaType: application/json
examples:
Example:
value:
- created_time: 1626875902
id: 864f351a-1377-4ad9-83f8-72f3fe6199ba
key: 1qkb...QQCL
last_used: 1690115110
name: org_token_xyz
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/user_apitoken'
description: List of user API tokens
examples:
- - created_time: 1626875902
id: 864f351a-1377-4ad9-83f8-72f3fe6199ba
key: 1qkb...QQCL
last_used: 1690115110
name: org_token_xyz
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- created_time: 1626875902
id: 864f351a-1377-4ad9-83f8-72f3fe6199ba
key: 1qkb...QQCL
last_used: 1690115110
name: org_token_xyz
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Self API Token
summary: createApiToken
description: >-
Create API Token
Note that the key is only available during creation time.
operationId: createApiToken
parameters: []
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/user_apitoken'
- examples:
- name: org_token_xyz
contentMediaType: application/json
examples:
Example:
value:
name: org_token_xyz
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/user_apitoken'
description: List of user API tokens
examples:
- - created_time: 1626875902
id: 864f351a-1377-4ad9-83f8-72f3fe6199ba
key: 1qkb...QQCL
last_used: 1690115110
name: org_token_xyz
contentMediaType: application/json
examples:
Example:
value:
- created_time: 1626875902
id: 864f351a-1377-4ad9-83f8-72f3fe6199ba
key: 1qkb...QQCL
last_used: 1690115110
name: org_token_xyz
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/user_apitoken'
description: List of user API tokens
examples:
- - created_time: 1626875902
id: 864f351a-1377-4ad9-83f8-72f3fe6199ba
key: 1qkb...QQCL
last_used: 1690115110
name: org_token_xyz
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- created_time: 1626875902
id: 864f351a-1377-4ad9-83f8-72f3fe6199ba
key: 1qkb...QQCL
last_used: 1690115110
name: org_token_xyz
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/self/apitokens/{apitoken_id}:
delete:
tags:
- Self API Token
summary: deleteApiToken
description: Delete an API Token
operationId: deleteApiToken
parameters:
- name: apitoken_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Self API Token
summary: getApiToken
description: Get User API Token
operationId: getApiToken
parameters:
- name: apitoken_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/user_apitoken'
- description: User API token metadata
examples:
- created_time: 1626875902
id: 864f351a-1377-4ad9-83f8-72f3fe6199ba
key: 1qkb...QQCL
last_used: 1690115110
name: org_token_xyz
contentMediaType: application/json
examples:
Example:
value:
created_time: 1626875902
id: 864f351a-1377-4ad9-83f8-72f3fe6199ba
key: 1qkb...QQCL
last_used: 1690115110
name: org_token_xyz
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/user_apitoken'
- description: User API token metadata
examples:
- created_time: 1626875902
id: 864f351a-1377-4ad9-83f8-72f3fe6199ba
key: 1qkb...QQCL
last_used: 1690115110
name: org_token_xyz
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 1626875902
id: 864f351a-1377-4ad9-83f8-72f3fe6199ba
key: 1qkb...QQCL
last_used: 1690115110
name: org_token_xyz
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Self API Token
summary: updateApiToken
description: Update User API Token
operationId: updateApiToken
parameters:
- name: apitoken_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/user_apitoken'
- examples:
- name: org_token_xyz
contentMediaType: application/json
examples:
Example:
value:
name: org_token_xyz
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/user_apitoken'
- description: User API token metadata
examples:
- created_time: 1626875902
id: 864f351a-1377-4ad9-83f8-72f3fe6199ba
key: 1qkb...QQCL
last_used: 1690115110
name: org_token_xyz
contentMediaType: application/json
examples:
Example:
value:
created_time: 1626875902
id: 864f351a-1377-4ad9-83f8-72f3fe6199ba
key: 1qkb...QQCL
last_used: 1690115110
name: org_token_xyz
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/user_apitoken'
- description: User API token metadata
examples:
- created_time: 1626875902
id: 864f351a-1377-4ad9-83f8-72f3fe6199ba
key: 1qkb...QQCL
last_used: 1690115110
name: org_token_xyz
contentMediaType: application/vnd.api+json
examples:
Example:
value:
created_time: 1626875902
id: 864f351a-1377-4ad9-83f8-72f3fe6199ba
key: 1qkb...QQCL
last_used: 1690115110
name: org_token_xyz
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/self/oauth/{provider}:
get:
tags:
- Self OAuth2
summary: getOauth2UrlForLinking
description: Obtain Authorization URL for Linking
operationId: getOauth2UrlForLinking
parameters:
- name: provider
in: path
description: ''
required: true
schema:
type: string
- name: forward
in: query
description: Callback URL to forward to after the OAuth login flow
style: form
explode: true
schema:
type: string
examples:
- https://manage.mist.com/oauth/callback.html
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_self_oauth_url'
- description: OAuth2 authorization URL response for linking the current Mist account
examples:
- authorization_url: https://accounts.google.com/o/oauth2/v2/auth?.....
linked: false
contentMediaType: application/json
examples:
Example:
value:
authorization_url: https://accounts.google.com/o/oauth2/v2/auth?.....
linked: false
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_self_oauth_url'
- description: OAuth2 authorization URL response for linking the current Mist account
examples:
- authorization_url: https://accounts.google.com/o/oauth2/v2/auth?.....
linked: false
contentMediaType: application/vnd.api+json
examples:
Example:
value:
authorization_url: https://accounts.google.com/o/oauth2/v2/auth?.....
linked: false
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Self OAuth2
summary: linkOauth2MistAccount
description: Link Mist account with an OAuth2 Provider
operationId: linkOauth2MistAccount
parameters:
- name: provider
in: path
description: ''
required: true
schema:
type: string
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/code_string'
- description: Request Body
examples:
- code: 4/S9tegDeLkrYg0L9pWNXV4cgMVbbr3SR9t693A2kSHzw
contentMediaType: application/json
examples:
Example:
value:
code: 4/S9tegDeLkrYg0L9pWNXV4cgMVbbr3SR9t693A2kSHzw
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_self_oauth_link_success'
- description: OAuth2 account-linking success response
examples:
- action: oauth account linked
id: google_user_id
contentMediaType: application/json
examples:
Example:
value:
action: oauth account linked
id: google_user_id
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_self_oauth_link_success'
- description: OAuth2 account-linking success response
examples:
- action: oauth account linked
id: google_user_id
contentMediaType: application/vnd.api+json
examples:
Example:
value:
action: oauth account linked
id: google_user_id
'400':
description: Authorization Error
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_self_oauth_link_failure'
- description: OAuth2 account-linking failure response
examples:
- error: access_denied
error_description: The resource owner or authorization server denied the request.
contentMediaType: application/json
examples:
Example:
value:
error: access_denied
error_description: The resource owner or authorization server denied the request.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_self_oauth_link_failure'
- description: OAuth2 account-linking failure response
examples:
- error: access_denied
error_description: The resource owner or authorization server denied the request.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
error: access_denied
error_description: The resource owner or authorization server denied the request.
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/self/two_factor/token:
get:
tags:
- Self MFA
summary: generateSecretFor2faVerification
description: Generate Secret Key for 2FA verification
operationId: generateSecretFor2faVerification
parameters:
- name: by
in: query
description: 'Secret response format. If `by`==`qrcode`, returns the secret as a QR code image. enum: `qrcode`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/mfa_secret_type'
- description: 'Secret response format. If `by`==`qrcode`, returns the secret as a QR code image. enum: `qrcode`'
responses:
'200':
description: Two Factor configuration Token
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_two_factor_json'
- description: Response body containing a generated two-factor authentication secret
examples:
- two_factor_secret: NRMTSTRWNBVECY3GJVYEY3DDJFRGSNCZGJUDO4RVN5FDM3DUMJSA
contentMediaType: application/json
examples:
Example:
value:
two_factor_secret: NRMTSTRWNBVECY3GJVYEY3DDJFRGSNCZGJUDO4RVN5FDM3DUMJSA
application/octet-stream:
schema:
type: string
description: If `by`==`qrcode`, returns the secret as a qrcode image
contentEncoding: base64
contentMediaType: application/octet-stream
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_two_factor_json'
- description: Response body containing a generated two-factor authentication secret
examples:
- two_factor_secret: NRMTSTRWNBVECY3GJVYEY3DDJFRGSNCZGJUDO4RVN5FDM3DUMJSA
contentMediaType: application/vnd.api+json
examples:
Example:
value:
two_factor_secret: NRMTSTRWNBVECY3GJVYEY3DDJFRGSNCZGJUDO4RVN5FDM3DUMJSA
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/self/two_factor/verify:
post:
tags:
- Self MFA
summary: verifyTwoFactor
description: >
Verify Two-factor (OTP)
To verify two-factor authentication by using a code generated by app (e.g. Google Authenticator, Authy). Upon successful verification, the `two_factor_passed` will be set to true if it hasn’t already been.
operationId: verifyTwoFactor
parameters: []
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/two_factor_code'
- description: Request Body
contentMediaType: application/json
required: false
responses:
'200':
description: Response when 2FA verification is successful
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/self/subscriptions:
get:
tags:
- Self Alarms
summary: listAlarmSubscriptions
description: Get List of all the subscriptions
operationId: listAlarmSubscriptions
parameters: []
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/response_self_subscription'
description: Subscription records visible to the current account
contentMediaType: application/json
application/vnd.api+json:
schema:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/response_self_subscription'
description: Subscription records visible to the current account
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/self/logs:
get:
tags:
- Self Audit Logs
summary: listSelfAuditLogs
description: >-
Get List of change logs across all Orgs for current admin
Audit logs records all administrative activities done by current admin across all orgs
operationId: listSelfAuditLogs
parameters:
- name: message
in: query
description: Filter results by message text
style: form
explode: true
schema:
type: string
examples:
- Created a new site
- name: sort
in: query
description: 'Field used to sort results; a leading `-` indicates descending order. enum: `-timestamp`, `admin_id`, `site_id`, `timestamp`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/list_org_logs_sort'
- description: 'Field used to sort results; a leading `-` indicates descending order. enum: `-timestamp`, `admin_id`, `site_id`, `timestamp`'
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_self_audit_logs'
- description: Paginated response for audit logs for the current admin across organizations
examples:
- end: 1428954000
limit: 100
page: 1
results:
- admin_id: 72bfa2bd-e58a-4670-9d20-a1468f7a6f58
admin_name: test@mistsys.com
after:
auth:
type: open
before:
auth:
type: psk
id: c6f9347b-b0a4-4a23-b927-fa9249f2ffb2
message: Update WLAN "Corporate"
org_id: 423f6eca-6276-4994-bfeb-53cbbbba6f04
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
timestamp: 1431382121
start: 1428939600
total: 135
contentMediaType: application/json
examples:
Example:
value:
end: 1428954000
limit: 100
page: 1
results:
- admin_id: 72bfa2bd-e58a-4670-9d20-a1468f7a6f58
admin_name: test@mistsys.com
after:
auth:
type: open
before:
auth:
type: psk
id: c6f9347b-b0a4-4a23-b927-fa9249f2ffb2
message: Update WLAN "Corporate"
org_id: 423f6eca-6276-4994-bfeb-53cbbbba6f04
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
timestamp: 1431382121
start: 1428939600
total: 135
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_self_audit_logs'
- description: Paginated response for audit logs for the current admin across organizations
examples:
- end: 1428954000
limit: 100
page: 1
results:
- admin_id: 72bfa2bd-e58a-4670-9d20-a1468f7a6f58
admin_name: test@mistsys.com
after:
auth:
type: open
before:
auth:
type: psk
id: c6f9347b-b0a4-4a23-b927-fa9249f2ffb2
message: Update WLAN "Corporate"
org_id: 423f6eca-6276-4994-bfeb-53cbbbba6f04
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
timestamp: 1431382121
start: 1428939600
total: 135
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 1428954000
limit: 100
page: 1
results:
- admin_id: 72bfa2bd-e58a-4670-9d20-a1468f7a6f58
admin_name: test@mistsys.com
after:
auth:
type: open
before:
auth:
type: psk
id: c6f9347b-b0a4-4a23-b927-fa9249f2ffb2
message: Update WLAN "Corporate"
org_id: 423f6eca-6276-4994-bfeb-53cbbbba6f04
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
timestamp: 1431382121
start: 1428939600
total: 135
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/restart:
post:
tags:
- Utilities Common
summary: restartSiteMultipleDevices
description: Note that only the devices that are connected will be restarted.
operationId: restartSiteMultipleDevices
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/utils_devices_restart_multi'
- description: Request Body
examples:
- '{"device_ids":["00000000-0000-0000-1000-5c5b35584a6f","00000000-0000-0000-1000-5c5b350ea3b3"]}'
- '{"device_ids":["421f6eca-6276-4893-bfeb-53cbbbba6f02"],"node":"node0"}'
contentMediaType: application/json
examples:
Example:
value:
device_ids:
- 00000000-0000-0000-1000-5c5b35584a6f
- 00000000-0000-0000-1000-5c5b350ea3b3
Example2:
value:
device_ids:
- 421f6eca-6276-4893-bfeb-53cbbbba6f02
node: node0
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/arp:
post:
tags:
- Utilities Common
summary: arpFromDevice
description: "ARP can be performed on the Device. The output will be available through websocket. As there can be multiple commands issued against the same AP at the same time and the output all goes through the same websocket stream, session is introduced for demux.\n\n\n#### Subscribe to Device Command outputs\n`WS /api-ws/v1/stream`\n\n```json\n{\n \"subscribe\": \"/sites/{site_id}/devices/{device_id}/cmd\"\n}\n```\n##### Example output from ws stream\n```json\n{ \n \"event\": \"data\", \n \"channel\": \"/sites/4ac1dcf4-9d8b-7211-65c4-057819f0862b/devices/00000000-0000-0000-1000-5c5b350e0060/cmd\", \n \"data\": { \n \"session\": \"session_id\", \n \"raw\": \n \"Output\": \"\\tMAC\\t\\tDEV\\tVLAN\\tRx Packets\\t\\t Rx Bytes\\t\\tTx Packets\\t\\t Tx Bytes\\tFlows\\tIdle sec\\n-----------------------------------------------------------------------------------------------------------------------\"\n } \n}\n```"
operationId: arpFromDevice
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ha_cluster_node'
- examples:
- node: node0
contentMediaType: application/json
examples:
Example:
value:
node: node0
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session'
- description: Response containing the WebSocket session handle for asynchronous command output
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session'
- description: Response containing the WebSocket session handle for asynchronous command output
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/bounce_port:
post:
tags:
- Utilities Common
summary: bounceDevicePort
description: >-
Port Bounce can be performed from Switch/Gateway.
**Note:** Ports starting with vme, ae, irb, and HA control ports (for SSR only) are not supported
The output will be available through websocket. As there can be multiple commands issued against the same AP at the same time and the output all goes through the same websocket stream, session is introduced for demux.
#### Subscribe to Device Command outputs
`WS /api-ws/v1/stream`
```json
{
"subscribe": "/sites/{site_id}/devices/{device_id}/cmd"
}
```
##### Example output from ws stream
```json
{
"event": "data",
"channel": "/sites/4ac1dcf4-9d8b-7211-65c4-057819f0862b/devices/00000000-0000-0000-1000-5c5b350e0060/cmd",
"data": {
"session": "session_id",
"raw": "Port bounce complete."
}
}
```
operationId: bounceDevicePort
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/utils_bounce_port'
- description: Request Body
examples:
- ports:
- ge-0/0/0
- ge-0/0/1
contentMediaType: application/json
examples:
Example:
value:
ports:
- ge-0/0/0
- ge-0/0/1
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/clear_mac_table:
post:
tags:
- Utilities Common
summary: clearSiteDeviceMacTable
description: >
Clear MAC Table from the Device.
The output will be available through websocket. As there can be multiple commands issued against the same device at the same time and the output all goes through the same websocket stream, `session` is introduced for demux.
#### Subscribe to Device Command outputs
`WS /api-ws/v1/stream`
```json
{
"subscribe": "/sites/{site_id}/devices/{device_id}/cmd"
}
```
operationId: clearSiteDeviceMacTable
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: All attributes are optional
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/utils_mac_table'
- description: All attributes are optional
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session'
- description: Response containing the WebSocket session handle for asynchronous command output
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session'
- description: Response containing the WebSocket session handle for asynchronous command output
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/clear_policy_hit_count:
post:
tags:
- Utilities Common
summary: clearSiteDevicePolicyHitCount
description: Clear application policy hit counts for the specified policy.
operationId: clearSiteDevicePolicyHitCount
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/clear_policy_hit_count'
- examples:
- policy_name: http
contentMediaType: application/json
examples:
Example:
value:
policy_name: http
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session_with_url'
- description: Response containing a WebSocket session handle and connection URL
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session_with_url'
- description: Response containing a WebSocket session handle and connection URL
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/config_cmd:
get:
tags:
- Utilities Common
summary: getSiteDeviceConfigCmd
description: >-
Get Config CLI Commands
For a brown-field switch deployment where we adopted the switch through Adoption Command, we do not wipe out / overwrite the existing config automatically. Instead, we generate CLI commands that we would have generated. The user can inspect, modify, and incorporate this into their existing config manually.
Once they feel comfortable about the config we generate, they can enable allow_mist_config where we will take full control of their config like a claimed switch
operationId: getSiteDeviceConfigCmd
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: sort
in: query
description: Make output cmds sorted (for better readability) or not.
style: form
explode: true
schema:
type: boolean
default: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_device_config_cli'
- description: Device configuration rendered as CLI commands
examples:
- cli:
- set system hostname corp-a135
contentMediaType: application/json
examples:
Example:
value:
cli:
- set system hostname corp-a135
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_device_config_cli'
- description: Device configuration rendered as CLI commands
examples:
- cli:
- set system hostname corp-a135
contentMediaType: application/vnd.api+json
examples:
Example:
value:
cli:
- set system hostname corp-a135
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/locate:
post:
tags:
- Utilities Common
summary: startSiteLocateDevice
description: "### Access Points\nLocate an Access Point by blinking it's LED.\nIt is a persisted state that has to be stopped by calling Stop Locating API\n\n### Switches\nLocate a Switch by blinking all port LEDs. \nBy default, request is sent to `master` switch and LEDs will keep flashing for 5 minutes.\nIn case of virtual chassis (VC) the desired member mac has to be passed in the request payload. \nAt anypoint, only one VC member can be requested to flash the LED. \nTo stop LED flashing before the duration ends /unlocate API request can be made. \nIf /unlocate API is not called LED will continue to flash on device for the given duration. \nDefault duration is 5 minutes and 120 minutes is the maximum."
operationId: startSiteLocateDevice
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/locate_switch'
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/monitor_traffic:
post:
tags:
- Utilities Common
summary: monitorSiteDeviceTraffic
description: >-
Monitor traffic on switches and SRX.
* JUNOS uses cmd "monitor interface " to monitor traffic on particular
* JUNOS uses cmd "monitor interface traffic" to monitor traffic on all ports
operationId: monitorSiteDeviceTraffic
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/utils_monitor_traffic'
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session_with_url'
- description: Response containing a WebSocket session handle and connection URL
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session_with_url'
- description: Response containing a WebSocket session handle and connection URL
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/ping:
post:
tags:
- Utilities Common
summary: pingFromDevice
description: >-
Ping from AP, Switch and SSR
Ping can be performed from the Device. The output will be available through websocket. As there can be multiple commands issued against the same AP at the same time and the output all goes through the same websocket stream, session is introduced for demux.
#### Subscribe to Device Command outputs
`WS /api-ws/v1/stream`
```json
{
"subscribe": "/sites/{site_id}/devices/{device_id}/cmd"
}
```
##### Example output from ws stream
```json
{
"event": "data",
"channel": "/sites/4ac1dcf4-9d8b-7211-65c4-057819f0862b/devices/00000000-0000-0000-1000-5c5b350e0060/cmd",
"data": {
"session": "session_id",
"raw": "64 bytes from 23.211.0.110: seq=8 ttl=58 time=12.323 ms\n"
}
}
```
operationId: pingFromDevice
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/utils_ping'
- description: Request Body
examples:
- count: 10
host: 1.1.1.1
contentMediaType: application/json
examples:
Example:
value:
count: 10
host: 1.1.1.1
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session'
- description: Response containing the WebSocket session handle for asynchronous command output
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session'
- description: Response containing the WebSocket session handle for asynchronous command output
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/readopt:
post:
tags:
- Utilities Common
summary: readoptSiteOctermDevice
description: For the octerm devices, the device ID must come from fpc0. However, for a VC, the users may change the original fpc0 from CLI. To fix the issue, the readopt API could be used to trigger the readopt process so the device would get the correct device ID to connect the cloud.
operationId: readoptSiteOctermDevice
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/release_dhcp_leases:
post:
tags:
- Utilities Common
summary: releaseSiteDeviceDhcpLease
description: Releases an active DHCP lease.
operationId: releaseSiteDeviceDhcpLease
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/utils_release_dhcp_leases'
- examples:
- port_id: ge-0/0/1.10
contentMediaType: application/json
examples:
Example:
value:
port_id: ge-0/0/1.10
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Parameter `port ` absent
headers: {}
content: {}
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/reprovision:
post:
tags:
- Utilities Common
summary: reprovisionSiteOctermDevice
description: To force one device to reprovision itself again.
operationId: reprovisionSiteOctermDevice
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/request_ztp_password:
post:
tags:
- Utilities Common
summary: getSiteDeviceZtpPassword
description: In the case where something happens during/after ZTP, the root-password is modified (required for ZTP to set up outbound-ssh) but the user-defined password config has not be configured. This API can be used to retrieve the temporary password.
operationId: getSiteDeviceZtpPassword
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/root_password_string'
- description: Temporary root password response for device ZTP recovery
examples:
- root_password: ef8070ef8f924edb592e1819ed64b31172ab8de9d5cde75d3f46acd9506202ab9b1cbb97e381c5aa11037f17e5ed7b4b609461cd813d944670549d410ef82f2e
contentMediaType: application/json
examples:
Example:
value:
root_password: ef8070ef8f924edb592e1819ed64b31172ab8de9d5cde75d3f46acd9506202ab9b1cbb97e381c5aa11037f17e5ed7b4b609461cd813d944670549d410ef82f2e
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/restart:
post:
tags:
- Utilities Common
summary: restartSiteDevice
description: Restart / Reboot a device
operationId: restartSiteDevice
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/utils_devices_restart'
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/shell:
post:
tags:
- Utilities Common
summary: createSiteDeviceShellSession
description: Create Shell Session
operationId: createSiteDeviceShellSession
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/shell_node'
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session_with_url'
- description: Response containing a WebSocket session handle and connection URL
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session_with_url'
- description: Response containing a WebSocket session handle and connection URL
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/show_bgp_summary:
post:
tags:
- Utilities Common
summary: showSiteDeviceBgpSummary
description: >-
Get BGP Summary from SSR, SRX and Switch.
The output will be available through websocket. As there can be multiple commands issued against the same device at the same time and the output all goes through the same websocket stream, `session` is introduced for demux.
#### Subscribe to Device Command outputs
`WS /api-ws/v1/stream`
```json
{
"subscribe": "/sites/{site_id}/devices/{device_id}/cmd"
}
```
##### Example output from ws stream
```
Tue 2024-04-23 16:36:06 UTC
Retrieving bgp entries...
BGP table version is 354, local router ID is 10.224.8.16, vrf id 0
Default local pref 100, local AS 65000
Status codes: s suppressed, d damped, h history, * valid, > best, = multipath,
i internal, r RIB_failure, S Stale, R Removed
Nexthop codes: @NNN nexthop's vrf id, < announce-nh-self
Origin codes: i - IGP, e - EGP, ? - incomplete
RPKI validation codes: V valid, I invalid, N Not found
Network Next Hop Metric LocPrf Weight Path
*> 161.161.161.0/24
```"
operationId: showSiteDeviceBgpSummary
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: All attributes are optional
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/utils_show_bgp_summary'
- description: All attributes are optional
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session'
- description: Response containing the WebSocket session handle for asynchronous command output
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session'
- description: Response containing the WebSocket session handle for asynchronous command output
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/show_dhcp_leases:
post:
tags:
- Utilities Common
summary: showSiteDeviceDhcpLeases
description: Shows DHCP leases
operationId: showSiteDeviceDhcpLeases
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/utils_show_dhcp_leases'
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session'
- description: Response containing the WebSocket session handle for asynchronous command output
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session'
- description: Response containing the WebSocket session handle for asynchronous command output
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/show_dot1x:
post:
tags:
- Utilities Common
summary: showSiteDeviceDot1xTable
description: >
Get Dot1X Table from the Device.
The output will be available through websocket. As there can be multiple commands issued against the same device at the same time and the output all goes through the same websocket stream, `session` is introduced for demux.
#### Subscribe to Device Command outputs
`WS /api-ws/v1/stream`
```json
{
"subscribe": "/sites/{site_id}/devices/{device_id}/cmd"
}
```
operationId: showSiteDeviceDot1xTable
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: All attributes are optional
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/utils_show_dot1x'
- description: All attributes are optional
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session'
- description: Response containing the WebSocket session handle for asynchronous command output
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session'
- description: Response containing the WebSocket session handle for asynchronous command output
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/show_evpn_database:
post:
tags:
- Utilities Common
summary: showSiteDeviceEvpnDatabase
description: Get EVPN Database from the Device. The output will be available through websocket.
operationId: showSiteDeviceEvpnDatabase
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: All attributes are optional
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/utils_show_evpn_database'
- description: All attributes are optional
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session'
- description: Response containing the WebSocket session handle for asynchronous command output
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session'
- description: Response containing the WebSocket session handle for asynchronous command output
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/show_forwarding_table:
post:
tags:
- Utilities Common
summary: showSiteDeviceForwardingTable
description: >
Get forwarding table from the Device. The output will be available through websocket. As there can be multiple commands issued against the same device at the same time and the output all goes through the same websocket stream, `session` is introduced for demux.
#### Subscribe to Device Command outputs
`WS /api-ws/v1/stream`
```json
{
"subscribe": "/sites/{site_id}/devices/{device_id}/cmd"
}
```
##### Example output from ws stream
```
Mon 2024-05-20 16:47:30 UTC Retrieving fib entries… Entry Count: 3268 Capacity: 22668 ==================== ====== ======= ================== ===== ====================== =========== =========== ====== IP Prefix Port Proto Tenant VRF Service Next Hops Vector Cost ==================== ====== ======= ================== ===== ====================== =========== =========== ====== 0.0.0.0/0 0 None Old_Mgmt - internet-wan_and_lte 1-2.0 broadband 1 1-4.0 lte 10 branch1-Kiosk - internet-wan_and_lte 1-2.0 broadband 1 1-4.0 lte 10 branch1-MGT - internet-wan_and_lte 1-2.0 broadband 1 1-4.0 lte 10 3.1.1.0/24 0 None Old_Mgmt - internet-wan_and_lte 1-2.0 broadband 1 1-4.0 lte 10 branch1-Kiosk - internet-wan_and_lte 1-2.0 broadband 1 1-4.0 lte 10 branch1-MGT - internet-wan_and_lte 1-2.0 broadband 1 1-4.0 lte 10
```
operationId: showSiteDeviceForwardingTable
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: All attributes are optional
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/utils_show_forwarding_table'
- description: All attributes are optional
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session'
- description: Response containing the WebSocket session handle for asynchronous command output
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session'
- description: Response containing the WebSocket session handle for asynchronous command output
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/show_mac_table:
post:
tags:
- Utilities Common
summary: showSiteDeviceMacTable
description: "Get MAC Table from the Device.\n\nThe output will be available through websocket. As there can be multiple commands issued against the same device at the same time and the output all goes through the same websocket stream, `session` is introduced for demux.\n\n\n\n#### Subscribe to Device Command outputs\n\n`WS /api-ws/v1/stream`\n\n```json\n{\n \"subscribe\": \"/sites/{site_id}/devices/{device_id}/cmd\"\n```\n\n\n#### Example output from ws stream\n\n```json \n{\n \"event\": \"data\",\n \"channel\": \"/sites/d6fb4f96-xxxx-xxxx-xxxx-a8d7b85087ac/devices/00000000-0000-0000-1000-209339xxxxxx/cmd\",\n \"data\": \"{\\\"event\\\": \\\"data\\\", \\\"channel\\\": \\\"/sites/d6fb4f96-xxxx-xxxx-xxxx-a8d7b85087ac/devices/209339xxxxxx/cmd\\\", \\\"data\\\": {\\\"session\\\": \\\"eec2b6e4-1e63-4f9f-9cf8-ef7f9632861e\\\", \\\"raw\\\": \\\"\\\\nMAC flags (S - static MAC, D - dynamic MAC, L - locally learned, P - Persistent static, C - Control MAC\\\\n SE - statistics enabled, NM - non configured MAC, R - remote PE MAC, O - ovsdb MAC\\\\n GBP - group based policy, B - Blocked MAC)\\\\n\\\\n\\\\nE\\\"}}\"\n}\n{\n \"event\": \"data\",\n \"channel\": \"/sites/d6fb4f96-xxxx-xxxx-xxxx-a8d7b85087ac/devices/00000000-0000-0000-1000-209339xxxxxx/cmd\",\n \"data\": \"{\\\"event\\\": \\\"data\\\", \\\"channel\\\": \\\"/sites/d6fb4f96-xxxx-xxxx-xxxx-a8d7b85087ac/devices/209339xxxxxx/cmd\\\", \\\"data\\\": {\\\"session\\\": \\\"eec2b6e4-1e63-4f9f-9cf8-ef7f9632861e\\\", \\\"raw\\\": \\\"thernet switching table : 59 entries, 59 learned\\\\nRouting instance : default-switch\\\\n Vlan MAC MAC Age GBP Logical NH MAC RTR\\\\n name address flags \\\"}}\"\n}\n{\n \"event\": \"data\",\n \"channel\": \"/sites/d6fb4f96-xxxx-xxxx-xxxx-a8d7b85087ac/devices/00000000-0000-0000-1000-209339xxxxxx/cmd\",\n \"data\": \"{\\\"event\\\": \\\"data\\\", \\\"channel\\\": \\\"/sites/d6fb4f96-xxxx-xxxx-xxxx-a8d7b85087ac/devices/209339xxxxxx/cmd\\\", \\\"data\\\": {\\\"session\\\": \\\"eec2b6e4-1e63-4f9f-9cf8-ef7f9632861e\\\", \\\"raw\\\": \\\" Tag interface Index property ID\\\\n corp 00:50:56:87:4f:69 D - xe-0/1/3.0 0 0 \\\\n corp 00:50:56:87:ce:f5 D - x\\\"}}\"\n}\n{\n \"event\": \"data\",\n \"channel\": \"/sites/d6fb4f96-xxxx-xxxx-xxxx-a8d7b85087ac/devices/00000000-0000-0000-1000-209339xxxxxx/cmd\",\n \"data\": \"{\\\"event\\\": \\\"data\\\", \\\"channel\\\": \\\"/sites/d6fb4f96-xxxx-xxxx-xxxx-a8d7b85087ac/devices/209339xxxxxx/cmd\\\", \\\"data\\\": {\\\"session\\\": \\\"eec2b6e4-1e63-4f9f-9cf8-ef7f9632861e\\\", \\\"raw\\\": \\\"e-0/1/3.0 0 0 \\\\n corp 20:93:39:0f:62:00 D - xe-0/1/3.0 0 0 \\\\n ifo 00:50:56:87:2d:42 D - xe-0/1/3.0 \\\"}}\"\n}\n...\n```"
operationId: showSiteDeviceMacTable
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: All attributes are optional
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/utils_mac_table'
- description: All attributes are optional
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session'
- description: Response containing the WebSocket session handle for asynchronous command output
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session'
- description: Response containing the WebSocket session handle for asynchronous command output
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/support:
post:
tags:
- Utilities Common
summary: uploadSiteDeviceSupportFile
description: >-
Support / Upload device support files
#### Info Param
| Name | Type | Description |
| --- | --- | --- |
| process | string | Upload 1 file with output of show system processes extensive |
| outbound-ssh | string | Upload 1 file that concatenates all /var/log/outbound-ssh.log* files |
| messages | string | Upload 1 to 10 /var/log/messages* files |
| core-dumps | string | Upload all core dump files, if any. Uploads for all members of VC on switches.|
| full | string | Upload 1 file with output of request support information, 1 file that concatenates all /var/log/outbound-ssh.log files, all core dump files, the 3 most recent /var/log/messages files, and Mist agent logs (for Junos devices running the Mist agent) |
| var-logs | string | Upload all non-empty files in the /var/log/ directory |
| jma-logs | string | Upload Mist agent logs (for Junos devices running the Mist agent only) |
"
operationId: uploadSiteDeviceSupportFile
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/utils_send_support_logs'
- description: Request Body
examples:
- info: full
contentMediaType: application/json
examples:
Example:
value:
info: full
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Device not online
headers: {}
content: {}
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/traceroute:
post:
tags:
- Utilities Common
summary: tracerouteFromDevice
description: >-
Traceroute can be performed from the Device.
The output will be available through websocket. As there can be multiple commands issued against the same Device at the same time and the output all goes through the same websocket stream, session is introduced for demux.
#### Subscribe to Device Command outputs
`WS /api-ws/v1/stream`
```json
{
"subscribe": "/sites/{site_id}/devices/{device_id}/cmd"
}
```
#### Example output from ws stream
```json
{
"channel": "/sites/d6fb4f96-xxxx-xxxx-xxxx-xxxxxxxxxxxx/devices/00000000-0000-0000-1000-xxxxxxxxxxxx/cmd",
"event": "data",
"data": {
"session": "9106e908-74dc-4a4f-9050-9c2adcaf44a5",
"raw": "Running traceroute...\ntraceroute to 8.8.8.8, 64 hops max\n 0 192.168.1.1 1 ms 192.168.1.1 1 ms 192.168.1.1 1 ms\n 1 80.10.236.81 2 ms 80.10.236.81 4 ms 80.10.236.81 2 ms\n 2 193.253.80.250 3 ms 193.253.80.250 2 ms 193.253.80.250 2 ms\n 3 193.252.159.41 2 ms 193.252.159.41 1 ms 193.252.159.41 3 ms\n"
}
```
operationId: tracerouteFromDevice
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/utils_traceroute'
- description: Request Body
examples:
- host: string
port: 33434
protocol: udp
contentMediaType: application/json
examples:
Example:
value:
host: string
port: 33434
protocol: udp
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session'
- description: Response containing the WebSocket session handle for asynchronous command output
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session'
- description: Response containing the WebSocket session handle for asynchronous command output
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/unlocate:
post:
tags:
- Utilities Common
summary: stopSiteLocateDevice
description: Stop Locate a Device
operationId: stopSiteLocateDevice
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/clear_arp:
post:
tags:
- Utilities WAN
summary: clearSiteSsrArpCache
description: >-
Clear ARP cache for SSR, SRX and Switch
Clear the entire ARP cache or a subset if arguments are provided.
*Note*: port_id is optional if neither vlan nor ip is specified
operationId: clearSiteSsrArpCache
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/utils_clear_arp'
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session'
- description: Response containing the WebSocket session handle for asynchronous command output
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session'
- description: Response containing the WebSocket session handle for asynchronous command output
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/clear_bgp:
post:
tags:
- Utilities WAN
summary: clearSiteSsrBgpRoutes
description: Clear routes associated with one or all BGP neighbors
operationId: clearSiteSsrBgpRoutes
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/utils_clear_bgp'
- examples:
- neighbor: all
type: in
vrf: TestVrf
contentMediaType: application/json
examples:
Example:
value:
neighbor: all
type: in
vrf: TestVrf
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session'
- description: Response containing the WebSocket session handle for asynchronous command output
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session'
- description: Response containing the WebSocket session handle for asynchronous command output
contentMediaType: application/vnd.api+json
'400':
description: Parameter neighbor absent
headers: {}
content: {}
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/clear_session:
post:
tags:
- Utilities WAN
summary: clearSiteDeviceSession
description: Clear session
operationId: clearSiteDeviceSession
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/utils_clear_session'
- examples:
- port_id: ge-0/0/1.10
contentMediaType: application/json
examples:
Example:
value:
port_id: ge-0/0/1.10
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/release_dhcp:
post:
tags:
- Utilities WAN
summary: releaseSiteSsrDhcpLease
description: >-
Releases an active DHCP lease.
The output will be available through websocket.
As there can be multiple commands issued against the same Device at the same
time and the output all goes through the same websocket stream, session is
introduced for demux.
#### Subscribe to Device Command outputs
`WS /api-ws/v1/stream`
```json
{ "subscribe": "/sites/{site_id}/devices/{device_id}/cmd" }
```
#### Example output from ws stream
```json
{
"event": "data",
"channel": "/sites/d6fb4f96-3ba4-4cf5-8af2-a8d7b85087ac/devices/00000000-0000-0000-1000-0200010edbca/cmd",
"data": "{\"event\": \"data\", \"channel\": \"/sites/d6fb4f96-xxxx-xxxx-xxxx-a8d7b85087ac/devices/0200010edbca/cmd\",\"data\": {\"session\": \"356b2150-7307-4165-8411-52794c1ee8b0\",\"raw\": \"Releasing dhcp...\"}}"
}
{
"event": "data",
"channel": "/sites/d6fb4f96-3ba4-4cf5-8af2-a8d7b85087ac/devices/00000000-0000-0000-1000-0200010edbca/cmd",
"data": "{\"event\": \"data\", \"channel\": \"/sites/d6fb4f96-xxxx-xxxx-xxxx-a8d7b85087ac/devices/0200010edbca/cmd\",\"data\": {\"session\": \"356b2150-7307-4165-8411-52794c1ee8b0\",\"raw\": \"Successfully released DHCP lease.\"}}"
}
```
operationId: releaseSiteSsrDhcpLease
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/utils_release_dhcp'
- examples:
- port_id: ge-0/0/1.10
contentMediaType: application/json
examples:
Example:
value:
port_id: ge-0/0/1.10
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session'
- description: Response containing the WebSocket session handle for asynchronous command output
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session'
- description: Response containing the WebSocket session handle for asynchronous command output
contentMediaType: application/vnd.api+json
'400':
description: Parameter `port ` absent
headers: {}
content: {}
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/resolve_dns:
post:
tags:
- Utilities WAN
summary: testSiteSsrDnsResolution
description: "DNS resolutions are performed on the Device.\n\nThe output will be available through websocket. As there can be multiple commands issued against the same SSR at the same time and the output all goes through the same websocket stream, `session` is used for demux.\n \n #### Subscribe to Device Command outputs\n`WS /api-ws/v1/stream`\n\n```json\n{\n \"subscribe\": \"/sites/{site_id}/devices/{device_id}/cmd\"\n}\n```\n##### Example output from ws stream\n```\n Router | Hostname | Resolved | Last Resolved | Expiration\n-------------|------------------------|----------|----------------------|---------------------\n test-device | xxx.yyy.net | Y | 2022-03-28T03:56:49Z | 2022-03-28T03:57:49Z\n```"
operationId: testSiteSsrDnsResolution
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session'
- description: Response containing the WebSocket session handle for asynchronous command output
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session'
- description: Response containing the WebSocket session handle for asynchronous command output
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/run_top:
post:
tags:
- Utilities WAN
summary: runSiteSrxTopCommand
description: "Run top command on switches and SRX. The output will be available through websocket. \n\nAs there can be multiple commands issued against the same device at the same time and the output all goes through the same websocket stream, `session` is introduced for demux.\n\n#### Subscribe to Device Command outputs\n`WS /api-ws/v1/stream`\n\n```json\n{\n \"subscribe\": \"/sites/{site_id}/devices/{device_id}/cmd\"\n}\n```"
operationId: runSiteSrxTopCommand
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session_with_url'
- description: Response containing a WebSocket session handle and connection URL
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session_with_url'
- description: Response containing a WebSocket session handle and connection URL
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/service_ping:
post:
tags:
- Utilities WAN
summary: servicePingFromSsr
description: >-
Ping from SSR
Service Ping can be performed from the Device. The output will be available through websocket. As there can be multiple command issued against the same device at the same time and the output all goes through the same websocket stream, session is introduced for demux.
#### Subscribe to Device Command outputs
`WS /api-ws/v1/stream`
```json
{
"subscribe": "/sites/{site_id}/devices/{device_id}/cmd"
}
```
##### Example output from ws stream
```json
{
"event": "data",
"channel": "/sites/4ac1dcf4-9d8b-7211-65c4-057819f0862b/devices/00000000-0000-0000-1000-5c5b350e0060/cmd",
"data": {
"session": "session_id",
"raw": "64 bytes from 23.211.0.110: seq=8 ttl=58 time=12.323 ms\n"
}
}
```
operationId: servicePingFromSsr
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/utils_service_ping'
- description: Request Body
examples:
- count: 10
host: 1.1.1.1
service: web-session
contentMediaType: application/json
examples:
Example:
value:
count: 10
host: 1.1.1.1
service: web-session
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session'
- description: Response containing the WebSocket session handle for asynchronous command output
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session'
- description: Response containing the WebSocket session handle for asynchronous command output
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/show_ospf_database:
post:
tags:
- Utilities WAN
summary: showSiteGatewayOspfDatabase
description: "Get OSPF Database from SSR and SRX. The output will be available through websocket. \n\nAs there can be multiple commands issued against the same device at the same time and the output all goes through the same websocket stream, `session` is introduced for demux.\n\n#### Subscribe to Device Command outputs\n`WS /api-ws/v1/stream`\n\n```json\n{\n \"subscribe\": \"/sites/{site_id}/devices/{device_id}/cmd\"\n}\n```\n\n#### Example output from ws stream\n```\n===== ==================== ========== ======= ======== ================ =================== =================\nVrf Neighbor Router ID Priority State Uptime Dead Timer Due Interface Address Interface State\n===== ==================== ========== ======= ======== ================ =================== =================\n 1.0.0.3 1 Full 852 38 172.16.3.2 Backup\n 1.0.0.4 1 Full 811 33 172.16.3.2 DROther\n 1.0.0.3 1 Full 852 38 172.16.4.2 Backup\n 1.0.0.4 1 Full 811 34 172.16.4.2 DROther\n```"
operationId: showSiteGatewayOspfDatabase
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: All attributes are optional
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/utils_show_ospf_database'
- description: All attributes are optional
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session'
- description: Response containing the WebSocket session handle for asynchronous command output
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session'
- description: Response containing the WebSocket session handle for asynchronous command output
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/show_ospf_interfaces:
post:
tags:
- Utilities WAN
summary: showSiteGatewayOspfInterfaces
description: "Get OSPF interfaces from SSR and SRX. The output will be available through websocket. \n\nAs there can be multiple commands issued against the same device at the same time and the output all goes through the same websocket stream, `session` is introduced for demux.\n\n#### Subscribe to Device Command outputs\n`WS /api-ws/v1/stream`\n\n```json\n{\n \"subscribe\": \"/sites/{site_id}/devices/{device_id}/cmd\"\n}\n```\n\n#### Example output from ws stream\n```\n===== ================== =================== ============== =============== =========== ========= ===========\nVrf Device Interface Network Interface Interface Up IP address OSPF Type Area ID Area Type\n===== ================== =================== ============== =============== =========== ========= ===========\n net1 g1 True 172.16.1.2/24 Broadcast 0.0.0.0 default\n net3 g3 True 172.16.3.2/24 Broadcast 0.0.0.0 default\n net4 g4 True 172.16.4.2/24 Broadcast 0.0.0.4 default\n```"
operationId: showSiteGatewayOspfInterfaces
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: All attributes are optional
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/utils_show_ospf_interfaces'
- description: All attributes are optional
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session'
- description: Response containing the WebSocket session handle for asynchronous command output
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session'
- description: Response containing the WebSocket session handle for asynchronous command output
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/show_ospf_neighbors:
post:
tags:
- Utilities WAN
summary: showSiteGatewayOspfNeighbors
description: "Get OSPF Neighbors from SSR and SRX. The output will be available through websocket. \n\nAs there can be multiple commands issued against the same device at the same time and the output all goes through the same websocket stream, `session` is introduced for demux.\n\n#### Subscribe to Device Command outputs\n`WS /api-ws/v1/stream`\n\n```json\n{\n \"subscribe\": \"/sites/{site_id}/devices/{device_id}/cmd\"\n}\n```\n\n#### Example output from ws stream\n```\n===== ==================== ========== ======= ======== ================ =================== =================\nVrf Neighbor Router ID Priority State Uptime Dead Timer Due Interface Address Interface State\n===== ==================== ========== ======= ======== ================ =================== =================\n 1.0.0.3 1 Full 852 38 172.16.3.2 Backup\n 1.0.0.4 1 Full 811 33 172.16.3.2 DROther\n 1.0.0.3 1 Full 852 38 172.16.4.2 Backup\n 1.0.0.4 1 Full 811 34 172.16.4.2 DROther\n```"
operationId: showSiteGatewayOspfNeighbors
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: All attributes are optional
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/utils_show_ospf_neighbors'
- description: All attributes are optional
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session'
- description: Response containing the WebSocket session handle for asynchronous command output
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session'
- description: Response containing the WebSocket session handle for asynchronous command output
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/show_ospf_summary:
post:
tags:
- Utilities WAN
summary: showSiteGatewayOspfSummary
description: "Get OSPF summary from SSR and SRX. The output will be available through websocket. \n\nAs there can be multiple commands issued against the same device at the same time and the output all goes through the same websocket stream, `session` is introduced for demux.\n\n#### Subscribe to Device Command outputs\n`WS /api-ws/v1/stream`\n\n```json\n{\n \"subscribe\": \"/sites/{site_id}/devices/{device_id}/cmd\"\n}\n```\n\n#### Example output from ws stream\n```\n===== =========== ========== ============= ==================== ========= =========== =============\nVrf Router ID ABR Type ASBR Router External LSA Count Area ID Area Type Area Border\n Router\n===== =========== ========== ============= ==================== ========= =========== =============\n 1.0.0.2 cisco False 0 0.0.0.0\n 1.0.0.2 cisco False 0 0.0.0.4 default\n```"
operationId: showSiteGatewayOspfSummary
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: All attributes are optional
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/utils_show_ospf_summary'
- description: All attributes are optional
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session'
- description: Response containing the WebSocket session handle for asynchronous command output
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session'
- description: Response containing the WebSocket session handle for asynchronous command output
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/show_route:
post:
tags:
- Utilities WAN
summary: showSiteSsrAndSrxRoutes
description: "Get routes from SSR, SRX and Switch. \n\nThe output will be available through websocket. As there can be multiple commands issued against the same device at the same time and the output all goes through the same websocket stream, `session` is introduced for demux.\n\n#### Subscribe to Device Command outputs\n`WS /api-ws/v1/stream`\n\n```json\n{\n \"subscribe\": \"/sites/{site_id}/devices/{device_id}/cmd\"\n}\n```\n##### Example output from ws stream\n```\nadmin@labsystem1.fiedler# show bgp neighbors\nBGP neighbor is 192.168.4.1, remote AS 4200000001, local AS 4200000128, external\nlink\n BGP version 4, remote router ID 1.1.1.1\n BGP state = Established, up for 00:27:25\n Last read 00:00:25, hold time is 90, keepalive interval is 30 seconds\n Configured hold time is 90, keepalive interval is 30 seconds\n Neighbor capabilities:\n 4 Byte AS: advertised and received\n Route refresh: advertised and received(old & new)\n Address family IPv4 Unicast: advertised and received\n Graceful Restart Capability: advertised and received\n Remote Restart timer is 120 seconds\n Address families by peer:\n none\n ...\n```"
operationId: showSiteSsrAndSrxRoutes
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: All attributes are optional
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/utils_show_route'
- description: All attributes are optional
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session'
- description: Response containing the WebSocket session handle for asynchronous command output
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session'
- description: Response containing the WebSocket session handle for asynchronous command output
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/show_service_path:
post:
tags:
- Utilities WAN
summary: showSiteSsrServicePath
description: >-
Get service path information of the Device.
The output will be available through websocket. As there can be multiple command
issued against the same device at the same time and the output all goes through
the same websocket stream, session is introduced for demux.
#### Subscribe to Device Command outputs
`WS /api-ws/v1/stream`
```json
{ "subscribe": "/sites/{site_id}/devices/{device_id}/cmd" }
```
#### Example output from ws stream
```json
{
"channel": "/sites/d6fb4f96-xxxx-xxxx-xxxx-xxxxxxxxxxxx/devices/00000000-0000-0000-1000-xxxxxxxxxxxx/cmd",
"event": "data",
"data": {
"session": "5cb8a6db-d11a-42cd-bed7-19e9f29e637",
"raw": "{\"status\":\"SUCCESS\",\"finished\":true,\"rows\":[{\"service\":\"management\",\"type\":\"service-agent\",\"network_interface\":\"ge-0/0/0\",\"destination\":\"\",\"gateway_ip\":\"192.168.1.1\",\"vector\":\"\",\"cost\":0,\"rate\":0,\"state\":\"Up\",\"capacity\":\"0/unlimited\",\"meetsSLA\":\"Yes\"},{\"service\":\"management\",\"type\":\"service-agent\",\"network_interface\":\"ge-0/0/1\",\"destination\":\"\",\"gateway_ip\":\"192.168.0.1\",\"vector\":\"\",\"cost\":0,\"rate\":0,\"state\":\"Up\",\"capacity\":\"0/unlimited\",\"meetsSLA\":\"Yes\"}]}"
}
}
```
operationId: showSiteSsrServicePath
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/utils_show_service_path'
- examples:
- node: node0
service_name: any
contentMediaType: application/json
examples:
Example:
value:
node: node0
service_name: any
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session'
- description: Response containing the WebSocket session handle for asynchronous command output
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session'
- description: Response containing the WebSocket session handle for asynchronous command output
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/show_session:
post:
tags:
- Utilities WAN
summary: showSiteSsrAndSrxSessions
description: "Get active sessions passing through the Device.\n\n\nThe output will be available through websocket. As there can be multiple command\nissued against the same device at the same time and the output all goes through\nthe same websocket stream, session is introduced for demux.\n\n\n\n#### Subscribe to Device Command outputs\n\n`WS /api-ws/v1/stream`\n\n\n```json \n{ \"subscribe\": \"/sites/{site_id}/devices/{device_id}/cmd\" }\n```\n\n\n#### Example output from ws stream\n\n```json \n{\n \"channel\": \"/sites/d6fb4f96-xxxx-xxxx-xxxx-xxxxxxxxxxxx/devices/00000000-0000-0000-1000-xxxxxxxxxxxx/cmd\",\n \"event\": \"data\",\n \"data\": {\n \"session\": \"f517bf29-1141-41ae-a084-17cacb0ccb57\",\n \"raw\": \"{\\\"status\\\":\\\"SUCCESS\\\",\\\"finished\\\":true,\\\"rows\\\":[{\\\"session_id\\\":\\\"a04b1cc7-dcc1-40a6-a010-0fe46ca38551\\\",\\\"direction\\\":\\\"forward\\\",\\\"service\\\":\\\"internet\\\",\\\"tenant\\\":\\\"SRV.PRD-Core\\\",\\\"device_interface\\\":\\\"ge-0/0/3\\\",\\\"network_interface\\\":\\\"ge-0/0/3.100\\\",\\\"protocol\\\":\\\"TCP\\\",\\\"source_ip\\\":\\\"10.3.20.101\\\",\\\"source_port\\\":45733,\\\"destination_ip\\\":\\\"13.38.46.35\\\",\\\"destination_port\\\":443,\\\"nat_ip\\\":\\\"192.168.1.115\\\",\\\"nat_port\\\":45256,\\\"payload_encrypted\\\":false,\\\"timeout\\\":1581,\\\"uptime\\\":319},{\\\"session_id\\\":\\\"a04b1cc7-dcc1-40a6-a010-0fe46ca38551\\\",\\\"direction\\\":\\\"reverse\\\",\\\"service\\\":\\\"internet\\\",\\\"tenant\\\":\\\"SRV.PRD-Core\\\",\\\"device_interface\\\":\\\"ge-0/0/0\\\",\\\"network_interface\\\":\\\"ge-0/0/0\\\",\\\"protocol\\\":\\\"TCP\\\",\\\"source_ip\\\":\\\"13.38.46.35\\\",\\\"source_port\\\":443,\\\"destination_ip\\\":\\\"192.168.1.115\\\",\\\"destination_port\\\":45256,\\\"nat_ip\\\":\\\"0.0.0.0\\\",\\\"nat_port\\\":0,\\\"payload_encrypted\\\":false,\\\"timeout\\\":1581,\\\"uptime\\\":319}]}\\n\"\n }\n}\n```"
operationId: showSiteSsrAndSrxSessions
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/utils_show_session'
- examples:
- node: node0
service_name: any
contentMediaType: application/json
examples:
Example:
value:
node: node0
service_name: any
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session'
- description: Response containing the WebSocket session handle for asynchronous command output
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session'
- description: Response containing the WebSocket session handle for asynchronous command output
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/wired_clients/{client_mac}/coa:
post:
tags:
- Utilities LAN
summary: reauthOrgDot1xWiredClient
description: Trigger a CoA (change of authorization) against a Wired client
operationId: reauthOrgDot1xWiredClient
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: client_mac
in: path
description: ''
required: true
schema:
pattern: ^[0-9a-fA-F]{12}$
type: string
examples:
- 0000000000ab
responses:
'200':
description: Reauth Wired Client
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_wired_coa'
- description: Response returned after triggering wired client CoA reauthentication
examples:
- device_mac: 5c5b35000002
port_id: ge-0/0/0
session: 0a2a11b8-4b30-40d8-a6d1-e91ea540d86f
contentMediaType: application/json
examples:
Example:
value:
device_mac: 5c5b35000002
port_id: ge-0/0/0
session: 0a2a11b8-4b30-40d8-a6d1-e91ea540d86f
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_wired_coa'
- description: Response returned after triggering wired client CoA reauthentication
examples:
- device_mac: 5c5b35000002
port_id: ge-0/0/0
session: 0a2a11b8-4b30-40d8-a6d1-e91ea540d86f
contentMediaType: application/vnd.api+json
examples:
Example:
value:
device_mac: 5c5b35000002
port_id: ge-0/0/0
session: 0a2a11b8-4b30-40d8-a6d1-e91ea540d86f
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/clear_pending_version:
post:
tags:
- Utilities LAN
summary: clearSiteMultipleDevicePendingVersion
description: Clear device pending fw version (Available on Junos OS EX2300-, EX3400-, EX4000-, EX4100-, EX4400- devices)
operationId: clearSiteMultipleDevicePendingVersion
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/devices_ids'
- description: Request Body
examples:
- device_ids:
- 00000000-0000-0000-1000-5c5b35584a6f
- 00000000-0000-0000-1000-5c5b350ea3b3
contentMediaType: application/json
examples:
Example:
value:
device_ids:
- 00000000-0000-0000-1000-5c5b35584a6f
- 00000000-0000-0000-1000-5c5b350ea3b3
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Request
headers: {}
content:
application/json:
schema:
type: string
examples:
- cannot clear pending version on an offline device
- clear-pending-fw-version not supported
contentMediaType: application/json
examples:
cannot-clear-pending-version-on-an-offline-device:
value: cannot clear pending version on an offline device
clear-pending-version-not-supported:
value: clear-pending-fw-version not supported
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/restore_backup_version:
post:
tags:
- Utilities LAN
summary: restoreSiteMultipleDeviceBackupVersion
description: Restore device backup fw version (Available on Junos OS EX4000-, EX4100-, EX4400- devices)
operationId: restoreSiteMultipleDeviceBackupVersion
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/devices_ids'
- description: Request Body
examples:
- device_ids:
- 00000000-0000-0000-1000-5c5b35584a6f
- 00000000-0000-0000-1000-5c5b350ea3b3
contentMediaType: application/json
examples:
Example:
value:
device_ids:
- 00000000-0000-0000-1000-5c5b35584a6f
- 00000000-0000-0000-1000-5c5b350ea3b3
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Request
headers: {}
content:
application/json:
schema:
type: string
examples:
- snapshot not supported
- cannot snapshot an offline device
contentMediaType: application/json
examples:
cannot-restore-backup-version-on-an-offline-device:
value: snapshot not supported
restore-backup-fw-version-not-supported:
value: cannot snapshot an offline device
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/upgrade_bios:
post:
tags:
- Utilities LAN
summary: upgradeSiteDevicesBios
description: Upgrade Bios on Multiple Device
operationId: upgradeSiteDevicesBios
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/upgrade_bios_multi'
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/upgrade_fpga:
post:
tags:
- Utilities LAN
summary: upgradeSiteDevicesFpga
description: Upgrade Bios on Multiple Device
operationId: upgradeSiteDevicesFpga
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/upgrade_fpga_multi'
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/cable_test:
post:
tags:
- Utilities LAN
summary: cableTestFromSwitch
description: >-
TDR can be performed from the Switch. The output will be available through websocket. As there can be multiple commands issued against the same Switch at the same time and the output all goes through the same websocket stream, session is introduced for demux.
#### Subscribe to Device Command outputs
`WS /api-ws/v1/stream`
```json
{
"subscribe": "/sites/{site_id}/devices/{device_id}/cmd"
}
```
##### Example output from ws stream
```json
{
"event": "data",
"channel": "/sites/4ac1dcf4-9d8b-7211-65c4-057819f0862b/devices/00000000-0000-0000-1000-5c5b350e0060/cmd",
"data": {
"session": "session_id",
"raw": "Interface TDR detail:\nTest status : Test successfully executed ge-0/0/0\n"
}
}
```
operationId: cableTestFromSwitch
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/utils_cable_tests'
- examples:
- port: ge-0/0/0
contentMediaType: application/json
examples:
Example:
value:
port: ge-0/0/0
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session'
- description: Response containing the WebSocket session handle for asynchronous command output
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session'
- description: Response containing the WebSocket session handle for asynchronous command output
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/clear_bpdu_error:
post:
tags:
- Utilities LAN
summary: clearBpduErrorsFromPortsOnSwitch
description: Clear bridge protocol data unit (BPDU) error condition caused by the detection of a possible bridging loop from Spanning Tree Protocol (STP) operation that renders the port unoperational.
operationId: clearBpduErrorsFromPortsOnSwitch
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/utils_clear_bpdu'
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Ports not specified
headers: {}
content: {}
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/clear_dot1x:
post:
tags:
- Utilities LAN
summary: clearSiteDeviceDot1xSession
description: Clear Dot1x Session. The output will be available through websocket.
operationId: clearSiteDeviceDot1xSession
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/clear_dot1x_session'
- description: Request Body
examples:
- ports:
- ge-0/0/0
contentMediaType: application/json
examples:
Example:
value:
ports:
- ge-0/0/0
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session'
- description: Response containing the WebSocket session handle for asynchronous command output
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session'
- description: Response containing the WebSocket session handle for asynchronous command output
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/clear_macs:
post:
tags:
- Utilities LAN
summary: clearAllLearnedMacsFromPortOnSwitch
description: Clear all learned MAC addresses, including persistent MAC addresses, on a port.
operationId: clearAllLearnedMacsFromPortOnSwitch
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/utils_clear_macs'
- examples:
- ports:
- ge-0/0/0.0
contentMediaType: application/json
examples:
Example:
value:
ports:
- ge-0/0/0.0
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/clear_pending_version:
post:
tags:
- Utilities LAN
summary: clearSiteDevicePendingVersion
description: Clear device pending fw version (Available on Junos OS EX2300-, EX3400-, EX4000-, EX4100-, EX4400- devices)
operationId: clearSiteDevicePendingVersion
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Request
headers: {}
content:
application/json:
schema:
type: string
examples:
- cannot clear pending version on an offline device
- clear-pending-fw-version not supported
contentMediaType: application/json
examples:
cannot-clear-pending-version-on-an-offline-device:
value: cannot clear pending version on an offline device
clear-pending-version-not-supported:
value: clear-pending-fw-version not supported
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/flow_records/search:
get:
tags:
- Utilities LAN
summary: searchSiteDeviceFlowRecords
description: >-
Search network flow records for a specific device within a site.
Note: Only supported for switch devices. The device must be manageable. The `device_mac` is automatically scoped to the device in the URL path and cannot be overridden by query parameter.
operationId: searchSiteDeviceFlowRecords
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: sort
in: query
description: On which field the list should be sorted, -prefix represents DESC order
style: form
explode: true
schema:
type: string
default: timestamp
examples:
- -site_id
- name: src_ip
in: query
description: Source IP address
style: form
explode: true
schema:
type: string
- name: dst_ip
in: query
description: Destination IP address
style: form
explode: true
schema:
type: string
- name: src_port
in: query
description: Source port
style: form
explode: true
schema:
type: string
- name: dst_port
in: query
description: Destination port
style: form
explode: true
schema:
type: string
- name: protocol
in: query
description: Protocol (e.g. `tcp`, `udp`, `icmp`)
style: form
explode: true
schema:
type: string
- name: state
in: query
description: Flow state
style: form
explode: true
schema:
type: string
- name: direction
in: query
description: Flow direction
style: form
explode: true
schema:
type: string
- name: search_after
in: query
description: Pagination cursor for retrieving subsequent pages of results. This value is automatically populated by Mist in the `next` URL from the previous response and should not be manually constructed.
style: form
explode: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_device_flow_records_search'
- description: Paginated response for device flow record search results
examples:
- end: 1775003600
limit: 1000
results:
- device_mac: 5c5b350e020a
direction: ingress
dst_ip: 8.8.8.8
dst_port: 443
duration: 60
end_time: 1775000060
flow_id: 12345
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
protocol: tcp
sampling_percentage: 0.1
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
src_ip: 10.0.0.1
src_port: 54321
start_time: 1775000000
state: aged-out
timestamp: 1775000060
total_bytes: 150000
total_pkts: 100
start: 1775000000
total: 1
contentMediaType: application/json
examples:
Example:
value:
end: 1775003600
limit: 1000
results:
- device_mac: 5c5b350e020a
direction: ingress
dst_ip: 8.8.8.8
dst_port: 443
duration: 60
end_time: 1775000060
flow_id: 12345
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
protocol: tcp
sampling_percentage: 0.1
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
src_ip: 10.0.0.1
src_port: 54321
start_time: 1775000000
state: aged-out
timestamp: 1775000060
total_bytes: 150000
total_pkts: 100
start: 1775000000
total: 1
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_device_flow_records_search'
- description: Paginated response for device flow record search results
examples:
- end: 1775003600
limit: 1000
results:
- device_mac: 5c5b350e020a
direction: ingress
dst_ip: 8.8.8.8
dst_port: 443
duration: 60
end_time: 1775000060
flow_id: 12345
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
protocol: tcp
sampling_percentage: 0.1
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
src_ip: 10.0.0.1
src_port: 54321
start_time: 1775000000
state: aged-out
timestamp: 1775000060
total_bytes: 150000
total_pkts: 100
start: 1775000000
total: 1
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 1775003600
limit: 1000
results:
- device_mac: 5c5b350e020a
direction: ingress
dst_ip: 8.8.8.8
dst_port: 443
duration: 60
end_time: 1775000060
flow_id: 12345
org_id: 2818e386-8dec-2562-9ede-5b8a0fbbdc71
protocol: tcp
sampling_percentage: 0.1
site_id: 4ac1dcf4-9d8b-7211-65c4-057819f0862b
src_ip: 10.0.0.1
src_port: 54321
start_time: 1775000000
state: aged-out
timestamp: 1775000060
total_bytes: 150000
total_pkts: 100
start: 1775000000
total: 1
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/poll_stats:
post:
tags:
- Utilities LAN
summary: pollSiteSwitchStats
description: This API can be used to poll statistics from the Switch proactively once. After it is called, the statistics will be pushed back to the cloud within the statistics interval.
operationId: pollSiteSwitchStats
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/restore_backup_version:
post:
tags:
- Utilities LAN
summary: restoreSiteDeviceBackupVersion
description: Restore device backup fw version (Available on Junos OS EX4000-, EX4100-, EX4400- devices)
operationId: restoreSiteDeviceBackupVersion
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Request
headers: {}
content:
application/json:
schema:
type: string
examples:
- cannot restore backup version on an offline device
- restore-backup-fw-version not supported
contentMediaType: application/json
examples:
cannot-restore-backup-version-on-an-offline-device:
value: cannot restore backup version on an offline device
restore-backup-fw-version-not-supported:
value: restore-backup-fw-version not supported
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/show_arp:
post:
tags:
- Utilities LAN
summary: showSiteDeviceArpTable
description: >
Get ARP Table from the Device.
The output will be available through websocket. As there can be multiple commands issued against the same device at the same time and the output all goes through the same websocket stream, `session` is introduced for demux.
#### Subscribe to Device Command outputs
`WS /api-ws/v1/stream`
```json
{
"subscribe": "/sites/{site_id}/devices/{device_id}/cmd"
}
```
operationId: showSiteDeviceArpTable
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: All attributes are optional
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/utils_show_arp'
- description: All attributes are optional
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session'
- description: Response containing the WebSocket session handle for asynchronous command output
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/websocket_session'
- description: Response containing the WebSocket session handle for asynchronous command output
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/snapshot:
post:
tags:
- Utilities LAN
summary: createSiteDeviceSnapshot
description: Create recovery device snapshot (Available on Junos OS EX2300-, EX3400-, EX4400- devices)
operationId: createSiteDeviceSnapshot
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Request
headers: {}
content:
application/json:
schema:
type: string
examples:
- cannot snapshot an offline device
- snapshot not supported
contentMediaType: application/json
examples:
cannot-snapshot-an-offline-device:
value: cannot snapshot an offline device
snapshot-not-supported:
value: snapshot not supported
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/upgrade_bios:
post:
tags:
- Utilities LAN
summary: upgradeDeviceBios
description: Upgrade device bios
operationId: upgradeDeviceBios
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/upgrade_bios'
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_device_bios_upgrade'
- description: Device BIOS upgrade status response
examples:
- status: inprogress
timestamp: 1428949501
contentMediaType: application/json
examples:
Example:
value:
status: inprogress
timestamp: 1428949501
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_device_bios_upgrade'
- description: Device BIOS upgrade status response
examples:
- status: inprogress
timestamp: 1428949501
contentMediaType: application/vnd.api+json
examples:
Example:
value:
status: inprogress
timestamp: 1428949501
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/upgrade_fpga:
post:
tags:
- Utilities LAN
summary: upgradeDeviceFPGA
description: Upgrade device fpga
operationId: upgradeDeviceFPGA
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/upgrade_fpga'
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_device_bios_upgrade'
- description: Device BIOS upgrade status response
examples:
- status: inprogress
timestamp: 1428949501
contentMediaType: application/json
examples:
Example:
value:
status: inprogress
timestamp: 1428949501
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_device_bios_upgrade'
- description: Device BIOS upgrade status response
examples:
- status: inprogress
timestamp: 1428949501
contentMediaType: application/vnd.api+json
examples:
Example:
value:
status: inprogress
timestamp: 1428949501
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/vc/switch_master:
post:
tags:
- Utilities LAN
summary: toogleSiteDeviceVcRoutingEnginesRole
description: In a pre-provisioned VC, mastership is system-determined. This command allows manual toggling between primary and backup Routing Engines.
operationId: toogleSiteDeviceVcRoutingEnginesRole
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Request
headers: {}
content:
application/json:
schema:
type: string
examples:
- backup routing engine is not present
- The device is not an OC device
- Non-provisioned VC is not supported currently
- VC is currently disconnected
contentMediaType: application/json
examples:
backup-re-not-present:
value: backup routing engine is not present
device-is-not-an-oc-device:
value: The device is not an OC device
non-provisioned-vc-not-supported:
value: Non-provisioned VC is not supported currently
vc-is-currently-disconnected:
value: VC is currently disconnected
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/wired_clients/{client_mac}/coa:
post:
tags:
- Utilities LAN
summary: reauthSiteDot1xWiredClient
description: Trigger a CoA (change of authorization) against a Wired client
operationId: reauthSiteDot1xWiredClient
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: client_mac
in: path
description: ''
required: true
schema:
pattern: ^[0-9a-fA-F]{12}$
type: string
examples:
- 0000000000ab
responses:
'200':
description: Reauth Wired Client
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_wired_coa'
- description: Response returned after triggering wired client CoA reauthentication
examples:
- device_mac: 5c5b35000002
port_id: ge-0/0/0
session: 0a2a11b8-4b30-40d8-a6d1-e91ea540d86f
contentMediaType: application/json
examples:
Example:
value:
device_mac: 5c5b35000002
port_id: ge-0/0/0
session: 0a2a11b8-4b30-40d8-a6d1-e91ea540d86f
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_wired_coa'
- description: Response returned after triggering wired client CoA reauthentication
examples:
- device_mac: 5c5b35000002
port_id: ge-0/0/0
session: 0a2a11b8-4b30-40d8-a6d1-e91ea540d86f
contentMediaType: application/vnd.api+json
examples:
Example:
value:
device_mac: 5c5b35000002
port_id: ge-0/0/0
session: 0a2a11b8-4b30-40d8-a6d1-e91ea540d86f
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/clients/{client_mac}/coa:
post:
tags:
- Utilities Wi-Fi
summary: reauthOrgDot1xWirelessClient
description: Trigger a CoA (change of authorization) against a client
operationId: reauthOrgDot1xWirelessClient
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: client_mac
in: path
description: ''
required: true
schema:
pattern: ^[0-9a-fA-F]{12}$
type: string
examples:
- 0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/clients/disconnect:
post:
tags:
- Utilities Wi-Fi
summary: disconnectSiteMultipleClients
description: To unauthorize multiple clients
operationId: disconnectSiteMultipleClients
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
uniqueItems: true
type: array
items:
type: string
description: Request Body
examples:
- - 5c5b350e0001
- 5c5b350e0003
contentMediaType: application/json
examples:
Example:
value:
- 5c5b350e0001
- 5c5b350e0003
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/clients/unauthorize:
post:
tags:
- Utilities Wi-Fi
summary: unauthorizeSiteMultipleClients
description: This unauthorize clients (if they are guest) and disconnect them. From the guest’s perspective, they will see the splash page again and go through the flow (e.g. Terms of Use) again.
operationId: unauthorizeSiteMultipleClients
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/mac_addresses'
- description: Request Body
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/clients/{client_mac}/coa:
post:
tags:
- Utilities Wi-Fi
summary: reauthSiteDot1xWirelessClient
description: Trigger a CoA (change of authorization) against a Wireless client
operationId: reauthSiteDot1xWirelessClient
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: client_mac
in: path
description: ''
required: true
schema:
pattern: ^[0-9a-fA-F]{12}$
type: string
examples:
- 0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/clients/{client_mac}/disconnect:
post:
tags:
- Utilities Wi-Fi
summary: disconnectSiteWirelessClient
description: This disconnect a client (and it’s likely to connect back)
operationId: disconnectSiteWirelessClient
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: client_mac
in: path
description: ''
required: true
schema:
pattern: ^[0-9a-fA-F]{12}$
type: string
examples:
- 0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/clients/{client_mac}/unauthorize:
post:
tags:
- Utilities Wi-Fi
summary: unauthorizeSiteWirelessClient
description: This unauthorize a client (if it’s a guest) and disconnect it. From the guest’s perspective, s/he will see the splash page again and go through the flow (e.g. Terms of Use) again.
operationId: unauthorizeSiteWirelessClient
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: client_mac
in: path
description: ''
required: true
schema:
pattern: ^[0-9a-fA-F]{12}$
type: string
examples:
- 0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/reprovision:
post:
tags:
- Utilities Wi-Fi
summary: reprovisionSiteAllDevices
description: To force all Devices to reprovision itself again.
operationId: reprovisionSiteAllDevices
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/reset_radio_config:
post:
tags:
- Utilities Wi-Fi
summary: resetSiteAllApsToUseRrm
description: Reset all APs in the Site to use RRM
operationId: resetSiteAllApsToUseRrm
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/utils_reset_radio_config'
- description: Request Body
examples:
- bands:
- '24'
- '5'
- '6'
force: false
contentMediaType: application/json
examples:
Example:
value:
bands:
- '24'
- '5'
- '6'
force: false
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/zeroize:
post:
tags:
- Utilities Wi-Fi
summary: zeroizeSiteFipsAllAps
description: Zeroize all FIPS APs in the Site
operationId: zeroizeSiteFipsAllAps
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/utils_zeroize_fips'
- description: Request Body
examples:
- password: NUKETHESITE
contentMediaType: application/json
examples:
Example:
value:
password: NUKETHESITE
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/rogues/{rogue_bssid}/deauth_clients:
post:
tags:
- Utilities Wi-Fi
summary: deauthSiteWirelessClientsConnectedToARogue
description: Send Deauth frame to clients connected to a Rogue AP
operationId: deauthSiteWirelessClientsConnectedToARogue
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: rogue_bssid
in: path
description: ''
required: true
schema:
pattern: ^[0-9a-fA-F]{12}$
type: string
examples:
- 0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/rrm/optimize:
post:
tags:
- Utilities Wi-Fi
summary: optimizeSiteRrm
description: Optimize Site RRM
operationId: optimizeSiteRrm
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/utils_rrm_optimize'
- description: Request Body
examples:
- bands:
- '24'
- '5'
- '6'
contentMediaType: application/json
examples:
Example:
value:
bands:
- '24'
- '5'
- '6'
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/utils/test_smsglobal:
post:
tags:
- Utilities Wi-Fi
summary: testSiteWlanSmsGlobal
description: >-
Allows validation of Global sms gateway credentials.
In case of success, a text message confirming successful setup should be received. In case of error, smsglobal error message are returned.
operationId: testSiteWlanSmsGlobal
parameters: []
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/test_sms_global'
- examples:
- smsglobal_api_key: '123456'
smsglobal_api_secret: abcdef
smsglobal_sender: '61400000002'
to: '+911122334455'
contentMediaType: application/json
examples:
Example:
value:
smsglobal_api_key: '123456'
smsglobal_api_secret: abcdef
smsglobal_sender: '61400000002'
to: '+911122334455'
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/utils/test_telstra:
post:
tags:
- Utilities Wi-Fi
summary: testSiteWlanTelstraSetup
description: >-
Allows validation of Telstra sms gateway credentials.
In case of success, a text message confirming successful setup should be received. In case of error, telstra error message are returned.
operationId: testSiteWlanTelstraSetup
parameters: []
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/test_telstra'
- examples:
- telstra_client_id: '123456'
telstra_client_secret: abcdef
to: '+911122334455'
contentMediaType: application/json
examples:
Example:
value:
telstra_client_id: '123456'
telstra_client_secret: abcdef
to: '+911122334455'
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/utils/test_twilio:
post:
tags:
- Utilities Wi-Fi
summary: testSiteWlanTwilioSetup
description: >-
Allows validation of twilio setup
In case of success, a text message confirming successful setup should be received. In case of error, twilio error code and message are returned.
operationId: testSiteWlanTwilioSetup
parameters: []
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/test_twilio'
- description: Request Body
examples:
- from: '+185051234567'
to: '+19999999999'
twilio_auth_token: 2135be04736a1a0a314bce432d61721a
twilio_sid: REDACTED_TWILIO_ACCOUNT_SID
contentMediaType: application/json
examples:
Example:
value:
from: '+185051234567'
to: '+19999999999'
twilio_auth_token: 2135be04736a1a0a314bce432d61721a
twilio_sid: REDACTED_TWILIO_ACCOUNT_SID
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/pcaps:
get:
tags:
- Utilities PCAPs
summary: listOrgPacketCaptures
description: List organization packet capture sessions and generated capture files for the selected time range.
operationId: listOrgPacketCaptures
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_pcap_search'
- description: Paginated response for packet capture search results
examples:
- end: 1461089816
limit: 100
next: /api/v1/sites/67970e46-4e12-11e6-9188-0242ac110007/pcaps?start=1461099816&search_after=%5B1694537121217%5D&limit=100&end=1461089816
results:
- ap_macs:
- 5c5b35000010
timestamp: 1461869041
type: new_assoc
url: https://...
- duration: 9999
format: stream
id: 80cec4c9-322c-4712-95ce-6ba47fb54fc0
last_seen: 1693482149.417
mxedges:
- 00000000-0000-0000-1000-001122334455
org_id: 78c11da8-f984-4425-bedb-a7ddd7d0f6da
pcap_url: https://...
site_id: null
termination_reason: default
timestamp: 1693525333.234066
type: mxedge
url: https://...
start: 1461099816
contentMediaType: application/json
examples:
Example:
value:
end: 1461089816
limit: 100
next: /api/v1/sites/67970e46-4e12-11e6-9188-0242ac110007/pcaps?start=1461099816&search_after=%5B1694537121217%5D&limit=100&end=1461089816
results:
- ap_macs:
- 5c5b35000010
timestamp: 1461869041
type: new_assoc
url: https://...
- duration: 9999
format: stream
id: 80cec4c9-322c-4712-95ce-6ba47fb54fc0
last_seen: 1693482149.417
mxedges:
- 00000000-0000-0000-1000-001122334455
org_id: 78c11da8-f984-4425-bedb-a7ddd7d0f6da
pcap_url: https://...
site_id: null
termination_reason: default
timestamp: 1693525333.234066
type: mxedge
url: https://...
start: 1461099816
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_pcap_search'
- description: Paginated response for packet capture search results
examples:
- end: 1461089816
limit: 100
next: /api/v1/sites/67970e46-4e12-11e6-9188-0242ac110007/pcaps?start=1461099816&search_after=%5B1694537121217%5D&limit=100&end=1461089816
results:
- ap_macs:
- 5c5b35000010
timestamp: 1461869041
type: new_assoc
url: https://...
- duration: 9999
format: stream
id: 80cec4c9-322c-4712-95ce-6ba47fb54fc0
last_seen: 1693482149.417
mxedges:
- 00000000-0000-0000-1000-001122334455
org_id: 78c11da8-f984-4425-bedb-a7ddd7d0f6da
pcap_url: https://...
site_id: null
termination_reason: default
timestamp: 1693525333.234066
type: mxedge
url: https://...
start: 1461099816
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 1461089816
limit: 100
next: /api/v1/sites/67970e46-4e12-11e6-9188-0242ac110007/pcaps?start=1461099816&search_after=%5B1694537121217%5D&limit=100&end=1461089816
results:
- ap_macs:
- 5c5b35000010
timestamp: 1461869041
type: new_assoc
url: https://...
- duration: 9999
format: stream
id: 80cec4c9-322c-4712-95ce-6ba47fb54fc0
last_seen: 1693482149.417
mxedges:
- 00000000-0000-0000-1000-001122334455
org_id: 78c11da8-f984-4425-bedb-a7ddd7d0f6da
pcap_url: https://...
site_id: null
termination_reason: default
timestamp: 1693525333.234066
type: mxedge
url: https://...
start: 1461099816
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/pcaps/capture:
delete:
tags:
- Utilities PCAPs
summary: stopOrgPacketCapture
description: Stop the currently running organization packet capture and end its websocket output stream.
operationId: stopOrgPacketCapture
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Utilities PCAPs
summary: getOrgCapturingStatus
description: Retrieve the current organization packet capture status, including active capture targets and progress.
operationId: getOrgCapturingStatus
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_pcap_status'
- description: Current status of a packet capture session
examples:
- aps:
- 5c5b350e001c
- 5c5b350e001b
client_mac: 60a10a773412
duration: 300
failed: []
id: a9a84e13-a714-b1eb-152f-a434416217d5
includes_mcast: false
max_pkt_len: 128
num_packets: 1000
ok:
- 5c5b350e001c
- 5c5b350e001b
started_time: 1435080709
type: client
contentMediaType: application/json
examples:
Example:
value:
aps:
- 5c5b350e001c
- 5c5b350e001b
client_mac: 60a10a773412
duration: 300
failed: []
id: a9a84e13-a714-b1eb-152f-a434416217d5
includes_mcast: false
max_pkt_len: 128
num_packets: 1000
ok:
- 5c5b350e001c
- 5c5b350e001b
started_time: 1435080709
type: client
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_pcap_status'
- description: Current status of a packet capture session
examples:
- aps:
- 5c5b350e001c
- 5c5b350e001b
client_mac: 60a10a773412
duration: 300
failed: []
id: a9a84e13-a714-b1eb-152f-a434416217d5
includes_mcast: false
max_pkt_len: 128
num_packets: 1000
ok:
- 5c5b350e001c
- 5c5b350e001b
started_time: 1435080709
type: client
contentMediaType: application/vnd.api+json
examples:
Example:
value:
aps:
- 5c5b350e001c
- 5c5b350e001b
client_mac: 60a10a773412
duration: 300
failed: []
id: a9a84e13-a714-b1eb-152f-a434416217d5
includes_mcast: false
max_pkt_len: 128
num_packets: 1000
ok:
- 5c5b350e001c
- 5c5b350e001b
started_time: 1435080709
type: client
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Utilities PCAPs
summary: startOrgPacketCapture
description: "Start an organization-level packet capture for org-level Mist Edges\n\n**NOTE**: For packet captures of org level Mist Edges only. Use [Start Site Packet Capture]($e/Utilities%20PCAPs/startSitePacketCapture) for site level Mist Edges. \n\nThe output will be available through websocket. As there can be multiple commands issued against the same AP at the same time and the output all goes through the same websocket stream, session is introduced for demux.\n\n#### Subscribe to Device Command outputs\n`WS /api-ws/v1/stream`\n\n```json\n{\n \"subscribe\": \"/orgs/:org_id/pcaps\"\n}\n```\n#### Response (MxEdge)\n```json\n{\n \"event\": \"data\"\n \"channel\": \"/orgs/67970e46-4e12-11e6-9188-0242ac110007/pcaps\"\n \"data\": {\n \"capture_id\": \"f039b1b4-a23e-48b2-906a-0da40524de73\", \n \"pcap_dict\": {\n \"dst_mac\": \"68:ec:c5:09:2e:87\",\n \"src_mac\": \"8c:3b:ad:e0:47:40\", \n \"vlan\": 1, \n \"src_ip\": \"34.224.147.117\", \n \"dst_ip\": \"192.168.1.55\",\n \"dst_port\": 51635, \n \"src_port\": 443,\n \"protocol\": \"TCP\", \n \"mxedge_id\": \"00000000-0000-0000-1000-001122334455\",\n \"direction\": \"tx\", \n \"timestamp\": 1652247615, \n \"length\": 159.0, \n \"lost_messages\": 0,\n \"interface\": \"port0\",\n \"info\": \"1652247616.007409 IP ec2-34-224-147-117.compute-1.amazonaws.com.https > ip-192-168-1-55.ec2.internal.51635: Flags [P.], seq \\n 2192123968:2192124057, ack 4035166782, win 12, options [nop,nop,TS val 597467050 ecr 740580660], length 89\\\\n\",\n }, \n \"pcap_raw\": \"1MOyoQIABAAAAAAAAAAAAP//AAABAAAAQEx7YhMzAACfAAAAnwAAAGjsxQkuh4w7reBHQIEAAAEIAEUAAI1bLEAAKAZ/CiLgk3XAqAE3AbvJs4KpKEDwg8I+gBgADFf9AAABAQgKI5yfqiwkXTQXAwMAVKY5JopoKQrVEn0/3ld4YntctGEH/rTZuwtCvzSncFw71QJveJi9uxHs57KC8w9Apph3YvXJrmWg7M37+o+YV0KH/xmr626s5Bkhb3QhKOu+NoNEmA==\"\n }\n}\n```\n#### Stop Response\n```json\n{\n \"event\": \"data\"\n \"channel\": \"/orgs/67970e46-4e12-11e6-9188-0242ac110007/pcaps\"\n \"data\": {\n \"capture_id\": \"a2f7374d-6a70-41fd-8a3f-71e42573baaf\",\n \"pcap_dict\": null\n }\n}\n```"
operationId: startOrgPacketCapture
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/capture_org'
- description: Request Body
examples:
- duration: 600
format: stream
max_pkt_len: 1500
mxedges:
00000000-0000-0000-1000-001122334455:
interfaces:
port1:
tcpdump_expression: udp port 67 or udp port 68
num_packets: 100
type: mxedge
contentMediaType: application/json
examples:
MxEdge-Packet-Capture:
value:
duration: 600
format: stream
max_pkt_len: 1500
mxedges:
00000000-0000-0000-1000-001122334455:
interfaces:
port1:
tcpdump_expression: udp port 67 or udp port 68
num_packets: 100
type: mxedge
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_pcap_start'
- description: Packet capture session created by a start request
examples:
- ap_count: 3
aps: []
duration: 600
enabled: true
expiry: 1614886726.5411825
format: stream
id: a9a84e13-a714-b1eb-152f-a434416217d5
include_mcast: false
max_pkt_len: 68
num_packets: 100
org_id: a9346fba-f920-e99a-cc51-2e8dcc57fa3c
raw: true
site_id: 67970e46-4e12-11e6-9188-0242ac110007
ssid: ''
timestamp: 1614886126.5411825
type: radiotap
contentMediaType: application/json
examples:
Example:
value:
ap_count: 3
aps: []
duration: 600
enabled: true
expiry: 1614886726.5411825
format: stream
id: a9a84e13-a714-b1eb-152f-a434416217d5
include_mcast: false
max_pkt_len: 68
num_packets: 100
org_id: a9346fba-f920-e99a-cc51-2e8dcc57fa3c
raw: true
site_id: 67970e46-4e12-11e6-9188-0242ac110007
ssid: ''
timestamp: 1614886126.5411825
type: radiotap
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_pcap_start'
- description: Packet capture session created by a start request
examples:
- ap_count: 3
aps: []
duration: 600
enabled: true
expiry: 1614886726.5411825
format: stream
id: a9a84e13-a714-b1eb-152f-a434416217d5
include_mcast: false
max_pkt_len: 68
num_packets: 100
org_id: a9346fba-f920-e99a-cc51-2e8dcc57fa3c
raw: true
site_id: 67970e46-4e12-11e6-9188-0242ac110007
ssid: ''
timestamp: 1614886126.5411825
type: radiotap
contentMediaType: application/vnd.api+json
examples:
Example:
value:
ap_count: 3
aps: []
duration: 600
enabled: true
expiry: 1614886726.5411825
format: stream
id: a9a84e13-a714-b1eb-152f-a434416217d5
include_mcast: false
max_pkt_len: 68
num_packets: 100
org_id: a9346fba-f920-e99a-cc51-2e8dcc57fa3c
raw: true
site_id: 67970e46-4e12-11e6-9188-0242ac110007
ssid: ''
timestamp: 1614886126.5411825
type: radiotap
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/pcaps:
get:
tags:
- Utilities PCAPs
summary: listSitePacketCaptures
description: List packet captures for a site, optionally filtered by client MAC address and time range. Use [List Org Packet Captures]($e/Utilities%20PCAPs/listOrgPacketCaptures) to retrieve packet captures across the organization.
operationId: listSitePacketCaptures
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: client_mac
in: query
description: Optional client mac filter
style: form
explode: true
schema:
type: string
- name: start
in: query
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
style: form
explode: true
schema:
type: string
- name: end
in: query
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
style: form
explode: true
schema:
type: string
- name: duration
in: query
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
style: form
explode: true
schema:
type: string
default: 1d
examples:
- 10m
- name: limit
in: query
description: Maximum number of results to return per page
style: form
explode: true
schema:
minimum: 0
type: integer
contentEncoding: int32
default: 100
- name: page
in: query
description: Select the page number to return when using page-based pagination; starts at `1`
style: form
explode: true
schema:
minimum: 1
type: integer
contentEncoding: int32
default: 1
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_pcap_search'
- description: Paginated response for packet capture search results
examples:
- end: 1461089816
limit: 100
next: /api/v1/sites/67970e46-4e12-11e6-9188-0242ac110007/pcaps?start=1461099816&search_after=%5B1694537121217%5D&limit=100&end=1461089816
results:
- ap_macs:
- 5c5b35000010
timestamp: 1461869041
type: new_assoc
url: https://...
- duration: 9999
format: stream
id: 80cec4c9-322c-4712-95ce-6ba47fb54fc0
last_seen: 1693482149.417
mxedges:
- 00000000-0000-0000-1000-001122334455
org_id: 78c11da8-f984-4425-bedb-a7ddd7d0f6da
pcap_url: https://...
site_id: null
termination_reason: default
timestamp: 1693525333.234066
type: mxedge
url: https://...
start: 1461099816
contentMediaType: application/json
examples:
Example:
value:
end: 1461089816
limit: 100
next: /api/v1/sites/67970e46-4e12-11e6-9188-0242ac110007/pcaps?start=1461099816&search_after=%5B1694537121217%5D&limit=100&end=1461089816
results:
- ap_macs:
- 5c5b35000010
timestamp: 1461869041
type: new_assoc
url: https://...
- duration: 9999
format: stream
id: 80cec4c9-322c-4712-95ce-6ba47fb54fc0
last_seen: 1693482149.417
mxedges:
- 00000000-0000-0000-1000-001122334455
org_id: 78c11da8-f984-4425-bedb-a7ddd7d0f6da
pcap_url: https://...
site_id: null
termination_reason: default
timestamp: 1693525333.234066
type: mxedge
url: https://...
start: 1461099816
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_pcap_search'
- description: Paginated response for packet capture search results
examples:
- end: 1461089816
limit: 100
next: /api/v1/sites/67970e46-4e12-11e6-9188-0242ac110007/pcaps?start=1461099816&search_after=%5B1694537121217%5D&limit=100&end=1461089816
results:
- ap_macs:
- 5c5b35000010
timestamp: 1461869041
type: new_assoc
url: https://...
- duration: 9999
format: stream
id: 80cec4c9-322c-4712-95ce-6ba47fb54fc0
last_seen: 1693482149.417
mxedges:
- 00000000-0000-0000-1000-001122334455
org_id: 78c11da8-f984-4425-bedb-a7ddd7d0f6da
pcap_url: https://...
site_id: null
termination_reason: default
timestamp: 1693525333.234066
type: mxedge
url: https://...
start: 1461099816
contentMediaType: application/vnd.api+json
examples:
Example:
value:
end: 1461089816
limit: 100
next: /api/v1/sites/67970e46-4e12-11e6-9188-0242ac110007/pcaps?start=1461099816&search_after=%5B1694537121217%5D&limit=100&end=1461089816
results:
- ap_macs:
- 5c5b35000010
timestamp: 1461869041
type: new_assoc
url: https://...
- duration: 9999
format: stream
id: 80cec4c9-322c-4712-95ce-6ba47fb54fc0
last_seen: 1693482149.417
mxedges:
- 00000000-0000-0000-1000-001122334455
org_id: 78c11da8-f984-4425-bedb-a7ddd7d0f6da
pcap_url: https://...
site_id: null
termination_reason: default
timestamp: 1693525333.234066
type: mxedge
url: https://...
start: 1461099816
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/pcaps/capture:
delete:
tags:
- Utilities PCAPs
summary: stopSitePacketCapture
description: Stop current capture
operationId: stopSitePacketCapture
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
get:
tags:
- Utilities PCAPs
summary: getSiteCapturingStatus
description: Get Capturing status
operationId: getSiteCapturingStatus
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_pcap_status'
- description: Current status of a packet capture session
examples:
- aps:
- 5c5b350e001c
- 5c5b350e001b
client_mac: 60a10a773412
duration: 300
failed: []
id: a9a84e13-a714-b1eb-152f-a434416217d5
includes_mcast: false
max_pkt_len: 128
num_packets: 1000
ok:
- 5c5b350e001c
- 5c5b350e001b
started_time: 1435080709
type: client
contentMediaType: application/json
examples:
Example:
value:
aps:
- 5c5b350e001c
- 5c5b350e001b
client_mac: 60a10a773412
duration: 300
failed: []
id: a9a84e13-a714-b1eb-152f-a434416217d5
includes_mcast: false
max_pkt_len: 128
num_packets: 1000
ok:
- 5c5b350e001c
- 5c5b350e001b
started_time: 1435080709
type: client
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_pcap_status'
- description: Current status of a packet capture session
examples:
- aps:
- 5c5b350e001c
- 5c5b350e001b
client_mac: 60a10a773412
duration: 300
failed: []
id: a9a84e13-a714-b1eb-152f-a434416217d5
includes_mcast: false
max_pkt_len: 128
num_packets: 1000
ok:
- 5c5b350e001c
- 5c5b350e001b
started_time: 1435080709
type: client
contentMediaType: application/vnd.api+json
examples:
Example:
value:
aps:
- 5c5b350e001c
- 5c5b350e001b
client_mac: 60a10a773412
duration: 300
failed: []
id: a9a84e13-a714-b1eb-152f-a434416217d5
includes_mcast: false
max_pkt_len: 128
num_packets: 1000
ok:
- 5c5b350e001c
- 5c5b350e001b
started_time: 1435080709
type: client
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Utilities PCAPs
summary: startSitePacketCapture
description: "Initiate a Site Packet Capture\n\nThe output will be available through websocket. As there can be multiple commands issued against the same AP at the same time and the output all goes through the same websocket stream, session is introduced for demux.\n\n#### Subscribe to Device Command outputs\n`WS /api-ws/v1/stream`\n\n```json\n{\n \"subscribe\": \"/sites/{site_id}/pcaps\"\n}\n```\n#### Response (MxEdge)\n```json\n{\n \"event\": \"data\"\n \"channel\": \"/sites/{site_id}/pcaps\"\n \"data\": {\n \"capture_id\": \"6b1be4fb-b239-44d9-9d3b-cb1ff3af1721\",\n \"lost_messages\": 0\n \"pcap_dict\": {\n \"channel_frequency\": 2412,\n \"channel\": \"1\",\n \"datarate\": \"1.0 Mbps\",\n \"rssi\": -75, \n \"dst\": \"78:bd:bc:ca:0b:0a\",\n \"src\": \"18:b8:1f:4c:91:c0\",\n \"bssid\": \"18:b8:1f:4c:91:c0\",\n \"frame_type\": \"Management\", \n \"frame_subtype\": \"Probe Response\", \n \"proto\": \"802.11\", \n \"ap_mac\": \"d4:20:b0:81:99:2e\", \n \"direction\": \"tx\", \n \"timestamp\": 1652246543, \n \"length\": 416.0,\n \"interface\": \"radiotap\",\n \"info\": \"1652246544.467733 1683216786us tsft 1.0 Mb/s 2412 MHz 11g -75dBm signal -82dBm noise antenna 0 Probe Response (ATTKmsWiVS) [1.0* 2.0* 5.5* 11.0* 18.0 24.0 36.0 54.0 Mbit] CH: 2, PRIVACY\\\\n\",\n }, \n \"pcap_raw\": \"1MOyoQIABAAAAAAAAAAAAP//AAABAAAAEEh7Yh5VBwCgAQAAoAEAAAAAKwBvCADAAQAAAIw7reCS2VNkAAAAABACbAmABLWuAAEAEBgAAwACAABQADoBeL28ygsKGLgfTJHAGLgfTJHAcIZ2WDlBJQAAAGQAERUACkFUVEttc1dpVlMBCIKEi5YkMEhsAwECBwZVUyABCx4gAQAjAhkAKgEEMgQMEhhgMBQBAAAPrAQBAAAPrAQBAAAPrAIMAAsFAQAbAABGBTIIAQAALRqtCR////8AAAAAAAAAAAAAAAAAAAAAAAAAAD0WAggVAAAAAAAAAAAAAAAAAAAAAAAAAH8IBAAIAAAAAEDdkwBQ8gQQSgABEBBEAAECEDsAAQMQRwAQn2481frn3KT+uGod2ERx+RAhAAtBcnJpcywgSW5jLhAjAApCR1cyMTAtNzAwECQACkJHVzIxMC03MDAQQgAKQkdXMjEwLTcwMBBUAAgABgBQ8gQAARARAA5BcnJpcyBXaXJlbGVzcxAIAAIgCBA8AAEBEEkABgA3KgABIN0JABAYAgEQHAAA3RgAUPICAQGEAAOkAAAnpAAAQkNeAGIyLwAzjakr\"\n}\n```\n\n#### Response (Wired)\n```json\n{\n \"event\": \"data\"\n \"channel\": \"/sites/67970e46-4e12-11e6-9188-0242ac110007/pcaps\"\n \"data\": {\n \"capture_id\": \"f039b1b4-a23e-48b2-906a-0da40524de73\", \n \"pcap_dict\": {\n \"dst_mac\": \"68:ec:c5:09:2e:87\",\n \"src_mac\": \"8c:3b:ad:e0:47:40\", \n \"vlan\": 1, \n \"src_ip\": \"34.224.147.117\", \n \"dst_ip\": \"192.168.1.55\",\n \"dst_port\": 51635, \n \"src_port\": 443,\n \"proto\": \"TCP\", \n \"ap_mac\": \"d4:20:b0:81:99:2e\",\n \"direction\": \"tx\", \n \"timestamp\": 1652247615, \n \"length\": 159.0, \n \"interface\": \"wired\",\n \"info\": \"1652247616.007409 IP ec2-34-224-147-117.compute-1.amazonaws.com.https > ip-192-168-1-55.ec2.internal.51635: Flags [P.], seq 2192123968:2192124057, ack 4035166782, win 12, options [nop,nop,TS val 597467050 ecr 740580660], length 89\\\\n\",\n }, \n \"pcap_raw\": \"1MOyoQIABAAAAAAAAAAAAP//AAABAAAAQEx7YhMzAACfAAAAnwAAAGjsxQkuh4w7reBHQIEAAAEIAEUAAI1bLEAAKAZ/CiLgk3XAqAE3AbvJs4KpKEDwg8I+gBgADFf9AAABAQgKI5yfqiwkXTQXAwMAVKY5JopoKQrVEn0/3ld4YntctGEH/rTZuwtCvzSncFw71QJveJi9uxHs57KC8w9Apph3YvXJrmWg7M37+o+YV0KH/xmr626s5Bkhb3QhKOu+NoNEmA==\"\n\n }\n}\n```\n\n#### Stop Response (Wired/Wireless)\n```json\n{\n \"event\": \"data\"\n \"channel\": \"/sites/67970e46-4e12-11e6-9188-0242ac110007/pcaps\"\n \"data\": {\n \"capture_id\": \"a2f7374d-6a70-41fd-8a3f-71e42573baaf\", \n \"lost_messages\": 0,\n \"pcap_dict\": null\n }\n}\n```"
operationId: startSitePacketCapture
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/capture_site'
- description: Request Body
examples:
- '{"client_mac":"60a10a773412","duration":600,"includes_mcast":false,"max_pkt_len":128,"num_packets":100,"type":"new_assoc"}'
- '{"duration":600,"max_pkt_len":68,"num_packets":100,"type":"radiotap"}'
- '{"ap_mac":"string","client_mac":"38f9d3972ff1","duration":600,"max_pkt_len":128,"num_packets":1024,"ssid":"string","type":"radiotap,wired"}'
- '{"ap_mac":null,"band":"24","bandwidth":20,"channel":1,"client_mac":"38f9d3972ff1","duration":600,"format":"stream","max_pkt_len":68,"num_packets":100,"tcpdump_expression":"tcp port 80","type":"scan"}'
- '{"duration":600,"max_pkt_len":68,"num_packets":100,"tcpdump_expression":"tcp port 80","type":"wired"}'
- '{"ap_mac":null,"band":"24","duration":600,"max_pkt_len":128,"num_packets":100,"type":"wireless"}'
- '{"client_mac":"60a10a773412","duration":300,"includes_mcast":false,"max_pkt_len":128,"num_packets":1000,"type":"client"}'
- '{"duration":600,"format":"stream","gateways":{"001122334455":{"ports":{"ge-0/0/0":{"tcpdump_expression":"tcp"},"ge-0/0/1":{"tcpdump_expression":"port 443"},"ge-1/0/0":{"tcpdump_expression":"tcp"},"ge-1/0/1":{"tcpdump_expression":"port 443"}}},"001122334466":{"ports":{"ge-0/0/0":{"tcpdump_expression":"udp"},"ge-0/0/1":{"tcpdump_expression":"port 32768"}}}},"max_pkt_len":1500,"num_packets":100,"type":"gateway"}'
- '{"duration":600,"format":"stream","max_pkt_len":1500,"num_packets":100,"switches":{"001122334455":{"ports":{"ge-0/0/0":{"tcpdump_expression":"udp"},"ge-0/0/1":{},"ge-1/0/0":{},"ge-1/0/1":{}}},"001122334466":{"ports":{"ge-0/0/0":{},"ge-0/0/1":{}}}},"tcpdump_expression":"port 443","type":"switch"}'
contentMediaType: application/json
examples:
AP-New-Wireless-Client-Associations-Packet-Capture:
value:
client_mac: 60a10a773412
duration: 600
includes_mcast: false
max_pkt_len: 128
num_packets: 100
type: new_assoc
AP-Radiotap-Packet-Capture:
value:
duration: 600
max_pkt_len: 68
num_packets: 100
type: radiotap
AP-Radiotap-Packet-Capture-and-Wired-Packet-Capture:
value:
ap_mac: string
client_mac: 38f9d3972ff1
duration: 600
max_pkt_len: 128
num_packets: 1024
ssid: string
type: radiotap,wired
AP-Scan-radio-Packet-Capture:
value:
ap_mac: null
band: '24'
bandwidth: 20
channel: 1
client_mac: 38f9d3972ff1
duration: 600
format: stream
max_pkt_len: 68
num_packets: 100
tcpdump_expression: tcp port 80
type: scan
AP-Wired-Packet-Capture:
value:
duration: 600
max_pkt_len: 68
num_packets: 100
tcpdump_expression: tcp port 80
type: wired
AP-Wireless-Packet-Capture:
value:
ap_mac: null
band: '24'
duration: 600
max_pkt_len: 128
num_packets: 100
type: wireless
Client-Packet-Capture:
value:
client_mac: 60a10a773412
duration: 300
includes_mcast: false
max_pkt_len: 128
num_packets: 1000
type: client
SSR-Packet-Capture:
value:
duration: 600
format: stream
gateways:
'001122334455':
ports:
ge-0/0/0:
tcpdump_expression: tcp
ge-0/0/1:
tcpdump_expression: port 443
ge-1/0/0:
tcpdump_expression: tcp
ge-1/0/1:
tcpdump_expression: port 443
'001122334466':
ports:
ge-0/0/0:
tcpdump_expression: udp
ge-0/0/1:
tcpdump_expression: port 32768
max_pkt_len: 1500
num_packets: 100
type: gateway
Switch-Packet-Capture:
value:
duration: 600
format: stream
max_pkt_len: 1500
num_packets: 100
switches:
'001122334455':
ports:
ge-0/0/0:
tcpdump_expression: udp
ge-0/0/1: {}
ge-1/0/0: {}
ge-1/0/1: {}
'001122334466':
ports:
ge-0/0/0: {}
ge-0/0/1: {}
tcpdump_expression: port 443
type: switch
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_pcap_start'
- description: Packet capture session created by a start request
examples:
- ap_count: 3
aps: []
duration: 600
enabled: true
expiry: 1614886726.5411825
format: stream
id: a9a84e13-a714-b1eb-152f-a434416217d5
include_mcast: false
max_pkt_len: 68
num_packets: 100
org_id: a9346fba-f920-e99a-cc51-2e8dcc57fa3c
raw: true
site_id: 67970e46-4e12-11e6-9188-0242ac110007
ssid: ''
timestamp: 1614886126.5411825
type: radiotap
contentMediaType: application/json
examples:
Example:
value:
ap_count: 3
aps: []
duration: 600
enabled: true
expiry: 1614886726.5411825
format: stream
id: a9a84e13-a714-b1eb-152f-a434416217d5
include_mcast: false
max_pkt_len: 68
num_packets: 100
org_id: a9346fba-f920-e99a-cc51-2e8dcc57fa3c
raw: true
site_id: 67970e46-4e12-11e6-9188-0242ac110007
ssid: ''
timestamp: 1614886126.5411825
type: radiotap
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_pcap_start'
- description: Packet capture session created by a start request
examples:
- ap_count: 3
aps: []
duration: 600
enabled: true
expiry: 1614886726.5411825
format: stream
id: a9a84e13-a714-b1eb-152f-a434416217d5
include_mcast: false
max_pkt_len: 68
num_packets: 100
org_id: a9346fba-f920-e99a-cc51-2e8dcc57fa3c
raw: true
site_id: 67970e46-4e12-11e6-9188-0242ac110007
ssid: ''
timestamp: 1614886126.5411825
type: radiotap
contentMediaType: application/vnd.api+json
examples:
Example:
value:
ap_count: 3
aps: []
duration: 600
enabled: true
expiry: 1614886726.5411825
format: stream
id: a9a84e13-a714-b1eb-152f-a434416217d5
include_mcast: false
max_pkt_len: 68
num_packets: 100
org_id: a9346fba-f920-e99a-cc51-2e8dcc57fa3c
raw: true
site_id: 67970e46-4e12-11e6-9188-0242ac110007
ssid: ''
timestamp: 1614886126.5411825
type: radiotap
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/pcaps/{pcap_id}:
put:
tags:
- Utilities PCAPs
summary: updateSitePacketCapture
description: Update or add notes to a completed packet capture
operationId: updateSitePacketCapture
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: pcap_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/notes_string'
- examples:
- notes: wired pcap test
contentMediaType: application/json
examples:
Example:
value:
notes: wired pcap test
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/send_ble_beacon:
post:
tags:
- Utilities Location
summary: sendSiteDevicesArbitraryBleBeacon
description: >-
Send arbitrary BLE Beacon for a period of time
Note that only the devices that are connected will be restarted.
operationId: sendSiteDevicesArbitraryBleBeacon
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/utils_send_ble_beacon'
- examples:
- beacon_frame: 68b329da9893e34099c7d8ad5cb9c940
beacon_freq: 100
duration: 10
macs:
- 5c5b35584a6f
- 5c5b350ea3b3
map_ids:
- 845a23bf-bed9-e43c-4c86-6fa474be7ae5
contentMediaType: application/json
examples:
Example:
value:
beacon_frame: 68b329da9893e34099c7d8ad5cb9c940
beacon_freq: 100
duration: 10
macs:
- 5c5b35584a6f
- 5c5b350ea3b3
map_ids:
- 845a23bf-bed9-e43c-4c86-6fa474be7ae5
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/mxtunnels/{mxtunnel_id}/preempt_aps:
post:
tags:
- Utilities MxEdge
summary: preemptSitesMxTunnel
description: To preempt AP’s which are not connected to preferred peer to the preferred peer
operationId: preemptSitesMxTunnel
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: mxtunnel_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_mxtunnels_preempt_aps'
- description: Result of preempting APs onto preferred MxTunnel peers
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_mxtunnels_preempt_aps'
- description: Result of preempting APs onto preferred MxTunnel peers
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/devices/upgrade:
get:
tags:
- Utilities Upgrade
summary: listOrgDeviceUpgrades
description: List organization-level device upgrade jobs, including the site-level upgrade jobs created under each organization upgrade.
operationId: listOrgDeviceUpgrades
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/upgrade_org_devices_item'
description: Organization device upgrade jobs returned by a list response
examples:
- - id: 466f6eca-6276-4993-bfeb-53cbbbba6f88
site_upgrades:
- site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
upgrade_id: 174bda0-06a3-40ee-b918-d9cbde303690
contentMediaType: application/json
examples:
Example:
value:
- id: 466f6eca-6276-4993-bfeb-53cbbbba6f88
site_upgrades:
- site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
upgrade_id: 174bda0-06a3-40ee-b918-d9cbde303690
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/upgrade_org_devices_item'
description: Organization device upgrade jobs returned by a list response
examples:
- - id: 466f6eca-6276-4993-bfeb-53cbbbba6f88
site_upgrades:
- site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
upgrade_id: 174bda0-06a3-40ee-b918-d9cbde303690
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- id: 466f6eca-6276-4993-bfeb-53cbbbba6f88
site_upgrades:
- site_id: 72771e6a-6f5e-4de4-a5b9-1266c4197811
upgrade_id: 174bda0-06a3-40ee-b918-d9cbde303690
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Utilities Upgrade
summary: upgradeOrgDevices
description: Start an organization-level device upgrade job across selected sites. The request selects device type, sites, models, firmware versions, and upgrade strategy; AP-specific and Junos-specific options apply only where supported.
operationId: upgradeOrgDevices
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/upgrade_org_devices'
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_upgrade_org_devices'
- description: Organization AP upgrade job details
examples:
- enable_p2p: true
force: true
id: 31223085-405d-4b64-8aea-9c5b98098b4b
strategy: big_bang
target_version: 0.14.29411
upgrades:
- site_id: 1bbe6e79-2583-403c-be1a-9881b4691ab6
upgrade:
id: 473f6eca-6276-4993-bfeb-53cbbbba6f18
start_time: 1717658765
status: upgrading
targets:
download_requested:
- 5c5b3550bd2e
downloaded:
- 003e7316ff9e
total: 4
upgraded:
- 5c5b3550bd2e
- 003e7316ff9e
contentMediaType: application/json
examples:
Example:
value:
enable_p2p: true
force: true
id: 31223085-405d-4b64-8aea-9c5b98098b4b
strategy: big_bang
target_version: 0.14.29411
upgrades:
- site_id: 1bbe6e79-2583-403c-be1a-9881b4691ab6
upgrade:
id: 473f6eca-6276-4993-bfeb-53cbbbba6f18
start_time: 1717658765
status: upgrading
targets:
download_requested:
- 5c5b3550bd2e
downloaded:
- 003e7316ff9e
total: 4
upgraded:
- 5c5b3550bd2e
- 003e7316ff9e
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_upgrade_org_devices'
- description: Organization AP upgrade job details
examples:
- enable_p2p: true
force: true
id: 31223085-405d-4b64-8aea-9c5b98098b4b
strategy: big_bang
target_version: 0.14.29411
upgrades:
- site_id: 1bbe6e79-2583-403c-be1a-9881b4691ab6
upgrade:
id: 473f6eca-6276-4993-bfeb-53cbbbba6f18
start_time: 1717658765
status: upgrading
targets:
download_requested:
- 5c5b3550bd2e
downloaded:
- 003e7316ff9e
total: 4
upgraded:
- 5c5b3550bd2e
- 003e7316ff9e
contentMediaType: application/vnd.api+json
examples:
Example:
value:
enable_p2p: true
force: true
id: 31223085-405d-4b64-8aea-9c5b98098b4b
strategy: big_bang
target_version: 0.14.29411
upgrades:
- site_id: 1bbe6e79-2583-403c-be1a-9881b4691ab6
upgrade:
id: 473f6eca-6276-4993-bfeb-53cbbbba6f18
start_time: 1717658765
status: upgrading
targets:
download_requested:
- 5c5b3550bd2e
downloaded:
- 003e7316ff9e
total: 4
upgraded:
- 5c5b3550bd2e
- 003e7316ff9e
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/devices/upgrade/{upgrade_id}:
get:
tags:
- Utilities Upgrade
summary: getOrgDeviceUpgrade
description: Retrieve details for an organization-level device upgrade job, including per-site upgrade status and device targets.
operationId: getOrgDeviceUpgrade
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: upgrade_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_upgrade_org_devices'
- description: Organization AP upgrade job details
examples:
- enable_p2p: true
force: true
id: 31223085-405d-4b64-8aea-9c5b98098b4b
strategy: big_bang
target_version: 0.14.29411
upgrades:
- site_id: 1bbe6e79-2583-403c-be1a-9881b4691ab6
upgrade:
id: 473f6eca-6276-4993-bfeb-53cbbbba6f18
start_time: 1717658765
status: upgrading
targets:
download_requested:
- 5c5b3550bd2e
downloaded:
- 003e7316ff9e
total: 4
upgraded:
- 5c5b3550bd2e
- 003e7316ff9e
contentMediaType: application/json
examples:
Example:
value:
enable_p2p: true
force: true
id: 31223085-405d-4b64-8aea-9c5b98098b4b
strategy: big_bang
target_version: 0.14.29411
upgrades:
- site_id: 1bbe6e79-2583-403c-be1a-9881b4691ab6
upgrade:
id: 473f6eca-6276-4993-bfeb-53cbbbba6f18
start_time: 1717658765
status: upgrading
targets:
download_requested:
- 5c5b3550bd2e
downloaded:
- 003e7316ff9e
total: 4
upgraded:
- 5c5b3550bd2e
- 003e7316ff9e
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_upgrade_org_devices'
- description: Organization AP upgrade job details
examples:
- enable_p2p: true
force: true
id: 31223085-405d-4b64-8aea-9c5b98098b4b
strategy: big_bang
target_version: 0.14.29411
upgrades:
- site_id: 1bbe6e79-2583-403c-be1a-9881b4691ab6
upgrade:
id: 473f6eca-6276-4993-bfeb-53cbbbba6f18
start_time: 1717658765
status: upgrading
targets:
download_requested:
- 5c5b3550bd2e
downloaded:
- 003e7316ff9e
total: 4
upgraded:
- 5c5b3550bd2e
- 003e7316ff9e
contentMediaType: application/vnd.api+json
examples:
Example:
value:
enable_p2p: true
force: true
id: 31223085-405d-4b64-8aea-9c5b98098b4b
strategy: big_bang
target_version: 0.14.29411
upgrades:
- site_id: 1bbe6e79-2583-403c-be1a-9881b4691ab6
upgrade:
id: 473f6eca-6276-4993-bfeb-53cbbbba6f18
start_time: 1717658765
status: upgrading
targets:
download_requested:
- 5c5b3550bd2e
downloaded:
- 003e7316ff9e
total: 4
upgraded:
- 5c5b3550bd2e
- 003e7316ff9e
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/devices/upgrade/{upgrade_id}/cancel:
post:
tags:
- Utilities Upgrade
summary: cancelOrgDeviceUpgrade
description: Cancel an organization-level device upgrade job on a best-effort basis. Devices that have already completed the upgrade are not changed.
operationId: cancelOrgDeviceUpgrade
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: upgrade_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/devices/versions:
get:
tags:
- Utilities Upgrade
summary: listOrgAvailableDeviceVersions
description: List available firmware versions for organization devices, optionally filtered by device type and model.
operationId: listOrgAvailableDeviceVersions
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: type
in: query
description: 'Filter results by type. enum: `ap`, `gateway`, `switch`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/device_type_default_ap'
- description: 'Filter results by type. enum: `ap`, `gateway`, `switch`'
- name: model
in: query
description: Fetch version for device model, use/combine with `type` as needed (for switch and gateway devices). Accepts multiple comma-separated values.
style: form
explode: true
schema:
type: string
examples:
- AP27,AP27E
- AP43
examples:
Untitled Example1:
value: AP27,AP27E
Untitled Example2:
value: AP43
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/device_version_item'
description: Available firmware versions for device models
examples:
- - model: AP41
tag: suggested
version: v0.1.543
- model: AP21
version: v0.1.545
contentMediaType: application/json
examples:
Example:
value:
- model: AP41
tag: suggested
version: v0.1.543
- model: AP21
version: v0.1.545
application/vnd.api+json:
schema:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/device_version_item'
description: Available firmware versions for device models
examples:
- - model: AP41
tag: suggested
version: v0.1.543
- model: AP21
version: v0.1.545
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- model: AP41
tag: suggested
version: v0.1.543
- model: AP21
version: v0.1.545
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/jsi/devices/{device_mac}/upgrade:
post:
tags:
- Utilities Upgrade
summary: upgradeOrgJsiDevice
description: Start a software upgrade for a JSI-connected device identified by MAC address using the requested target version.
operationId: upgradeOrgJsiDevice
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_mac
in: path
description: ''
required: true
schema:
pattern: ^[0-9a-fA-F]{12}$
type: string
examples:
- 0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/version_string'
- examples:
- version: 3.1.5
contentMediaType: application/json
examples:
Example:
value:
version: 3.1.5
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/mxedges/upgrade:
get:
tags:
- Utilities Upgrade
summary: listOrgMxEdgeUpgrades
description: List Mist Edge upgrade requests for the organization, including status, rollout strategy, target versions, and per-status target counts.
operationId: listOrgMxEdgeUpgrades
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/response_mxedge_upgrade'
description: Mist Edge upgrade records returned by list upgrade operations
contentMediaType: application/json
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/response_mxedge_upgrade'
description: Mist Edge upgrade records returned by list upgrade operations
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Utilities Upgrade
summary: upgradeOrgMxEdges
description: Schedule a Mist Edge upgrade for selected Mist Edges, using service target versions or an optional Linux distro upgrade with rollout strategy and canary settings.
operationId: upgradeOrgMxEdges
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/mxedge_upgrade_multi'
- description: Request Body
examples:
- '{"allow_downgrades":{"mxagent":false,"tunterm":true},"canary_phases":[5,25,50,100],"channel":"stable","max_failure_percentage":5,"max_failures":[1,1,5,5],"mxedge_ids":["387804a7-3474-85ce-15a2-f9a9684c9c90"],"start_time":1624399840,"strategy":"serial","versions":{"mxagent":"latest","radsecproxy":"","tunterm":"default"}}'
- '{"canary_phases":[5,25,50,100],"distro":"buster","max_failure_percentage":5,"max_failures":[1,1,5,5],"mxedge_ids":["387804a7-3474-85ce-15a2-f9a9684c9c90"],"start_time":1624399840,"strategy":"serial"}'
contentMediaType: application/json
examples:
Upgrade_MxEdge:
value:
allow_downgrades:
mxagent: false
tunterm: true
canary_phases:
- 5
- 25
- 50
- 100
channel: stable
max_failure_percentage: 5
max_failures:
- 1
- 1
- 5
- 5
mxedge_ids:
- 387804a7-3474-85ce-15a2-f9a9684c9c90
start_time: 1624399840
strategy: serial
versions:
mxagent: latest
radsecproxy:
tunterm: default
Upgrade_MxEdge_Distro:
value:
canary_phases:
- 5
- 25
- 50
- 100
distro: buster
max_failure_percentage: 5
max_failures:
- 1
- 1
- 5
- 5
mxedge_ids:
- 387804a7-3474-85ce-15a2-f9a9684c9c90
start_time: 1624399840
strategy: serial
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/mxedges/upgrade/{upgrade_id}:
get:
tags:
- Utilities Upgrade
summary: getOrgMxEdgeUpgrade
description: Retrieve status, rollout strategy, target versions, and target counts for a specific Mist Edge upgrade request.
operationId: getOrgMxEdgeUpgrade
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: upgrade_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_mxedge_upgrade'
- description: Mist Edge upgrade details response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_mxedge_upgrade'
- description: Mist Edge upgrade details response
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Utilities Upgrade
summary: updateOrgMxEdgeUpgrade
description: Update a queued Mist Edge upgrade request, such as target versions, rollout strategy, start time, or target Mist Edge IDs. Only upgrades in `queued` state can be updated.
operationId: updateOrgMxEdgeUpgrade
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: upgrade_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/mxedge_upgrade_multi'
- description: Request Body
contentMediaType: application/json
required: false
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_mxedge_upgrade'
- description: Mist Edge upgrade details response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_mxedge_upgrade'
- description: Mist Edge upgrade details response
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/mxedges/upgrade/{upgrade_id}/cancel:
post:
tags:
- Utilities Upgrade
summary: cancelOrgMxEdgeUpgrade
description: Cancel a Mist Edge upgrade request on a best-effort basis. Mist Edges that have already been upgraded are not changed.
operationId: cancelOrgMxEdgeUpgrade
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: upgrade_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/ssr/upgrade:
get:
tags:
- Utilities Upgrade
summary: listOrgSsrUpgrades
description: List SSR firmware upgrade jobs for the organization, including status, rollout strategy, target versions, release channel, and device counts.
operationId: listOrgSsrUpgrades
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/response_ssr_upgrade'
description: SSR firmware upgrade jobs returned by list operations
examples:
- - channel: stable
counts:
failed: 0
queued: 1
success: 0
upgrading: 1
device_type: gateway
id: ceef2c8a-e2e6-447a-8b27-cb4f3ec1adae
status: upgrading
strategy: serial
versions: {}
contentMediaType: application/json
examples:
Example:
value:
- channel: stable
counts:
failed: 0
queued: 1
success: 0
upgrading: 1
device_type: gateway
id: ceef2c8a-e2e6-447a-8b27-cb4f3ec1adae
status: upgrading
strategy: serial
versions: {}
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/response_ssr_upgrade'
description: SSR firmware upgrade jobs returned by list operations
examples:
- - channel: stable
counts:
failed: 0
queued: 1
success: 0
upgrading: 1
device_type: gateway
id: ceef2c8a-e2e6-447a-8b27-cb4f3ec1adae
status: upgrading
strategy: serial
versions: {}
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- channel: stable
counts:
failed: 0
queued: 1
success: 0
upgrading: 1
device_type: gateway
id: ceef2c8a-e2e6-447a-8b27-cb4f3ec1adae
status: upgrading
strategy: serial
versions: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Utilities Upgrade
summary: upgradeOrgSsrs
description: Create an SSR firmware upgrade job for selected devices, with firmware version or channel, rollout strategy, and optional download or reboot timing.
operationId: upgradeOrgSsrs
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ssr_upgrade_multi'
- examples:
- channel: stable
device_ids:
- 00000000-0000-0000-1000-5c5b3500001f
- 00000000-0000-0000-1000-5c5b35000020
strategy: big_bang
version: 5.3.0-93
contentMediaType: application/json
examples:
Example:
value:
channel: stable
device_ids:
- 00000000-0000-0000-1000-5c5b3500001f
- 00000000-0000-0000-1000-5c5b35000020
strategy: big_bang
version: 5.3.0-93
required: false
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_ssr_upgrade'
- description: SSR firmware upgrade job summary
examples:
- channel: stable
counts:
failed: 0
queued: 1
success: 0
upgrading: 1
device_type: gateway
id: ceef2c8a-e2e6-447a-8b27-cb4f3ec1adae
status: upgrading
strategy: serial
versions: {}
contentMediaType: application/json
examples:
Example:
value:
channel: stable
counts:
failed: 0
queued: 1
success: 0
upgrading: 1
device_type: gateway
id: ceef2c8a-e2e6-447a-8b27-cb4f3ec1adae
status: upgrading
strategy: serial
versions: {}
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_ssr_upgrade'
- description: SSR firmware upgrade job summary
examples:
- channel: stable
counts:
failed: 0
queued: 1
success: 0
upgrading: 1
device_type: gateway
id: ceef2c8a-e2e6-447a-8b27-cb4f3ec1adae
status: upgrading
strategy: serial
versions: {}
contentMediaType: application/vnd.api+json
examples:
Example:
value:
channel: stable
counts:
failed: 0
queued: 1
success: 0
upgrading: 1
device_type: gateway
id: ceef2c8a-e2e6-447a-8b27-cb4f3ec1adae
status: upgrading
strategy: serial
versions: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/ssr/upgrade/{upgrade_id}/cancel:
get:
tags:
- Utilities Upgrade
summary: getOrgSsrUpgrade
description: Return detailed status for an SSR firmware upgrade job, including target device IDs grouped by upgrade status.
operationId: getOrgSsrUpgrade
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: upgrade_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_ssr_upgrade_status'
- description: Detailed status for an SSR firmware upgrade job
examples:
- channel: stable
device_type: gateway
id: 5cbcee0a-c620-4bb4-a25e-15000934e9d8
status: upgrading
targets:
failed: []
queued: []
success: []
upgrading:
- 8e525f1d-4178-4ae1-a988-2b0176855e55
versions: {}
contentMediaType: application/json
examples:
Example:
value:
channel: stable
device_type: gateway
id: 5cbcee0a-c620-4bb4-a25e-15000934e9d8
status: upgrading
targets:
failed: []
queued: []
success: []
upgrading:
- 8e525f1d-4178-4ae1-a988-2b0176855e55
versions: {}
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_ssr_upgrade_status'
- description: Detailed status for an SSR firmware upgrade job
examples:
- channel: stable
device_type: gateway
id: 5cbcee0a-c620-4bb4-a25e-15000934e9d8
status: upgrading
targets:
failed: []
queued: []
success: []
upgrading:
- 8e525f1d-4178-4ae1-a988-2b0176855e55
versions: {}
contentMediaType: application/vnd.api+json
examples:
Example:
value:
channel: stable
device_type: gateway
id: 5cbcee0a-c620-4bb4-a25e-15000934e9d8
status: upgrading
targets:
failed: []
queued: []
success: []
upgrading:
- 8e525f1d-4178-4ae1-a988-2b0176855e55
versions: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Utilities Upgrade
summary: cancelOrgSsrUpgrade
description: Cancel an SSR firmware upgrade job on a best-effort basis. Devices that have already upgraded are not changed.
operationId: cancelOrgSsrUpgrade
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: upgrade_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/orgs/{org_id}/ssr/versions:
get:
tags:
- Utilities Upgrade
summary: listOrgAvailableSsrVersions
description: List SSR firmware versions available for upgrade, optionally filtered by release channel and one or more SSR MAC addresses.
operationId: listOrgAvailableSsrVersions
parameters:
- name: org_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: channel
in: query
description: 'SSR release channel used to filter available versions. enum: `alpha`, `beta`, `stable`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/ssr_version_channel'
- description: 'SSR release channel used to filter available versions. enum: `alpha`, `beta`, `stable`'
- name: mac
in: query
description: Optional. MAC address, or comma separated MAC address list.
style: form
explode: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/ssr_version'
description: SSR firmware versions available for upgrade
examples:
- - default: true
package: SSR
version: 5.3.1-17
contentMediaType: application/json
examples:
Example:
value:
- default: true
package: SSR
version: 5.3.1-17
application/vnd.api+json:
schema:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/ssr_version'
description: SSR firmware versions available for upgrade
examples:
- - default: true
package: SSR
version: 5.3.1-17
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- default: true
package: SSR
version: 5.3.1-17
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/upgrade:
get:
tags:
- Utilities Upgrade
summary: listSiteDeviceUpgrades
description: List device upgrade operations for a site, optionally filtered by upgrade status. Use [List Org Device Upgrades]($e/Utilities%20Upgrade/listOrgDeviceUpgrades) to retrieve device upgrade operations across the organization.
operationId: listSiteDeviceUpgrades
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: status
in: query
description: 'Filter results by status. enum: `cancelled`, `completed`, `created`, `downloaded`, `downloading`, `failed`, `queued`, `upgrading`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/upgrade_device_status'
- description: 'Filter results by status. enum: `cancelled`, `completed`, `created`, `downloaded`, `downloading`, `failed`, `queued`, `upgrading`'
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/response_site_device_upgrades_item'
description: Site device upgrade jobs returned by list operations
examples:
- - counts:
download_requested: 0
downloaded: 0
failed: 0
reboot_in_progress: 0
rebooted: 0
skipped: 0
total: 0
enable_p2p: true
force: true
id: 472f6eca-6276-4993-bfeb-53cbbbba6f28
start_time: 0
status: created
strategy: big_bang
target_version: string
contentMediaType: application/json
examples:
Example:
value:
- counts:
download_requested: 0
downloaded: 0
failed: 0
reboot_in_progress: 0
rebooted: 0
skipped: 0
total: 0
enable_p2p: true
force: true
id: 472f6eca-6276-4993-bfeb-53cbbbba6f28
start_time: 0
status: created
strategy: big_bang
target_version: string
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/response_site_device_upgrades_item'
description: Site device upgrade jobs returned by list operations
examples:
- - counts:
download_requested: 0
downloaded: 0
failed: 0
reboot_in_progress: 0
rebooted: 0
skipped: 0
total: 0
enable_p2p: true
force: true
id: 472f6eca-6276-4993-bfeb-53cbbbba6f28
start_time: 0
status: created
strategy: big_bang
target_version: string
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- counts:
download_requested: 0
downloaded: 0
failed: 0
reboot_in_progress: 0
rebooted: 0
skipped: 0
total: 0
enable_p2p: true
force: true
id: 472f6eca-6276-4993-bfeb-53cbbbba6f28
start_time: 0
status: created
strategy: big_bang
target_version: string
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Utilities Upgrade
summary: upgradeSiteDevices
description: >-
Upgrade Site Device
**Note**: this call doesn’t guarantee the devices to be upgraded right away (they may be offline)
operationId: upgradeSiteDevices
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/upgrade_site_devices'
- description: Request Body
contentMediaType: application/json
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_upgrade_id'
- description: Response containing an upgrade job identifier
examples:
- upgrade_id: 4316c116-0acb-4c43-8f06-6723154e741e
contentMediaType: application/json
examples:
Example:
value:
upgrade_id: 4316c116-0acb-4c43-8f06-6723154e741e
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_upgrade_id'
- description: Response containing an upgrade job identifier
examples:
- upgrade_id: 4316c116-0acb-4c43-8f06-6723154e741e
contentMediaType: application/vnd.api+json
examples:
Example:
value:
upgrade_id: 4316c116-0acb-4c43-8f06-6723154e741e
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/upgrade/{upgrade_id}:
get:
tags:
- Utilities Upgrade
summary: getSiteDeviceUpgrade
description: Get Site Device Upgrade
operationId: getSiteDeviceUpgrade
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: upgrade_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_site_device_upgrade'
- description: Site device upgrade job details
examples:
- canary_phases:
- 1
- 10
- 50
- 100
current_phase: 0
enable_p2p: true
force: false
id: b910de88-0e0e-43a0-b20e-a43aa8788917
max_failure_percentage: 5
max_failures:
- 5
- 5
- 5
- 5
p2p_cluster_size: 10
p2p_parallelism: 2
reboot_at: 1738233315
start_time: 1738232698
status: created
strategy: canary
target_version: 0.14.29633
targets:
downloaded:
- 30783a619182
total: 2
upgraded:
- a8378280da5e
upgrade_plan:
'1':
- 30783a619182
'2':
- a8378280da5e
contentMediaType: application/json
examples:
Example:
value:
canary_phases:
- 1
- 10
- 50
- 100
current_phase: 0
enable_p2p: true
force: false
id: b910de88-0e0e-43a0-b20e-a43aa8788917
max_failure_percentage: 5
max_failures:
- 5
- 5
- 5
- 5
p2p_cluster_size: 10
p2p_parallelism: 2
reboot_at: 1738233315
start_time: 1738232698
status: created
strategy: canary
target_version: 0.14.29633
targets:
downloaded:
- 30783a619182
total: 2
upgraded:
- a8378280da5e
upgrade_plan:
'1':
- 30783a619182
'2':
- a8378280da5e
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_site_device_upgrade'
- description: Site device upgrade job details
examples:
- canary_phases:
- 1
- 10
- 50
- 100
current_phase: 0
enable_p2p: true
force: false
id: b910de88-0e0e-43a0-b20e-a43aa8788917
max_failure_percentage: 5
max_failures:
- 5
- 5
- 5
- 5
p2p_cluster_size: 10
p2p_parallelism: 2
reboot_at: 1738233315
start_time: 1738232698
status: created
strategy: canary
target_version: 0.14.29633
targets:
downloaded:
- 30783a619182
total: 2
upgraded:
- a8378280da5e
upgrade_plan:
'1':
- 30783a619182
'2':
- a8378280da5e
contentMediaType: application/vnd.api+json
examples:
Example:
value:
canary_phases:
- 1
- 10
- 50
- 100
current_phase: 0
enable_p2p: true
force: false
id: b910de88-0e0e-43a0-b20e-a43aa8788917
max_failure_percentage: 5
max_failures:
- 5
- 5
- 5
- 5
p2p_cluster_size: 10
p2p_parallelism: 2
reboot_at: 1738233315
start_time: 1738232698
status: created
strategy: canary
target_version: 0.14.29633
targets:
downloaded:
- 30783a619182
total: 2
upgraded:
- a8378280da5e
upgrade_plan:
'1':
- 30783a619182
'2':
- a8378280da5e
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/upgrade/{upgrade_id}/cancel:
post:
tags:
- Utilities Upgrade
summary: cancelSiteDeviceUpgrade
description: Best effort to cancel an upgrade. Devices which are already upgraded wont be touched
operationId: cancelSiteDeviceUpgrade
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: upgrade_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/versions:
get:
tags:
- Utilities Upgrade
summary: listSiteAvailableDeviceVersions
description: List firmware versions available for devices in a site, optionally filtered by device type and model. Use [List Org Available Device Versions]($e/Utilities%20Upgrade/listOrgAvailableDeviceVersions) to retrieve available device versions across the organization.
operationId: listSiteAvailableDeviceVersions
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: type
in: query
description: 'Filter results by type. enum: `ap`, `gateway`, `switch`'
style: form
explode: true
schema:
allOf:
- $ref: '#/components/schemas/device_type_default_ap'
- description: 'Filter results by type. enum: `ap`, `gateway`, `switch`'
- name: model
in: query
description: Fetch version for device model, use/combine with `type` as needed (for switch and gateway devices)
style: form
explode: true
schema:
type: string
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/device_version_item'
description: Available firmware versions for device models
examples:
- - model: AP41
tag: suggested
version: v0.1.543
- model: AP21
version: v0.1.545
contentMediaType: application/json
examples:
Example:
value:
- model: AP41
tag: suggested
version: v0.1.543
- model: AP21
version: v0.1.545
application/vnd.api+json:
schema:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/device_version_item'
description: Available firmware versions for device models
examples:
- - model: AP41
tag: suggested
version: v0.1.543
- model: AP21
version: v0.1.545
contentMediaType: application/vnd.api+json
examples:
Example:
value:
- model: AP41
tag: suggested
version: v0.1.543
- model: AP21
version: v0.1.545
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/devices/{device_id}/upgrade:
post:
tags:
- Utilities Upgrade
summary: upgradeDevice
description: Device Upgrade
operationId: upgradeDevice
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/device_upgrade'
- examples:
- version: 3.1.5
contentMediaType: application/json
examples:
Example:
value:
version: 3.1.5
required: false
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_device_upgrade'
- description: Single-device upgrade status response
examples:
- status: inprogress
timestamp: 1428949501
contentMediaType: application/json
examples:
Example:
value:
status: inprogress
timestamp: 1428949501
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_device_upgrade'
- description: Single-device upgrade status response
examples:
- status: inprogress
timestamp: 1428949501
contentMediaType: application/vnd.api+json
examples:
Example:
value:
status: inprogress
timestamp: 1428949501
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/mxedges/upgrade:
get:
tags:
- Utilities Upgrade
summary: listSiteMxEdgeUpgrades
description: List Mist Edge upgrade operations for a site. Use [List Org Mist Edge Upgrades]($e/Utilities%20Upgrade/listOrgMxEdgeUpgrades) to retrieve Mist Edge upgrade operations across the organization.
operationId: listSiteMxEdgeUpgrades
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/response_mxedge_upgrade'
description: Mist Edge upgrade records returned by list upgrade operations
contentMediaType: application/json
application/vnd.api+json:
schema:
type: array
items:
$ref: '#/components/schemas/response_mxedge_upgrade'
description: Mist Edge upgrade records returned by list upgrade operations
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
post:
tags:
- Utilities Upgrade
summary: upgradeSiteMxEdges
description: >-
Upgrade Mist Edges in a Site.
See [Org Mist Edges](/#tag/Utilities-Upgrade/operation/upgradeOrgMxEdges) for package upgrades
See [Org Mist Edges Distro](/#tag/Utilities-Upgrade/operation/upgradeOrgMxEdges) for distro upgrades
operationId: upgradeSiteMxEdges
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/mxedge_upgrade_multi'
- description: Request Body
examples:
- '{"allow_downgrades":{"mxagent":false,"tunterm":true},"canary_phases":[5,25,50,100],"channel":"stable","max_failure_percentage":5,"max_failures":[1,1,5,5],"mxedge_ids":["387804a7-3474-85ce-15a2-f9a9684c9c90"],"start_time":1624399840,"strategy":"serial","versions":{"mxagent":"latest","radsecproxy":"","tunterm":"default"}}'
- '{"canary_phases":[5,25,50,100],"distro":"buster","max_failure_percentage":5,"max_failures":[1,1,5,5],"mxedge_ids":["387804a7-3474-85ce-15a2-f9a9684c9c90"],"start_time":1624399840,"strategy":"serial"}'
contentMediaType: application/json
examples:
Upgrade_MxEdge:
value:
allow_downgrades:
mxagent: false
tunterm: true
canary_phases:
- 5
- 25
- 50
- 100
channel: stable
max_failure_percentage: 5
max_failures:
- 1
- 1
- 5
- 5
mxedge_ids:
- 387804a7-3474-85ce-15a2-f9a9684c9c90
start_time: 1624399840
strategy: serial
versions:
mxagent: latest
radsecproxy:
tunterm: default
Upgrade_MxEdge_Distro:
value:
canary_phases:
- 5
- 25
- 50
- 100
distro: buster
max_failure_percentage: 5
max_failures:
- 1
- 1
- 5
- 5
mxedge_ids:
- 387804a7-3474-85ce-15a2-f9a9684c9c90
start_time: 1624399840
strategy: serial
required: false
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/mxedges/upgrade/{upgrade_id}:
get:
tags:
- Utilities Upgrade
summary: getSiteMxEdgeUpgrade
description: Get Mist Edge Upgrade
operationId: getSiteMxEdgeUpgrade
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: upgrade_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_mxedge_upgrade'
- description: Mist Edge upgrade details response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_mxedge_upgrade'
- description: Mist Edge upgrade details response
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
put:
tags:
- Utilities Upgrade
summary: updateSiteMxEdgeUpgrade
description: Update Mist Edge Upgrade. Only upgrades in `queued` state can be updated.
operationId: updateSiteMxEdgeUpgrade
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: upgrade_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: Request Body
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/mxedge_upgrade_multi'
- description: Request Body
contentMediaType: application/json
required: false
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_mxedge_upgrade'
- description: Mist Edge upgrade details response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_mxedge_upgrade'
- description: Mist Edge upgrade details response
contentMediaType: application/vnd.api+json
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/mxedges/upgrade/{upgrade_id}/cancel:
post:
tags:
- Utilities Upgrade
summary: cancelSiteMxEdgeUpgrade
description: Cancel Mist Edge Upgrade. Best effort to cancel an upgrade. MxEdges which are already upgraded won't be touched.
operationId: cancelSiteMxEdgeUpgrade
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: upgrade_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/ssr/upgrade/{upgrade_id}:
get:
tags:
- Utilities Upgrade
summary: getSiteSsrUpgrade
description: Get Specific Site SSR Upgrade
operationId: getSiteSsrUpgrade
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: upgrade_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
responses:
'200':
description: OK
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_ssr_upgrade_status'
- description: Detailed status for an SSR firmware upgrade job
examples:
- channel: stable
device_type: gateway
id: 5cbcee0a-c620-4bb4-a25e-15000934e9d8
status: upgrading
targets:
failed: []
queued: []
success: []
upgrading:
- 8e525f1d-4178-4ae1-a988-2b0176855e55
versions: {}
contentMediaType: application/json
examples:
Example:
value:
channel: stable
device_type: gateway
id: 5cbcee0a-c620-4bb4-a25e-15000934e9d8
status: upgrading
targets:
failed: []
queued: []
success: []
upgrading:
- 8e525f1d-4178-4ae1-a988-2b0176855e55
versions: {}
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_ssr_upgrade_status'
- description: Detailed status for an SSR firmware upgrade job
examples:
- channel: stable
device_type: gateway
id: 5cbcee0a-c620-4bb4-a25e-15000934e9d8
status: upgrading
targets:
failed: []
queued: []
success: []
upgrading:
- 8e525f1d-4178-4ae1-a988-2b0176855e55
versions: {}
contentMediaType: application/vnd.api+json
examples:
Example:
value:
channel: stable
device_type: gateway
id: 5cbcee0a-c620-4bb4-a25e-15000934e9d8
status: upgrading
targets:
failed: []
queued: []
success: []
upgrading:
- 8e525f1d-4178-4ae1-a988-2b0176855e55
versions: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
/api/v1/sites/{site_id}/ssr/{device_id}/upgrade:
post:
tags:
- Utilities Upgrade
summary: upgradeSsr
description: Upgrade Site SSR device
operationId: upgradeSsr
parameters:
- name: site_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
- name: device_id
in: path
description: ''
required: true
schema:
type: string
contentEncoding: uuid
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
requestBody:
description: ''
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ssr_upgrade'
- examples:
- channel: stable
version: 5.3.1-170-93
contentMediaType: application/json
examples:
Example:
value:
channel: stable
version: 5.3.1-170-93
required: false
responses:
'200':
description: Example response
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_ssr_upgrade'
- description: SSR firmware upgrade job summary
examples:
- channel: stable
counts:
failed: 0
queued: 1
success: 0
upgrading: 1
device_type: gateway
id: ceef2c8a-e2e6-447a-8b27-cb4f3ec1adae
status: upgrading
strategy: serial
versions: {}
contentMediaType: application/json
examples:
Example:
value:
channel: stable
counts:
failed: 0
queued: 1
success: 0
upgrading: 1
device_type: gateway
id: ceef2c8a-e2e6-447a-8b27-cb4f3ec1adae
status: upgrading
strategy: serial
versions: {}
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_ssr_upgrade'
- description: SSR firmware upgrade job summary
examples:
- channel: stable
counts:
failed: 0
queued: 1
success: 0
upgrading: 1
device_type: gateway
id: ceef2c8a-e2e6-447a-8b27-cb4f3ec1adae
status: upgrading
strategy: serial
versions: {}
contentMediaType: application/vnd.api+json
examples:
Example:
value:
channel: stable
counts:
failed: 0
queued: 1
success: 0
upgrading: 1
device_type: gateway
id: ceef2c8a-e2e6-447a-8b27-cb4f3ec1adae
status: upgrading
strategy: serial
versions: {}
'400':
description: Bad Syntax
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http400'
- description: Standard HTTP 400 bad request error response
examples:
- detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
'401':
description: Unauthorized
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/json
examples:
Example:
value:
detail: Authentication credentials were not provided.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http401'
- description: Standard HTTP 401 authentication error response
examples:
- detail: Authentication credentials were not provided.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Authentication credentials were not provided.
'403':
description: Permission Denied
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/json
examples:
Example:
value:
detail: You do not have permission to perform this action.
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http403'
- description: Standard HTTP 403 permission error response
examples:
- detail: You do not have permission to perform this action.
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: You do not have permission to perform this action.
'404':
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/json
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http404'
- description: Standard HTTP 404 not found error response
contentMediaType: application/vnd.api+json
'429':
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
headers: {}
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
application/vnd.api+json:
schema:
allOf:
- $ref: '#/components/schemas/response_http429'
- description: Standard HTTP 429 rate limit error response
examples:
- detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
contentMediaType: application/vnd.api+json
examples:
Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
deprecated: false
parameters: []
components:
schemas:
aamw_profile:
title: aamw_profile
type: object
properties:
categories:
type: array
items:
$ref: '#/components/schemas/aamw_profile_category'
description: File categories evaluated by this Advanced Anti Malware profile
created_time:
type: number
description: Timestamp when the Advanced Anti Malware profile was created
readOnly: true
fallback_action:
allOf:
- $ref: '#/components/schemas/aamw_profile_action3'
- description: 'Action to take when Sky ATP cannot obtain a malware verdict. enum: `block`, `permit`.'
file_action:
allOf:
- $ref: '#/components/schemas/aamw_profile_action1'
- description: 'Action to take for files that meet or exceed the malware verdict threshold. enum: `block`, `permit`.'
id:
type: string
description: Unique identifier of the Advanced Anti Malware profile
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
modified_time:
type: number
description: Timestamp when the Advanced Anti Malware profile was last modified
readOnly: true
name:
type: string
description: Display name of the Advanced Anti Malware profile
examples:
- aamw-custom
org_id:
type: string
description: Organization that owns this Advanced Anti Malware profile
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
site_id:
type: string
description: Site associated with this derived Advanced Anti Malware profile
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
verdict_threshold:
maximum: 10
minimum: 1
type: integer
description: Minimum Sky ATP verdict score that triggers the configured file action
contentEncoding: int32
default: 8
description: Advanced Anti Malware profile that controls Sky ATP file verdict handling
aamw_profile_action:
title: aamw_profile_action
enum:
- block
- permit
type: string
description: 'Action applied to files by an Advanced Anti Malware profile. enum: `block`, `permit`'
aamw_profile_category:
title: aamw_profile_category
type: object
properties:
category:
allOf:
- $ref: '#/components/schemas/aamw_profile_category_category2'
- description: 'File category covered by this Advanced Anti Malware profile. enum: `archive`, `document`, `pdf`, `executable`, `rich_application`, `library`, `os_package`, `mobile`, `java`, `configuration`, `script`.'
hash_lookup_only:
type: boolean
description: Whether files in this category use hash lookup without full file analysis
default: false
description: File category rule for Advanced Anti Malware inspection
aamw_profile_category_category:
title: aamw_profile_category_category
enum:
- archive
- document
- pdf
- executable
- rich_application
- library
- os_package
- mobile
- java
- configuration
- script
type: string
description: 'enum: `archive`, `document`, `pdf`, `executable`, `rich_application`, `library`, `os_package`, `mobile`, `java`, `configuration`, `script`'
account_cradlepoint_config:
title: account_cradlepoint_config
type: object
properties:
cp_api_id:
type: string
description: Cradlepoint API ID used by Mist for the integration
examples:
- 84446d61-2206-4ea5-855a-0043f980be54
cp_api_key:
type: string
description: Cradlepoint API key paired with the Cradlepoint API ID
examples:
- 79c329da9893e34099c7d8ad5cb9c941
ecm_api_id:
type: string
description: Cradlepoint ECM API ID used by Mist for the integration
examples:
- 73446d61-2206-4ea5-855a-0043f980be62
ecm_api_key:
type: string
description: Cradlepoint ECM API key paired with the ECM API ID
examples:
- 68b329da9893e34099c7d8ad5cb9c9405
enable_lldp:
type: boolean
description: Whether Mist uses Cradlepoint LLDP data to link routers to Mist sites and devices
description: Cradlepoint account credentials and LLDP integration settings
account_crowdstrike_config:
title: account_crowdstrike_config
required:
- client_id
- client_secret
- customer_id
type: object
properties:
client_id:
type: string
description: Customer account api client ID
client_secret:
type: string
description: Customer account api client Secret
customer_id:
type: string
description: Customer id of an admin
description: OAuth linked CrowdStrike apps account details
account_jamf_config:
title: account_jamf_config
required:
- client_id
- client_secret
- instance_url
- smartgroup_name
type: object
properties:
client_id:
type: string
description: Customer account api client id. Required if `app_name`==`crowdstrike`
client_secret:
type: string
description: Customer account api client secret
instance_url:
type: string
description: Customer account Jamf instance URL
examples:
- junipertest.jamfcloud.com
smartgroup_name:
type: string
description: Smart group membership for determining compliance status
examples:
- CompliantGroup1
description: OAuth linked Jamf apps account details
account_jse_config:
title: account_jse_config
required:
- password
- username
type: object
properties:
cloud_name:
type: string
description: JSE cloud hostname used for the integration
examples:
- devcentral.juniperclouds.net
password:
type: string
description: Credential password for the JSE integration user
contentEncoding: password
examples:
- foryoureyesonly
username:
type: string
description: JSE integration username with access to service location, site, and IPsec profile APIs
examples:
- john@abc.com
description: Juniper Security Exchange account credentials used for integration
account_jse_info:
title: account_jse_info
type: object
properties:
cloud_name:
type: string
description: JSE cloud hostname configured for the integration
examples:
- devcentral.juniperclouds.net
org_names:
uniqueItems: true
type: array
items:
type: string
description: JSE organization names associated with the linked account
username:
type: string
description: JSE integration username configured for the linked account
examples:
- john@abc.com
description: Linked Juniper Security Exchange account information
account_juniper_config:
title: account_juniper_config
required:
- password
- username
type: object
properties:
password:
type: string
description: Authentication password for the Juniper account
contentEncoding: password
examples:
- password
username:
type: string
description: Customer account user name
examples:
- john@nmo.com
description: Juniper account credentials used to link the integration
account_juniper_info:
title: account_juniper_info
type: object
properties:
accounts:
type: array
items:
$ref: '#/components/schemas/juniper_account'
description: List of linked Juniper account records
description: Linked Juniper account information returned by the integration
account_mobicontrol_config:
title: account_mobicontrol_config
required:
- client_id
- client_secret
- instance_url
- password
- username
type: object
properties:
client_id:
type: string
description: Customer account Client ID
client_secret:
type: string
description: Customer account Client Secret
instance_url:
type: string
description: Customer account MobiControl instance URL
password:
type: string
description: Customer account password instance URL
contentEncoding: password
username:
type: string
description: Login username used to authenticate to the MobiControl account
description: MobiControl account credentials used for OAuth application linking
account_oauth_config:
title: account_oauth_config
required:
- account_id
type: object
properties:
account_id:
type: string
description: Linked app(zoom/teams/intune) account id
examples:
- iojzXIJWEuiD73ZvydOfg
discard_guest_info:
type: boolean
description: Optional, for Zoom/Teams. Whether to redact identifying information for call participants that are not part of the Zoom/Teams account identified by `account_id`
max_daily_api_requests:
type: integer
description: Zoom daily api request quota, https://developers.zoom.us/docs/api/rest/rate-limits/
contentEncoding: int32
examples:
- 5000
description: OAuth linked apps (zoom/teams/intune) account details
account_oauth_info:
title: account_oauth_info
required:
- accounts
- linked
type: object
properties:
accounts:
type: array
items:
$ref: '#/components/schemas/account_oauth_info_account'
description: Linked third-party application accounts for this OAuth application
authorization_url:
type: string
description: OAuth authorization URL to open when linking an account
readOnly: true
linked:
type: boolean
description: Whether at least one account is linked for this OAuth application
readOnly: true
description: OAuth-linked application account status and authorization details
account_oauth_info_account:
title: account_oauth_info_account
type: object
properties:
account_id:
type: string
description: Linked app account id
readOnly: true
examples:
- iojzXIJWEuiD73ZvydOfg
auto_probe_subnet:
type: string
description: For Prisma accounts only, tunnel auto probe subnet
readOnly: true
examples:
- 11.0.0.0/8
client_id:
type: string
description: Customer account Client ID
readOnly: true
cloud_name:
type: string
description: Name of the company whose account mist has subscribed to
readOnly: true
examples:
- Tapi.sase.paloaltonetworks.com
company:
type: string
description: Name of the company whose account mist has subscribed to
readOnly: true
examples:
- Test Company1 Ltd
enable_probe:
type: boolean
description: For Prisma accounts only, tunnel probe enable/disable
readOnly: true
examples:
- false
error:
type: string
description: This error is provided when the account fails to fetch token/data
readOnly: true
examples:
- OAuth token refresh failed, please re-link your account
errors:
type: array
items:
type: string
description: Problems reported during OAuth token refresh or account data sync
readOnly: true
examples:
- - OAuth token refresh failed, please re-link your account
- API daily rate limit reached for your account
instance_url:
type: string
description: Customer account instance URL
readOnly: true
key_id:
type: string
description: For ZDX Account only, Customer account API key ID
examples:
- L72frZcK3JvrZc
last_status:
type: string
description: Is the last data pull for account is successful or not
readOnly: true
examples:
- failed
last_sync:
type: integer
description: Last data pull timestamp, background jobs that pull account data
contentEncoding: int64
readOnly: true
examples:
- 1665465339000
linked_by:
type: string
description: First name of the user who linked the account
readOnly: true
examples:
- Testname1
linked_timestamp:
type: number
description: Timestamp when this third-party account was linked
readOnly: true
examples:
- 1665465339000
max_daily_api_requests:
type: integer
description: Zoom daily api request quota, https://developers.zoom.us/docs/api/rest/rate-limits/
contentEncoding: int32
readOnly: true
examples:
- 5000
name:
type: string
description: Display name of the linked third-party account or company
readOnly: true
examples:
- Test Compay1 Ltd
password:
type: string
description: Customer account password instance URL
contentEncoding: password
readOnly: true
region:
type: string
description: For Prisma accounts only
readOnly: true
examples:
- americas
regions:
type: object
additionalProperties:
$ref: '#/components/schemas/account_oauth_info_account_region'
description: Prisma Access regions with allocated bandwidth for this linked account
service_account_name:
type: string
description: For Prisma accounts only
readOnly: true
examples:
- Corp SA
service_connections:
type: object
additionalProperties:
$ref: '#/components/schemas/account_oauth_info_account_service_connection'
description: Prisma Access service connections configured for this linked account
smartgroup_name:
type: string
description: Smart group membership for determining compliance status
readOnly: true
examples:
- CompliantGroup1
tsg_id:
type: string
description: For Prisma accounts only, Prisma Tenant Service Group id
readOnly: true
examples:
- '189953456'
username:
type: string
description: Login name configured for the linked third-party account
readOnly: true
webhook_auth_type:
type: string
description: For Crowdstrike, JAMF, SentinelOne and VMWare accounts only
examples:
- Basic
- Bearer
webhook_enabled:
type: boolean
description: For Crowdstrike, JAMF, SentinelOne and VMWare accounts only
webhook_password:
type: string
description: For VMWare accounts only
contentEncoding: password
examples:
- password_1234
webhook_secret:
type: string
description: For Crowdstrike accounts only
contentEncoding: password
examples:
- secret-value
webhook_token:
type: string
description: For JAMF and SentinelOne accounts only
examples:
- token-value
webhook_url:
type: string
description: For Crowdstrike, JAMF, SentinelOne and VMWare accounts only
examples:
- https://websync.nac-staging.mistsys.com/v1/S_org-8dcbe9005/ae9dee49-69e7-4710-a114-5b827a777738/crowdstrike/edr
- https://websync.nac-staging.mistsys.com/v1/S_org-8dcbe9005/ae9dee49-69e7-4710-a114-5b827a777738/jamf/mdm
- https://websync.nac-staging.mistsys.com/v1/S_org-8dcbe9005/00fd8b39-cf92-4b43-a2ff-a461b48e7059/sentinelone/edr
- https://websync.nac-staging.mistsys.com/v1/S_41b2525af1d8dcbe9005/f43ea4c48f22/vmware/mdm
webhook_username:
type: string
description: For VMWare accounts only
examples:
- username_1234
zdx_org_id:
type: string
description: For ZDX Account only, ZDX organization id
examples:
- '123456'
description: OAuth linked apps account info
account_oauth_info_account_region:
title: account_oauth_info_account_region
type: object
properties:
aggregate_region:
type: string
description: Bandwidth Aggregate region for this region
examples:
- us-southwest
allocated_bandwidth:
type: integer
description: Allocated bandwidth for the region, in Mbps
contentEncoding: int32
readOnly: true
examples:
- 1000
name:
type: string
description: Display name for this region
examples:
- US West
description: Prisma Access region bandwidth allocation for a linked OAuth account
account_oauth_info_account_service_connection:
title: account_oauth_info_account_service_connection
type: object
properties:
region:
type: string
description: Prisma Access region where this service connection is provisioned
examples:
- us-southwest
description: Prisma Access service connection region for a linked OAuth account
account_prisma_config:
title: account_prisma_config
required:
- client_id
- client_secret
- tsg_id
type: object
properties:
auto_probe_subnet:
type: string
description: Required If `enable_probe`==`true`. This field will accept an IPv4 cidr and an IP address will be picked from this range to be used as tunnel probe source IP address and as well as BGP neighbour IP address. The subnet should be big enough for num_devices * num_tunnel * 2
examples:
- 11.0.0.0/8
client_id:
type: string
description: Customer account api client ID
client_secret:
type: string
description: Customer account api client Secret
enable_probe:
type: boolean
description: To enable/disable tunnel probe
default: false
tsg_id:
type: string
description: Prisma Tenant Service Group id
description: OAuth linked CrowdStrike apps account details
account_sentinelone_config:
title: account_sentinelone_config
required:
- api_token
- instance_url
type: object
properties:
api_token:
type: string
description: Access token used to authenticate to the SentinelOne account
instance_url:
type: string
description: Customer account SentinelOne instance URL
description: OAuth linked CrowdStrike apps account details
account_skyatp_cloud_name:
title: account_skyatp_cloud_name
enum:
- www.amerskyatp.com
- www.apacskyatp.com
- www.euroskyatp.com
- www.canadaskyatp.com
type: string
description: 'Sky ATP cloud name. enum: `www.amerskyatp.com`, `www.apacskyatp.com`, `www.euroskyatp.com`, `www.canadaskyatp.com`'
examples:
- www.amerskyatp.com
account_skyatp_config:
title: account_skyatp_config
required:
- password
- realm
- username
type: object
properties:
cloud_name:
allOf:
- $ref: '#/components/schemas/account_skyatp_cloud_name1'
- description: 'Sky ATP cloud endpoint used for the integration. enum: `www.amerskyatp.com`, `www.apacskyatp.com`, `www.euroskyatp.com`, `www.canadaskyatp.com`.'
examples:
- www.amerskyatp.com
password:
type: string
description: Credential password for the Sky ATP realm user
contentEncoding: password
examples:
- foryoureyesonly
realm:
type: string
description: Sky ATP realm to create or link with this Mist organization
examples:
- mist-team
username:
type: string
description: Sky ATP username used to create or access the realm
examples:
- john@abc.com
description: Sky ATP account credentials and realm settings used for integration
account_skyatp_data:
title: account_skyatp_data
type: object
properties:
secintel:
allOf:
- $ref: '#/components/schemas/account_skyatp_data_secintel2'
- description: Juniper SecIntel threat feed configuration provided by Sky ATP
secintel_allowlist_url:
type: string
description: URL for the Sky ATP SecIntel allowlist
readOnly: true
examples:
- https://papi.s3.amazonaws.com/secintel_allowlist/xxx...
secintel_blocklist_url:
type: string
description: URL for the Sky ATP SecIntel blocklist
readOnly: true
examples:
- https://papi.s3.amazonaws.com/secintel_blocklist/xxx...
description: Sky ATP SecIntel feed data and generated list URLs
account_skyatp_data_secintel:
title: account_skyatp_data_secintel
type: object
properties:
third_party_threat_feeds:
uniqueItems: true
type: array
items:
type: string
description: Third-party threat feed names enabled for SecIntel
description: >-
juniper secintel_feeds are enabled depending on your license tier: infected_host, geo_ip, attacker_ip, command_and_control.
third party:
* ip-based: block_list, threatfox_ip, feodo_tracker, dshield, tor
* url-based: threatfox_url, urlhaus, open_phish
* domain-based: threatfox_domains
account_skyatp_info:
title: account_skyatp_info
type: object
properties:
cloud_name:
allOf:
- $ref: '#/components/schemas/account_skyatp_cloud_name2'
- description: 'Sky ATP cloud endpoint configured for the integration. enum: `www.amerskyatp.com`, `www.apacskyatp.com`, `www.euroskyatp.com`, `www.canadaskyatp.com`.'
examples:
- www.amerskyatp.com
realm:
type: string
description: Sky ATP realm linked with this Mist organization
examples:
- mist-team
username:
type: string
description: Sky ATP username configured for the linked realm
examples:
- john@abc.com
description: Linked Sky ATP account and realm information
account_vmware_config:
title: account_vmware_config
required:
- client_id
- client_secret
- instance_url
- webhook_enabled
type: object
properties:
client_id:
type: string
description: Customer account Client ID
client_secret:
type: string
description: Customer account Client Secret
instance_url:
type: string
description: Customer account VMware instance URL
webhook_enabled:
type: boolean
description: Enables or disables the webhook integration
description: VMware account credentials and webhook settings for OAuth application linking
account_zdx_config:
title: account_zdx_config
required:
- key_id
- key_secret
- zdx_org_id
type: object
properties:
cloud_name:
type: string
description: ZDX cloud name. Refer https://help.zscaler.com/zdx/getting-started-zdx-api for ZDX cloud name
default: zdxcloud.net
key_id:
type: string
description: Customer account API key ID
examples:
- K35vrZcK3JvrZc
key_secret:
type: string
description: Customer account API key Secret
examples:
- K35vrZcK3JvrZcjjswpp2eii1oo100
zdx_org_id:
type: string
description: Organization identifier assigned to the ZDX account
examples:
- '123456'
description: OAuth linked ZDX apps account details
account_zscaler_config:
title: account_zscaler_config
required:
- cloud_name
- partner_key
- password
- username
type: object
properties:
cloud_name:
type: string
description: Zscaler Internet Access cloud name used for the integration
examples:
- zscalerbeta.net
partner_key:
type: string
description: Zscaler partner key generated for the Mist integration
examples:
- K35vrZcK3JvrZc
password:
type: string
description: Credential password for the Zscaler partner administrator
contentEncoding: password
examples:
- password
username:
type: string
description: Zscaler partner administrator username used by Mist
examples:
- john@nmo.com
description: OAuth linked Zscaler apps account details
account_zscaler_info:
title: account_zscaler_info
type: object
properties:
cloud_name:
type: string
description: Zscaler Internet Access cloud name configured for the integration
examples:
- zscalerbeta.net
partner_key:
type: string
description: Zscaler partner key configured for the Mist integration
examples:
- K35vrZcK3JvrZc
username:
type: string
description: Zscaler partner administrator username configured for Mist
examples:
- john@nmo.com
description: OAuth linked Zscaler apps account details
acl_policy:
title: acl_policy
type: object
properties:
actions:
type: array
items:
$ref: '#/components/schemas/acl_policy_action'
description: Destination tag actions evaluated for sources matching this ACL policy
disabled:
type: boolean
description: Whether this ACL policy is disabled
default: false
name:
type: string
description: Display name of the ACL policy
examples:
- guest access
src_tags:
type: array
items:
type: string
description: Source ACL tags that select traffic for this ACL policy
description: >-
ACL Policy:
- for GBP-based policy, all src_tags and dst_tags have to be gbp-based
- for ACL-based policy, `network` is required in either the source or destination so that we know where to attach the policy to
acl_policy_action:
title: acl_policy_action
required:
- dst_tag
type: object
properties:
action:
allOf:
- $ref: '#/components/schemas/allow_deny4'
- description: Allow or deny decision applied to traffic matching the destination tag
dst_tag:
type: string
description: Destination ACL tag matched by this policy action
examples:
- corp
description: Action applied to traffic that matches a destination ACL tag
acl_tag:
title: acl_tag
required:
- type
type: object
properties:
ether_types:
type: array
items:
type: string
description: Layer 2 EtherTypes matched by this ACL tag; defaults to `any`
default:
- any
gbp_tag:
type: integer
description: >-
Required if
- `type`==`dynamic_gbp` (gbp_tag received from RADIUS)
- `type`==`gbp_resource`
- `type`==`static_gbp` (applying gbp tag against matching conditions)
contentEncoding: int32
macs:
type: array
items:
type: string
description: Client or resource MAC addresses matched by this ACL tag
network:
type: string
description: >-
If:
* `type`==`mac` (optional. default is `any`)
* `type`==`subnet` (optional. default is `any`)
* `type`==`network`
* `type`==`resource` (optional. default is `any`)
* `type`==`static_gbp` if from matching network (vlan)
port_usage:
type: string
description: Required if `type`==`port_usage`. Switch port usage name matched by this ACL tag
radius_group:
type: string
description: >-
Required if:
* `type`==`radius_group`
* `type`==`aruba_user_role`
* `type`==`static_gbp`
if from matching radius_group
specs:
type: array
items:
$ref: '#/components/schemas/acl_tag_spec'
description: Layer 4 protocol and destination-port constraints for this ACL tag
subnets:
type: array
items:
type: string
description: IP subnets matched by this ACL tag
type:
allOf:
- $ref: '#/components/schemas/acl_tag_type2'
- description: 'Classifier type that determines which ACL tag fields are evaluated. enum: `any`, `aruba_user_role`, `dynamic_gbp`, `gbp_resource`, `mac`, `network`, `port_usage`, `radius_group`, `resource`, `static_gbp`, `subnet`.'
description: Resource tags (`type`==`resource` or `type`==`gbp_resource`) can only be used in `dst_tags`
acl_tag_spec:
title: acl_tag_spec
type: object
properties:
port_range:
type: string
description: Matched dst port, "0" means any
default: '0'
protocol:
type: string
description: '`tcp` / `udp` / `icmp` / `icmp6` / `gre` / `any` / `:protocol_number`, `protocol_number` is between 1-254, default is `any` `protocol_number` is between 1-254'
default: any
description: Layer 4 protocol and destination-port match constraint for an ACL tag
acl_tag_type:
title: acl_tag_type
enum:
- any
- aruba_user_role
- dynamic_gbp
- gbp_resource
- mac
- network
- port_usage
- radius_group
- resource
- static_gbp
- subnet
type: string
description: "enum: \n * `any`: matching anything not identified\n * `aruba_user_role`: Aruba user role matched via `radius_group`\n * `dynamic_gbp`: from the gbp_tag received from RADIUS\n * `gbp_resource`: can only be used in `dst_tags`\n * `mac`\n * `network`\n * `port_usage`\n * `radius_group`\n * `resource`: can only be used in `dst_tags`\n * `static_gbp`: applying gbp tag against matching conditions\n * `subnet`'"
admin:
title: admin
type: object
properties:
admin_id:
type: string
description: Unique identifier of the administrator
contentEncoding: uuid
readOnly: true
examples:
- 456b7016-a916-a4b1-78dd-72b947c152b7
compliance_status:
allOf:
- $ref: '#/components/schemas/admin_compliance_status2'
- description: 'Trade compliance status for this administrator. enum: `blocked`, `restricted`.'
email:
type: string
description: If admin account is not an Org API Token
contentEncoding: email
examples:
- jsnow@abc.com
enable_two_factor:
type: boolean
description: If admin account is not an Org API Token
readOnly: true
expire_time:
type: integer
description: Expiration time for the admin invitation, in epoch seconds
contentEncoding: int32
first_name:
type: string
description: If admin account is not an Org API Token. For an invite, this is the original first name used
examples:
- John
hours:
maximum: 168
minimum: 1
type: integer
description: If admin account is not an Org API Token, how long the invite should be valid
contentEncoding: int32
default: 24
last_name:
type: string
description: If admin account is not an Org API Token. For an invite, this is the original last name used
examples:
- Sno
name:
type: string
description: For Org API Token Only
no_tracking:
type:
- boolean
- 'null'
description: Optional, whether to store privacy-consent information. When it doesn’t exist, it’s assumed true on EU (i.e. no tracking, the user has to opt-in); otherwise, the user would have to opt-out
oauth_google:
type: boolean
description: If admin account is not an Org API Token
readOnly: true
password_modified_time:
type: number
description: Password last modified time, in epoch
phone:
type: string
description: If admin account is not an Org API Token. Phone number (numbers only, including country code)
phone2:
type: string
description: If admin account is not an Org API Token. Secondary phone number (numbers only, including country code)
privileges:
minItems: 1
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/admin_privilege'
description: Privilege assignments that define the admin's MSP, organization, site, or site group access
session_expiry:
maximum: 20160
minimum: 10
type: integer
description: Session lifetime for the admin, in minutes
contentEncoding: int64
readOnly: true
examples:
- 1440
tags:
type: array
items:
type: string
description: Read-only tags associated with the admin account
readOnly: true
two_factor_verified:
type: boolean
description: If admin account is not an Org API Token. Two factor status
readOnly: true
via_sso:
type: boolean
description: If admin account is not an Org API Token, an admin login via_sso is more restircted. (password and email cannot be changed)
readOnly: true
description: Mist administrator account or organization API token details
admin_compliance_status:
title: admin_compliance_status
enum:
- blocked
- restricted
type: string
description: 'trade compliance status. enum: `blocked`, `restricted`'
admin_invite:
title: admin_invite
required:
- email
- first_name
- last_name
- org_name
- password
- recaptcha
type: object
properties:
account_only:
type: boolean
description: Skip creating initial setup if true
default: false
allow_mist:
type: boolean
description: Whether to allow Mist to look at this org
default: false
city:
type: string
description: Registration city for the admin user
examples:
- Cupertino
country:
type: string
description: Registration country or region for the admin user, as a name or ISO code
examples:
- United States
email:
maxLength: 64
type: string
description: Registration email address for the admin user
examples:
- test@mistsys.com
first_name:
type: string
description: Given name for the registering admin user
examples:
- John
invite_code:
type: string
description: Invite code used to authorize new admin registration
examples:
- MISTROCKS
last_name:
type: string
description: Family name for the registering admin user
examples:
- Smith
org_name:
type: string
description: Organization name supplied during initial admin registration
examples:
- Smith LLC
password:
type: string
description: Credential password for the registering admin account
contentEncoding: password
examples:
- foryoureyesonly
recaptcha:
type: string
description: CAPTCHA verification token submitted during admin registration
recaptcha_flavor:
allOf:
- $ref: '#/components/schemas/recaptcha_flavor4'
- description: 'CAPTCHA provider flavor used for registration verification. enum: `google`, `hcaptcha`.'
examples:
- hcaptcha
referer_invite_token:
type: string
description: Invite token to apply after account creation
examples:
- Dm2gtT8dwMeM4Bc2E8FLIaA96VHOjPat
return_to:
type: string
description: URL the user should be redirected back to
examples:
- https://mist.zendesk.com/hc/quickstart.pdf
state:
type: string
description: Registration state or province for the admin user, optional depending on country or region
examples:
- CA
street_address:
type: string
description: Street address of registering user
examples:
- 1601 S De Anza Blvd Ste 248
street_address 2:
type: string
description: Street address 2 of registering user
examples:
- 1601 S De Anza Blvd Ste 248
zipcode:
type: string
description: Postal code for the registering admin user
examples:
- '95014'
description: Administrator invitation and initial registration payload
admin_privilege:
title: admin_privilege
required:
- role
- scope
type: object
properties:
msp_id:
type: string
description: Required if `scope`==`msp`. MSP granted by this privilege
contentEncoding: uuid
examples:
- b9d42c2e-88ee-41f8-b798-f009ce7fe909
msp_logo_url:
type: string
description: Logo of the MSP (if the MSP belongs to an Advanced tier)
readOnly: true
msp_name:
type:
- string
- 'null'
description: Name of the MSP (if the org belongs to an MSP)
readOnly: true
msp_url:
type: string
description: Custom url of the MSP (if the MSP belongs to an Advanced tier)
readOnly: true
name:
type: string
description: Display name of the object for this privilege scope
readOnly: true
org_id:
type: string
description: Required if `scope`==`org`. Organization granted by this privilege
contentEncoding: uuid
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
org_name:
type: string
description: Name of the org (for a site belonging to org)
readOnly: true
orggroup_ids:
type: array
items:
type: string
contentEncoding: uuid
description: If `scope`==`orggroup`. Organization groups granted by this privilege
role:
allOf:
- $ref: '#/components/schemas/admin_privilege_role2'
- description: 'Access role granted by this privilege. enum: `admin`, `helpdesk`, `installer`, `read`, `write`.'
scope:
allOf:
- $ref: '#/components/schemas/admin_privilege_scope2'
- description: 'Object scope where this privilege applies. enum: `msp`, `org`, `orggroup`, `site`, `sitegroup`.'
site_id:
type: string
description: Required if `scope`==`site`. Site granted by this privilege
contentEncoding: uuid
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
sitegroup_ids:
type: array
items:
type: string
contentEncoding: uuid
description: If `scope`==`sitegroup`. Site groups granted by this privilege
views:
type: array
items:
$ref: '#/components/schemas/admin_privilege_view'
description: UI view restrictions applied when custom roles limit this privilege
description: Admin privilege scope, role, and UI access settings
admin_privilege_role:
title: admin_privilege_role
enum:
- admin
- helpdesk
- installer
- read
- write
type: string
description: 'access permissions. enum: `admin`, `helpdesk`, `installer`, `read`, `write`'
admin_privilege_scope:
title: admin_privilege_scope
enum:
- msp
- org
- orggroup
- site
- sitegroup
type: string
description: 'enum: `msp`, `org`, `orggroup`, `site`, `sitegroup`'
admin_privilege_view:
title: admin_privilege_view
enum:
- lobby_admin
- location
- marketing
- mxedge_admin
- reporting
- security
- super_observer
- switch_admin
type: string
description: 'UI view name allowed by a custom admin role. enum: `lobby_admin`, `location`, `marketing`, `mxedge_admin`, `reporting`, `security`, `super_observer`, `switch_admin`'
aggregate_route:
title: aggregate_route
type: object
properties:
discard:
type: boolean
description: Whether to install the aggregate route as a discard route
default: false
metric:
maximum: 4294967295
minimum: 0
type:
- integer
- 'null'
description: Routing metric assigned to the aggregate route
contentEncoding: int32
preference:
maximum: 4294967295
minimum: 0
type:
- integer
- 'null'
description: Route preference assigned to the aggregate route
contentEncoding: int32
description: Aggregate route configuration for a network or routing instance
alarm:
title: alarm
required:
- count
- group
- id
- last_seen
- severity
- timestamp
- type
type: object
properties:
ack_admin_id:
type: string
description: UUID of the admin who acked the alarm
contentEncoding: uuid
readOnly: true
examples:
- 456b7016-a916-a4b1-78dd-72b947c152b7
ack_admin_name:
type: string
description: Name & Email ID of the admin who acked the alarm
examples:
- Joe
acked:
type: boolean
description: Whether the alarm is acked or not
examples:
- true
acked_time:
type: integer
description: Epoch (seconds) when the alarm was acked
contentEncoding: int32
readOnly: true
examples:
- 1711031352
aps:
type: array
items:
type: string
description: Access point MAC addresses related to this alarm
examples:
- - ffeeddccbbaa
- ffeeddccbbab
bssids:
type: array
items:
type: string
description: Wireless BSSIDs related to this alarm
count:
type: integer
description: Number of incident within an alarm window
contentEncoding: int32
readOnly: true
examples:
- 2
gateways:
type: array
items:
type: string
description: Gateway MAC addresses related to this alarm
examples:
- - ffeeddccbbaa
- ffeeddccbbab
group:
type: string
description: Category group for this alarm, such as certificate_expiry, infrastructure, marvis, or security
examples:
- security
hostnames:
type: array
items:
type: string
description: Device hostnames related to this alarm
examples:
- - MC_DavidL
- MCM_AP_33_Nishant
id:
type: string
description: Unique identifier of the alarm
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
last_seen:
type: number
description: Epoch (seconds) of the last incident/alarm within an alarm window
readOnly: true
examples:
- 1711031774
note:
type: string
description: Text describing the alarm
org_id:
type: string
description: Organization associated with this alarm
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
resolved_time:
type: integer
description: Epoch (seconds) of the resolved_time for the alarm
contentEncoding: int32
severity:
type: string
description: Impact level assigned to this alarm, such as critical, warn, or info
examples:
- critical
site_id:
type: string
description: Site associated with this alarm
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
ssids:
type: array
items:
type: string
description: Wireless SSIDs related to this alarm
status:
allOf:
- $ref: '#/components/schemas/alarm_status2'
- description: 'Current lifecycle status of this alarm. enum: `open`, `resolved`.'
switches:
type: array
items:
type: string
description: Switch MAC addresses related to this alarm
examples:
- - ffeeddccbbaa
- ffeeddccbbab
timestamp:
type: number
description: Time when the alarm was raised, in epoch seconds
readOnly: true
type:
type: string
description: Key-name of the alarm type
readOnly: true
examples:
- rogue_client
description: Additional information per alarm type
alarm_ack:
title: alarm_ack
required:
- alarm_ids
type: object
properties:
alarm_ids:
type: array
items:
type: string
contentEncoding: uuid
description: Alarm identifiers to acknowledge or unacknowledge
examples:
- - ccb8c94d-ca56-4075-932f-1f2ab444ff2c
- 98ff4a3d-ec9b-4138-a42e-54fc3335179d
note:
type: string
description: Some text note describing the intent
examples:
- maintenance window
description: Request body for acknowledging or unacknowledging alarms
alarm_count_distinct:
title: alarm_count_distinct
enum:
- acked
- group
- severity
- type
type: string
description: 'enum: `acked`, `group`, `severity`, `type`'
alarm_group:
title: alarm_group
enum:
- certificate_expiry
- infrastructure
- marvis
- security
type: string
description: 'Alarm group. enum: `certificate_expiry`, `infrastructure`, `marvis`, `security`'
alarm_search_result:
title: alarm_search_result
required:
- end
- limit
- results
- start
- total
type: object
properties:
component:
type: string
description: Alarm component matched by the search result
end:
type: integer
description: Upper bound of the alarm search window, in epoch seconds
contentEncoding: int32
examples:
- 1711035686
limit:
type: integer
description: Maximum number of alarm results returned
contentEncoding: int32
examples:
- 10
next:
type: string
description: URL for the next page of alarm search results
examples:
- /api/v1/orgs/b3b9f5e6-67b1-4112-9b4c-6824c565eaeb/alarms/search?end=1711035686&limit=10&search_after=%5B1711031354000%2C+%2256bfa7af-b2db-43ee-a4c8-9b820bbba0e1%22%5D&start=1710949286
page:
type: integer
description: Current page number for paginated alarm search results
contentEncoding: int32
examples:
- 1
results:
type: array
items:
$ref: '#/components/schemas/alarm'
description: Alarm records returned for this search
start:
type: integer
description: Lower bound of the alarm search window, in epoch seconds
contentEncoding: int32
examples:
- 1710949286
total:
type: integer
description: Number of alarm records matching the search
contentEncoding: int32
examples:
- 232
description: Paginated response returned by an alarm search
alarm_severity:
title: alarm_severity
enum:
- critical
- info
- warn
type: string
description: 'Severity of the alarm. enum: `critical`, `info`, `warn`'
alarm_status:
title: alarm_status
enum:
- open
- resolved
type: string
description: 'Current lifecycle status of this alarm. enum: `open`, `resolved`'
alarm_template:
title: alarm_template
required:
- delivery
- rules
type: object
properties:
created_time:
type: number
description: Timestamp when the alarm template was created
readOnly: true
delivery:
allOf:
- $ref: '#/components/schemas/delivery3'
- description: Default alarm delivery settings for rules in this template
id:
type: string
description: Unique identifier of the alarm template
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
modified_time:
type: number
description: Timestamp when the alarm template was last modified
readOnly: true
name:
type: string
description: Some string to name the alarm template
examples:
- default
org_id:
type: string
description: Organization that owns this alarm template
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
rules:
type: object
additionalProperties:
$ref: '#/components/schemas/alarm_template_rule'
description: Alarm Rules object to configure the individual alarm keys/types. Property key is the alarm name.
examples:
- ap_offline:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
bad_cable:
delivery:
additional_emails:
- string
enabled: true
to_org_admins: true
to_site_admins: true
enabled: true
description: Alarm template defining default delivery and per-alarm rules
alarm_template_rule:
title: alarm_template_rule
type: object
properties:
delivery:
allOf:
- $ref: '#/components/schemas/delivery1'
- description: Overrides for the alarm template delivery defaults for this alarm rule
enabled:
type: boolean
description: Whether this alarm rule is enabled in the template
description: Per-alarm enablement and delivery override in an alarm template
alarms:
title: alarms
required:
- alarm_ids
type: object
properties:
alarm_ids:
type: array
items:
type: string
contentEncoding: uuid
description: Alarm identifiers to acknowledge or unacknowledge
note:
type: string
description: Some text note describing the intent
description: Alarm identifiers and optional note used for bulk alarm state changes
allow_deny:
title: allow_deny
enum:
- allow
- deny
type: string
description: 'Policy action value that either allows or denies matching traffic. enum: `allow`, `deny`'
anomaly:
title: anomaly
required:
- events
- sle_baseline
- sle_deviation
- timestamp
type: object
properties:
events:
type: array
items:
type: string
description: Event names contributing to this anomaly
readOnly: true
since:
type: number
description: Timestamp when the anomalous period began
readOnly: true
sle_baseline:
type: number
description: Expected SLE value used as the anomaly baseline
readOnly: true
sle_deviation:
type: number
description: Difference between the observed SLE value and the baseline
readOnly: true
timestamp:
type: number
description: Time when this anomaly data point was recorded, in epoch seconds
readOnly: true
description: SLE anomaly data point with baseline, deviation, and contributing events
antenna_select:
title: antenna_select
enum:
- external
- internal
type: string
description: 'Antenna Mode for AP which supports selectable antennas. enum: `""` (default), `external`, `internal`'
examples:
- external
aos_register_cmd:
title: aos_register_cmd
type: object
properties:
cli_commands:
type: string
description: AOS-specific CLI commands that can be copied and pasted directly into an AOS device to register it with Mist. Includes registration code and configuration commands.
description: AOS Brownfield Registration Commands
aoscx_register_cmd:
title: aoscx_register_cmd
type: object
properties:
cli_commands:
type: string
description: AOSCX-specific CLI commands that can be copied and pasted directly into an AOSCX device to register it with Mist
description: AOSCX Brownfield Registration Commands
ap_aeroscout:
title: ap_aeroscout
type: object
properties:
enabled:
type: boolean
description: Whether to enable aeroscout config
default: false
host:
type:
- string
- 'null'
description: Required if enabled, aeroscout server host
examples:
- aero.pvt.net
locate_connected:
type: boolean
description: Whether to enable the feature to allow wireless clients data received and sent to AES server for location calculation
default: false
port:
type:
- integer
- 'null'
description: Optional if enabled, Aeroscout server port. Defaults to 1144
contentEncoding: int32
default: 1144
description: AeroScout location integration settings applied to an AP or AP profile
ap_airista:
title: ap_airista
type: object
properties:
enabled:
type: boolean
description: Whether to enable Airista config
default: false
host:
type:
- string
- 'null'
description: Required if enabled, Airista server host
examples:
- airista.pvt.net
port:
type:
- integer
- 'null'
description: Optional if enabled, Airista server port. Defaults to 1144
contentEncoding: int32
default: 1144
description: Airista RTLS integration settings for an AP
ap_centrak:
title: ap_centrak
type: object
properties:
enabled:
type: boolean
description: Whether to enable Centrak config
default: false
description: CenTrak integration settings for an AP
ap_client_bridge:
title: ap_client_bridge
type: object
properties:
auth:
allOf:
- $ref: '#/components/schemas/ap_client_bridge_auth2'
- description: Credentials and security mode used when the AP connects as a wireless client bridge
enabled:
type: boolean
description: >-
When acted as client bridge:
* only 5G radio can be used
* will not serve as AP on any radios
default: false
ssid:
minLength: 1
type: string
description: Uplink SSID used by the AP when client bridge mode is enabled
examples:
- Uplink-SSID
description: AP client bridge mode configuration
ap_client_bridge_auth:
title: ap_client_bridge_auth
type: object
properties:
psk:
maxLength: 63
minLength: 8
type: string
description: Pre-shared key used when `type`==`psk` for client bridge authentication
examples:
- foryoureyesonly
type:
allOf:
- $ref: '#/components/schemas/ap_client_bridge_auth_type2'
- minLength: 1
description: 'Authentication mode for the client bridge connection. enum: `open`, `psk`.'
examples:
- psk
description: Authentication settings for the AP client bridge uplink
ap_client_bridge_auth_type:
title: ap_client_bridge_auth_type
enum:
- open
- psk
type: string
description: 'wpa2-AES/CCMPp is assumed when `type`==`psk`. enum: `open`, `psk`'
examples:
- psk
ap_esl_config:
title: ap_esl_config
type: object
properties:
cacert:
type: string
description: Only if `type`==`imagotag` or `type`==`native`
examples:
- >
--BEGIN CERTIFICATE--
MIIDXTCCAkWgAwIBAgIJAL5b1z4f3k2TMA0GCSqGSIb3DQEBCwUAMIGVMQsw
channel:
type: integer
description: Only if `type`==`imagotag` or `type`==`native`
contentEncoding: int32
examples:
- 3
enabled:
type: boolean
description: usb_config is ignored if esl_config enabled
default: false
host:
type: string
description: Only if `type`==`imagotag` or `type`==`native`
examples:
- 1.1.1.1
port:
type: integer
description: Only if `type`==`imagotag` or `type`==`native`
contentEncoding: int32
examples:
- 0
type:
allOf:
- $ref: '#/components/schemas/ap_esl_type2'
- description: 'ESL integration type to enable on the AP. enum: `hanshow`, `imagotag`, `native`, `solum`.'
examples:
- imagotag
verify_cert:
type: boolean
description: Only if `type`==`imagotag` or `type`==`native`
examples:
- true
vlan_id:
type: integer
description: Only if `type`==`solum` or `type`==`hanshow`
contentEncoding: int32
default: 1
description: Electronic shelf label integration settings for an AP
ap_esl_type:
title: ap_esl_type
enum:
- hanshow
- imagotag
- native
- solum
type: string
description: 'note: ble_config will be ignored if esl_config is enabled and with native mode. enum: `hanshow`, `imagotag`, `native`, `solum`'
examples:
- imagotag
device_ap:
title: device_ap
required:
- type
type: object
properties:
aeroscout:
allOf:
- $ref: '#/components/schemas/ap_aeroscout1'
- description: Location integration settings for AeroScout on this access point
airista:
allOf:
- $ref: '#/components/schemas/ap_airista1'
- description: Location integration settings for Airista on this access point
ble_config:
allOf:
- $ref: '#/components/schemas/ble_config4'
- description: Bluetooth Low Energy beacon and asset settings for this access point
centrak:
allOf:
- $ref: '#/components/schemas/ap_centrak1'
- description: Location integration settings for Centrak on this access point
client_bridge:
allOf:
- $ref: '#/components/schemas/ap_client_bridge1'
- description: Wireless client bridge settings for this access point
created_time:
type: number
description: Timestamp when the access point object was created
readOnly: true
deviceprofile_id:
type:
- string
- 'null'
description: Device profile assigned to this access point
contentEncoding: uuid
examples:
- 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
disable_eth1:
type: boolean
description: Whether to disable eth1 port
default: false
disable_eth2:
type: boolean
description: Whether to disable eth2 port
default: false
disable_eth3:
type: boolean
description: Whether to disable eth3 port
default: false
disable_module:
type: boolean
description: Whether to disable module port
default: false
enable_unii_4:
type: boolean
description: Whether U-NII-4 channels (169, 173, 177) are enabled on this access point
default: false
esl_config:
allOf:
- $ref: '#/components/schemas/ap_esl_config1'
- description: Electronic shelf label integration settings for this access point
flow_control:
type: boolean
description: For some AP models, flow_control can be enabled to address some switch compatibility issue
default: false
for_site:
type: boolean
description: Whether the access point configuration is scoped directly to a site
readOnly: true
height:
type: number
description: Installation height of the AP, in meters
examples:
- 2.75
id:
type: string
description: Unique identifier of the access point object
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
image1_url:
type:
- string
- 'null'
description: First custom image URL associated with the access point
image2_url:
type:
- string
- 'null'
description: Second custom image URL associated with the access point
image3_url:
type:
- string
- 'null'
description: Third custom image URL associated with the access point
iot_config:
allOf:
- $ref: '#/components/schemas/ap_iot3'
- description: Digital and analog IoT pin settings for this access point
ip_config:
allOf:
- $ref: '#/components/schemas/ap_ip_config4'
- description: Management IP addressing settings for this access point
lacp_config:
allOf:
- $ref: '#/components/schemas/device_ap_lacp_config3'
- description: Link aggregation settings for supported AP Ethernet uplinks
led:
allOf:
- $ref: '#/components/schemas/ap_led5'
- description: Indicator light behavior settings for this access point
locked:
type: boolean
description: Whether this map is considered locked down
mac:
type: string
description: Access point MAC address used to identify the device
readOnly: true
map_id:
type: string
description: Map where the device belongs to
contentEncoding: uuid
examples:
- 63eda950-c6da-11e4-a628-60f81dd250cc
mesh:
allOf:
- $ref: '#/components/schemas/ap_mesh3'
- description: Wireless mesh role and band settings for this access point
model:
type: string
description: Hardware model reported for the access point
readOnly: true
modified_time:
type: number
description: Timestamp when the access point object was last modified
readOnly: true
mqtt_config:
allOf:
- $ref: '#/components/schemas/ap_mqtt3'
- description: MQTT broker publishing settings for this access point
name:
type: string
description: Configured hostname assigned to the access point
examples:
- conference room
notes:
type: string
description: Any notes about this AP
examples:
- slightly off center
ntp_servers:
uniqueItems: true
type: array
items:
type: string
description: NTP servers used by this access point
org_id:
type: string
description: Organization that owns this access point
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
orientation:
maximum: 359
minimum: 0
type: integer
description: AP orientation in degrees from 0 to 359, where 0 is up and 90 is right
contentEncoding: int32
examples:
- 45
poe_passthrough:
type: boolean
description: Whether to enable power out through module port (for APH) or eth1 (for APL/BT11)
default: false
port_config:
type: object
additionalProperties:
$ref: '#/components/schemas/ap_port_config'
description: eth0 is not allowed here. Property key is the interface(s) name (e.g. `eth1` or `eth1,eth2`). If spcified, this takes predecence over switch_config (switch_config requires user to configure all vlans manually, which is error-prone. thus deprecated)
pwr_config:
allOf:
- $ref: '#/components/schemas/ap_pwr_config3'
- description: Power negotiation and peripheral power settings for this access point
radio_config:
allOf:
- $ref: '#/components/schemas/ap_radio4'
- description: Radio configuration overrides for this access point
serial:
type: string
description: Manufacturer serial number for the access point
readOnly: true
site_id:
type: string
description: Site where this access point is assigned
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
type:
const: ap
type: string
description: 'Device type discriminator for access point records. enum: `ap`.'
readOnly: true
uplink_port_config:
allOf:
- $ref: '#/components/schemas/ap_uplink_port_config4'
- description: Authentication and failover behavior for AP uplink ports
usb_config:
allOf:
- $ref: '#/components/schemas/ap_usb3'
- description: Legacy USB integration settings for this access point
uwb_config:
allOf:
- $ref: '#/components/schemas/ap_uwb_config4'
- description: UWB RTLS / OMLOX asset-visibility settings; overrides the device profile and site-level `uwb_config`
vars:
type: object
additionalProperties:
type: string
description: Variable values that override site variables for this access point
examples:
- RADIUS_IP1: 172.31.2.5
RADIUS_SECRET: 11s64632d
x:
type: number
description: Horizontal map position of the AP, in pixels
examples:
- 53.5
y:
type: number
description: Vertical map position of the AP, in pixels
examples:
- 173.1
zigbee_config:
allOf:
- $ref: '#/components/schemas/ap_zigbee3'
- description: Zigbee radio and network settings for this access point
description: Access point configuration and placement data
ap_iot:
title: ap_iot
type: object
properties:
A1:
allOf:
- $ref: '#/components/schemas/ap_iot_output6'
- description: Analog-capable IoT pin A1 output settings
A2:
allOf:
- $ref: '#/components/schemas/ap_iot_output1'
- description: Analog-capable IoT pin A2 output settings
A3:
allOf:
- $ref: '#/components/schemas/ap_iot_output2'
- description: Analog-capable IoT pin A3 output settings
A4:
allOf:
- $ref: '#/components/schemas/ap_iot_output3'
- description: Analog-capable IoT pin A4 output settings
DI1:
allOf:
- $ref: '#/components/schemas/ap_iot_input3'
- description: Digital input pin DI1 settings
DI2:
allOf:
- $ref: '#/components/schemas/ap_iot_input1'
- description: Digital input pin DI2 settings
DO:
allOf:
- $ref: '#/components/schemas/ap_iot_output4'
- description: Digital output pin DO settings
description: Digital and analog IoT port settings applied to an AP or AP profile
ap_iot_input:
title: ap_iot_input
type: object
properties:
enabled:
type: boolean
description: Whether to enable a pin
default: false
name:
type: string
description: Optional; descriptive pin name
examples:
- motion
pullup:
allOf:
- $ref: '#/components/schemas/ap_iot_pullup1'
- description: 'Selects the pull-up resistor mode applied to the input pin. enum: `external`, `internal`, `none`.'
description: IoT Input AP settings
ap_iot_output:
title: ap_iot_output
type: object
properties:
enabled:
type: boolean
description: Whether to enable a pin
default: false
name:
type: string
description: Optional; descriptive pin name
examples:
- motion
output:
type: boolean
description: Whether the pin is configured as an output. DO and A1-A4 can be repurposed by changing
examples:
- true
pullup:
allOf:
- $ref: '#/components/schemas/ap_iot_pullup3'
- description: 'Selects the pull-up resistor mode applied to the output pin. enum: `external`, `internal`, `none`.'
value:
type: integer
description: Output pin signal level, default 0
contentEncoding: int32
examples:
- 0
description: IoT output AP settings
ap_iot_pullup:
title: ap_iot_pullup
enum:
- external
- internal
- none
type: string
description: 'the type of pull-up the pin uses. enum: `external`, `internal`, `none`'
ap_ip_config:
title: ap_ip_config
type: object
properties:
dns:
type: array
items:
type: string
description: If `type`==`static`. DNS server IP addresses for AP management traffic
examples:
- - 8.8.8.8
- 4.4.4.4
dns_suffix:
type: array
items:
type: string
description: If `type`==`static`. DNS search suffixes applied to AP management lookups
examples:
- - .mist.local
- .mist.com
gateway:
type: string
description: Required if `type`==`static`. IPv4 default gateway for AP management traffic
contentEncoding: ipv4
examples:
- 10.2.1.254
gateway6:
type: string
description: Required if `type6`==`static`. IPv6 default gateway for AP management traffic when static IPv6 addressing is used
contentEncoding: ipv6
examples:
- 2607:f8b0:4005:808::1
ip:
type: string
description: Required if `type`==`static`. Static IPv4 address for the AP management interface
contentEncoding: ipv4
examples:
- 10.2.1.1
ip6:
type: string
description: Required if `type6`==`static`. Static IPv6 address for the AP management interface
contentEncoding: ipv6
examples:
- 2607:f8b0:4005:808::2004
mtu:
type: integer
description: Maximum transmission unit for AP management traffic
contentEncoding: int32
examples:
- 0
netmask:
type: string
description: Required if `type`==`static`. IPv4 netmask for the AP management interface
examples:
- 255.255.255.0
netmask6:
type: string
description: Required if `type6`==`static`. IPv6 prefix length for the AP management interface
examples:
- /32
type:
allOf:
- $ref: '#/components/schemas/ip_type13'
- description: 'IPv4 address assignment mode for AP management traffic. enum: `dhcp`, `static`.'
examples:
- static
type6:
allOf:
- $ref: '#/components/schemas/ip_type64'
- description: 'IPv6 address assignment mode for AP management traffic. enum: `autoconf`, `dhcp`, `disabled`, `static`.'
examples:
- static
vlan_id:
type: integer
description: Management VLAN ID, default is 1 (untagged)
contentEncoding: int32
default: 1
examples:
- 1
description: Management IP addressing settings for an access point
ap_led:
title: ap_led
type: object
properties:
brightness:
maximum: 255
minimum: 0
type: integer
description: Indicator LED brightness level from 0 to 255
contentEncoding: int32
default: 255
examples:
- 255
enabled:
type: boolean
description: Whether the AP indicator LED is enabled
default: true
description: Indicator light settings for an access point
ap_mesh:
title: ap_mesh
type: object
properties:
bands:
type: array
items:
$ref: '#/components/schemas/dot11_band'
description: Radio bands allowed for AP mesh links
enabled:
type: boolean
description: Whether mesh is enabled on this AP
default: false
group:
maximum: 9
minimum: 1
type:
- integer
- 'null'
description: Mesh group, base AP(s) will only allow remote AP(s) in the same mesh group to join, 1-9, optional
contentEncoding: int32
examples:
- 1
role:
allOf:
- $ref: '#/components/schemas/ap_mesh_role2'
- description: Mesh role for this AP, either base or remote
examples:
- base
use_wpa3_on_5:
type: boolean
description: Whether to use WPA3 on the 5 GHz band for mesh links
default: false
description: Wireless mesh settings for an access point
dot11_band:
title: dot11_band
enum:
- '24'
- '5'
- 5-dedicated
- 5-selectable
- '6'
- 6-dedicated
- 6-selectable
type: string
description: 'enum: `24`, `5`, `5-dedicated`, `5-selectable`, `6`, `6-dedicated`, `6-selectable`'
ap_mesh_role:
title: ap_mesh_role
enum:
- base
- remote
type: string
description: 'Mesh role for this AP, either base or remote. enum: `base`, `remote`'
examples:
- base
ap_mqtt:
title: ap_mqtt
type: object
properties:
broker_host:
type: string
description: MQTT broker hostname or IP address; required when `enabled` is `true`
broker_port:
type: integer
description: MQTT broker port; defaults to `1883` for `tcp` and `8883` for `ssl`
contentEncoding: int32
broker_proto:
allOf:
- $ref: '#/components/schemas/ap_mqtt_broker_proto2'
- description: 'MQTT broker transport protocol. enum: `ssl`, `tcp`.'
default_topic:
type: string
description: Optional catch-all MQTT topic; BLE advertisements matching no AssetFilter are published here
examples:
- mist/asset/raw
enabled:
type: boolean
description: Whether to enable MQTT publishing
default: false
format:
allOf:
- $ref: '#/components/schemas/ap_mqtt_format2'
- description: 'Payload format for published messages. enum: `json`, `raw`.'
password:
type: string
description: Optional MQTT password; masked in GET responses
contentEncoding: password
username:
type: string
description: Optional MQTT username
description: MQTT publishing configuration for an AP. Use `mqtt_topic` on individual AssetFilter entries to specify which MQTT topic each matching BLE advertisement is forwarded to. Only AssetFilters with `mqtt_topic` set are used; disabled filters and filters without `mqtt_topic` are skipped. Set `default_topic` to publish advertisements that match no AssetFilter to a catch-all topic, allowing MQTT to be used without configuring any AssetFilter.
ap_mqtt_broker_proto:
title: ap_mqtt_broker_proto
enum:
- ssl
- tcp
type: string
description: 'MQTT broker transport protocol. enum: `ssl`, `tcp`'
ap_mqtt_format:
title: ap_mqtt_format
enum:
- json
- raw
type: string
description: 'Payload format for MQTT published messages. enum: `json`, `raw`'
ap_port_config:
title: ap_port_config
type: object
properties:
disabled:
type: boolean
description: Whether this AP Ethernet port is disabled
default: false
dynamic_vlan:
allOf:
- $ref: '#/components/schemas/ap_port_config_dynamic_vlan2'
- description: RADIUS-assigned VLAN settings for AP port authentication
enable_mac_auth:
type: boolean
description: Whether MAC authentication is enabled on this AP port
default: false
forwarding:
allOf:
- $ref: '#/components/schemas/ap_port_config_forwarding2'
- description: 'Traffic forwarding mode for this AP Ethernet port. enum: `all`, `limited`, `mxtunnel`, `site_mxedge`, `wxtunnel`.'
examples:
- all
mac_auth_preferred:
type: boolean
description: When `true`, we'll do dot1x then mac_auth. enable this to prefer mac_auth
default: false
mac_auth_protocol:
allOf:
- $ref: '#/components/schemas/ap_port_config_mac_auth_protocol2'
- description: 'Protocol used for MAC authentication when `enable_mac_auth` is `true`. enum: `eap-md5`, `eap-peap`, `pap`.'
mist_nac:
allOf:
- $ref: '#/components/schemas/wlan_mist_nac3'
- description: Juniper Mist NAC settings used by AP port authentication
mx_tunnel_id:
type: string
description: If `forwarding`==`mxtunnel`, vlan_ids comes from mxtunnel
contentEncoding: uuid
examples:
- 08cd7499-5841-51c8-e663-fb16b6f3b45e
mxtunnel_name:
type: string
description: If `forwarding`==`site_mxedge`, vlan_ids comes from site_mxedge (`mxtunnel` under site setting)
port_auth:
allOf:
- $ref: '#/components/schemas/ap_port_config_port_auth2'
- description: 'Authentication mode for this AP Ethernet port. enum: `dot1x`, `none`.'
examples:
- none
port_vlan_id:
maximum: 4094
minimum: 1
type: integer
description: If `forwarding`==`limited`. VLAN ID allowed on this AP Ethernet port
contentEncoding: int32
examples:
- 1
radius_config:
allOf:
- $ref: '#/components/schemas/radius_config2'
- description: RADIUS authentication and accounting settings for this AP port
radsec:
allOf:
- $ref: '#/components/schemas/radsec3'
- description: TLS-secured RADIUS settings for this AP port
vlan_id:
maximum: 4094
minimum: 1
type: integer
description: >-
Optional to specify the VLAN ID for a tunnel if forwarding is for `wxtunnel`, `mxtunnel` or `site_mxedge`.
* if vlan_id is not specified then it will use first one in vlan_ids[] of the mxtunnel.
* if forwarding == site_mxedge, vlan_ids comes from site_mxedge (`mxtunnel` under site setting)
contentEncoding: int32
examples:
- 9
vlan_ids:
type: string
description: If `forwarding`==`limited`, comma separated list of additional VLAN IDs allowed on this port
examples:
- 10,20,30
wxtunnel_id:
type: string
description: If `forwarding`==`wxtunnel`, the port is bridged to the vlan of the session
contentEncoding: uuid
examples:
- 7dae216d-7c98-a51b-e068-dd7d477b7216
wxtunnel_remote_id:
type: string
description: If `forwarding`==`wxtunnel`, the port is bridged to the vlan of the session
examples:
- wifiguest
description: Ethernet port behavior settings for an access point
ap_port_config_dynamic_vlan:
title: ap_port_config_dynamic_vlan
type: object
properties:
default_vlan_id:
maximum: 4094
minimum: 1
type: integer
description: Fallback VLAN ID used when RADIUS does not return a dynamic VLAN match
contentEncoding: int32
examples:
- 999
enabled:
type: boolean
description: Whether dynamic VLAN assignment is enabled for this AP port
type:
allOf:
- $ref: '#/components/schemas/ap_port_config_dynamic_vlan_type2'
- description: 'Mapping mode for interpreting dynamic VLAN attributes returned by RADIUS. enum: `airespace-interface-name`, `standard`.'
vlans:
type: object
additionalProperties:
type: string
nullable: true
description: Mapping entries for RADIUS-assigned VLAN values on this AP port. For `type`==`airespace-interface-name`, the property key is the Airespace interface name returned by RADIUS (e.g. "guest"), and the value is the corresponding VLAN ID (e.g. 100). For `type`==`standard`, the property key is the VLAN ID number returned by RADIUS, and the value is ignored.
examples:
- 1-10: null
user: 10
description: Dynamic VLAN assignment settings for AP port authentication
ap_port_config_dynamic_vlan_type:
title: ap_port_config_dynamic_vlan_type
enum:
- airespace-interface-name
- standard
type: string
description: 'Mapping mode for interpreting dynamic VLAN attributes returned by RADIUS.\ \ enum: `airespace-interface-name`, where the VLAN is determined by parsing\ \ the RADIUS attribute as an Airespace interface name (e.g. "guest"\ \ would map to VLAN 100), or `standard`, where the VLAN is determined by parsing\ \ the RADIUS attribute as a standard VLAN ID number'
ap_port_config_forwarding:
title: ap_port_config_forwarding
enum:
- all
- limited
- mxtunnel
- site_mxedge
- wxtunnel
type: string
description: "enum: \n * `all`: local breakout, All VLANs\n * `limited`: local breakout, only the VLANs configured in `port_vlan_id` and `vlan_ids`\n * `mxtunnel`: central breakout to an Org Mist Edge (requires `mxtunnel_id`)\n * `site_mxedge`: central breakout to a Site Mist Edge (requires `mxtunnel_name`)\n * `wxtunnel`': central breakout to an Org WxTunnel (requires `wxtunnel_id`)"
examples:
- all
ap_port_config_mac_auth_protocol:
title: ap_port_config_mac_auth_protocol
enum:
- eap-md5
- eap-peap
- pap
type: string
description: 'if `enable_mac_auth`==`true`, allows user to select an authentication protocol. enum: `eap-md5`, `eap-peap`, `pap`'
ap_port_config_port_auth:
title: ap_port_config_port_auth
enum:
- dot1x
- none
type: string
description: 'When doing port auth. enum: `dot1x`, `none`'
examples:
- none
ap_pwr_config:
title: ap_pwr_config
type: object
properties:
base:
type: integer
description: Additional power to request during negotiating with PSE over PoE, in mW
contentEncoding: int32
default: 0
examples:
- 2000
prefer_usb_over_wifi:
type: boolean
description: Whether to enable power out to peripheral, meanwhile will reduce power to Wi-Fi (only for AP45 at power mode)
default: false
description: Power negotiation and peripheral power settings for an AP or AP profile
ap_radio:
title: ap_radio
type: object
properties:
allow_rrm_disable:
type: boolean
description: Whether RRM can be disabled for individual radio-band settings
default: false
ant_gain_24:
minimum: 0
type: integer
description: Antenna gain for 2.4G - for models with external antenna only
contentEncoding: int32
examples:
- 4
ant_gain_5:
minimum: 0
type: integer
description: Antenna gain for 5G - for models with external antenna only
contentEncoding: int32
examples:
- 5
ant_gain_6:
minimum: 0
type: integer
description: Antenna gain for 6G - for models with external antenna only
contentEncoding: int32
examples:
- 5
antenna_mode:
allOf:
- $ref: '#/components/schemas/ap_radio_antenna_mode2'
- description: 'Selected radio chain mode for AP models that support antenna mode control. enum: `1x1`, `2x2`, `3x3`, `4x4`, `default`.'
antenna_select:
allOf:
- $ref: '#/components/schemas/antenna_select1'
- description: 'Internal or external antenna selection for AP models with selectable antennas. enum: ``, `external`, `internal`.'
examples:
- external
band_24:
allOf:
- $ref: '#/components/schemas/ap_radio_band242'
- description: 2.4 GHz radio settings for this access point
band_24_usage:
allOf:
- $ref: '#/components/schemas/radio_band_24_usage4'
- description: 'Radio usage mode for the 2.4 GHz-capable radio. enum: `24`, `5`, `6`, `auto`.'
band_5:
allOf:
- $ref: '#/components/schemas/ap_radio_band53'
- description: 5 GHz radio settings for this access point
band_5_on_24_radio:
allOf:
- $ref: '#/components/schemas/ap_radio_band51'
- description: 5 GHz settings used when the 2.4 GHz radio operates in 5 GHz mode
band_6:
allOf:
- $ref: '#/components/schemas/ap_radio_band62'
- description: 6 GHz radio settings for this access point
full_automatic_rrm:
type: boolean
description: Let RRM control everything, only the `channels` and `ant_gain` will be honored (i.e. disabled/bandwidth/power/band_24_usage are all controlled by RRM)
default: false
indoor_use:
type: boolean
description: To make an outdoor operate indoor. For an outdoor-ap, some channels are disallowed by default, this allows the user to use it as an indoor-ap
default: false
rrm_managed:
type: boolean
description: Enable RRM to manage all radio settings (ignores all band_xxx configs)
scanning_enabled:
type: boolean
description: Whether scanning radio is enabled
examples:
- true
description: Radio configuration settings for an access point
ap_radio_antenna_mode:
title: ap_radio_antenna_mode
enum:
- 1x1
- 2x2
- 3x3
- 4x4
- default
type: string
description: 'enum: `1x1`, `2x2`, `3x3`, `4x4`, `default`'
ap_radio_band24:
title: ap_radio_band24
type: object
properties:
allow_rrm_disable:
type: boolean
description: Whether RRM may disable the 2.4 GHz radio when optimizing RF settings
default: false
ant_gain:
maximum: 10
minimum: 0
type:
- integer
- 'null'
description: External antenna gain for the 2.4 GHz radio
contentEncoding: int32
default: 0
antenna_mode:
allOf:
- $ref: '#/components/schemas/radio_band_antenna_mode4'
- description: 'Radio chain mode for the 2.4 GHz radio. enum: `1x1`, `2x2`, `3x3`, `4x4`, `default`.'
examples:
- default
bandwidth:
allOf:
- $ref: '#/components/schemas/dot11_bandwidth242'
- description: 'Channel width configured for the 2.4 GHz radio. enum: `0`, `20`, `40`.'
examples:
- 20
channel:
maximum: 13
minimum: 1
type:
- integer
- 'null'
description: For Device. (primary) channel for the band, 0 means using the Site Setting
contentEncoding: int32
examples:
- 6
channels:
type:
- array
- 'null'
items:
type: integer
contentEncoding: int32
description: Allowed channel list for the 2.4 GHz radio; null or an empty array uses automatic selection
default: []
disabled:
type: boolean
description: Whether to disable the radio
default: false
power:
maximum: 25
minimum: 0
type:
- integer
- 'null'
description: Radio Tx power, in dBm. Can be an integer 0-25 for static power configuration, or `null` or unset for auto power mode
contentEncoding: int32
examples:
- 3
power_max:
maximum: 18
minimum: 3
type:
- integer
- 'null'
description: When power=null/unset, max tx power to use, HW-specific values will be used if not set
contentEncoding: int32
power_min:
maximum: 18
minimum: 3
type:
- integer
- 'null'
description: When power=null/unset, min tx power to use, HW-specific values will be used if not set
contentEncoding: int32
preamble:
allOf:
- $ref: '#/components/schemas/radio_band_preamble4'
- description: '802.11 preamble mode used by the 2.4 GHz radio. enum: `auto`, `long`, `short`.'
description: 2.4 GHz radio settings for an access point
ap_radio_band5:
title: ap_radio_band5
type: object
properties:
allow_rrm_disable:
type: boolean
description: Whether RRM may disable the 5 GHz radio when optimizing RF settings
default: false
ant_gain:
maximum: 10
minimum: 0
type:
- integer
- 'null'
description: External antenna gain for the 5 GHz radio
contentEncoding: int32
default: 0
antenna_beam_pattern:
allOf:
- $ref: '#/components/schemas/radio_band_antenna_beam_pattern3'
- description: 'Beam pattern used by the 5 GHz radio antenna. enum: `narrow`, `medium`, `wide`.'
antenna_mode:
allOf:
- $ref: '#/components/schemas/radio_band_antenna_mode1'
- description: 'Radio chain mode for the 5 GHz radio. enum: `1x1`, `2x2`, `3x3`, `4x4`, `default`.'
examples:
- default
bandwidth:
allOf:
- $ref: '#/components/schemas/dot11_bandwidth52'
- description: 'Channel width configured for the 5 GHz radio. enum: `0`, `20`, `40`, `80`.'
examples:
- 40
channel:
type:
- integer
- 'null'
description: For Device. (primary) channel for the band, 0 means using the Site Setting
contentEncoding: int32
examples:
- 100
channels:
type:
- array
- 'null'
items:
type: integer
contentEncoding: int32
description: Allowed channel list for the 5 GHz radio; null or an empty array uses automatic selection
default: []
disabled:
type: boolean
description: Whether to disable the radio
default: false
power:
maximum: 25
minimum: 0
type:
- integer
- 'null'
description: Radio Tx power, in dBm. Can be an integer 0-25 for static power configuration, or `null` or unset for auto power mode
contentEncoding: int32
examples:
- 6
power_max:
maximum: 17
minimum: 5
type:
- integer
- 'null'
description: When power=null/unset, max tx power to use, HW-specific values will be used if not set
contentEncoding: int32
power_min:
maximum: 17
minimum: 5
type:
- integer
- 'null'
description: When power=null/unset, min tx power to use, HW-specific values will be used if not set
contentEncoding: int32
preamble:
allOf:
- $ref: '#/components/schemas/radio_band_preamble1'
- description: '802.11 preamble mode used by the 5 GHz radio. enum: `auto`, `long`, `short`.'
description: 5 GHz radio settings for an access point
ap_radio_band6:
title: ap_radio_band6
type: object
properties:
allow_rrm_disable:
type: boolean
description: Whether RRM may disable the 6 GHz radio when optimizing RF settings
default: false
ant_gain:
maximum: 10
minimum: 0
type:
- integer
- 'null'
description: External antenna gain for the 6 GHz radio
contentEncoding: int32
default: 0
antenna_beam_pattern:
allOf:
- $ref: '#/components/schemas/radio_band_antenna_beam_pattern1'
- description: 'Beam pattern used by the 6 GHz radio antenna. enum: `narrow`, `medium`, `wide`.'
antenna_mode:
allOf:
- $ref: '#/components/schemas/radio_band_antenna_mode2'
- description: 'Radio chain mode for the 6 GHz radio. enum: `1x1`, `2x2`, `3x3`, `4x4`, `default`.'
examples:
- default
bandwidth:
allOf:
- $ref: '#/components/schemas/dot11_bandwidth62'
- description: 'Channel width configured for the 6 GHz radio. enum: `0`, `20`, `40`, `80`, `160`.'
examples:
- 80
channel:
type:
- integer
- 'null'
description: For Device. (primary) channel for the band, 0 means using the Site Setting
contentEncoding: int32
examples:
- 0
channels:
type:
- array
- 'null'
items:
type: integer
contentEncoding: int32
description: Allowed channel list for the 6 GHz radio; null or an empty array uses automatic selection
default: []
disabled:
type: boolean
description: Whether to disable the radio
default: false
power:
maximum: 25
minimum: 0
type:
- integer
- 'null'
description: Radio Tx power, in dBm. Can be an integer 0-25 for static power configuration, or `null` or unset for auto power mode
contentEncoding: int32
examples:
- 7
power_max:
maximum: 18
minimum: 5
type:
- integer
- 'null'
description: When power=null/unset, max tx power to use, HW-specific values will be used if not set
contentEncoding: int32
power_min:
maximum: 18
minimum: 5
type:
- integer
- 'null'
description: When power=null/unset, min tx power to use, HW-specific values will be used if not set
contentEncoding: int32
preamble:
allOf:
- $ref: '#/components/schemas/radio_band_preamble2'
- description: '802.11 preamble mode used by the 6 GHz radio. enum: `auto`, `long`, `short`.'
standard_power:
type: boolean
description: For 6GHz Only, standard-power operation, AFC (Automatic Frequency Coordination) will be performed, and we'll fall back to Low Power Indoor if AFC failed
default: false
description: 6 GHz radio settings for an access point
ap_radio_mac:
title: ap_radio_mac
required:
- mac
- radio_macs
type: object
properties:
mac:
minLength: 1
type: string
description: Access point MAC address for this radio MAC mapping
examples:
- 5c5b350001a0
radio_macs:
type: array
items:
type: string
description: List of radio MAC addresses associated with this access point
examples:
- - 5c5b350001a0
- 5c5b350001a1
description: Access point MAC address and its related radio MAC addresses
examples:
- mac: 5c5b350001a0
radio_macs:
- 5c5b350001a0
- 5c5b350001a1
ap_radio_stat:
title: ap_radio_stat
type: object
properties:
bandwidth:
allOf:
- $ref: '#/components/schemas/dot11_bandwidth8'
- description: 'Current channel width reported for this radio. enum: `0`, `20`, `40`, `80`, `160`.'
examples:
- 20
channel:
type:
- integer
- 'null'
description: Current channel the radio is running on
contentEncoding: int32
readOnly: true
dynamic_chaining_enabled:
type:
- boolean
- 'null'
description: Use dynamic chaining for downlink
readOnly: true
mac:
type:
- string
- 'null'
description: Radio base MAC address; a base radio MAC can represent up to 16 BSSIDs (e.g. 5c5b350001a0-5c5b350001af)
readOnly: true
noise_floor:
type:
- integer
- 'null'
description: Measured noise floor for this radio, in dBm
contentEncoding: int32
readOnly: true
examples:
- -90
num_clients:
type:
- integer
- 'null'
description: Number of clients currently connected on this radio
contentEncoding: int32
readOnly: true
num_wlans:
type: integer
description: How many WLANs are applied to the radio
contentEncoding: int32
power:
type:
- integer
- 'null'
description: Transmit power (in dBm)
contentEncoding: int32
readOnly: true
rx_bytes:
type:
- integer
- 'null'
description: Received byte count reported for this radio
contentEncoding: int64
readOnly: true
examples:
- 8515104416
rx_pkts:
type:
- integer
- 'null'
description: Received packet count reported for this radio
contentEncoding: int64
readOnly: true
examples:
- 57770567
tx_bytes:
type:
- integer
- 'null'
description: Transmitted byte count reported for this radio
contentEncoding: int64
readOnly: true
examples:
- 211217389682
tx_pkts:
type:
- integer
- 'null'
description: Transmitted packet count reported for this radio
contentEncoding: int64
readOnly: true
examples:
- 812204062
usage:
type:
- string
- 'null'
description: Operating band reported for this radio, such as 24, 5, or 6
readOnly: true
examples:
- '24'
util_all:
type:
- integer
- 'null'
description: All utilization in percentage
contentEncoding: int32
readOnly: true
util_non_wifi:
type:
- integer
- 'null'
description: Reception of "No Packets" utilization in percentage, received frames with invalid PLCPs and CRS glitches as noise
contentEncoding: int32
readOnly: true
util_rx_in_bss:
type:
- integer
- 'null'
description: Reception of "In BSS" utilization in percentage, only frames that are received from AP/STAs within the BSS
contentEncoding: int32
readOnly: true
util_rx_other_bss:
type:
- integer
- 'null'
description: Reception of "Other BSS" utilization in percentage, all frames received from AP/STAs that are outside the BSS
contentEncoding: int32
readOnly: true
util_tx:
type:
- integer
- 'null'
description: Transmission utilization in percentage
contentEncoding: int32
readOnly: true
util_undecodable_wifi:
type:
- integer
- 'null'
description: Reception of "UnDecodable Wifi" utilization in percentage, only Preamble, PLCP header is decoded, Rest is undecodable in this radio
contentEncoding: int32
readOnly: true
util_unknown_wifi:
type:
- integer
- 'null'
description: Reception of "No Category" utilization in percentage, all 802.11 frames that are corrupted at the receiver
contentEncoding: int32
readOnly: true
description: Runtime radio statistics for an access point radio
ap_redundancy:
title: ap_redundancy
type: object
properties:
modules:
type: object
additionalProperties:
$ref: '#/components/schemas/ap_redundancy_module'
description: Per-module AP redundancy counts keyed by switch node ID
num_aps:
type: integer
description: Total number of APs considered for switch redundancy
contentEncoding: int32
examples:
- 15
num_aps_with_switch_redundancy:
type: integer
description: Number of APs that have switch redundancy coverage
contentEncoding: int32
examples:
- 8
description: AP switch redundancy coverage summary
ap_redundancy_module:
title: ap_redundancy_module
type: object
properties:
num_aps:
type: integer
description: Total number of APs connected through this VC member
contentEncoding: int32
examples:
- 15
num_aps_with_switch_redundancy:
type: integer
description: Number of APs on this VC member with switch redundancy coverage
contentEncoding: int32
examples:
- 8
description: AP switch redundancy counts for one VC member
ap_search:
title: ap_search
required:
- mxtunnel_status
- power_constrained
- power_opmode
- wlans
type: object
properties:
band_24_bandwidth:
type: string
description: Current channel bandwidth on the AP 2.4 GHz radio
band_24_channel:
type: integer
description: Current channel on the AP 2.4 GHz radio
contentEncoding: int32
band_24_power:
type: integer
description: Current transmit power on the AP 2.4 GHz radio
contentEncoding: int32
band_5_bandwidth:
type: string
description: Current channel bandwidth on the AP 5 GHz radio
band_5_channel:
type: integer
description: Current channel on the AP 5 GHz radio
contentEncoding: int32
band_5_power:
type: integer
description: Current transmit power on the AP 5 GHz radio
contentEncoding: int32
band_6_bandwidth:
type: string
description: Current channel bandwidth on the AP 6 GHz radio
band_6_channel:
type: integer
description: Current channel on the AP 6 GHz radio
contentEncoding: int32
band_6_power:
type: integer
description: Current transmit power on the AP 6 GHz radio
contentEncoding: int32
eth0_port_speed:
type: integer
description: Port speed of eth0
contentEncoding: int32
ext_ip:
type: string
description: External IP address observed for AP management traffic
hostname:
type: array
items:
type: string
description: Observed hostnames detected for the AP in search results
inactive_wired_vlans:
type: array
items:
type: integer
contentEncoding: int32
description: Inactive wired VLAN IDs reported for this AP
ip:
type: string
description: Management IP address currently assigned to the AP
last_hostname:
type: string
description: Most recent hostname detected for the AP
lldp_mgmt_addr:
type: string
description: LLDP management IP address advertised by the upstream neighbor
lldp_port_desc:
type: string
description: LLDP port description advertised by the upstream neighbor
lldp_port_id:
type: string
description: LLDP port identifier advertised by the upstream neighbor
lldp_power_allocated:
type: integer
description: Power allocated to the AP by LLDP, in mW
contentEncoding: int32
lldp_power_draw:
type: integer
description: Power drawn by the AP as reported through LLDP, in mW
contentEncoding: int32
lldp_system_desc:
type: string
description: LLDP system description advertised by the upstream neighbor
lldp_system_name:
type: string
description: LLDP system name advertised by the upstream neighbor
mac:
type: string
description: Access point MAC address used to identify the AP in search results
model:
type: string
description: AP hardware model for this search result
mxedge_id:
type: string
description: Mist Edge id, if AP is connecting to a Mist Edge
mxedge_ids:
type: string
description: Comma separated list of Mist Edge ids, if AP is connecting to a Mist Edge
mxtunnel_status:
type: string
description: Current MxTunnel connection status of the AP
org_id:
type: string
description: Organization that owns this AP search result
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
power_constrained:
type: boolean
description: Whether the AP is operating with insufficient power
power_opmode:
type: string
description: Operating mode reported when AP power is constrained
site_id:
type: string
description: Site that contains this AP search result
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
sku:
type: string
description: Hardware SKU for the AP model
timestamp:
type: number
description: Time associated with this AP search result
readOnly: true
uptime:
type: integer
description: Device uptime for the AP, in seconds
contentEncoding: int32
version:
type: string
description: Software version currently running on the AP
wlans:
type: array
items:
$ref: '#/components/schemas/ap_search_wlan'
description: Wireless LAN summaries applied to the AP in this search result
description: Access point record returned by device search endpoints
ap_search_wlan:
title: ap_search_wlan
type: object
properties:
id:
type: string
description: WLAN identifier included in the AP search result
contentEncoding: uuid
ssid:
type: string
description: Wireless network SSID shown for this WLAN
description: WLAN summary included in an AP search result
ap_stat_mesh_downlink:
title: ap_stat_mesh_downlink
type: object
properties:
band:
type: string
description: Radio band used by this mesh downlink
examples:
- '5'
channel:
type: integer
description: Radio channel used by this mesh downlink
contentEncoding: int32
examples:
- 36
idle_time:
type: integer
description: Seconds since traffic was last observed on this mesh downlink
contentEncoding: int32
examples:
- 3
last_seen:
type:
- number
- 'null'
description: Timestamp when this mesh downlink was last observed
readOnly: true
examples:
- 1470417522
proto:
type: string
description: 802.11 protocol reported for this mesh downlink
examples:
- n
rssi:
type: integer
description: Received signal strength for this mesh downlink, in dBm
contentEncoding: int32
examples:
- -65
rx_bps:
type:
- integer
- 'null'
description: Inbound throughput on this mesh downlink, in bits per second
contentEncoding: int64
readOnly: true
examples:
- 60003
rx_bytes:
type:
- integer
- 'null'
description: Inbound byte count for this mesh downlink
contentEncoding: int64
readOnly: true
examples:
- 8515104416
rx_packets:
type:
- integer
- 'null'
description: Inbound packet count for this mesh downlink
contentEncoding: int64
readOnly: true
examples:
- 57770567
rx_rate:
type:
- number
- 'null'
description: Inbound data rate reported for this mesh downlink
readOnly: true
rx_retries:
type:
- integer
- 'null'
description: Inbound retry count reported for this mesh downlink
contentEncoding: int32
readOnly: true
site_id:
type: string
description: Site associated with this mesh downlink statistic
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
snr:
type: integer
description: Signal-to-noise ratio for this mesh downlink, in dB
contentEncoding: int32
examples:
- 31
tx_bps:
type:
- integer
- 'null'
description: Outbound throughput on this mesh downlink, in bits per second
contentEncoding: int64
readOnly: true
examples:
- 634301
tx_bytes:
type:
- integer
- 'null'
description: Outbound byte count for this mesh downlink
contentEncoding: int64
readOnly: true
examples:
- 211217389682
tx_packets:
type:
- integer
- 'null'
description: Outbound packet count for this mesh downlink
contentEncoding: int64
readOnly: true
examples:
- 812204062
tx_rate:
type:
- number
- 'null'
description: Outbound data rate reported for this mesh downlink
readOnly: true
tx_retries:
type:
- integer
- 'null'
description: Outbound retry count reported for this mesh downlink
contentEncoding: int32
readOnly: true
description: Runtime statistics for a mesh downlink from this AP
ap_stat_mesh_uplink:
title: ap_stat_mesh_uplink
type: object
properties:
band:
type: string
description: Radio band used by this mesh uplink
examples:
- '5'
channel:
type: integer
description: Radio channel used by this mesh uplink
contentEncoding: int32
examples:
- 36
idle_time:
type: integer
description: Seconds since traffic was last observed on this mesh uplink
contentEncoding: int32
examples:
- 3
last_seen:
type:
- number
- 'null'
description: Timestamp when this mesh uplink was last observed
readOnly: true
examples:
- 1470417522
proto:
type: string
description: 802.11 protocol reported for this mesh uplink
examples:
- n
rssi:
type: integer
description: Received signal strength for this mesh uplink, in dBm
contentEncoding: int32
examples:
- -65
rx_bps:
type:
- integer
- 'null'
description: Inbound throughput on this mesh uplink, in bits per second
contentEncoding: int64
readOnly: true
examples:
- 60003
rx_bytes:
type:
- integer
- 'null'
description: Inbound byte count for this mesh uplink
contentEncoding: int64
readOnly: true
examples:
- 8515104416
rx_packets:
type:
- integer
- 'null'
description: Inbound packet count for this mesh uplink
contentEncoding: int64
readOnly: true
examples:
- 57770567
rx_rate:
type:
- number
- 'null'
description: Inbound data rate reported for this mesh uplink
readOnly: true
rx_retries:
type:
- integer
- 'null'
description: Inbound retry count reported for this mesh uplink
contentEncoding: int32
readOnly: true
site_id:
type: string
description: Site associated with this mesh uplink statistic
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
snr:
type: integer
description: Signal-to-noise ratio for this mesh uplink, in dB
contentEncoding: int32
examples:
- 31
tx_bps:
type:
- integer
- 'null'
description: Outbound throughput on this mesh uplink, in bits per second
contentEncoding: int64
readOnly: true
examples:
- 634301
tx_bytes:
type:
- integer
- 'null'
description: Outbound byte count for this mesh uplink
contentEncoding: int64
readOnly: true
examples:
- 211217389682
tx_packets:
type:
- integer
- 'null'
description: Outbound packet count for this mesh uplink
contentEncoding: int64
readOnly: true
examples:
- 812204062
tx_rate:
type:
- number
- 'null'
description: Outbound data rate reported for this mesh uplink
readOnly: true
tx_retries:
type:
- integer
- 'null'
description: Outbound retry count reported for this mesh uplink
contentEncoding: int32
readOnly: true
uplink_ap_id:
type: string
description: Identifier of the upstream AP for this mesh uplink
contentEncoding: uuid
examples:
- 00000000-0000-0000-1000-5c5b35000010
description: Runtime statistics for this AP's mesh uplink
ap_switch:
title: ap_switch
type: object
properties:
enabled:
type: boolean
description: Whether deprecated AP switch VLAN control is enabled
default: false
eth0:
allOf:
- $ref: '#/components/schemas/ap_switch_setting7'
- description: VLAN settings for AP eth0
eth1:
allOf:
- $ref: '#/components/schemas/ap_switch_setting1'
- description: VLAN settings for AP eth1
eth2:
allOf:
- $ref: '#/components/schemas/ap_switch_setting2'
- description: VLAN settings for AP eth2
eth3:
allOf:
- $ref: '#/components/schemas/ap_switch_setting3'
- description: VLAN settings for AP eth3
module:
allOf:
- $ref: '#/components/schemas/ap_switch_setting4'
- description: VLAN settings for the AP module port
wds:
allOf:
- $ref: '#/components/schemas/ap_switch_setting5'
- description: VLAN settings for WDS traffic on the AP
description: Deprecated AP switch VLAN control settings for advanced per-port configuration
deprecated: true
ap_switch_setting:
title: ap_switch_setting
type: object
properties:
enable_vlan:
type: boolean
description: Whether VLAN tagging is enabled for this AP switch-config port
port_vlan_id:
anyOf:
- maximum: 4094
minimum: 1
type: integer
contentEncoding: int32
- type: string
description: Native VLAN ID for this AP switch-config port
vlan_ids:
type: array
items:
maximum: 4094
minimum: 1
type: integer
contentEncoding: int32
description: Allowed VLAN IDs for this AP switch-config port
description: VLAN settings for one deprecated AP switch-config port
ap_template:
title: ap_template
required:
- ap_matching
type: object
properties:
ap_matching:
allOf:
- $ref: '#/components/schemas/ap_template_matching2'
- description: Rules used to select access points for this AP template
created_time:
type: number
description: Timestamp when the AP template was created
readOnly: true
for_site:
type: boolean
description: Whether the AP template is scoped to a site rather than the organization
readOnly: true
id:
type: string
description: Unique identifier of the AP template
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
modified_time:
type: number
description: Timestamp when the AP template was last modified
readOnly: true
org_id:
type: string
description: Organization that owns this AP template
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
site_id:
type: string
description: Site that owns this site-level AP template
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
wifi:
allOf:
- $ref: '#/components/schemas/ap_template_wifi2'
- description: Wi-Fi and mesh settings applied by this AP template
description: Access point template configuration
ap_template_matching:
title: ap_template_matching
type: object
properties:
enabled:
type: boolean
description: Whether AP matching is enabled for this AP template
rules:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/ap_template_matching_rule'
description: AP matching entries that select access points and apply AP port configuration
description: Rules that select which AP template port configuration applies
ap_template_matching_rule:
title: ap_template_matching_rule
type: object
properties:
match_model:
minLength: 1
type: string
description: Access point model matched by this AP template rule
name:
minLength: 1
type: string
description: Display label for this AP template matching rule
port_config:
type: object
additionalProperties:
$ref: '#/components/schemas/ap_port_config'
description: Property key is the interface(s) name (e.g. "eth1,eth2")
description: Model and name match criteria for an AP template port configuration
ap_template_wifi:
title: ap_template_wifi
type: object
properties:
cisco_enabled:
type: boolean
description: Whether Cisco-specific Wi-Fi compatibility behavior is enabled
disable_11k:
type: boolean
description: Whether 802.11k neighbor reports are disabled
default: false
disable_radios_when_power_constrained:
type: boolean
description: Whether AP radios are disabled when power is constrained
enable_arp_spoof:
type: boolean
description: Whether ARP spoofing checks are enabled when proxy ARP is used
enable_shared_radio_scanning:
type: boolean
description: Whether shared radio scanning is enabled for AP radio scanning
default: false
enabled:
type: boolean
description: Whether Wi-Fi settings in this AP template are enabled
default: true
locate_connected:
type: boolean
description: Whether location tracking is enabled for connected clients
default: false
locate_unconnected:
type: boolean
description: Whether location tracking is enabled for unconnected clients
default: false
mesh_allow_dfs:
type: boolean
description: Whether mesh links may use DFS channels, which can add CAC delays during scanning
default: false
mesh_enable_crm:
type: boolean
description: Whether CRM is enabled for mesh networking in this AP template
mesh_enabled:
type: boolean
description: Whether mesh networking is enabled by this AP template
proxy_arp:
type: boolean
description: Whether proxy ARP is enabled for Wi-Fi clients
default: false
description: Wi-Fi behavior settings applied by an AP template
ap_uplink_port_config:
title: ap_uplink_port_config
type: object
properties:
dot1x:
type: boolean
description: Whether to do 802.1x against uplink switch. When enabled, AP cert will be used to do EAP-TLS and the Org's CA Cert has to be provisioned at the switch
default: false
keep_wlans_up_if_down:
type: boolean
description: By default, WLANs are disabled when uplink is down. In some scenario, like SiteSurvey, one would want the AP to keep sending beacons.
default: false
description: AP Uplink port configuration
ap_usb:
title: ap_usb
type: object
properties:
cacert:
type:
- string
- 'null'
description: Only if `type`==`imagotag`. CA certificate used to validate the Imagotag service certificate
channel:
type: integer
description: Only if `type`==`imagotag`, channel selection, not needed by default, required for manual channel override only
contentEncoding: int32
examples:
- 3
enabled:
type: boolean
description: Whether to enable any usb config
host:
type: string
description: Only if `type`==`imagotag`. Imagotag service host or IP address contacted by the AP
examples:
- 1.1.1.1
port:
type: integer
description: Only if `type`==`imagotag`. TCP port used to reach the Imagotag service
contentEncoding: int32
default: 0
examples:
- 0
type:
allOf:
- $ref: '#/components/schemas/ap_usb_type2'
- description: 'USB integration type for this legacy AP USB configuration. enum: `hanshow`, `imagotag`, `solum`.'
examples:
- imagotag
verify_cert:
type: boolean
description: Only if `type`==`imagotag`, whether to turn on SSL verification
vlan_id:
type: integer
description: Only if `type`==`solum` or `type`==`hanshow`
contentEncoding: int32
default: 1
description: >-
Legacy USB integration settings for an access point
- Note: if native imagotag is enabled, BLE will be disabled automatically
- Note: legacy, new config moved to ESL Config.
ap_usb_type:
title: ap_usb_type
enum:
- hanshow
- imagotag
- solum
type: string
description: 'usb config type. enum: `hanshow`, `imagotag`, `solum`'
examples:
- imagotag
ap_uwb_config:
title: ap_uwb_config
type: object
properties:
enabled:
type: boolean
description: Whether UWB RTLS integration is enabled
default: false
host:
type: string
description: RTLS server hostname or IP address
examples:
- coriva.example.com
port:
maximum: 65535
minimum: 1
type: integer
description: RTLS server port number
contentEncoding: int32
examples:
- 9000
slot:
maximum: 15
minimum: 0
type: integer
description: UWB time slot assigned to this AP, 0–15
contentEncoding: int32
default: 0
examples:
- 0
type:
allOf:
- $ref: '#/components/schemas/ap_uwb_config_type'
- description: 'UWB integration type. enum: `zigpos`'
description: Ultra-wideband (UWB) RTLS / OMLOX asset-visibility integration settings for an access point. The device-level value overrides the device profile value, which in turn overrides the site-level setting.
ap_uwb_config_type:
title: ap_uwb_config_type
const: zigpos
type: string
description: 'UWB integration type. enum: `zigpos`'
ap_zigbee:
title: ap_zigbee
type: object
properties:
allow_join:
allOf:
- $ref: '#/components/schemas/ap_zigbee_allow_join2'
- description: 'Join policy for new Zigbee devices on this AP. enum: `always`, `manual`.'
examples:
- manual
channel:
maximum: 26
minimum: 0
type: integer
description: Zigbee channel (2.4 GHz). `0` means auto; valid fixed values are 11–26
contentEncoding: int32
default: 0
examples:
- 0
enabled:
type: boolean
description: Whether to enable Zigbee on this AP
default: false
extended_pan_id:
type:
- string
- 'null'
description: Extended PAN ID in hex string format; only applicable when `pan_id` is also specified
examples:
- '1311768467294899695'
pan_id:
type:
- string
- 'null'
description: PAN ID in hex string format; if not specified, assigned automatically
examples:
- 0x1234
description: Zigbee radio and network settings applied to an AP or AP profile
ap_zigbee_allow_join:
title: ap_zigbee_allow_join
enum:
- always
- manual
type: string
description: 'Controls whether new Zigbee devices are allowed to join the network. enum: `always`, `manual`'
examples:
- manual
api_usage:
title: api_usage
required:
- request_limit
- requests
type: object
properties:
request_limit:
type: integer
description: Maximum API requests allowed in the current hourly rate-limit window
contentEncoding: int32
readOnly: true
requests:
type: integer
description: Number of API requests made in the current hourly rate-limit window
contentEncoding: int32
readOnly: true
seconds:
type: number
description: Time remaining, in seconds, before the current hourly rate-limit window resets
description: API rate-limit usage status for the current user or API token
app_probing:
title: app_probing
type: object
properties:
apps:
type: array
items:
type: string
description: Predefined application keys to probe
examples:
- - facebook
custom_apps:
type: array
items:
$ref: '#/components/schemas/app_probing_custom_app'
description: User-defined application probe definitions
enabled:
type: boolean
description: Whether gateway application probing is enabled
description: Application reachability probing settings for gateway management
app_probing_custom_app:
title: app_probing_custom_app
type: object
properties:
address:
type: string
description: Required if `protocol`==`icmp`. IP address probed by the ICMP custom app
examples:
- 192.168.1.1
app_type:
type: string
description: Category label used for this custom application probe
hostnames:
type: array
items:
type: string
description: If `protocol`==`http`. Hostnames or URLs probed by this custom app
examples:
- - https://www.abc.com
key:
type: string
description: Stable key used to identify this custom application probe
name:
type: string
description: Display name for this custom application probe
examples:
- pos_app
network:
type: string
description: Gateway network used as the source context for this probe
examples:
- lan
packetSize:
maximum: 65400
minimum: 0
type: integer
description: If `protocol`==`icmp`. ICMP packet size used by this custom app probe
contentEncoding: int32
protocol:
allOf:
- $ref: '#/components/schemas/app_probing_custom_app_protocol2'
- description: 'Probe protocol used by this custom application definition. enum: `http`, `icmp`.'
url:
type: string
description: If `protocol`==`http`. HTTP URL or hostname probed by this custom app
examples:
- www.abc.com
vrf:
type: string
description: Gateway VRF used as the source context for this probe
examples:
- lan
description: User-defined application probe definition
app_probing_custom_app_protocol:
title: app_probing_custom_app_protocol
enum:
- http
- icmp
type: string
description: 'Probe protocol for a custom application. enum: `http`, `icmp`'
arp_table_stats:
title: arp_table_stats
type: object
properties:
arp_table_count:
type: integer
description: Number of ARP table entries currently present on the device
contentEncoding: int32
max_entries_supported:
type: integer
description: Supported ARP table capacity for the device
contentEncoding: int32
description: ARP table usage and capacity statistics
asset:
title: asset
required:
- mac
- name
type: object
properties:
created_time:
type: number
description: Timestamp when this asset record was created
readOnly: true
for_site:
type: boolean
description: Whether this asset is scoped directly to a site
readOnly: true
id:
type: string
description: Unique identifier of the asset record
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
mac:
type: string
description: Bluetooth MAC address used to identify the BLE asset
map_id:
type: string
description: Identifier of the map associated with this asset, when specified
contentEncoding: uuid
modified_time:
type: number
description: Timestamp when this asset record was last modified
readOnly: true
name:
type: string
description: Display name or label for the BLE asset
org_id:
type: string
description: Owning organization identifier for this asset
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
site_id:
type: string
description: Identifier of the site associated with this asset
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
tag_id:
type: string
description: BLE tag identifier associated with this asset
contentEncoding: uuid
description: Named Bluetooth Low Energy asset record
asset_filter:
title: asset_filter
required:
- name
type: object
properties:
ap_mac:
type: string
description: Access point MAC address that must observe the BLE asset
beam:
type: integer
description: BLE beam number used to filter asset observations
contentEncoding: int32
created_time:
type: number
description: Timestamp when this asset filter was created
readOnly: true
disabled:
type: boolean
description: Whether the asset filter is disabled
default: false
eddystone_uid_namespace:
type: string
description: Eddystone uid namespace used to filter assets
examples:
- 2818e3868dec25629ede
eddystone_url:
type: string
description: Eddystone url used to filter assets
examples:
- https://www.abc.com
for_site:
type: boolean
description: Whether this asset filter is scoped directly to a site
readOnly: true
ibeacon_major:
maximum: 65535
minimum: 1
type:
- integer
- 'null'
description: Major value from the iBeacon advertisement that assets must match
contentEncoding: int32
examples:
- 1234
ibeacon_uuid:
type:
- string
- 'null'
description: UUID from the iBeacon advertisement that assets must match
contentEncoding: uuid
examples:
- f3f17139-704a-f03a-2786-0400279e37c3
id:
type: string
description: Unique identifier of the asset filter
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
mfg_company_id:
type: integer
description: BLE manufacturing-specific company-id used to filter assets
contentEncoding: int32
examples:
- 935
modified_time:
type: number
description: Timestamp when this asset filter was last modified
readOnly: true
mqtt_topic:
type: string
description: If set, matching BLE advertisements are forwarded to this MQTT topic when MQTT publishing is enabled
name:
type: string
description: Display name for this BLE asset filter
examples:
- Visitor Tags
org_id:
type: string
description: Owning organization identifier for this asset filter
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
rssi:
type: integer
description: Signal strength threshold used to filter BLE asset observations
contentEncoding: int32
service_uuid:
type: string
description: BLE service data uuid used to filter assets
contentEncoding: uuid
examples:
- 0000fe6a-0000-1000-8000-0030459b3cfb
site_id:
type: string
description: Containing site identifier for this asset filter, when site-scoped
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
description: BLE asset filter definition; all specified criteria must match
asset_import:
title: asset_import
required:
- mac
- name
type: object
properties:
mac:
minLength: 1
type: string
description: Bluetooth MAC address used to identify the imported BLE asset
name:
minLength: 1
type: string
description: Display name for the imported BLE asset
description: Asset record supplied in a JSON import payload
asset_of_interest:
title: asset_of_interest
type: object
properties:
ap_mac:
minLength: 1
type: string
description: Access point MAC address that heard this BLE beacon
beam:
type: number
description: BLE beam number that detected this beacon
by:
minLength: 1
type: string
description: Match source for this BLE beacon, such as asset or asset filter
curr_site:
minLength: 1
type: string
description: Site currently associated with this BLE beacon
device_name:
type: string
description: AP name reported for the device that heard this BLE beacon
id:
type: string
description: Unique identifier of the matched asset or filter entry
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
last_seen:
type:
- number
- 'null'
description: Timestamp when this BLE beacon was last observed
readOnly: true
examples:
- 1470417522
mac:
minLength: 1
type: string
description: Bluetooth MAC address of this BLE beacon
manufacture:
minLength: 1
type: string
description: BLE manufacturer name resolved for this beacon
map_id:
minLength: 1
type: string
description: Identifier of the map associated with this BLE beacon observation
name:
minLength: 1
type: string
description: Display name of the matched asset or filter
rssi:
type: number
description: Signal strength of this BLE beacon, in dBm
description: BLE beacon that matched a named asset or asset filter
asset_rssi_zone:
title: asset_rssi_zone
type: object
properties:
id:
type: string
description: Unique identifier of the RSSI zone
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
since:
type: number
description: Timestamp when the asset entered this RSSI zone
description: RSSI zone membership for an individual asset statistic
asset_zone:
title: asset_zone
type: object
properties:
id:
type: string
description: Unique identifier of the zone
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
since:
type: number
description: Timestamp when the asset entered this zone
description: Map zone membership for an individual asset statistic
assets_import_file:
title: assets_import_file
type: object
properties:
file:
type: string
description: CSV file containing asset records to import
contentEncoding: base64
description: CSV file upload payload for importing BLE assets
audit_log:
title: audit_log
required:
- admin_id
- admin_name
- id
- message
- org_id
- site_id
- timestamp
type: object
properties:
admin_id:
type: string
description: Identifier of the administrator associated with the audited action
contentEncoding: uuid
readOnly: true
examples:
- 456b7016-a916-a4b1-78dd-72b947c152b7
admin_name:
type: string
description: Name or email of the administrator associated with the audited action
after:
type: object
description: Field values after the audited change
before:
type: object
description: Field values before the audited change
for_site:
type: boolean
description: Whether this audit log entry is scoped to a site
readOnly: true
id:
type: string
description: Unique identifier of the audit log entry
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
message:
type: string
description: Human-readable audit message describing the action
org_id:
type: string
description: Owning organization identifier for this audit log entry
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
site_id:
type: string
description: Associated site identifier for this audit log entry
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
timestamp:
type: number
description: Time when the audited action occurred
readOnly: true
description: Administrative audit log entry
auto_map_assignment:
title: auto_map_assignment
type: object
properties:
dryrun:
type: boolean
description: If `true`, validates the site's APs without starting the map assignment process. Returns device validity and estimated runtime.
default: false
force_collection:
type: boolean
description: If `true`, forces data collection via orchestration. If `false`, attempts to use existing BLE data first.
default: false
description: Request options for validating or starting automatic AP map assignment
auto_map_assignment_request:
title: auto_map_assignment_request
type: object
properties:
map_ids:
type: array
items:
type: string
contentEncoding: uuid
description: Optional list of specific map IDs to apply/clear. If not provided or empty, all pending map assignments are accepted/rejected.
description: Request body for accepting or clearing pending map assignments
auto_orient:
title: auto_orient
type: object
properties:
dryrun:
type: boolean
description: Set to `true` to perform an invalid AP check and provide an estimated run time without enqueuing the run into the auto orient service.
force_collection:
type: boolean
description: "If `force_collection`==`false`, the API attempts to start auto orientation with existing BLE data. \nIf `force_collection`==`true`, the API attempts to start BLE orchestration."
default: false
macs:
type: array
items:
type: string
description: AP MAC addresses to include in the auto-orient run
override:
type: boolean
description: Set to `true` to run auto orient even if there are invalid APs in the selected APs.
description: Request options for validating or starting AP auto-orientation
auto_placement:
title: auto_placement
type: object
properties:
dryrun:
type: boolean
description: Set to `true` to perform an invalid AP check and provide an estimated run time without enqueuing the run into the auto placement service.
default: false
force_collection:
type: boolean
description: "* If `force_collection`==`false`: the API attempts to start localization with existing data. \n* If `force_collection`==`true`: maintenance the API attempts to start orchestration."
default: false
macs:
type: array
items:
type: string
description: AP MAC addresses to include in the auto-placement run
override:
type: boolean
description: Set to `true` to run auto placement even if there are invalid APs in the selected APs.
default: false
description: Request options for validating or starting AP auto-placement
auto_placement_info_status:
title: auto_placement_info_status
enum:
- done
- error
- inprogress
- pending
type: string
description: 'the status of autoplacement for a given map. enum: `done`, `error`, `inprogress`, `pending`'
auto_preemption:
title: auto_preemption
type: object
properties:
day_of_week:
allOf:
- $ref: '#/components/schemas/day_of_week7'
- description: 'Scheduled weekday for auto preemption. enum: `any`, `fri`, `mon`, `sat`, `sun`, `thu`, `tue`, `wed`.'
enabled:
type: boolean
description: Whether auto preemption is enabled
default: false
time_of_day:
type: string
description: Scheduled time of day for auto preemption
default: any
examples:
- 12:00
description: Schedule to preempt AP tunnels that are not connected to their preferred peer
autoplacement_localization_selector:
title: autoplacement_localization_selector
type: object
properties:
for:
allOf:
- $ref: '#/components/schemas/autoplacement_localization_selector_for'
- description: 'The selector to choose auto placement or auto orientation. enum: `orientation`, `placement`'
macs:
type: array
items:
type: string
description: List of AP MAC addresses to apply the action to. If omitted, the action applies to all APs on the map
description: Request body to apply or clear cached autoplacement or auto-orientation values for a map or subset of APs
autoplacement_localization_selector_for:
title: autoplacement_localization_selector_for
enum:
- orientation
- placement
type: string
description: 'The selector to choose auto placement or auto orientation. enum: `orientation`, `placement`'
avprofile:
title: avprofile
required:
- name
type: object
properties:
created_time:
type: number
description: Timestamp when this antivirus profile was created
readOnly: true
fallback_action:
allOf:
- $ref: '#/components/schemas/avprofile_fallback_action2'
- description: 'Action to take when antivirus scanning cannot complete. enum: `block`, `log-and-permit`, `permit`.'
id:
type: string
description: Unique identifier of the antivirus profile
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
max_filesize:
maximum: 40000
minimum: 20
type: integer
description: Maximum file size scanned by this antivirus profile, in KB
contentEncoding: int32
default: 10000
mime_whitelist:
uniqueItems: true
type: array
items:
type: string
description: Content MIME types exempted from antivirus scanning
modified_time:
type: number
description: Timestamp when this antivirus profile was last modified
readOnly: true
name:
type: string
description: Display name of the antivirus profile
org_id:
type: string
description: Owning organization identifier for this antivirus profile
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
protocols:
minItems: 1
type: array
items:
$ref: '#/components/schemas/avprofile_protocol'
description: Network protocols inspected by this antivirus profile
site_id:
type: string
description: Associated site identifier for this antivirus profile, when site-scoped
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
url_whitelist:
uniqueItems: true
type: array
items:
type: string
description: Allowed URL entries exempted from antivirus scanning
description: Antivirus scanning profile with protocols, limits, and whitelist settings
avprofile_fallback_action:
title: avprofile_fallback_action
enum:
- block
- log-and-permit
- permit
type: string
description: 'Action applied when antivirus scanning cannot complete. enum: `block`, `log-and-permit`, `permit`'
avprofile_protocol:
title: avprofile_protocol
enum:
- ftp
- http
- imap
- pop3
- smtp
type: string
description: 'Protocol that can be inspected by an antivirus profile. enum: `ftp`, `http`, `imap`, `pop3`, `smtp`'
beacon:
title: beacon
type: object
properties:
created_time:
type: number
description: Timestamp when this beacon configuration was created
readOnly: true
eddystone_instance:
type: string
description: Eddystone-UID instance (6 bytes) in hexstring format
eddystone_namespace:
type: string
description: Eddystone-UID namespace (10 bytes) in hexstring format
eddystone_url:
type: string
description: Eddystone-URL value broadcast by the beacon
for_site:
type: boolean
description: Whether this beacon is scoped directly to a site
readOnly: true
ibeacon_major:
maximum: 65535
minimum: 1
type:
- integer
- 'null'
description: iBeacon major value advertised by this beacon
contentEncoding: int32
examples:
- 1234
ibeacon_minor:
maximum: 65535
minimum: 1
type:
- integer
- 'null'
description: iBeacon minor value advertised by this beacon
contentEncoding: int32
examples:
- 1234
ibeacon_uuid:
type:
- string
- 'null'
description: iBeacon UUID advertised by this beacon
contentEncoding: uuid
examples:
- f3f17139-704a-f03a-2786-0400279e37c3
id:
type: string
description: Unique identifier of the beacon configuration
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
mac:
type: string
description: Optional beacon MAC address, currently used only to identify battery voltage
map_id:
type: string
description: Map where the beacon is placed
contentEncoding: uuid
modified_time:
type: number
description: Timestamp when this beacon configuration was last modified
readOnly: true
name:
type: string
description: Display name of the beacon
org_id:
type: string
description: Owning organization identifier for this beacon
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
power:
maximum: 100
minimum: -12
type: integer
description: Beacon transmit power, in dBm
contentEncoding: int32
default: -12
site_id:
type: string
description: Site identifier associated with this beacon
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
type:
allOf:
- $ref: '#/components/schemas/beacon_type2'
- description: 'Beacon advertisement format used by this beacon. enum: `eddystone-uid`, `eddystone-url`, `ibeacon`.'
x:
type: number
description: Horizontal map position of the beacon, in pixels
y:
type: number
description: Vertical map position of the beacon, in pixels
description: Beacon configuration and placement data
beacon_type:
title: beacon_type
enum:
- eddystone-uid
- eddystone-url
- ibeacon
type: string
description: 'enum: `eddystone-uid`, `eddystone-url`, `ibeacon`'
bgp_config:
title: bgp_config
required:
- via
type: object
properties:
auth_key:
type: string
description: Optional if `via`==`lan`, `via`==`tunnel` or `via`==`wan`
bfd_minimum_interval:
maximum: 255000
minimum: 1
type:
- integer
- 'null'
description: >-
Optional if `via`==`lan`, `via`==`tunnel` or `via`==`wan`, when bfd_multiplier is configured alone. Default:
* 1000 if `type`==`external`
* 350 `type`==`internal`
contentEncoding: int32
default: 350
bfd_multiplier:
maximum: 255
minimum: 1
type:
- integer
- 'null'
description: Optional if `via`==`lan`, `via`==`tunnel` or `via`==`wan`, when bfd_minimum_interval_is_configured alone
contentEncoding: int32
default: 3
disable_bfd:
type: boolean
description: Optional if `via`==`lan`, `via`==`tunnel` or `via`==`wan`. BFD provides faster path failure detection and is enabled by default
default: false
export:
type: string
description: Routing policy applied to routes exported by this BGP session
export_policy:
type: string
description: Default export policies if no per-neighbor policies defined
extended_v4_nexthop:
type: boolean
description: Optional if `via`==`lan`, `via`==`tunnel` or `via`==`wan`. By default, either inet/net6 unicast depending on neighbor IP family (v4 or v6). For v6 neighbors, to exchange v4 nexthop, which allows dual-stack support, enable this
graceful_restart_time:
maximum: 4095
minimum: 0
type: integer
description: Optional if `via`==`lan`, `via`==`tunnel` or `via`==`wan`. `0` means disable
contentEncoding: int32
default: 0
hold_time:
maximum: 65535
minimum: 0
type: integer
description: Optional if `via`==`lan`, `via`==`tunnel` or `via`==`wan`. Default is 90.
contentEncoding: int32
default: 90
import:
type: string
description: Routing policy applied to routes imported by this BGP session
import_policy:
type: string
description: Optional if `via`==`lan`, `via`==`tunnel` or `via`==`wan`. Default import policies if no per-neighbor policies defined
local_as:
anyOf:
- type: string
- maximum: 4294967295
minimum: 1
type: integer
contentEncoding: int32
description: Required if `via`==`lan`, `via`==`tunnel` or `via`==`wan`; local BGP Autonomous System (AS) number
examples:
- '65000'
neighbor_as:
anyOf:
- type: string
- maximum: 4294967294
minimum: 1
type: integer
contentEncoding: int32
description: Default BGP neighbor Autonomous System (AS) number for this session
examples:
- '65000'
neighbors:
type: object
additionalProperties:
$ref: '#/components/schemas/bgp_config_neighbors'
description: Required if `via`==`lan`, `via`==`tunnel` or `via`==`wan`. If per-neighbor as is desired. Property key is the neighbor address
networks:
type: array
items:
type: string
description: Optional if `via`==`lan`; networks where BGP neighbors can connect to or from
no_private_as:
type: boolean
description: Optional if `via`==`lan`, `via`==`tunnel` or `via`==`wan`. If true, we will not advertise private ASNs (AS 64512-65534) to this neighbor
default: false
no_readvertise_to_overlay:
type: boolean
description: Optional if `via`==`lan`, `via`==`tunnel` or `via`==`wan`. By default, we'll re-advertise all learned BGP routers toward overlay
default: false
tunnel_name:
type: string
description: Optional if `via`==`tunnel`; tunnel name used for this BGP session
type:
allOf:
- $ref: '#/components/schemas/bgp_config_type2'
- minLength: 1
description: Required if `via`==`lan`, `via`==`tunnel` or `via`==`wan`; BGP session type, internal or external
via:
allOf:
- $ref: '#/components/schemas/bgp_config_via2'
- description: Transport used for this BGP session, such as LAN, tunnel, VPN, or WAN
vpn_name:
type: string
description: Optional if `via`==`vpn`; VPN name used for this BGP session
wan_name:
type: string
description: Optional if `via`==`wan`; WAN interface name used for this BGP session
description: BGP session configuration. BFD is enabled when either bfd_minimum_interval or bfd_multiplier is configured
bgp_config_neighbors:
title: bgp_config_neighbors
required:
- neighbor_as
type: object
properties:
disabled:
type: boolean
description: If true, the BGP session to this neighbor will be administratively disabled/shutdown
default: false
export_policy:
type: string
description: Export policy applied only to this BGP neighbor
hold_time:
maximum: 65535
minimum: 0
type: integer
description: BGP hold time for this neighbor, in seconds
contentEncoding: int32
default: 90
import_policy:
type: string
description: Import policy applied only to this BGP neighbor
multihop_ttl:
maximum: 255
minimum: 0
type: integer
description: Assuming BGP neighbor is directly connected
contentEncoding: int32
neighbor_as:
anyOf:
- type: string
- maximum: 4294967294
minimum: 1
type: integer
contentEncoding: int32
description: Autonomous System (AS) number of this BGP neighbor
examples:
- '65000'
tunnel_via:
allOf:
- $ref: '#/components/schemas/tunnel_via2'
- description: If `via`==`tunnel`, primary or secondary tunnel associated with this BGP neighbor
description: Per-neighbor BGP session settings
bgp_config_type:
title: bgp_config_type
enum:
- external
- internal
type: string
description: 'Required if `via`==`lan`, `via`==`tunnel` or `via`==`wan`. enum: `external`, `internal`'
bgp_config_via:
title: bgp_config_via
enum:
- lan
- tunnel
- vpn
- wan
type: string
description: 'enum: `lan`, `tunnel`, `vpn`, `wan`'
bgp_peer:
title: bgp_peer
type: object
properties:
evpn_overlay:
type: boolean
description: If this is created for evpn overlay
for_overlay:
type: boolean
description: If this is created for overlay
local_as:
anyOf:
- type: string
- maximum: 4294967294
minimum: 1
type: integer
contentEncoding: int32
description: Local Autonomous System (AS) number used by this BGP session
examples:
- '65000'
neighbor:
type: string
description: IP address of the BGP neighbor
examples:
- 15.8.3.5
neighbor_as:
anyOf:
- type: string
- maximum: 4294967294
minimum: 1
type: integer
contentEncoding: int32
description: Autonomous System (AS) number of the BGP neighbor
examples:
- '65000'
neighbor_mac:
type: string
description: MAC address of the BGP neighbor when it is another device in the same organization
examples:
- 020001c04600
node:
type: string
description: HA node reporting this BGP peer, such as node0 or node1
examples:
- node0
rx_pkts:
type:
- integer
- 'null'
description: Packets received from this BGP neighbor
contentEncoding: int64
readOnly: true
examples:
- 57770567
rx_routes:
type: integer
description: Number of received routes
contentEncoding: int32
examples:
- 60
state:
allOf:
- $ref: '#/components/schemas/bgp_stats_state1'
- description: 'Current state of the BGP session. enum: `active`, `connect`, `established`, `idle`, `open_config`, `open_sent`.'
examples:
- established
timestamp:
type: number
description: Time when these BGP peer stats were sampled
readOnly: true
tx_pkts:
type:
- integer
- 'null'
description: Packets sent to this BGP neighbor
contentEncoding: int64
readOnly: true
examples:
- 812204062
tx_routes:
type: integer
description: Number of routes advertised to this BGP neighbor
contentEncoding: int32
examples:
- 60
up:
type: boolean
description: Whether the BGP session is currently up
uptime:
type: integer
description: Number of seconds the BGP session has been up
contentEncoding: int32
examples:
- 31355
vrf_name:
type: string
description: VRF name associated with this BGP session
examples:
- default
description: Only present when `bgp_peers` in `fields` query parameter
bgp_stats:
title: bgp_stats
type: object
properties:
evpn_overlay:
type: boolean
description: If this is created for evpn overlay
for_overlay:
type: boolean
description: If this is created for overlay
local_as:
anyOf:
- type: string
- maximum: 4294967294
minimum: 1
type: integer
contentEncoding: int32
description: Local Autonomous System (AS) number used by this BGP session
examples:
- '65000'
mac:
type: string
description: Router MAC address for the device reporting this BGP peer
examples:
- 020001c04668
model:
type: string
description: Device model reporting this BGP peer statistic
neighbor:
type: string
description: IP address of the BGP neighbor
examples:
- 15.8.3.5
neighbor_as:
anyOf:
- type: string
- maximum: 4294967294
minimum: 1
type: integer
contentEncoding: int32
description: Autonomous System (AS) number of the BGP neighbor
examples:
- '65000'
neighbor_mac:
type: string
description: MAC address of the BGP neighbor when it is another device in the same organization
examples:
- 020001c04600
node:
type: string
description: HA node reporting this BGP peer, such as node0 or node1
examples:
- node0
org_id:
type: string
description: Owning organization identifier for this BGP peer statistic
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
rx_pkts:
type:
- integer
- 'null'
description: Packets received from this BGP neighbor
contentEncoding: int64
readOnly: true
examples:
- 57770567
rx_routes:
type: integer
description: Number of received routes
contentEncoding: int32
examples:
- 60
site_id:
type: string
description: Site identifier associated with this BGP peer statistic
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
state:
allOf:
- $ref: '#/components/schemas/bgp_stats_state1'
- description: 'Current state of the BGP session. enum: `active`, `connect`, `established`, `idle`, `open_config`, `open_sent`.'
examples:
- established
timestamp:
type: number
description: Time when these BGP peer stats were sampled
readOnly: true
tx_pkts:
type:
- integer
- 'null'
description: Packets sent to this BGP neighbor
contentEncoding: int64
readOnly: true
examples:
- 812204062
tx_routes:
type: integer
description: Number of routes advertised to this BGP neighbor
contentEncoding: int32
examples:
- 60
up:
type: boolean
description: Whether the BGP session is currently up
uptime:
type: integer
description: Number of seconds the BGP session has been up
contentEncoding: int32
examples:
- 31355
vrf_name:
type: string
description: VRF name associated with this BGP session
examples:
- default
description: BGP peer statistics reported by a network device
bgp_stats_state:
title: bgp_stats_state
enum:
- active
- connect
- established
- idle
- open_config
- open_sent
type: string
description: 'enum: `active`, `connect`, `established`, `idle`, `open_config`, `open_sent`'
examples:
- established
binary_stream:
title: binary_stream
required:
- file
type: object
properties:
file:
type: string
description: Binary file payload to upload with this request
contentEncoding: base64
description: Binary file upload payload
ble_config:
title: ble_config
type: object
properties:
beacon_enabled:
type: boolean
description: Whether Mist beacons is enabled
default: true
beacon_rate:
type: integer
description: Required if `beacon_rate_mode`==`custom`, 1-10, in number-beacons-per-second
contentEncoding: int32
examples:
- 3
beacon_rate_mode:
allOf:
- $ref: '#/components/schemas/ble_config_beacon_rate_mode2'
- description: 'Beacon rate mode for Mist BLE beacons; use custom to set beacon_rate. enum: `custom`, `default`.'
examples:
- custom
beam_disabled:
type: array
items:
type: integer
contentEncoding: int32
description: AP BLE beam numbers disabled for location advertisements
examples:
- - 1
- 3
- 6
custom_ble_packet_enabled:
type: boolean
description: Can be enabled if `beacon_enabled`==`true`, whether to send custom packet
default: false
custom_ble_packet_frame:
type: string
description: The custom frame to be sent out in this beacon. The frame must be a hexstring
examples:
- 0x........
custom_ble_packet_freq_msec:
minimum: 0
type: integer
description: Frequency (msec) of data emitted by custom ble beacon
contentEncoding: int32
default: 0
examples:
- 300
eddystone_uid_adv_power:
maximum: 20
minimum: -100
type: integer
description: Advertised TX Power, -100 to 20 (dBm), omit this attribute to use default
contentEncoding: int32
default: 0
examples:
- -65
eddystone_uid_beams:
type: string
description: BLE beams used to transmit Eddystone-UID advertisements, expressed as ranges such as `2-4,7`
examples:
- 2-4,7
eddystone_uid_enabled:
type: boolean
description: Only if `beacon_enabled`==`false`, Whether Eddystone-UID beacon is enabled
default: false
eddystone_uid_freq_msec:
type: integer
description: Frequency (msec) of data emit by Eddystone-UID beacon
contentEncoding: int32
default: 0
examples:
- 200
eddystone_uid_instance:
type: string
description: Eddystone-UID instance for the device
examples:
- 5c5b35000001
eddystone_uid_namespace:
type: string
description: Eddystone-UID namespace broadcast by the AP, as a 10-byte hex string
examples:
- 2818e3868dec25629ede
eddystone_url_adv_power:
maximum: 20
minimum: -100
type: integer
description: Advertised TX Power, -100 to 20 (dBm), omit this attribute to use default
contentEncoding: int32
default: 0
examples:
- -65
eddystone_url_beams:
type: string
description: BLE beams used to transmit Eddystone-URL advertisements, expressed as ranges such as `2-4,7`
examples:
- 2-4,7
eddystone_url_enabled:
type: boolean
description: Only if `beacon_enabled`==`false`, Whether Eddystone-URL beacon is enabled
default: false
eddystone_url_freq_msec:
type: integer
description: Frequency (msec) of data emitted by Eddystone-URL beacon
contentEncoding: int32
default: 0
examples:
- 1000
eddystone_url_url:
type: string
description: URL pointed by Eddystone-URL beacon
examples:
- https://www.abc.com
ibeacon_adv_power:
maximum: 20
minimum: -100
type: integer
description: Advertised TX Power, -100 to 20 (dBm), omit this attribute to use default
contentEncoding: int32
default: 0
examples:
- -65
ibeacon_beams:
type: string
description: BLE beams used to transmit iBeacon advertisements, expressed as ranges such as `2-4,7`
examples:
- 2-4,7
ibeacon_enabled:
type: boolean
description: Can be enabled if `beacon_enabled`==`true`, whether to send iBeacon
default: false
ibeacon_freq_msec:
type: integer
description: Frequency (msec) of data emit for iBeacon
contentEncoding: int32
default: 0
ibeacon_major:
maximum: 65535
minimum: 1
type:
- integer
- 'null'
description: iBeacon major value broadcast by the AP
contentEncoding: int32
examples:
- 1234
ibeacon_minor:
maximum: 65535
minimum: 1
type:
- integer
- 'null'
description: iBeacon minor value broadcast by the AP
contentEncoding: int32
examples:
- 1234
ibeacon_uuid:
type: string
description: Optional, if not specified, the same UUID as the beacon will be used
contentEncoding: uuid
examples:
- f3f17139-704a-f03a-2786-0400279e37c3
power:
maximum: 10
minimum: 1
type: integer
description: Required if `power_mode`==`custom`; else use `power_mode` as default
contentEncoding: int32
default: 9
examples:
- 6
power_mode:
allOf:
- $ref: '#/components/schemas/ble_config_power_mode3'
- description: 'Transmit power mode for BLE beacons; use custom to set `power`. enum: `custom`, `default`.'
examples:
- custom
description: Bluetooth Low Energy beacon and asset advertising settings for an AP
ble_config_beacon_rate_mode:
title: ble_config_beacon_rate_mode
enum:
- custom
- default
type: string
description: 'Beacon rate mode for Mist BLE beacons; use custom to set beacon_rate. enum: `custom`, `default`'
examples:
- custom
ble_config_power_mode:
title: ble_config_power_mode
enum:
- custom
- default
type: string
description: 'Transmit power mode for BLE beacons; use `custom` to set explicit power. enum: `custom`, `default`'
examples:
- custom
call_troubleshoot:
title: call_troubleshoot
type: object
properties:
mac:
type: string
description: Client MAC address for the troubleshot call
examples:
- 983a78ea4a44
meeting_id:
type: string
description: Meeting identifier for the troubleshot call
contentEncoding: uuid
examples:
- b784d744-9a7c-4fad-9af0-f78858a319b1
results:
type: array
items:
$ref: '#/components/schemas/troubleshoot_call_item'
description: Per-sample troubleshooting results for the call
description: Detailed call troubleshooting response
call_troubleshoot_data:
title: call_troubleshoot_data
type: object
properties:
ap_num_clients:
type: number
description: Troubleshooting metric value for AP client count
examples:
- -0.6565111
ap_rtt:
type: number
description: Troubleshooting metric value for AP round-trip time
examples:
- 0.16559607
client_cpu:
type: number
description: Troubleshooting metric value for client CPU load
examples:
- 3.7028809
client_n_streams:
type: number
description: Troubleshooting metric value for the number of client spatial streams
examples:
- 0.15803306
client_radio_band:
type: number
description: Troubleshooting metric value for the client radio band
examples:
- 0.5576923
client_rssi:
type: number
description: Troubleshooting metric value for client RSSI
examples:
- -1.0839354
client_rx_bytes:
type: number
description: Troubleshooting metric value for bytes received by the client
examples:
- 2.2622051
client_rx_rates:
type: number
description: Troubleshooting metric value for client receive data rates
examples:
- 0.62357205
client_rx_retries:
type: number
description: Troubleshooting metric value for client receive retries
examples:
- 0.26726437
client_tx_bytes:
type: number
description: Troubleshooting metric value for bytes transmitted by the client
examples:
- 0.15803306
client_tx_rates:
type: number
description: Troubleshooting metric value for client transmit data rates
examples:
- 0.62357205
client_tx_retries:
type: number
description: Troubleshooting metric value for client transmit retries
examples:
- 0.77553505
client_vpn_distance:
type: number
description: Troubleshooting metric value for client VPN distance
examples:
- 1.6474955
client_wifi_version:
type: number
description: Troubleshooting metric value for the client Wi-Fi version
examples:
- 0.18267937
expected:
type: number
description: Model baseline value expected for this media direction
examples:
- 30.941595
radio_bandwidth:
type: number
description: Troubleshooting metric value for radio channel bandwidth
examples:
- -0.06538621
radio_channel:
type: number
description: Troubleshooting metric value for the radio channel
examples:
- -0.73391086
radio_tx_power:
type: number
description: Troubleshooting metric value for radio transmit power
examples:
- 0.10027129
radio_util:
type: number
description: Troubleshooting metric value for radio utilization
examples:
- 12.770318
radio_util_interference:
type: number
description: Troubleshooting metric value for radio interference utilization
examples:
- -3.079999
site_num_clients:
type: number
description: Troubleshooting metric value for the number of clients at the site
examples:
- 0.017364305
wan_avg_download_mbps:
type: number
description: Troubleshooting metric value for average WAN download throughput
examples:
- 1.4803165
wan_avg_upload_mbps:
type: number
description: Troubleshooting metric value for average WAN upload throughput
examples:
- -0.038184267
wan_jitter:
type: number
description: Troubleshooting metric value for WAN jitter
examples:
- 5.9680853
wan_max_download_mbps:
type: number
description: Troubleshooting metric value for maximum WAN download throughput
examples:
- 1.4803165
wan_max_upload_mbps:
type: number
description: Troubleshooting metric value for maximum WAN upload throughput
examples:
- -0.038184267
wan_rtt:
type: number
description: Troubleshooting metric value for WAN round-trip time
examples:
- 46.77899
description: Per-media call troubleshooting metric values
call_troubleshoot_summary:
title: call_troubleshoot_summary
type: object
properties:
ap_num_clients:
type: number
description: Summary troubleshooting metric value for AP client count
examples:
- -0.08802365511655807
ap_rtt:
type: number
description: Summary troubleshooting metric value for AP round-trip time
examples:
- 0.09924473613500595
audio_in:
allOf:
- $ref: '#/components/schemas/call_troubleshoot_summary_data5'
- description: Troubleshooting metrics for the inbound audio stream
audio_out:
allOf:
- $ref: '#/components/schemas/call_troubleshoot_summary_data1'
- description: Troubleshooting metrics for the outbound audio stream
client_cpu:
type: number
description: Summary troubleshooting metric value for client CPU load
examples:
- 0.00834270566701889
client_n_streams:
type: number
description: Summary troubleshooting metric value for the number of client spatial streams
examples:
- 0.00734270566701889
client_radio_band:
type: number
description: Summary troubleshooting metric value for the client radio band
examples:
- 0.5841414928436279
client_rssi:
type: number
description: Summary troubleshooting metric value for client RSSI
examples:
- 0.7594696879386902
client_rx_bytes:
type: number
description: Summary troubleshooting metric value for bytes received by the client
examples:
- 2.365511655807E-05
client_rx_rates:
type: number
description: Summary troubleshooting metric value for client receive data rates
examples:
- 0.02441493794322014
client_rx_retries:
type: number
description: Summary troubleshooting metric value for client receive retries
examples:
- -0.14325742423534393
client_tx_bytes:
type: number
description: Summary troubleshooting metric value for bytes transmitted by the client
examples:
- 0.00102365511655807
client_tx_rates:
type: number
description: Summary troubleshooting metric value for client transmit data rates
examples:
- 0.22236637771129608
client_tx_retries:
type: number
description: Summary troubleshooting metric value for client transmit retries
examples:
- 0.3308201730251312
client_vpn_distance:
type: number
description: Summary troubleshooting metric value for client VPN distance
examples:
- -0.0001660545531194657
client_wifi_version:
type: number
description: Summary troubleshooting metric value for the client Wi-Fi version
examples:
- 7.0566701889E-07
expected:
type: number
description: Model baseline value expected for this call sample
examples:
- -2.8630001056670187
radio_ap_change:
type: number
description: Summary troubleshooting metric value for AP changes on the radio path
examples:
- 0.01850946433842182
radio_bandwidth:
type: number
description: Summary troubleshooting metric value for radio channel bandwidth
examples:
- -0.021175479516386986
radio_channel:
type: number
description: Summary troubleshooting metric value for the radio channel
examples:
- 0.11686426401138306
radio_rx_failed:
type: number
description: Summary troubleshooting metric value for failed radio receive attempts
examples:
- 1.1782013177871704
radio_tx_power:
type: number
description: Summary troubleshooting metric value for radio transmit power
examples:
- 0.121039018034935
radio_util:
type: number
description: Summary troubleshooting metric value for radio utilization
examples:
- 0.2452986091375351
radio_util_interference:
type: number
description: Summary troubleshooting metric value for radio interference utilization
examples:
- 3.4367904663085938
site_num_clients:
type: number
description: Summary troubleshooting metric value for the number of clients at the site
examples:
- 0.055026158690452576
site_wan_avg_download_mbps:
type: number
description: Summary troubleshooting metric value for site WAN average download throughput
examples:
- 3.0566701889E-07
site_wan_avg_upload_mbps:
type: number
description: Summary troubleshooting metric value for site WAN average upload throughput
examples:
- 5.566701889E-08
site_wan_download_mbps:
type: number
description: Summary troubleshooting metric value for site WAN download throughput
examples:
- 8.0566701889E-07
site_wan_jitter:
type: number
description: Summary troubleshooting metric value for site WAN jitter
examples:
- 0.7875519659784105
site_wan_rtt:
type: number
description: Summary troubleshooting metric value for site WAN round-trip time
examples:
- 15.094849904378256
site_wan_upload_mbps:
type: number
description: Summary troubleshooting metric value for site WAN upload throughput
examples:
- 2.0566701889E-07
timestamp:
type: number
description: Time when this call troubleshooting sample was recorded
readOnly: true
video_in:
allOf:
- $ref: '#/components/schemas/call_troubleshoot_summary_data2'
- description: Troubleshooting metrics for the inbound video stream
video_out:
allOf:
- $ref: '#/components/schemas/call_troubleshoot_summary_data3'
- description: Troubleshooting metrics for the outbound video stream
description: Summary row for call troubleshooting metrics
call_troubleshoot_summary_data:
title: call_troubleshoot_summary_data
type: object
properties:
ap_num_clients:
type: number
description: Media-direction metric value for AP client count
examples:
- -0.6565111
ap_rtt:
type: number
description: Media-direction metric value for AP round-trip time
examples:
- 0.16559607
client_cpu:
type: number
description: Media-direction metric value for client CPU load
examples:
- 3.7028809
client_n_streams:
type: number
description: Media-direction metric value for the number of client spatial streams
examples:
- 0.15803306
client_radio_band:
type: number
description: Media-direction metric value for the client radio band
examples:
- 0.5576923
client_rssi:
type: number
description: Media-direction metric value for client RSSI
examples:
- -1.0839354
client_rx_bytes:
type: number
description: Media-direction metric value for bytes received by the client
examples:
- 2.2622051
client_rx_rates:
type: number
description: Media-direction metric value for client receive data rates
examples:
- 0.26726437
client_tx_bytes:
type: number
description: Media-direction metric value for bytes transmitted by the client
examples:
- 6.6164713
client_tx_rates:
type: number
description: Media-direction metric value for client transmit data rates
examples:
- 0.62357205
client_tx_retries:
type: number
description: Media-direction metric value for client transmit retries
examples:
- 1.702031
client_vpn_distance:
type: number
description: Media-direction metric value for client VPN distance
examples:
- 1.6474955
client_wifi_version:
type: number
description: Media-direction metric value for the client Wi-Fi version
examples:
- 0.18267937
expected:
type: number
description: Model baseline value expected for this media direction
examples:
- 30.941595
radio_bandwidth:
type: number
description: Media-direction metric value for radio channel bandwidth
examples:
- -0.06538621
radio_channel:
type: number
description: Media-direction metric value for the radio channel
examples:
- -0.73391086
radio_tx_power:
type: number
description: Media-direction metric value for radio transmit power
examples:
- 0.10027129
radio_util:
type: number
description: Media-direction metric value for radio utilization
examples:
- 12.770318
radio_util_interference:
type: number
description: Media-direction metric value for radio interference utilization
examples:
- -3.079999
site_num_clients:
type: number
description: Media-direction metric value for the number of clients at the site
examples:
- 0.017364305
site_wan_avg_download_mbps:
type: number
description: Media-direction metric value for site WAN average download throughput
examples:
- 3.0566701889E-07
site_wan_avg_upload_mbps:
type: number
description: Media-direction metric value for site WAN average upload throughput
examples:
- 5.566701889E-08
site_wan_download_mbps:
type: number
description: Media-direction metric value for site WAN download throughput
examples:
- 8.0566701889E-07
site_wan_jitter:
type: number
description: Media-direction metric value for site WAN jitter
examples:
- 0.7875519659784105
site_wan_rtt:
type: number
description: Media-direction metric value for site WAN round-trip time
examples:
- 15.094849904378256
site_wan_upload_mbps:
type: number
description: Media-direction metric value for site WAN upload throughput
examples:
- 2.0566701889E-07
wan_avg_download_mbps:
type: number
description: Media-direction metric value for average WAN download throughput
examples:
- 1.4803165
wan_avg_upload_mbps:
type: number
description: Media-direction metric value for average WAN upload throughput
examples:
- -0.038184267
wan_jitter:
type: number
description: Media-direction metric value for WAN jitter
examples:
- 5.9680853
wan_max_download_mbps:
type: number
description: Media-direction metric value for maximum WAN download throughput
examples:
- 1.4803165
wan_max_upload_mbps:
type: number
description: Media-direction metric value for maximum WAN upload throughput
examples:
- -0.038184267
wan_rtt:
type: number
description: Media-direction metric value for WAN round-trip time
examples:
- 46.77899
description: Media-direction call troubleshooting metrics in a summary response
troubleshoot_call_item:
title: troubleshoot_call_item
type: object
properties:
ap_num_clients:
type: number
description: Troubleshooting metric value for AP client count
examples:
- -0.08802365511655807
ap_rtt:
type: number
description: Troubleshooting metric value for AP round-trip time
examples:
- 0.09924473613500595
audio_in:
allOf:
- $ref: '#/components/schemas/call_troubleshoot_data5'
- description: Troubleshooting metrics for the inbound audio stream
audio_out:
allOf:
- $ref: '#/components/schemas/call_troubleshoot_data1'
- description: Troubleshooting metrics for the outbound audio stream
client_cpu:
type: number
description: Troubleshooting metric value for client CPU load
examples:
- 0.00834270566701889
client_n_streams:
type: number
description: Troubleshooting metric value for the number of client spatial streams
examples:
- 0.00734270566701889
client_radio_band:
type: number
description: Troubleshooting metric value for the client radio band
examples:
- 0.5841414928436279
client_rssi:
type: number
description: Troubleshooting metric value for client RSSI
examples:
- 0.7594696879386902
client_rx_bytes:
type: number
description: Troubleshooting metric value for bytes received by the client
examples:
- 2.365511655807E-05
client_rx_rates:
type: number
description: Troubleshooting metric value for client receive data rates
examples:
- 0.02441493794322014
client_rx_retries:
type: number
description: Troubleshooting metric value for client receive retries
examples:
- -0.14325742423534393
client_tx_bytes:
type: number
description: Troubleshooting metric value for bytes transmitted by the client
examples:
- 0.00102365511655807
client_tx_rates:
type: number
description: Troubleshooting metric value for client transmit data rates
examples:
- 0.22236637771129608
client_tx_retries:
type: number
description: Troubleshooting metric value for client transmit retries
examples:
- 0.3308201730251312
client_vpn_distance:
type: number
description: Troubleshooting metric value for client VPN distance
examples:
- -0.0001660545531194657
client_wifi_version:
type: number
description: Troubleshooting metric value for the client Wi-Fi version
examples:
- 7.0566701889E-07
expected:
type: number
description: Model baseline value expected for this call sample
examples:
- -2.8630001056670187
radio_ap_change:
type: number
description: Troubleshooting metric value for AP changes on the radio path
examples:
- 0.01850946433842182
radio_bandwidth:
type: number
description: Troubleshooting metric value for radio channel bandwidth
examples:
- -0.021175479516386986
radio_channel:
type: number
description: Troubleshooting metric value for the radio channel
examples:
- 0.11686426401138306
radio_rx_failed:
type: number
description: Troubleshooting metric value for failed radio receive attempts
examples:
- 1.1782013177871704
radio_tx_power:
type: number
description: Troubleshooting metric value for radio transmit power
examples:
- 0.121039018034935
radio_util:
type: number
description: Troubleshooting metric value for radio utilization
examples:
- 0.2452986091375351
radio_util_interference:
type: number
description: Troubleshooting metric value for radio interference utilization
examples:
- 3.4367904663085938
site_num_clients:
type: number
description: Troubleshooting metric value for the number of clients at the site
examples:
- 0.055026158690452576
site_wan_avg_download_mbps:
type: number
description: Troubleshooting metric value for site WAN average download throughput
examples:
- 3.0566701889E-07
site_wan_avg_upload_mbps:
type: number
description: Troubleshooting metric value for site WAN average upload throughput
examples:
- 5.566701889E-08
site_wan_download_mbps:
type: number
description: Troubleshooting metric value for site WAN download throughput
examples:
- 8.0566701889E-07
site_wan_jitter:
type: number
description: Troubleshooting metric value for site WAN jitter
examples:
- 1.00566701889E-06
site_wan_rtt:
type: number
description: Troubleshooting metric value for site WAN round-trip time
examples:
- 4.0566701889E-07
site_wan_upload_mbps:
type: number
description: Troubleshooting metric value for site WAN upload throughput
examples:
- 2.0566701889E-07
timestamp:
type: number
description: Time when this call troubleshooting sample was recorded
readOnly: true
video_in:
allOf:
- $ref: '#/components/schemas/call_troubleshoot_data2'
- description: Troubleshooting metrics for the inbound video stream
video_out:
allOf:
- $ref: '#/components/schemas/call_troubleshoot_data3'
- description: Troubleshooting metrics for the outbound video stream
description: Per-sample call troubleshooting metrics
capture_client:
title: capture_client
required:
- type
type: object
properties:
ap_mac:
type:
- string
- 'null'
description: AP MAC address used to target the client packet capture
client_mac:
type:
- string
- 'null'
description: Client MAC address, required if `type`==`client`; optional otherwise
examples:
- 60a10a773412
duration:
maximum: 86400
minimum: 60
type:
- integer
- 'null'
description: Packet capture duration, in seconds
contentEncoding: int32
default: 600
examples:
- 300
includes_mcast:
type: boolean
description: Whether to include multicast traffic in the packet capture
default: false
max_pkt_len:
maximum: 2048
minimum: 64
type:
- integer
- 'null'
description: Maximum number of bytes captured from each packet
contentEncoding: int32
default: 512
examples:
- 128
num_packets:
maximum: 10000
minimum: 0
type:
- integer
- 'null'
description: Maximum number of packets to capture; use 0 for unlimited
contentEncoding: int32
default: 1024
examples:
- 1000
ssid:
type:
- string
- 'null'
description: Optional SSID filter for the packet capture
type:
const: client
type: string
description: Packet capture type discriminator for client captures
examples:
- client
description: Initiate a Client Packet Capture
capture_client_type:
title: capture_client_type
const: client
type: string
description: 'Packet capture type discriminator for client captures. enum: `client`'
examples:
- client
capture_gateway:
title: capture_gateway
required:
- gateways
- type
type: object
properties:
duration:
maximum: 86400
minimum: 60
type:
- integer
- 'null'
description: Packet capture duration, in seconds
contentEncoding: int32
default: 600
examples:
- 300
format:
allOf:
- $ref: '#/components/schemas/capture_gateway_format2'
- description: 'Output format for the gateway packet capture. enum: `stream`.'
examples:
- stream
gateways:
type: object
additionalProperties:
$ref: '#/components/schemas/capture_gateway_gateways'
description: List of SSRs. Property key is the SSR MAC
max_pkt_len:
maximum: 1520
minimum: 64
type:
- integer
- 'null'
description: minimum is 64 (SSR) / 68 (SRX) maximum is 10240 (SSR) / 1520 (SRX)
contentEncoding: int32
default: 512
examples:
- 128
num_packets:
maximum: 10000
minimum: 0
type:
- integer
- 'null'
description: Maximum number of packets to capture; use 0 for unlimited
contentEncoding: int32
default: 1024
examples:
- 1000
ports:
type: object
additionalProperties:
$ref: '#/components/schemas/capture_gateway_gateways_port'
description: Gateway ports to include in the packet capture
type:
const: gateway
type: string
description: Packet capture type discriminator for gateway captures
examples:
- gateway
description: Initiate a Gateway (SSR/SRX) Packet Capture
capture_gateway_format:
title: capture_gateway_format
const: stream
type: string
description: 'Output format for the gateway packet capture. enum: `stream`'
examples:
- stream
capture_gateway_gateways:
title: capture_gateway_gateways
type: object
properties:
ports:
type: object
additionalProperties:
$ref: '#/components/schemas/capture_gateway_gateways_port'
description: Gateway ports to include in the capture, keyed by port ID
description: Gateway-specific packet capture settings keyed under a gateway MAC address
capture_gateway_gateways_port:
title: capture_gateway_gateways_port
type: object
properties:
tcpdump_expression:
type: string
description: tcpdump expression per port
description: Per-port tcpdump filter for a gateway packet capture
capture_gateway_type:
title: capture_gateway_type
const: gateway
type: string
description: 'Packet capture type discriminator for gateway captures. enum: `gateway`'
examples:
- gateway
capture_mxedge:
title: capture_mxedge
required:
- type
type: object
properties:
duration:
maximum: 10800
minimum: 60
type: integer
description: Packet capture duration, in seconds. Default is 600, minimum is 60 and maximum is 10800 (3h)
contentEncoding: int32
default: 600
examples:
- 600
format:
allOf:
- $ref: '#/components/schemas/capture_mxedge_format3'
- description: 'Output format for the Mist Edge packet capture. enum: `stream`, `tzsp`.'
max_pkt_len:
maximum: 2048
minimum: 64
type: integer
description: Max_len of each packet to capture. Default is 512, minimum is 64 and maximum is 2048
contentEncoding: int32
default: 512
examples:
- 512
mxedges:
type: object
additionalProperties:
$ref: '#/components/schemas/capture_mxedge_mxedges'
description: Dict of Mist Edges to capture on, property key is the Mist Edge ID. Property value is a dict of interfaces to capture for the given Mist Edge (e.g. port1, kni0, lacp0, ipsec, drop, oobm)
num_packets:
maximum: 10000
minimum: 0
type: integer
description: Number of packets to capture. Default is 1024, maximum is 10000, minimum 1, or 0 for unlimited (local/remote streaming only)
contentEncoding: int32
default: 1024
examples:
- 100
tcpdump_expression:
type: string
description: tcpdump expression, applicable across all interfaces if specified at top level. An interface-specific value (under the `interfaces` dict) overrides this top-level value.
type:
const: mxedge
type: string
description: 'Packet capture type discriminator for Mist Edge captures. enum: `mxedge`.'
examples:
- mxedge
tzsp_host:
type: string
description: Required if `format`==`tzsp`. Remote host accessible to mxedges over the network for receiving the captured packets
examples:
- 192.168.1.2
tzsp_port:
maximum: 65535
minimum: 1
type: integer
description: Optional port on remote host for receiving the captured packets. Default is 37008 (TZSP)
contentEncoding: int32
default: 37008
description: Initiate a Mist Edge Packet Capture
capture_mxedge_format:
title: capture_mxedge_format
enum:
- stream
- tzsp
type: string
description: "PCAP format. enum: \n * `stream`: to Mist cloud\n * `tzsp`: stream packets (over UDP as TZSP packets) to a remote host (typically running Wireshark)"
capture_mxedge_mxedges:
title: capture_mxedge_mxedges
type: object
properties:
interfaces:
type: object
additionalProperties:
$ref: '#/components/schemas/capture_mxedge_mxedges_interfaces'
description: Mx Edge interfaces to include in the capture, keyed by interface name
description: Property key is the Mx Edge ID, currently limited to one mxedge per org capture session
capture_mxedge_mxedges_interfaces:
title: capture_mxedge_mxedges_interfaces
type: object
properties:
tcpdump_expression:
type: string
description: tcpdump expression common for wired,radiotap
description: Property key is the Port name (e.g. "port1", "kni0", "lacp0", "ipsec", "drop", "oobm"), currently limited to specifying one interface per mxedge
capture_mxedge_type:
title: capture_mxedge_type
const: mxedge
type: string
description: 'Packet capture type discriminator for Mist Edge captures. enum: `mxedge`'
examples:
- mxedge
capture_new_assoc:
title: capture_new_assoc
required:
- type
type: object
properties:
ap_mac:
type: string
description: AP MAC address used to target new association capture
examples:
- a83a79a947ee
client_mac:
type: string
description: Client MAC address, required if `type`==`client`; optional otherwise
examples:
- 60a10a773412
duration:
maximum: 86400
minimum: 60
type:
- integer
- 'null'
description: Packet capture duration, in seconds
contentEncoding: int32
default: 600
examples:
- 300
includes_mcast:
type: boolean
description: Whether to include multicast traffic in the packet capture
default: false
max_pkt_len:
maximum: 2048
minimum: 64
type:
- integer
- 'null'
description: Maximum number of bytes captured from each packet
contentEncoding: int32
default: 512
examples:
- 128
num_packets:
maximum: 10000
minimum: 0
type:
- integer
- 'null'
description: Maximum number of packets to capture; use 0 for unlimited
contentEncoding: int32
default: 1024
examples:
- 1000
ssid:
type: string
description: Optional SSID filter for new association capture
type:
const: new_assoc
type: string
description: 'Packet capture type discriminator for new association captures. enum: `new_assoc`.'
examples:
- new_assoc
description: Initiate a packet Capture for New Wireless Client Associations
capture_new_assoc_type:
title: capture_new_assoc_type
const: new_assoc
type: string
description: 'Packet capture type discriminator for new association captures. enum: `new_assoc`'
examples:
- new_assoc
capture_radiotap:
title: capture_radiotap
required:
- type
type: object
properties:
ap_mac:
type: string
description: AP MAC address used to target the radiotap packet capture
examples:
- a83a79a947ee
band:
allOf:
- $ref: '#/components/schemas/capture_radiotap_band2'
- description: 'Radio band to capture for radiotap packets. enum: `24`, `24,5,6`, `5`, `6`.'
examples:
- '24'
client_mac:
type: string
description: Client MAC address used to filter the radiotap packet capture
examples:
- 38f9d3972ff1
duration:
maximum: 86400
minimum: 60
type:
- integer
- 'null'
description: Packet capture duration, in seconds
contentEncoding: int32
default: 600
examples:
- 300
format:
allOf:
- $ref: '#/components/schemas/capture_radiotap_format2'
- description: 'Output format for the radiotap packet capture. enum: `pcap`, `stream`.'
examples:
- stream
max_pkt_len:
maximum: 2048
minimum: 64
type:
- integer
- 'null'
description: Maximum number of bytes captured from each packet
contentEncoding: int32
default: 512
examples:
- 128
num_packets:
maximum: 10000
minimum: 0
type:
- integer
- 'null'
description: Maximum number of packets to capture; use 0 for unlimited
contentEncoding: int32
default: 1024
examples:
- 1000
ssid:
type: string
description: Wireless network SSID used to filter the radiotap packet capture
examples:
- test
tcpdump_expression:
type:
- string
- 'null'
description: Filter expression applied to the radiotap packet capture
examples:
- tcp port 80
type:
const: radiotap
type: string
description: Packet capture type discriminator for radiotap captures
examples:
- radiotap
wlan_id:
type: string
description: WLAN id associated with the respective ssid.
contentEncoding: uuid
examples:
- fac8e973-feb9-421a-b381-aabbc4b61f5a
description: Initiate a Radiotap Packet Capture
capture_radiotap_band:
title: capture_radiotap_band
enum:
- '24'
- 24,5,6
- '5'
- '6'
type: string
description: 'enum: `24`, `24,5,6`, `5`, `6`'
examples:
- '24'
capture_radiotap_format:
title: capture_radiotap_format
enum:
- pcap
- stream
type: string
description: 'Output format for the radiotap packet capture. enum: `pcap`, `stream`'
examples:
- stream
capture_radiotap_type:
title: capture_radiotap_type
const: radiotap
type: string
description: 'Packet capture type discriminator for radiotap captures. enum: `radiotap`'
examples:
- radiotap
capture_radiotapwired:
title: capture_radiotapwired
required:
- type
type: object
properties:
ap_mac:
type:
- string
- 'null'
description: AP MAC address used to target the combined radiotap and wired packet capture
band:
allOf:
- $ref: '#/components/schemas/capture_radiotapwired_band2'
- description: 'Radio band to capture for the radiotap portion. enum: `24`, `24,5,6`, `5`, `6`.'
examples:
- '24'
client_mac:
type:
- string
- 'null'
description: Client MAC address used to filter the combined packet capture
examples:
- 38f9d3972ff1
duration:
maximum: 86400
minimum: 60
type:
- integer
- 'null'
description: Packet capture duration, in seconds
contentEncoding: int32
default: 600
examples:
- 300
format:
allOf:
- $ref: '#/components/schemas/capture_radiotapwired_format2'
- description: 'Output format for the combined packet capture. enum: `pcap`, `stream`.'
examples:
- stream
max_pkt_len:
maximum: 2048
minimum: 64
type:
- integer
- 'null'
description: Maximum number of bytes captured from each packet
contentEncoding: int32
default: 512
examples:
- 128
num_packets:
maximum: 10000
minimum: 0
type:
- integer
- 'null'
description: Maximum number of packets to capture; use 0 for unlimited
contentEncoding: int32
default: 1024
examples:
- 1000
radiotap_tcpdump_expression:
type: string
description: tcpdump expression for radiotap interface (802.11 + radio headers)
examples:
- type
ssid:
type:
- string
- 'null'
description: Wireless network SSID used to filter the radiotap portion
examples:
- test
tcpdump_expression:
type:
- string
- 'null'
description: Filter expression applied across the combined packet capture
examples:
- tcp port 80
type:
const: radiotap,wired
type: string
description: 'Packet capture type discriminator for combined radiotap and wired captures. enum: `radiotap,wired`.'
examples:
- radiotap,wired
wired_tcpdump_expression:
type:
- string
- 'null'
description: Filter expression applied to the wired portion of the capture
examples:
- tcp port 80
wireless_tcpdump_expression:
type: string
description: tcpdump expression for radiotap interface (802.11)
wlan_id:
type:
- string
- 'null'
description: WLAN id associated with the respective ssid.
examples:
- fac8e973-feb9-421a-b381-aabbc4b61f5a
description: Initiate a Radiotap Packet Capture and Wired Packet Capture
capture_radiotapwired_band:
title: capture_radiotapwired_band
enum:
- '24'
- 24,5,6
- '5'
- '6'
type: string
description: 'only used for radiotap. enum: `24`, `24,5,6`, `5`, `6`'
examples:
- '24'
capture_radiotapwired_format:
title: capture_radiotapwired_format
enum:
- pcap
- stream
type: string
description: 'Output format for the combined packet capture. enum: `pcap`, `stream`'
examples:
- stream
capture_radiotapwired_type:
title: capture_radiotapwired_type
const: radiotap,wired
type: string
description: 'Packet capture type discriminator for combined radiotap and wired captures. enum: `radiotap,wired`'
examples:
- radiotap,wired
capture_scan:
title: capture_scan
required:
- type
type: object
properties:
ap_mac:
type:
- string
- 'null'
description: AP MAC address used to filter the scan radio packet capture
aps:
type: object
additionalProperties:
$ref: '#/components/schemas/capture_scan_aps'
description: Dictionary key is AP mac and value is a dictionary which contains key "band", "bandwidth", "channel" and "tcpdump_expression". In case keys are missed we will take parent value if parent values are not set we will use default value
band:
allOf:
- oneOf:
- {}
- $ref: '#/components/schemas/capture_scan_band2'
- description: 'Radio band to capture for scan radio packets. enum: `24`, `5`, `6`.'
examples:
- '24'
bandwidth:
allOf:
- $ref: '#/components/schemas/dot11_bandwidth1'
- description: 'Channel bandwidth to use for the scan radio packet capture. enum: `0`, `20`, `40`, `80`, `160`.'
examples:
- 20
channel:
type: integer
description: Specify the channel value where scan PCAP has to be started, default value gets applied when user provides wrong values
contentEncoding: int32
default: 1
examples:
- 1
client_mac:
type:
- string
- 'null'
description: Client MAC address used to filter the scan radio packet capture
examples:
- 38f9d3972ff1
duration:
maximum: 86400
minimum: 60
type:
- integer
- 'null'
description: Packet capture duration, in seconds
contentEncoding: int32
default: 600
examples:
- 300
format:
allOf:
- $ref: '#/components/schemas/capture_scan_format2'
- description: 'Output format for the scan radio packet capture. enum: `pcap`, `stream`.'
examples:
- stream
max_pkt_len:
maximum: 2048
minimum: 64
type:
- integer
- 'null'
description: Maximum number of bytes captured from each packet
contentEncoding: int32
default: 512
examples:
- 128
num_packets:
maximum: 10000
minimum: 0
type:
- integer
- 'null'
description: Maximum number of packets to capture; use 0 for unlimited
contentEncoding: int32
default: 1024
examples:
- 1000
tcpdump_expression:
type: string
description: tcpdump expression, port specific if specified under ports dict, otherwise applicable across ports if specified at top level of payload. Port specific value overrides top level value when both exist.
examples:
- tcp port 80
type:
const: scan
type: string
description: Packet capture type discriminator for scan radio captures
examples:
- scan
width:
type: string
description: Specify the bandwidth value with respect to the channel.
description: Initiate a Scan Radio Packet Capture
capture_scan_aps:
title: capture_scan_aps
type: object
properties:
band:
allOf:
- $ref: '#/components/schemas/capture_scan_aps_band2'
- description: 'Radio band on which to start the scan capture. enum: `24`, `5`, `6`.'
channel:
type: string
description: Specify the channel value where scan PCAP has to be started
tcpdump_expression:
type: string
description: tcpdump expression, port specific if specified under ports dict, otherwise applicable across ports if specified at top level of payload. Port specific value overrides top level value when both exist.
width:
type: string
description: Specify the bandwidth value with respect to the channel.
description: Property key is the AP MAC address (e.g. "5c5b35000001"). All optionals, parent parameters will be used if not defined
capture_scan_aps_band:
title: capture_scan_aps_band
enum:
- '24'
- '5'
- '6'
type: string
description: 'Only Single value allowed. enum: `24`, `5`, `6`'
capture_scan_band:
title: capture_scan_band
enum:
- '24'
- '5'
- '6'
type: string
description: 'Only Single value allowed, default value gets applied when user provides wrong values. enum: `24`, `5`, `6`'
examples:
- '24'
capture_scan_format:
title: capture_scan_format
enum:
- pcap
- stream
type: string
description: 'Output format for the scan radio packet capture. enum: `pcap`, `stream`'
examples:
- stream
capture_scan_type:
title: capture_scan_type
const: scan
type: string
description: 'Packet capture type discriminator for scan radio captures. enum: `scan`'
examples:
- scan
capture_switch:
title: capture_switch
required:
- switches
- type
type: object
properties:
duration:
maximum: 86400
minimum: 60
type:
- integer
- 'null'
description: Packet capture duration, in seconds
contentEncoding: int32
default: 600
examples:
- 300
format:
allOf:
- $ref: '#/components/schemas/capture_switch_format2'
- description: 'Output format for the switch packet capture. enum: `stream`.'
max_pkt_len:
maximum: 2048
minimum: 64
type:
- integer
- 'null'
description: Maximum number of bytes captured from each packet
contentEncoding: int32
default: 512
examples:
- 128
num_packets:
maximum: 10000
minimum: 0
type:
- integer
- 'null'
description: Maximum number of packets to capture; use 0 for unlimited
contentEncoding: int32
default: 1024
examples:
- 1000
ports:
type: object
additionalProperties:
$ref: '#/components/schemas/capture_switch_ports_tcpdump_expression'
description: Switch ports to include in the packet capture
switches:
type: object
additionalProperties:
$ref: '#/components/schemas/capture_switch_switches'
description: Property key is the switch MAC address
tcpdump_expression:
type: string
description: tcpdump expression, port specific if specified under ports dict, otherwise applicable across ports if specified at top level of payload. Port specific value overrides top level value when both exist.
examples:
- port 443
type:
const: switch
type: string
description: Packet capture type discriminator for switch captures
examples:
- switch
description: Initiate a Switch (Junos) Packet Capture
capture_switch_format:
title: capture_switch_format
const: stream
type: string
description: 'Output format for the switch packet capture. enum: `stream`'
capture_switch_ports_tcpdump_expression:
title: capture_switch_ports_tcpdump_expression
type: object
properties:
tcpdump_expression:
type: string
description: tcpdump expression, port specific if specified under ports dict, otherwise applicable across ports if specified at top level of payload. Port specific value overrides top level value when both exist.
examples:
- port 443
description: Per-port tcpdump filter for a switch packet capture
capture_switch_switches:
title: capture_switch_switches
type: object
properties:
ports:
type: object
additionalProperties:
$ref: '#/components/schemas/capture_switch_ports_tcpdump_expression'
description: Switch ports to include in the capture, keyed by port ID
description: Switch-specific packet capture settings keyed under a switch MAC address
capture_switch_type:
title: capture_switch_type
const: switch
type: string
description: 'Packet capture type discriminator for switch captures. enum: `switch`'
examples:
- switch
capture_wired:
title: capture_wired
required:
- type
type: object
properties:
ap_mac:
type:
- string
- 'null'
description: AP MAC address used to target the wired packet capture
duration:
maximum: 86400
minimum: 60
type:
- integer
- 'null'
description: Packet capture duration, in seconds
contentEncoding: int32
default: 600
examples:
- 300
format:
allOf:
- $ref: '#/components/schemas/capture_wired_format2'
- description: 'Output format for the wired packet capture. enum: `pcap`, `stream`.'
max_pkt_len:
maximum: 2048
minimum: 64
type:
- integer
- 'null'
description: Maximum number of bytes captured from each packet
contentEncoding: int32
default: 512
examples:
- 128
num_packets:
maximum: 10000
minimum: 0
type:
- integer
- 'null'
description: Maximum number of packets to capture; use 0 for unlimited
contentEncoding: int32
default: 1024
examples:
- 1000
tcpdump_expression:
type:
- string
- 'null'
description: Filter expression applied to the wired packet capture
examples:
- tcp port 80
type:
const: wired
type: string
description: Packet capture type discriminator for wired captures
examples:
- wired
description: Initiate a Wired Packet Capture
capture_wired_format:
title: capture_wired_format
enum:
- pcap
- stream
type: string
description: 'pcap format. enum: `pcap`, `stream`'
capture_wired_type:
title: capture_wired_type
const: wired
type: string
description: 'Packet capture type discriminator for wired captures. enum: `wired`'
examples:
- wired
capture_wireless:
title: capture_wireless
required:
- type
type: object
properties:
ap_mac:
type:
- string
- 'null'
description: AP MAC address used to target the wireless packet capture
band:
allOf:
- $ref: '#/components/schemas/capture_wireless_band2'
- description: 'Radio band to capture for wireless packets. enum: `24`, `5`, `6`.'
duration:
maximum: 86400
minimum: 60
type:
- integer
- 'null'
description: Packet capture duration, in seconds
contentEncoding: int32
default: 600
examples:
- 300
format:
allOf:
- $ref: '#/components/schemas/capture_wireless_format2'
- description: 'Output format for the wireless packet capture. enum: `pcap`, `stream`.'
max_pkt_len:
maximum: 2048
minimum: 64
type:
- integer
- 'null'
description: Maximum number of bytes captured from each packet
contentEncoding: int32
default: 512
examples:
- 128
num_packets:
maximum: 10000
minimum: 0
type:
- integer
- 'null'
description: Maximum number of packets to capture; use 0 for unlimited
contentEncoding: int32
default: 1024
examples:
- 1000
ssid:
type: string
description: Wireless network SSID used to filter the packet capture
type:
const: wireless
type: string
description: Packet capture type discriminator for wireless captures
examples:
- wireless
wlan_id:
type: string
description: WLAN identifier used to filter the wireless packet capture
contentEncoding: uuid
description: Initiate a Wireless Packet Capture
capture_wireless_band:
title: capture_wireless_band
enum:
- '24'
- '5'
- '6'
type: string
description: 'enum: `24`, `5`, `6`'
capture_wireless_format:
title: capture_wireless_format
enum:
- pcap
- stream
type: string
description: 'pcap format. enum: `pcap`, `stream`'
capture_wireless_type:
title: capture_wireless_type
const: wireless
type: string
description: 'Packet capture type discriminator for wireless captures. enum: `wireless`'
examples:
- wireless
claim_activation:
title: claim_activation
required:
- code
- type
type: object
properties:
code:
type: string
description: Activation or license claim code to redeem
device_type:
allOf:
- $ref: '#/components/schemas/device_type_default_ap1'
- description: 'If only intended to claim a certain device type, specify it here. enum: `ap`, `gateway`, `switch`.'
type:
allOf:
- $ref: '#/components/schemas/claim_type2'
- description: Claim scope, such as all, inventory, or license
description: Request to claim organization licenses or activation codes
claim_activation_async:
title: claim_activation_async
required:
- code
- type
type: object
properties:
code:
type: string
description: Activation code to claim
device_type:
allOf:
- $ref: '#/components/schemas/device_type_default_ap1'
- description: 'If only intended to claim a certain device type, specify it here. enum: `ap`, `gateway`, `switch`.'
type:
allOf:
- $ref: '#/components/schemas/claim_type_async2'
- description: Claim scope; `all` claims licenses synchronously and queues inventory, `inventory` queues inventory only
description: Request to schedule an asynchronous inventory claim
claim_type:
title: claim_type
enum:
- all
- inventory
- license
type: string
description: 'what to claim. enum: `all`, `inventory`, `license`'
claim_type_async:
title: claim_type_async
enum:
- all
- inventory
type: string
description: 'Claim scope for async inventory claiming. enum: `all`, `inventory`'
clear_dot1x_session:
title: clear_dot1x_session
type: object
properties:
ports:
type: array
items:
type: string
description: Port IDs whose dot1x sessions should be cleared
examples:
- - ge-0/0/0
- ge-0/0/1
description: Request body for clearing dot1x sessions on switch ports
clear_policy_hit_count:
title: clear_policy_hit_count
required:
- policy_name
type: object
properties:
policy_name:
type: string
description: Application policy name whose hit counters should be cleared
description: Request body for clearing hit counters on an application policy
client_cert_serial_numbers:
title: client_cert_serial_numbers
type: object
properties:
serial_numbers:
uniqueItems: true
type: array
items:
type: string
description: Certificate serial numbers to revoke
description: Client certificate serial numbers targeted by a certificate operation
examples:
- serial_numbers:
- 13 00 13 03 23 EE D5 84 01
client_info_source:
title: client_info_source
enum:
- lldp
- mac
type: string
description: 'source from where the client was learned (lldp, mac). enum: `lldp`, `mac`'
client_key_mgmt:
title: client_key_mgmt
enum:
- WPA2-PSK
- WPA2-PSK/CCMP
- WPA2-PSK-FT
- WPA2-PSK-SHA256
- WPA3-EAP-SHA256
- WPA3-EAP-SHA256/CCMP
- WPA3-EAP-FT/GCMP256
- WPA3-SAE-FT
- WPA3-SAE-PSK
type: string
description: 'Key management protocol used for the latest authentication. enum: `WPA2-PSK`, `WPA2-PSK/CCMP`, `WPA2-PSK-FT`, `WPA2-PSK-SHA256`, `WPA3-EAP-SHA256`, `WPA3-EAP-SHA256/CCMP`, `WPA3-EAP-FT/GCMP256`, `WPA3-SAE-FT`, `WPA3-SAE-PSK`'
examples:
- WPA2-PSK
client_nac:
title: client_nac
type: object
properties:
ap:
type: array
items:
type: string
description: Observed AP MAC addresses for the NAC client during the query duration
readOnly: true
examples:
- - 5c5b35bf16bb
- d4dc090041b4
auth_type:
allOf:
- $ref: '#/components/schemas/nac_auth_type5'
- description: 'Authentication method used by the NAC client. enum: `cert`, `device-auth`, `eap-teap`, `eap-tls`, `eap-ttls`, `idp`, `mab`, `eap-peap`.'
examples:
- eap-tls
cert_cn:
type: array
items:
type: string
description: Certificate common names observed for the client during the query duration
readOnly: true
examples:
- - john@mycorp.net
cert_issuer:
type: array
items:
type: string
description: Certificate issuers observed for the client during the query duration
readOnly: true
examples:
- - /C=US/ST=CA/CN=MyCorp
cert_serial:
type: array
items:
type: string
description: Certificate serial numbers observed for the client during the query duration
readOnly: true
examples:
- - 2c63510123456789
cert_subject:
type: array
items:
type: string
description: Certificate subjects observed for the client during the query duration
readOnly: true
examples:
- - /C=US/O=MyCorp/CN=john@mycorp.net/emailAddress=john@mycorp.net
client_ip:
type: array
items:
type: string
description: Client IP addresses observed during the query duration
readOnly: true
examples:
- - 10.100.0.157
device_mac:
type: string
description: MAC address of the AP or switch handling the NAC client session
readOnly: true
examples:
- 60c78d8c7f6f
edr_managed:
type: boolean
description: Whether the NAC client is managed by an EDR provider
edr_providers:
type: array
items:
$ref: '#/components/schemas/edr_provider'
description: EDR providers associated with the NAC client
edr_status:
type: array
items:
$ref: '#/components/schemas/edr_status'
description: EDR health statuses reported for the NAC client
group:
type: string
description: User group associated with the NAC client
idp_id:
type: string
description: Identity Provider identifier used during NAC authentication
idp_role:
uniqueItems: true
type: array
items:
type: string
description: Identity Provider roles or groups returned for the NAC client
last_ap:
type: string
description: Most recent AP MAC address used by the NAC client
examples:
- a83a79a947ee
last_cert_cn:
type: string
description: Most recent certificate common name used by the NAC client
examples:
- john@mycorp.net
last_cert_expiry:
type: number
description: Most recent certificate expiration timestamp for the NAC client
examples:
- 1746711240
last_cert_issuer:
type: string
description: Most recent certificate issuer used by the NAC client
examples:
- /C=US/ST=CA/CN=MyCorp
last_cert_serial:
type: string
description: Most recent certificate serial number used by the NAC client
examples:
- 2c63510123456789
last_cert_subject:
type: string
description: Most recent certificate subject used by the NAC client
examples:
- /C=US/O=MyCorp/CN=john@mycorp.net/emailAddress=john@mycorp.net
last_client_ip:
type: string
description: Most recent client IP address observed for the NAC client
examples:
- 10.100.0.157
last_nacrule_id:
type: string
description: Most recent NAC policy rule identifier used for authentication
examples:
- 603b62db-d839-4152-9f7f-f2578443de8d
last_nacrule_name:
type: string
description: Most recent NAC policy rule name used for authentication
examples:
- Wireless Cert Auth
last_nas_vendor:
type: string
description: Most recent NAS vendor reported for the NAC client
examples:
- juniper-mist
last_port_id:
type: string
description: Most recent port identifier used by the NAC client
examples:
- ge-0/0/17.0
last_ssid:
type: string
description: Most recent SSID used by the NAC client
examples:
- MyCorp-NAC
last_status:
allOf:
- $ref: '#/components/schemas/nac_client_last_status2'
- description: 'Most recent NAC authentication status for the client. enum: `permitted`, `session_started`, `session_stopped`, `denied`.'
examples:
- permitted
last_username:
type: string
description: Most recent username presented by the NAC client
examples:
- john@mycorp.net
last_vlan:
type: integer
description: Most recent VLAN associated with the NAC client
contentEncoding: int32
examples:
- 10
mac:
type: string
description: Client MAC address for the NAC record
readOnly: true
examples:
- ac3eb179e535
nacrule_id:
type: array
items:
type: string
description: NAC policy rule identifiers used during the query duration
readOnly: true
examples:
- - 603b62db-d839-4152-9f7f-f2578443de8d
nacrule_matched:
type: boolean
description: Whether a NAC policy rule matched the client
nacrule_name:
type: array
items:
type: string
description: NAC policy rule names used during the query duration
readOnly: true
examples:
- - Wireless Cert Auth
nas_ip:
type: string
description: IP address of the NAS device used for authentication
nas_vendor:
type: array
items:
type: string
description: NAS vendors observed for the client during the query duration
readOnly: true
examples:
- - juniper-mist
org_id:
type: string
description: Owning organization identifier for the NAC client
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
port_id:
type: array
items:
type: string
description: Port identifiers used by the NAC client during the query duration
readOnly: true
examples:
- - ge-0/0/17.0
random_mac:
allOf:
- $ref: '#/components/schemas/random_mac3'
- description: 'Whether the NAC client used a randomized MAC address. enum: `true`, `false`.'
resp_attrs:
uniqueItems: true
type: array
items:
type: string
description: RADIUS response attributes returned for the NAC client
examples:
- - Tunnel-Type=VLAN
- Tunnel-Medium-Type=IEEE-802
- Tunnel-Private-Group-Id=750
- User-Name=anonymous
site_id:
type: string
description: Site identifier associated with the NAC client
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
ssid:
type: array
items:
type: string
description: Wireless SSIDs used by the NAC client during the query duration
examples:
- - MyCorp-NAC
timestamp:
type: number
description: Time when the NAC client record was observed
readOnly: true
type:
allOf:
- $ref: '#/components/schemas/nac_access_type4'
- description: 'Network access type for the NAC client. enum: `wireless`, `wired`, `vty`.'
examples:
- wireless
usermac_label:
uniqueItems: true
type: array
items:
type: string
description: User MAC labels associated with the NAC client
username:
type: array
items:
type: string
description: User identities associated with the NAC client authentication
readOnly: true
vlan:
type: array
items:
type: string
description: Network VLANs associated with the NAC client during authentication
readOnly: true
description: NAC client authentication and access state
client_wireless:
title: client_wireless
type: object
properties:
ap:
type: array
items:
type: string
description: Observed AP MAC addresses for the wireless client during the query duration
examples:
- - a83a79a947ee
- 003e73170b4c
app_version:
type: array
items:
type: string
description: Marvis Client application versions reported by the wireless client during the query duration
examples:
- - 0.100.3
band:
type: string
description: Wi-Fi radio band used by the wireless client
examples:
- '5'
device:
type: array
items:
type: string
description: Detected device types for the wireless client during the query duration
examples:
- - Mac
ftc:
type: boolean
description: Whether fast transition information is reported for the wireless client
hardware:
type: string
description: Only when client has the Marvis Client app running. Type of Wi-Fi adapter
examples:
- Apple Wi-Fi adapter
hostname:
type: array
items:
type: string
description: Detected hostnames for the wireless client during the query duration
examples:
- - hostname-a
- hostname-b
ip:
type: array
items:
type: string
description: Detected IP addresses for the wireless client during the query duration
examples:
- - 10.5.23.43
- 192.168.0.2
last_ap:
type: string
description: Most recent AP MAC address used by the wireless client
examples:
- a83a79a947ee
last_device:
type: string
description: Most recent device type detected for the wireless client
examples:
- Zebra
last_firmware:
type: string
description: Only when client has the Marvis Client app running. Same as "firmware"
examples:
- 'wl0: Jan 20 2024 04:08:41 version 20.103.12.0.8.7.171 FWID 01-e09d2675'
last_hostname:
type: string
description: Latest hostname we detected for the client
examples:
- hostname-a
last_ip:
type: string
description: Most recent IP address detected for the wireless client
examples:
- 10.100.0.157
last_model:
type: string
description: Only when client has the Marvis Client app running. latest client hardware model we detected for the client
examples:
- MBP 16\" M1 2021
last_os:
type: string
description: Only when client has the Marvis Client app running. Latest version of OS Type we detected for the client
examples:
- Sonoma
last_os_version:
type: string
description: Only when client has the Marvis Client app running. Latest version of OS Version we detected for the client
examples:
- 14.4.1 (Build 23E224)
last_psk_id:
type: string
description: Only for PPSK authentication. Latest PPSK ID used by the client
contentEncoding: uuid
examples:
- abf7dc5c-bb51-4bb7-93b6-5547400ffe11
last_psk_name:
type: string
description: Only for PPSK authentication. Latest PPSK Name used by the client
examples:
- iot
last_ssid:
type: string
description: Most recent SSID used by the wireless client
examples:
- john@mycorp.net
last_username:
type: string
description: Most recent username associated with the wireless client
last_vlan:
type: integer
description: Most recent VLAN associated with the wireless client
contentEncoding: int32
examples:
- 10
last_wlan_id:
type: string
description: ID of the latest SSID (WLAN) the client is/was connected to
contentEncoding: uuid
examples:
- e5d67b07-aae8-494b-8584-cbc20c8110aa
mac:
type: string
description: Client MAC address for the wireless client
examples:
- bcd074000000
mfg:
type: string
description: Manufacturer of the client hardware (MAC OUI based)
examples:
- Apple
model:
type: string
description: Only when client has the Marvis Client app running. Client hardware model
examples:
- MBP 16\" M1 2021
org_id:
type: string
description: Owning organization identifier for the wireless client
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
os:
type: array
items:
type: string
description: Operating systems detected for the wireless client during the query duration
examples:
- - Sonoma
os_version:
type: array
items:
type: string
description: Operating system versions detected for the wireless client during the query duration
examples:
- - 14.4.1 (Build 23E224)
protocol:
type: string
description: 802.11 protocol amendment used by the wireless client
examples:
- ax
psk_id:
type: array
items:
type: string
contentEncoding: uuid
description: PPSK identifiers used by the wireless client during the query duration
examples:
- - abf7dc5c-bb51-4bb7-93b6-5547400ffe11
psk_name:
type: array
items:
type: string
description: PPSK names used by the wireless client during the query duration
examples:
- - iot
random_mac:
type: boolean
description: Whether the wireless client uses a randomized MAC address
sdk_version:
type: array
items:
type: string
description: Marvis Client SDK versions reported by the wireless client during the query duration
examples:
- - 0.100.3
site_id:
type: string
description: Mist Site ID where the client is connected
contentEncoding: uuid
examples:
- 25ff5219-9be7-4db9-907d-0c9b60445147
site_ids:
type: array
items:
type: string
contentEncoding: uuid
description: Site identifiers where the wireless client was observed during the query duration
examples:
- - 25ff5219-9be7-4db9-907d-0c9b60445147
ssid:
type: array
items:
type: string
description: Wireless network SSIDs used by the client during the query duration
examples:
- - IoT SSID
timestamp:
type: number
description: Time when the wireless client record was observed
readOnly: true
username:
type: array
items:
type: string
description: User identities associated with the wireless client during the query duration
examples:
- - user@corp.com
vlan:
type: array
items:
type: integer
contentEncoding: int32
description: Network VLANs associated with the wireless client during the query duration
examples:
- - 10
wlan_id:
type: array
items:
type: string
contentEncoding: uuid
description: WLAN identifiers used by the wireless client during the query duration
examples:
- - e5d67b07-aae8-494b-8584-cbc20c8110aa
description: Wireless client record observed during a client search or stats query
coa_server:
title: coa_server
required:
- ip
- secret
type: object
properties:
disable_event_timestamp_check:
type: boolean
description: Whether to disable Event-Timestamp Check
default: false
enabled:
type: boolean
description: Whether this RADIUS CoA server is enabled
default: false
ip:
type: string
description: Server IPv4 address for RADIUS CoA messages
contentEncoding: ipv4
examples:
- 1.2.3.4
port:
anyOf:
- maximum: 65545
minimum: 1
type: integer
contentEncoding: int32
- type: string
description: UDP port used to send RADIUS CoA messages to the server
secret:
type: string
description: Shared secret used to authenticate RADIUS CoA messages
examples:
- testing456
description: RADIUS Change of Authorization (CoA) server settings
code_string:
title: code_string
required:
- code
type: object
properties:
code:
type: string
description: Request-supplied authorization or claim code value
description: Request body containing a single authorization or claim code
config_switch_local_accounts_user:
title: config_switch_local_accounts_user
type: object
properties:
password:
type: string
description: Local password for the switch user account
contentEncoding: password
examples:
- Juniper123
role:
allOf:
- $ref: '#/components/schemas/config_switch_local_accounts_user_role2'
- description: 'Access role granted to the local switch user account. enum: `admin`, `helpdesk`, `none`, `read`.'
description: Local switch user account credentials and access role
config_switch_local_accounts_user_role:
title: config_switch_local_accounts_user_role
enum:
- admin
- helpdesk
- none
- read
type: string
description: 'enum: `admin`, `helpdesk`, `none`, `read`'
config_vc_port_member:
title: config_vc_port_member
required:
- member
type: object
properties:
member:
type: number
description: Virtual Chassis member ID whose VC ports are being configured
vc_ports:
uniqueItems: true
type: array
items:
type: string
description: Port names to configure as Virtual Chassis ports on the member
description: Virtual Chassis member and port list for a VC port operation
const_alarm_definition:
title: const_alarm_definition
required:
- display
- fields
- group
- key
- severity
type: object
properties:
display:
type: string
description: Description of the alarm type
examples:
- Device offline
example:
type: object
description: Sample alarm payload returned for this alarm type
examples:
- aps:
- d420b02000fa
count: 1
group: infrastructure
hostnames:
- Vendor_AP2
id: f70c308f-7007-4866-9ecd-0d01842979ea
last_seen: 1629753888
org_id: 09dac91f-6e73-4100-89f7-698e0fafbb1b
severity: warn
site_id: dcfb31a1-d615-4361-8c95-b9dde05aa704
timestamp: 1629753888
type: device_down
fields:
type: array
items:
type: string
description: Alarm payload fields available for this alarm type
examples:
- - aps
- hostnames
group:
type: string
description: Alarm group to which this definition belongs
examples:
- infrastructure
key:
type: string
description: Alarm type key used in event and alarm payloads
examples:
- device_down
marvis_suggestion_category:
type: string
description: Marvis defined category to which the alarm belongs
severity:
type: string
description: Alarm severity level for this definition
examples:
- warn
description: Alarm type definition returned by the constants API
const_ap_channel:
title: const_ap_channel
type: object
properties:
band24_40mhz_allowed:
type: boolean
description: Whether 40 MHz channels are allowed on the 2.4 GHz band
examples:
- true
band24_channels:
type: object
additionalProperties:
type: array
items:
type: integer
format: int32
description: Allowed 2.4 GHz channels for this country or regulatory domain
example:
'20':
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
'40':
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
description: Allowed 2.4 GHz channels for this country or regulatory domain
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
band24_enabled:
type: boolean
description: Whether the 2.4 GHz band is enabled for this country or regulatory domain
examples:
- true
band5_channels:
type: object
additionalProperties:
type: array
items:
type: integer
format: int32
description: Allowed 5 GHz channels for this country or regulatory domain
example:
'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
description: Allowed 5 GHz channels for this country or regulatory domain
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
band5_enabled:
type: boolean
description: Whether the 5 GHz band is enabled for this country or regulatory domain
examples:
- true
band6_channels:
type: object
additionalProperties:
type: array
items:
type: integer
format: int32
description: Allowed 6 GHz channels for this country or regulatory domain
example:
'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
description: Allowed 6 GHz channels for this country or regulatory domain
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
band6_enabled:
type: boolean
description: Whether the 6 GHz band is enabled for this country or regulatory domain
examples:
- true
certified:
type: boolean
description: Whether AP operation is certified for this country or regulatory domain
examples:
- true
code:
type: integer
description: Country code, ISO 3166-1 numeric
contentEncoding: int32
examples:
- 840
dfs_ok:
type: boolean
description: Whether DFS channels are allowed in this country or regulatory domain
examples:
- true
key:
type: string
description: Country code, in two-character
examples:
- US
name:
type: string
description: Country or regulatory-domain display name
examples:
- United States
uses:
type: string
description: Regulatory ruleset used for AP channel validation
examples:
- US_FCC
description: Country and regulatory-domain channel capabilities for AP radios
const_ap_esl_version:
title: const_ap_esl_version
type: object
properties:
esl_version:
type: string
description: Electronic Shelf Label (ESL) package version supported by the AP model
readOnly: true
examples:
- 2.5.1
model:
type: string
description: AP model that supports the listed ESL version
readOnly: true
examples:
- AP34
description: Supported Electronic Shelf Label (ESL) version for an AP model
const_ap_led:
title: const_ap_led
required:
- code
- description
- key
- name
type: object
properties:
code:
type: string
description: Numeric LED status and `last_trouble` code reported by the AP
examples:
- '01'
description:
type: string
description: Human-readable explanation of the AP status
examples:
- LED not working
key:
type: string
description: Machine-readable AP status key
examples:
- LED_FAILURE
name:
type: string
description: Display name for the AP status
examples:
- LED Failure
description: AP LED status and `last_trouble` code definition returned by the constants API
const_app_category_definition:
title: const_app_category_definition
required:
- display
- key
type: object
properties:
display:
type: string
description: Description of the app category
examples:
- Images
filters:
allOf:
- $ref: '#/components/schemas/const_app_category_definition_filters2'
- description: Platform-specific application signatures included in this category
examples:
- srx:
- Enhanced_Images_Media
- Enhanced_Web_Images
- Enhanced_Image_Servers
includes:
type: array
items:
type: string
description: Application categories included by this aggregate category
key:
type: string
description: Machine-readable application category key
examples:
- Images
description: Application category definition returned by the constants API
const_app_category_definition_filters:
title: const_app_category_definition_filters
type: object
properties:
srx:
uniqueItems: true
type: array
items:
type: string
description: Application signature names for SRX platforms included in this category
ssr:
uniqueItems: true
type: array
items:
type: string
description: Application identifiers for SSR platforms included in this category
description: Platform-specific application category filters
examples:
- srx:
- Enhanced_Images_Media
- Enhanced_Web_Images
- Enhanced_Image_Servers
const_app_subcategory_definition:
title: const_app_subcategory_definition
required:
- display
- key
- traffic_type
type: object
properties:
display:
type: string
description: Description of the app subcategory
examples:
- Office Document
key:
type: string
description: Machine-readable application subcategory key
examples:
- Office_Documents
traffic_type:
type: string
description: Type of traffic (QoS) of the app subcategory
examples:
- Images
description: Application subcategory definition returned by the constants API
const_application_definition:
title: const_application_definition
type: object
properties:
app_id:
type: boolean
description: Whether an AppID is defined for this application
app_image_url:
type: string
description: URL of the application icon image, when one is available
examples:
- '""'
app_probe:
type: boolean
description: Whether an application probe is available for this application
category:
type: string
description: Application category key associated with this application
examples:
- FileSharing
group:
type: string
description: Application group display name for this application
examples:
- File Sharing
key:
type: string
description: Machine-readable key that identifies the application
examples:
- dropbox
name:
type: string
description: Display name of the application
examples:
- Dropbox
signature_based:
type: boolean
description: Whether this application is detected using signatures
ssr_app_id:
type: boolean
description: Whether an SSR AppID is defined for this application
description: Application definition recognized by Juniper Devices
const_country:
title: const_country
required:
- alpha2
- certified
- name
- numeric
type: object
properties:
alpha2:
type: string
description: Country code, in two-character
examples:
- FR
certified:
type: boolean
description: Whether this country is certified for use in Mist APs
examples:
- true
name:
type: string
description: Human-readable country name for display
examples:
- France
numeric:
type: number
description: Country code, ISO 3166-1 numeric
examples:
- 250
description: Country definition returned by the constants API
const_device_ap:
title: const_device_ap
required:
- ap_type
- type
type: object
properties:
ap_type:
type: string
description: Internal AP platform type identifier
examples:
- jewel
band24:
allOf:
- $ref: '#/components/schemas/const_device_ap_band242'
- description: 2.4 GHz radio capability limits for this AP model
band5:
allOf:
- $ref: '#/components/schemas/const_device_ap_band52'
- description: 5 GHz radio capability limits for this AP model
band6:
allOf:
- $ref: '#/components/schemas/const_device_ap_band62'
- description: 6 GHz radio capability limits for this AP model
band_24_usages:
type: array
items:
$ref: '#/components/schemas/const_device_ap_band_24_usage'
description: Supported RF band usages for the 2.4 GHz radio on this AP model
ce_dfs_ok:
type: boolean
description: Whether DFS operation is allowed for this AP model under CE rules
examples:
- true
cisco_pace:
type: boolean
description: Whether the AP model supports Cisco PACE interoperability
description:
type: string
description: Product description for the AP model
examples:
- AP-45
disallowed_channels:
type: object
additionalProperties:
type: array
items:
type: integer
format: int32
description: Property key is a list of country codes (e.g. "GB, DE")
description: Property key is a list of country codes (e.g. "GB, DE")
display:
type: string
description: User-facing model name shown for the AP
examples:
- AP45
extio:
type: object
additionalProperties:
$ref: '#/components/schemas/const_device_ap_extios'
description: Property key is the GPIO port name (e.g. "D0", "A1")
fcc_dfs_ok:
type: boolean
description: Whether DFS operation is allowed for this AP model under FCC rules
examples:
- true
has_11ax:
type: boolean
description: Whether the AP model supports 802.11ax
has_compass:
type: boolean
description: Whether the AP model includes a compass sensor
examples:
- false
has_ext_ant:
type: boolean
description: Whether the AP model supports external antennas
has_extio:
type: boolean
description: Whether the AP model exposes external I/O ports
examples:
- false
has_height:
type: boolean
description: Whether mounting height can be configured for this AP model
examples:
- false
has_module_port:
type: boolean
description: Whether the AP model includes a module port
has_poe_out:
type: boolean
description: Whether the AP model supports PoE output
examples:
- true
has_scanning_radio:
type: boolean
description: Whether the AP model has scanning-radio capability
examples:
- true
has_selectable_radio:
type: boolean
description: Whether the AP model has selectable radio modes
examples:
- true
has_usb:
type: boolean
description: Whether the AP model includes a USB port
has_vble:
type: boolean
description: Whether the AP model supports virtual BLE (vBLE)
examples:
- true
has_wifi_band24:
type: boolean
description: Whether the AP model supports 2.4 GHz Wi-Fi
examples:
- true
has_wifi_band5:
type: boolean
description: Whether the AP model supports 5 GHz Wi-Fi
examples:
- true
has_wifi_band6:
type: boolean
description: Whether the AP model supports 6 GHz Wi-Fi
examples:
- true
max_poe_out:
type: integer
description: Maximum PoE-out power budget supported by the AP model, in milliwatts
contentEncoding: int32
examples:
- 15400
max_wlans:
type: integer
description: Maximum number of WLANs supported by this AP model
contentEncoding: int32
model:
type: string
description: AP model identifier for this capability definition
examples:
- AP45
other_dfs_ok:
type: boolean
description: Whether DFS operation is allowed for this AP model in other regulatory domains
examples:
- true
outdoor:
type: boolean
description: Whether the AP model is rated for outdoor deployment
radios:
type: object
additionalProperties:
type: string
description: Property key is the radio number (e.g. r0, r1, ...). Property value is the RF band (e.g. "24", "5", ...)
examples:
- r0: '6'
r1: '5'
r2: '24'
shared_scanning_radio:
type: boolean
description: Whether scanning-radio capability shares a radio with client service
type:
const: ap
type: string
description: Device type for this AP model definition
readOnly: true
unmanaged:
type: boolean
description: Whether this AP model is listed as unmanaged in the constants catalog
vble:
allOf:
- $ref: '#/components/schemas/const_device_ap_vble2'
- description: Virtual BLE (vBLE) capability settings for this AP model
description: AP model capability definition returned by the constants API
const_device_ap_band24:
title: const_device_ap_band24
type: object
properties:
band5_channels_op:
type: string
description: 5 GHz channel set used when this radio operates on 5 GHz
examples:
- low
max_clients:
type: integer
description: Maximum client count supported on the 2.4 GHz radio
contentEncoding: int32
examples:
- 128
max_power:
type: integer
description: Maximum transmit power for the 2.4 GHz radio, in dBm
contentEncoding: int32
examples:
- 19
min_power:
type: integer
description: Minimum transmit power for the 2.4 GHz radio, in dBm
contentEncoding: int32
examples:
- 8
description: 2.4 GHz radio capability limits for an AP model
const_device_ap_band5:
title: const_device_ap_band5
type: object
properties:
max_clients:
type: integer
description: Maximum client count supported on the 5 GHz radio
contentEncoding: int32
examples:
- 128
max_power:
type: integer
description: Maximum transmit power for the 5 GHz radio, in dBm
contentEncoding: int32
examples:
- 17
min_power:
type: integer
description: Minimum transmit power for the 5 GHz radio, in dBm
contentEncoding: int32
examples:
- 8
description: 5 GHz radio capability limits for an AP model
const_device_ap_band6:
title: const_device_ap_band6
type: object
properties:
max_clients:
type: integer
description: Maximum client count supported on the 6 GHz radio
contentEncoding: int32
examples:
- 128
max_power:
type: integer
description: Maximum transmit power for the 6 GHz radio, in dBm
contentEncoding: int32
examples:
- 17
min_power:
type: integer
description: Minimum transmit power for the 6 GHz radio, in dBm
contentEncoding: int32
examples:
- 8
description: 6 GHz radio capability limits for an AP model
const_device_ap_band_24_usage:
title: const_device_ap_band_24_usage
enum:
- '24'
- '5'
- '6'
type: string
description: 'enum: `24`, `5`, `6`'
const_device_ap_extios:
title: const_device_ap_extios
type: object
properties:
default_dir:
allOf:
- $ref: '#/components/schemas/const_device_ap_extios_default_dir2'
- description: 'Default direction for this external I/O port. enum: `IN`, `OUT`.'
input:
type: boolean
description: Whether this external I/O port supports input mode
output:
type: boolean
description: Whether this external I/O port supports output mode
description: External I/O port capabilities for an AP model
const_device_ap_extios_default_dir:
title: const_device_ap_extios_default_dir
enum:
- IN
- OUT
type: string
description: 'Default direction for this external I/O port. enum: `IN`, `OUT`'
const_device_ap_vble:
title: const_device_ap_vble
type: object
properties:
beacon_rate:
type: integer
description: Advertisement rate for the virtual BLE beacon
contentEncoding: int32
examples:
- 4
beams:
type: integer
description: Number of virtual BLE beams supported by the AP model
contentEncoding: int32
examples:
- 9
power:
type: integer
description: Transmit power for virtual BLE beacons, in dBm
contentEncoding: int32
examples:
- 8
description: Virtual BLE (vBLE) capability settings for an AP model
const_device_gateway:
title: const_device_gateway
required:
- type
type: object
properties:
defaults:
type: object
additionalProperties:
type: string
description: Default interface group mappings for this gateway model
description:
type: string
description: Product description for the gateway model
experimental:
type: boolean
description: Whether this gateway model is marked experimental in the constants catalog
default: false
fans_pluggable:
type: boolean
description: Whether the gateway model has field-replaceable fans
default: true
ha_node0_fpc:
type: integer
description: FPC number used for node0 in HA deployments
contentEncoding: int32
ha_node1_fpc:
type: integer
description: FPC number used for node1 in HA deployments
contentEncoding: int32
has_bgp:
type: boolean
description: Whether the gateway model supports BGP
default: false
has_fxp0:
type: boolean
description: Whether the gateway model includes an fxp0 management interface
default: true
has_ha_control:
type: boolean
description: Whether the gateway model has a dedicated HA control port
default: false
has_ha_data:
type: boolean
description: Whether the gateway model has dedicated HA data ports
default: false
has_irb:
type: boolean
description: Whether the gateway model supports IRB interfaces
default: false
has_poe_out:
type: boolean
description: Whether the gateway model supports PoE output
default: true
has_snapshot:
type: boolean
description: Whether the gateway model supports configuration snapshots
default: true
irb_disabled_by_default:
type: boolean
description: Whether IRB interfaces are disabled by default on this gateway model
default: false
model:
type: string
description: Gateway model identifier for this capability definition
number_fans:
type: integer
description: Number of fans in the gateway model
contentEncoding: int32
oc_device:
type: boolean
description: Whether this gateway model is identified as an OpenConfig-managed device
default: false
pic:
type: object
additionalProperties:
type: string
description: Physical Interface Card port layout for this gateway model
ports:
allOf:
- $ref: '#/components/schemas/const_device_gateway_ports2'
- description: Per-interface metadata for this gateway model
sub_required:
type: string
description: Subscription type required for this gateway model
t128_device:
type: boolean
description: Whether this gateway model is a 128 Technology or SSR device
default: false
type:
const: gateway
type: string
description: Device type for this gateway model definition
readOnly: true
description: Gateway model capability definition returned by the constants API
const_device_gateway_ports:
title: const_device_gateway_ports
type: object
properties:
display:
type: string
description: User-facing interface name for the gateway port
pci_address:
type: string
description: PCI address for the gateway port
speed:
type: integer
description: Port speed for the gateway interface, in Mbps
contentEncoding: int32
description: Object Key is the interface name (e.g. "ge-0/0/1", ...)
const_device_switch:
title: const_device_switch
required:
- type
type: object
properties:
alias:
type: string
description: Alternate model identifier for chassis-based switch definitions
examples:
- EX4100-48P-CHAS
defaults:
allOf:
- $ref: '#/components/schemas/const_device_switch_default2'
- description: Default port mappings for this switch model
description:
type: string
description: Product description for the switch model
examples:
- Juniper EX4100 Series
display:
type: string
description: User-facing model name shown for the switch
examples:
- EX4100-48P
evolved_os:
type: boolean
description: Whether the switch model runs Junos Evolved
default: false
evpn_ri_type:
type: string
description: EVPN routing-instance type used by this switch model
examples:
- mac-vrf
experimental:
type: boolean
description: Whether this switch model is marked experimental in the constants catalog
default: false
fans_pluggable:
type: boolean
description: Whether the switch model has field-replaceable fans
default: false
examples:
- true
has_bgp:
type: boolean
description: Whether the switch model supports BGP
default: false
examples:
- true
has_ets:
type: boolean
description: Whether the switch model supports Enhanced Transmission Selection (ETS)
default: false
has_evpn:
type: boolean
description: Whether the switch model supports EVPN
default: false
examples:
- true
has_irb:
type: boolean
description: Whether the switch model supports IRB interfaces
default: false
examples:
- true
has_poe_out:
type: boolean
description: Whether the switch model supports PoE output
default: false
examples:
- true
has_snapshot:
type: boolean
description: Whether the switch model supports configuration snapshots
default: true
has_vc:
type: boolean
description: Whether the switch model supports Virtual Chassis
default: true
examples:
- true
model:
type: string
description: Switch model identifier for this capability definition
examples:
- EX4100-48P
modular:
type: boolean
description: Whether the switch model has modular hardware
default: false
no_shaping_rate:
type: boolean
description: Whether the switch model omits shaping-rate support
default: false
number_fans:
type: integer
description: Number of fans in the switch model
contentEncoding: int32
examples:
- 2
oc_device:
type: boolean
description: Whether this switch model is identified as an OpenConfig-managed device
default: false
examples:
- true
oob_interface:
type: string
description: Out-of-band management interface names for this switch model
examples:
- re0:mgmt-0, re1:mgmt-0
packet_action_drop_only:
type: boolean
description: Whether packet action support is limited to drop-only behavior
default: false
pic:
type: object
additionalProperties:
type: string
description: Object Key is the PIC number
examples:
- '0': ge*48
'1': qsfp+*4
'2': sfp+*4 (uplink)
sub_required:
type: string
description: Subscription type required for this switch model
type:
const: switch
type: string
description: Device type for this switch model definition
readOnly: true
description: Switch model capability definition returned by the constants API
const_device_switch_default:
title: const_device_switch_default
type: object
properties:
_ports:
type: string
description: Default switch port range list for this model
examples:
- ge-0/0/0-47, et-0/1/0-3, xe-0/2/0-3, ge-0/2/0-3
description: Default switch port ranges for a model
const_device_type_ap:
title: const_device_type_ap
const: ap
type: string
description: 'Device Type. enum: `ap`'
const_device_type_gateway:
title: const_device_type_gateway
const: gateway
type: string
description: 'Device Type. enum: `gateway`'
const_device_type_switch:
title: const_device_type_switch
const: switch
type: string
description: 'Device Type. enum: `switch`'
const_event:
title: const_event
required:
- display
- key
type: object
properties:
description:
type: string
description: Narrative description of the device event type
display:
type: string
description: Human-readable label for the device event type
example:
type: object
description: Sample device event payload for this event type
group:
type: string
description: Device event group for this definition
key:
type: string
description: Machine-readable device event key
description: Device event definition returned by the constants API
const_fingerprint_types:
title: const_fingerprint_types
type: object
properties:
family:
uniqueItems: true
type: array
items:
type: string
description: Device family values available for client fingerprint matching
mfg:
uniqueItems: true
type: array
items:
type: string
description: Manufacturer values available for client fingerprint matching
model:
uniqueItems: true
type: array
items:
type: string
description: Device model values available for client fingerprint matching
os:
uniqueItems: true
type: array
items:
type: string
description: Operating system values available for client fingerprint matching
description: Supported client fingerprint values for NAC matching
const_gateway_applications_definition:
title: const_gateway_applications_definition
type: object
properties:
app_id:
type: boolean
description: Whether an AppID is defined for this gateway application
examples:
- true
key:
type: string
description: Machine-readable key that identifies the gateway application
examples:
- 4shared
name:
type: string
description: Display name of the gateway application
examples:
- 4shared
ssr_app_id:
type: boolean
description: Whether an SSR AppID is defined for this gateway application
examples:
- true
description: Gateway application definition returned by the constants API
const_insight_metrics_property:
title: const_insight_metrics_property
type: object
properties:
ctype:
uniqueItems: true
type: array
items:
type: string
description: Metric classification type labels for this insight metric
description:
type: string
description: Human-readable description of the insight metric
example:
anyOf:
- type: array
items:
$ref: '#/components/schemas/const_insight_metrics_property_example'
- type: object
additionalProperties:
type: array
items:
$ref: '#/components/schemas/const_insight_metrics_property_example'
description: Sample values returned for this insight metric
intervals:
type: object
additionalProperties:
$ref: '#/components/schemas/const_insight_metrics_property_interval'
description: Supported time intervals and retention windows for this metric
keys:
type: object
description: Additional key metadata for this insight metric
params:
type: object
additionalProperties:
$ref: '#/components/schemas/const_insight_metrics_property_param'
description: Parameters supported when querying this insight metric
report_durations:
type: object
additionalProperties:
$ref: '#/components/schemas/const_insight_metrics_property_report_duration'
description: Supported reporting durations for this insight metric
report_scopes:
uniqueItems: true
type: array
items:
type: string
description: Entity scopes supported when reporting this insight metric
scopes:
type: array
items:
$ref: '#/components/schemas/const_insight_metrics_property_scope'
description: Entity scopes that can be queried for this insight metric
sle_baselined:
type: boolean
description: Whether the insight metric uses an SLE baseline
sle_classifiers:
uniqueItems: true
type: array
items:
type: string
description: SLE classifiers associated with this insight metric
type:
type: string
description: Metric data type, such as timeseries
unit:
type: string
description: Measurement unit for values returned by this metric
values:
type: object
description: Enumerated or structured value metadata for this insight metric
description: Definition of an insight metric returned by the constants API
const_insight_metrics_property_example_any_of:
title: const_insight_metrics_property_example_any_of
type: object
description: Example values for an insight metric property, as an array or keyed object
const_insight_metrics_property_interval:
title: const_insight_metrics_property_interval
type: object
properties:
interval:
type: integer
description: Sampling interval length, in seconds
contentEncoding: int32
max_age:
type: integer
description: Maximum lookback age for this interval, in seconds
contentEncoding: int32
description: Interval definition for an insight metric
const_insight_metrics_property_param:
title: const_insight_metrics_property_param
type: object
properties:
required:
type: boolean
description: Whether this query parameter is required
description: Query parameter definition for an insight metric
const_insight_metrics_property_report_duration:
title: const_insight_metrics_property_report_duration
type: object
properties:
duration:
type: integer
description: Report duration length, in seconds
contentEncoding: int32
interval:
type: integer
description: Sampling interval used for this report duration, in seconds
contentEncoding: int32
description: Report duration definition for an insight metric
const_insight_metrics_property_scope:
title: const_insight_metrics_property_scope
enum:
- ap
- client
- device
- gateway
- map
- msp
- mxcluster
- mxedge
- org
- otherdevice
- rssizone
- sdkclient
- site
- switch
- wlan
- zone
type: string
description: 'enum: `ap`, `client`, `device`, `gateway`, `map`, `msp`, `mxcluster`, `mxedge`, `org`, `otherdevice`, `rssizone`, `sdkclient`, `site`, `switch`, `wlan`, `zone`'
const_language:
title: const_language
required:
- display
- display_native
- key
type: object
properties:
display:
type: string
description: Localized language display name in the API default locale
examples:
- English (US)
display_native:
type: string
description: Language display name in its native locale
examples:
- English (US)
key:
type: string
description: Locale key used to select this language
examples:
- en-US
description: Language option returned by the constants API
const_license_type:
title: const_license_type
type: object
properties:
description:
type: string
description: Human-readable description of the license type
examples:
- Wired Assurance 12
enforcement_level:
allOf:
- $ref: '#/components/schemas/const_license_type_enforcement_level'
- description: 'Level at which the license is enforced. enum: `org`, `site`.'
entitled_licenses:
type: array
items:
type: string
description: License type keys this license type entitles
examples:
- - sub_ex12
- sub_sadv1
group:
type: string
description: License group this license type belongs to
examples:
- SUB-WIRED
includes:
type: array
items:
type: string
description: License SKU components included by this license type
examples:
- - sub_ex12a
- sub_ex12p
key:
type: string
description: Machine-readable license type key
examples:
- sub_ex12
name:
type: string
description: Display name of the license type
examples:
- SUB-EX12
type:
type: string
description: License type identifier (SKU)
examples:
- SUB-EX12
description: License type definition returned by the constants API
const_license_type_enforcement_level:
title: const_license_type_enforcement_level
enum:
- org
- site
type: string
description: 'Level at which the license is enforced. enum: `org`, `site`.'
const_marvis_client_version:
title: const_marvis_client_version
type: object
properties:
label:
type: string
description: Release label for this Marvis Client version
examples:
- default
notes:
type: string
description: Release notes or extra text for this Marvis Client version
os:
type: string
description: Operating system supported by this Marvis Client installer
examples:
- windows
url:
type: string
description: Download URL for this Marvis Client installer
examples:
- https://mobile.mist.com/installers/marvisclient/...
version:
type: string
description: Marvis Client software version for this installer
examples:
- 0.100.29
description: Marvis Client version download entry
const_marvisclient_event:
title: const_marvisclient_event
type: object
properties:
display:
type: string
description: Human-readable name for this Marvis Client event type
examples:
- Marvis Client Roamed
key:
type: string
description: Event type key used in Marvis Client event search and count APIs
examples:
- MARVISCLIENT_ROAMED
description: A Marvis Client event type definition
const_mxedge_model:
title: const_mxedge_model
type: object
properties:
custom_ports:
type: boolean
description: Whether this Mist Edge model supports custom port definitions
display:
type: string
description: User-facing model name shown for the Mist Edge
examples:
- X10
model:
type: string
description: Mist Edge model identifier
examples:
- ME-X10
ports:
type: object
additionalProperties:
$ref: '#/components/schemas/const_mxedge_model_port'
description: Port metadata keyed by interface number for this Mist Edge model
description: Mist Edge model definition returned by the constants API
const_mxedge_model_port:
title: const_mxedge_model_port
type: object
properties:
display:
type: string
description: User-facing interface name for this Mist Edge port
examples:
- xe0
speed:
type: integer
description: Port speed for the Mist Edge interface, in Mbps
contentEncoding: int32
examples:
- 10000
description: Mist Edge model port metadata
const_nac_event:
title: const_nac_event
type: object
properties:
ap:
type: string
description: Access point MAC address associated with the NAC event
examples:
- 5c5b355008c0
bssid:
type: string
description: Wireless BSSID associated with the NAC event
examples:
- 5c5b35548892
cert_cn:
type: string
description: Certificate common name presented during NAC authentication
examples:
- suriyas
cert_expiry:
type: integer
description: Certificate expiration timestamp presented during NAC authentication
contentEncoding: int32
examples:
- 1711557441
cert_issuer:
type: string
description: Certificate issuer presented during NAC authentication
examples:
- /DC=net/DC=jnpr/CN=Juniper Networks Issuing AWS1 CA
cert_san_upn:
type: array
items:
type: string
description: Certificate SAN UPN values presented during NAC authentication
examples:
- - suriyas@juniper.net
cert_serial:
type: string
description: Certificate serial number presented during NAC authentication
examples:
- 1300103d29e56ef083797bedc2000100103d29
cert_subject:
type: string
description: Certificate subject presented during NAC authentication
examples:
- /CN=suriyas/emailAddress=suriyas@juniper.net
eap_type:
type: string
description: EAP method used for the NAC authentication
examples:
- EAP-TLS
nas_vendor:
type: string
description: Network access server vendor reported for the NAC event
examples:
- Mist
org_id:
type: string
description: Organization identifier associated with the NAC event
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
random_mac:
type: boolean
description: Whether the client used a randomized MAC address in the NAC event
examples:
- true
site_id:
type: string
description: Site identifier associated with the NAC event
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
ssid:
type: string
description: Wireless SSID associated with the NAC event
examples:
- Test_Suriya-SSID
timestamp:
type: number
description: Time when the NAC event occurred
readOnly: true
type:
type: string
description: NAC event type key
examples:
- NAC_CLIENT_CERT_CHECK_SUCCESS
username:
type: string
description: User identity associated with the NAC event
examples:
- suriyas@juniper.net
wcid:
type: string
description: Wireless client identifier associated with the NAC event
contentEncoding: uuid
examples:
- b43637b0-f0d9-0a1d-1ec2-73c394a9f679
description: NAC event example payload returned by the constants API
const_other_device_model:
title: const_other_device_model
type: object
properties:
_vendor_model_id:
type: string
description: Vendor-specific model identifier for this other-device model
display:
type: string
description: User-facing model name shown for the other-device model
model:
type: string
description: Device model identifier for this other-device definition
type:
type: string
description: Device category for this other-device model
vendor:
type: string
description: Manufacturer name for this other-device model
description: Other-device model definition returned by the constants API
const_state:
title: const_state
type: object
properties:
iso_code:
type: string
description: ISO subdivision code for the state or territory
examples:
- AK
name:
type: string
description: State or territory display name
examples:
- Alaska
description: State or territory definition returned by the constants API
const_traffic_type:
title: const_traffic_type
type: object
properties:
display:
type: string
description: Human-readable traffic type label
examples:
- VoIP Video
dscp:
type: integer
description: Differentiated Services Code Point value used for this traffic type
contentEncoding: int32
examples:
- 32
failover_policy:
type: string
description: Failover behavior associated with this traffic type
examples:
- non_revertible
max_jitter:
type: integer
description: Maximum jitter threshold for this traffic type, in milliseconds
contentEncoding: int32
examples:
- 250
max_latency:
type: integer
description: Maximum latency threshold for this traffic type, in milliseconds
contentEncoding: int32
examples:
- 1500
max_loss:
type: integer
description: Maximum packet loss threshold for this traffic type, in percent
contentEncoding: int32
examples:
- 35
name:
type: string
description: Machine-readable traffic type name
examples:
- voip_video
traffic_class:
type: string
description: Traffic class associated with this traffic type
examples:
- medium
description: Traffic type definition returned by the constants API
const_webhook_topic:
title: const_webhook_topic
type: object
properties:
allows_single_event_per_message:
type: boolean
description: Whether this topic can be configured to enforce one event per webhook message
for_org:
type: boolean
description: Whether this topic can be used in organization-level webhooks
has_delivery_results:
type: boolean
description: Whether delivery-result search is available for this webhook topic
internal:
type: boolean
description: Whether this topic is internal and not selectable in site or organization webhooks
key:
type: string
description: Machine-readable key that identifies the webhook topic
examples:
- alarms
description: Webhook topic definition returned by the constants API
count_org_devices_mxtunnel_status:
title: count_org_devices_mxtunnel_status
enum:
- down
- up
type: string
description: 'Mist Tunnel status value used when counting organization devices. enum: `down`, `up`'
count_pbn_distinct:
title: count_pbn_distinct
enum:
- versions
- models
- customer_risk
- bug_type
type: string
description: 'Fields that can be used to group PBN advisory count results. enum: `versions`, `models`, `customer_risk`, `bug_type`'
examples:
- versions
count_result:
title: count_result
required:
- count
type: object
properties:
count:
type: integer
description: Number of matching items for the distinct value or values in this result
contentEncoding: int32
additionalProperties:
type: string
description: Count result row with the matching distinct field values
count_sirt_distinct:
title: count_sirt_distinct
enum:
- versions
- models
- severity
- jsa_updated_date
type: string
description: 'Fields that can be used to group SIRT advisory count results. enum: `versions`, `models`, `severity`, `jsa_updated_date`'
examples:
- versions
count_site_calls_distinct:
title: count_site_calls_distinct
const: mac
type: string
description: 'Distinct field used when counting site call statistics. enum: `mac`'
count_usermac_distinct:
title: count_usermac_distinct
enum:
- mac
- name
- labels
- org_id
type: string
description: 'Fields that can be used to group user MAC count results. enum: `mac`, `name`, `labels`, `org_id`'
examples:
- org_id
cpu_stat:
title: cpu_stat
type: object
properties:
idle:
type:
- number
- 'null'
description: Percentage of CPU time that is idle
readOnly: true
interrupt:
type:
- number
- 'null'
description: Percentage of CPU time being used by interrupts
readOnly: true
load_avg:
type: array
items:
type: number
description: Load averages for the last 1, 5, and 15 minutes
system:
type:
- number
- 'null'
description: Percentage of CPU time being used by system processes
readOnly: true
usage:
type:
- number
- 'null'
description: Overall CPU usage percentage
readOnly: true
user:
type:
- number
- 'null'
description: Percentage of CPU time being used by user processes
readOnly: true
description: CPU utilization breakdown for a device
day_of_week:
title: day_of_week
enum:
- any
- fri
- mon
- sat
- sun
- thu
- tue
- wed
type: string
description: 'enum: `any`, `fri`, `mon`, `sat`, `sun`, `thu`, `tue`, `wed`'
days_number:
title: days_number
type: object
properties:
days:
type: integer
description: Number of most recent days of CRL entries to retain after truncation
contentEncoding: int32
default: 30
description: Request body specifying CRL truncation retention in days
delivery:
title: delivery
required:
- enabled
type: object
properties:
additional_emails:
type: array
items:
type: string
description: Additional email recipients for alarm delivery
enabled:
type: boolean
description: Whether to enable the alarm delivery via emails or not
examples:
- true
to_org_admins:
type: boolean
description: Whether to deliver the alarms via emails to Org admins or not
examples:
- true
to_site_admins:
type: boolean
description: Whether to deliver the alarms via emails to Site admins or not
examples:
- false
description: Delivery object to configure the alarm delivery
device_ap_lacp_config:
title: device_ap_lacp_config
type: object
properties:
enabled:
type: boolean
description: Whether to enable LACP on supported AP Ethernet uplinks
default: false
description: LACP settings for supported AP Ethernet uplinks
device_enum_with_all:
title: device_enum_with_all
enum:
- all
- ap
- switch
- gateway
type: string
description: 'device type. enum: `all`, `ap`, `gateway`, `switch`. Default is `ap`'
device_event:
title: device_event
required:
- org_id
- timestamp
- type
type: object
properties:
ap:
type: string
description: Deprecated AP MAC address field; use `mac` instead
deprecated: true
ap_name:
type: string
description: Deprecated AP name field; use `device_name` instead
deprecated: true
apfw:
type: string
description: AP firmware version associated with the device event
audit_id:
type: string
description: Audit log identifier associated with the device event
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
bandwidth:
type: integer
description: Channel bandwidth associated with a radio event, in MHz
contentEncoding: int32
channel:
type: integer
description: RF channel associated with the device event
contentEncoding: int32
chassis_mac:
type: string
description: Chassis MAC address associated with the device event
count:
type: integer
description: Event count reported in the device event payload
contentEncoding: int32
device_name:
type: string
description: Name of the device associated with the event
device_type:
allOf:
- $ref: '#/components/schemas/device_type6'
- description: 'Device type associated with the event. enum: `ap`, `gateway`, `switch`.'
ev_type:
allOf:
- $ref: '#/components/schemas/webhook_device_events_event_ev_type2'
- description: 'Advisory severity for the device event. enum: `notice`, `warn`.'
ext_ip:
type: string
description: External IP address reported for the device event
job_id:
type: string
description: Job identifier associated with a tunnel provisioning event (present when `includes`==`ext_tunnel`)
contentEncoding: uuid
mac:
type: string
description: Device MAC address associated with the event
model:
type: string
description: Device model associated with the event
node:
type: string
description: Cluster node identifier associated with the device event
org_id:
type: string
description: Organization identifier associated with the device event
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
port_id:
type: string
description: Port identifier associated with the device event
power:
type: integer
description: Transmit power associated with a radio event
contentEncoding: int32
pre_bandwidth:
type: integer
description: Previous channel bandwidth before an RRM change, in MHz
contentEncoding: int32
pre_channel:
type: integer
description: Previous RF channel before an RRM change
contentEncoding: int32
pre_power:
type: integer
description: Previous transmit power before an RRM change
contentEncoding: int32
pre_usage:
type: integer
description: Previous radio usage band before an RRM change
contentEncoding: int32
reason:
type: string
description: Optional reason text reported for the device event
site_id:
type: string
description: Site identifier associated with the device event
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
site_name:
type: string
description: Name of the site associated with the event
status:
type: string
description: Tunnel provisioning status for ext_tunnel events (e.g. `PROVISION_IN_PROGRESS`)
template_id:
type: string
description: Gateway template identifier associated with a tunnel provisioning event (present when `includes`==`ext_tunnel`)
contentEncoding: uuid
text:
type: string
description: Optional human-readable text for the device event
timestamp:
type: number
description: Time when the device event occurred
readOnly: true
tunnel_name:
type: string
description: Tunnel name associated with a tunnel provisioning event (present when `includes`==`ext_tunnel`)
type:
type: string
description: Device event type key
usage:
type: integer
description: Current radio usage band for an RRM event
contentEncoding: int32
version:
type: string
description: Firmware or software version associated with the device event
description: Device event payload returned by search and webhook APIs
device_gateway:
title: device_gateway
required:
- type
type: object
properties:
additional_config_cmds:
type: array
items:
type: string
description: Additional CLI configuration commands to apply to this gateway
bgp_config:
type: object
additionalProperties:
$ref: '#/components/schemas/bgp_config'
description: BGP routing configuration for this gateway. Property key is the BGP session name
created_time:
type: number
description: Timestamp when the gateway object was created
readOnly: true
deviceprofile_id:
type: string
description: Device profile associated with this gateway
contentEncoding: uuid
readOnly: true
dhcpd_config:
allOf:
- $ref: '#/components/schemas/dhcpd_config4'
- description: DHCP server configuration served by this gateway
dns_servers:
type: array
items:
type: string
description: DNS servers configured for this gateway
dns_suffix:
type: array
items:
type: string
description: DNS search suffixes configured for this gateway
extra_routes:
type: object
additionalProperties:
$ref: '#/components/schemas/gateway_extra_route'
description: Additional IPv4 routes configured on this gateway
extra_routes6:
type: object
additionalProperties:
$ref: '#/components/schemas/gateway_extra_route6'
description: Additional IPv6 routes configured on this gateway
examples:
- 2a02:1234:420a:10c9::/64:
via: 2a02:1234:200a::100
for_site:
type: boolean
description: Whether the gateway configuration is scoped directly to a site
readOnly: true
gateway_mgmt:
allOf:
- $ref: '#/components/schemas/gateway_mgmt4'
- description: Management-plane settings for this gateway
id:
type: string
description: Unique identifier of the gateway object
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
idp_profiles:
type: object
additionalProperties:
$ref: '#/components/schemas/idp_profile'
description: Intrusion detection and prevention profiles configured for this gateway
image1_url:
type:
- string
- 'null'
description: First custom image URL associated with the gateway
image2_url:
type:
- string
- 'null'
description: Second custom image URL associated with the gateway
image3_url:
type:
- string
- 'null'
description: Third custom image URL associated with the gateway
ip_configs:
type: object
additionalProperties:
$ref: '#/components/schemas/gateway_ip_config_property'
description: Gateway interface IP configurations by network name
mac:
type: string
description: Gateway MAC address used to identify the device
readOnly: true
managed:
type: boolean
description: Whether the device is managed by Mist. Deprecated in favour of mist_configured.
deprecated: true
map_id:
type: string
description: Map where the device belongs to
contentEncoding: uuid
examples:
- 63eda950-c6da-11e4-a628-60f81dd250cc
mist_configured:
type: boolean
description: whether the device can be configured by Mist or not. This deprecates `managed` for adopted devices.
model:
type: string
description: Gateway model reported for the device
readOnly: true
modified_time:
type: number
description: Timestamp when the gateway object was last modified
readOnly: true
msp_id:
type: string
description: MSP that manages this gateway, when applicable
contentEncoding: uuid
readOnly: true
examples:
- b9d42c2e-88ee-41f8-b798-f009ce7fe909
name:
type: string
description: Friendly display name assigned to the gateway
networks:
type: array
items:
$ref: '#/components/schemas/network'
description: Layer 3 networks configured for use by this gateway
notes:
type: string
description: Free-form administrative notes for this gateway
ntp_servers:
uniqueItems: true
type: array
items:
type: string
description: NTP servers used by this gateway
oob_ip_config:
allOf:
- $ref: '#/components/schemas/gateway_oob_ip_config4'
- description: Out-of-band management IP configuration for this gateway
org_id:
type: string
description: Organization that owns this gateway
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
path_preferences:
type: object
additionalProperties:
$ref: '#/components/schemas/gateway_path_preferences'
description: Property key is the path name
port_config:
type: object
additionalProperties:
$ref: '#/components/schemas/gateway_port_config'
description: Property key is the port name or range (e.g. "ge-0/0/0-10")
port_mirroring:
allOf:
- $ref: '#/components/schemas/gateway_port_mirroring2'
- description: Port mirroring configuration for this gateway
router_id:
type: string
description: Auto assigned if not set
examples:
- 10.2.1.10
routing_policies:
type: object
additionalProperties:
$ref: '#/components/schemas/gw_routing_policy'
description: Routing policies applied by this gateway
serial:
type: string
description: Manufacturer serial number for the gateway
readOnly: true
service_policies:
type: array
items:
$ref: '#/components/schemas/service_policy'
description: Traffic service policies enforced by this gateway
site_id:
type: string
description: Site where this gateway is assigned
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
tunnel_configs:
type: object
additionalProperties:
$ref: '#/components/schemas/tunnel_config'
description: Property key is the tunnel name
tunnel_provider_options:
allOf:
- $ref: '#/components/schemas/tunnel_provider_options4'
- description: Provider-specific options for tunnels terminated by this gateway
type:
const: gateway
type: string
description: Device type discriminator for gateway records
readOnly: true
url_filtering_deny_msg:
type: string
description: When a service policy denies a app_category, what message to show in user's browser
default: Access to this URL Category has been blocked
examples:
- Access to this URL Category has been blocked
vars:
type: object
additionalProperties:
type: string
description: Variable values that override site variables for this gateway
examples:
- RADIUS_IP1: 172.31.2.5
RADIUS_SECRET: 11s64632d
vrf_config:
allOf:
- $ref: '#/components/schemas/vrf_config1'
- description: VRF configuration applied to this gateway
vrf_instances:
type: object
additionalProperties:
$ref: '#/components/schemas/gateway_vrf_instance'
description: VRF instances configured on this gateway
examples:
- CORP_VRF:
networks:
- CORP_NET
- MGMT_NET
x:
type: number
description: Horizontal map position of the gateway, in pixels
examples:
- 53.5
y:
type: number
description: Vertical map position of the gateway, in pixels
examples:
- 173.1
description: Gateway configuration and placement data
device_id_string:
title: device_id_string
required:
- device_id
type: object
properties:
device_id:
type: string
description: Device identifier supplied by the request
contentEncoding: uuid
description: Request body containing a device identifier
device_other:
title: device_other
type: object
properties:
created_time:
type: number
description: Timestamp when the third-party device record was created
readOnly: true
device_mac:
type: string
description: MAC address of the Mist device this third-party device is attached to
id:
type: string
description: Unique identifier of the third-party device record
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
mac:
type: string
description: Third-party device MAC address
model:
type: string
description: Third-party device model reported by the vendor integration
modified_time:
type: number
description: Timestamp when the third-party device record was last modified
readOnly: true
name:
type: string
description: Display name reported or configured for the third-party device
org_id:
type: string
description: Organization that owns this third-party device record
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
serial:
type: string
description: Manufacturer serial number reported for the third-party device
site_id:
type: string
description: Site where the third-party device is assigned
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
state:
type: string
description: Operational state reported for the third-party device
vendor:
type: string
description: External vendor integration that reported the third-party device
vendor_api_id:
type: string
description: Identifier assigned by the vendor API for this third-party device
description: Third-party device discovered or managed through an external vendor integration
device_search_radius_filter_status:
title: device_search_radius_filter_status
enum:
- up
- down
- unreachable
type: string
description: 'Status of the device search RADIUS filter. enum: `up`, `down`, `unreachable`'
device_search_radius_stat:
title: device_search_radius_stat
type: object
properties:
auth_accepts:
type: integer
description: Number of accepted authentication requests
contentEncoding: int32
auth_rejects:
type: integer
description: Number of rejected authentication requests
contentEncoding: int32
auth_server_status:
allOf:
- $ref: '#/components/schemas/device_search_radius_filter_status1'
- description: 'RADIUS authentication server status for this server in device search results. enum: `up`, `down`, `unreachable`.'
auth_timeouts:
type: integer
description: Number of authentication timeouts
contentEncoding: int32
description: RADIUS authentication counters and server status for a device search result
device_status:
title: device_status
enum:
- all
- connected
- disconnected
type: string
description: 'enum: `all`, `connected`, `disconnected`'
device_status_filter:
title: device_status_filter
enum:
- connected
- disconnected
type: string
description: 'Filter devices based on their status. enum: `connected`, `disconnected`'
device_switch:
title: device_switch
required:
- type
type: object
properties:
acl_policies:
type: array
items:
$ref: '#/components/schemas/acl_policy'
description: ACL policies applied to traffic handled by this switch
acl_tags:
type: object
additionalProperties:
$ref: '#/components/schemas/acl_tag'
description: ACL tags used by switch access policies
additional_config_cmds:
type: array
items:
type: string
description: Additional CLI configuration commands to apply to this switch
aggregate_routes:
type: object
additionalProperties:
$ref: '#/components/schemas/aggregate_route'
description: Additional IPv4 aggregate routes configured on this switch
examples:
- 172.16.3.0/24:
discard: false
metric: null
preference: 30
aggregate_routes6:
type: object
additionalProperties:
$ref: '#/components/schemas/aggregate_route'
description: Additional IPv6 aggregate routes configured on this switch
examples:
- 2a02:1234:420a:10c9::/64:
discard: false
metric: null
preference: 30
bgp_config:
type: object
additionalProperties:
$ref: '#/components/schemas/switch_bgp_config'
description: BGP routing configuration for this switch. Property key is the BGP session name
created_time:
type: number
description: Timestamp when the switch object was created
readOnly: true
default_port_usage:
type: string
description: 'Port usage to assign to switch ports without any port usage assigned. Default: `default` to preserve default behavior'
default: default
deviceprofile_id:
type: string
description: Device profile associated with this switch
contentEncoding: uuid
readOnly: true
dhcp_snooping:
allOf:
- $ref: '#/components/schemas/dhcp_snooping5'
- description: DHCP snooping configuration for this switch
dhcpd_config:
allOf:
- $ref: '#/components/schemas/switch_dhcpd_config3'
- description: DHCP server configuration served by this switch
disable_auto_config:
type: boolean
description: This disables the default behavior of a cloud-ready switch/gateway being managed/configured by Mist. Setting this to `true` means you want to disable the default behavior and do not want the device to be Mist-managed.
default: false
dns_servers:
type: array
items:
type: string
description: DNS servers configured for this switch
dns_suffix:
type: array
items:
type: string
description: DNS search suffixes configured for this switch
evpn_config:
allOf:
- $ref: '#/components/schemas/evpn_config3'
- description: EVPN configuration applied to this switch
readOnly: true
extra_routes:
type: object
additionalProperties:
$ref: '#/components/schemas/extra_route'
description: Additional IPv4 routes configured on this switch
examples:
- 0.0.0.0/0:
via: 192.168.1.10
extra_routes6:
type: object
additionalProperties:
$ref: '#/components/schemas/extra_route6'
description: Additional IPv6 routes configured on this switch
examples:
- 2a02:1234:420a:10c9::/64:
via: 2a02:1234:200a::100
id:
type: string
description: Unique identifier of the switch object
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
image1_url:
type:
- string
- 'null'
description: First custom image URL associated with the switch
image2_url:
type:
- string
- 'null'
description: Second custom image URL associated with the switch
image3_url:
type:
- string
- 'null'
description: Third custom image URL associated with the switch
iot_config:
type: object
additionalProperties:
$ref: '#/components/schemas/switch_iot_port'
description: IoT port settings for this switch
ip_config:
allOf:
- $ref: '#/components/schemas/junos_ip_config3'
- description: Management IP addressing settings for this switch
local_port_config:
type: object
additionalProperties:
$ref: '#/components/schemas/junos_local_port_config'
description: Local port configuration settings for this switch
mac:
type: string
description: Switch MAC address used to identify the device
readOnly: true
managed:
type: boolean
description: An adopted switch/gateway will not be managed/configured by Mist by default. Setting this parameter to `true` enables the adopted switch/gateway to be managed/configured by Mist. Deprecated in favour of mist_configured, which is more intuitive and can be used for both adopted and claimed devices.
default: false
deprecated: true
map_id:
type: string
description: Map where the device belongs to
contentEncoding: uuid
examples:
- 63eda950-c6da-11e4-a628-60f81dd250cc
mist_configured:
type: boolean
description: whether the device can be configured by Mist or not. This deprecates `managed` (for adopted device) and `disable_auto_config` for claimed device)
mist_nac:
allOf:
- $ref: '#/components/schemas/switch_mist_nac5'
- description: Mist NAC settings applied to this switch
model:
type: string
description: Switch model reported for the device
readOnly: true
modified_time:
type: number
description: Timestamp when the switch object was last modified
readOnly: true
name:
type: string
description: Friendly display name assigned to the switch
networks:
type: object
additionalProperties:
$ref: '#/components/schemas/switch_network'
description: Layer 3 networks configured for use by this switch
notes:
type: string
description: Free-form administrative notes for this switch
ntp_servers:
type: array
items:
type: string
description: NTP servers used by this switch
oob_ip_config:
allOf:
- $ref: '#/components/schemas/switch_oob_ip_config3'
- description: Out-of-band management IP configuration for this switch
org_id:
type: string
description: Organization that owns this switch
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
ospf_areas:
type: object
additionalProperties:
$ref: '#/components/schemas/ospf_area'
description: OSPF area configuration for this switch
ospf_config:
allOf:
- $ref: '#/components/schemas/switch_ospf_config2'
- description: OSPF routing configuration for this switch
other_ip_configs:
type: object
additionalProperties:
$ref: '#/components/schemas/junos_other_ip_config'
description: Property key is the network name. Defines the additional IP Addresses configured on the device.
port_config:
type: object
additionalProperties:
$ref: '#/components/schemas/junos_port_config'
description: Per-port wired configuration for this switch
port_config_overwrite:
type: object
additionalProperties:
$ref: '#/components/schemas/switch_port_config_overwrite'
description: Per-port overrides for switch port usage attributes
port_mirroring:
type: object
additionalProperties:
$ref: '#/components/schemas/switch_port_mirroring_property'
description: Port mirroring configuration for this switch
port_usages:
type: object
additionalProperties:
$ref: '#/components/schemas/switch_port_usage'
description: Reusable switch port usage profiles available on this switch
radius_config:
allOf:
- $ref: '#/components/schemas/switch_radius_config6'
- description: RADIUS authentication and accounting settings for this switch
remote_syslog:
allOf:
- $ref: '#/components/schemas/remote_syslog5'
- description: Remote syslog settings for this switch
role:
type: string
description: Deployment role label for this switch
router_id:
type: string
description: Used for OSPF / BGP / EVPN
examples:
- 10.2.1.10
routing_policies:
type: object
additionalProperties:
$ref: '#/components/schemas/sw_routing_policy'
description: Routing policies applied by this switch
serial:
type: string
description: Manufacturer serial number for the switch
readOnly: true
site_id:
type: string
description: Site where this switch is assigned
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
snmp_config:
allOf:
- $ref: '#/components/schemas/snmp_config5'
- description: SNMP configuration for this switch
stp_config:
allOf:
- $ref: '#/components/schemas/switch_stp_config4'
- description: Spanning Tree Protocol configuration for this switch
switch_mgmt:
allOf:
- $ref: '#/components/schemas/switch_mgmt6'
- description: Management-plane settings for this switch
type:
const: switch
type: string
description: Device type discriminator for switch records
readOnly: true
use_router_id_as_source_ip:
type: boolean
description: Whether to use it for snmp / syslog / tacplus / radius
default: false
vars:
type: object
additionalProperties:
type: string
description: Variable values that override site variables for this switch
examples:
- RADIUS_IP1: 172.31.2.5
RADIUS_SECRET: 11s64632d
virtual_chassis:
allOf:
- $ref: '#/components/schemas/switch_virtual_chassis2'
- description: Virtual Chassis membership and provisioning settings for this switch
vrf_config:
allOf:
- $ref: '#/components/schemas/vrf_config8'
- description: VRF configuration applied to this switch
vrf_instances:
type: object
additionalProperties:
$ref: '#/components/schemas/switch_vrf_instance'
description: VRF instances configured on this switch
examples:
- guest:
extra_routes:
0.0.0.0/0:
via: 192.168.31.1
networks:
- guest
vrrp_config:
allOf:
- $ref: '#/components/schemas/vrrp_config3'
- description: VRRP configuration applied to this switch
x:
type: number
description: Horizontal map position of the switch, in pixels
examples:
- 53.5
y:
type: number
description: Vertical map position of the switch, in pixels
examples:
- 173.1
description: >-
You can configure `port_usages` and `networks` settings at the device level, but most of the time it's better use the Site Setting to achieve better consistency and be able to re-use the same settings across switches entries defined here will "replace" those defined in Site Setting/Network Template
In addition it is possible to use the `port_config_overwrite` to overwrite some attributes of the port_usage without having to create a new port_usage.
device_type:
title: device_type
enum:
- ap
- gateway
- switch
type: string
description: 'enum: `ap`, `gateway`, `switch`'
device_type_ap:
title: device_type_ap
const: ap
type: string
description: 'Device Type. enum: `ap`'
device_type_default_ap:
title: device_type_default_ap
enum:
- ap
- gateway
- switch
type: string
description: 'enum: `ap`, `gateway`, `switch`'
device_type_gateway:
title: device_type_gateway
const: gateway
type: string
description: 'Device Type. enum: `gateway`'
device_type_switch:
title: device_type_switch
const: switch
type: string
description: 'Device Type. enum: `switch`'
device_upgrade:
title: device_upgrade
required:
- version
type: object
properties:
reboot:
type: boolean
description: For Switches and Gateways only (APs are automatically rebooted). Reboot device immediately after upgrade is completed
default: false
reboot_at:
type: integer
description: For Switches and Gateways only and if `reboot`==`true`. Reboot start time in epoch seconds, default is `start_time`
contentEncoding: int32
snapshot:
type: boolean
description: For Junos devices only. Perform recovery snapshot after device is rebooted
default: false
start_time:
type: integer
description: Firmware download start time in epoch
contentEncoding: int32
version:
type: string
description: Specific version / `stable`, default is to use the latest
description: Device firmware upgrade request options
device_version_item:
title: device_version_item
required:
- model
- version
type: object
properties:
model:
type: string
description: Device model (as seen in the device stats)
tag:
type: string
description: Annotation, suggested / alpha. Or it can be empty or nothing which is likely a dev build
version:
type: string
description: Available firmware version for this device model
description: Available firmware version for a specific device model and release tag
deviceprofile_ap:
title: deviceprofile_ap
required:
- type
type: object
properties:
aeroscout:
allOf:
- $ref: '#/components/schemas/ap_aeroscout2'
- description: Location integration defaults for AeroScout in this AP profile
airista:
allOf:
- $ref: '#/components/schemas/ap_airista2'
- description: Location integration defaults for Airista in this AP profile
ble_config:
allOf:
- $ref: '#/components/schemas/ble_config2'
- description: Bluetooth Low Energy beacon and asset defaults in this AP profile
created_time:
type: number
description: Timestamp when the AP device profile was created
readOnly: true
disable_eth1:
type: boolean
description: Whether to disable eth1 port
default: false
disable_eth2:
type: boolean
description: Whether to disable eth2 port
default: false
disable_eth3:
type: boolean
description: Whether to disable eth3 port
default: false
disable_module:
type: boolean
description: Whether to disable module port
default: false
esl_config:
allOf:
- $ref: '#/components/schemas/ap_esl_config2'
- description: Electronic shelf label integration defaults in this AP profile
for_site:
type: boolean
description: Whether this AP profile is scoped directly to a site
readOnly: true
id:
type: string
description: Unique identifier of the AP device profile
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
iot_config:
allOf:
- $ref: '#/components/schemas/ap_iot2'
- description: Digital and analog IoT pin defaults in this AP profile
ip_config:
allOf:
- $ref: '#/components/schemas/ap_ip_config2'
- description: Management IP addressing defaults in this AP profile
lacp_config:
allOf:
- $ref: '#/components/schemas/device_ap_lacp_config2'
- description: Link aggregation defaults for supported AP Ethernet uplinks
led:
allOf:
- $ref: '#/components/schemas/ap_led2'
- description: Indicator light behavior defaults in this AP profile
mesh:
allOf:
- $ref: '#/components/schemas/ap_mesh2'
- description: Wireless mesh role and band defaults in this AP profile
modified_time:
type: number
description: Timestamp when the AP device profile was last modified
readOnly: true
mqtt_config:
allOf:
- $ref: '#/components/schemas/ap_mqtt2'
- description: MQTT broker publishing settings for this AP profile
name:
type:
- string
- 'null'
description: Display name of the AP device profile
ntp_servers:
uniqueItems: true
type: array
items:
type: string
description: NTP servers configured by this AP profile
org_id:
type: string
description: Organization that owns this AP device profile
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
poe_passthrough:
type: boolean
description: Whether to enable power out through module port (for APH) or eth1 (for APL/BT11)
default: false
port_config:
type: object
additionalProperties:
$ref: '#/components/schemas/ap_port_config'
description: eth0 is not allowed here. Property key is the interface(s) name (e.g. `eth1` or `eth1,eth2`). If specified, this takes precedence over switch_config (deprecated)
pwr_config:
allOf:
- $ref: '#/components/schemas/ap_pwr_config2'
- description: Power negotiation and peripheral power defaults in this AP profile
radio_config:
allOf:
- $ref: '#/components/schemas/ap_radio2'
- description: Radio configuration defaults in this AP profile
site_id:
type: string
description: Site where this AP device profile is defined, when scoped to a site
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
switch_config:
allOf:
- $ref: '#/components/schemas/ap_switch1'
- description: Deprecated AP switch configuration defaults in this profile
deprecated: true
type:
const: ap
type: string
description: Device type discriminator for AP device profiles
uplink_port_config:
allOf:
- $ref: '#/components/schemas/ap_uplink_port_config2'
- description: Authentication and failover defaults for AP uplink ports
usb_config:
allOf:
- $ref: '#/components/schemas/ap_usb2'
- description: Legacy USB integration defaults in this AP profile
uwb_config:
allOf:
- $ref: '#/components/schemas/ap_uwb_config2'
- description: UWB RTLS / OMLOX asset-visibility settings; overrides the site-level `uwb_config` and is overridden by device-level `uwb_config`
vars:
type: object
additionalProperties:
type: string
description: Variable values provided by this AP device profile
examples:
- RADIUS_IP1: 172.31.2.5
RADIUS_SECRET: 11s64632d
zigbee_config:
allOf:
- $ref: '#/components/schemas/ap_zigbee2'
- description: Zigbee radio and network defaults in this AP profile
description: AP device profile configuration applied to APs at a site or organization
deviceprofile_gateway:
title: deviceprofile_gateway
required:
- name
- type
type: object
properties:
additional_config_cmds:
type: array
items:
type: string
description: Additional CLI configuration commands provided by this gateway profile
bgp_config:
type: object
additionalProperties:
$ref: '#/components/schemas/bgp_config'
description: BGP routing defaults for this gateway profile. Property key is the BGP session name
created_time:
type: number
description: Timestamp when the gateway profile was created
readOnly: true
dhcpd_config:
allOf:
- $ref: '#/components/schemas/dhcpd_config1'
- description: DHCP server defaults provided by this gateway profile
dnsOverride:
type: boolean
description: Whether DNS server and suffix settings in this profile override inherited values
default: false
dns_servers:
type: array
items:
type: string
description: DNS servers provided by this gateway profile
dns_suffix:
type: array
items:
type: string
description: DNS search suffixes provided by this gateway profile
extra_routes:
type: object
additionalProperties:
$ref: '#/components/schemas/gateway_extra_route'
description: Additional IPv4 route defaults in this gateway profile
extra_routes6:
type: object
additionalProperties:
$ref: '#/components/schemas/gateway_extra_route6'
description: Additional IPv6 route defaults in this gateway profile
examples:
- 2a02:1234:420a:10c9::/64:
via: 2a02:1234:200a::100
gateway_matching:
allOf:
- $ref: '#/components/schemas/gateway_matching3'
- description: Matching rules that select gateways for this profile
id:
type: string
description: Unique identifier of the gateway profile
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
idp_profiles:
type: object
additionalProperties:
$ref: '#/components/schemas/idp_profile'
description: Intrusion detection and prevention profile defaults in this gateway profile
ip_configs:
type: object
additionalProperties:
$ref: '#/components/schemas/gateway_ip_config_property'
description: Gateway interface IP configuration defaults by network name
modified_time:
type: number
description: Timestamp when the gateway profile was last modified
readOnly: true
name:
type: string
description: Display name of the gateway profile
examples:
- gw_template
networks:
type: array
items:
$ref: '#/components/schemas/network'
description: Layer 3 networks configured by this gateway profile
ntpOverride:
type: boolean
description: Whether NTP servers in this profile override inherited values
default: false
ntp_servers:
type: array
items:
type: string
description: NTP servers provided by this gateway profile
oob_ip_config:
allOf:
- $ref: '#/components/schemas/gateway_oob_ip_config1'
- description: Out-of-band management IP defaults in this gateway profile
org_id:
type: string
description: Organization that owns this gateway profile
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
path_preferences:
type: object
additionalProperties:
$ref: '#/components/schemas/gateway_path_preferences'
description: Property key is the path name
port_config:
type: object
additionalProperties:
$ref: '#/components/schemas/gateway_port_config'
description: Property key is the port(s) name or range (e.g. "ge-0/0/0-10")
router_id:
type: string
description: Auto assigned if not set
examples:
- 10.2.1.10
routing_policies:
type: object
additionalProperties:
$ref: '#/components/schemas/gw_routing_policy'
description: Routing policy defaults applied by this gateway profile
service_policies:
type: array
items:
$ref: '#/components/schemas/service_policy'
description: Traffic service policy defaults enforced by this gateway profile
tunnel_configs:
type: object
additionalProperties:
$ref: '#/components/schemas/tunnel_config'
description: Property key is the tunnel name
tunnel_provider_options:
allOf:
- $ref: '#/components/schemas/tunnel_provider_options1'
- description: Provider-specific tunnel options defined by this gateway profile
type:
const: gateway
type: string
description: Device type discriminator for gateway profiles
url_filtering_deny_msg:
type: string
description: When a service policy denies a app_category, what message to show in user's browser
default: Access to this URL Category has been blocked
examples:
- Access to this URL Category has been blocked
vrf_config:
allOf:
- $ref: '#/components/schemas/vrf_config2'
- description: VRF defaults applied by this gateway profile
vrf_instances:
type: object
additionalProperties:
$ref: '#/components/schemas/gateway_vrf_instance'
description: VRF instances configured by this gateway profile
examples:
- CORP_VRF:
networks:
- CORP_NET
- MGMT_NET
description: Gateway Template is applied to a site for gateway(s) in a site.
deviceprofile_switch:
title: deviceprofile_switch
required:
- name
- type
type: object
properties:
acl_policies:
type: array
items:
$ref: '#/components/schemas/acl_policy'
description: ACL policy defaults provided by this switch profile
acl_tags:
type: object
additionalProperties:
$ref: '#/components/schemas/acl_tag'
description: ACL tags available to switch access policies in this profile
additional_config_cmds:
type: array
items:
type: string
description: Additional CLI configuration commands provided by this switch profile
aggregate_routes:
type: object
additionalProperties:
$ref: '#/components/schemas/aggregate_route'
description: Additional IPv4 aggregate route defaults in this switch profile
examples:
- 172.16.3.0/24:
discard: false
metric: null
preference: 30
aggregate_routes6:
type: object
additionalProperties:
$ref: '#/components/schemas/aggregate_route'
description: Additional IPv6 aggregate route defaults in this switch profile
examples:
- 2a02:1234:420a:10c9::/64:
discard: false
metric: null
preference: 30
created_time:
type: number
description: Timestamp when the switch profile was created
readOnly: true
dhcp_snooping:
allOf:
- $ref: '#/components/schemas/dhcp_snooping1'
- description: DHCP snooping defaults provided by this switch profile
dhcpd_config:
allOf:
- $ref: '#/components/schemas/switch_dhcpd_config1'
- description: DHCP server defaults provided by this switch profile
dns_servers:
type: array
items:
type: string
description: DNS servers provided by this switch profile
dns_suffix:
type: array
items:
type: string
description: DNS search suffixes provided by this switch profile
evpn_config:
allOf:
- $ref: '#/components/schemas/evpn_config1'
- description: EVPN defaults applied by this switch profile
readOnly: true
extra_routes:
type: object
additionalProperties:
$ref: '#/components/schemas/extra_route'
description: Additional IPv4 route defaults in this switch profile
examples:
- 0.0.0.0/0:
via: 192.168.1.10
extra_routes6:
type: object
additionalProperties:
$ref: '#/components/schemas/extra_route6'
description: Additional IPv6 route defaults in this switch profile
examples:
- 2a02:1234:420a:10c9::/64:
via: 2a02:1234:200a::100
id:
type: string
description: Unique identifier of the switch profile
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
iot_config:
type: object
additionalProperties:
$ref: '#/components/schemas/switch_iot_port'
description: IoT port defaults provided by this switch profile
ip_config:
allOf:
- $ref: '#/components/schemas/junos_ip_config1'
- description: Management IP addressing defaults in this switch profile
mist_nac:
allOf:
- $ref: '#/components/schemas/switch_mist_nac1'
- description: Mist NAC defaults applied by this switch profile
modified_time:
type: number
description: Timestamp when the switch profile was last modified
readOnly: true
name:
type: string
description: Display name of the switch profile
networks:
type: object
additionalProperties:
$ref: '#/components/schemas/switch_network'
description: Layer 3 networks configured by this switch profile
ntp_servers:
type: array
items:
type: string
description: NTP servers provided by this switch profile
oob_ip_config:
allOf:
- $ref: '#/components/schemas/switch_oob_ip_config1'
- description: Out-of-band management IP defaults in this switch profile
org_id:
type: string
description: Organization that owns this switch profile
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
ospf_areas:
type: object
additionalProperties:
$ref: '#/components/schemas/ospf_area'
description: OSPF area defaults provided by this switch profile
other_ip_configs:
type: object
additionalProperties:
$ref: '#/components/schemas/junos_other_ip_config'
description: Property key is the network name. Defines the additional IP Addresses configured on the device.
port_config:
type: object
additionalProperties:
$ref: '#/components/schemas/junos_port_config'
description: Per-port wired defaults provided by this switch profile
port_mirroring:
type: object
additionalProperties:
$ref: '#/components/schemas/switch_port_mirroring_property'
description: Port mirroring defaults provided by this switch profile
port_usages:
type: object
additionalProperties:
$ref: '#/components/schemas/switch_port_usage'
description: Reusable switch port usage profiles provided by this switch profile
radius_config:
allOf:
- $ref: '#/components/schemas/switch_radius_config2'
- description: RADIUS authentication and accounting defaults in this switch profile
remote_syslog:
allOf:
- $ref: '#/components/schemas/remote_syslog1'
- description: Remote syslog defaults provided by this switch profile
routing_policies:
type: object
additionalProperties:
$ref: '#/components/schemas/sw_routing_policy'
description: Routing policy defaults applied by this switch profile
site_id:
type: string
description: Site where this switch profile is defined, when scoped to a site
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
snmp_config:
allOf:
- $ref: '#/components/schemas/snmp_config1'
- description: SNMP defaults provided by this switch profile
stp_config:
allOf:
- $ref: '#/components/schemas/switch_stp_config1'
- description: Spanning Tree Protocol defaults provided by this switch profile
switch_mgmt:
allOf:
- $ref: '#/components/schemas/switch_mgmt1'
- description: Management-plane defaults provided by this switch profile
type:
const: switch
type: string
description: Device type discriminator for switch profiles
readOnly: true
use_router_id_as_source_ip:
type: boolean
description: Whether to use it for snmp / syslog / tacplus / radius
default: false
vrf_config:
allOf:
- $ref: '#/components/schemas/vrf_config3'
- description: VRF defaults applied by this switch profile
vrf_instances:
type: object
additionalProperties:
$ref: '#/components/schemas/switch_vrf_instance'
description: VRF instances configured by this switch profile
examples:
- guest:
extra_routes:
0.0.0.0/0:
via: 192.168.31.1
networks:
- guest
vrrp_config:
allOf:
- $ref: '#/components/schemas/vrrp_config1'
- description: VRRP defaults applied by this switch profile
description: Switch Device Profiles can be applied to one or multiple switches. The settings from the Device Profile will override the settings from the Switch Template and the Site Settings.
devices_gbp_tag:
title: devices_gbp_tag
required:
- gbp_tag
- macs
type: object
properties:
gbp_tag:
type: integer
description: Group-Based Policy tag value to apply to the devices
contentEncoding: int32
macs:
minItems: 1
uniqueItems: true
type: array
items:
type: string
description: Device MAC addresses that receive the GBP tag
examples:
- - 683b679ac024
description: Request body for assigning a GBP tag to multiple devices
devices_ids:
title: devices_ids
required:
- device_ids
type: object
properties:
device_ids:
type: array
items:
type: string
contentEncoding: uuid
description: Device identifiers to operate on in the request
description: Request body containing device identifiers
dhcp_client_option:
title: dhcp_client_option
type: object
properties:
code:
type: string
description: DHCP option code and option name
examples:
- DHO_DHCP_MESSAGE_TYPE(53)
data:
type: string
description: Decoded value carried by the DHCP option
examples:
- DHCPREQUEST
description: DHCP client option observed in a DHCP packet
dhcp_snooping:
title: dhcp_snooping
type: object
properties:
all_networks:
type: boolean
description: Whether DHCP snooping applies to all configured networks
enable_arp_spoof_check:
type: boolean
description: Enable for dynamic ARP inspection check
enable_ip_source_guard:
type: boolean
description: Enable for check for forging source IP address
enabled:
type: boolean
description: Whether DHCP snooping is enabled
networks:
type: array
items:
type: string
description: Network names with DHCP snooping enabled when `all_networks`==`false`
description: DHCP snooping security settings
dhcpd_config:
title: dhcpd_config
type: object
properties:
enabled:
type: boolean
description: If set to `false`, disable the DHCP server
default: true
additionalProperties:
allOf:
- $ref: '#/components/schemas/dhcpd_config_property'
- description: DHCP server or relay configuration for one network
description: DHCP server configuration map with a global enable flag
dhcpd_config_fixed_binding:
title: dhcpd_config_fixed_binding
type: object
properties:
ip:
type: string
description: Reserved IPv4 address for this fixed DHCP binding
examples:
- 192.168.70.35
ip6:
type: string
description: Reserved IPv6 address for this fixed DHCP binding
examples:
- 2607:f8b0:4005:808::2
name:
type: string
description: Friendly name for this fixed DHCP binding
description: Static DHCP binding for a client MAC address
dhcpd_config_option:
title: dhcpd_config_option
type: object
properties:
type:
allOf:
- $ref: '#/components/schemas/dhcpd_config_option_type2'
- description: 'Data type used to encode this DHCP option value. enum: `boolean`, `hex`, `int16`, `int32`, `ip`, `string`, `uint16`, `uint32`.'
value:
type: string
description: Option value to send for this DHCP option
description: Custom DHCP option value
dhcpd_config_option_type:
title: dhcpd_config_option_type
enum:
- boolean
- hex
- int16
- int32
- ip
- string
- uint16
- uint32
type: string
description: 'enum: `boolean`, `hex`, `int16`, `int32`, `ip`, `string`, `uint16`, `uint32`'
dhcpd_config_property:
title: dhcpd_config_property
type: object
properties:
dns_servers:
type: array
items:
type: string
description: If `type`==`local` or `type6`==`local`, DNS servers advertised to DHCP clients
examples:
- - 8.8.8.8
- 4.4.4.4
- 2001:4860:4860::8888
dns_suffix:
type: array
items:
type: string
description: If `type`==`local` or `type6`==`local`, DNS search suffixes advertised to DHCP clients
examples:
- - .mist.local
- .mist.com
fixed_bindings:
type: object
additionalProperties:
$ref: '#/components/schemas/dhcpd_config_fixed_binding'
description: If `type`==`local` or `type6`==`local`, fixed client bindings for local DHCP service
examples:
- 5684dae9ac8b:
ip: 192.168.70.35
name: John
gateway:
type: string
description: If `type`==`local` - optional, `ip` will be used if not provided
examples:
- 192.168.70.1
ip6_end:
type: string
description: If `type6`==`local`, ending IPv6 address for the DHCP lease pool
examples:
- 2607:f8b0:4005:808::ff
ip6_start:
type: string
description: If `type6`==`local`, starting IPv6 address for the DHCP lease pool
examples:
- 2607:f8b0:4005:808::2
ip_end:
type: string
description: If `type`==`local`, ending IPv4 address for the DHCP lease pool
examples:
- 192.168.70.200
ip_start:
type: string
description: If `type`==`local`, starting IPv4 address for the DHCP lease pool
examples:
- 192.168.70.100
lease_time:
maximum: 604800
minimum: 3600
type: integer
description: In seconds, lease time has to be between 3600 [1hr] - 604800 [1 week], default is 86400 [1 day]
contentEncoding: int32
default: 86400
options:
type: object
additionalProperties:
$ref: '#/components/schemas/dhcpd_config_option'
description: If `type`==`local` or `type6`==`local`, custom DHCP options advertised to clients
server_id_override:
type: boolean
description: "`server_id_override`==`true` means the device, when acts as DHCP relay and forwards DHCP responses from DHCP server to clients, \nshould overwrite the Sever Identifier option (i.e. DHCP option 54) in DHCP responses with its own IP address."
default: false
servers:
type: array
items:
type: string
description: If `type`==`relay`, upstream IPv4 DHCP servers
examples:
- - 11.2.3.4
serversv6:
type: array
items:
type: string
description: If `type6`==`relay`, upstream IPv6 DHCP servers
examples:
- - 2607:f8b0:4005:808::64
type:
allOf:
- $ref: '#/components/schemas/dhcpd_config_type2'
- description: 'IPv4 DHCP mode for this network. enum: `local`, `none`, `relay`.'
type6:
allOf:
- $ref: '#/components/schemas/dhcpd_config_type62'
- description: 'IPv6 DHCP mode for this network. enum: `local`, `none`, `relay`.'
vendor_encapsulated:
type: object
additionalProperties:
$ref: '#/components/schemas/dhcpd_config_vendor_option'
description: If `type`==`local` or `type6`==`local`, vendor-encapsulated DHCP options advertised to clients
description: DHCP server or relay configuration for one network
dhcpd_config_type:
title: dhcpd_config_type
enum:
- local
- none
- relay
type: string
description: 'enum: `local` (DHCP Server), `none`, `relay` (DHCP Relay)'
dhcpd_config_vendor_option:
title: dhcpd_config_vendor_option
type: object
properties:
type:
allOf:
- $ref: '#/components/schemas/dhcpd_config_vendor_option_type2'
- description: 'Data type used to encode this vendor option value. enum: `boolean`, `hex`, `int16`, `int32`, `ip`, `string`, `uint16`, `uint32`.'
value:
type: string
description: Option value to send for this vendor option
description: Vendor-encapsulated DHCP option value
dhcpd_config_vendor_option_type:
title: dhcpd_config_vendor_option_type
enum:
- boolean
- hex
- int16
- int32
- ip
- string
- uint16
- uint32
type: string
description: 'enum: `boolean`, `hex`, `int16`, `int32`, `ip`, `string`, `uint16`, `uint32`'
dhcpd_stat_lan:
title: dhcpd_stat_lan
type: object
properties:
num_ips:
type: integer
description: Total number of IP addresses in the DHCP pool
contentEncoding: int32
examples:
- 100
num_leased:
type: integer
description: Number of DHCP pool addresses currently leased
contentEncoding: int32
examples:
- 20
description: DHCP lease statistics for one network
discovered_switch:
title: discovered_switch
type: object
properties:
adopted:
type: boolean
description: Whether the discovered switch has been adopted into Mist management
ap_redundancy:
allOf:
- $ref: '#/components/schemas/ap_redundancy1'
- description: AP switch redundancy summary for APs connected through the discovered switch
aps:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/discovered_switch_ap'
description: Connected APs observed on ports of the discovered switch
chassis_id:
uniqueItems: true
type: array
items:
type: string
description: LLDP chassis identifier reported by the discovered switch
for_site:
type: boolean
description: Whether the discovered switch is associated with the requested site
readOnly: true
mgmt_addr:
type: string
description: Management IP address advertised by the discovered switch
model:
type: string
description: Switch model reported for the discovered switch
org_id:
type: string
description: Organization that contains the discovered switch record
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
site_id:
type: string
description: Site where the switch was discovered
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
system_desc:
type: string
description: LLDP system description advertised by the discovered switch
system_name:
type: string
description: LLDP system name advertised by the discovered switch
timestamp:
type: number
description: Time when the discovered switch data was observed
readOnly: true
vendor:
type: string
description: Switch vendor reported for the discovered switch
version:
type: string
description: Software version reported for the discovered switch
description: Switch discovered from AP uplink LLDP data and site switch discovery
discovered_switch_ap:
title: discovered_switch_ap
type: object
properties:
hostname:
type: string
description: AP hostname observed on the discovered switch
inactive_wired_vlans:
type: array
items:
type: integer
contentEncoding: int32
description: Inactive wired VLAN IDs reported for the AP attachment
mac:
type: string
description: AP MAC address observed on the discovered switch
poe_status:
type: boolean
description: Whether the upstream switch port provides PoE for the AP
port:
type: string
description: Switch port name connected to the AP
port_id:
type: string
description: LLDP port identifier for the AP uplink
power_draw:
type: number
description: Power draw reported for the AP connection
when:
type: string
description: Timestamp when this AP attachment was last observed
description: AP attachment details observed on a discovered switch
discovered_switch_metric:
title: discovered_switch_metric
type: object
properties:
adopted:
type: boolean
description: Whether the discovered switch in this metric has been adopted into Mist management
aps:
type: array
items:
$ref: '#/components/schemas/discovered_switch_metric_ap'
description: AP attachment details included with this discovered switch metric
chassis_id:
type: array
items:
type: string
description: LLDP chassis identifiers associated with this metric result
hostname:
type: string
description: Switch hostname associated with this metric result
examples:
- SW-HLAB-ea2e00
mgmt_addr:
type: string
description: Management IP address associated with this metric result
examples:
- 10.10.20.42
model:
type: string
description: Switch model associated with this metric result
org_id:
type: string
description: Organization that contains the discovered switch metric
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
scope:
type: string
description: Aggregation scope for the discovered switch metric result
examples:
- site
score:
type: integer
description: Compliance or health score for the discovered switch metric
contentEncoding: int32
examples:
- 100
site_id:
type: string
description: Site associated with the discovered switch metric
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
system_desc:
type: string
description: LLDP system description associated with this metric result
examples:
- 'Juniper Networks, Inc. ex4100-f-12p Ethernet Switch, kernel JUNOS 22.4R3.25, Build date: 2024-02-10 00:49:09 UTC Copyright (c) 1996-2024 Juniper Networks, Inc.'
system_name:
type: string
description: LLDP system name associated with this metric result
examples:
- SW-HLAB-ea2e00
timestamp:
type: number
description: Time bucket for the discovered switch metric result
readOnly: true
type:
type: string
description: Metric category represented by this discovered switch metric
examples:
- inactive_wired_vlans
vendor:
type: string
description: Switch vendor associated with this metric result
version:
type: string
description: Software version associated with this metric result
description: Time-series metric result for discovered switch health or compliance
discovered_switch_metric_ap:
title: discovered_switch_metric_ap
type: object
properties:
hostname:
type: string
description: AP hostname included in the discovered switch metric
mac:
type: string
description: AP MAC address included in the discovered switch metric
poe_status:
type: boolean
description: Whether the upstream switch port provides PoE for this AP
port:
type: string
description: Switch port name connected to this AP
port_id:
type: string
description: LLDP port identifier for this AP uplink
power_draw:
type: integer
description: Power draw reported for this AP connection
contentEncoding: int32
when:
type: string
description: Timestamp when this AP attachment metric was observed
description: AP attachment details included in a discovered switch metric
discovered_switch_metric_type:
title: discovered_switch_metric_type
enum:
- inactive_wired_vlans
- poe_compliance
- switch_ap_affinity
- version_compliance
type: string
description: 'enum: `inactive_wired_vlans`, `poe_compliance`, `switch_ap_affinity`, `version_compliance`'
discovered_switches_metric_scope:
title: discovered_switches_metric_scope
enum:
- site
- switch
type: string
description: 'Scope level used when querying discovered switch metrics. enum: `site`, `switch`'
dot11_bandwidth:
title: dot11_bandwidth
enum:
- 0
- 20
- 40
- 80
- 160
type: integer
description: 'channel width for the band.enum: `0`(disabled, response only), `20`, `40`, `80` (only applicable for band_5 and band_6), `160` (only for band_6)'
examples:
- 20
dot11_bandwidth24:
title: dot11_bandwidth24
enum:
- 0
- 20
- 40
type: integer
description: 'channel width for the 2.4GHz band. enum: `0`(disabled, response only), `20`, `40`'
examples:
- 20
dot11_bandwidth5:
title: dot11_bandwidth5
enum:
- 0
- 20
- 40
- 80
type: integer
description: 'channel width for the 5GHz band. enum: `0`(disabled, response only), `20`, `40`, `80`'
examples:
- 40
dot11_bandwidth6:
title: dot11_bandwidth6
enum:
- 0
- 20
- 40
- 80
- 160
type: integer
description: 'channel width for the 6GHz band. enum: `0`(disabled, response only), `20`, `40`, `80`, `160`'
examples:
- 80
dot11_proto:
title: dot11_proto
enum:
- a
- ac
- ax
- b
- be
- g
- n
type: string
description: 'enum: `a`, `ac`, `ax`, `b`, `be`, `g`, `n`'
dswitches_compliance_major_version:
title: dswitches_compliance_major_version
required:
- major_count
- model
type: object
properties:
major_count:
type: number
description: Number of major software versions observed for this switch model
model:
type: string
description: Switch model represented by this version-compliance grouping
system_names:
uniqueItems: true
type: array
items:
type: string
description: Discovered switch system names included in this version-compliance grouping
description: Version-compliance grouping for one discovered switch model
dswitches_metrics_inactive_wired_vlans:
title: dswitches_metrics_inactive_wired_vlans
required:
- details
- score
type: object
properties:
details:
type: object
description: Metric-specific details for inactive wired VLAN findings
score:
type: number
description: Compliance score for the inactive wired VLAN metric
description: Inactive wired VLAN metric for APs connected to discovered switches
dswitches_metrics_poe_compliance:
title: dswitches_metrics_poe_compliance
required:
- details
- score
type: object
properties:
details:
allOf:
- $ref: '#/components/schemas/dswitches_metrics_poe_compliance_details2'
- description: Counts and power totals used to calculate the PoE compliance score
score:
type: number
description: Compliance score for the PoE compliance metric
description: PoE compliance metric for APs connected to discovered switches
dswitches_metrics_poe_compliance_details:
title: dswitches_metrics_poe_compliance_details
required:
- total_aps
- total_power
type: object
properties:
total_aps:
type: integer
description: Number of APs evaluated for PoE compliance
contentEncoding: int32
total_power:
type: number
description: Aggregate AP PoE power demand across evaluated APs, in mW
description: Detail values used by the discovered-switch PoE compliance metric
dswitches_metrics_switch_ap_affinity:
title: dswitches_metrics_switch_ap_affinity
required:
- details
- score
type: object
properties:
details:
allOf:
- $ref: '#/components/schemas/dswitches_metrics_switch_ap_affinity_details2'
- description: Switch names and threshold used to calculate the affinity score
score:
type: number
description: Compliance score for the switch/AP affinity metric
description: Switch/AP affinity metric for discovered switches
dswitches_metrics_switch_ap_affinity_details:
title: dswitches_metrics_switch_ap_affinity_details
required:
- system_name
- threshold
type: object
properties:
system_name:
uniqueItems: true
type: array
items:
type: string
description: Discovered switch system names reported for the affinity metric
threshold:
type: number
description: APs-per-switch threshold used for the affinity metric
description: Detail values used by the switch/AP affinity metric
dswitches_metrics_version_compliance:
title: dswitches_metrics_version_compliance
required:
- details
- score
type: object
properties:
details:
allOf:
- $ref: '#/components/schemas/dswitches_metrics_version_compliance_details2'
- description: Version grouping details used to calculate the compliance score
score:
type: number
description: Compliance score for the discovered-switch version metric
description: Version compliance metric for discovered switches
dswitches_metrics_version_compliance_details:
title: dswitches_metrics_version_compliance_details
required:
- major_versions
- total_switch_count
type: object
properties:
major_versions:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/dswitches_compliance_major_version'
description: Per-model major version groupings used for version compliance
total_switch_count:
type: integer
description: Number of discovered switches evaluated for version compliance
contentEncoding: int32
description: Detail values used by the discovered-switch version compliance metric
dynamic_psk_source:
title: dynamic_psk_source
enum:
- cloud_psks
- radius
type: string
description: 'Origin used to retrieve per-user PSKs. enum: `cloud_psks`, `radius`'
examples:
- cloud_psks
edgeconnect_register_cmd:
title: edgeconnect_register_cmd
type: object
properties:
registration_code:
type: string
description: Registration code used to adopt an EdgeConnect device into Mist
description: EdgeConnect device registration command response
edr_provider:
title: edr_provider
enum:
- crowdstrike
- sentinelone
type: string
description: 'EDR provider associated with the NAC client. enum: `crowdstrike`, `sentinelone`'
edr_status:
title: edr_status
enum:
- sentinelone_healthy
- sentinelone_infected
- crowdstrike_low
- crowdstrike_medium
- crowdstrike_high
- crowdstrike_critical
- crowdstrike_informational
type: string
description: 'EDR Status of the NAC client. enum: `sentinelone_healthy`, `sentinelone_infected`, `crowdstrike_low`, `crowdstrike_medium`, `crowdstrike_high`, `crowdstrike_critical`, `crowdstrike_informational`'
email_string:
title: email_string
required:
- email
type: object
properties:
email:
type: string
description: Request email address provided in the payload
contentEncoding: email
description: Request body containing an email address
error_delete_failed:
title: error_delete_failed
required:
- detail
- org_id
type: object
properties:
detail:
type: string
description: Reason the delete request failed
examples:
- inventory not empty
org_id:
type: string
description: Organization that could not be deleted and caused the delete request to fail
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
description: Error response returned when an organization delete request is blocked
event_fastroam:
title: event_fastroam
required:
- ap_mac
- client_mac
- fromap
- latency
- ssid
- timestamp
type: object
properties:
ap_mac:
type: string
description: Destination AP MAC address for the roam
client_mac:
type: string
description: Roaming client MAC address for the event
fromap:
type: string
description: Source AP MAC address reported for the roam
latency:
type: number
description: Roaming latency measured for the client event, in seconds
ssid:
type: string
description: Wireless network SSID involved in the roam
subtype:
type: string
description: Detailed roaming event subtype
timestamp:
type: number
description: Time when the roaming event occurred
readOnly: true
type:
allOf:
- $ref: '#/components/schemas/event_fastroam_type2'
- description: 'Fast-roam result category for the event. enum: `fail`, `none`, `pingpong`, `poor`, `slow`, `success`.'
description: Fast-roaming event observed for a wireless client
event_fastroam_type:
title: event_fastroam_type
enum:
- fail
- none
- pingpong
- poor
- slow
- success
type: string
description: 'enum: `fail`, `none`, `pingpong`, `poor`, `slow`, `success`'
event_otherdevice:
title: event_otherdevice
type: object
properties:
device_mac:
type: string
description: Attached device MAC address associated with the other-device event
mac:
type: string
description: Other-device MAC address associated with the event
examples:
- 5c5b351e13b5
org_id:
type: string
description: Organization that contains the other-device event
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
site_id:
type: string
description: Site where the other-device event occurred
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
text:
type: string
description: Human-readable message for the other-device event
examples:
- 'Plugged: The Internal 5GB (SIM1) has been inserted into Internal 1.'
timestamp:
type: number
description: Time when the other-device event occurred
readOnly: true
type:
type: string
description: Event type for the other-device event
examples:
- CELLULAR_EDGE_MODEM_WAN_PLUGGED
vendor:
type: string
description: Manufacturer or vendor name reported for the other device
examples:
- cradlepoint
description: Event generated by an other-device integration or attached device
event_severity:
title: event_severity
enum:
- normal
- critical
- high
- warning
type: string
description: 'Severity level for an event. enum: `normal`, `critical`, `high`, `warning`'
events_client:
title: events_client
required:
- band
- timestamp
type: object
properties:
ap:
type: string
description: Access point MAC address associated with the wireless client event
band:
allOf:
- $ref: '#/components/schemas/dot11_band1'
- description: 'Radio band used for the wireless client event. enum: `24`, `5`, `5-dedicated`, `5-selectable`, `6`, `6-dedicated`, `6-selectable`.'
bssid:
type: string
description: Wireless BSSID involved in the client event
channel:
type: integer
description: Radio channel used for the wireless client event
contentEncoding: int32
key_mgmt:
allOf:
- $ref: '#/components/schemas/client_key_mgmt1'
- description: 'Key management protocol used by the client session. enum: `WPA2-PSK`, `WPA2-PSK/CCMP`, `WPA2-PSK-FT`, `WPA2-PSK-SHA256`, `WPA3-EAP-SHA256`, `WPA3-EAP-SHA256/CCMP`, `WPA3-EAP-FT/GCMP256`, `WPA3-SAE-FT`, `WPA3-SAE-PSK`.'
examples:
- WPA2-PSK
proto:
allOf:
- $ref: '#/components/schemas/dot11_proto1'
- description: '802.11 protocol used by the client session. enum: `a`, `ac`, `ax`, `b`, `be`, `g`, `n`.'
ssid:
type: string
description: Wireless network SSID involved in the client event
text:
type: string
description: Human-readable message for the client event
timestamp:
type: number
description: Time when the client event occurred
readOnly: true
type:
type: string
description: Event type, e.g. MARVIS_EVENT_CLIENT_FBT_FAILURE
type_code:
type: integer
description: Reason code for association or disassociation client events
contentEncoding: int32
wlan_id:
type: string
description: Wireless LAN identifier associated with the client event
contentEncoding: uuid
description: Wireless client event returned by client event search APIs
events_client_wan:
title: events_client_wan
type: object
properties:
When:
type: string
description: Event timestamp string reported by the WAN client event source
examples:
- 2022-12-31 23:59:59.293000+00:00
ev_type:
type: string
description: WAN client event type identifier
examples:
- CLIENT_IP_ASSIGNED
metadata:
type: object
description: Additional attributes provided with the WAN client event
org_id:
type: string
description: Organization that contains the WAN client event
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
random_mac:
type: boolean
description: Whether the WAN client used a randomized MAC address
site_id:
type: string
description: Site where the WAN client event occurred
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
text:
type: string
description: Human-readable message for the WAN client event
examples:
- DHCP Ack IP 192.168.88.216
wcid:
type: string
description: WAN client identifier associated with the event
contentEncoding: uuid
examples:
- 62bbfb75-10d8-49d1-dec7-d2df91624287
description: WAN client event returned by WAN client event search APIs
events_rogue:
title: events_rogue
required:
- ap
- bssid
- channel
- rssi
- ssid
- timestamp
type: object
properties:
ap:
type: string
description: Access point MAC address that detected the rogue BSSID
bssid:
type: string
description: Rogue BSSID observed by the AP
channel:
type: integer
description: Radio channel where the rogue BSSID was observed
contentEncoding: int32
rssi:
type: integer
description: Received signal strength of the rogue BSSID, in dBm
contentEncoding: int32
ssid:
type: string
description: Wireless network SSID advertised by the rogue BSSID
timestamp:
type: number
description: Time when the rogue event was observed
readOnly: true
description: Rogue wireless network event detected by a site AP
events_skyatp:
title: events_skyatp
required:
- device_mac
- ip
- mac
- org_id
- site_id
- threat_level
- timestamp
- type
type: object
properties:
device_mac:
type: string
description: Network device MAC address that reported the SkyATP event
readOnly: true
for_site:
type: boolean
description: Whether the SkyATP event is scoped to a site rather than only the organization
readOnly: true
ip:
type: string
description: Client IP address associated with the SkyATP event
readOnly: true
mac:
type: string
description: Client MAC address associated with the SkyATP event
readOnly: true
org_id:
type: string
description: Organization that contains the SkyATP event
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
site_id:
type: string
description: Site where the SkyATP event occurred
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
threat_level:
type: integer
description: Numeric SkyATP threat level reported for the event
contentEncoding: int32
readOnly: true
timestamp:
type: number
description: Time when the SkyATP event occurred
readOnly: true
type:
type: string
description: SkyATP event type, such as `cc`, `fs`, or `mw`
readOnly: true
description: SkyATP threat event returned by SkyATP event search APIs
evpn_config:
title: evpn_config
type: object
properties:
enabled:
type: boolean
description: Whether EVPN configuration is enabled on the switch
readOnly: true
role:
allOf:
- $ref: '#/components/schemas/evpn_config_role2'
- description: 'EVPN topology role for the switch. enum: `access`, `border`, `collapsed-core`, `core`, `distribution`, `esilag-access`, `none`.'
readOnly: true
description: EVPN configuration settings applied to a Junos switch
evpn_config_role:
title: evpn_config_role
enum:
- access
- border
- collapsed-core
- core
- distribution
- esilag-access
- none
type: string
description: 'enum: `access`, `border`, `collapsed-core`, `core`, `distribution`, `esilag-access`, `none`'
evpn_options:
title: evpn_options
type: object
properties:
auto_loopback_subnet:
type: string
description: Optional, for dhcp_relay, unique loopback IPs are required for ERB or IPClos where we can set option-82 server_id-overrides
default: 172.16.192.0/24
auto_loopback_subnet6:
type: string
description: Optional, for dhcp_relay, unique loopback IPs are required for ERB or IPClos where we can set option-82 server_id-overrides
default: fd33:ab00:2::/64
auto_router_id_subnet:
type: string
description: Optional, this generates router_id automatically, if specified, `router_id_prefix` is ignored
default: 172.16.254.0/23
auto_router_id_subnet6:
type: string
description: Optional, this generates router_id automatically, if specified, `router_id_prefix` is ignored
examples:
- fd31:5700:1::/64
core_as_border:
type: boolean
description: Optional, for ERB or CLOS, you can either use esilag to upstream routers or to also be the virtual-gateway. When `routed_at` != `core`, whether to do virtual-gateway at core as well
default: false
enable_inband_mgmt:
type: boolean
description: Whether to route management traffic inband; routes will be propagated to downstream switches
default: false
enable_inband_ztp:
type: boolean
description: if the mangement traffic goes inbnd, during installation, only the border/core switches are connected to the Internet to allow initial configuration to be pushed down and leave the downstream access switches stay in the Factory Default state enabling inband-ztp allows upstream switches to use LLDP to assign IP and gives Internet to downstream switches in that state
default: false
overlay:
allOf:
- $ref: '#/components/schemas/evpn_options_overlay2'
- description: EVPN overlay BGP settings for the topology
per_vlan_vga_v4_mac:
type: boolean
description: Only for by Core-Distribution architecture when `evpn_options.routed_at`==`core`. By default, JUNOS uses 00-00-5e-00-01-01 as the virtual-gateway-address's v4_mac. If enabled, 00-00-5e-00-0X-YY will be used (where XX=vlan_id/256, YY=vlan_id%256)
default: false
per_vlan_vga_v6_mac:
type: boolean
description: Only for by Core-Distribution architecture when `evpn_options.routed_at`==`core`. By default, JUNOS uses 00-00-5e-00-02-01 as the virtual-gateway-address's v6_mac. If enabled, 00-00-5e-00-1X-YY will be used (where XX=vlan_id/256, YY=vlan_id%256)
default: false
routed_at:
allOf:
- $ref: '#/components/schemas/evpn_options_routed_at2'
- description: 'Topology tier where EVPN virtual gateway routing is placed. enum: `core`, `distribution`, `edge`.'
underlay:
allOf:
- $ref: '#/components/schemas/evpn_options_underlay2'
- description: EVPN underlay BGP and subnet settings for the topology
vs_instances:
type: object
additionalProperties:
$ref: '#/components/schemas/evpn_options_vs_instance'
description: Virtual-switch instance mappings used to segregate EVPN networks
examples:
- guest:
networks:
- guest
iot:
networks:
- iot-wifi
- iot-lan
description: EVPN topology generation options for campus fabric configuration
evpn_options_overlay:
title: evpn_options_overlay
type: object
properties:
as:
maximum: 65535
minimum: 1
type: integer
description: Overlay BGP Local AS Number
contentEncoding: int32
default: 65000
examples:
- 65000
description: EVPN overlay BGP settings
evpn_options_routed_at:
title: evpn_options_routed_at
enum:
- core
- distribution
- edge
type: string
description: 'optional, where virtual-gateway should reside. enum: `core`, `distribution`, `edge`'
evpn_options_underlay:
title: evpn_options_underlay
type: object
properties:
as_base:
maximum: 65535
minimum: 1
type: integer
description: Underlay BGP Base AS Number
contentEncoding: int32
default: 65001
examples:
- 65001
routed_id_prefix:
type: string
description: Prefix length used for automatically derived underlay router identifiers
examples:
- /24
subnet:
type: string
description: Underlay subnet, by default, `10.255.240.0/20`, or `fd31:5700::/64` for ipv6
examples:
- 10.255.240.0/20
use_ipv6:
type: boolean
description: If v6 is desired for underlay
default: false
description: EVPN underlay BGP and subnet settings
evpn_options_vs_instance:
title: evpn_options_vs_instance
type: object
properties:
networks:
uniqueItems: true
type: array
items:
type: string
description: List of network names included in this virtual-switch instance
description: EVPN virtual-switch instance network mapping
evpn_topology_response:
title: evpn_topology_response
type: object
properties:
created_time:
type: number
description: Timestamp when the EVPN topology was created
readOnly: true
evpn_options:
allOf:
- $ref: '#/components/schemas/evpn_options1'
- description: Generation options applied to the EVPN topology
for_site:
type: boolean
description: Whether the EVPN topology is scoped to a site rather than the organization
id:
type: string
description: Unique identifier of the EVPN topology
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
modified_time:
type: number
description: Timestamp when the EVPN topology was last modified
readOnly: true
name:
type: string
description: Display name for the EVPN topology
examples:
- CC
org_id:
type: string
description: Organization that owns the EVPN topology
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
overwrite:
type: boolean
description: Whether generated EVPN configuration changes are applied automatically
pod_names:
type: object
additionalProperties:
type: string
description: Property key is the pod number
site_id:
type: string
description: Site associated with the EVPN topology
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
description: EVPN topology metadata returned by EVPN topology APIs
evpn_topology:
title: evpn_topology
required:
- switches
type: object
properties:
created_time:
type: number
description: Timestamp when the EVPN topology was created
readOnly: true
evpn_options:
allOf:
- $ref: '#/components/schemas/evpn_options1'
- description: Generation options applied to the EVPN topology
id:
type: string
description: Unique identifier of the EVPN topology
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
modified_time:
type: number
description: Timestamp when the EVPN topology was last modified
readOnly: true
name:
type: string
description: Display name for the EVPN topology
examples:
- CC
org_id:
type: string
description: Organization that owns the EVPN topology
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
overwrite:
type: boolean
description: Whether to apply generated EVPN configuration changes automatically
pod_names:
type: object
additionalProperties:
type: string
description: Property key is the pod number
site_id:
type: string
description: Site associated with the EVPN topology
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
switch_configs:
type: object
additionalProperties:
$ref: '#/components/schemas/evpn_topology_switch_config'
description: Per-switch configuration overrides included in the EVPN topology
switches:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/evpn_topology_switch'
description: Topology member switches, roles, and links
description: EVPN topology create or update payload
evpn_topology_switch:
title: evpn_topology_switch
required:
- mac
- role
type: object
properties:
config:
allOf:
- $ref: '#/components/schemas/evpn_topology_switch_config1'
- description: Per-switch configuration supplied for this topology member. Use the [Update Site Device]($e/Sites%20Devices/updateSiteDevice) endpoint to update the switch configuration.
deviceprofile_id:
type: string
description: Associated device profile identifier for the switch. Use the [Assign Org Device Profile]($e/Orgs%20Device%20Profiles/assignOrgDeviceProfile) endpoint to assign a Device Profile to the switch.
contentEncoding: uuid
readOnly: true
examples:
- 6a1deab1-96df-4fa2-8455-d5253f943d06
downlink_ips:
type: array
items:
type: string
description: IP addresses used by this switch for EVPN downlinks
readOnly: true
downlinks:
type: array
items:
type: string
description: Switch MAC addresses connected as downlinks from this topology member
examples:
- - 5c5b35000005
- 5c5b35000006
esilaglinks:
type: array
items:
type: string
description: Switch MAC addresses connected through ESI-LAG from this topology member
examples:
- - 5c5b35000005
- 5c5b35000006
evpn_id:
minimum: 1
type: integer
description: Topology identifier number for this EVPN switch member
contentEncoding: int32
readOnly: true
mac:
minLength: 1
type: string
description: Switch MAC address used to identify the topology member
examples:
- 5c5b35000003
model:
type: string
description: Switch model for this topology member
readOnly: true
examples:
- QFX10002-36Q
pod:
maximum: 255
minimum: 1
type: integer
description: "Optionally, for distribution / access / esilag-access, they can be placed into different pods. e.g. \n * for CLOS, to group dist / access switches into pods\n * for ERB/CRB, to group dist / esilag-access into pods"
contentEncoding: int32
default: 1
pods:
type: array
items:
type: integer
contentEncoding: int32
description: List of pod numbers this switch participates in
role:
allOf:
- $ref: '#/components/schemas/evpn_topology_switch_role2'
- minLength: 1
description: 'EVPN topology role for this switch. enum: `access`, `border`, `collapsed-core`, `core`, `distribution`, `esilag-access`, `none`.'
router_id:
type: string
description: Routing identifier used by this switch for EVPN routing
readOnly: true
examples:
- 172.16.254.4
site_id:
type: string
description: Associated site for this EVPN topology switch
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
suggested_downlinks:
type: array
items:
type: string
description: Builder-suggested downlink switch MAC addresses
readOnly: true
examples:
- - 5c5b35000005
- 5c5b35000006
suggested_esilaglinks:
type: array
items:
type: string
description: Builder-suggested ESI-LAG switch MAC addresses
readOnly: true
examples:
- - 5c5b35000005
- 5c5b35000006
suggested_uplinks:
type: array
items:
type: string
description: Builder-suggested uplink switch MAC addresses
readOnly: true
examples:
- - 5c5b35000005
- 5c5b35000006
uplinks:
type: array
items:
type: string
description: Switch MAC addresses connected as uplinks from this topology member
examples:
- - 5c5b35000005
- 5c5b35000006
description: Switch member of an EVPN topology, including role and link relationships
evpn_topology_switch_config:
title: evpn_topology_switch_config
type: object
properties:
dhcpd_config:
allOf:
- $ref: '#/components/schemas/evpn_topology_switch_config_dhcpd_config2'
- description: Switch DHCP server configuration for the topology member
networks:
type: object
additionalProperties:
$ref: '#/components/schemas/switch_network'
description: EVPN network definitions for the topology member
other_ip_configs:
type: object
additionalProperties:
$ref: '#/components/schemas/junos_other_ip_config'
description: Additional interface IP configurations for the topology member
port_config:
type: object
additionalProperties:
$ref: '#/components/schemas/junos_port_config'
description: Switch port configuration for the topology member
port_usages:
type: object
additionalProperties:
$ref: '#/components/schemas/switch_port_usage'
description: Switch port usage definitions for the topology member
router_id:
type: string
description: Used for OSPF / BGP / EVPN
examples:
- 10.2.1.10
vrf_config:
allOf:
- $ref: '#/components/schemas/evpn_topology_switch_config_vrf_config2'
- description: Routing instance and VRF settings for the topology member
description: Per-switch configuration used by an EVPN topology member
evpn_topology_switch_config_dhcpd_config:
title: evpn_topology_switch_config_dhcpd_config
type: object
properties:
enabled:
type: boolean
description: If DHCPD is enabled on the switch
description: DHCP server enablement for an EVPN topology switch override
junos_other_ip_config:
title: junos_other_ip_config
type: object
properties:
evpn_anycast:
type: boolean
description: For EVPN, whether anycast is desired
default: false
ip:
type: string
description: Required if `type`==`static`; IPv4 address for the additional Junos L3 presence
examples:
- 10.3.3.1
ip6:
type: string
description: Required if `type6`==`static`; IPv6 address for the additional Junos L3 presence
examples:
- fdad:b0bc:f29e::3d16
netmask:
type: string
description: Optional IPv4 netmask; `subnet` from `network` definition will be used if defined
examples:
- 255.255.255.0
netmask6:
type: string
description: Optional IPv6 prefix length; `subnet` from `network` definition will be used if defined
examples:
- /64
type:
allOf:
- $ref: '#/components/schemas/ip_type3'
- description: 'IPv4 assignment mode for the additional Junos L3 presence. enum: `dhcp`, `static`.'
examples:
- static
type6:
allOf:
- $ref: '#/components/schemas/ip_type61'
- description: 'IPv6 assignment mode for the additional Junos L3 presence. enum: `autoconf`, `dhcp`, `disabled`, `static`.'
examples:
- static
description: Optional switch L3 presence on an additional network or VLAN
evpn_topology_switch_config_vrf_config:
title: evpn_topology_switch_config_vrf_config
type: object
properties:
enabled:
type: boolean
description: Whether to enable VRF (when supported on the device)
description: VRF enablement for an EVPN topology switch override
evpn_topology_switch_role:
title: evpn_topology_switch_role
enum:
- access
- border
- collapsed-core
- core
- distribution
- esilag-access
- none
type: string
description: 'use `role`==`none` to remove a switch from the topology. enum: `access`, `border`, `collapsed-core`, `core`, `distribution`, `esilag-access`, `none`'
extra_route:
title: extra_route
type: object
properties:
discard:
type: boolean
description: Whether to install a discard route; this takes precedence over next-hop settings
default: false
metric:
maximum: 2147483647
minimum: 0
type:
- integer
- 'null'
description: Route metric for the IPv4 static route
contentEncoding: int32
next_qualified:
type: object
additionalProperties:
$ref: '#/components/schemas/extra_route_next_qualified_properties'
description: Qualified next-hop settings keyed by IPv4 next-hop address
examples:
- 10.3.1.1:
metric: null
preference: 40
no_resolve:
type: boolean
description: Whether to prevent recursive next-hop resolution for the IPv4 static route
default: false
preference:
maximum: 2147483647
minimum: 0
type:
- integer
- 'null'
description: Route preference for the IPv4 static route
contentEncoding: int32
examples:
- 30
via:
oneOf:
- type: string
- type: array
items:
type: string
description: Next-hop IPv4 address or ECMP next-hop IPv4 addresses for the route
examples:
- 10.2.1.1
- >-
[
"10.2.1.1",
"10.2.1.2"
]
description: IPv4 static route settings for a destination prefix
extra_route6:
title: extra_route6
type: object
properties:
discard:
type: boolean
description: Whether to install a discard route; this takes precedence over next-hop settings
default: false
metric:
maximum: 2147483647
minimum: 0
type:
- integer
- 'null'
description: Route metric for the IPv6 static route
contentEncoding: int32
next_qualified:
type: object
additionalProperties:
$ref: '#/components/schemas/extra_route6_next_qualified_properties'
description: Qualified next-hop settings keyed by IPv6 next-hop address
examples:
- 2a02:1234:200a::100:
metric: null
preference: 40
no_resolve:
type: boolean
description: Whether to prevent recursive next-hop resolution for the IPv6 static route
default: false
preference:
maximum: 2147483647
minimum: 0
type:
- integer
- 'null'
description: Route preference for the IPv6 static route
contentEncoding: int32
examples:
- 30
via:
oneOf:
- type: string
- type: array
items:
type: string
description: Next-hop IPv6 address or ECMP next-hop IPv6 addresses for the route
examples:
- 10.2.1.1
- >-
[
"10.2.1.1",
"10.2.1.2"
]
description: IPv6 static route settings for a destination prefix
extra_route6_next_qualified_properties:
title: extra_route6_next_qualified_properties
type: object
properties:
metric:
type:
- integer
- 'null'
description: Route metric for this qualified IPv6 next hop
contentEncoding: int32
preference:
type:
- integer
- 'null'
description: Route preference for this qualified IPv6 next hop
contentEncoding: int32
description: Qualified next-hop attributes for an IPv6 static route
extra_route_next_qualified_properties:
title: extra_route_next_qualified_properties
type: object
properties:
metric:
type:
- integer
- 'null'
description: Route metric for this qualified IPv4 next hop
contentEncoding: int32
preference:
type:
- integer
- 'null'
description: Route preference for this qualified IPv4 next hop
contentEncoding: int32
description: Qualified next-hop attributes for an IPv4 static route
fast_roam_result:
title: fast_roam_result
enum:
- fail
- none
- success
type: string
description: 'enum: `fail`, `none`, `success`'
fingerprint:
title: fingerprint
type: object
properties:
family:
type: string
description: Device family or category inferred from client fingerprinting
readOnly: true
mac:
type: string
description: Client device MAC address for the fingerprint record
readOnly: true
mfg:
type: string
description: Manufacturer name inferred from client fingerprinting
readOnly: true
model:
type: string
description: Device model inferred from client fingerprinting
readOnly: true
org_id:
type: string
description: Organization that contains the fingerprint record
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
os:
type: string
description: Operating system name and version inferred from client fingerprinting
readOnly: true
os_type:
type: string
description: Operating system family inferred from client fingerprinting
readOnly: true
random_mac:
type: boolean
description: Whether the client device uses a randomized MAC address
readOnly: true
site_id:
type: string
description: Site associated with the fingerprint record
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
timestamp:
type: number
description: Time when the fingerprint record was observed
readOnly: true
description: Client device fingerprint record returned by NAC fingerprint insights
fingerprint_search_result:
title: fingerprint_search_result
required:
- end
- limit
- results
- start
- total
type: object
properties:
end:
type: integer
description: Upper bound of the time range for the fingerprint search
contentEncoding: int32
examples:
- 1711035686
limit:
type: integer
description: Maximum number of fingerprint records returned in the response
contentEncoding: int32
examples:
- 10
next:
type: string
description: Pagination URL for the next page of fingerprint search results
results:
type: array
items:
$ref: '#/components/schemas/fingerprint'
description: Fingerprint records returned for the search
start:
type: integer
description: Lower bound of the time range for the fingerprint search
contentEncoding: int32
examples:
- 1710949286
total:
type: integer
description: Number of fingerprint records matching the search
contentEncoding: int32
examples:
- 232
description: Search response for client device fingerprint records
fingerprints_count_distinct:
title: fingerprints_count_distinct
enum:
- family
- model
- os
- os_type
type: string
description: 'enum: `family`, `model`, `os`, `os_type`'
flow_record:
title: flow_record
type: object
properties:
device_mac:
type: string
description: MAC address of the device
direction:
allOf:
- $ref: '#/components/schemas/flow_record_direction'
- description: 'Flow direction. enum: `egress`, `ingress`'
dst_ip:
type: string
description: Destination IP address
dst_port:
type: integer
description: Destination port number
contentEncoding: int32
duration:
type: integer
description: Flow duration in seconds
contentEncoding: int64
end_time:
type: integer
description: Flow end time in epoch seconds
contentEncoding: int64
flow_id:
type: integer
description: Unique flow identifier
contentEncoding: int64
org_id:
type: string
description: UUID of the org
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
protocol:
type: string
description: Protocol (e.g. `tcp`, `udp`, `icmp`)
sampling_percentage:
type: number
description: Percentage of packets sampled (e.g. `0.1` means 0.1% of packets are captured via sFlow; `100.0` means all packets are captured via FBT)
site_id:
type: string
description: UUID of the site
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
src_ip:
type: string
description: Source IP address
src_port:
type: integer
description: Source port number
contentEncoding: int32
start_time:
type: integer
description: Flow start time in epoch seconds
contentEncoding: int64
state:
allOf:
- $ref: '#/components/schemas/flow_record_state'
- description: 'Flow state. enum: `active`, `aged-out`'
timestamp:
type: integer
description: Epoch time (in seconds) when the flow record was last updated or completed
contentEncoding: int64
total_bytes:
type: integer
description: Total number of bytes in the flow
contentEncoding: int64
total_pkts:
type: integer
description: Total number of packets in the flow
contentEncoding: int64
description: Network flow record reported by a switch device
flow_record_direction:
title: flow_record_direction
enum:
- egress
- ingress
type: string
description: 'Flow direction. enum: `egress`, `ingress`'
flow_record_state:
title: flow_record_state
enum:
- active
- aged-out
type: string
description: 'Flow state. enum: `active`, `aged-out`'
for_site:
title: for_site
enum:
- any
- 'true'
- 'false'
type: string
description: 'enum: `any`, `true`, `false`'
fwupdate_stat:
title: fwupdate_stat
type: object
properties:
progress:
maximum: 100
minimum: 0
type:
- integer
- 'null'
description: Firmware update progress percentage, or null when unavailable
contentEncoding: int32
readOnly: true
examples:
- 10
status:
allOf:
- oneOf:
- {}
- $ref: '#/components/schemas/fwupdate_stat_status2'
- description: 'Current firmware update status. enum: `inprogress`, `failed`, `upgraded`, `success`, `scheduled`, `error`.'
readOnly: true
status_id:
type:
- integer
- 'null'
description: Numeric firmware update status identifier
contentEncoding: int32
readOnly: true
examples:
- 5
timestamp:
type: number
description: Time when the firmware update status was last updated
readOnly: true
will_retry:
type:
- boolean
- 'null'
description: Whether the firmware update process will retry after the current status
readOnly: true
examples:
- false
description: Firmware update status for a device
fwupdate_stat_status:
title: fwupdate_stat_status
enum:
- inprogress
- failed
- upgraded
- success
- scheduled
- error
type: string
description: 'enum: `inprogress`, `failed`, `upgraded`, `success`, `scheduled`, `error`'
gateway_cluster:
title: gateway_cluster
required:
- nodes
type: object
properties:
nodes:
maxItems: 2
minItems: 1
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/gateway_cluster_node'
description: Gateway nodes that form the HA cluster
description: Gateway HA cluster request or response body
gateway_cluster_node:
title: gateway_cluster_node
required:
- mac
type: object
properties:
mac:
type: string
description: Gateway device MAC address. Format is `[0-9a-f]{12}` (e.g. "5684dae9ac8b")
description: Gateway cluster node identified by MAC address
gateway_compliance_major_version_properties:
title: gateway_compliance_major_version_properties
type: object
properties:
major_count:
type: integer
description: Number of gateways counted in this major-version compliance entry
contentEncoding: int32
major_version:
type: string
description: Gateway software major version represented by this compliance entry
examples:
- 19.4R2-S1.2
description: Version-compliance details for one gateway model
gateway_compliance_version:
title: gateway_compliance_version
type: object
properties:
major_version:
type: object
additionalProperties:
$ref: '#/components/schemas/gateway_compliance_major_version_properties'
description: Per-model gateway major-version compliance details
score:
type: number
description: Gateway software version compliance score
examples:
- 99.9
type:
type: string
description: Device type represented by the gateway compliance metric
examples:
- gateway
description: Version compliance metric for gateway devices
gateway_extra_route:
title: gateway_extra_route
type: object
properties:
via:
type: string
description: Next-hop IPv4 address for the gateway extra route
contentEncoding: ipv4
description: Gateway IPv4 extra route next-hop settings
gateway_extra_route6:
title: gateway_extra_route6
type: object
properties:
via:
type: string
description: Next-hop IPv6 address for the gateway extra route
contentEncoding: ipv6
description: Gateway IPv6 extra route next-hop settings
idp_profile:
title: idp_profile
type: object
properties:
base_profile:
allOf:
- $ref: '#/components/schemas/idp_profile_base_profile2'
- description: 'Built-in IDP baseline profile inherited before applying overwrites. enum: `critical`, `standard`, `strict`.'
examples:
- strict
created_time:
type: number
description: Timestamp when the IDP profile was created
readOnly: true
id:
type: string
description: Unique identifier of the IDP profile
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
modified_time:
type: number
description: Timestamp when the IDP profile was last modified
readOnly: true
name:
type: string
description: Display name of the IDP profile
examples:
- relaxed
org_id:
type: string
description: Owning organization for the IDP profile
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
overwrites:
type: array
items:
$ref: '#/components/schemas/idp_profile_overwrite'
description: IDP signature override rules applied on top of the base profile
description: Organization IDP profile with a base profile and targeted overwrite rules
gateway_ip_config_property:
title: gateway_ip_config_property
type: object
properties:
ip:
type: string
description: Static IPv4 address for the gateway network interface when `type`==`static`
contentEncoding: ipv4
ip6:
type: string
description: Static IPv6 address for the gateway network interface when `type6`==`static`
contentEncoding: ipv6
netmask:
type: string
description: IPv4 netmask or prefix length for the gateway network interface when `type`==`static`
examples:
- /24
netmask6:
type: string
description: IPv6 netmask or prefix length for the gateway network interface when `type6`==`static`
examples:
- 2001:db8:abcd:12::1
secondary_ips:
type: array
items:
type: string
description: Additional IPv4 addresses in CIDR notation for this gateway network interface
examples:
- - 192.168.50.1/24
- 192.168.60.1/26
type:
allOf:
- $ref: '#/components/schemas/ip_type4'
- description: 'IPv4 address assignment mode for this gateway network interface. enum: `dhcp`, `static`.'
examples:
- static
type6:
allOf:
- $ref: '#/components/schemas/ip_type62'
- description: 'IPv6 address assignment mode for this gateway network interface. enum: `autoconf`, `dhcp`, `disabled`, `static`.'
examples:
- static
description: Gateway network interface IP configuration
gateway_matching:
title: gateway_matching
type: object
properties:
enable:
type: boolean
description: Whether gateway matching is enabled
rules:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/gateway_matching_rule'
description: Gateway matching rules evaluated for this configuration
description: Gateway matching configuration used to apply gateway-specific settings
gateway_matching_rule:
title: gateway_matching_rule
type: object
properties:
additional_config_cmds:
type: array
items:
type: string
description: For SRX only, additional Junos CLI commands appended when this gateway matching rule applies
name:
type: string
description: Display name for the gateway matching rule
port_config:
type: object
additionalProperties:
$ref: '#/components/schemas/gateway_port_config'
description: Property key is the port(s) name or range (e.g. "ge-0/0/0-10").
additionalProperties:
type: string
description: 'Property key defines the type of matching. e.g: `match_name[0:3]`, `match_model[0-6]` or `match_role`'
description: Gateway matching rule that applies settings when its match keys select a gateway
gateway_metrics:
title: gateway_metrics
type: object
properties:
config_success:
type: number
description: Gateway configuration success score
examples:
- 99.9
version_compliance:
allOf:
- $ref: '#/components/schemas/gateway_compliance_version1'
- description: Gateway software version compliance metric
description: Gateway metric scores returned by the site gateway metrics API
gateway_mgmt:
title: gateway_mgmt
type: object
properties:
admin_sshkeys:
type: array
items:
type: string
description: SSR-only SSH public keys for administrative access
examples:
- - ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAA...Wxa6p6UW0ZbcP john@host
app_probing:
allOf:
- $ref: '#/components/schemas/app_probing1'
- description: Application probing configuration for gateway monitoring
app_usage:
type: boolean
description: Consumes uplink bandwidth, requires WA license
auto_signature_update:
allOf:
- $ref: '#/components/schemas/gateway_mgmt_auto_signature_update2'
- description: Schedule for automatic security signature updates
config_revert_timer:
maximum: 30
minimum: 1
type: integer
description: Rollback timer for commit confirmed
contentEncoding: int32
default: 10
disable_console:
type: boolean
description: For SSR and SRX, disable console port
default: false
disable_idp_pcap:
type: boolean
description: For SRX only, disable IDP packet capture
default: false
disable_oob:
type: boolean
description: For SSR and SRX, disable management interface
default: false
disable_usb:
type: boolean
description: For SSR and SRX, disable usb interface
default: false
fips_enabled:
type: boolean
description: Whether FIPS mode is enabled on the gateway
default: false
probe_hosts:
type: array
items:
type: string
description: IPv4 probe targets used for gateway connectivity checks
examples:
- - 8.8.8.8
probe_hostsv6:
type: array
items:
type: string
description: IPv6 probe targets used for gateway connectivity checks
examples:
- - 2001:4860:4860::8888
protect_re:
allOf:
- $ref: '#/components/schemas/protect_re1'
- description: Control-plane protection settings for the gateway
root_password:
type: string
description: SRX only. Root password for local gateway access
contentEncoding: password
security_log_source_address:
type: string
description: IPv4 source address used for gateway security log traffic
contentEncoding: ipv4
examples:
- 192.168.1.1
security_log_source_interface:
type: string
description: Source interface used for gateway security log traffic
examples:
- ge-0/0/1.0
description: Gateway management-plane and access settings
gateway_mgmt_auto_signature_update:
title: gateway_mgmt_auto_signature_update
type: object
properties:
day_of_week:
allOf:
- $ref: '#/components/schemas/day_of_week1'
- description: 'Scheduled weekday for automatic signature updates. enum: `any`, `fri`, `mon`, `sat`, `sun`, `thu`, `tue`, `wed`.'
enable:
type: boolean
description: Whether automatic security signature updates are enabled
default: true
time_of_day:
type: string
description: Optional, Mist will decide the timing
description: Automatic security signature update schedule
gateway_mgmt_host_out_policy:
title: gateway_mgmt_host_out_policy
type: object
properties:
path_preference:
type: string
description: Preferred path name for this gateway-originated service traffic
description: Host-out path policy for gateway-originated management traffic
gateway_mgmt_host_out_policy_syslog:
title: gateway_mgmt_host_out_policy_syslog
type: object
properties:
path_preference:
type: string
description: Preferred path name used by default for gateway syslog traffic
examples:
- broadband_wans
servers:
type: array
items:
$ref: '#/components/schemas/gateway_mgmt_host_out_policy_syslog_server'
description: Per-server host-out path policies for gateway syslog traffic
description: Host-out path policy for gateway syslog traffic
gateway_mgmt_host_out_policy_syslog_server:
title: gateway_mgmt_host_out_policy_syslog_server
type: object
properties:
host:
type: string
description: Syslog server hostname or IP address
examples:
- 103.35.3.5
path_preference:
type: string
description: Preferred path name used for this syslog server
examples:
- dc_only
server_name:
type: string
description: Remote syslog server name referenced by the policy
examples:
- dc_syslog_server
description: Per-syslog-server host-out path policy override
gateway_oob_ip_config:
title: gateway_oob_ip_config
type: object
properties:
gateway:
type: string
description: Default gateway for the out-of-band management interface when `type`==`static`
ip:
type: string
description: Static IPv4 address for the out-of-band management interface when `type`==`static`
netmask:
type: string
description: IPv4 netmask or prefix length for the out-of-band management interface when `type`==`static`
node1:
allOf:
- $ref: '#/components/schemas/gateway_oob_ip_config_node12'
- description: Out-of-band management IP configuration override for node1 in an HA cluster
type:
allOf:
- $ref: '#/components/schemas/ip_type2'
- description: 'IP assignment mode for the out-of-band management interface. enum: `dhcp`, `static`.'
examples:
- static
use_mgmt_vrf:
type: boolean
description: If supported on the platform. If enabled, DNS will be using this routing-instance, too
default: false
use_mgmt_vrf_for_host_out:
type: boolean
description: For host-out traffic (NTP/TACPLUS/RADIUS/SYSLOG/SNMP), if alternative source network/ip is desired
default: false
vlan_id:
oneOf:
- type: string
- maximum: 4094
minimum: 1
type: integer
contentEncoding: int32
description: VLAN ID used for out-of-band management traffic
description: Out-of-band management IP configuration for gateway interfaces such as vme, em0, or fxp0
gateway_oob_ip_config_node1:
title: gateway_oob_ip_config_node1
type: object
properties:
gateway:
type: string
description: Default gateway for the node1 out-of-band management interface when `type`==`static`
ip:
type: string
description: Static IPv4 address for the node1 out-of-band management interface when `type`==`static`
netmask:
type: string
description: IPv4 netmask or prefix length for the node1 out-of-band management interface when `type`==`static`; used only if `subnet` is not specified in `networks`
type:
allOf:
- $ref: '#/components/schemas/ip_type5'
- description: 'IP assignment mode for the node1 out-of-band management interface. enum: `dhcp`, `static`.'
examples:
- static
use_mgmt_vrf:
type: boolean
description: If supported on the platform. If enabled, DNS will be using this routing-instance, too
default: false
use_mgmt_vrf_for_host_out:
type: boolean
description: Whether to use `mgmt_junos` for host-out traffic (NTP/TACPLUS/RADIUS/SYSLOG/SNMP), if alternative source network/ip is desired
default: false
vlan_id:
oneOf:
- type: string
- maximum: 4094
minimum: 1
type: integer
contentEncoding: int32
description: VLAN ID used for node1 out-of-band management traffic
description: Node1-specific out-of-band management IP configuration for HA clusters
gateway_path_preferences:
title: gateway_path_preferences
type: object
properties:
paths:
type: array
items:
$ref: '#/components/schemas/gateway_path_preferences_path'
description: Candidate paths evaluated for this gateway path preference
strategy:
allOf:
- $ref: '#/components/schemas/gateway_path_strategy2'
- description: 'Selection strategy used to evaluate the candidate paths. enum: `ecmp`, `ordered`, `weighted`.'
description: Gateway path preference that selects among one or more local, WAN, VPN, or tunnel paths
gateway_path_preferences_path:
title: gateway_path_preferences_path
required:
- type
type: object
properties:
cost:
type: integer
description: Relative cost assigned to this path for gateway path selection
contentEncoding: int32
disabled:
type: boolean
description: For SSR Only. `true`, if this specific path is undesired
gateway_ip:
type: string
description: Only if `type`==`local`, if a different gateway is desired
internet_access:
type: boolean
description: Only if `type`==`vpn`, if this vpn path can be used for internet
name:
type: string
description: "Required when \n * `type`==`vpn`: the name of the VPN Path to use \n * `type`==`wan`: the name of the WAN interface to use"
networks:
type: array
items:
type: string
description: List of network names used when `type`==`local`
target_ips:
type: array
items:
type: string
description: List of destination IP addresses to replace when `type`==`local`
type:
allOf:
- $ref: '#/components/schemas/gateway_path_type2'
- description: Gateway path source type, such as local network, WAN interface, VPN path, or tunnel
wan_name:
type: string
description: Optional if `type`==`vpn`; WAN interface name associated with the VPN path
examples:
- wan0
description: Candidate path within a gateway path preference
gateway_path_strategy:
title: gateway_path_strategy
enum:
- ecmp
- ordered
- weighted
type: string
description: 'enum: `ecmp`, `ordered`, `weighted`'
gateway_path_type:
title: gateway_path_type
enum:
- local
- tunnel
- vpn
- wan
type: string
description: 'enum: `local`, `tunnel`, `vpn`, `wan`'
gateway_port_config:
title: gateway_port_config
required:
- usage
type: object
properties:
ae_disable_lacp:
type: boolean
description: If `aggregated`==`true`. To disable LCP support for the AE interface
default: false
ae_idx:
type:
- string
- 'null'
description: If `aggregated`==`true`. Users could force to use the designated AE name (must be an integer between 0 and 127)
ae_lacp_force_up:
type: boolean
description: 'For SRX only, if `aggregated`==`true`.Sets the state of the interface as UP when the peer has limited LACP capability. Use case: When a device connected to this AE port is ZTPing for the first time, it will not have LACP configured on the other end. **Note:** Turning this on will enable force-up on one of the interfaces in the bundle only'
default: false
aggregated:
type: boolean
description: Whether the port participates in an aggregated Ethernet interface
default: false
critical:
type: boolean
description: To generate port up/down alarm, set it to true
default: false
description:
type: string
description: Interface Description. Can be a variable (i.e. "{{myvar}}")
disable_autoneg:
type: boolean
description: Whether Ethernet autonegotiation is disabled on the port
default: false
disabled:
type: boolean
description: Port admin up (true) / down (false)
default: false
dsl_type:
allOf:
- $ref: '#/components/schemas/gateway_port_dsl_type2'
- description: 'If `wan_type`==`dsl`. DSL technology used by the WAN port. enum: `adsl`, `vdsl`.'
dsl_vci:
type: integer
description: If `wan_type`==`dsl`, 16 bit int
contentEncoding: int32
default: 35
dsl_vpi:
type: integer
description: If `wan_type`==`dsl`, 8 bit int
contentEncoding: int32
default: 0
duplex:
allOf:
- $ref: '#/components/schemas/gateway_port_duplex2'
- description: 'Ethernet duplex mode configured on the port. enum: `auto`, `full`, `half`.'
examples:
- full
ip_config:
allOf:
- $ref: '#/components/schemas/gateway_port_config_ip_config2'
- description: Layer 3 IP configuration for the port
lte_apn:
type: string
description: If `wan_type`==`lte`. APN used by the LTE uplink
lte_auth:
allOf:
- $ref: '#/components/schemas/gateway_port_lte_auth2'
- description: 'If `wan_type`==`lte`. Authentication method used by the LTE uplink. enum: `chap`, `none`, `pap`.'
lte_backup:
type: boolean
description: Whether the LTE uplink is used as a backup WAN connection
lte_password:
type: string
description: If `wan_type`==`lte`. Password used for LTE uplink authentication
contentEncoding: password
lte_username:
type: string
description: If `wan_type`==`lte`. Username used for LTE uplink authentication
mtu:
type: integer
description: Layer 3 MTU configured on the port
contentEncoding: int32
name:
type: string
description: Interface name used to derive device configuration
networks:
type: array
items:
type: string
description: If `usage`==`lan`. Networks attached to the interface
outer_vlan_id:
type: integer
description: For Q-in-Q. Outer VLAN ID used for QinQ encapsulation
contentEncoding: int32
poe_disabled:
type: boolean
description: Whether PoE output is disabled on the port
default: false
poe_keep_state_when_reboot:
type: boolean
description: Whether Perpetual PoE capabilities are enabled for a port
default: false
port_network:
type: string
description: Only for SRX and if `usage`==`lan`, the name of the Network to be used as the Untagged VLAN
preserve_dscp:
type: boolean
description: Whether to preserve dscp when sending traffic over VPN (SSR-only)
default: true
redundant:
type: boolean
description: If HA mode. Whether the port participates in the redundant Ethernet configuration
redundant_group:
maximum: 128
minimum: 1
type: integer
description: If HA mode, SRX Only - support redundancy-group. 1-128 for physical SRX, 1-64 for virtual SRX
contentEncoding: int32
reth_idx:
anyOf:
- type: integer
contentEncoding: int32
- type: string
description: If HA mode and for SRX only. Redundant Ethernet interface index assigned to the port
reth_node:
type: string
description: If HA mode. Node associated with the redundant Ethernet interface
reth_nodes:
type: array
items:
type: string
description: If HA mode and for SSR only. Per-network node assignment used for VLAN-based redundancy
examples:
- - node0
- node1
speed:
type: string
description: Link speed configured on the port
default: auto
examples:
- 1g
ssr_no_virtual_mac:
type: boolean
description: When SSR is running as VM, this is required on certain hosting platforms
default: false
svr_port_range:
type: string
description: For SSR only. Port range configured on the interface
default: none
examples:
- 60000-60005
traffic_shaping:
allOf:
- $ref: '#/components/schemas/gateway_traffic_shaping3'
- description: Traffic shaping settings applied to the port
usage:
allOf:
- $ref: '#/components/schemas/gateway_port_usage2'
- description: 'Logical usage assigned to the port. enum: `ha_control`, `ha_data`, `lan`, `wan`.'
vlan_id:
oneOf:
- type: string
- maximum: 4094
minimum: 1
type: integer
contentEncoding: int32
description: VLAN ID or variable used when the WAN interface is carried on a VLAN
vpn_paths:
type: object
additionalProperties:
$ref: '#/components/schemas/gateway_port_vpn_path'
description: Per-VPN path settings for traffic that uses this port
wan_arp_policer:
allOf:
- $ref: '#/components/schemas/gateway_port_wan_arp_policer2'
- description: 'Only when `wan_type`==`broadband`. ARP policer profile applied to the WAN port. enum: `default`, `max`, `recommended`.'
wan_ext_ip:
type: string
description: Only if `usage`==`wan`, optional. If spoke should reach this port by a different IP
examples:
- 64.2.4.3
wan_ext_ip6:
type: string
description: Only if `usage`==`wan`, optional. If spoke should reach this port by a different IPv6
examples:
- 2601:1700:43c0:dc0::10
wan_extra_routes:
type: object
additionalProperties:
$ref: '#/components/schemas/wan_extra_routes'
description: Only if `usage`==`wan`. Property Key is the destination CIDR (e.g. "100.100.100.0/24")
wan_extra_routes6:
type: object
additionalProperties:
$ref: '#/components/schemas/wan_extra_routes6'
description: Only if `usage`==`wan`. Property Key is the destination CIDR (e.g. "2a02:1234:420a:10c9::/64")
wan_networks:
type: array
items:
type: string
description: Only if `usage`==`wan`. Networks reachable through this WAN port for policy definition
wan_probe_override:
allOf:
- $ref: '#/components/schemas/gateway_wan_probe_override2'
- description: Optional WAN health probe override settings for this port
wan_source_nat:
allOf:
- $ref: '#/components/schemas/gateway_port_wan_source_nat2'
- description: Source NAT settings applied to traffic leaving this WAN port
wan_speedtest_mode:
allOf:
- $ref: '#/components/schemas/gateway_port_config_wan_speedtest_mode2'
- description: 'Controls whether Marvis or the scheduler can run speed tests on this WAN port. enum: `auto`, `enabled`, `disabled`.'
examples:
- auto
wan_type:
allOf:
- $ref: '#/components/schemas/gateway_port_wan_type2'
- description: 'Only if `usage`==`wan`. WAN uplink type configured on the port. enum: `broadband`, `dsl`, `lte`.'
description: Gateway port configuration for LAN, WAN, tunnel, and HA interfaces
gateway_port_config_ip_config:
title: gateway_port_config_ip_config
type: object
properties:
dns:
type: array
items:
type: string
description: Resolver server IP addresses used by this interface, except on out-of-band interfaces such as vme, em0, or fxp0
dns_suffix:
type: array
items:
type: string
description: DNS search suffixes used by this interface, except on out-of-band interfaces such as vme, em0, or fxp0
gateway:
type: string
description: Except for out-of_band interface (vme/em0/fxp0). Interface Default Gateway IP address (i.e. "192.168.1.1") or a Variable (i.e. "{{myvar}}")
examples:
- 192.168.1.1
gateway6:
type: string
description: Except for out-of_band interface (vme/em0/fxp0). Interface Default Gateway IPv6 Address (i.e. "2001:db8::1") or a Variable (i.e. "{{myvar}}")
examples:
- 2001:db8::1
ip:
type: string
description: Interface IP address (i.e. "192.168.1.8") or a Variable (i.e. "{{myvar}}")
contentEncoding: ipv4
examples:
- 192.168.1.8
ip6:
type: string
description: Interface IPv6 Address (i.e. "2001:db8::123") or a Variable (i.e. "{{myvar}}")
contentEncoding: ipv6
examples:
- 2001:db8::123
netmask:
type: string
description: Used only if `subnet` is not specified in `networks`. Interface Netmask (i.e. "/24") or a Variable (i.e. "{{myvar}}")
examples:
- /24
netmask6:
type: string
description: Used only if `subnet` is not specified in `networks`. Interface IPv6 Netmask (i.e. "/64") or a Variable (i.e. "{{myvar}}")
examples:
- /64
network:
type: string
description: Optional, the network to be used for mgmt
poser_password:
type: string
description: Password used for PPPoE when `type`==`pppoe`
contentEncoding: password
pppoe_auth:
allOf:
- $ref: '#/components/schemas/gateway_wan_ppoe_auth2'
- description: 'Authentication protocol used for PPPoE when `type`==`pppoe`. enum: `chap`, `none`, `pap`.'
pppoe_username:
type: string
description: Username used for PPPoE when `type`==`pppoe`
type:
allOf:
- $ref: '#/components/schemas/gateway_wan_type2'
- description: 'IPv4 assignment mode for this gateway port interface. enum: `dhcp`, `pppoe`, `static`.'
type6:
allOf:
- $ref: '#/components/schemas/gateway_wan_type62'
- description: 'IPv6 assignment mode for this gateway port interface. enum: `autoconf`, `dhcp`, `static`.'
description: Junos IP configuration for a gateway port interface
gateway_port_config_wan_speedtest_mode:
title: gateway_port_config_wan_speedtest_mode
enum:
- auto
- enabled
- disabled
type: string
description: 'Controls whether Marvis/scheduler can run speedtest on this port. enum: `auto`, `enabled`, `disabled`'
examples:
- auto
gateway_port_dsl_type:
title: gateway_port_dsl_type
enum:
- adsl
- vdsl
type: string
description: 'if `wan_type`==`dsl`. enum: `adsl`, `vdsl`'
gateway_port_duplex:
title: gateway_port_duplex
enum:
- auto
- full
- half
type: string
description: 'enum: `auto`, `full`, `half`'
examples:
- full
gateway_port_lte_auth:
title: gateway_port_lte_auth
enum:
- chap
- none
- pap
type: string
description: 'if `wan_type`==`lte`. enum: `chap`, `none`, `pap`'
gateway_port_mirroring:
title: gateway_port_mirroring
type: object
properties:
port_mirror:
allOf:
- $ref: '#/components/schemas/gateway_port_mirroring_port_mirror2'
- description: Mirroring rule that copies ingress traffic from source ports to an output port
description: Port mirroring settings for a gateway interface
gateway_port_mirroring_port_mirror:
title: gateway_port_mirroring_port_mirror
type: object
properties:
family_type:
type: string
description: Packet family used for this port mirroring rule
ingress_port_ids:
type: array
items:
type: string
description: Source gateway port IDs whose ingress traffic is mirrored
output_port_id:
type: string
description: Destination gateway port ID that receives mirrored traffic
examples:
- ge-0/0/5
rate:
type: integer
description: Sampling rate applied to mirrored traffic
contentEncoding: int32
run_length:
minimum: 0
type: integer
description: Number of bytes copied from each mirrored packet
contentEncoding: int32
description: Gateway port mirroring rule
gateway_port_usage:
title: gateway_port_usage
enum:
- ha_control
- ha_data
- lan
- wan
type: string
description: 'port usage name. enum: `ha_control`, `ha_data`, `lan`, `wan`'
gateway_port_vpn_path:
title: gateway_port_vpn_path
type: object
properties:
bfd_profile:
allOf:
- $ref: '#/components/schemas/gateway_port_vpn_path_bfd_profile2'
- description: 'BFD profile used for this VPN path when the VPN `type`==`hub_spoke`. enum: `broadband`, `lte`.'
bfd_use_tunnel_mode:
type: boolean
description: Only if the VPN `type`==`hub_spoke`. Whether to use tunnel mode. SSR only
default: false
preference:
type: integer
description: Only if the VPN `type`==`hub_spoke`. For a given VPN, when `path_selection.strategy`==`simple`, the preference for a path (lower is preferred)
contentEncoding: int32
role:
allOf:
- $ref: '#/components/schemas/gateway_port_vpn_path_role2'
- description: 'Gateway role for this VPN path; valid values depend on the VPN `type`. enum: `hub`, `mesh`, `spoke`.'
traffic_shaping:
allOf:
- $ref: '#/components/schemas/gateway_traffic_shaping1'
- description: Traffic shaping settings applied to this VPN path
description: VPN path settings for traffic that uses a gateway port
gateway_port_vpn_path_bfd_profile:
title: gateway_port_vpn_path_bfd_profile
enum:
- broadband
- lte
type: string
description: 'Only if the VPN `type`==`hub_spoke`. enum: `broadband`, `lte`'
gateway_port_vpn_path_role:
title: gateway_port_vpn_path_role
enum:
- hub
- mesh
- spoke
type: string
description: 'If the VPN `type`==`hub_spoke`, enum: `hub`, `spoke`. If the VPN `type`==`mesh`, enum: `mesh`'
gateway_port_wan_arp_policer:
title: gateway_port_wan_arp_policer
enum:
- default
- max
- recommended
type: string
description: 'Only when `wan_type`==`broadband`. enum: `default`, `max`, `recommended`'
gateway_port_wan_source_nat:
title: gateway_port_wan_source_nat
type: object
properties:
disabled:
type: boolean
description: Or to disable the source-nat
default: false
nat6_pool:
type: string
description: If alternative nat_pool is desired
examples:
- 2601:1700:43c0:dc0:20c:29ff:fea7:93bc/126
nat_pool:
type: string
description: If alternative nat_pool is desired
examples:
- 64.2.4.0/30
description: Only if `usage`==`wan`, optional. By default, source-NAT is performed on all WAN Ports using the interface-ip
gateway_port_wan_type:
title: gateway_port_wan_type
enum:
- broadband
- dsl
- lte
type: string
description: 'Only if `usage`==`wan`. enum: `broadband`, `dsl`, `lte`'
gateway_search:
title: gateway_search
required:
- type
type: object
properties:
clustered:
type: boolean
description: Whether the gateway is part of a gateway cluster
evpn_missing_links:
type: boolean
description: Whether EVPN topology links are missing for this gateway
evpntopo_id:
type: string
description: EVPN topology ID associated with this gateway
ext_ip:
type: string
description: External IP address observed for gateway management traffic
hostname:
uniqueItems: true
type: array
items:
type: string
description: Observed hostnames detected for the gateway in search results
ip:
type: string
description: Management IP address currently reported for the gateway
last_config_status:
type: string
description: Most recent configuration status reported for the gateway
last_hostname:
type: string
description: Most recent hostname detected for the gateway
last_trouble_code:
type: string
description: Most recent trouble code reported for the gateway
last_trouble_timestamp:
type: integer
description: Timestamp when the most recent gateway trouble code was reported
contentEncoding: int32
mac:
type: string
description: Gateway MAC address reported in search results
managed:
type: boolean
description: Whether the gateway is managed by Mist. Deprecated in favor of `mist_configured`
deprecated: true
mist_configured:
type: boolean
description: Whether the gateway can be configured by Mist. Replaces `managed` for adopted devices and `disable_auto_config` for claimed devices
model:
type: string
description: Gateway model reported for this search result
node:
type: string
description: Gateway cluster node associated with this search result
node0_mac:
type: string
description: Cluster node0 MAC address reported for an HA gateway
node1_mac:
type: string
description: Cluster node1 MAC address reported for an HA gateway
num_members:
type: integer
description: Number of members in the gateway cluster
contentEncoding: int32
org_id:
type: string
description: Organization that owns this gateway search result
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
role:
type: string
description: Gateway cluster role reported for this search result
site_id:
type: string
description: Site that contains this gateway search result
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
t128agent_version:
type: string
description: Session Smart Router agent version reported by the gateway
time_drifted:
type: boolean
description: Whether the gateway clock has drifted from the expected time
timestamp:
type: number
description: Time associated with this gateway search result
readOnly: true
type:
const: gateway
type: string
description: Device type for this gateway search result
uptime:
type: integer
description: Device uptime for the gateway, in seconds
contentEncoding: int32
version:
type: string
description: Software version currently running on the gateway
description: Gateway record returned by device search endpoints
gateway_template:
title: gateway_template
required:
- name
type: object
properties:
additional_config_cmds:
type: array
items:
type: string
description: Additional CLI configuration commands provided by this gateway template
bgp_config:
type: object
additionalProperties:
$ref: '#/components/schemas/bgp_config'
description: BGP routing defaults for this gateway template. Property key is the BGP session name
created_time:
type: number
description: Timestamp when the gateway template was created
readOnly: true
dhcpd_config:
allOf:
- $ref: '#/components/schemas/dhcpd_config3'
- description: DHCP server defaults provided by this gateway template
dnsOverride:
type: boolean
description: Whether DNS server and suffix settings in this template override inherited values
default: false
dns_servers:
type: array
items:
type: string
description: DNS servers provided by this gateway template
dns_suffix:
type: array
items:
type: string
description: DNS search suffixes provided by this gateway template
extra_routes:
type: object
additionalProperties:
$ref: '#/components/schemas/gateway_extra_route'
description: Additional IPv4 route defaults in this gateway template
extra_routes6:
type: object
additionalProperties:
$ref: '#/components/schemas/gateway_extra_route6'
description: Additional IPv6 route defaults in this gateway template
examples:
- 2a02:1234:420a:10c9::/64:
via: 2a02:1234:200a::100
gateway_matching:
allOf:
- $ref: '#/components/schemas/gateway_matching2'
- description: Matching rules that select gateways for this template
gateway_mgmt:
allOf:
- $ref: '#/components/schemas/gateway_mgmt2'
- description: Management-plane defaults provided by this gateway template
id:
type: string
description: Unique identifier of the gateway template
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
idp_profiles:
type: object
additionalProperties:
$ref: '#/components/schemas/idp_profile'
description: Intrusion detection and prevention profile defaults in this gateway template
ip_configs:
type: object
additionalProperties:
$ref: '#/components/schemas/gateway_ip_config_property'
description: Gateway interface IP configuration defaults by network name
modified_time:
type: number
description: Timestamp when the gateway template was last modified
readOnly: true
name:
type: string
description: Display name of the gateway template
examples:
- gw_template
networks:
type: array
items:
$ref: '#/components/schemas/network'
description: Layer 3 networks configured by this gateway template
ntpOverride:
type: boolean
description: Whether NTP servers in this template override inherited values
default: false
ntp_servers:
type: array
items:
type: string
description: NTP servers provided by this gateway template
oob_ip_config:
allOf:
- $ref: '#/components/schemas/gateway_oob_ip_config3'
- description: Out-of-band management IP defaults in this gateway template
org_id:
type: string
description: Organization that owns this gateway template
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
path_preferences:
type: object
additionalProperties:
$ref: '#/components/schemas/gateway_path_preferences'
description: Property key is the path name
port_config:
type: object
additionalProperties:
$ref: '#/components/schemas/gateway_port_config'
description: Property key is the Port Name (i.e. "ge-0/0/0"), the Ports Range (i.e. "ge-0/0/0-10"), the List of Ports (i.e. "ge-0/0/0,ge-1/0/0", only allowed for Aggregated or Redundant interfaces) or a Variable (i.e. "{{myvar}}").
router_id:
type: string
description: Auto assigned if not set
examples:
- 10.2.1.10
routing_policies:
type: object
additionalProperties:
$ref: '#/components/schemas/gw_routing_policy'
description: Routing policy defaults applied by this gateway template
service_policies:
type: array
items:
$ref: '#/components/schemas/service_policy'
description: Traffic service policy defaults enforced by this gateway template
tunnel_configs:
type: object
additionalProperties:
$ref: '#/components/schemas/tunnel_config'
description: Property key is the tunnel name
tunnel_provider_options:
allOf:
- $ref: '#/components/schemas/tunnel_provider_options2'
- description: Provider-specific tunnel options defined by this gateway template
type:
allOf:
- $ref: '#/components/schemas/gateway_template_type2'
- description: 'Gateway template deployment type. enum: `spoke`, `standalone`.'
examples:
- standalone
url_filtering_deny_msg:
type: string
description: When a service policy denies a app_category, what message to show in user's browser
default: Access to this URL Category has been blocked
examples:
- Access to this URL Category has been blocked
vrf_config:
allOf:
- $ref: '#/components/schemas/vrf_config4'
- description: VRF defaults applied by this gateway template
vrf_instances:
type: object
additionalProperties:
$ref: '#/components/schemas/gateway_vrf_instance'
description: VRF instances configured by this gateway template
examples:
- CORP_VRF:
networks:
- CORP_NET
- MGMT_NET
description: Gateway Template is applied to a site for gateway(s) in a site.
gateway_template_type:
title: gateway_template_type
enum:
- spoke
- standalone
type: string
description: 'Gateway template deployment type. enum: `spoke`, `standalone`'
examples:
- standalone
gateway_traffic_shaping:
title: gateway_traffic_shaping
type: object
properties:
class_percentages:
type: array
items:
type: integer
contentEncoding: int32
description: Traffic class bandwidth percentages for high, medium, low, and best-effort queues
enabled:
type: boolean
description: Whether traffic shaping is enabled
default: false
max_tx_kbps:
type: integer
description: Maximum transmit bandwidth for the interface, in Kbps
contentEncoding: int32
description: Traffic shaping settings for a gateway interface or VPN path
gateway_vrf_instance:
title: gateway_vrf_instance
type: object
properties:
networks:
uniqueItems: true
type: array
items:
type: string
description: Network names included in this gateway VRF instance
description: Gateway VRF instance and its member networks
examples:
- networks:
- CORP_NET
- MGMT_NET
gateway_wan_ppoe_auth:
title: gateway_wan_ppoe_auth
enum:
- chap
- none
- pap
type: string
description: 'if `type`==`pppoe`. enum: `chap`, `none`, `pap`'
gateway_wan_probe_override:
title: gateway_wan_probe_override
type: object
properties:
hostnames:
uniqueItems: true
type: array
items:
type: string
description: List of hostnames used as probe destinations; applicable for both IPv4 and IPv6
http:
allOf:
- $ref: '#/components/schemas/gateway_wan_probe_override_http2'
- description: HTTP probe settings; success from any ICMP or HTTP probe indicates the WAN is up
ip6s:
uniqueItems: true
type: array
items:
type: string
description: List of IPv6 probe host addresses used by this WAN override
ips:
uniqueItems: true
type: array
items:
type: string
description: List of IPv4 probe host addresses used by this WAN override
probe_profile:
allOf:
- $ref: '#/components/schemas/gateway_wan_probe_override_probe_profile2'
- description: 'WAN probe profile used for health checks on this port. enum: `broadband`, `lte`.'
description: Only if `usage`==`wan`. WAN health probe override for this gateway port
gateway_wan_probe_override_http:
title: gateway_wan_probe_override_http
type: object
properties:
accepted_status_codes:
type: array
items:
type: integer
contentEncoding: int32
description: HTTP response status codes that indicate a successful probe. Defaults to 200 if not specified.
examples:
- - 204
urls:
type: array
items:
type: string
description: HTTP or HTTPS URLs to probe
examples:
- - http://www.google.com/generate_204
- https://www.google.com/generate_204
description: HTTP probe settings for a WAN probe override
gateway_wan_probe_override_probe_profile:
title: gateway_wan_probe_override_probe_profile
enum:
- broadband
- lte
type: string
description: 'WAN probe profile used for health checks on this port. enum: `broadband`, `lte`'
gateway_wan_type:
title: gateway_wan_type
enum:
- dhcp
- pppoe
- static
type: string
description: 'enum: `dhcp`, `pppoe`, `static`'
gateway_wan_type6:
title: gateway_wan_type6
enum:
- autoconf
- dhcp
- static
type: string
description: 'enum: `autoconf`, `dhcp`, `static`'
get_org_mxedge_upgrade_info_channel:
title: get_org_mxedge_upgrade_info_channel
enum:
- alpha
- beta
- stable
type: string
description: 'enum: `alpha`, `beta`, `stable`'
guest:
title: guest
type: object
properties:
access_code_email:
type: string
description: If `auth_method`==`email`, the email address where the authorization code has been sent to
readOnly: true
ap_mac:
type: string
description: MAC address of the AP used during guest registration
readOnly: true
auth_method:
type: string
description: Guest authentication method used for the authorization
readOnly: true
authorized:
type: boolean
description: Whether the guest is currently authorized
default: true
authorized_expiring_time:
type: number
description: Unix timestamp when the guest authorization expires
readOnly: true
examples:
- 1480704955
authorized_time:
type: number
description: Unix timestamp when the guest was authorized
readOnly: true
examples:
- 1480704355
company:
type: string
description: Optional company name provided by the guest during registration
examples:
- abc
email:
type: string
description: Optional email address provided by the guest during registration
contentEncoding: email
examples:
- john@abc.com
field1:
type: string
description: Optional custom field 1 value provided by the guest during registration
field2:
type: string
description: Optional custom field 2 value provided by the guest during registration
field3:
type: string
description: Optional custom field 3 value provided by the guest during registration
field4:
type: string
description: Optional custom field 4 value provided by the guest during registration
mac:
type: string
description: Device MAC address captured during guest registration
readOnly: true
minutes:
maximum: 259200
minimum: 0
type: integer
description: Authorization duration, in minutes. Default is 1440 minutes (1 day), maximum is 259200 (180 days)
contentEncoding: int32
default: 1440
name:
type: string
description: Optional name provided by the guest during registration
readOnly: true
examples:
- John Smith
random_mac:
type: boolean
description: Whether the guest device used a randomized MAC address to connect to the SSID
readOnly: true
ssid:
type: string
description: Name of the SSID
readOnly: true
examples:
- Guest-SSID
wlan_id:
type: string
description: Identifier of the WLAN used for the guest authorization
contentEncoding: uuid
readOnly: true
examples:
- 6748cfa6-4e12-11e6-9188-0242ac110007
description: Guest authorization record at site scope
guest_org:
title: guest_org
required:
- wlan_id
type: object
properties:
access_code_email:
type: string
description: If `auth_method`==`email`, the email address where the authorization code has been sent to
readOnly: true
allow_wlan_id_roam:
type: boolean
description: Based on the WLAN portal configuration (field `allow_wlan_id_roam`), if the user is also authorized on other Guest WLANs of the same Org without reauthentication
readOnly: true
ap_mac:
type: string
description: MAC address of the AP used during guest registration
readOnly: true
auth_method:
type: string
description: Guest authentication method used for the authorization
readOnly: true
authorized:
type: boolean
description: Whether the guest is currently authorized
default: true
authorized_expiring_time:
type: number
description: Unix timestamp when the guest authorization expires
readOnly: true
examples:
- 1480704955
authorized_time:
type: number
description: Unix timestamp when the guest was authorized
readOnly: true
examples:
- 1480704355
company:
type: string
description: Optional company name provided by the guest during registration
examples:
- abc
cross_site:
type: boolean
description: Based on the WLAN portal configuration (field `cross_site`), if the user is also authorized on other sites (same `wlan.ssid`) of the same Org without reauthentication
readOnly: true
email:
type: string
description: Optional email address provided by the guest during registration
contentEncoding: email
examples:
- john@abc.com
field1:
type: string
description: Optional custom field 1 value provided by the user during registration
field2:
type: string
description: Optional custom field 2 value provided by the user during registration
field3:
type: string
description: Optional custom field 3 value provided by the user during registration
field4:
type: string
description: Optional custom field 4 value provided by the user during registration
mac:
type: string
description: Device MAC address captured during guest registration
minutes:
maximum: 259200
minimum: 0
type: integer
description: Authorization duration, in minutes. Default is 1440 minutes (1 day), maximum is 259200 (180 days)
contentEncoding: int32
default: 1440
name:
type: string
description: Optional name provided by the guest during registration
examples:
- John Smith
random_mac:
type: boolean
description: Whether the guest device used a randomized MAC address to connect to the SSID
readOnly: true
ssid:
type: string
description: Name of the SSID
readOnly: true
examples:
- Guest-SSID
wlan_id:
type: string
description: Identifier of the WLAN used for the guest authorization
contentEncoding: uuid
examples:
- 6748cfa6-4e12-11e6-9188-0242ac110007
description: Guest authorization record at organization scope
gw_routing_policy:
title: gw_routing_policy
type: object
properties:
terms:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/gw_routing_policy_term'
description: Ordered terms evaluated by this gateway routing policy
description: Gateway routing policy made of ordered match-action terms
gw_routing_policy_term:
title: gw_routing_policy_term
type: object
properties:
actions:
allOf:
- $ref: '#/components/schemas/gw_routing_policy_term_action2'
- description: Policy actions applied when this routing policy term matches
matching:
allOf:
- $ref: '#/components/schemas/gw_routing_policy_term_matching2'
- description: Route match criteria that must be satisfied before actions are applied
description: Gateway routing policy term with match criteria and actions
gw_routing_policy_term_action:
title: gw_routing_policy_term_action
type: object
properties:
accept:
type: boolean
description: Whether to accept routes that match this term. Precedence is `accept` > `next_term` > `next_policy`; routes are rejected if all three are false
add_community:
type: array
items:
type: string
description: BGP communities to add to routes that match this term
add_target_vrfs:
type: array
items:
type: string
description: SSR target VRFs to add when leaking routes from hub to spoke
community:
type: array
items:
type: string
description: BGP communities to set when this term is used as an export policy
exclude_as_path:
type: array
items:
type: string
description: AS path values to exclude when this term is used as an export policy
exclude_community:
type: array
items:
type: string
description: BGP communities to exclude from routes that match this term
export_communities:
type: array
items:
type: string
description: BGP communities allowed for export when this term is used as an export policy
local_preference:
anyOf:
- type: string
- maximum: 4294967295
minimum: 1
type: integer
contentEncoding: int32
description: Preference value to set when this term is used as an import policy
next_policy:
type: boolean
description: When true, continue evaluating the next routing policy in the chain after this term matches; default is false
default: false
next_term:
type: boolean
description: When true, continue evaluating the next term in the same routing policy after this term matches; default is false
default: false
prepend_as_path:
type: array
items:
type: string
description: AS path values to prepend when this term is used as an export policy
description: Actions applied to routes matched by a gateway routing policy term
gw_routing_policy_term_matching:
title: gw_routing_policy_term_matching
type: object
properties:
as_path:
type: array
items:
$ref: '#/components/schemas/bgp_as'
description: AS path values that routes must match
community:
type: array
items:
type: string
description: BGP communities that routes must match
network:
uniqueItems: true
type: array
items:
type: string
description: Configured network names that routes must match
prefix:
type: array
items:
type: string
description: Route prefixes that routes must match
protocol:
type: array
items:
$ref: '#/components/schemas/gw_routing_policy_term_matching_protocol_enum'
description: Routing protocols that routes must match
route_exists:
allOf:
- $ref: '#/components/schemas/gw_routing_policy_term_matching_route_exists2'
- description: Existing route condition that must be satisfied before this term matches
vpn_neighbor_mac:
type: array
items:
type: string
description: Overlay neighbor MAC addresses used as match criteria for BGP sessions with `via`==`vpn`
vpn_path:
type: array
items:
type: string
description: Overlay path names used as match criteria for BGP sessions with `via`==`vpn`
vpn_path_sla:
allOf:
- $ref: '#/components/schemas/gw_routing_policy_term_matching_vpn_path_sla2'
- description: SLA thresholds used when matching a VPN path
description: Route match criteria for a gateway routing policy term; all specified criteria must match
gw_routing_policy_term_matching_protocol_enum:
title: gw_routing_policy_term_matching_protocol_enum
enum:
- aggregate
- bgp
- direct
- ospf
- static
type: string
description: 'enum: `aggregate`, `bgp`, `direct`, `ospf`, `static` (SRX Only)'
gw_routing_policy_term_matching_route_exists:
title: gw_routing_policy_term_matching_route_exists
type: object
properties:
route:
type: string
description: Prefix that must exist for this condition to match
examples:
- 192.168.0.0/24
vrf_name:
type: string
description: Name of the VRF instance where the route is checked; can also be a VPN or WAN name when applicable
default: default
description: Route-existence match condition for a gateway routing policy term
gw_routing_policy_term_matching_vpn_path_sla:
title: gw_routing_policy_term_matching_vpn_path_sla
type: object
properties:
max_jitter:
type:
- integer
- 'null'
description: Maximum jitter threshold allowed for the VPN path
contentEncoding: int32
max_latency:
type:
- integer
- 'null'
description: Maximum latency threshold allowed for the VPN path
contentEncoding: int32
examples:
- 1500
max_loss:
type:
- integer
- 'null'
description: Maximum packet-loss threshold allowed for the VPN path
contentEncoding: int32
examples:
- 30
description: SLA thresholds used when matching VPN paths
ha_cluster_config:
title: ha_cluster_config
type: object
properties:
disable_auto_config:
type: boolean
description: This disables the default behavior of a cloud-ready switch/gateway being managed/configured by Mist. Setting this to `true` means you want to disable the default behavior and do not want the device to be Mist-managed.
deprecated: true
managed:
type: boolean
description: An adopted switch/gateway will not be managed/configured by Mist by default. Setting this parameter to `true` enables the adopted switch/gateway to be managed/configured by Mist.
deprecated: true
mist_configured:
type: boolean
description: whether the device can be configured by Mist or not. This deprecates `managed` (for adopted device) and `disable_auto_config` for claimed device)
nodes:
type: array
items:
$ref: '#/components/schemas/ha_cluster_config_node'
description: Gateway nodes to include in the HA cluster; each node must be currently unassigned in inventory
site_id:
type: string
description: Site where the HA cluster should be created
contentEncoding: uuid
examples:
- 43e9c864-a7e4-4310-8031-d9817d2c5a43
description: Request to create an HA cluster from unassigned gateway inventory nodes
ha_cluster_config_node:
title: ha_cluster_config_node
maxProperties: 2
type: object
properties:
mac:
type: string
description: Gateway node MAC address for an inventory node that is currently unassigned
examples:
- aff827549235
description: HA cluster inventory node identified by MAC address
ha_cluster_delete:
title: ha_cluster_delete
type: object
properties:
mac:
type: string
description: Node0 MAC address identifying the HA cluster to delete
examples:
- aff827549235
description: Request body identifying the HA cluster node to remove
ha_cluster_node:
title: ha_cluster_node
type: object
properties:
node:
allOf:
- $ref: '#/components/schemas/ha_cluster_node_enum22'
- description: 'HA cluster node on which to run the device operation. enum: `node0`, `node1`.'
description: HA cluster node selector for device operations
ha_cluster_node_enum:
title: ha_cluster_node_enum
enum:
- node0
- node1
type: string
description: 'HA cluster node selector. enum: `node0`, `node1`'
hours:
title: hours
type: object
properties:
fri:
type: string
description: Operating hour range for Friday
examples:
- 09:00-17:00
mon:
type: string
description: Operating hour range for Monday
examples:
- 09:00-17:00
sat:
type: string
description: Operating hour range for Saturday
examples:
- 09:00-17:00
sun:
type: string
description: Operating hour range for Sunday
examples:
- 09:00-17:00
thu:
type: string
description: Operating hour range for Thursday
examples:
- 09:00-17:00
tue:
type: string
description: Operating hour range for Tuesday
examples:
- 09:00-17:00
wed:
type: string
description: Operating hour range for Wednesday
examples:
- 09:00-17:00
description: Day-of-week operating hour filters using hour ranges such as 09:00-17:00
idp_config:
title: idp_config
type: object
properties:
alert_only:
type: boolean
description: Whether to alert without enforcing IDP prevention actions
enabled:
type: boolean
description: Whether IDP inspection is enabled for the policy
default: false
idpprofile_id:
type: string
description: org_level IDP Profile can be used, this takes precedence over `profile`
contentEncoding: uuid
examples:
- 89b9d208-84a4-fa8f-af57-78f92c639cf2
profile:
type: string
description: 'enum: `Custom`, `strict` (default), `standard` or keys from idp_profiles'
default: strict
description: Intrusion detection and prevention settings for a service policy
idp_machine_cert_lookup_field:
title: idp_machine_cert_lookup_field
enum:
- automatic
- cn
- dns
type: string
description: "allow customer to choose the EAP-TLS client certificate's field to use for IDP Machine Groups lookup. enum: `automatic`, `cn`, `dns`"
idp_profile_action:
title: idp_profile_action
enum:
- alert
- close
- drop
type: string
description: 'IDP profile action. enum: `alert`, `close`, `drop`. `alert` is the default, `drop` silently drops packets, and `close` asks the client/server to close the connection'
examples:
- alert
idp_profile_base_profile:
title: idp_profile_base_profile
enum:
- critical
- standard
- strict
type: string
description: 'enum: `critical`, `standard`, `strict`'
examples:
- strict
idp_profile_matching:
title: idp_profile_matching
type: object
properties:
attack_name:
type: array
items:
type: string
description: Signature names matched by the IDP profile overwrite
dst_subnet:
type: array
items:
type: string
description: Destination subnets matched by the IDP profile overwrite
severity:
type: array
items:
$ref: '#/components/schemas/idp_profile_matching_severity_value'
description: Threat levels matched by the IDP profile overwrite
description: Criteria that select IDP signatures for an overwrite rule
idp_profile_matching_severity_value:
title: idp_profile_matching_severity_value
enum:
- critical
- info
- major
- minor
type: string
description: 'enum: `critical`, `info`, `major`, `minor`'
examples:
- major
idp_profile_overwrite:
title: idp_profile_overwrite
type: object
properties:
action:
allOf:
- $ref: '#/components/schemas/idp_profile_action2'
- description: 'Enforcement action applied when this overwrite rule matches. enum: `alert`, `close`, `drop`.'
examples:
- alert
matching:
allOf:
- $ref: '#/components/schemas/idp_profile_matching2'
- description: Criteria that select signatures for this overwrite rule
name:
type: string
description: Display name for this IDP profile overwrite rule
description: Override rule that changes the IDP action for matching signatures
idp_user_cert_lookup_field:
title: idp_user_cert_lookup_field
enum:
- automatic
- cn
- email
- upn
type: string
description: "allow customer to choose the EAP-TLS client certificate's field to use for IDP User Groups lookup. enum: `automatic`, `cn`, `email`, `upn`"
if_stat_property:
title: if_stat_property
type: object
properties:
address_mode:
type: string
description: Address assignment mode reported for the interface
ips:
uniqueItems: true
type: array
items:
type: string
description: Interface IP addresses reported with prefix information
nat_addresses:
uniqueItems: true
type: array
items:
type: string
description: NAT addresses associated with this interface
network_name:
type: string
description: Mist network name associated with this interface
port_id:
type: string
description: Physical or logical port identifier for this interface
port_usage:
type: string
description: Configured usage for this interface, such as LAN or WAN
redundancy_state:
type: string
description: Redundancy state reported for this interface
rx_bytes:
type:
- integer
- 'null'
description: Received byte counter for this interface
contentEncoding: int64
readOnly: true
examples:
- 8515104416
rx_pkts:
type:
- integer
- 'null'
description: Received packet counter for this interface
contentEncoding: int64
readOnly: true
examples:
- 57770567
servp_info:
allOf:
- $ref: '#/components/schemas/if_stat_property_servp_info2'
- description: Service-provider and geolocation details for this interface
tx_bytes:
type:
- integer
- 'null'
description: Transmitted byte counter for this interface
contentEncoding: int64
readOnly: true
examples:
- 211217389682
tx_pkts:
type:
- integer
- 'null'
description: Transmitted packet counter for this interface
contentEncoding: int64
readOnly: true
examples:
- 812204062
up:
type: boolean
description: Whether the interface is operationally up
vlan:
type: integer
description: Associated VLAN ID for this interface
contentEncoding: int32
wan_name:
type: string
description: Configured WAN name associated with this interface
wan_type:
type: string
description: Configured WAN uplink type associated with this interface
description: Interface statistics and metadata reported by a device
if_stat_property_servp_info:
title: if_stat_property_servp_info
type: object
properties:
asn:
type: string
description: Autonomous System Number associated with the service provider
city:
type: string
description: Detected city for the service provider address
country_code:
type: string
description: ISO country code for the service provider address
latitude:
type: number
description: Geographic latitude for the service provider address
longitude:
type: number
description: Geographic longitude for the service provider address
org:
type: string
description: Service provider organization name
region_code:
type: string
description: Administrative region code for the service provider address
description: Service-provider and geolocation details associated with an interface address
image_import:
title: image_import
required:
- file
type: object
properties:
file:
type: string
description: Image file content uploaded as multipart form data
contentEncoding: base64
json:
type: string
description: Optional JSON metadata submitted with the image upload
description: Multipart image upload payload
import_site_assets_upsert:
title: import_site_assets_upsert
enum:
- 'False'
- 'True'
type: string
description: 'Whether site asset import should update matching existing assets. enum: `False`, `True`'
insight_metrics:
title: insight_metrics
required:
- end
- interval
- start
type: object
properties:
end:
type: integer
description: Window end timestamp for the returned insight metrics
contentEncoding: int32
interval:
type: integer
description: Aggregation interval used for the metric results
contentEncoding: int32
limit:
type: integer
description: Maximum number of insight metric result items returned
contentEncoding: int32
results:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/insight_metrics_results_item'
description: Metric result values for the requested insight metric
start:
type: integer
description: Window start timestamp for the returned insight metrics
contentEncoding: int32
description: Insight metric response for a requested time range and aggregation interval
insight_rogue_ap:
title: insight_rogue_ap
required:
- ap_mac
- avg_rssi
- bssid
- channel
- num_aps
type: object
properties:
ap_mac:
type: string
description: Reporting AP MAC address with the strongest signal for the SSID/BSSID pair
avg_rssi:
type: number
description: Average RSSI for the SSID/BSSID pair as heard by the reporting AP
bssid:
type: string
description: Rogue or neighbor BSSID detected as a threat
channel:
type: string
description: Radio channel where the reporting AP heard the SSID/BSSID pair
delta_x:
type: number
description: X position relative to the reporting AP (`ap_mac`)
delta_y:
type: number
description: Y position relative to the reporting AP (`ap_mac`)
num_aps:
type: integer
description: Number of APs that heard the SSID/BSSID pair
contentEncoding: int32
seen_on_lan:
type: boolean
description: Whether the reporting AP sees a LAN-side client associated with the BSSID
ssid:
type: string
description: Wireless SSID detected for the rogue or neighbor BSSID
times_heard:
type: integer
description: Represents number of times the pair was heard in the interval. Each count roughly corresponds to a minute.
contentEncoding: int32
description: Rogue or neighbor AP observation returned by site insights
insight_rogue_client:
title: insight_rogue_client
required:
- annotation
- ap_mac
- avg_rssi
- band
- bssid
- client_mac
- num_aps
type: object
properties:
annotation:
type: string
description: Rogue client annotation or classification
ap_mac:
type: string
description: Reporting AP MAC address that observed the rogue client
avg_rssi:
type: number
description: Average RSSI for the rogue client as heard by reporting APs
band:
type: string
description: Radio band on which the rogue client was observed
bssid:
type: string
description: Rogue BSSID associated with the client
client_mac:
type: string
description: Observed client MAC address on the rogue BSSID
num_aps:
type: integer
description: Number of APs that observed the rogue client
contentEncoding: int32
description: Rogue client observation returned by site insights
installer_device:
title: installer_device
type: object
properties:
ble_stat:
allOf:
- $ref: '#/components/schemas/installer_device_ble_stat2'
- description: BLE beacon statistics reported by the device
connected:
type: boolean
description: Whether the device is currently connected to Mist
examples:
- true
deviceprofile_name:
type: string
description: Device profile name associated with this installer device
examples:
- SJ1
ext_ip:
type: string
description: External IP address observed for device management traffic
examples:
- 12.34.56.78
height:
type: number
description: Mounting height recorded for map placement
examples:
- 2.7
ip:
type: string
description: Management IP address currently reported for the device
examples:
- 192.168.1.111
last_seen:
type:
- number
- 'null'
description: Timestamp when the device was last seen by Mist
readOnly: true
examples:
- 1470417522
mac:
type: string
description: Device MAC address shown to installers
examples:
- 5c5b35000018
map_id:
type: string
description: Map where the installer placed this device
contentEncoding: uuid
examples:
- 845a23bf-bed9-e43c-4c86-6fa474be7ae5
model:
type: string
description: Device model reported for this installer device
examples:
- AP41
name:
type: string
description: Device name configured through the installer workflow
examples:
- hallway
orientation:
type: integer
description: Device orientation in degrees from 0 to 359, where 0 is up and 90 is right
contentEncoding: int32
examples:
- 90
serial:
type: string
description: Device serial number reported to installer workflows
examples:
- FXLH2015150025
site_name:
type: string
description: Site name associated with this installer device
examples:
- SJ1
uptime:
type: integer
description: Device uptime, in seconds
contentEncoding: int32
examples:
- 12345
vc_mac:
type:
- string
- 'null'
description: Virtual Chassis MAC address when this device is part of a VC
version:
type: string
description: Software version currently running on the device
examples:
- 0.10.24362
x:
type: number
description: Horizontal map position of the device, in pixels
examples:
- 150
y:
type: number
description: Vertical map position of the device, in pixels
examples:
- 300
description: Recently claimed device visible to installer workflows
installer_device_ble_stat:
title: installer_device_ble_stat
type: object
properties:
major:
type: integer
description: iBeacon major value reported by the device
contentEncoding: int32
examples:
- 12345
minors:
type: array
items:
type: integer
contentEncoding: int32
description: iBeacon minor values reported by the device
uuid:
type: string
description: iBeacon UUID advertised by the device
contentEncoding: uuid
examples:
- ada72f8f-1643-e5c6-94db-f2a5636f1a64
description: BLE statistics for the device
installer_provision_device:
title: installer_provision_device
required:
- name
type: object
properties:
deviceprofile_name:
type: string
description: Profile name applied to the device during installer provisioning
examples:
- SJ1
for_site:
type: boolean
description: Whether this installer provisioning request is scoped to a site
readOnly: true
height:
type: number
description: Mounting height recorded for map placement
examples:
- 2.7
map_id:
type: string
description: Identifier of the map where the device should be placed
contentEncoding: uuid
examples:
- 845a23bf-bed9-e43c-4c86-6fa474be7ae5
name:
type: string
description: Device name to set during installer provisioning
examples:
- SJ1-AP1
orientation:
type: integer
description: Device orientation in degrees from 0 to 359, where 0 is up and 90 is right
contentEncoding: int32
examples:
- 90
replacing_mac:
type: string
description: Only if replacing an existing device; MAC address of the device being replaced
examples:
- 5c5b3500003
role:
type: string
description: Optional role for switch / gateway
site_id:
type: string
description: Identifier of the destination site for installer provisioning
contentEncoding: uuid
examples:
- 72771e6a-6f5e-4de4-a5b9-1266c4197811
site_name:
type: string
description: Destination site name for installer provisioning
examples:
- SJ1
x:
type: number
description: Horizontal map position for the device, in pixels
examples:
- 150
y:
type: number
description: Vertical map position for the device, in pixels
examples:
- 300
description: Installer payload for provisioning or replacing a device
installer_site:
title: installer_site
required:
- address
- country_code
- latlng
- name
type: object
properties:
address:
type: string
description: Street or postal address for the installer site
examples:
- 1601 S. Deanza Blvd., Cupertino, CA, 95014
country_code:
type: string
description: ISO country code for the installer site
examples:
- US
id:
type: string
description: Unique identifier of the installer site
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
latlng:
allOf:
- $ref: '#/components/schemas/lat_lng4'
- description: Geographic coordinates of the installer site
name:
type: string
description: Display name of the installer site
examples:
- Mist Office
rftemplate_name:
type: string
description: RF template name applied to the installer site
examples:
- rftemplate1
sitegroup_names:
type: array
items:
type: string
description: Names of site groups associated with the installer site
examples:
- - sg1
- sg2
timezone:
type: string
description: Time zone configured for the installer site
examples:
- America/Los_Angeles
description: Site definition available to installer workflows
installers_item:
title: installers_item
type: object
properties:
id:
type: string
description: Unique identifier of the installer access entry
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
name:
type: string
description: Display name of the installer access entry
examples:
- 'Entry #1'
description: Installer access entry with scope and role details
inventory:
title: inventory
type: object
properties:
adopted:
type: boolean
description: Only if `type`==`switch` or `type`==`gateway`, whether the switch/gateway is adopted
chassis_mac:
type: string
description: For Virtual Chassis only, MAC address of the FPC0 member
chassis_serial:
type: string
description: For Virtual Chassis only, the Serial Number of the FPC0
connected:
type: boolean
description: Whether the device is connected
created_time:
type: number
description: Timestamp when the inventory record was created
readOnly: true
deviceprofile_id:
type:
- string
- 'null'
description: Deviceprofile id if assigned, null if not assigned
hostname:
type: string
description: Inventory hostname value reported by the device
hw_rev:
type: string
description: Device hardware revision number
id:
type: string
description: Unique identifier of the inventory record
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
jsi:
type: boolean
description: Whether the inventory device is in JSI mode
last_disconnected:
type: integer
description: Timestamp when the device last disconnected, in epoch seconds
contentEncoding: int32
mac:
type: string
description: Device MAC address for this inventory record
magic:
type: string
description: Claim code used to add this device to inventory
model:
type: string
description: Device model reported in inventory
modified_time:
type: number
description: Timestamp when the inventory record was last modified
readOnly: true
name:
type: string
description: Device name if configured
org_id:
type: string
description: Organization that owns this inventory record
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
serial:
type: string
description: Device serial number reported in inventory
site_id:
type: string
description: Site associated with this inventory record, when assigned
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
sku:
type: string
description: Device stock keeping unit
type:
allOf:
- $ref: '#/components/schemas/device_type_default_ap3'
- description: 'Device type for this inventory record. enum: `ap`, `gateway`, `switch`.'
vc_mac:
type: string
description: If `type`==`switch` and the device is part of a Virtual Chassis, MAC address of the Virtual Chassis. If `type`==`gateway` and the device is part of a cluster, MAC address of the cluster
description: Organization inventory record for a claimed device
inventory_count_distinct:
title: inventory_count_distinct
enum:
- model
- status
- site_id
- sku
- version
type: string
description: 'enum: `model`, `status`, `site_id`, `sku`, `version`'
inventory_search:
title: inventory_search
type: object
properties:
end:
type: integer
description: Page ending index for this inventory search response
contentEncoding: int32
limit:
type: integer
description: Maximum number of inventory search results requested
contentEncoding: int32
examples:
- 1000
next:
type: string
description: URL for the next page of inventory search results
results:
type: array
items:
$ref: '#/components/schemas/inventory_search_result'
description: Inventory records returned by the search
start:
type: integer
description: Page starting index for this inventory search response
contentEncoding: int32
total:
type: integer
description: Number of inventory records matching the search
contentEncoding: int32
examples:
- 1
description: Paginated inventory search response
inventory_search_result:
title: inventory_search_result
type: object
properties:
mac:
type: string
description: Device MAC address for this inventory search result
examples:
- f01c2df166e0
magic:
type: string
description: Device claim code (magic) for this inventory search result
examples:
- WVTFBLTNPXD23H2
master:
type: boolean
description: Whether this search result represents the master member of a Virtual Chassis
examples:
- true
members:
type: array
items:
$ref: '#/components/schemas/inventory_search_result_member'
description: Virtual Chassis members included in this inventory search result
model:
type: string
description: Device model for this inventory search result
examples:
- EX4300-48P
name:
type: string
description: Configured device name in this inventory search result
examples:
- mist-wa-ex4300-VC
org_id:
type: string
description: Organization that owns this inventory search result
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
serial:
type: string
description: Device serial number for this inventory search result
examples:
- PD3714460200
site_id:
type: string
description: Site associated with this inventory search result, when assigned
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
sku:
type: string
description: Device SKU for this inventory search result
examples:
- EX4300-48P
status:
type: string
description: Current inventory status for the device
examples:
- disconnected
type:
allOf:
- $ref: '#/components/schemas/device_type_default_ap4'
- description: 'Device type for this inventory search result. enum: `ap`, `gateway`, `switch`.'
vc_mac:
type: string
description: Virtual Chassis MAC address for this inventory search result
examples:
- f01c2df166e0
version:
type: string
description: Software version reported for this inventory search result
examples:
- 21.4R3.5
description: Inventory record returned by inventory search
inventory_search_result_member:
title: inventory_search_result_member
type: object
properties:
mac:
type: string
description: Member device MAC address in this inventory search result
examples:
- f01c2df166e0
model:
type: string
description: Member device model in this inventory search result
examples:
- EX4300-48P
serial:
type: string
description: Member device serial number in this inventory search result
examples:
- PD3714460200
description: Virtual Chassis member in an inventory search result
inventory_update:
title: inventory_update
required:
- op
type: object
properties:
disable_auto_config:
type: boolean
description: If `op`==`assign`, this disables the default behavior of a cloud-ready switch/gateway being managed/configured by Mist. Setting this to `true` means you want to disable the default behavior and do not want the device to be Mist-managed.
default: false
deprecated: true
macs:
type: array
items:
type: string
description: Device MAC addresses affected by this inventory operation
managed:
type: boolean
description: If `op`==`assign`. An adopted switch/gateway will not be managed/configured by Mist by default. Setting this parameter to `true` enables the adopted switch/gateway to be managed/configured by Mist.
default: false
deprecated: true
mist_configured:
type: boolean
description: Whether the device can be configured by Mist. Replaces `managed` for adopted devices and `disable_auto_config` for claimed devices
no_reassign:
type: boolean
description: If `op`==`assign`, if true, treat site assignment against an already assigned AP as error
default: false
op:
allOf:
- $ref: '#/components/schemas/inventory_update_operation2'
- description: 'Inventory operation to apply to the listed devices. enum: `assign`, `delete`, `downgrade_to_jsi`, `unassign`, `upgrade_to_mist`.'
serials:
type: array
items:
type: string
description: Device serial numbers affected by this inventory operation
site_id:
type: string
description: If `op`==`assign`, target site ID for the inventory operation
contentEncoding: uuid
description: Request to assign, unassign, delete, or change management mode for inventory devices
inventory_update_operation:
title: inventory_update_operation
enum:
- assign
- delete
- downgrade_to_jsi
- unassign
- upgrade_to_mist
type: string
description: >-
enum:
* `upgrade_to_mist`: Upgrade to mist-managed
* `downgrade_to_jsi`: Downgrade to basic monitoring. When downgrading a VC member to jsi, we will move the cloud connection of the VC to jsi-terminator and keep all VC device/inventories intact for pain-free upgrading back to mist.
* `assign`: Assign inventory to a site
* `unassign`: Unassign inventory from a site
* `delete`: Delete multiple inventory from org. If the device is already assigned to a site, it will be unassigned
iotendpoint_stats:
title: iotendpoint_stats
type: object
properties:
ap_mac:
type: string
description: MAC address of the AP the endpoint was seen on
examples:
- 5c5b350e0001
id:
type: string
description: Unique identifier for the IoT endpoint
examples:
- 63f9e299182b63f9
lqi:
maximum: 255
minimum: 0
type: integer
description: Link Quality Indicator (0–255)
contentEncoding: int32
mac:
type: string
description: Endpoint MAC address reported in IoT statistics
examples:
- 63f9e299182b63f9
mfg:
type: string
description: Manufacturer name reported for the IoT endpoint
examples:
- Assa Abloy
model:
type: string
description: Device model reported for the IoT endpoint
examples:
- Assa Abloy
timestamp:
type: number
description: Epoch timestamp of the last observation, in seconds
type:
type: string
description: 'IoT endpoint type. enum: `zigbee`'
examples:
- zigbee
description: IoT endpoint statistics returned by a search response
iotproxy:
title: iotproxy
type: object
properties:
enabled:
type: boolean
description: Whether the site IoT proxy is enabled
default: false
visionline:
allOf:
- $ref: '#/components/schemas/iotproxy_visionline2'
- description: Site access-control integration settings for Visionline
description: IoT proxy configuration for the site
iotproxy_visionline:
title: iotproxy_visionline
type: object
properties:
access_id:
type: string
description: Access ID for the Visionline service
examples:
- 790e6c1790e6c18541d
cacerts:
type: array
items:
type: string
description: PEM-encoded CA certificates used to verify the Visionline collector's TLS certificate. Required when the collector uses a self-signed certificate
enabled:
type: boolean
description: Whether the Visionline integration is enabled
default: false
host:
type: string
description: Collector hostname or IP address for Visionline
examples:
- visionline_collector1.local
password:
type: string
description: Visionline service password used by the IoT proxy
contentEncoding: password
port:
type: integer
description: TCP port of the Visionline collector
contentEncoding: int32
default: 443
username:
type: string
description: Visionline service username used by the IoT proxy
examples:
- card_administrator
description: Visionline integration settings for IoT proxy
ip_stat:
title: ip_stat
type: object
properties:
dhcp_server:
type:
- string
- 'null'
description: Reported DHCP server IPv4 address for the interface, when available
readOnly: true
examples:
- 192.168.95.1
dns:
uniqueItems: true
type: array
items:
type: string
description: Reported DNS server addresses for the interface
dns_suffix:
uniqueItems: true
type: array
items:
type: string
description: Reported DNS search suffixes for the interface
gateway:
type:
- string
- 'null'
description: Current IPv4 default gateway for the interface, when available
readOnly: true
gateway6:
type:
- string
- 'null'
description: Current IPv6 default gateway for the interface, when available
readOnly: true
examples:
- fdad:b0bc:f29e::1
ip:
type:
- string
- 'null'
description: Current IPv4 address for the interface, when available
readOnly: true
examples:
- 10.3.3.1
ip6:
type:
- string
- 'null'
description: Current IPv6 address for the interface, when available
readOnly: true
examples:
- fdad:b0bc:f29e::3d16
ips:
type: object
additionalProperties:
type: string
nullable: true
description: Per-VLAN IP address summaries keyed by VLAN name
netmask:
type:
- string
- 'null'
description: Current IPv4 subnet mask for the interface, when available
readOnly: true
examples:
- 255.255.255.0
netmask6:
type:
- string
- 'null'
description: Current IPv6 prefix length for the interface, when available
readOnly: true
examples:
- /64
description: Read-only IP addressing status reported by a device interface
ip_type:
title: ip_type
enum:
- dhcp
- static
type: string
description: 'IP address assignment mode, either DHCP or static. enum: `dhcp`, `static`'
examples:
- static
ip_type6:
title: ip_type6
enum:
- autoconf
- dhcp
- disabled
- static
type: string
description: 'enum: `autoconf`, `dhcp`, `disabled`, `static`'
examples:
- static
issued_client_certificate:
title: issued_client_certificate
type: object
properties:
cert_provider:
type: string
description: Certificate provider that issued this client certificate
examples:
- byod
common_name:
type: string
description: Subject common name encoded in the issued client certificate
examples:
- john@corp.com
created_time:
type: integer
description: Certificate issuance time, in epoch seconds
contentEncoding: int32
device_id:
type: string
description: Device associated with the issued client certificate
contentEncoding: uuid
readOnly: true
examples:
- 00000000-0000-0000-1000-d8695a0f9e61
expire_time:
type: integer
description: Certificate expiry time, in epoch seconds
contentEncoding: int32
serial_number:
type: string
description: Certificate serial number used for lookup or revocation
examples:
- 91984382552102771A2B3C4E5F224719956718003374658
description: Issued Mist SCEP client certificate metadata
issued_client_certificates_results:
title: issued_client_certificates_results
type: object
properties:
limit:
type: integer
description: Maximum number of results requested
contentEncoding: int32
page:
type: integer
description: Current page number
contentEncoding: int32
results:
type: array
items:
$ref: '#/components/schemas/issued_client_certificate'
description: List of issued client certificates returned by the query
description: Issued client certificate search results wrapper
js_inventory_item:
title: js_inventory_item
type: object
properties:
availability:
type: string
description: Current operational availability status of the device; only returned for onboarded (claimed) devices
claimed:
type: boolean
description: Indicates if the device is claimed by any org
contract_end_date:
type: string
description: Expiration date of the service contract; only returned for onboarded (claimed) devices
contract_id:
type: string
description: Unique identifier of the service contract; only returned for onboarded (claimed) devices
contract_reseller:
type: string
description: Name of the reseller associated with the contract; only returned for onboarded (claimed) devices
contract_sku:
type: string
description: SKU associated with the service contract; only returned for onboarded (claimed) devices
contract_start_date:
type: string
description: Official commencement date of the service contract; only returned for onboarded (claimed) devices
contract_type:
type: string
description: General classification of the contract; only returned for onboarded (claimed) devices
current_contract_flag:
type: string
description: Current status of the contract (e.g., 'Active', 'Expired'); only returned for onboarded (claimed) devices
device_name:
type: string
description: Name of the device
distributor:
type: string
description: Name of the distributor who provided the device; only returned for onboarded (claimed) devices
end_of_sale_time:
type: integer
description: End of sale epoch timestamp
contentEncoding: int32
end_of_service_time:
type: integer
description: End of service epoch timestamp
contentEncoding: int32
eol_psn:
type: string
description: Product support notice associated with the device end-of-life milestone
examples:
- TSB18097
eos_time:
type: integer
description: End of support time
contentEncoding: int32
has_support:
type: boolean
description: Indicates if the device is covered under active support contract
ia_address:
type: string
description: Physical installation street address of the asset; only returned for onboarded (claimed) devices
ia_country:
type: string
description: Country of installation; only returned for onboarded (claimed) devices
ia_region:
type: string
description: Geographic region where the device is installed; only returned for onboarded (claimed) devices
ia_zip_postal:
type: string
description: ZIP or postal code of the installation site; only returned for onboarded (claimed) devices
master:
type: boolean
description: Indicates whether it is Master
model:
type: string
description: Hardware model recorded in the install base inventory
org_id:
type: string
description: Organization identifier that has claimed the device, when applicable
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
serial:
type: string
description: Device serial number recorded in the install base inventory
service_contract_no:
type: string
description: Unique identifier for the service contract; only returned for onboarded (claimed) devices
service_contract_type:
type: string
description: Specific service level or contract category for the device; only returned for onboarded (claimed) devices
service_decline_flag:
type: string
description: Indicates if the service offer was declined (e.g., 'Y'/'N'); only returned for onboarded (claimed) devices
service_eligible:
type: string
description: Indicator of whether the device is eligible for service coverage ('Yes', 'No'); only returned for onboarded (claimed) devices
ship_date_calc:
type: string
description: Calculated or actual date the device was shipped; only returned for onboarded (claimed) devices
sku:
type: string
description: Serviceable SKU associated with the device
status:
type: string
description: Current inventory status reported for the device
suggested_version:
type: string
description: Recommended software version for the device
support_contract_status:
allOf:
- $ref: '#/components/schemas/support_contract_status2'
- description: 'Service contract status; only returned for onboarded (claimed) devices. enum: `Active`, `Declined`, `EOL`, `Service Available`.'
type:
allOf:
- $ref: '#/components/schemas/device_type2'
- description: 'Device category for the inventory item. enum: `ap`, `gateway`, `switch`.'
version:
type: string
description: Software version currently running on the device
version_description:
type: string
description: Release description associated with the reported software version
version_eos_time:
type: integer
description: End of Service of version
contentEncoding: int32
version_time:
type: integer
description: FRS date of the version
contentEncoding: int32
warranty:
type: string
description: Coverage details associated with the device warranty
warranty_end:
type: string
description: Expiration date of the warranty period; only returned for onboarded (claimed) devices
warranty_start:
type: string
description: Start date of the manufacturer or secondary warranty; only returned for onboarded (claimed) devices
warranty_time:
type: integer
description: Timestamp when warranty needs to be renewed
contentEncoding: int32
warranty_type:
type: string
description: Warranty category reported for the device
description: Juniper Support inventory item with entitlement, lifecycle, and software metadata
js_inventory_search:
title: js_inventory_search
type: object
properties:
end:
type: integer
description: Offset to end at
contentEncoding: int32
limit:
type: integer
description: Number of results to return
contentEncoding: int32
next:
type: string
description: URL for the next page of JSI inventory results
results:
type: array
items:
$ref: '#/components/schemas/js_inventory_item'
description: JSI inventory records returned by the search
start:
type: integer
description: Offset to start from
contentEncoding: int32
total:
type: integer
description: Number of JSI inventory records matching the search
contentEncoding: int32
description: Paginated JSI inventory search response
jse_device:
title: jse_device
type: object
properties:
ext_ip:
type: string
description: External IP address for the JSE device, when available
last_seen:
type:
- number
- 'null'
description: Timestamp when the JSE device was last seen
readOnly: true
examples:
- 1470417522
mac:
type: string
description: Device MAC address for the JSE device
model:
type: string
description: Device model for the JSE device
serial:
type: string
description: Device serial number for the JSE device
description: JSE device reported for an organization
jsi_inventory_count_distinct:
title: jsi_inventory_count_distinct
enum:
- account_id
- claimed
- has_support
- end_of_sale_time
- eos_time
- version_time
- model
- sku
- status
- type
- version
- warranty_type
type: string
description: 'Distinct field used when counting Juniper Support Insight inventory records. enum: `account_id`, `claimed`, `has_support`, `end_of_sale_time`, `eos_time`, `version_time`, `model`, `sku`, `status`, `type`, `version`, `warranty_type`'
jsi_pbn_bug_type:
title: jsi_pbn_bug_type
enum:
- Day-1
- Regression
type: string
description: 'Type of the bug. enum: `Day-1`, `Regression`'
jsi_pbn_item:
title: jsi_pbn_item
type: object
properties:
bug_type:
allOf:
- $ref: '#/components/schemas/jsi_pbn_bug_type'
- description: 'Type of the bug. enum: `Day-1`, `Regression`'
customer_risk:
type: string
description: Customer impact risk level for the PBN advisory
fixed_in:
type: string
description: Release in which the issue was fixed
id:
type: string
description: Unique PBN advisory identifier from Juniper Support Insights
examples:
- '1403338'
introduced_in:
type: string
description: Release where the PBN issue was introduced
models:
type: array
items:
type: string
description: Device models affected by the PBN issue
product_family:
type: array
items:
type: string
description: Product families affected by the PBN issue
release_notes:
type: string
description: Release notes for this PBN
restoration:
type: string
description: Steps recommended to restore service or recover from the PBN issue
title:
type: string
description: Summary title for the PBN issue
updated_date:
type: integer
description: Time when the PBN advisory was last updated
contentEncoding: int32
versions:
type: array
items:
type: string
description: Software versions affected by the PBN issue
workaround:
type: string
description: Mitigation or workaround guidance for the PBN issue
workaround_provided:
type: string
description: Indicator of whether workaround guidance is available
description: PBN (Problem Bug Notification) advisory item
jsi_pbn_search:
title: jsi_pbn_search
type: object
properties:
end:
type: integer
description: Upper bound timestamp for the PBN search window
contentEncoding: int32
limit:
type: integer
description: Number of results to return
contentEncoding: int32
next:
type: string
description: Pagination URL for the next page of PBN advisories
results:
type: array
items:
$ref: '#/components/schemas/jsi_pbn_item'
description: List of PBN advisories
start:
type: integer
description: Lower bound timestamp for the PBN search window
contentEncoding: int32
total:
type: integer
description: Count of PBN advisories matching the search
contentEncoding: int32
description: Juniper Security Intelligence PBN search response with result metadata
jsi_sirt_item:
title: jsi_sirt_item
type: object
properties:
cvss_score:
type: number
description: Common Vulnerability Scoring System score for the SIRT advisory
id:
type: string
description: Unique SIRT or JSA advisory identifier from Juniper Support Insights
examples:
- JSA100053
models:
type: array
items:
type: string
description: Device models affected by the SIRT advisory
problem:
type: string
description: Issue details described by the SIRT advisory
published_date:
type: integer
description: Release date of the SIRT issue
contentEncoding: int32
release_notes:
type: string
description: Release notes if any
severity:
allOf:
- $ref: '#/components/schemas/jsi_sirt_severity'
- description: 'Security severity assigned to the SIRT advisory. enum: `Critical`, `High`, `Low`, `Medium`'
solution:
type: string
description: Recommended fix or remediation for the security issue
title:
type: string
description: Summary title for the SIRT advisory
updated_date:
type: integer
description: Time when the JSA advisory was last updated
contentEncoding: int32
versions:
type: array
items:
type: string
description: Software versions affected by the SIRT advisory
workaround:
type: string
description: Mitigation or workaround guidance for the SIRT advisory
description: Juniper Security Intelligence SIRT advisory item
jsi_sirt_search:
title: jsi_sirt_search
type: object
properties:
end:
type: integer
description: Upper bound timestamp for the SIRT search window
contentEncoding: int32
limit:
type: integer
description: Number of results to return
contentEncoding: int32
next:
type: string
description: Pagination URL for the next page of SIRT advisories
results:
type: array
items:
$ref: '#/components/schemas/jsi_sirt_item'
description: List of SIRT advisories
start:
type: integer
description: Lower bound timestamp for the SIRT search window
contentEncoding: int32
total:
type: integer
description: Count of SIRT advisories matching the search
contentEncoding: int32
description: Juniper Security Intelligence SIRT search response with result metadata
jsi_sirt_severity:
title: jsi_sirt_severity
enum:
- Critical
- High
- Low
- Medium
type: string
description: 'Security severity assigned to the SIRT advisory. enum: `Critical`, `High`, `Low`, `Medium`'
juniper_account:
title: juniper_account
type: object
properties:
linked_by:
type: string
description: User who linked this Juniper account
readOnly: true
examples:
- John Smith (john@abccorp.com)
name:
type: string
description: Display name of the linked Juniper account
readOnly: true
examples:
- ABC Corp
description: Linked Juniper account available to the organization
juniper_srx_auto_upgrade:
title: juniper_srx_auto_upgrade
type: object
properties:
custom_versions:
type: object
additionalProperties:
type: string
description: Per-SRX-model firmware versions to deploy instead of the default version
enabled:
type: boolean
description: Whether SRX auto-upgrade is enabled for newly onboarded devices
default: false
snapshot:
type: boolean
description: Whether to take a snapshot during the SRX upgrade process
default: false
version:
type: string
description: Firmware version to deploy (e.g. 23.4R2-S5.5). Optional, used when custom_versions not specified
examples:
- 23.4R2-S5.5
description: SRX firmware auto-upgrade settings applied when a device is first onboarded
junos_ip_config:
title: junos_ip_config
type: object
properties:
dns:
uniqueItems: true
type: array
items:
type: string
description: Configured DNS server addresses for Junos management traffic
dns_suffix:
uniqueItems: true
type: array
items:
type: string
description: DNS search suffixes configured for Junos management traffic
gateway:
type: string
description: Default gateway IPv4 address for this Junos IP configuration
ip:
type: string
description: Configured IPv4 address for this Junos IP configuration
netmask:
type: string
description: Used only if `subnet` is not specified in `networks`
network:
type: string
description: Management network for this IP configuration; used as the default source network for outbound SSH, DNS, NTP, TACACS+, RADIUS, syslog, and SNMP
type:
allOf:
- $ref: '#/components/schemas/ip_type1'
- description: 'IP assignment mode for this Junos IP configuration. enum: `dhcp`, `static`.'
examples:
- static
description: Junos management IP configuration
junos_local_port_config:
title: junos_local_port_config
required:
- usage
type: object
properties:
all_networks:
type: boolean
description: Only if `mode`==`trunk` whether to trunk all network/vlans
default: false
allow_dhcpd:
type: boolean
description: 'Controls whether DHCP server traffic is allowed on ports using this configuration if DHCP snooping is enabled. This is a tri-state setting; `true`: ports become trusted ports allowing DHCP server traffic, `false`: ports become untrusted blocking DHCP server traffic, undefined: use system defaults (access ports default to untrusted, trunk ports default to trusted).'
allow_multiple_supplicants:
type: boolean
description: Whether multiple supplicants may authenticate on the port
default: false
bypass_auth_when_server_down:
type: boolean
description: Only if `port_auth`==`dot1x` bypass auth for known clients if set to true when RADIUS server is down
default: false
bypass_auth_when_server_down_for_unknown_client:
type: boolean
description: Only if `port_auth`=`dot1x` bypass auth for all (including unknown clients) if set to true when RADIUS server is down
default: false
description:
type: string
description: Human-readable description for this local port configuration
disable_autoneg:
type: boolean
description: Only if `mode`!=`dynamic` if speed and duplex are specified, whether to disable autonegotiation
default: false
disabled:
type: boolean
description: Whether the port is disabled
default: false
duplex:
allOf:
- $ref: '#/components/schemas/switch_port_local_usage_duplex2'
- description: 'Link duplex mode for this local port configuration. enum: `auto`, `full`, `half`.'
dynamic_vlan_networks:
type: array
items:
type: string
description: Only if `port_auth`==`dot1x`, networks or VLANs that RADIUS can return for dynamic VLAN assignment
examples:
- - corp
- user
enable_mac_auth:
type: boolean
description: Only if `port_auth`==`dot1x` whether to enable MAC Auth
default: false
enable_qos:
type: boolean
description: Whether QoS is enabled on ports using this local configuration
default: false
guest_network:
type:
- string
- 'null'
description: Only if `port_auth`==`dot1x` which network to put the device into if the device cannot do dot1x. default is null (i.e. not allowed)
inter_switch_link:
type: boolean
description: Used together with "isolation" under networks for links between Juniper devices; must be applied to both connected ports
default: false
mac_auth_only:
type: boolean
description: Only if `enable_mac_auth`==`true`, whether to use MAC authentication without 802.1X
mac_auth_preferred:
type: boolean
description: Only if `enable_mac_auth`==`true` + `mac_auth_only`==`false`, dot1x will be given priority then mac_auth. Enable this to prefer mac_auth over dot1x.
mac_auth_protocol:
allOf:
- $ref: '#/components/schemas/switch_port_local_usage_mac_auth_protocol2'
- description: 'Only if `enable_mac_auth`==`true`, MAC authentication protocol to use. enum: `eap-md5`, `eap-peap`, `pap`.'
mac_limit:
minimum: 0
type: integer
description: Max number of MAC addresses, default is 0 for unlimited, otherwise range is 1 or higher, with upper bound constrained by platform
contentEncoding: int32
default: 0
mode:
allOf:
- $ref: '#/components/schemas/switch_port_local_usage_mode2'
- description: 'Switching mode for this local port configuration. enum: `access`, `inet`, `trunk`.'
mtu:
type: integer
description: Media maximum transmission unit (MTU) is the largest data unit that can be forwarded without fragmentation. The default value is 1514.
contentEncoding: int32
networks:
type: array
items:
type: string
description: Only if `mode`==`trunk`, network or VLAN names to trunk
note:
type: string
description: Additional note for the port config override
examples:
- force 100M for camera
persist_mac:
type: boolean
description: Only if `mode`==`access` and `port_auth`!=`dot1x` whether the port should retain dynamically learned MAC addresses
default: false
poe_disabled:
type: boolean
description: Whether PoE capabilities are disabled for a port
default: false
port_auth:
allOf:
- oneOf:
- {}
- $ref: '#/components/schemas/switch_port_local_usage_dot1x2'
- description: '802.1X authentication mode for this local port configuration. enum: `dot1x`.'
port_network:
type: string
description: Native network/vlan for untagged traffic
reauth_interval:
anyOf:
- maximum: 65535
minimum: 10
type: integer
contentEncoding: int32
default: 3600
- type: string
description: Only if `port_auth`==`dot1x`, RADIUS reauthentication interval for clients on the port
server_fail_network:
type:
- string
- 'null'
description: Only if `port_auth`==`dot1x` sets server fail fallback vlan
server_reject_network:
type:
- string
- 'null'
description: Only if `port_auth`==`dot1x` when RADIUS server reject / fails
speed:
allOf:
- $ref: '#/components/schemas/junos_port_config_speed3'
- description: 'Link speed for this local port configuration. enum: `10m`, `100m`, `1g`, `2.5g`, `5g`, `10g`, `25g`, `40g`, `100g`, `auto`.'
storm_control:
allOf:
- $ref: '#/components/schemas/switch_port_local_usage_storm_control'
- description: Storm-control settings for this local port configuration
stp_edge:
type: boolean
description: When enabled, the port is not expected to receive BPDU frames
default: false
stp_no_root_port:
type: boolean
description: Whether STP should prevent this port from becoming a root port
default: false
stp_p2p:
type: boolean
description: Whether STP treats this port as a point-to-point link
default: false
usage:
type: string
description: Port usage profile name for this local port configuration
use_vstp:
type: boolean
description: If this is connected to a vstp network
default: false
voip_network:
type: string
description: Network/vlan for voip traffic, must also set port_network. to authenticate device, set port_auth
description: Per-port Switch Port Operator (SPO) override configuration used in `local_port_config` to customize settings inherited from `port_config`
junos_port_config:
title: junos_port_config
required:
- usage
type: object
properties:
ae_disable_lacp:
type: boolean
description: To disable LACP support for the AE interface
ae_idx:
type: integer
description: Users could force to use the designated AE name
contentEncoding: int32
ae_lacp_force_up:
type: boolean
description: 'If `aggregated`==`true`, sets the state of the interface as UP when the peer has limited LACP capability. Use case: When a device connected to this AE port is ZTPing for the first time, it will not have LACP configured on the other end. **Note:** Turning this on will enable force-up on one of the interfaces in the bundle only'
default: false
ae_lacp_passive:
type: boolean
description: If `aggregated`==`true`, sets LACP to passive mode on this AE interface; by default, active (fast) mode is used
default: false
ae_lacp_slow:
type: boolean
description: To use slow timeout
aggregated:
type: boolean
description: Whether this port is configured as an aggregated Ethernet member
default: false
critical:
type: boolean
description: To generate port up/down alarm
default: false
description:
type: string
description: Human-readable description for this Junos port
disable_autoneg:
type: boolean
description: If `speed` and `duplex` are specified, whether to disable autonegotiation
default: false
duplex:
allOf:
- $ref: '#/components/schemas/junos_port_config_duplex2'
- description: 'Link duplex mode for this Junos port. enum: `auto`, `full`, `half`.'
dynamic_usage:
type:
- string
- 'null'
description: Enable dynamic usage for this port. Set to `dynamic` to enable.
esilag:
type: boolean
description: Whether this Junos port participates in an ESI-LAG
mtu:
type: integer
description: Media maximum transmission unit (MTU) is the largest data unit that can be forwarded without fragmentation
contentEncoding: int32
default: 1514
networks:
type: array
items:
type: string
description: List of network names. Required if `usage`==`inet`
no_local_overwrite:
type: boolean
description: Prevent helpdesk to override the port config
default: true
poe_disabled:
type: boolean
description: Whether PoE capabilities are disabled for this Junos port
default: false
port_network:
type: string
description: Required if `usage`==`vlan_tunnel`. Q-in-Q tunneling using All-in-one bundling. This also enables standard L2PT for interfaces that are not encapsulation tunnel interfaces and uses MAC rewrite operation. [View more information](https://www.juniper.net/documentation/us/en/software/junos/multicast-l2/topics/topic-map/q-in-q.html#id-understanding-qinq-tunneling-and-vlan-translation)
speed:
allOf:
- $ref: '#/components/schemas/junos_port_config_speed1'
- description: 'Link speed for this Junos port. enum: `10m`, `100m`, `1g`, `2.5g`, `5g`, `10g`, `25g`, `40g`, `100g`, `auto`.'
usage:
type: string
description: Port usage name. For Q-in-Q, use `vlan_tunnel`. If EVPN is used, use `evpn_uplink`or `evpn_downlink`
description: Junos switch port configuration
junos_port_config_duplex:
title: junos_port_config_duplex
enum:
- auto
- full
- half
type: string
description: 'enum: `auto`, `full`, `half`'
junos_port_config_speed:
title: junos_port_config_speed
enum:
- 10m
- 100m
- 1g
- 2.5g
- 5g
- 10g
- 25g
- 40g
- 100g
- auto
type: string
description: 'enum: `100m`, `10m`, `1g`, `2.5g`, `5g`, `10g`, `25g`, `40g`, `100g`,`auto`'
l2tp_state:
title: l2tp_state
enum:
- established
- established_with_session
- idle
- wait-ctrl-conn
- wait-ctrl-reply
type: string
description: 'enum: `established`, `established_with_session`, `idle`, `wait-ctrl-conn`, `wait-ctrl-reply`'
examples:
- established
last_config_device_type:
title: last_config_device_type
enum:
- ap
- gateway
- switch
- mxedge
type: string
description: 'enum: `ap`, `gateway`, `mxedge`, `switch`'
last_trouble:
title: last_trouble
type: object
properties:
code:
type: string
description: Trouble code; definitions are listed at [List Ap Led Definition]($e/Constants%20Definitions/listApLedDefinition)
examples:
- '03'
timestamp:
type: number
description: Time when the last trouble code was reported
readOnly: true
description: Last trouble indicator reported by a switch
lat_lng:
title: lat_lng
required:
- lat
- lng
type: object
properties:
lat:
type: number
description: Geographic latitude in decimal degrees
examples:
- 37.295833
lng:
type: number
description: Geographic longitude in decimal degrees
examples:
- -122.032946
description: Geographic latitude and longitude coordinate pair
latlng_br:
title: latlng_br
type: object
properties:
lat:
type: string
description: Bottom-right latitude for the Google map bounds
lng:
type: string
description: Bottom-right longitude for the Google map bounds
description: When `type`==`google`, latitude and longitude of the bottom-right corner
latlng_tl:
title: latlng_tl
type: object
properties:
lat:
type: string
description: Top-left latitude for the Google map bounds
lng:
type: string
description: Top-left longitude for the Google map bounds
description: When `type`==`google`, latitude and longitude of the top-left corner
license:
title: license
type: object
properties:
amendments:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/license_amendment'
description: Read-only license amendments associated with the organization
readOnly: true
entitled:
type: object
additionalProperties:
type: integer
format: int32
description: Property key is license type (e.g. SUB-MAN) and Property value is the number of licenses entitled.
readOnly: true
fully_loaded:
type: object
additionalProperties:
type: integer
format: int32
description: Maximum license demand by service if all organization devices use each service
readOnly: true
licenses:
type: array
items:
$ref: '#/components/schemas/license_sub'
description: Read-only license subscriptions for the organization
summary:
type: object
additionalProperties:
type: integer
format: int32
description: Current license consumption by license type
readOnly: true
usages:
type: object
additionalProperties:
type: integer
format: int32
description: Available license counts by service
readOnly: true
description: Organization license entitlement, subscription, and usage summary
license_amendment:
title: license_amendment
type: object
properties:
created_time:
type: number
description: Timestamp when the license amendment was created
readOnly: true
end_time:
type: integer
description: End time of the license amendment
contentEncoding: int32
readOnly: true
id:
type: string
description: Unique identifier of the license amendment
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
modified_time:
type: number
description: Timestamp when the license amendment was last modified
readOnly: true
quantity:
type: integer
description: License quantity associated with this amendment
contentEncoding: int32
readOnly: true
start_time:
type: integer
description: Start time of the license amendment
contentEncoding: int32
readOnly: true
subscription_id:
type: string
description: Subscription identifier associated with this amendment
readOnly: true
type:
type: string
description: License type affected by this amendment
readOnly: true
description: Read-only change applied to a license subscription
license_sub:
title: license_sub
type: object
properties:
created_time:
type: number
description: Timestamp when the license subscription was created
readOnly: true
end_time:
type: integer
description: End date of the license term
contentEncoding: int32
readOnly: true
id:
type: string
description: Unique identifier of the license subscription
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
modified_time:
type: number
description: Timestamp when the license subscription was last modified
readOnly: true
order_id:
type: string
description: Order identifier for this license subscription
readOnly: true
org_id:
type: string
description: Organization that owns this license subscription
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
quantity:
type: integer
description: Number of devices entitled for this license
contentEncoding: int32
readOnly: true
remaining_quantity:
type: integer
description: Number of licenses left in this subscription
contentEncoding: int32
start_time:
type: integer
description: Start date of the license term
contentEncoding: int32
readOnly: true
subscription_id:
type: string
description: Subscription identifier for this license subscription
readOnly: true
type:
type: string
description: License type for this subscription
readOnly: true
description: Read-only license subscription record
license_usage_org:
title: license_usage_org
required:
- num_devices
- site_id
- usages
type: object
properties:
for_site:
type: boolean
description: Whether this license usage record is scoped to a site
readOnly: true
fully_loaded:
type: object
additionalProperties:
type: integer
format: int32
description: Maximum license demand by service if all organization devices use each service
readOnly: true
num_devices:
type: integer
description: Number of devices counted in this license usage scope
contentEncoding: int32
readOnly: true
site_id:
type: string
description: Site associated with this license usage record
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
summary:
type: object
additionalProperties:
type: integer
format: int32
description: Current license consumption by license type for this usage scope
readOnly: true
usages:
type: object
additionalProperties:
type: integer
format: int32
description: Available license counts by service for this usage scope
readOnly: true
description: License usage record for an organization usage scope
license_usage_site:
title: license_usage_site
required:
- org_entitled
- svna_enabled
- trial_enabled
- usages
- vna_eligible
- vna_ui
- wvna_eligible
type: object
properties:
org_entitled:
type: object
additionalProperties:
type: integer
format: int32
description: Organization-level license entitlements available to this site
examples:
- SUB-LOC: 30
SUB-MAN: 60
svna_enabled:
type: boolean
description: Eligibility for the Switch SLE
trial_enabled:
type: boolean
description: Whether trial licensing is enabled for the site
usages:
type: object
additionalProperties:
type: integer
format: int32
description: License usage counts by subscription type for this site
examples:
- SUB-LOC: 30
SUB-MAN: 60
vna_eligible:
type: boolean
description: Eligibility for the AP/Client SLE
vna_ui:
type: boolean
description: If True, Conversational Assistant and Marvis Action available
wvna_eligible:
type: boolean
description: Eligibility for the WAN SLE
description: Site license usage and entitlement response
list_msp_logs_sort:
title: list_msp_logs_sort
enum:
- -timestamp
- admin_id
- site_id
- timestamp
type: string
description: 'enum: `-timestamp`, `admin_id`, `site_id`, `timestamp`'
list_org_logs_sort:
title: list_org_logs_sort
enum:
- -timestamp
- admin_id
- site_id
- timestamp
type: string
description: 'enum: `-timestamp`, `admin_id`, `site_id`, `timestamp`'
locate_switch:
title: locate_switch
type: object
properties:
duration:
maximum: 120
minimum: 1
type: integer
description: Minutes the leds should keep flashing
contentEncoding: int32
default: 5
mac:
type: string
description: For virtual chassis, the MAC of the member
examples:
- f01c2d4ff760
description: Request body for locating a switch or virtual chassis member by MAC address for a limited duration
log_event:
title: log_event
required:
- message
- org_id
- timestamp
type: object
properties:
admin_id:
type:
- string
- 'null'
description: Admin user identifier associated with the log event
contentEncoding: uuid
readOnly: true
admin_name:
type:
- string
- 'null'
description: Name of the admin that performs the action
readOnly: true
after:
type: object
description: field values after the change
readOnly: true
before:
type: object
description: field values prior to the change
readOnly: true
device_id:
type:
- string
- 'null'
description: Device identifier associated with the log event
contentEncoding: uuid
readOnly: true
for_site:
type: boolean
description: Whether this log event is scoped to a site
readOnly: true
id:
type: string
description: Unique identifier of the log event
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
message:
type: string
description: Human-readable log message describing the event
readOnly: true
org_id:
type: string
description: Organization associated with the log event
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
site_id:
type:
- string
- 'null'
description: Site associated with the log event, if any
contentEncoding: uuid
readOnly: true
src_ip:
type: string
description: sender source IP address
timestamp:
type: number
description: Time when the log event occurred
readOnly: true
description: Audit log event recorded for an organization or site
login:
title: login
required:
- email
- password
type: object
properties:
email:
type: string
description: Administrator email address used to log in
examples:
- test@mistsys.com
password:
type: string
description: Administrator password used to log in
examples:
- foryoureyesonly
two_factor:
type: string
description: Optional two-factor authentication code for the login request
examples:
- '123456'
description: Login request using email/password and an optional two-factor code
login_failures:
title: login_failures
type: object
properties:
email:
type: string
description: User email address for the failed login attempts
examples:
- admin@test.com
last_failure_at:
type: integer
description: Time of the most recent failed login attempt
contentEncoding: int32
examples:
- 1509161968
num_attempts:
type: integer
description: Number of failed login attempts
contentEncoding: int32
examples:
- 1
src_ips:
type: array
items:
type: string
description: Source IP addresses observed for failed login attempts
examples:
- - 192.168.1.39
- 192.168.1.38
- 192.168.1.37
user_agents:
type: array
items:
type: string
description: User-Agent strings observed for failed login attempts
examples:
- - Test UA 39
- Test UA 38
- Test UA 37
description: Failed login attempt summary with source IPs and user agents
mac_addresses:
title: mac_addresses
required:
- macs
type: object
properties:
macs:
minItems: 1
uniqueItems: true
type: array
items:
type: string
description: List of MAC addresses included in the request
examples:
- - 683b679ac024
description: Request containing one or more MAC addresses
mac_table_stats:
title: mac_table_stats
type: object
properties:
mac_table_count:
type: integer
description: Number of learned MAC table entries currently present
contentEncoding: int32
max_mac_entries_supported:
type: integer
description: Maximum number of MAC table entries supported
contentEncoding: int32
description: MAC table capacity and usage statistics
map:
title: map
type: object
properties:
created_time:
type: number
description: Timestamp when the map was created
readOnly: true
flags:
type: object
additionalProperties:
type: integer
format: int32
description: Name/val pair objects for location engine to use
readOnly: true
examples:
- assetHoldTime: 5
storeTime: 10
for_site:
type: boolean
description: Whether this map belongs to a site scope
readOnly: true
geofences:
type: array
items:
$ref: '#/components/schemas/map_geofence'
description: Location boundary definitions configured on this map
group_idx:
type: integer
description: Optional floor or group ordering index for this map
contentEncoding: int32
examples:
- 1
group_name:
type: string
description: Optional floor or group display name for this map
examples:
- East Wing
height:
type: integer
description: When `type`==`image`, height of the map image in pixels
contentEncoding: int32
examples:
- 1500
height_m:
type: number
description: Physical height of the map in meters
id:
type: string
description: Unique identifier of the map
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
latlng_br:
allOf:
- $ref: '#/components/schemas/latlng_br1'
- description: When `type`==`google`, bottom-right map bounds coordinate
latlng_tl:
allOf:
- $ref: '#/components/schemas/latlng_tl1'
- description: When `type`==`google`, top-left map bounds coordinate
locked:
type: boolean
description: Whether this map is considered locked down
default: false
modified_time:
type: number
description: Timestamp when the map was last modified
readOnly: true
name:
type: string
description: The name of the map
examples:
- Mist Office
occupancy_limit:
type: integer
description: Maximum occupancy configured for this map
contentEncoding: int32
org_id:
type: string
description: Organization associated with this map
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
orientation:
maximum: 359
minimum: 0
type: integer
description: Map orientation in degrees; 0 means up is north, 90 means up is west
contentEncoding: int32
default: 0
examples:
- 30
origin_x:
type: integer
description: User-annotated X origin, pixels
contentEncoding: int32
examples:
- 35
origin_y:
type: integer
description: User-annotated Y origin, pixels
contentEncoding: int32
examples:
- 60
ppm:
type: number
description: When `type`==`image`, pixels per meter for the map image
examples:
- 40.94
site_id:
type: string
description: Site associated with this map, when scoped to a site
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
sitesurvey_path:
minItems: 0
type: array
items:
$ref: '#/components/schemas/map_sitesurvey_path_items'
description: Site survey path geometry for this map
thumbnail_url:
type: string
description: When `type`==`image`, URL for the thumbnail image or preview
readOnly: true
examples:
- https://url/to/image.png
type:
allOf:
- $ref: '#/components/schemas/map_type2'
- description: Map type, such as `image` or `google`
examples:
- image
url:
type: string
description: When `type`==`image`, URL for the map image
readOnly: true
examples:
- https://url/to/image.png
view:
allOf:
- oneOf:
- {}
- $ref: '#/components/schemas/map_view2'
- description: 'If `type`==`google`, map tile view to display. enum: `hybrid`, `roadmap`, `satellite`, `terrain`.'
wall_path:
allOf:
- $ref: '#/components/schemas/map_wall_path2'
- description: Wall path geometry for this map
wayfinding:
allOf:
- $ref: '#/components/schemas/map_wayfinding2'
- description: Navigation pathfinding settings for this map
wayfinding_path:
allOf:
- $ref: '#/components/schemas/map_wayfinding_path2'
- description: Wayfinding path geometry for this map
width:
type: integer
description: When `type`==`image`, width of the map image in pixels
contentEncoding: int32
examples:
- 1250
width_m:
type: number
description: Physical width of the map in meters
description: Map or floorplan metadata for a site or organization
map_geofence:
title: map_geofence
type: object
properties:
name:
type: string
description: Display name for the map geofence
examples:
- example
vertices:
type: array
items:
$ref: '#/components/schemas/map_geofence_vertice'
description: Polygon points that define the geofence boundary
description: Geofence drawn on a map
map_geofence_vertice:
title: map_geofence_vertice
type: object
properties:
X:
type: number
description: Geofence vertex X coordinate in map units
examples:
- 700
Y:
type: number
description: Geofence vertex Y coordinate in map units
examples:
- 100
description: Vertex coordinate for a map geofence polygon
map_import_json:
title: map_import_json
required:
- vendor_name
type: object
properties:
import_all_floorplans:
type: boolean
description: Whether to import all floorplans from the uploaded map JSON
default: false
import_height:
type: boolean
description: Whether to import height metadata from the uploaded map JSON
default: true
import_orientation:
type: boolean
description: Whether to import orientation metadata from the uploaded map JSON
default: true
vendor_name:
allOf:
- $ref: '#/components/schemas/map_import_json_vendor_name2'
- description: 'Map import vendor for the uploaded JSON. enum: `ekahau`, `ibwave`.'
examples:
- ekahau
description: Options for importing map data from Ekahau or iBwave JSON
map_import_json_vendor_name:
title: map_import_json_vendor_name
enum:
- ekahau
- ibwave
type: string
description: 'Map import vendor for the uploaded JSON. enum: `ekahau`, `ibwave`'
examples:
- ekahau
map_jibestream:
title: map_jibestream
required:
- client_id
- client_secret
- customer_id
- endpoint_url
- map_id
- mmpp
- ppm
- vendor_name
- venue_id
type: object
properties:
client_id:
type: string
description: Client identifier for the Jibestream API
contentEncoding: uuid
examples:
- 199d6770-0f6f-407a-9bd5-fc33c7840194
client_secret:
type: string
description: Client secret for the Jibestream API
contentEncoding: password
examples:
- /9Nog3yDzcYj0bY91XJZQLCt+m9DXaIVhx+Ghk3ddd
customer_id:
type: integer
description: Jibestream customer record id
contentEncoding: int32
examples:
- 123
endpoint_url:
type: string
description: Map contents endpoint host
examples:
- https://api.jibestream.com
map_id:
type: string
description: Jibestream map identifier to import
contentEncoding: uuid
examples:
- b069b358-4c97-5319-1f8c-7c5ca64d6ab1
mmpp:
type: integer
description: Millimeters per pixel for the Jibestream map
contentEncoding: int32
examples:
- 223
ppm:
type: number
description: Pixel per meter, same as the map JSON value.
examples:
- 4
vendor_name:
const: jibestream
type: string
description: Vendor identifier for a Jibestream import
venue_id:
type: integer
description: Venue or organization id
contentEncoding: int32
examples:
- 123
description: Jibestream map import configuration
map_jibestream_vendor_name:
title: map_jibestream_vendor_name
const: jibestream
type: string
description: 'The vendor ‘jibestream’. enum: `jibestream`'
map_micello:
title: map_micello
required:
- account_key
- default_level_id
- map_id
- vendor_name
type: object
properties:
account_key:
type: string
description: Account key that has access to the map
default_level_id:
type: integer
description: Micello default floor or level identifier
contentEncoding: int32
examples:
- 5
map_id:
type: string
description: Micello map identifier to import
contentEncoding: uuid
examples:
- 6f4bf402-45f9-2a56-6c8b-7f83d3bc98e9
vendor_name:
const: micello
type: string
description: Vendor identifier for a Micello import
description: Micello map import configuration
map_micello_vendor_name:
title: map_micello_vendor_name
const: micello
type: string
description: 'The vendor ‘micello’. enum: `micello`'
map_node:
title: map_node
required:
- name
type: object
properties:
edges:
type: object
additionalProperties:
type: string
description: Adjacent node IDs and path weights for this map node
examples:
- N1: '1'
name:
type: string
description: Map node identifier or display name
examples:
- N1
position:
allOf:
- $ref: '#/components/schemas/map_node_position2'
- description: Coordinates of this map node
description: Node in a map path graph
map_node_position:
title: map_node_position
required:
- x
- y
type: object
properties:
x:
type: number
description: Horizontal coordinate of the map node
examples:
- 746
y:
type: number
description: Vertical coordinate of the map node
examples:
- 104
description: Position of a map path node
map_org_import_file:
title: map_org_import_file
type: object
properties:
auto_deviceprofile_assignment:
type: boolean
description: Whether to auto assign device to deviceprofile by name
examples:
- true
csv:
type: string
description: Optional AP name-mapping CSV file
contentEncoding: base64
file:
type: string
description: Ekahau or iBwave floorplan file to import
contentEncoding: base64
json:
allOf:
- $ref: '#/components/schemas/map_org_import_file_json2'
- description: Import options for the organization map file
description: Multipart payload for importing map files at organization scope
map_org_import_file_json:
title: map_org_import_file_json
required:
- vendor_name
type: object
properties:
import_all_floorplans:
type: boolean
description: Whether to import all floorplans from the uploaded map file
default: false
import_height:
type: boolean
description: Whether to import height metadata from the uploaded map file
default: true
import_orientation:
type: boolean
description: Whether to import orientation metadata from the uploaded map file
default: true
site_id:
type: string
description: Target site for imported floorplans, when specified
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
vendor_name:
allOf:
- $ref: '#/components/schemas/map_org_import_file_json_vendor_name2'
- description: 'Map import vendor for the uploaded file. enum: `ekahau`, `ibwave`.'
examples:
- ekahau
description: Options for importing map files at organization scope
map_org_import_file_json_vendor_name:
title: map_org_import_file_json_vendor_name
enum:
- ekahau
- ibwave
type: string
description: 'Map import vendor for the uploaded file. enum: `ekahau`, `ibwave`'
examples:
- ekahau
map_site_import_file:
title: map_site_import_file
type: object
properties:
auto_deviceprofile_assignment:
type: boolean
description: Whether to auto assign device to deviceprofile by name
examples:
- true
csv:
type: string
description: Optional AP name-mapping CSV file
contentEncoding: base64
file:
type: string
description: Ekahau or iBwave floorplan file to import
contentEncoding: base64
json:
allOf:
- $ref: '#/components/schemas/map_import_json1'
- description: Import options for the site map file
description: Multipart payload for importing map files at site scope
map_site_replace_file:
title: map_site_replace_file
required:
- file
type: object
properties:
file:
type: string
description: Map image file used to replace the existing site map
contentEncoding: base64
json:
allOf:
- $ref: '#/components/schemas/map_site_replace_file_json2'
- description: Replacement transform options for the map image
description: Multipart payload for replacing a site map image
map_site_replace_file_json:
title: map_site_replace_file_json
type: object
properties:
transform:
allOf:
- $ref: '#/components/schemas/map_site_replace_file_json_transform2'
- description: Coordinate transform to apply when replacing the map image
description: Options for replacing a site map image
map_site_replace_file_json_transform:
title: map_site_replace_file_json_transform
type: object
properties:
rotation:
type: number
description: Whether to rotate the replacing image, in degrees
default: 0
scale:
type: number
description: Whether to scale the replacing image
default: 1
examples:
- 0.98
x:
type: number
description: Where the (0, 0) of the new image is relative to the original map
default: 0
examples:
- 3.16
y:
type: number
description: Where the (0, 0) of the new image is relative to the original map
default: 0
examples:
- 12
description: If `transform` is provided, all the locations of the objects on the map (AP, Zone, Vbeacon, Beacon) will be transformed as well (relative to the new Map)
map_sitesurvey_path_items:
title: map_sitesurvey_path_items
type: object
properties:
coordinate:
type: string
description: Site survey path coordinate space
examples:
- actual
id:
type: string
description: Unique identifier of the site survey path
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
name:
type: string
description: Display name of the site survey path
examples:
- Default
nodes:
minItems: 0
type: array
items:
$ref: '#/components/schemas/map_node'
description: Path nodes included in the site survey path
description: Site survey path definition on a map
map_type:
title: map_type
enum:
- google
- image
type: string
description: 'Map type, such as `image` or `google`. enum: `google`, `image`'
examples:
- image
map_view:
title: map_view
enum:
- hybrid
- roadmap
- satellite
- terrain
type: string
description: 'if `type`==`google`. enum: `hybrid`, `roadmap`, `satellite`, `terrain`'
map_wall_path:
title: map_wall_path
type: object
properties:
coordinate:
type: string
description: Wall path coordinate space
examples:
- actual
nodes:
minItems: 0
type: array
items:
$ref: '#/components/schemas/map_node'
description: Path nodes that define the wall geometry
description: JSON blob for wall definition (same format as wayfinding_path)
map_wayfinding:
title: map_wayfinding
type: object
properties:
micello:
allOf:
- $ref: '#/components/schemas/map_wayfinding_micello2'
- description: External Micello wayfinding integration settings for this map
snap_to_path:
type: boolean
description: Whether wayfinding should snap routes to configured paths
description: Properties related to wayfinding
map_wayfinding_micello:
title: map_wayfinding_micello
type: object
properties:
account_key:
type: string
description: Micello account key used for wayfinding
examples:
- adasdf
default_level_id:
type: integer
description: Default Micello floor or level identifier for wayfinding
contentEncoding: int32
examples:
- 5
map_id:
type: string
description: Micello map identifier used for wayfinding
examples:
- c660f81dd250c
description: Micello wayfinding integration settings
map_wayfinding_path:
title: map_wayfinding_path
type: object
properties:
coordinate:
type: string
description: Wayfinding path coordinate space
examples:
- actual
nodes:
minItems: 0
type: array
items:
$ref: '#/components/schemas/map_node'
description: Path nodes used for wayfinding routes
description: JSON blob for wayfinding (using Dijkstra’s algorithm)
mapstack:
title: mapstack
type: object
properties:
name:
type: string
description: The name of the map stack
examples:
- Board Room
description: Map Stack filter or creation payload
mapstack_response:
title: mapstack_response
type: object
properties:
created_time:
type: number
description: Timestamp when the map stack was created
readOnly: true
id:
type: string
description: Unique identifier of the map stack
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
modified_time:
type: number
description: Timestamp when the map stack was last modified
readOnly: true
name:
type: string
description: The name of the map stack
examples:
- Board Room
org_id:
type: string
description: Organization associated with the map stack
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
site_id:
type: string
description: Site associated with the map stack
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
description: Map Stack response object
marvis:
title: marvis
type: object
properties:
auto_operations:
allOf:
- $ref: '#/components/schemas/marvis_auto_operations2'
- description: Automatic remediation operations controlled by Marvis
description: Marvis automation and client settings
marvis_auto_operations:
title: marvis_auto_operations
type: object
properties:
ap_insufficient_capacity:
type: boolean
description: Whether Marvis may remediate AP insufficient-capacity issues automatically
default: false
ap_loop:
type: boolean
description: Whether Marvis may remediate AP loop issues automatically
default: false
ap_non_compliant:
type: boolean
description: Whether Marvis may remediate AP non-compliance automatically
default: false
bounce_port_for_abnormal_poe_client:
type: boolean
description: Whether Marvis may bounce switch ports for abnormal PoE clients
default: false
disable_port_when_ddos_protocol_violation:
type: boolean
description: Whether Marvis may disable a port when DDOS protocol violations are detected
default: false
disable_port_when_rogue_dhcp_server_detected:
type: boolean
description: Whether Marvis may disable a port when a rogue DHCP server is detected
default: false
gateway_non_compliant:
type: boolean
description: Whether Marvis may remediate non-compliant gateways automatically
default: false
switch_misconfigured_port:
type: boolean
description: Whether Marvis may remediate misconfigured switch ports automatically
default: false
switch_port_stuck:
type: boolean
description: Whether Marvis may remediate stuck switch ports automatically
default: false
description: Marvis automatic remediation operation toggles
marvis_client:
title: marvis_client
type: object
properties:
disabled:
type: boolean
description: Whether this Marvis Client profile is disabled
default: false
enrollment_url:
type: string
description: In MDM, add `--enrollment_url ` to the install command
readOnly: true
examples:
- marvisclient://api.mist.com/path/to/url
id:
type: string
description: Unique identifier of the Marvis Client profile
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
location:
allOf:
- $ref: '#/components/schemas/marvis_client_location2'
- description: Client location collection settings for Marvis Client
name:
type: string
description: Display name for the Marvis Client profile
examples:
- Handhelds
synthetic_test:
allOf:
- $ref: '#/components/schemas/marvis_client_synthetic_test'
- description: Synthetic test settings for Marvis Client
telemetry:
allOf:
- $ref: '#/components/schemas/marvis_client_telemetry2'
- description: Client telemetry collection settings for Marvis Client
description: Marvis Client configuration profile
marvis_client_event:
title: marvis_client_event
type: object
properties:
band:
type: string
description: Wi-Fi band at the time of the event
bssid:
type: string
description: BSSID the client roamed to (for roam events)
channel:
type: integer
description: Channel the client roamed to (for roam events)
contentEncoding: int32
device_id:
type: string
description: UUID of the device the Marvis Client is installed on
contentEncoding: uuid
hostname:
type: string
description: Device hostname
location:
allOf:
- $ref: '#/components/schemas/stats_marvis_client_location1'
- description: Last known device location
neighbor_ap_report:
type: array
items:
$ref: '#/components/schemas/marvis_client_event_neighbor_ap'
description: List of neighboring APs observed at the time of the event
org_id:
type: string
description: Organization UUID
contentEncoding: uuid
percent:
type: integer
description: Battery level percentage at the time of the event (for battery events)
contentEncoding: int32
pre_bssid:
type: string
description: BSSID the client roamed from (for roam events)
pre_channel:
type: integer
description: Channel the client roamed from (for roam events)
contentEncoding: int32
pre_rssi:
type: integer
description: RSSI before the roam event, in dBm
contentEncoding: int32
rssi:
type: integer
description: Wi-Fi RSSI at the time of the event, in dBm
contentEncoding: int32
ssid:
type: string
description: SSID the client was connected to
timestamp:
type: integer
description: Event timestamp, in epoch seconds
contentEncoding: int32
type:
type: string
description: Event type
wifi_ip:
type: string
description: Device Wi-Fi IP address at the time of the event
wifi_mac:
type: string
description: Device Wi-Fi MAC address
description: A Marvis Client event record
marvis_client_event_neighbor_ap:
title: marvis_client_event_neighbor_ap
type: object
properties:
band:
type: string
description: Wi-Fi band the AP is operating on
bssid:
type: string
description: BSSID of the neighboring AP
channel:
type: integer
description: Channel the neighboring AP is on
contentEncoding: int32
rssi:
type: integer
description: RSSI of the neighboring AP signal, in dBm
contentEncoding: int32
description: A neighboring AP observed in a Marvis Client event
marvis_client_events_search:
title: marvis_client_events_search
type: object
properties:
limit:
type: integer
description: Maximum number of results requested
contentEncoding: int32
results:
type: array
items:
$ref: '#/components/schemas/marvis_client_event'
description: List of Marvis Client events
total:
type: integer
description: Total number of matching results
contentEncoding: int32
description: Paginated list of Marvis Client events
marvis_client_insights:
title: marvis_client_insights
type: object
properties:
avg_battery:
type: array
items:
type: number
description: Average battery level per interval bucket
avg_cellular_rssi:
type: array
items:
type: number
description: Average cellular RSSI per interval bucket, in dBm
avg_cpu:
type: array
items:
type: number
description: Average CPU utilization per interval bucket (0–100)
avg_memory:
type: array
items:
type: number
description: Average memory utilization per interval bucket (0–100)
avg_wifi_rssi:
type: array
items:
type: number
description: Average Wi-Fi RSSI per interval bucket, in dBm
end:
type: integer
description: End of the reporting window, in epoch seconds
contentEncoding: int32
interval:
type: integer
description: Duration of each interval bucket, in seconds
contentEncoding: int32
limit:
type: integer
description: Maximum number of results requested
contentEncoding: int32
page:
type: integer
description: Current page number
contentEncoding: int32
rt:
type: array
items:
type: string
description: List of ISO 8601 timestamp strings for each interval bucket
start:
type: integer
description: Start of the reporting window, in epoch seconds
contentEncoding: int32
description: Time-series performance metrics for a Marvis Client device
marvis_client_location:
title: marvis_client_location
type: object
properties:
enabled:
type: boolean
description: Whether location collection is enabled for Marvis Client
description: Location collection settings for Marvis Client
marvis_client_synthetic_test:
title: marvis_client_synthetic_test
type: object
properties:
enabled:
type: boolean
description: Whether synthetic testing is enabled for Marvis Client
description: Synthetic test settings for Marvis Client
marvis_client_telemetry:
title: marvis_client_telemetry
type: object
properties:
enabled:
type: boolean
description: Whether telemetry collection is enabled for Marvis Client
description: "Note: some stats are not collected when it's not connected to Mist infrastructure"
marvis_config_action:
title: marvis_config_action
type: object
properties:
admin_id:
type: string
description: Admin UUID associated with the config action
contentEncoding: uuid
id:
type: string
description: UUID of the config action
contentEncoding: uuid
mac:
type: string
description: Device MAC address
op:
type: string
description: Operation type (e.g. disable_port, enable_port, update_mtu, add_vlans_to_port)
org_id:
type: string
description: Organization UUID
contentEncoding: uuid
port_id:
type: string
description: Port identifier (e.g. ge-0/0/13)
reason:
type: string
description: Reason for the config action (e.g. rogue_dhcp_server_detected)
site_id:
type: string
description: Site UUID
contentEncoding: uuid
src:
type: string
description: Source of the config action (e.g. marvis)
timestamp:
type: number
description: Timestamp when the config action was recorded, in epoch seconds
type:
type: string
description: Config type (e.g. wired)
vlan_ids:
type: array
items:
type: integer
contentEncoding: int32
description: List of VLAN IDs involved in the config action
description: A Marvis-injected config action record
marvis_config_actions_search:
title: marvis_config_actions_search
type: object
properties:
end:
type: integer
description: Search window end timestamp, in epoch seconds
contentEncoding: int32
limit:
type: integer
description: Maximum number of results requested
contentEncoding: int32
results:
type: array
items:
$ref: '#/components/schemas/marvis_config_action'
description: List of Marvis config actions
start:
type: integer
description: Search window start timestamp, in epoch seconds
contentEncoding: int32
total:
type: integer
description: Total number of matching results
contentEncoding: int32
description: Paginated list of Marvis config actions
marvis_config_feedback:
title: marvis_config_feedback
type: object
properties:
note:
type: string
description: Free-text note about the feedback
type:
allOf:
- $ref: '#/components/schemas/marvis_config_feedback_type'
- description: 'Feedback type. enum: `invalid`'
description: Feedback submission for a Marvis config action
marvis_config_feedback_response:
title: marvis_config_feedback_response
type: object
properties:
feedback_note:
type: string
description: The note provided with the feedback
feedback_type:
type: string
description: The feedback type that was submitted
description: Response after submitting feedback on a Marvis config action
marvis_config_feedback_type:
title: marvis_config_feedback_type
const: invalid
type: string
description: 'Feedback type. enum: `invalid`'
marvis_self_driving:
title: marvis_self_driving
type: object
properties:
wan:
allOf:
- $ref: '#/components/schemas/marvis_self_driving_domain4'
- description: Self-driving automation settings for the WAN domain
wired:
allOf:
- $ref: '#/components/schemas/marvis_self_driving_domain1'
- description: Self-driving automation settings for the wired domain
wireless:
allOf:
- $ref: '#/components/schemas/marvis_self_driving_domain2'
- description: Self-driving automation settings for the wireless domain
description: Self-driving network automation settings per domain
marvis_self_driving_domain:
title: marvis_self_driving_domain
type: object
properties:
enabled:
type: boolean
description: Whether self-driving automation is enabled for this domain
default: false
description: Self-driving automation settings for one Marvis domain
memory_stat:
title: memory_stat
required:
- usage
type: object
properties:
usage:
type: number
description: Current memory utilization percentage for the device or master Routing Engine
description: Memory utilization statistics for a device; in a virtual chassis, this reports the master Routing Engine
mfa_secret_type:
title: mfa_secret_type
const: qrcode
type: string
description: 'MFA secret representation format for enrollment. enum: `qrcode`'
mist_nacedge:
title: mist_nacedge
type: object
properties:
auth_ttl:
maximum: 2592000
minimum: 60
type: integer
description: Cache of last auth result; in seconds
contentEncoding: int32
default: 604800
caching_site_ids:
type: array
items:
type: string
contentEncoding: uuid
description: List of site UUIDs whose auth requests should be cached by NAC Edges assigned to this site
examples:
- - 4ac1dcf4-9d8b-7910-ac87-6ad873648a5c
- 7dc1acf4-9d8b-7910-ac87-6ad873648a5c
default_dot1x_vlan:
type: string
description: Default vlan for all dot1x devices, if different from default_vlan
examples:
- '20'
default_vlan:
type: string
description: Default vlan to assign for devices not in the cache
examples:
- test_vlan
enabled:
type: boolean
description: Whether Mist Site Survivability is enabled for the site
mxedge_hosts:
type: array
items:
type: string
description: NAC Edge hostnames used for the Site Survivability feature
examples:
- - mxedge1.local
description: Mist NAC Site Survivability settings for the site
ml_overwrite_additional_properties:
title: ml_overwrite_additional_properties
type: object
properties:
int:
type: integer
description: Location ML intercept value to use for the model
contentEncoding: int32
ple:
type: integer
description: Path-loss estimate value to use for the location machine learning model
contentEncoding: int32
description: Location machine learning parameter overwrite values for one client model
module_stat_item_errors_items:
title: module_stat_item_errors_items
required:
- since
- type
type: object
properties:
feature:
type: string
description: Affected feature associated with this module error condition
examples:
- Mist-Management
minimum_version:
type: string
description: Minimum software version associated with this module error
examples:
- 128T-6.0.0-1
reason:
type: string
description: Human-readable reason for the module error condition
since:
type: integer
description: Epoch timestamp when the module error condition began
contentEncoding: int32
examples:
- 1657497600
type:
type: string
description: Module error type code reported by the device
examples:
- FW_UPGRADE_REQUIRED_BY_FEATURE
description: Error condition reported for a device module
module_stat_item_fans_items:
title: module_stat_item_fans_items
type: object
properties:
airflow:
type: string
description: Direction of airflow reported for the fan
examples:
- out
name:
type: string
description: Fan label reported by the device
examples:
- Fan 0
rpm:
type: integer
description: Current fan speed in revolutions per minute
contentEncoding: int32
status:
type: string
description: Operational status reported for the fan
examples:
- ok
description: Cooling fan telemetry for a device module
module_stat_item_network_resource:
title: module_stat_item_network_resource
type: object
properties:
count:
minimum: 0
type: integer
description: Current utilization count for the network resource
contentEncoding: int32
examples:
- 17
limit:
minimum: 0
type: integer
description: Maximum supported count for the network resource
contentEncoding: int32
examples:
- 768000
type:
type: string
description: Network resource category, such as FIB or FLOW
examples:
- FIB
description: Network resource usage counter reported by a device module
module_stat_item_pics_item:
title: module_stat_item_pics_item
type: object
properties:
index:
type: integer
description: PIC index within the device module
contentEncoding: int32
model_number:
type: string
description: Model number reported for the PIC
port_groups:
type: array
items:
$ref: '#/components/schemas/module_stat_item_pics_item_port_groups_item'
description: Port groups provided by this PIC
description: Physical Interface Card summary for a device module
module_stat_item_pics_item_port_groups_item:
title: module_stat_item_pics_item_port_groups_item
type: object
properties:
count:
type: integer
description: Number of ports in this PIC port group
contentEncoding: int32
type:
type: string
description: Port media or interface type for this PIC port group
description: Port group summary for a PIC
module_stat_item_poe:
title: module_stat_item_poe
type: object
properties:
max_power:
type: number
description: Total PoE power budget available to the module, in watts
examples:
- 250
power_draw:
type: number
description: Current PoE power draw on the module, in watts
examples:
- 120.3
status:
type: string
description: Operational status of PoE on the module
description: Power over Ethernet telemetry for a device module
module_stat_item_psus_item:
title: module_stat_item_psus_item
type: object
properties:
name:
type: string
description: Power supply label reported by the device
examples:
- Power Supply 0
status:
type: string
description: Operational status reported for the power supply
examples:
- ok
description: Power supply status for a device module
module_stat_item_temperatures_item:
title: module_stat_item_temperatures_item
type: object
properties:
celsius:
type: number
description: Temperature reading for the sensor, in degrees Celsius
examples:
- 45
name:
type: string
description: Temperature sensor label reported by the device
examples:
- CPU
status:
type: string
description: Operational status reported for the temperature sensor
examples:
- ok
description: Temperature sensor reading for a device module
module_stat_item_vc_links_item:
title: module_stat_item_vc_links_item
type: object
properties:
neighbor_module_idx:
type: integer
description: Index of the neighboring module connected through this virtual chassis link
contentEncoding: int32
examples:
- 1
neighbor_port_id:
type: string
description: Port identifier on the neighboring module for this virtual chassis link
examples:
- vcp-255/1/0
port_id:
type: string
description: Local port identifier for this virtual chassis link
examples:
- vcp-255/1/0
description: Virtual chassis link endpoint for a device module
msp:
title: msp
type: object
properties:
allow_mist:
type: boolean
description: Whether Mist support access is allowed for this MSP account
created_time:
type: number
description: Timestamp when the MSP account was created
readOnly: true
id:
type: string
description: Unique identifier of the MSP account
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
logo_url:
type: string
description: For advanced tier (uMSPs) only
modified_time:
type: number
description: Timestamp when the MSP account was last modified
readOnly: true
name:
type: string
description: Display name of the MSP account
tier:
allOf:
- $ref: '#/components/schemas/msp_tier2'
- description: 'Service tier for the MSP account. enum: `advanced`, `base`.'
url:
type: string
description: For advanced tier (uMSPs) only
description: Managed service provider account
msp_license_action:
title: msp_license_action
required:
- op
type: object
properties:
amendment_id:
type: string
description: Required if `op`==`unamend`; identifies the license amendment to undo
dst_org_id:
type: string
description: Required if `op`==`amend`; destination org ID that receives the amended license quantity
contentEncoding: uuid
notes:
type: string
description: Required if `op`==`annotate`; note text to attach to the license action
op:
allOf:
- $ref: '#/components/schemas/msp_license_action_operation2'
- minLength: 1
description: 'License operation to perform for this MSP request. enum: `amend`, `annotate`, `delete`, `unamend`.'
quantity:
type: number
description: Required if `op`==`amend`; license quantity to move to the destination org
subscription_id:
minLength: 1
type: string
description: Required if `op`==`annotate`; subscription ID for the license action
description: License operation request for an MSP account
msp_license_action_operation:
title: msp_license_action_operation
enum:
- amend
- annotate
- delete
- unamend
type: string
description: 'enum: `amend`, `annotate`, `delete`, `unamend`'
msp_logo:
title: msp_logo
type: object
properties:
logo_url:
type: string
description: Public URL for the advanced-tier MSP logo image
description: Payload for uploading an advanced-tier MSP logo
msp_logs_count_distinct:
title: msp_logs_count_distinct
enum:
- admin_id
- admin_name
- message
- org_id
type: string
description: 'enum: `admin_id`, `admin_name`, `message`, `org_id`'
msp_marvis_suggestions_count_distinct:
title: msp_marvis_suggestions_count_distinct
enum:
- org_id
- status
type: string
description: 'Distinct field used when counting MSP Marvis suggestions. enum: `org_id`, `status`'
msp_org_change:
title: msp_org_change
required:
- op
- org_ids
type: object
properties:
op:
allOf:
- $ref: '#/components/schemas/msp_org_change_operation2'
- description: 'Assignment operation to apply to the listed org IDs. enum: `assign`, `unassign`.'
org_ids:
type: array
items:
type: string
description: List of org IDs to assign to or unassign from the MSP account
description: Request to assign or unassign orgs for an MSP account
msp_org_change_operation:
title: msp_org_change_operation
enum:
- assign
- unassign
type: string
description: 'Assignment operation to apply to the listed org IDs. enum: `assign`, `unassign`'
msp_search_type:
title: msp_search_type
const: orgs
type: string
description: 'Search result type returned by MSP organization search. enum: `orgs`'
msp_tickets_count_distinct:
title: msp_tickets_count_distinct
enum:
- org_id
- status
- type
type: string
description: 'enum: `org_id`, `status`, `type`'
msp_tier:
title: msp_tier
enum:
- advanced
- base
type: string
description: 'Service tier for the MSP account. enum: `advanced`, `base`'
mxcluster:
title: mxcluster
type: object
properties:
created_time:
type: number
description: Timestamp when the Mist Edge cluster was created
readOnly: true
for_site:
type: boolean
description: Whether this Mist Edge cluster is scoped to a site
readOnly: true
id:
type: string
description: Unique identifier of the Mist Edge cluster
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
mist_das:
allOf:
- $ref: '#/components/schemas/mxedge_das3'
- description: Dynamic authorization service settings for the cluster
mist_nac:
allOf:
- $ref: '#/components/schemas/mxcluster_nac3'
- description: NAC settings for the Mist Edge cluster
mist_nacedge:
allOf:
- $ref: '#/components/schemas/mxcluster_nacedge2'
- description: NAC Edge survivability settings for the cluster; requires `mist_nac` to be enabled
modified_time:
type: number
description: Timestamp when the Mist Edge cluster was last modified
readOnly: true
mxedge_mgmt:
allOf:
- $ref: '#/components/schemas/mxedge_mgmt5'
- description: Out-of-band management settings for Mist Edges in the cluster
name:
type: string
description: Display name of the Mist Edge cluster
org_id:
type: string
description: Identifier of the org that owns the Mist Edge cluster
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
proxy:
allOf:
- $ref: '#/components/schemas/proxy4'
- description: Network proxy settings used by Mist Edges in the cluster to communicate with the Mist Cloud
radsec:
allOf:
- $ref: '#/components/schemas/mxcluster_radsec3'
- description: TLS RADIUS proxy settings for the Mist Edge cluster
radsec_tls:
allOf:
- $ref: '#/components/schemas/mxcluster_radsec_tls2'
- description: TLS keypair settings for RadSec on the Mist Edge cluster
site_id:
type: string
description: Identifier of the site when the Mist Edge cluster is site-scoped
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
tunterm_ap_subnets:
type: array
items:
type: string
description: AP source subnets allowed to establish Mist tunnels
tunterm_dhcpd_config:
allOf:
- $ref: '#/components/schemas/tunterm_dhcpd_config2'
- description: DHCP relay or server settings for tunneled VLANs
tunterm_extra_routes:
type: object
additionalProperties:
$ref: '#/components/schemas/mxcluster_tunterm_extra_route'
description: Extra routes for Mist Tunnel VLAN traffic
tunterm_hosts:
type: array
items:
type: string
description: Hostnames or IP addresses used as Mist Tunnel peers
tunterm_hosts_order:
type: array
items:
type: integer
contentEncoding: int32
description: Explicit host ordering indexes used when ordered selection is configured
tunterm_hosts_selection:
allOf:
- $ref: '#/components/schemas/mxcluster_tunterm_hosts_selection2'
- description: 'Selection strategy for ordering tunnel termination hosts. enum: `ordered`, `shuffle`, `shuffle-by-site`.'
tunterm_monitoring:
type: array
items:
type: array
items:
$ref: '#/components/schemas/tunterm_monitoring_item'
description: Monitoring checks for tunnel termination reachability. Only for Org Mist Edges; use `tunterm_monitoring` in the `site_setting` for site-scoped Mist Edges
tunterm_monitoring_disabled:
type: boolean
description: Whether tunnel termination monitoring is disabled for the cluster
description: Mist Edge cluster that groups one or more Mist Edge devices for tunneling, RadSec, and related edge services
mxcluster_nac:
title: mxcluster_nac
type: object
properties:
acct_server_port:
type: integer
description: RADIUS accounting port used by Mist NAC on the cluster
contentEncoding: int32
default: 1813
auth_server_port:
type: integer
description: RADIUS authentication port used by Mist NAC on the cluster
contentEncoding: int32
default: 1812
client_ips:
type: object
additionalProperties:
$ref: '#/components/schemas/mxcluster_nac_client_ip'
description: Property key is the RADIUS Client IP/Subnet.
enabled:
type: boolean
description: Whether Mist NAC is enabled on the cluster
default: false
secret:
type: string
description: Shared RADIUS secret used by Mist NAC clients
examples:
- testing123
description: Mist NAC RADIUS settings for a Mist Edge cluster. Used when the Mist Edge Cluster is used as a RADIUS Proxy between the local devices and the Mist NAC
mxcluster_nac_client_ip:
title: mxcluster_nac_client_ip
type: object
properties:
require_message_authenticator:
type: boolean
description: Whether to require Message-Authenticator in requests
default: false
secret:
type: string
description: Client-specific shared secret, if different from the cluster default
site_id:
type: string
description: Present only for third-party clients, identifies the associated site
contentEncoding: uuid
examples:
- 00000000-0000-0000-1234-000000000000
vendor:
allOf:
- $ref: '#/components/schemas/mxcluster_nac_client_vendor2'
- description: 'RADIUS client vendor profile for this IP or subnet. enum: `aruba`, `cisco-aironet`, `cisco-dnac`, `cisco-ios`, `cisco-meraki`, `brocade`, `generic`, `juniper`, `paloalto`.'
examples:
- cisco-ios
description: Mist NAC client settings for a RADIUS client IP or subnet
mxcluster_nac_client_vendor:
title: mxcluster_nac_client_vendor
enum:
- aruba
- cisco-aironet
- cisco-dnac
- cisco-ios
- cisco-meraki
- brocade
- generic
- juniper
- paloalto
type: string
description: 'convention to be followed is : "-", could be an os/platform/model/company. For ex: for cisco vendor, there could variants wrt os (such as ios, nxos etc), platforms (asa etc), or acquired companies (such as meraki, aironet) etc. enum: `aruba`, `cisco-aironet`, `cisco-dnac`, `cisco-ios`, `cisco-meraki`, `brocade`, `generic`, `juniper`, `paloalto`'
examples:
- cisco-ios
mxcluster_nacedge:
title: mxcluster_nacedge
type: object
properties:
auth_ttl:
maximum: 2592000
minimum: 60
type: integer
description: Cache TTL for last auth result in seconds
contentEncoding: int32
default: 604800
caching_site_ids:
type: array
items:
type: string
contentEncoding: uuid
description: List of site UUIDs whose auth requests should be cached by NAC Edges in this cluster
examples:
- - 4ac1dcf4-9d8b-7910-ac87-6ad873648a5c
- 7dc1acf4-9d8b-7910-ac87-6ad873648a5c
default_dot1x_vlan:
type: string
description: Default VLAN for all dot1x devices, if different from default_vlan
examples:
- '20'
default_vlan:
type: string
description: Default VLAN to assign for devices not in the cache
examples:
- testVlan
enabled:
type: boolean
description: Whether NAC Edge survivability is enabled for this cluster
default: false
nac_edge_hosts:
type: array
items:
type: string
description: NAC Edge hostnames used by APs for survivability authentication
examples:
- - nac-west-1.corp.com
- nac-west-2.corp.com
description: NAC Edge survivability settings for a Mist Edge cluster. Requires `mist_nac` to be enabled on the cluster
mxcluster_rad_auth_server_keywrap_format:
title: mxcluster_rad_auth_server_keywrap_format
enum:
- ascii
- hex
type: string
description: 'if used for Mist APs. enum: `ascii`, `hex`'
mxcluster_radsec:
title: mxcluster_radsec
type: object
properties:
acct_servers:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/mxcluster_radsec_acct_server'
description: RADIUS accounting servers used by the RadSec proxy
auth_servers:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/mxcluster_radsec_auth_server'
description: RADIUS authentication servers used by the RadSec proxy
enabled:
type: boolean
description: Whether to enable service on Mist Edge i.e. RADIUS proxy over TLS
match_ssid:
type: boolean
description: Whether to match ssid in request message to select from a subset of RADIUS servers
nas_ip_source:
allOf:
- $ref: '#/components/schemas/mxcluster_radsec_nas_ip_source2'
- description: 'Source used to populate NAS-IP-Address and NAS-IPv6-Address attributes. enum: `any`, `oob`, `oob6`, `tunnel`, `tunnel6`.'
proxy_hosts:
type: array
items:
type: string
description: AP-reachable hostnames or IP addresses advertised as RadSec TLS servers
server_selection:
allOf:
- $ref: '#/components/schemas/mxcluster_radsec_server_selection2'
- description: 'RADIUS server selection strategy for RadSec failover. enum: `ordered`, `unordered`.'
src_ip_source:
allOf:
- $ref: '#/components/schemas/mxcluster_radsec_src_ip_source2'
- description: 'Connection source interface or address used when reaching RADIUS servers. enum: `any`, `oob`, `oob6`, `tunnel`, `tunnel6`.'
description: RadSec proxy configuration for a Mist Edge cluster. Used when the Mist Edge Cluster is used as a RADIUS Proxy between the local devices and external RADIUS Server.
mxcluster_radsec_acct_server:
title: mxcluster_radsec_acct_server
type: object
properties:
host:
type: string
description: IP / hostname of RADIUS server
port:
type: integer
description: Acct port of RADIUS server
contentEncoding: int32
default: 1813
secret:
type: string
description: Shared secret used with this RADIUS accounting server
contentEncoding: password
ssids:
type: array
items:
type: string
description: WLAN SSID filters that use this accounting server when matching is enabled
description: RadSec accounting server settings for a Mist Edge cluster
mxcluster_radsec_auth_server:
title: mxcluster_radsec_auth_server
type: object
properties:
host:
type: string
description: IP / hostname of RADIUS server
inband_status_check:
type: boolean
description: Whether to enable inband status check
default: false
inband_status_interval:
minimum: 0
type: integer
description: Inband status interval, in seconds
contentEncoding: int32
default: 300
keywrap_enabled:
type: boolean
description: If used for Mist APs, enable keywrap algorithm. Default is false
keywrap_format:
allOf:
- oneOf:
- {}
- $ref: '#/components/schemas/mxcluster_rad_auth_server_keywrap_format2'
- description: 'Encoding format for Mist AP RADIUS keywrap keys. enum: `ascii`, `hex`.'
keywrap_kek:
type: string
description: If used for Mist APs, encryption key
keywrap_mack:
type: string
description: If used for Mist APs, Message Authentication Code Key
port:
type: integer
description: Auth port of RADIUS server
contentEncoding: int32
default: 1812
retry:
type: integer
description: Number of authentication request retries before failing over
contentEncoding: int32
default: 2
secret:
type: string
description: Shared secret used with this RADIUS authentication server
contentEncoding: password
ssids:
type: array
items:
type: string
description: WLAN SSID filters that use this authentication server when matching is enabled
timeout:
type: integer
description: Authentication request timeout, in seconds
contentEncoding: int32
default: 5
description: RadSec authentication server settings for a Mist Edge cluster
mxcluster_radsec_nas_ip_source:
title: mxcluster_radsec_nas_ip_source
enum:
- any
- oob
- oob6
- tunnel
- tunnel6
type: string
description: 'SSpecify NAS-IP-ADDRESS, NAS-IPv6-ADDRESS to use with auth_servers. enum: `any`, `oob`, `oob6`, `tunnel`, `tunnel6`'
mxcluster_radsec_server_selection:
title: mxcluster_radsec_server_selection
enum:
- ordered
- unordered
type: string
description: 'When ordered, Mist Edge will prefer and go back to the first RADIUS server if possible. enum: `ordered`, `unordered`'
mxcluster_radsec_src_ip_source:
title: mxcluster_radsec_src_ip_source
enum:
- any
- oob
- oob6
- tunnel
- tunnel6
type: string
description: 'Specify IP address to connect to auth_servers and acct_servers. enum: `any`, `oob`, `oob6`, `tunnel`, `tunnel6`'
mxcluster_radsec_tls:
title: mxcluster_radsec_tls
type: object
properties:
keypair:
type: string
description: Name or identifier of the TLS keypair used by RadSec
description: TLS settings for RadSec on a Mist Edge cluster
mxcluster_tunterm_extra_route:
title: mxcluster_tunterm_extra_route
type: object
properties:
via:
type: string
description: Next-hop IP address for this extra route
description: Extra route for Mist Tunneled VLAN traffic
mxcluster_tunterm_hosts_selection:
title: mxcluster_tunterm_hosts_selection
enum:
- ordered
- shuffle
- shuffle-by-site
type: string
description: >-
Ordering of tunterm_hosts for Mist Edge within the same mxcluster. enum:
* `shuffle`: the ordering of tunterm_hosts is randomized by the device''s MAC
* `shuffle-by-site`: shuffle by site_id+tunnel_id (so when client connects to a specific Tunnel, it will go to the same (order of) mxedge, and we load-balancing between tunnels)
* `ordered`: order decided by tunterm_hosts_order
tunterm_monitoring_item:
title: tunterm_monitoring_item
type: object
properties:
host:
minLength: 1
type: string
description: Can be ip, ipv6, hostname
examples:
- 10.2.8.15
port:
type: integer
description: When `protocol`==`tcp`, TCP port checked by the monitoring probe
contentEncoding: int32
examples:
- 80
protocol:
allOf:
- $ref: '#/components/schemas/tunterm_monitoring_protocol2'
- minLength: 1
description: 'Monitoring method used for this tunnel termination check. enum: `arp`, `ping`, `tcp`.'
examples:
- tcp
src_vlan_id:
type: integer
description: Optional source for the monitoring check, vlan_id configured in tunterm_other_ip_configs
contentEncoding: int32
examples:
- 5
timeout:
type: integer
description: Maximum time for this monitoring check, in seconds
contentEncoding: int32
default: 300
examples:
- 300
description: Monitoring check for tunnel termination reachability
mxedge:
title: mxedge
required:
- model
- name
type: object
properties:
created_time:
type: number
description: Timestamp when the Mist Edge record was created
readOnly: true
for_site:
type: boolean
description: Whether this Mist Edge is scoped to a site
readOnly: true
id:
type: string
description: Unique identifier of the Mist Edge
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
mac:
type: string
description: Mist Edge MAC address
readOnly: true
examples:
- 0200009fbe65
magic:
type: string
description: Registration claim code for the Mist Edge
readOnly: true
examples:
- L-NpT5gi-ADR8WTFd4EiQPY3cP5WdSoD
model:
type: string
description: Mist Edge hardware or virtual appliance model
examples:
- ME-100
modified_time:
type: number
description: Timestamp when the Mist Edge record was last modified
readOnly: true
mxagent_registered:
type: boolean
description: Whether the Mist Edge agent has registered with Mist cloud
readOnly: true
mxcluster_id:
type:
- string
- 'null'
description: Mist Edge cluster identifier that this appliance belongs to
contentEncoding: uuid
examples:
- 572586b7-f97b-a22b-526c-8b97a3f609c4
mxedge_mgmt:
allOf:
- $ref: '#/components/schemas/mxedge_mgmt1'
- description: Management credentials and settings for the Mist Edge
name:
type: string
description: Display name of the Mist Edge
examples:
- Guest
notes:
type: string
description: Free-form notes for the Mist Edge
examples:
- note for mxedge
ntp_servers:
uniqueItems: true
type: array
items:
type: string
description: Time synchronization servers used by the Mist Edge
oob_ip_config:
allOf:
- $ref: '#/components/schemas/mxedge_oob_ip_config3'
- description: Out-of-band management IP configuration for the Mist Edge
org_id:
type: string
description: Identifier of the org that owns the Mist Edge
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
proxy:
allOf:
- $ref: '#/components/schemas/proxy1'
- description: Network proxy settings used by the Mist Edge
services:
type: array
items:
type: string
description: List of services enabled to run on the Mist Edge
site_id:
type: string
description: Identifier of the site when the Mist Edge is site-scoped
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
tunterm_dhcpd_config:
allOf:
- $ref: '#/components/schemas/mxedge_tunterm_dhcpd_config2'
- description: DHCP relay or server settings for Mist Tunneled VLANs
tunterm_extra_routes:
type: object
additionalProperties:
$ref: '#/components/schemas/mxedge_tunterm_extra_route'
description: Extra routes for Mist Tunneled VLAN traffic; property key is a CIDR
tunterm_igmp_snooping_config:
allOf:
- $ref: '#/components/schemas/mxedge_tunterm_igmp_snooping_config2'
- description: IGMP snooping settings for Mist Tunneled VLANs
tunterm_ip_config:
allOf:
- $ref: '#/components/schemas/mxedge_tunterm_ip_config2'
- description: Tunnel termination IP configuration for the Mist Edge
tunterm_monitoring:
type: array
items:
type: array
items:
$ref: '#/components/schemas/tunterm_monitoring_item'
description: Monitoring checks for tunnel termination reachability
tunterm_multicast_config:
allOf:
- $ref: '#/components/schemas/mxedge_tunterm_multicast_config'
- description: Multicast forwarding settings for tunnel termination
tunterm_other_ip_configs:
type: object
additionalProperties:
$ref: '#/components/schemas/mxedge_tunterm_other_ip_config'
description: IPconfigs by VLAN ID. Property key is the VLAN ID
tunterm_port_config:
allOf:
- $ref: '#/components/schemas/tunterm_port_config3'
- description: Port configuration for tunnel termination traffic
tunterm_registered:
type: boolean
description: Whether the tunnel termination service has registered with Mist cloud
readOnly: true
tunterm_switch_config:
allOf:
- $ref: '#/components/schemas/mxedge_tunterm_switch_configs2'
- description: Switch VLAN settings for tunnel termination
versions:
allOf:
- $ref: '#/components/schemas/mxedge_versions2'
- description: Service version information reported by the Mist Edge
readOnly: true
description: Mist Edge appliance configuration and registration state
mxedge_das:
title: mxedge_das
type: object
properties:
coa_servers:
type: array
items:
$ref: '#/components/schemas/mxedge_das_coa_server'
description: Dynamic authorization clients allowed to send CoA or Disconnect-Message requests
enabled:
type: boolean
description: Whether cloud-assisted DAS is enabled for the Mist Edge cluster
default: false
description: Cloud-assisted Dynamic Authorization Service settings for a Mist Edge cluster
mxedge_das_coa_server:
title: mxedge_das_coa_server
type: object
properties:
disable_event_timestamp_check:
type: boolean
description: Whether to disable Event-Timestamp Check
default: false
enabled:
type: boolean
description: Whether this DAS CoA or Disconnect-Message client is enabled
host:
type: string
description: Server host allowed to send CoA or Disconnect-Message requests to Mist Edges
port:
type: integer
description: UDP port where Mist Edges accept CoA or Disconnect-Message requests from this host
contentEncoding: int32
default: 3799
require_message_authenticator:
type: boolean
description: Whether to require Message-Authenticator in requests
default: false
secret:
type: string
description: Shared secret used by this DAS CoA or Disconnect-Message client
contentEncoding: password
description: CoA or Disconnect-Message client allowed to contact Mist Edge DAS
mxedge_event:
title: mxedge_event
type: object
properties:
audit_id:
type: string
description: Audit log identifier associated with this event, when available
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
component:
type:
- string
- 'null'
description: Mist Edge component that reported the event, such as a power supply or fan
examples:
- PS1
- Fan1
device_id:
type:
- string
- 'null'
description: Identifier of the device associated with the event, when available
contentEncoding: uuid
readOnly: true
device_type:
type: string
description: Device type associated with the event
from_version:
type: string
description: Service version before an upgrade-related event
mac:
type: string
description: Mist Edge MAC address associated with the event
mxcluster_id:
type: string
description: Mist Edge cluster identifier associated with the event
examples:
- 2815c917-58e7-472f-a190-bfd44fb58d05
mxedge_id:
type: string
description: Mist Edge identifier associated with the event
examples:
- 00000000-0000-0000-1000-020000dc585c
mxedge_name:
type: string
description: Display name of the Mist Edge associated with the event
org_id:
type: string
description: Identifier of the org where the event occurred
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
package:
type: string
description: Software package associated with the event
service:
type: string
description: Mist Edge service associated with the event
examples:
- tunterm
severity:
allOf:
- $ref: '#/components/schemas/event_severity1'
- description: 'Event severity level reported for this Mist Edge event. enum: `normal`, `critical`, `high`, `warning`.'
sys_info.usage:
allOf:
- $ref: '#/components/schemas/mxedge_event_sys_info2'
- description: System resource usage details associated with the event
text:
type: string
description: Human-readable message describing the Mist Edge event
timestamp:
type: number
description: Time when the Mist Edge event occurred
readOnly: true
to_version:
type: string
description: Service version after an upgrade-related event
type:
type: string
description: Mist Edge event type code
examples:
- ME_SERVICE_STOPPED
description: Event reported for a Mist Edge appliance or service
mxedge_event_sys_info:
title: mxedge_event_sys_info
type: object
properties:
resource:
type: string
description: System resource referenced by the event
severity:
allOf:
- $ref: '#/components/schemas/event_severity2'
- description: 'Event severity for the system resource condition. enum: `normal`, `critical`, `high`, `warning`.'
description: System resource details for a Mist Edge event
mxedge_for_site:
title: mxedge_for_site
enum:
- any
- 'false'
- 'true'
type: string
description: 'enum: `any`, `false`, `true`'
mxedge_mgmt:
title: mxedge_mgmt
type: object
properties:
config_auto_revert:
type: boolean
description: Whether the Mist Edge automatically reverts configuration changes if connectivity is lost
default: false
fips_enabled:
type: boolean
description: Whether FIPS mode is enabled on the Mist Edge
default: false
mist_password:
type: string
description: Password for the Mist service account on the Mist Edge
examples:
- MIST_PASSWORD
oob_ip_type:
allOf:
- $ref: '#/components/schemas/mxedge_mgmt_oob_ip_type2'
- description: 'IPv4 address assignment mode for out-of-band management. enum: `dhcp`, `disabled`, `static`.'
oob_ip_type6:
allOf:
- $ref: '#/components/schemas/mxedge_mgmt_oob_ip_type62'
- description: 'IPv6 address assignment mode for out-of-band management. enum: `autoconf`, `dhcp`, `disabled`, `static`.'
root_password:
type: string
description: Root account password for the Mist Edge
contentEncoding: password
examples:
- ROOT_PASSWORD
description: Management settings for a Mist Edge appliance
mxedge_mgmt_oob_ip_type:
title: mxedge_mgmt_oob_ip_type
enum:
- dhcp
- disabled
- static
type: string
description: 'enum: `dhcp`, `disabled`, `static`'
mxedge_mgmt_oob_ip_type6:
title: mxedge_mgmt_oob_ip_type6
enum:
- autoconf
- dhcp
- disabled
- static
type: string
description: 'enum: `autoconf`, `dhcp`, `disabled`, `static`'
mxedge_oob_ip_config:
title: mxedge_oob_ip_config
type: object
properties:
autoconf6:
type: boolean
description: Whether IPv6 autoconfiguration is enabled on the out-of-band management interface
default: true
dhcp6:
type: boolean
description: Whether DHCPv6 is enabled on the out-of-band management interface
default: true
dns:
type: array
items:
type: string
description: Name server addresses for out-of-band management
default:
- 8.8.8.8
- 8.8.4.4
- 2001:4860:4860::8888
- 2001:4860:4860::8844
examples:
- - 8.8.8.8
- 4.4.4.4
- 2001:4860:4860::8888
- 2001:4860:4860::8844
gateway:
type: string
description: If `type`=`static`, IPv4 default gateway for the out-of-band management interface
examples:
- 10.2.1.254
gateway6:
type: string
description: If `type6`=`static`, IPv6 default gateway for the out-of-band management interface
examples:
- 2601:1700:43c0:dc0::1
ip:
type: string
description: If `type`=`static`, IPv4 address for the out-of-band management interface
examples:
- 10.2.1.2
ip6:
type: string
description: If `type6`=`static`, IPv6 address for the out-of-band management interface
examples:
- 2601:1700:43c0:dc0:20c:29ff:fea7:93bc
netmask:
type: string
description: If `type`=`static`, IPv4 netmask for the out-of-band management interface
examples:
- 255.255.255.0
netmask6:
type: string
description: If `type6`=`static`, IPv6 prefix length for the out-of-band management interface
examples:
- /64
type:
allOf:
- $ref: '#/components/schemas/ip_type9'
- description: 'IPv4 address assignment mode for out-of-band management. enum: `dhcp`, `static`.'
examples:
- static
type6:
allOf:
- $ref: '#/components/schemas/ip_type10'
- description: 'IPv6 address assignment mode for out-of-band management. enum: `dhcp`, `static`.'
examples:
- static
description: IP configuration for the Mist Edge out-of-band management interface
mxedge_service_action:
title: mxedge_service_action
enum:
- restart
- start
- stop
type: string
description: 'enum: `restart`, `start`, `stop`'
mxedge_service_name:
title: mxedge_service_name
enum:
- mxagent
- mxdas
- mxnacedge
- mxocproxy
- radsecproxy
- tunterm
type: string
description: 'Mist Edge service name. enum: `mxagent`, `mxdas`, `mxnacedge`, `mxocproxy`, `radsecproxy`, `tunterm`'
mxedge_tunterm_dhcpd_config:
title: mxedge_tunterm_dhcpd_config
type: object
properties:
enabled:
type: boolean
description: Whether DHCP relay is enabled for Mist Tunneled VLANs
default: false
servers:
type: array
items:
type: string
description: DHCP relay server addresses used when `type`==`relay`
type:
allOf:
- $ref: '#/components/schemas/mxedge_tunterm_dhcpd_type2'
- description: 'DHCP handling mode for the global tunnel termination config. enum: `relay`.'
additionalProperties:
allOf:
- $ref: '#/components/schemas/mxedge_tunterm_dhcpd_config_property'
- description: Per-VLAN DHCP relay settings for a Mist Tunneled VLAN
description: Global and per-VLAN DHCP relay settings for Mist Tunneled VLANs; property key is the VLAN ID
mxedge_tunterm_dhcpd_config_property:
title: mxedge_tunterm_dhcpd_config_property
type: object
properties:
enabled:
type: boolean
description: Whether DHCP relay is enabled for this tunneled VLAN
default: false
servers:
type: array
items:
type: string
description: DHCP relay server addresses used by this tunneled VLAN
type:
allOf:
- $ref: '#/components/schemas/mxedge_tunterm_dhcpd_config_type2'
- description: 'DHCP handling mode for this tunneled VLAN. enum: `relay`.'
description: Per-VLAN DHCP relay settings for a Mist Tunneled VLAN
mxedge_tunterm_dhcpd_config_type:
title: mxedge_tunterm_dhcpd_config_type
const: relay
type: string
description: 'DHCP handling mode for this tunneled VLAN. enum: `relay`'
mxedge_tunterm_dhcpd_type:
title: mxedge_tunterm_dhcpd_type
const: relay
type: string
description: 'DHCP handling mode for the global tunnel termination config. enum: `relay`'
mxedge_tunterm_extra_route:
title: mxedge_tunterm_extra_route
type: object
properties:
via:
type: string
description: Next-hop IP address for this Mist Tunnel extra route
description: Extra route for Mist Tunnel traffic on a Mist Edge
mxedge_tunterm_igmp_snooping_config:
title: mxedge_tunterm_igmp_snooping_config
type: object
properties:
enabled:
oneOf:
- type: boolean
default: false
- type: string
default: 'False'
description: Whether IGMP snooping is enabled for the configured VLANs
querier:
allOf:
- $ref: '#/components/schemas/mxedge_tunterm_igmp_snooping_querier2'
- description: IGMP querier settings used with tunnel termination snooping
vlan_ids:
anyOf:
- type: array
items:
maximum: 4096
minimum: 0
type: integer
contentEncoding: int32
- type: string
description: List of VLAN IDs where tunnel termination performs IGMP snooping
description: IGMP snooping settings for Mist Tunnel VLANs
mxedge_tunterm_igmp_snooping_querier:
title: mxedge_tunterm_igmp_snooping_querier
type: object
properties:
max_response_time:
type: integer
description: Querier's query response interval, in tenths-of-seconds
contentEncoding: int32
examples:
- 10
mtu:
type: integer
description: The MTU we use (needed when forming large IGMPv3 Reports)
contentEncoding: int32
examples:
- 1500
query_interval:
type: integer
description: Querier's query interval, in seconds
contentEncoding: int32
examples:
- 125
robustness:
maximum: 7
minimum: 1
type: integer
description: IGMP querier robustness variable
contentEncoding: int32
version:
type: integer
description: Querier's maximum protocol version
contentEncoding: int32
examples:
- 3
description: IGMP querier settings for tunnel termination
mxedge_tunterm_ip_config:
title: mxedge_tunterm_ip_config
required:
- gateway
- ip
- netmask
type: object
properties:
gateway:
type: string
description: IPv4 gateway for the Mist Tunnel interface
examples:
- 10.2.1.254
gateway6:
type: string
description: IPv6 gateway for the Mist Tunnel interface
examples:
- 2001:1010:1010:1010::1
ip:
type: string
description: Address on the untagged Mist Tunnel interface, in IPv4 format
examples:
- 10.2.1.1
ip6:
type: string
description: Address on the Mist Tunnel interface, in IPv6 format
examples:
- 2001:1010:1010:1010::2
netmask:
type: string
description: Subnet mask for the Mist Tunnel IPv4 address
examples:
- 255.255.255.0
netmask6:
type: string
description: Prefix length for the Mist Tunnel IPv6 address
examples:
- /64
description: IP configuration for the Mist Tunnel interface
mxedge_tunterm_multicast_config:
title: mxedge_tunterm_multicast_config
type: object
properties:
mdns:
allOf:
- $ref: '#/components/schemas/mxedge_tunterm_multicast_mdns2'
- description: Settings for mDNS forwarding on tunnel termination VLANs
ssdp:
allOf:
- $ref: '#/components/schemas/mxedge_tunterm_multicast_ssdp2'
- description: Settings for SSDP forwarding on tunnel termination VLANs
description: Multicast forwarding settings for tunnel termination
mxedge_tunterm_multicast_mdns:
title: mxedge_tunterm_multicast_mdns
type: object
properties:
enabled:
type: boolean
description: Whether mDNS forwarding is enabled for the configured VLANs
vlan_ids:
uniqueItems: true
type: array
items:
type: string
description: List of VLAN IDs where mDNS forwarding is enabled
description: mDNS forwarding settings for tunnel termination
mxedge_tunterm_multicast_ssdp:
title: mxedge_tunterm_multicast_ssdp
type: object
properties:
enabled:
type: boolean
description: Whether SSDP forwarding is enabled for the configured VLANs
vlan_ids:
uniqueItems: true
type: array
items:
type: string
description: List of VLAN IDs where SSDP forwarding is enabled
description: SSDP forwarding settings for tunnel termination
mxedge_tunterm_other_ip_config:
title: mxedge_tunterm_other_ip_config
required:
- ip
- netmask
type: object
properties:
ip:
type: string
description: Address for the additional Mist Tunnel interface, in IPv4 format
netmask:
type: string
description: Subnet mask for the additional Mist Tunnel IPv4 address
description: Additional IP configuration for a Mist Tunnel VLAN interface
mxedge_tunterm_switch_config:
title: mxedge_tunterm_switch_config
type: object
properties:
port_vlan_id:
type: integer
description: Untagged VLAN ID for this tunnel termination switch port
contentEncoding: int32
vlan_ids:
type: array
items:
$ref: '#/components/schemas/vlan_id_with_variable'
description: List of tagged VLAN IDs allowed on this tunnel termination switch port
description: Switch VLAN settings for one tunnel termination port
mxedge_tunterm_switch_configs:
title: mxedge_tunterm_switch_configs
type: object
properties:
enabled:
type: boolean
description: Whether custom tunnel termination switch VLAN settings are enabled
additionalProperties:
allOf:
- $ref: '#/components/schemas/mxedge_tunterm_switch_config'
- description: Switch VLAN settings for one tunnel termination port
description: Custom VLAN settings for tunnel termination switch ports, if desired; property key is the port identifier
mxedge_upgrade_channel:
title: mxedge_upgrade_channel
enum:
- alpha
- beta
- stable
type: string
description: 'upgrade channel to follow. enum: `alpha`, `beta`, `stable`'
mxedge_upgrade_info_items:
title: mxedge_upgrade_info_items
required:
- package
- version
type: object
properties:
default:
type: boolean
description: Whether this version is the default upgrade target for the package
distro:
type: string
description: Linux distribution codename for the package version
package:
type: string
description: Mist Edge service package name
version:
type: string
description: Available version for this package
description: Available upgrade version for a Mist Edge package
mxedge_upgrade_multi:
title: mxedge_upgrade_multi
required:
- mxedge_ids
type: object
properties:
allow_downgrades:
allOf:
- $ref: '#/components/schemas/mxedge_upgrade_multi_allow_downgrades2'
- description: Per-service downgrade permission settings for this upgrade
canary_phases:
type: array
items:
type: integer
contentEncoding: int32
description: Canary phase percentages for phased Mist Edge upgrades
default:
- 1
- 10
- 50
- 100
channel:
allOf:
- $ref: '#/components/schemas/mxedge_upgrade_channel1'
- description: 'Upgrade channel to use for qualified versions. enum: `alpha`, `beta`, `stable`.'
distro:
type: string
description: Linux distribution codename for an optional distro upgrade, such as bullseye or `next` to upgrade to the next distro version. Uses highest qualified versions
max_failure_percentage:
type: integer
description: Failure threshold before we stop the upgrade and mark it as failed
contentEncoding: int32
default: 5
mxedge_ids:
type: array
items:
type: string
contentEncoding: uuid
description: Mist Edge IDs included in the upgrade request
start_time:
type: integer
description: Upgrade start time in epoch seconds, default is now
contentEncoding: int32
strategy:
allOf:
- $ref: '#/components/schemas/mxedge_upgrade_strategy2'
- description: 'Upgrade rollout strategy for the selected Mist Edges. enum: `canary`, `big_bang`, `serial`.'
versions:
allOf:
- $ref: '#/components/schemas/mxedge_upgrade_version2'
- description: Per-service target versions for the upgrade request
description: Request to schedule upgrades for one or more Mist Edges
mxedge_upgrade_multi_allow_downgrades:
title: mxedge_upgrade_multi_allow_downgrades
type: object
properties:
mxagent:
type: boolean
description: Whether downgrades are allowed for the mxagent service
default: false
mxdas:
type: boolean
description: Whether downgrades are allowed for the mxdas service
default: false
mxocproxy:
type: boolean
description: Whether downgrades are allowed for the mxocproxy service
default: false
radsecproxy:
type: boolean
description: Whether downgrades are allowed for the radsecproxy service
default: false
tunterm:
type: boolean
description: Whether downgrades are allowed for the tunterm service
default: false
description: Whether downgrade is allowed when running version is higher than expected version for each service
mxedge_upgrade_response_counts:
title: mxedge_upgrade_response_counts
required:
- failed
- queued
- success
- upgrading
type: object
properties:
failed:
type: integer
description: Number of Mist Edge upgrades that failed
contentEncoding: int32
queued:
type: integer
description: Number of Mist Edge upgrades waiting to run
contentEncoding: int32
success:
type: integer
description: Number of Mist Edge upgrades completed successfully
contentEncoding: int32
upgrading:
type: integer
description: Number of Mist Edge upgrades currently in progress
contentEncoding: int32
description: Counts of Mist Edge upgrades by current status
mxedge_upgrade_strategy:
title: mxedge_upgrade_strategy
enum:
- canary
- big_bang
- serial
type: string
description: >-
enum:
* `big_bang`: upgrade all at once, no orchestration
* `serial`: one at a time'
* `canary`: upgrade in phases
mxedge_upgrade_version:
title: mxedge_upgrade_version
required:
- mxagent
- tunterm
type: object
properties:
mxagent:
type: string
description: Target version for the mxagent service
mxdas:
type: string
description: Target version for the mxdas service
default: current
mxocproxy:
type: string
description: Target version for the mxocproxy service
default: current
radsecproxy:
type: string
description: Target version for the radsecproxy service
default: current
tunterm:
type: string
description: Target version for the tunterm service
description: Version to upgrade for each service, `current` / `latest` / `default` / specific version (e.g. `2.5.100`).\nIgnored if distro upgrade, `tunterm`, `radsecproxy`, `mxagent`, `mxocproxy`, `mxdas` or `mxnacedge`
mxedge_versions:
title: mxedge_versions
type: object
properties:
mxagent:
type: string
description: Reported version of the mxagent service
readOnly: true
tunterm:
type: string
description: Reported version of the tunnel termination service
readOnly: true
description: Read-only Mist Edge service versions
mxedge_vm_params:
title: mxedge_vm_params
type: object
properties:
model:
type: string
description: Mist Edge VM SKU or model to deploy
examples:
- ME-VM
name:
type: string
description: User given name (optional)
user_data:
type: string
description: Base64 encoded user data
description: Mist Edge VM parameters
mxedges_assign:
title: mxedges_assign
required:
- mxedge_ids
- site_id
type: object
properties:
mxedge_ids:
type: array
items:
type: string
contentEncoding: uuid
description: Mist Edge identifiers to assign to the site
site_id:
type: string
description: Identifier of the site that receives the Mist Edges
contentEncoding: uuid
examples:
- 43e9c864-a7e4-4310-8031-d9817d2c5a43
description: Request to assign Mist Edges to a site
mxedges_unassign:
title: mxedges_unassign
required:
- mxedge_ids
type: object
properties:
mxedge_ids:
type: array
items:
type: string
contentEncoding: uuid
description: Mist Edge identifiers to unassign from their site
description: Request to unassign Mist Edges from their site
mxtunnel:
title: mxtunnel
type: object
properties:
anchor_mxtunnel_ids:
type: array
items:
type: string
contentEncoding: uuid
description: IDs of anchor Mist Tunnels used for edge-to-edge tunnel formation
auto_preemption:
allOf:
- $ref: '#/components/schemas/auto_preemption1'
- description: Preemption behavior for restoring preferred tunnel peers after failover
created_time:
type: number
description: Timestamp when the Mist Tunnel was created
readOnly: true
for_site:
type: boolean
description: Whether this Mist Tunnel is scoped to a site
readOnly: true
hello_interval:
maximum: 300
minimum: 1
type:
- integer
- 'null'
description: In seconds, used as heartbeat to detect if a tunnel is alive. AP will try another peer after missing N hellos specified by `hello_retries`.
contentEncoding: int32
default: 60
hello_retries:
maximum: 30
minimum: 2
type:
- integer
- 'null'
description: Number of missed hello heartbeats before an AP tries another tunnel peer
contentEncoding: int32
default: 7
id:
type: string
description: Unique identifier of the Mist Tunnel
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
ipsec:
allOf:
- $ref: '#/components/schemas/mxtunnel_ipsec2'
- description: Security settings for IPsec support on this Mist Tunnel
modified_time:
type: number
description: Timestamp when the Mist Tunnel was last modified
readOnly: true
mtu:
maximum: 1500
minimum: 0
type: integer
description: 0 to enable PMTU, 552-1500 to start PMTU with a lower MTU
contentEncoding: int32
default: 0
mxcluster_ids:
type: array
items:
type: string
contentEncoding: uuid
description: Mist Edge cluster IDs that host this Mist Tunnel
name:
type:
- string
- 'null'
description: Display name of the Mist Tunnel
org_id:
type: string
description: Identifier of the org that owns the Mist Tunnel
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
protocol:
allOf:
- $ref: '#/components/schemas/mxtunnel_protocol3'
- description: 'Encapsulation protocol used for the Mist Tunnel. enum: `ip`, `udp`.'
site_id:
type: string
description: Identifier of the site when the Mist Tunnel is site-scoped
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
vlan_ids:
type: array
items:
type: integer
contentEncoding: int32
description: List of VLAN IDs carried by this Mist Tunnel
description: Mist Tunnel configuration for tunneling AP user VLANs to Mist Edge clusters
mxtunnel_ipsec:
title: mxtunnel_ipsec
type: object
properties:
dns_servers:
type:
- array
- 'null'
items:
type: string
description: Name server addresses advertised for IPsec tunnel clients
dns_suffix:
uniqueItems: true
type: array
items:
type: string
description: Search suffixes advertised for IPsec tunnel clients
enabled:
type: boolean
description: Whether IPsec support is enabled for this Mist Tunnel
extra_routes:
type: array
items:
$ref: '#/components/schemas/mxtunnel_ipsec_extra_route'
description: Additional routes advertised for the IPsec tunnel
split_tunnel:
type: boolean
description: Whether split tunneling is enabled for IPsec clients
use_mxedge:
type: boolean
description: Whether IPsec termination uses Mist Edge
description: IPsec settings for a Mist Tunnel
mxtunnel_ipsec_extra_route:
title: mxtunnel_ipsec_extra_route
type: object
properties:
dest:
type: string
description: Route destination CIDR for the IPsec extra route
next_hop:
type: string
description: Route next-hop IPv4 address for the IPsec extra route
contentEncoding: ipv4
description: Extra route advertised for an IPsec tunnel
mxtunnel_protocol:
title: mxtunnel_protocol
enum:
- ip
- udp
type: string
description: 'Encapsulation protocol used for Mist Tunnel traffic. enum: `ip`, `udp`'
nac_access_type:
title: nac_access_type
enum:
- wireless
- wired
- vty
type: string
description: 'Type of network access. enum: `wireless`, `wired`, `vty`'
examples:
- wireless
nac_auth_type:
title: nac_auth_type
enum:
- cert
- device-auth
- eap-teap
- eap-tls
- eap-ttls
- idp
- mab
- eap-peap
type: string
description: 'enum: `cert`, `device-auth`, `eap-teap`, `eap-tls`, `eap-ttls`, `idp`, `mab`, `eap-peap`'
examples:
- eap-tls
nac_client_coa:
title: nac_client_coa
type: object
properties:
coa_type:
allOf:
- $ref: '#/components/schemas/nac_coa_type3'
- description: 'Change of Authorization command to send to the NAC client. enum: `reauth`, `disconnect`.'
description: Change of Authorization request for a NAC client
nac_client_coa_response:
title: nac_client_coa_response
type: object
properties:
device_mac:
type: string
description: Target AP or switch MAC address for the CoA command
device_type:
allOf:
- $ref: '#/components/schemas/device_type3'
- description: 'Type of network device that received the CoA command. enum: `ap`, `gateway`, `switch`.'
description: Response returned after sending a NAC client CoA command
nac_client_event:
title: nac_client_event
type: object
properties:
ap:
type: string
description: Access point MAC address for the client session
examples:
- 5c5b35513227
auth_type:
allOf:
- $ref: '#/components/schemas/nac_auth_type2'
- description: 'Authentication method used for the NAC event. enum: `cert`, `device-auth`, `eap-teap`, `eap-tls`, `eap-ttls`, `idp`, `mab`, `eap-peap`.'
examples:
- eap-tls
bssid:
type: string
description: Wireless BSSID used for the client session
examples:
- 5c5b355fafcc
client_type:
allOf:
- $ref: '#/components/schemas/nac_access_type2'
- description: 'Access type for the NAC client event. enum: `wireless`, `wired`, `vty`.'
examples:
- wireless
device_mac:
type: string
description: Network device MAC address for the AP or switch handling the client session
readOnly: true
examples:
- 60c78d8c7f6f
dryrun_nacrule_id:
type: string
description: Dry-run NAC rule ID that matched the event, when present
contentEncoding: uuid
readOnly: true
examples:
- 32f27e7d-ff26-4a9b-b3d1-ff9bcb264012
dryrun_nacrule_matched:
type: boolean
description: Whether a dry-run NAC rule matched the event
readOnly: true
idp_id:
type: string
description: Identity provider configuration ID used for the event
contentEncoding: uuid
readOnly: true
examples:
- 912ef72e-2239-4996-b81e-469e87a27cd6
idp_role:
type: array
items:
type: string
description: Roles or groups returned by the identity provider
examples:
- - itsuperusers
- vip
idp_username:
type: string
description: Username presented to the identity provider
readOnly: true
examples:
- user@deaflyz.net
mac:
type: string
description: Client MAC address for the NAC event
readOnly: true
examples:
- ac3eb179e535
mxedge_id:
type: string
description: Mist Edge ID used to connect to cloud
nacrule_id:
type: string
description: NAC rule ID that matched the event
contentEncoding: uuid
readOnly: true
examples:
- 32f27e7d-ff26-4a9b-b3d1-ff9bcb264c62
nacrule_matched:
type: boolean
description: Whether a NAC rule matched the event
readOnly: true
nas_vendor:
type: string
description: Vendor of the network access server
readOnly: true
examples:
- juniper-mist
org_id:
type: string
description: Identifier of the org where the NAC event occurred
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
port_id:
type: string
description: Switch port identifier where the NAC event occurred
readOnly: true
examples:
- ge-0/0/17.0
port_type:
allOf:
- $ref: '#/components/schemas/nac_access_type3'
- description: 'Access type of the port where the NAC event occurred. enum: `wireless`, `wired`, `vty`.'
examples:
- wireless
random_mac:
allOf:
- $ref: '#/components/schemas/random_mac1'
- description: 'Whether the client used a randomized MAC address. enum: `true`, `false`.'
resp_attrs:
uniqueItems: true
type: array
items:
type: string
description: RADIUS response attributes returned by NAC to the NAS
examples:
- - Tunnel-Type=VLAN
- Tunnel-Medium-Type=IEEE-802
- Tunnel-Private-Group-Id=750
- User-Name=anonymous
site_id:
type: string
description: Identifier of the site where the NAC event occurred
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
ssid:
type: string
description: Wireless network SSID used for the NAC session
readOnly: true
examples:
- MyCorp-NAC
timestamp:
type: number
description: Time when the NAC event occurred
readOnly: true
type:
type: string
description: NAC event type code
readOnly: true
examples:
- NAC_CLIENT_PERMIT
usermac_label:
type: array
items:
type: string
description: Labels derived from the usermac entry matched by the client
examples:
- - bldg5
- printer
username:
type: string
description: Client-presented username for the NAC event
readOnly: true
vlan:
type: string
description: Network VLAN name or ID returned for the NAC client
readOnly: true
vlan_source:
type: string
description: Source of the assigned VLAN, for example `nactag` or `usermac`
examples:
- nactag
description: NAC authentication event for a wired or wireless client
nac_client_last_status:
title: nac_client_last_status
enum:
- permitted
- session_started
- session_stopped
- denied
type: string
description: 'Latest Authentication status of the client. enum: `denied`, `permitted`, `session_started`, `session_stopped`'
examples:
- permitted
nac_coa_type:
title: nac_coa_type
enum:
- reauth
- disconnect
type: string
description: 'CoA type to send. enum: `reauth`, `disconnect`'
nac_crl_file:
title: nac_crl_file
type: object
properties:
created_time:
type: number
description: Epoch timestamp when the NAC CRL file was uploaded
readOnly: true
id:
type: string
description: Unique ID for the uploaded CRL file, used to reference the file
readOnly: true
examples:
- a1ca26f3-44dd-4833-9a7b-97bbb2ab5230
modified_time:
type: number
description: Epoch timestamp when the NAC CRL file metadata was last modified
readOnly: true
name:
type: string
description: Issuer name for the CRL file
examples:
- SampleCertificateSigner
url:
type: string
description: Download URL for the uploaded NAC CRL file
examples:
- http://url/to/crl_file
description: Metadata for an uploaded NAC CRL file
nac_portal:
title: nac_portal
type: object
properties:
access_type:
allOf:
- $ref: '#/components/schemas/nac_portal_access_type2'
- description: 'If `type`==`marvis_client`, whether onboarding applies to wireless clients or both wireless and wired clients. enum: `wireless`, `wireless+wired`.'
additional_cacerts:
type: array
items:
type: string
description: Additional CA certificates trusted during NAC portal certificate onboarding
examples:
- - '-----BEGIN CERTIFICATE-----\\n-----END CERTIFICATE-----'
additional_nac_server_name:
type: array
items:
type: string
description: Optional list of additional NAC server names
examples:
- - nac1.corp.com
- nac2.corp.com
bg_image_url:
type: string
description: URL of the NAC portal background image
cert_expire_time:
type: integer
description: Validity duration for portal-issued client certificates, in days
contentEncoding: int32
examples:
- 365
eap_type:
allOf:
- $ref: '#/components/schemas/nac_portal_eap_type2'
- description: 'EAP mode used when onboarding wireless clients through the NAC portal. enum: `wpa2`, `wpa3`.'
enable_location:
type: boolean
description: Whether location data collection is enabled for devices onboarding through this NAC portal
default: false
enable_telemetry:
type: boolean
description: Model, version, fingering, events (connecting, disconnect, roaming), which ap
expiry_notification_time:
type: integer
description: Number of days before certificate expiration to start sending reminder notifications
contentEncoding: int32
id:
type: string
description: Unique identifier of the NAC portal
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
name:
type: string
description: Human-readable name of the NAC portal
examples:
- get-wifi
notify_expiry:
type: boolean
description: Whether to send reminder notifications before portal-issued certificates expire
org_id:
type: string
description: Organization that owns this NAC portal
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
portal:
allOf:
- $ref: '#/components/schemas/nac_portal_guest_portal2'
- description: Guest portal settings used when `type`==`guest_portal`
portal_authorize_jwt_secret:
type: string
description: If `type`==`guest_portal` and `auth`==`external`, the `portal_authorize_jwt_secret` will be generated
readOnly: true
examples:
- 1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef
portal_authorize_url:
type: string
description: If `type`==`guest_portal` and `auth`==`external`, the `portal_authorize_url` will be generated
readOnly: true
examples:
- https://guest-mistnac.mist.com/callback/be22bba7-8e22-e1cf-5185-b880816fe2cf/authorize
portal_sso_url:
type: string
description: If `type`==`guest_portal` or `type`==`guest_admin` and ans SSO is enabled, the `portal_sso_url` will be generated (which needs to be configured in your IDP
readOnly: true
examples:
- https://guest-mistnac.mist.com/callback/be22bba7-8e22-e1cf-5185-b880816fe2cf/acs
ssid:
type: string
description: Wireless SSID associated with the NAC portal
examples:
- Corp
sso:
allOf:
- $ref: '#/components/schemas/nac_portal_sso2'
- description: SAML SSO settings for NAC portal authentication and role mapping
template_url:
type: string
description: URL for the NAC portal template customization resource
thumbnail_url:
type: string
description: Read-only URL of the NAC portal background image thumbnail
readOnly: true
tos:
type: string
description: Terms of service text shown in the NAC portal
type:
allOf:
- $ref: '#/components/schemas/nac_portal_type2'
- description: 'NAC portal mode, such as guest admin, guest portal, or Marvis client onboarding. enum: `guest_admin`, `guest_portal`, `marvis_client`.'
ui_url:
type: string
description: If `auth`==`guest_admin`, the URL to the guest admin portal
readOnly: true
examples:
- https://guest-mistnac.mist.com/admin/51908ea7-dea7-4581-a578-f7320c4d5216/login
description: NAC portal configuration for 802.1X onboarding, guest access, or Marvis client certificate provisioning
nac_portal_access_type:
title: nac_portal_access_type
enum:
- wireless
- wireless+wired
type: string
description: 'if `type`==`marvis_client`. enum: `wireless`, `wireless+wired`'
nac_portal_eap_type:
title: nac_portal_eap_type
enum:
- wpa2
- wpa3
type: string
description: 'EAP mode used when onboarding wireless clients through the NAC portal. enum: `wpa2`, `wpa3`'
nac_portal_guest_portal:
title: nac_portal_guest_portal
type: object
properties:
auth:
allOf:
- $ref: '#/components/schemas/nac_portal_guest_portal_auth2'
- description: 'Mode presented by the NAC guest portal for user authentication. enum: `external`, `multi`, `none`.'
expire:
type: integer
description: If `auth`==`none` or `auth`==`multi`, whether to expire the guest after a certain time
contentEncoding: int32
examples:
- 1440
external_portal_url:
type: string
description: If `auth`==`external`, the URL to redirect the user to for authentication
examples:
- https://yourorg.com/external-guest-portal
force_reconnect:
type: boolean
description: Disconnect client (workaround for reauth issues)
forward:
type: boolean
description: If `auth`==`none` or `auth`==`multi`, whether to forward the user to the guest portal after authentication
examples:
- true
forward_url:
type: string
description: If `auth`==`none` or `auth`==`multi`, URL to forward the user to after authentication
examples:
- https://yourorg.com/guest-portal-redirect
max_num_devices:
maximum: 100
minimum: 0
type: integer
description: Maximum number of clients allowed per guest. 0 (default, unlimited), 1-100 range
contentEncoding: int32
default: 0
examples:
- 10
privacy:
type: boolean
description: If `auth`==`none` or `auth`==`multi`, whether to show the privacy policy
examples:
- true
description: "Guest portal configuration when `type`==`guest_portal`. If \n * `auth`==`none`, the user is presented with a terms of service and can click and continue.\n * `auth`==`external`, the user is redirected to an external URL for authentication.\n * `auth`==`multi`, the user is presented with a choice of authentication methods:\n - social logins: facebook / google / amazon / microsoft / azure\n - sponsor\n - sms: supported provider: twillio\n - email\n - sso\n - userpass: pre created guest list"
nac_portal_guest_portal_auth:
title: nac_portal_guest_portal_auth
enum:
- external
- multi
- none
type: string
description: 'Guest portal authentication type. enum: `external`, `multi`, `none`'
nac_portal_sso:
title: nac_portal_sso
type: object
properties:
idp_cert:
type: string
description: Identity provider certificate used to verify signed SAML responses
examples:
- '-----BEGIN CERTIFICATE-----\n\n-----END CERTIFICATE-----'
idp_sign_algo:
allOf:
- $ref: '#/components/schemas/nac_portal_sso_idp_sign_algo2'
- description: 'Signing algorithm expected for SAML assertions from the identity provider. enum: `sha1`, `sha256`, `sha384`, `sha512`.'
idp_sso_url:
type: string
description: Identity provider Single Sign-On URL for SAML authentication
examples:
- https://yourorg.onelogin.com/trust/saml2/http-post/sso/138130
issuer:
type: string
description: Identity provider issuer URL for SAML authentication
examples:
- https://app.onelogin.com/saml/metadata/138130
nameid_format:
type: string
description: SAML NameID format expected from the identity provider
examples:
- email
sso_role_matching:
type: array
items:
$ref: '#/components/schemas/nac_portal_sso_role_matching'
description: Rules that map SSO role values from the identity provider to NAC portal roles
use_sso_role_for_cert:
type: boolean
description: Whether to include the matched SSO role in the issued certificate subject for later policy matching
description: SAML SSO configuration for a NAC portal
nac_portal_sso_idp_sign_algo:
title: nac_portal_sso_idp_sign_algo
enum:
- sha1
- sha256
- sha384
- sha512
type: string
description: 'Signing algorithm for SAML Assertion. enum: `sha1`, `sha256`, `sha384`, `sha512`.'
nac_portal_sso_role_matching:
title: nac_portal_sso_role_matching
type: object
properties:
assigned:
type: string
description: NAC portal role assigned when the SSO role value matches
examples:
- user
match:
type: string
description: SSO role value to match from the SAML assertion
examples:
- Student
description: Mapping rule from an SSO role claim value to a NAC portal role
nac_portal_template:
title: nac_portal_template
type: object
properties:
alignment:
allOf:
- $ref: '#/components/schemas/portal_template_alignment4'
- description: 'Text and content alignment for the NAC portal page. enum: `center`, `left`, `right`.'
color:
type: string
description: Primary color used by the NAC portal template
default: '#1074bc'
logo:
type: string
description: Custom logo custom logo with "data:image/png;base64," format. default null, uses Juniper Mist Logo.
poweredBy:
type: boolean
description: Whether to hide "Powered by Juniper Mist" and email footers
default: false
description: Visual template settings for a NAC portal
nac_portal_type:
title: nac_portal_type
enum:
- guest_admin
- guest_portal
- marvis_client
type: string
description: "enum: \n * `guest_admin`: NAC-Based Portal Admin for Pre Created Guest Authentication\n * `guest_portal`: NAC-Based Guest Portal\n * `marvis_client`"
nac_rule:
title: nac_rule
required:
- action
- name
type: object
properties:
action:
allOf:
- $ref: '#/components/schemas/nac_rule_action2'
- description: Allow or block decision applied when the NAC rule matches
examples:
- allow
apply_tags:
type: array
items:
type: string
description: NAC tag IDs to include in the Access-Accept when the rule allows access
examples:
- - c049dfcd-0c73-5014-1c64-062e9903f1e5
created_time:
type: number
description: Epoch timestamp when the NAC rule was created
readOnly: true
dry_run:
type: boolean
description: Whether the NAC rule is in dry-run mode, where matches are logged but the action is not enforced
enabled:
type: boolean
description: Whether the NAC rule is evaluated during policy matching
default: true
guest_auth_state:
allOf:
- $ref: '#/components/schemas/nac_rule_guest_auth_state2'
- description: 'Guest portal authorization state condition for the rule. enum: `authorized`, `unknown`.'
examples:
- authorized
id:
type: string
description: Unique identifier of the NAC rule
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
matching:
allOf:
- $ref: '#/components/schemas/nac_rule_matching3'
- description: Criteria that must match for the NAC rule to apply
modified_time:
type: number
description: Epoch timestamp when the NAC rule was last modified
readOnly: true
name:
type: string
description: Human-readable name of the NAC rule
not_matching:
allOf:
- $ref: '#/components/schemas/nac_rule_matching1'
- description: Criteria that must not match for the NAC rule to apply
order:
minimum: 0
type: integer
description: Rule priority; lower values are evaluated with higher priority
contentEncoding: int32
examples:
- 1
org_id:
type: string
description: Org identifier that owns the NAC rule
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
description: NAC authentication policy rule that matches request criteria and applies an allow or block action
nac_rule_action:
title: nac_rule_action
enum:
- allow
- block
type: string
description: 'Allow or block decision applied when the NAC rule matches. enum: `allow`, `block`'
examples:
- allow
nac_rule_guest_auth_state:
title: nac_rule_guest_auth_state
enum:
- authorized
- unknown
type: string
description: 'Guest portal authorization state. enum: `authorized`, `unknown`'
examples:
- authorized
nac_rule_matching:
title: nac_rule_matching
type: object
properties:
auth_type:
allOf:
- $ref: '#/components/schemas/nac_auth_type3'
- description: 'NAC authentication method that must match the request. enum: `cert`, `device-auth`, `eap-teap`, `eap-tls`, `eap-ttls`, `idp`, `mab`, `eap-peap`.'
examples:
- eap-tls
family:
type: array
items:
type: string
description: Client device family values that must match the request
mfg:
type: array
items:
type: string
description: Client device manufacturer values that must match the request
model:
type: array
items:
type: string
description: Client device model values that must match the request
nactags:
type: array
items:
type: string
description: NAC tag IDs whose match criteria must be satisfied by the request
examples:
- - 041d5d36-716c-4cfb-4988-3857c6aa14a2
- a809a97f-d599-f812-eb8c-c3f84aabf6ba
os_type:
type: array
items:
type: string
description: Client OS type values that must match the request
port_types:
type: array
items:
$ref: '#/components/schemas/nac_rule_matching_port_type'
description: Wired or wireless access types that must match the request
examples:
- - wired
site_ids:
type: array
items:
type: string
contentEncoding: uuid
description: Site IDs where the rule criteria apply
examples:
- - bb19fc3e-4124-4b57-80d9-c3f6edce47c4
- bb19fc3e-6564-4b57-80d9-c3f6edce47c1
sitegroup_ids:
type: array
items:
type: string
contentEncoding: uuid
description: Site group IDs where the rule criteria apply
examples:
- - bb19fc3e-4124-4b57-80d9-c3f6edce47c4
- bb19fc3e-6564-4b57-80d9-c3f6edce47c1
vendor:
type: array
items:
type: string
description: Client device vendor values that must match the request
description: Criteria used to include or exclude a NAC authentication request from a rule
nac_rule_matching_port_type:
title: nac_rule_matching_port_type
enum:
- wired
- wireless
type: string
description: 'Port attachment type matched by a NAC rule. enum: `wired`, `wireless`'
nac_tag:
title: nac_tag
required:
- name
- type
type: object
properties:
allow_usermac_override:
type: boolean
description: Whether usermac result values can override this NAC tag when the result type is also supported by usermac
default: false
created_time:
type: number
description: Epoch timestamp when the NAC tag was created
readOnly: true
egress_vlan_names:
type: array
items:
type: string
description: If `type`==`egress_vlan_names`, list of egress VLAN names returned by the NAC rule
examples:
- - 1vlan-30
- 1vlan-20
- 2-vlan10
gbp_tag:
anyOf:
- maximum: 65535
minimum: 1
type: integer
contentEncoding: int32
- type: string
description: If `type`==`gbp_tag`, GBP tag value returned by the NAC rule
id:
type: string
description: Unique identifier of the NAC tag
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
match:
allOf:
- $ref: '#/components/schemas/nac_tag_match2'
- minLength: 1
description: 'If `type`==`match`, client or authentication attribute used for rule matching. enum: `cert_cn`, `cert_eku`, `cert_issuer`, `cert_san`, `cert_serial`, `cert_sub`, `cert_template`, `client_mac`, `edr_status`, `gbp_tag`, `hostname`, `idp_role`, `ingress_vlan`, `mdm_status`, `nas_ip`, `radius_group`, `realm`, `ssid`, `user_name`, `usermac_label`.'
match_all:
type: boolean
description: >-
This field is applicable only when `type`==`match`
* `false`: means it is sufficient to match any of the values (i.e., match-any behavior)
* `true`: means all values should be matched (i.e., match-all behavior)
Currently it makes sense to set this field to `true` only if the `match`==`idp_role`, `match`==`usermac_label` and `edr_status`
default: false
modified_time:
type: number
description: Epoch timestamp when the NAC tag was last modified
readOnly: true
nacportal_id:
type: string
description: If `type`==`redirect_nacportal_id`, NAC portal ID used for client redirection
contentEncoding: uuid
examples:
- 1e970fec-0a7a-4d73-a472-3ef3b6a456aa
name:
minLength: 1
type: string
description: Human-readable name of the NAC tag
org_id:
type: string
description: Org identifier that owns the NAC tag
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
radius_attrs:
type: array
items:
type: string
description: If `type`==`radius_attrs`, standard RADIUS attributes returned by the NAC rule
examples:
- - Idle-Timeout=600
- Termination-Action=RADIUS-Request
radius_group:
type: string
description: If `type`==`radius_group`, RADIUS group value returned by the NAC rule
radius_vendor_attrs:
type: array
items:
type: string
description: If `type`==`radius_vendor_attrs`, vendor-specific RADIUS attributes returned by the NAC rule
examples:
- - PaloAlto-Admin-Role=superuser
- PaloAlto-Panorama-Admin-Role=administrator
session_timeout:
type: integer
description: If `type`==`session_timeout`, session timeout returned by the NAC rule, in seconds
contentEncoding: int32
examples:
- 86000
type:
allOf:
- $ref: '#/components/schemas/nac_tag_type2'
- minLength: 1
description: 'NAC tag type that determines whether the tag is a matcher or a result attribute. enum: `egress_vlan_names`, `gbp_tag`, `match`, `radius_attrs`, `radius_group`, `radius_vendor_attrs`, `redirect_nacportal_id`, `session_timeout`, `username_attr`, `vlan`.'
username_attr:
allOf:
- $ref: '#/components/schemas/nac_tag_username_attr2'
- description: 'If `type`==`username_attr`, attribute used to derive the username returned by the NAC rule. enum: `automatic`, `cn`, `dns`, `email`, `upn`.'
values:
type: array
items:
type: string
description: If `type`==`match`, attribute values used by the NAC tag matcher
vlan:
type: string
description: If `type`==`vlan`, VLAN name or ID returned by the NAC rule
description: NAC tag used as a rule-matching classifier or as a result attribute for allowed users
nac_tag_match:
title: nac_tag_match
enum:
- cert_cn
- cert_eku
- cert_issuer
- cert_san
- cert_serial
- cert_sub
- cert_template
- client_mac
- edr_status
- gbp_tag
- hostname
- idp_role
- ingress_vlan
- mdm_status
- nas_ip
- radius_group
- realm
- ssid
- user_name
- usermac_label
type: string
description: 'if `type`==`match`. enum: `cert_cn`, `cert_eku`, `cert_issuer`, `cert_san`, `cert_serial`, `cert_sub`, `cert_template`, `client_mac`, `edr_status`, `gbp_tag`, `hostname`, `idp_role`, `ingress_vlan`, `mdm_status`, `nas_ip`, `radius_group`, `realm`, `ssid`, `user_name`, `usermac_label`'
nac_tag_type:
title: nac_tag_type
enum:
- egress_vlan_names
- gbp_tag
- match
- radius_attrs
- radius_group
- radius_vendor_attrs
- redirect_nacportal_id
- session_timeout
- username_attr
- vlan
type: string
description: 'enum: `egress_vlan_names`, `gbp_tag`, `match`, `radius_attrs`, `radius_group`, `radius_vendor_attrs`, `redirect_nacportal_id`, `session_timeout`, `username_attr`, `vlan`'
nac_tag_username_attr:
title: nac_tag_username_attr
enum:
- automatic
- cn
- dns
- email
- upn
type: string
description: 'enum: `automatic`, `cn`, `dns`, `email`, `upn`'
name_string:
title: name_string
type: object
properties:
name:
type: string
description: Value to create or update as the target resource name
description: Request body containing a name value
network:
title: network
required:
- name
type: object
properties:
created_time:
type: number
description: Epoch timestamp when the network was created
readOnly: true
disallow_mist_services:
type: boolean
description: Whether to disallow Mist Devices in the network
default: false
gateway:
type: string
description: IPv4 gateway address for this network
contentEncoding: ipv4
examples:
- 192.168.70.1
gateway6:
type: string
description: IPv6 gateway address for this network
contentEncoding: ipv6
examples:
- fdad:b0bc:f29e::1
id:
type: string
description: Unique identifier of the network
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
internal_access:
allOf:
- $ref: '#/components/schemas/network_internal_access2'
- description: Internal access settings for this network
internet_access:
allOf:
- $ref: '#/components/schemas/network_internet_access2'
- description: Direct internet access and NAT settings for this network
isolation:
type: boolean
description: Whether to allow clients in the network to talk to each other
modified_time:
type: number
description: Epoch timestamp when the network was last modified
readOnly: true
multicast:
allOf:
- $ref: '#/components/schemas/network_multicast2'
- description: Settings for multicast routing on this network
name:
type: string
description: Display name of the organization network
org_id:
type: string
description: Organization that owns this network
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
routed_for_networks:
type: array
items:
type: string
description: Other network names this network can route to, for example through BGP, OSPF or static routes
subnet:
type: string
description: IPv4 subnet CIDR for this network
examples:
- 192.168.70.0/24
subnet6:
type: string
description: IPv6 subnet CIDR for this network
examples:
- fdad:b0bc:f29e::/32
tenants:
type: object
additionalProperties:
$ref: '#/components/schemas/network_tenant'
description: Tenant address mappings associated with this network
vlan_id:
oneOf:
- type: string
- maximum: 4094
minimum: 1
type: integer
contentEncoding: int32
description: VLAN ID or variable associated with this network
vpn_access:
type: object
additionalProperties:
$ref: '#/components/schemas/network_vpn_access_config'
description: VPN access settings keyed by VPN name for this network
description: Organization-level Layer 3 network definition that can be merged into site settings and used for service routes. Networks are used to define the service routes in the Gateway settings or templates
network_internal_access:
title: network_internal_access
type: object
properties:
enabled:
type: boolean
description: Whether internal access is enabled for this network
description: Internal access settings for an organization network
network_internet_access:
title: network_internet_access
type: object
properties:
create_simple_service_policy:
type: boolean
description: Whether Mist should create simple service policies for restricted internet access
default: false
destination_nat:
type: object
additionalProperties:
$ref: '#/components/schemas/network_internet_access_destination_nat_property'
description: Destination NAT rules for direct internet access
enabled:
type: boolean
description: Whether direct internet access is enabled for this network
restricted:
type: boolean
description: By default, all access is allowed, to only allow certain traffic, make `restricted`=`true` and define service_policies
default: false
static_nat:
type: object
additionalProperties:
$ref: '#/components/schemas/network_internet_access_static_nat_property'
description: Static NAT rules for direct internet access
description: Direct internet access settings for an organization network
network_internet_access_destination_nat_property:
title: network_internet_access_destination_nat_property
type: object
properties:
internal_ip:
type: string
description: The Destination NAT destination IP address. Must be an IP (i.e. "192.168.70.30") or a Variable (i.e. "{{myvar}}")
examples:
- 192.168.70.30
name:
type: string
description: Label for this direct internet destination NAT rule
examples:
- web server
port:
type: string
description: The Destination NAT destination IP address. Must be a Port (i.e. "443") or a Variable (i.e. "{{myvar}}")
examples:
- '443'
wan_name:
type: string
description: SRX Only. If not set, we configure the nat policies against all WAN ports for simplicity
examples:
- wan0
description: Direct-internet destination NAT rule target settings
network_internet_access_static_nat_property:
title: network_internet_access_static_nat_property
type: object
properties:
internal_ip:
type: string
description: The Static NAT destination IP address. Must be an IP address (i.e. "192.168.70.3") or a Variable (i.e. "{{myvar}}")
examples:
- 192.168.70.3
name:
type: string
description: Label for this direct internet static NAT rule
examples:
- pos_station-1
wan_name:
type: string
description: SRX Only. If not set, we configure the nat policies against all WAN ports for simplicity. Can be a Variable (i.e. "{{myvar}}")
examples:
- wan0
description: Direct-internet static NAT rule target settings
network_multicast:
title: network_multicast
type: object
properties:
disable_igmp:
type: boolean
description: If the network will only be the source of the multicast traffic, IGMP can be disabled
default: false
enabled:
type: boolean
description: Whether multicast support is enabled for this network
default: false
groups:
type: object
additionalProperties:
$ref: '#/components/schemas/network_multicast_group'
description: Multicast group-to-RP mappings for this network
description: Whether to enable multicast support (only PIM-sparse mode is supported)
network_multicast_group:
title: network_multicast_group
type: object
properties:
rp_ip:
type: string
description: RP (rendezvous point) IP address
description: Multicast group rendezvous point mapping
network_source_nat:
title: network_source_nat
type: object
properties:
external_ip:
type: string
description: External source NAT IP or subnet used when spoke hosts must be reachable from the hub
examples:
- 172.16.0.8/30
description: If `routed`==`false` (usually at Spoke), but some hosts needs to be reachable from Hub
network_template:
title: network_template
type: object
properties:
acl_policies:
type: array
items:
$ref: '#/components/schemas/acl_policy'
description: ACL policy defaults provided by this network template
acl_tags:
type: object
additionalProperties:
$ref: '#/components/schemas/acl_tag'
description: ACL tags available to access policies in this network template
additional_config_cmds:
type: array
items:
type: string
description: Additional CLI configuration commands provided by this network template
bgp_config:
type: object
additionalProperties:
$ref: '#/components/schemas/switch_bgp_config'
description: BGP routing defaults for this network template. Property key is the BGP session name
created_time:
type: number
description: Timestamp when the network template was created
readOnly: true
dhcp_snooping:
allOf:
- $ref: '#/components/schemas/dhcp_snooping3'
- description: DHCP snooping defaults provided by this network template
dns_servers:
type: array
items:
type: string
description: DNS servers provided by this network template
dns_suffix:
type: array
items:
type: string
description: DNS search suffixes provided by this network template
extra_routes:
type: object
additionalProperties:
$ref: '#/components/schemas/extra_route'
description: Additional IPv4 route defaults in this network template
examples:
- 0.0.0.0/0:
via: 192.168.1.10
extra_routes6:
type: object
additionalProperties:
$ref: '#/components/schemas/extra_route6'
description: Additional IPv6 route defaults in this network template
examples:
- 2a02:1234:420a:10c9::/64:
via: 2a02:1234:200a::100
id:
type: string
description: Unique identifier of the network template
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
import_org_networks:
type: array
items:
type: string
description: Organization network names imported into this network template
mist_nac:
allOf:
- $ref: '#/components/schemas/switch_mist_nac2'
- description: Mist NAC defaults applied by this network template
modified_time:
type: number
description: Timestamp when the network template was last modified
readOnly: true
multicast_config:
allOf:
- $ref: '#/components/schemas/switch_multicast_config1'
- description: Multicast settings for networks in the master VRF (not assigned to any vrf_instances); PIM is automatically enabled when any master-VRF network has `multicast.enabled`==`true`
name:
type: string
description: Display name of the network template
networks:
type: object
additionalProperties:
$ref: '#/components/schemas/switch_network'
description: Layer 3 networks configured by this network template
ntp_servers:
type: array
items:
type: string
description: NTP servers provided by this network template
org_id:
type: string
description: Organization that owns this network template
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
ospf_areas:
type: object
additionalProperties:
$ref: '#/components/schemas/ospf_area'
description: OSPF area defaults provided by this network template
port_mirroring:
type: object
additionalProperties:
$ref: '#/components/schemas/switch_port_mirroring_property'
description: Port mirroring defaults provided by this network template
port_usages:
type: object
additionalProperties:
$ref: '#/components/schemas/switch_port_usage'
description: Reusable switch port usage profiles provided by this network template
radius_config:
allOf:
- $ref: '#/components/schemas/switch_radius_config3'
- description: RADIUS authentication and accounting defaults in this network template
remote_syslog:
allOf:
- $ref: '#/components/schemas/remote_syslog2'
- description: Remote syslog defaults provided by this network template
remove_existing_configs:
type: boolean
description: By default, only the configuration generated by Mist is cleaned up during the configuration process. If `true`, all the existing configuration will be removed.
default: false
routing_policies:
type: object
additionalProperties:
$ref: '#/components/schemas/sw_routing_policy'
description: Routing policy defaults applied by this network template
snmp_config:
allOf:
- $ref: '#/components/schemas/snmp_config2'
- description: SNMP defaults provided by this network template
switch_matching:
allOf:
- $ref: '#/components/schemas/switch_matching3'
- description: Matching rules that select switches for this network template
switch_mgmt:
allOf:
- $ref: '#/components/schemas/switch_mgmt3'
- description: Management-plane defaults provided by this network template
vrf_config:
allOf:
- $ref: '#/components/schemas/vrf_config5'
- description: VRF defaults applied by this network template
vrf_instances:
type: object
additionalProperties:
$ref: '#/components/schemas/switch_vrf_instance'
description: VRF instances configured by this network template
examples:
- guest:
extra_routes:
0.0.0.0/0:
via: 192.168.31.1
networks:
- guest
description: Network template configuration applied to sites or site groups
network_tenant:
title: network_tenant
type: object
properties:
addresses:
type: array
items:
type: string
description: IP addresses or subnets assigned to this tenant in the network
description: Tenant address entry for a network
network_vpn_access_config:
title: network_vpn_access_config
type: object
properties:
advertised_subnet:
type: string
description: If `routed`==`true`, whether to advertise an aggregated subnet toward HUB this is useful when there are multiple networks on SPOKE's side
examples:
- 172.16.0.0/24
allow_ping:
type: boolean
description: Whether to allow ping from vpn into this routed network
destination_nat:
type: object
additionalProperties:
$ref: '#/components/schemas/network_vpn_access_destination_nat_property'
description: Destination NAT rules applied for VPN access to this network
nat_pool:
type: string
description: If `routed`==`false` (usually at Spoke), but some hosts needs to be reachable from Hub, a subnet is required to create and advertise the route to Hub
examples:
- 172.16.0.0/26
no_readvertise_to_lan_bgp:
type: boolean
description: toward LAN-side BGP peers
default: false
no_readvertise_to_lan_ospf:
type: boolean
description: toward LAN-side OSPF peers
default: false
no_readvertise_to_overlay:
type: boolean
description: toward overlay, how HUB should deal with routes it received from Spokes
other_vrfs:
type: array
items:
type: string
description: Other VRFs that can receive leaked routes from this spoke network
routed:
type: boolean
description: Whether this network is routable
source_nat:
allOf:
- $ref: '#/components/schemas/network_source_nat2'
- description: Source NAT settings used when non-routed spoke hosts must be reachable from the hub
static_nat:
type: object
additionalProperties:
$ref: '#/components/schemas/network_vpn_access_static_nat_property'
description: Static NAT rules applied for VPN access to this network
summarized_subnet:
type: string
description: toward overlay, how HUB should deal with routes it received from Spokes
examples:
- 172.16.0.0/16
summarized_subnet_to_lan_bgp:
type: string
description: toward LAN-side BGP peers
examples:
- 172.16.0.0/16
summarized_subnet_to_lan_ospf:
type: string
description: toward LAN-side OSPF peers
examples:
- 172.16.0.0/16
description: VPN access settings for a network and VPN pair
network_vpn_access_destination_nat_property:
title: network_vpn_access_destination_nat_property
type: object
properties:
internal_ip:
type: string
description: The Destination NAT destination IP address. Must be an IP (i.e. "192.168.70.30") or a Variable (i.e. "{{myvar}}")
examples:
- 192.168.70.30
name:
type: string
description: Label for this VPN destination NAT rule
examples:
- web server
port:
type: string
description: Destination port or variable for this VPN destination NAT rule
examples:
- '443'
description: VPN access destination NAT rule target settings
network_vpn_access_static_nat_property:
title: network_vpn_access_static_nat_property
type: object
properties:
internal_ip:
type: string
description: The Static NAT destination IP address. Must be an IP address (i.e. "192.168.70.3") or a Variable (i.e. "{{myvar}}")
examples:
- 192.168.70.3
name:
type: string
description: Label for this VPN static NAT rule
examples:
- pos_station-1
description: VPN access static NAT rule target settings
note_string:
title: note_string
type: object
properties:
note:
type: string
description: Some text note describing the intent
examples:
- maintenance window
description: Request body containing a note value
notes_string:
title: notes_string
type: object
properties:
notes:
type: string
description: Text to attach to the target resource as notes
examples:
- wired pcap test
description: Request body containing notes text
oauth_app_name:
title: oauth_app_name
enum:
- crowdstrike
- intune
- jamf
- mobicontrol
- prisma
- sentinelone
- teams
- vmware
- zdx
- zoom
type: string
description: 'enum: `crowdstrike`, `intune`, `jamf`, `mobicontrol`, `prisma`, `sentinelone`, `teams`, `vmware`, `zdx`, `zoom`'
oauth_ping_identity_region:
title: oauth_ping_identity_region
enum:
- asia
- au
- ca
- eu
- us
type: string
description: 'enum: `us` (United States, default), `ca` (Canada), `eu` (Europe), `asia` (Asia), `au` (Australia)'
oauth_provider_domain:
title: oauth_provider_domain
enum:
- okta.com
- oktapreview.com
- okta-emea.com
- okta-gov.com
- okta.mil
- mtls.okta.com
type: string
description: 'If `oauth_type`==`okta`, specifies the region-specific OAuth provider domain. enum: `okta.com`, `oktapreview.com`, `okta-emea.com`, `okta-gov.com`, `okta.mil`, `mtls.okta.com`'
examples:
- okta.com
optic_port_config_port:
title: optic_port_config_port
type: object
properties:
channelized:
type: boolean
description: Whether channelization is enabled on this optic port
default: false
speed:
type: string
description: Interface speed (e.g. `25g`, `50g`), use the chassis speed by default
examples:
- 25g
description: Per-interface optic port override settings
org:
title: org
required:
- name
type: object
properties:
alarmtemplate_id:
type:
- string
- 'null'
description: Org-level alarm template ID used as the default for sites
contentEncoding: uuid
allow_mist:
type: boolean
description: Whether Mist support access is allowed for this organization
default: true
created_time:
type: number
description: Epoch timestamp when the organization was created
readOnly: true
id:
type: string
description: Unique identifier of the organization
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
modified_time:
type: number
description: Epoch timestamp when the organization was last modified
readOnly: true
msp_id:
type: string
description: Managed service provider account that owns this organization, when applicable
contentEncoding: uuid
readOnly: true
examples:
- b9d42c2e-88ee-41f8-b798-f009ce7fe909
msp_logo_url:
type: string
description: logo uploaded by the MSP with advanced tier, only present if provided
contentEncoding: uri
readOnly: true
examples:
- https://example.com/logo/b9d42c2e-88ee-41f8-b798-f009ce7fe909.jpeg
msp_name:
type: string
description: Name of the msp the org belongs to
readOnly: true
examples:
- MSP
name:
type: string
description: Display name of the organization
examples:
- Org
orggroup_ids:
type: array
items:
type: string
contentEncoding: uuid
description: Organization group IDs that include this organization
session_expiry:
maximum: 20160
minimum: 10
type: integer
description: Admin session lifetime for the organization, in minutes
contentEncoding: int32
default: 1440
description: Mist organization containing sites, devices, users, and organization-level settings
org_apitoken:
title: org_apitoken
required:
- name
type: object
properties:
created_by:
type:
- string
- 'null'
description: email of the token creator / null if creator is deleted
readOnly: true
examples:
- user@mycorp.com
created_time:
type: number
description: Epoch timestamp when the organization API token was created
readOnly: true
id:
type: string
description: Unique identifier of the organization API token
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
key:
type: string
description: Token secret key. The full API Token is only returned when the API token is created and can only be partially retrieved afterward
readOnly: true
examples:
- 1qkb...QQCL
last_used:
type:
- number
- 'null'
description: Epoch timestamp when the token was last used, or null if it has not been used
readOnly: true
examples:
- 1690115110
name:
type: string
description: Display name of the organization API token
examples:
- org_token_xyz
org_id:
type: string
description: Organization that owns this API token
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
privileges:
maxItems: 10
minItems: 1
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/privilege_org'
description: Access scopes and roles granted to the organization API token
examples:
- - role: admin
scope: org
src_ips:
type: array
items:
type: string
description: Allowed source IP addresses or CIDRs from which the token may be used
examples:
- - 63.3.56.0/24
- 63.3.55.4
description: >-
Organization API token with scoped privileges
**Note:**
`privileges` is required to create the object, but may not be returned in the POST API response. Retrieve the token afterward to inspect it.
privilege_org:
title: privilege_org
required:
- role
- scope
type: object
properties:
org_id:
type: string
description: If `scope`==`org`, organization ID this privilege applies to
contentEncoding: uuid
readOnly: true
role:
allOf:
- $ref: '#/components/schemas/privilege_org_role2'
- description: 'Access role granted by this organization privilege. enum: `admin`, `helpdesk`, `installer`, `read`, `write`.'
scope:
allOf:
- $ref: '#/components/schemas/privilege_org_scope2'
- description: 'Organization hierarchy level where this privilege applies. enum: `org`, `site`, `sitegroup`, `orgsites`.'
site_id:
type: string
description: If `scope`==`site`, site ID this privilege applies to
contentEncoding: uuid
sitegroup_id:
type: string
description: If `scope`==`sitegroup`, site group ID this privilege applies to
contentEncoding: uuid
view:
type: string
description: Used for backward compatibility. Use `views` instead.
deprecated: true
views:
type: array
items:
$ref: '#/components/schemas/admin_privilege_view'
description: UI views allowed by custom role restrictions
description: Organization privilege scope and role settings
org_asset_count_distinct:
title: org_asset_count_distinct
enum:
- ibeacon_major
- ibeacon_minor
- ibeacon_uuid
- mac
- map_id
- site_id
type: string
description: 'enum: `ibeacon_major`, `ibeacon_minor`, `ibeacon_uuid`, `mac`, `map_id`, `site_id`'
org_client_sessions_count_distinct:
title: org_client_sessions_count_distinct
enum:
- ap
- device
- hostname
- ip
- model
- os
- ssid
- vlan
type: string
description: 'enum: `ap`, `device`, `hostname`, `ip`, `model`, `os`, `ssid`, `vlan`'
org_clients_count_distinct:
title: org_clients_count_distinct
enum:
- ap
- device
- hostname
- ip
- mac
- model
- os
- ssid
- vlan
type: string
description: 'enum: `ap`, `device`, `hostname`, `ip`, `mac`, `model`, `os`, `ssid`, `vlan`'
org_crl_import_file:
title: org_crl_import_file
type: object
properties:
file:
type: string
description: a PEM or DER formatted CRL file
contentEncoding: base64
json:
type: string
description: a JSON string with "name" field for CRL file issuer (optional)
description: Multipart upload payload for importing an organization CRL file
org_device:
title: org_device
required:
- mac
- name
type: object
properties:
mac:
type: string
description: Organization device MAC address
name:
type: string
description: Display name of the organization device
description: Organization device identifier returned by the devices list
org_devices_count_distinct:
title: org_devices_count_distinct
enum:
- hostname
- ip
- lldp_mgmt_addr
- lldp_port_id
- lldp_system_desc
- lldp_system_name
- mac
- model
- mxedge_id
- mxtunnel_status
- site_id
- version
type: string
description: 'enum: `hostname`, `ip`, `lldp_mgmt_addr`, `lldp_port_id`, `lldp_system_desc`, `lldp_system_name`, `mac`, `model`, `mxedge_id`, `mxtunnel_status`, `site_id`, `version`'
org_devices_events_count_distinct:
title: org_devices_events_count_distinct
enum:
- ap
- apfw
- model
- org_id
- site_id
- text
- timestamp
- type
type: string
description: 'enum: `ap`, `apfw`, `model`, `org_id`, `site_id`, `text`, `timestamp`, `type`'
org_devices_last_configs_count_distinct:
title: org_devices_last_configs_count_distinct
enum:
- mac
- name
- site_id
- version
type: string
description: 'enum: `mac`, `name`, `site_id`, `version`'
org_e911_report:
title: org_e911_report
type: object
properties:
detail:
type: string
description: Human-readable description of the action taken
last_generated:
type: integer
description: Unix timestamp of when the report file was last generated. Only present when `status` is `available`.
contentEncoding: int32
status:
allOf:
- $ref: '#/components/schemas/org_e911_report_status2'
- description: 'Current generation state of the E911 AP BSSID report. enum: `disabled`, `scheduled`, `available`.'
url:
type: string
description: Presigned URL to download the CSV file. Only present when `status` is `available`.
description: E911 AP BSSID report status for the organization
org_e911_report_status:
title: org_e911_report_status
enum:
- disabled
- scheduled
- available
type: string
description: 'Current status of E911 report generation. enum: `disabled`, `scheduled`, `available`'
org_event:
title: org_event
type: object
properties:
org_id:
type: string
description: Organization associated with this event
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
text:
type: string
description: Detailed human-readable message for the organization event
examples:
- authentication failed, API key invalid
timestamp:
type: number
description: Time when the organization event occurred
readOnly: true
type:
type: string
description: Event type code for this organization event
examples:
- CRADLEPOINT_SYNC_FAILED
description: Event record generated at the organization level
org_guests_count_distinct:
title: org_guests_count_distinct
enum:
- auth_method
- company
- ssid
type: string
description: 'enum: `auth_method`, `company`, `ssid`'
org_license_action:
title: org_license_action
required:
- op
type: object
properties:
amendment_id:
type: string
description: If `op`==`unamend`, the ID of the operation to cancel
contentEncoding: uuid
dst_org_id:
type: string
description: If `op`==`amend`, the id of the org where the license is moved
contentEncoding: uuid
notes:
type: string
description: If `op`==`annotate`, note text to attach to the license
op:
allOf:
- $ref: '#/components/schemas/org_license_action_operation2'
- description: 'License action operation to perform. enum: `amend`, `annotate`, `delete`, `unamend`.'
quantity:
type: integer
description: If `op`==`amend`, the number of licenses to move
contentEncoding: int32
subscription_id:
type: string
description: If `op`==`amend` or `op`==`delete`, the ID of the subscription to use
description: Request to amend, annotate, delete, or unamend an organization license
org_license_action_operation:
title: org_license_action_operation
enum:
- amend
- annotate
- delete
- unamend
type: string
description: 'to move a license, use the `amend` operation. enum: `amend`, `annotate`, `delete`, `unamend`'
org_logs_count_distinct:
title: org_logs_count_distinct
enum:
- admin_id
- admin_name
- message
- site_id
type: string
description: 'enum: `admin_id`, `admin_name`, `message`, `site_id`'
org_mxedge_count_distinct:
title: org_mxedge_count_distinct
enum:
- distro
- model
- mxcluster_id
- site_id
- tunterm_version
type: string
description: 'enum: `distro`, `model`, `mxcluster_id`, `site_id`, `tunterm_version`'
org_mxedge_events_count_distinct:
title: org_mxedge_events_count_distinct
enum:
- mxcluster_id
- mxedge_id
- package
- type
type: string
description: 'enum: `mxcluster_id`, `mxedge_id`, `package`, `type`'
org_nac_client_events_count_distinct:
title: org_nac_client_events_count_distinct
enum:
- ap
- auth_type
- dryrun_nacrule_id
- mac
- nacrule_id
- nas_vendor
- ssid
- type
- username
- vlan
type: string
description: 'enum: `ap`, `auth_type`, `dryrun_nacrule_id`, `mac`, `nacrule_id`, `nas_vendor`, `ssid`, `type`, `username`, `vlan`'
org_nac_clients_count_distinct:
title: org_nac_clients_count_distinct
enum:
- ap
- auth_type
- device_mac
- edr_managed
- edr_providers
- edr_status
- family
- hostname
- idp_id
- mfg
- mdm_compliance
- mdm_managed
- mdm_provider
- model
- mxedge_id
- nacrule_matched
- nacrule_name
- nacrule_id
- nas_ip
- nas_vendor
- os
- site_id
- ssid
- status
- type
- usermac_label
- username
- vlan
type: string
description: 'enum: `ap`, `auth_type`, `device_mac`, `edr_managed`, `edr_providers`, `edr_status`, `family`, `hostname`, `idp_id`, `mfg`, `mdm_compliance`, `mdm_managed`, `mdm_provider`, `model`, `mxedge_id`, `nacrule_matched`, `nacrule_name`, `nacrule_id`, `nas_ip`, `nas_vendor`, `os`, `site_id`, `ssid`, `status`, `type`, `usermac_label`, `username`, `vlan`'
org_otherdevices_events_count_distinct:
title: org_otherdevices_events_count_distinct
enum:
- mac
- site_id
- type
- vendor
type: string
description: 'enum: `mac`, `site_id`, `type`, `vendor`'
org_psk_portal_logs_count_distinct:
title: org_psk_portal_logs_count_distinct
enum:
- admin_id
- admin_name
- psk_id
- psk_name
- pskportal_id
- user_id
type: string
description: 'enum: `admin_id`, `admin_name`, `psk_id`, `psk_name`, `pskportal_id`, `user_id`'
org_service_policy:
title: org_service_policy
type: object
properties:
aamw:
allOf:
- $ref: '#/components/schemas/service_policy_aamw2'
- description: Advanced anti-malware settings applied by this service policy
action:
allOf:
- $ref: '#/components/schemas/allow_deny2'
- description: Allow or deny action for traffic matched by this service policy
antivirus:
allOf:
- $ref: '#/components/schemas/service_policy_antivirus1'
- description: Malware and virus inspection settings applied by this service policy
appqoe:
allOf:
- $ref: '#/components/schemas/service_policy_appqoe1'
- description: Application QoE settings applied by this service policy
created_time:
type: number
description: Epoch timestamp when the service policy was created
readOnly: true
ewf:
type: array
items:
$ref: '#/components/schemas/service_policy_ewf_rule'
description: Enhanced web filtering rules applied by this service policy
id:
type: string
description: Unique identifier of the service policy
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
idp:
allOf:
- $ref: '#/components/schemas/idp_config2'
- description: Intrusion detection and prevention settings applied by this service policy
local_routing:
type: boolean
description: Whether the policy permits access within the same VRF
modified_time:
type: number
description: Epoch timestamp when the service policy was last modified
readOnly: true
name:
type: string
description: Display name of the service policy
org_id:
type: string
description: Organization that owns this service policy
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
path_preference:
type: string
description: By default, we derive all paths available and use them, optionally, you can customize by using `path_preference`
secintel:
allOf:
- $ref: '#/components/schemas/service_policy_secintel1'
- description: Juniper SecIntel threat intelligence settings applied by this service policy
services:
uniqueItems: true
type: array
items:
type: string
description: Application services or groups matched by this policy
ssl_proxy:
allOf:
- $ref: '#/components/schemas/service_policy_ssl_proxy1'
- description: SSL proxy inspection settings applied by this service policy
tenants:
uniqueItems: true
type: array
items:
type: string
description: Tenant names matched by this service policy
description: Organization-level service policy that allows or denies traffic for tenants and services
org_setting:
title: org_setting
type: object
properties:
allow_mist:
type: boolean
description: whether to allow Mist to look at this org
default: false
ap_updown_threshold:
maximum: 240
minimum: 0
type:
- integer
- 'null'
description: Enable threshold-based device down delivery for AP devices only. When configured it takes effect for AP devices and `device_updown_threshold` is ignored.
contentEncoding: int32
default: 0
api_policy:
allOf:
- $ref: '#/components/schemas/org_setting_api_policy2'
- description: Policy for hiding API secrets and passwords in responses
auto_device_naming:
allOf:
- $ref: '#/components/schemas/org_setting_auto_device_naming2'
- description: Automatic device naming rules for claimed devices
auto_deviceprofile_assignment:
allOf:
- $ref: '#/components/schemas/org_setting_auto_deviceprofile_assignment2'
- description: Automatic device profile assignment rules for claimed devices
auto_site_assignment:
allOf:
- $ref: '#/components/schemas/org_setting_auto_site_assignment2'
- description: Automatic site assignment rules for claimed devices
auto_upgrade:
allOf:
- $ref: '#/components/schemas/org_setting_auto_upgrade2'
- description: AP automatic firmware upgrade policy for the organization
blacklist_url:
type: string
description: Read-only URL for the organization blacklist file
readOnly: true
examples:
- https://papi.s3.amazonaws.com/blacklist/xxx...
cacerts:
type: array
items:
type: string
description: Legacy CA certificate list used to verify client certificates. If `cacerts_configs` is provided and non-empty, this field is ignored.
cacerts_configs:
type: array
items:
$ref: '#/components/schemas/org_setting_cacerts_config'
description: Preferred per-issuer CA certificate configuration with optional OCSP and CRL settings. When provided and non-empty, `cacerts` is ignored.
celona:
allOf:
- $ref: '#/components/schemas/org_setting_celona'
- description: Integration settings for Celona
cloudshark:
allOf:
- $ref: '#/components/schemas/org_setting_cloudshark'
- description: Packet capture integration settings for CloudShark
created_time:
type: number
description: Epoch timestamp when the organization settings were created
readOnly: true
device_cert:
allOf:
- $ref: '#/components/schemas/org_setting_device_cert2'
- description: Common device certificate used by organization settings
device_updown_threshold:
maximum: 240
minimum: 0
type:
- integer
- 'null'
description: "Enable threshold-based device down delivery via\n * device-updowns webhooks topic, \n * Mist Alert Framework; e.g. send AP/SW/GW down event only if AP/SW/GW Up is not seen within the threshold in minutes; 0 - 240, default is 0 (trigger immediate)"
contentEncoding: int32
default: 0
disable_pcap:
type: boolean
description: Whether to disallow Mist to analyze pcap files (this is required for marvis pcap)
default: false
disable_remote_shell:
type: boolean
description: Whether to disable remote shell access for an entire org
default: false
for_site:
type: boolean
description: Read-only indicator that the settings object is scoped to a site
readOnly: true
gateway_mgmt:
allOf:
- $ref: '#/components/schemas/org_setting_gateway_mgmt2'
- description: Gateway management defaults for the organization
gateway_tunnel_updown_threshold:
minimum: 0
type:
- integer
- 'null'
description: enable threshold-based gateway tunnel (secure edge tunnels) up-down delivery.
contentEncoding: int32
gateway_updown_threshold:
maximum: 240
minimum: 0
type:
- integer
- 'null'
description: Enable threshold-based device down delivery for Gateway devices only. When configured it takes effect for GW devices and `device_updown_threshold` is ignored.
contentEncoding: int32
default: 0
examples:
- 10
id:
type: string
description: Unique identifier of the organization settings object
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
installer:
allOf:
- $ref: '#/components/schemas/org_setting_installer2'
- description: Access settings for organization installer workflows
jcloud:
allOf:
- $ref: '#/components/schemas/org_setting_jcloud2'
- description: Integration settings for JCloud
jcloud_ra:
allOf:
- $ref: '#/components/schemas/org_setting_jcloud_ra2'
- description: Routing Assurance integration settings for JCloud
juniper:
allOf:
- $ref: '#/components/schemas/account_juniper_info1'
- description: Linked Juniper account information for this organization
juniper_srx:
allOf:
- $ref: '#/components/schemas/org_setting_juniper_srx2'
- description: SRX integration settings for Juniper devices
junos_shell_access:
allOf:
- $ref: '#/components/schemas/org_setting_junos_shell_access2'
- description: Role-based Junos web-shell access settings
marvis:
allOf:
- $ref: '#/components/schemas/org_setting_marvis2'
- description: AI assistant and self-driving feature settings for Marvis
mgmt:
allOf:
- $ref: '#/components/schemas/org_setting_mgmt2'
- description: Tunnel settings for organization management connectivity
mist_nac:
allOf:
- $ref: '#/components/schemas/org_setting_mist_nac2'
- description: NAC settings for Mist Access Assurance
modified_time:
type: number
description: Epoch timestamp when the organization settings were last modified
readOnly: true
msp_id:
type: string
description: Managed service provider account associated with these settings
contentEncoding: uuid
readOnly: true
examples:
- b9d42c2e-88ee-41f8-b798-f009ce7fe909
mxedge_mgmt:
allOf:
- $ref: '#/components/schemas/mxedge_mgmt3'
- description: Management settings for Mist Edge devices
optic_port_config:
type: object
additionalProperties:
$ref: '#/components/schemas/optic_port_config_port'
description: Configuration defaults for optic ports
org_id:
type: string
description: Organization that owns these settings
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
password_policy:
allOf:
- $ref: '#/components/schemas/org_setting_password_policy'
- description: Admin credential policy settings for the organization
pcap:
allOf:
- $ref: '#/components/schemas/org_setting_pcap2'
- description: Packet capture settings for the organization
pcap_bucket_verified:
type: boolean
description: Whether the configured packet capture bucket has been verified
readOnly: true
security:
allOf:
- $ref: '#/components/schemas/org_setting_security2'
- description: Organization security controls such as local SSH restrictions
simple_alert:
allOf:
- $ref: '#/components/schemas/simple_alert3'
- description: Basic alert delivery settings for the organization
ssr:
allOf:
- $ref: '#/components/schemas/setting_ssr3'
- description: Session Smart Router settings for the organization
switch:
allOf:
- $ref: '#/components/schemas/org_setting_switch'
- description: Configuration defaults for switches in this organization
switch_mgmt:
allOf:
- $ref: '#/components/schemas/org_setting_switch_mgmt2'
- description: Management settings for switches in this organization
switch_updown_threshold:
type:
- integer
- 'null'
description: Enable threshold-based device down delivery for Switch devices only. When configured it takes effect for SW devices and `device_updown_threshold` is ignored.
contentEncoding: int32
default: 0
examples:
- 0
synthetic_test:
allOf:
- $ref: '#/components/schemas/synthetictest_config3'
- description: Configuration for organization synthetic tests
tags:
type: array
items:
type: string
description: Labels associated with these organization settings
ui_idle_timeout:
maximum: 480
minimum: 0
type: integer
description: Automatically logout the user when UI session is inactive. `0` means disabled
contentEncoding: int32
default: 0
examples:
- 10
ui_no_tracking:
type: boolean
description: Whether UI usage tracking is disabled for the organization
default: false
vpn_options:
allOf:
- $ref: '#/components/schemas/org_setting_vpn_options2'
- description: Options for organization VPN behavior
wan_pma:
allOf:
- $ref: '#/components/schemas/org_setting_wan_pma'
- description: PMA feature settings for WAN Assurance
wired_pma:
allOf:
- $ref: '#/components/schemas/org_setting_wired_pma'
- description: PMA feature settings for Wired Assurance
wireless_pma:
allOf:
- $ref: '#/components/schemas/org_setting_wireless_pma'
- description: PMA feature settings for Wireless Assurance
description: Organization-wide feature, integration, management, and security settings
org_setting_api_policy:
title: org_setting_api_policy
type: object
properties:
enforce_src_ips_for_tokens:
type: boolean
description: Optional. When `true`, Org API tokens without their own `src_ips` also respect the org policy `src_ips`. Default is `false`.
default: false
no_reveal:
type: boolean
description: >-
By default, API hides password/secrets when the user doesn't have write access
* `true`: API will hide passwords/secrets for all users
* `false`: API will hide passwords/secrets for read-only users
default: false
src_ips:
maxItems: 10
type: array
items:
type: string
description: Optional list of IP addresses or CIDR subnets from which org API access is allowed. At most 10 entries. The source IP of the request making this update must be within one of the specified subnets.
examples:
- - 63.3.56.0/24
- 63.3.55.4
description: Organization API response policy for hiding secrets and passwords
org_setting_auto_assignment_rule:
title: org_setting_auto_assignment_rule
required:
- src
type: object
properties:
create_new_site_if_needed:
type: boolean
description: If `src`==`geoip`. By default, a claimed device only gets assigned if the site exists to auto-create the site, enable this
default: false
expression:
type:
- string
- 'null'
description: "If `src`==`name`, `src`==`lldp_system_name`, `src`==`dns_suffix` \n \"[0:3]\" // \"abcdef\" -> \"abc\" \n \"split(.)[1]\" // \"a.b.c\" -> \"b\" \n \"split(-)[1][0:3]\" // \"a1234-b5678-c90\" -> \"b56\"'"
examples:
- split(.)[1]
gatewaytemplate_id:
type: string
description: If `src`==`geoip` and `create_new_site_if_needed`==`true`. If a gateway template is desired for this newly created site
match_country:
type: string
description: If `src`==`geoip`, country or region value that must match the device location
match_device_type:
allOf:
- $ref: '#/components/schemas/device_type_default_ap6'
- description: 'Device type filter that limits which claimed devices this rule applies to. enum: `ap`, `gateway`, `switch`.'
match_model:
type: string
description: Optional additional device model filter for this assignment rule
model:
type: string
description: If `src`==`model`, device model value to match
prefix:
type:
- string
- 'null'
description: If `src`==`name`, prefix that must be present in the device name
examples:
- XX-
src:
allOf:
- $ref: '#/components/schemas/org_setting_auto_site_assignment_src2'
- description: 'Source attribute used to evaluate the automatic assignment rule. enum: `ext_ip`, `dns_suffix`, `geoip`, `lldp_port_desc`, `lldp_system_name`, `model`, `name`, `subnet`.'
subnet:
type: string
description: If `src`==`subnet` or `ext_ip`==`ext_ip`
suffix:
type:
- string
- 'null'
description: If `src`==`name`, suffix that must be present in the device name
examples:
- -YY
value:
type: string
description: "If \n * `src`==`ext_ip`, `src`==`subnet` or `src`==`model`, the site name\n * `src`==`geoip`: site name for the device to be assigned to (\\\"city\\\" / \\\"city+country\\\" / ...)\""
description: Automatic assignment rule used by org settings
org_setting_auto_device_naming:
title: org_setting_auto_device_naming
type: object
properties:
enable:
type: boolean
description: Whether automatic device naming is enabled
rules:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/org_setting_auto_device_naming_rule'
description: List of rules used to derive device names automatically
description: Automatic device naming configuration for claimed devices
org_setting_auto_device_naming_rule:
title: org_setting_auto_device_naming_rule
type: object
properties:
expression:
type: string
description: "\"[0:3]\" // \"abcdef\" -> \"abc\" \n \"split(.)[1]\" // \"a.b.c\" -> \"b\" \n \"split(-)[1][0:3]\" // \"a1234-b5678-c90\" -> \"b56\"'"
examples:
- split(.)[1]
match_device:
allOf:
- $ref: '#/components/schemas/device_type_default_ap5'
- description: 'Device type filter for this naming rule. enum: `ap`, `gateway`, `switch`.'
prefix:
type: string
description: Text prepended to the generated device name
src:
allOf:
- $ref: '#/components/schemas/org_setting_auto_device_naming_rule_src2'
- description: 'Device attribute used to generate the name. enum: `lldp_port_desc`, `mac`.'
suffix:
type: string
description: Text appended to the generated device name
description: Automatic device naming rule
org_setting_auto_device_naming_rule_src:
title: org_setting_auto_device_naming_rule_src
enum:
- lldp_port_desc
- mac
type: string
description: 'Device attribute used to generate the name. enum: `lldp_port_desc`, `mac`'
org_setting_auto_deviceprofile_assignment:
title: org_setting_auto_deviceprofile_assignment
type: object
properties:
enable:
type: boolean
description: Whether automatic device profile assignment is enabled
rules:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/org_setting_auto_assignment_rule'
description: Assignment rules evaluated for automatic device profile selection
description: Automatic device profile assignment configuration
org_setting_auto_site_assignment:
title: org_setting_auto_site_assignment
type: object
properties:
enable:
type: boolean
description: Whether automatic site assignment is enabled
rules:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/org_setting_auto_assignment_rule'
description: Assignment rules evaluated for automatic site selection
description: Automatic site assignment configuration for claimed devices
org_setting_auto_site_assignment_src:
title: org_setting_auto_site_assignment_src
enum:
- ext_ip
- dns_suffix
- geoip
- lldp_port_desc
- lldp_system_name
- model
- name
- subnet
type: string
description: 'enum: `ext_ip`, `dns_suffix`, `geoip`, `lldp_port_desc`, `lldp_system_name`, `model`, `name`, `subnet`'
org_setting_auto_upgrade:
title: org_setting_auto_upgrade
type: object
properties:
custom_versions:
type: object
additionalProperties:
type: string
description: Per-AP-model firmware versions or channels used for auto-upgrade
examples:
- AP21: alpha
AP41: 0.1.5135
AP61: 0.1.7215
day_of_week:
allOf:
- $ref: '#/components/schemas/day_of_week3'
- description: 'Day of the week for the AP auto-upgrade maintenance window. enum: `any`, `fri`, `mon`, `sat`, `sun`, `thu`, `tue`, `wed`.'
enabled:
type: boolean
description: Whether AP auto-upgrade is enabled. Note that Mist may auto-upgrade APs if the running version is no longer supported.
default: false
time_of_day:
type: string
description: '`any` or HH:MM (24-hour format). Upgrade will happen within up to 1 hour from this time.'
examples:
- 12:00
version:
allOf:
- $ref: '#/components/schemas/site_auto_upgrade_version3'
- description: 'Firmware release channel or specific version used for AP auto-upgrade. enum: `beta`, `custom`, `stable`.'
examples:
- beta
description: Organization-wide AP automatic firmware upgrade policy
org_setting_cacerts_config:
title: org_setting_cacerts_config
required:
- cert
type: object
properties:
cert:
type: string
description: PEM-encoded CA certificate
examples:
- '-----BEGIN CERTIFICATE-----\nMIIFZjCCA06gAwIBAgIIP61/1qm/uDowDQYJKoZIhvcNAQELBQE\n-----END CERTIFICATE-----'
crl_enabled:
type: boolean
description: Whether CRL checks are enabled. When true, CRL from AIA is used if available unless `crl_url` is set.
default: true
crl_url:
type: string
description: Optional override URL for the certificate CRL distribution point
examples:
- https://crl.example.com/issuer1.crl
name:
type: string
description: Optional user-friendly label for the CA issuer configuration
examples:
- Issuer 1
ocsp_enabled:
type: boolean
description: Whether OCSP checks are enabled. When true, OCSP responder from AIA is used if available unless `ocsp_url` is set.
default: true
ocsp_url:
type: string
description: Optional override URL for the OCSP responder
examples:
- https://ocsp.example.com
description: Per-issuer CA certificate configuration used to verify client certificates
org_setting_celona:
title: org_setting_celona
type: object
properties:
api_key:
type: string
description: Credential used by Mist for the Celona integration
examples:
- $2a$04$OkaLCoJn6rDjR8ha.oduQVDST3.kJNIrte
api_prefix:
type: string
description: Celona API prefix configured for the integration
examples:
- cc3273fcb016470e
description: Integration settings for Celona
org_setting_cloudshark:
title: org_setting_cloudshark
type: object
properties:
apitoken:
type: string
description: Token used by Mist to access the CloudShark integration
examples:
- accbd6f10c6d05c3
url:
type: string
description: CloudShark Enterprise URL, if using a self-hosted CS Enterprise instance
examples:
- https://cloudshark.hosted.domain
description: Packet capture integration settings for CloudShark
org_setting_device_cert:
title: org_setting_device_cert
type: object
properties:
cert:
type: string
description: PEM-encoded common device certificate used by organization settings
examples:
- '-----BEGIN CERTIFICATE-----\nMIIFZjCCA06gAwIBAgIIP61/1qm/uDowDQYJKoZIhvcNAQELBQE\n-----END CERTIFICATE-----'
key:
type: string
description: Private key paired with the common device certificate
examples:
- '-----BEGIN PRI...'
description: Optional common device certificate configuration for organization settings
org_setting_gateway_mgmt:
title: org_setting_gateway_mgmt
type: object
properties:
app_probing:
allOf:
- $ref: '#/components/schemas/org_setting_gateway_mgmt_app_probing2'
- description: Application probing configuration applied to managed gateways
app_usage:
type: boolean
description: For SRX only, whether gateway application usage collection is enabled; requires App Track license
fips_enabled:
type: boolean
description: Whether FIPS mode is enabled for managed gateways
default: false
host_in_policies:
allOf:
- $ref: '#/components/schemas/org_setting_gateway_mgmt_host_in_policies2'
- description: Host-in access policies for gateway management services such as ICMP and SNMP
host_out_policies:
allOf:
- $ref: '#/components/schemas/org_setting_gateway_mgmt_host_out_policies2'
- description: Path preference policies for gateway-originated management traffic
overlay_ip:
allOf:
- $ref: '#/components/schemas/org_setting_gateway_mgmt_overlay_ip2'
- description: Overlay IP addresses used when gateway management traffic uses the overlay
description: Organization-level gateway management settings
org_setting_gateway_mgmt_app_probing:
title: org_setting_gateway_mgmt_app_probing
type: object
properties:
apps:
type: array
items:
type: string
description: Predefined application keys to probe from managed gateways
examples:
- - facebook
description: Application probing settings for organization gateway management
org_setting_gateway_mgmt_host_in_policies:
title: org_setting_gateway_mgmt_host_in_policies
type: object
properties:
icmp:
allOf:
- $ref: '#/components/schemas/org_setting_gateway_mgmt_host_in_policy3'
- description: Host-in access policy for ICMP traffic to managed gateways
snmp:
allOf:
- $ref: '#/components/schemas/org_setting_gateway_mgmt_host_in_policy1'
- description: Host-in access policy for SNMP traffic to managed gateways
description: Host-in access policies for gateway management services
org_setting_gateway_mgmt_host_in_policy:
title: org_setting_gateway_mgmt_host_in_policy
type: object
properties:
tenants:
uniqueItems: true
type: array
items:
type: string
description: Tenant names this host-in policy applies to
description: Host-in access policy for a gateway management service
org_setting_gateway_mgmt_host_out_policies:
title: org_setting_gateway_mgmt_host_out_policies
type: object
properties:
dns:
allOf:
- $ref: '#/components/schemas/gateway_mgmt_host_out_policy1'
- description: Path preference policy for gateway-originated DNS traffic
ntp:
allOf:
- $ref: '#/components/schemas/gateway_mgmt_host_out_policy2'
- description: Path preference policy for gateway-originated NTP traffic
syslog:
allOf:
- $ref: '#/components/schemas/gateway_mgmt_host_out_policy_syslog1'
- description: Path preference policy for gateway-originated syslog traffic
description: Optional path preferences for gateway-originated management traffic; ECMP is used across available paths when no preference is specified
org_setting_gateway_mgmt_overlay_ip:
title: org_setting_gateway_mgmt_overlay_ip
type: object
properties:
ip:
type: string
description: When it's going overlay, a routable IP to overlay will be required
node1_ip:
type: string
description: For SSR HA cluster, another IP for node1 will be required, too
description: Overlay IP configuration used for gateway management traffic
org_setting_installer:
title: org_setting_installer
type: object
properties:
allow_all_devices:
type: boolean
description: Whether installers may work with all eligible devices
allow_all_sites:
type: boolean
description: Whether installers may work with all sites
extra_site_ids:
type: array
items:
type: string
contentEncoding: uuid
description: Additional site IDs that installers may access
grace_period:
type: integer
description: Grace period, in days, during which installers can modify recent sites or devices
contentEncoding: int32
description: Organization-level permissions and grace period for installer workflows
org_setting_jcloud:
title: org_setting_jcloud
type: object
properties:
org_apitoken:
type: string
description: JCloud organization API token used by this Mist organization
org_apitoken_name:
type: string
description: Display name for the JCloud organization API token
org_id:
type: string
description: JCloud organization identifier linked to this Mist organization
description: JCloud integration settings for this Mist organization
org_setting_jcloud_ra:
title: org_setting_jcloud_ra
type: object
properties:
org_apitoken:
type: string
description: JCloud Routing Assurance Org Token
org_apitoken_name:
type: string
description: JCloud Routing Assurance Org Token Name
org_id:
type: string
description: JCloud Routing Assurance Org ID
description: JCloud Routing Assurance connexion
org_setting_juniper_srx:
title: org_setting_juniper_srx
type: object
properties:
auto_upgrade:
allOf:
- $ref: '#/components/schemas/juniper_srx_auto_upgrade1'
- description: SRX auto-upgrade settings applied when Juniper SRX devices are first onboarded
description: Organization settings for Juniper SRX devices
org_setting_junos_shell_access:
title: org_setting_junos_shell_access
type: object
properties:
admin:
allOf:
- $ref: '#/components/schemas/org_setting_junos_shell_access_admin2'
- description: 'Shell access level used for administrator web-shell sessions. enum: `admin`, `none`, `viewer`.'
helpdesk:
allOf:
- $ref: '#/components/schemas/org_setting_junos_shell_access_helpdesk2'
- description: 'Shell access level used for helpdesk web-shell sessions. enum: `admin`, `none`, `viewer`.'
read:
allOf:
- $ref: '#/components/schemas/org_setting_junos_shell_access_read2'
- description: 'Shell access level used for read-only web-shell sessions. enum: `admin`, `none`, `viewer`.'
write:
allOf:
- $ref: '#/components/schemas/org_setting_junos_shell_access_write2'
- description: 'Shell access level used for write-role web-shell sessions. enum: `admin`, `none`, `viewer`.'
description: "junos_shell_access: Manages role-based web-shell access. \nWhen junos_shell access is not defined (Default) - No additional users are configured and web-shell uses default `mist` user to login. \nWhen junos_shell_access is defined - Additional users mist-web-admin (admin permission), mist-web-viewer(viewer permission) are configured on the device and web-shell logs in with the mist-web-admin/mist-web-viewer user depending upon the shell access level. Setting the shell access level to \"none\", disables web-shell access for that specific role."
org_setting_junos_shell_access_admin:
title: org_setting_junos_shell_access_admin
enum:
- admin
- none
- viewer
type: string
description: 'enum: `admin`, `viewer`, `none`'
org_setting_junos_shell_access_helpdesk:
title: org_setting_junos_shell_access_helpdesk
enum:
- admin
- none
- viewer
type: string
description: 'enum: `admin`, `viewer`, `none`'
org_setting_junos_shell_access_read:
title: org_setting_junos_shell_access_read
enum:
- admin
- none
- viewer
type: string
description: 'enum: `admin`, `viewer`, `none`'
org_setting_junos_shell_access_write:
title: org_setting_junos_shell_access_write
enum:
- admin
- none
- viewer
type: string
description: 'enum: `admin`, `viewer`, `none`'
org_setting_marvis:
title: org_setting_marvis
type: object
properties:
disable_proactive_monitoring:
type: boolean
description: 'Disable proactive monitoring in Marvis. NOTE: support access must be enabled for the org (`allow_mist`=`true`) for proactive monitoring to function.'
default: false
self_driving:
allOf:
- $ref: '#/components/schemas/marvis_self_driving1'
- description: Self-driving network automation settings by domain
description: Organization settings for Marvis automation
org_setting_mgmt:
title: org_setting_mgmt
type: object
properties:
mxtunnel_ids:
type: array
items:
type: string
contentEncoding: uuid
description: Mist Tunnel IDs selected for management connectivity
use_mxtunnel:
type: boolean
description: Whether to use Mist Tunnel for mgmt connectivity, this takes precedence over use_wxtunnel
default: false
use_wxtunnel:
type: boolean
description: Whether to use wxtunnel for mgmt connectivity
default: false
description: Organization management connectivity settings
org_setting_mist_nac:
title: org_setting_mist_nac
type: object
properties:
allow_teap_machine_auth_only:
type: boolean
description: allow clients to connect even when the user cert failed. TEAP authenticates both Machine Cert and User Cert. When enabled, clients who only succeed Machine Cert authentication will be accepted.
default: false
cacerts:
type: array
items:
type: string
description: CA certificates trusted by Mist NAC for certificate-based authentication
default_idp_id:
type: string
description: use this IDP when no explicit realm present in the incoming username/CN OR when no IDP is explicitly mapped to the incoming realm.
disable_rsae_algorithms:
type: boolean
description: to disable RSAE_PSS_SHA256, RSAE_PSS_SHA384, RSAE_PSS_SHA512 from server side. see https://www.openssl.org/docs/man3.0/man1/openssl-ciphers.html
default: false
eap_ssl_security_level:
maximum: 4
minimum: 1
type: integer
description: eap ssl security level, see https://www.openssl.org/docs/man1.1.1/man3/SSL_CTX_set_security_level.html#DEFAULT-CALLBACK-BEHAVIOUR
contentEncoding: int32
default: 2
enable_eap_md5_for_mab:
type: boolean
description: 'Enable EAP-MD5 for MAB. WARNING: Not FIPS compliant, use only if required for legacy device support.'
default: false
eu_only:
type: boolean
description: By default, NAC POD failover considers all NAC pods available around the globe, i.e. EU, US, or APAC based, failover happens based on geo IP of the originating site. For strict GDPR compliance NAC POD failover would only happen between the PODs located within the EU environment, and no authentication would take place outside of EU. This is an org setting that is applicable to WLANs, switch templates, Mist Edge clusters that have mist_nac enabled
default: false
fingerprinting:
allOf:
- $ref: '#/components/schemas/org_setting_mist_nac_fingerprinting2'
- description: Client fingerprinting settings used by Mist NAC
idp_machine_cert_lookup_field:
allOf:
- $ref: '#/components/schemas/idp_machine_cert_lookup_field1'
- description: 'Client certificate field used to look up machine groups in identity providers. enum: `automatic`, `cn`, `dns`.'
idp_user_cert_lookup_field:
allOf:
- $ref: '#/components/schemas/idp_user_cert_lookup_field1'
- description: 'Client certificate field used to look up user groups in identity providers. enum: `automatic`, `cn`, `email`, `upn`.'
idps:
type: array
items:
$ref: '#/components/schemas/org_setting_mist_nac_idp'
description: Identity provider mappings used by Mist NAC realm matching
mdm:
allOf:
- $ref: '#/components/schemas/org_setting_mist_nac_mdm2'
- description: Mobile Device Management CoA settings for Mist NAC
server_cert:
allOf:
- $ref: '#/components/schemas/org_setting_mist_nac_server_cert'
- description: RADIUS server certificate presented by Mist NAC during EAP-TLS
use_ip_version:
allOf:
- $ref: '#/components/schemas/org_setting_mist_nac_ip_version2'
- description: 'IP version used by NAS devices and Mist Edge proxies to reach Mist NAC. enum: `v4`, `v6`.'
use_ssl_port:
type: boolean
description: By default, NAS devices (switches/aps) and proxies(mxedge) are configured to use port TCP2083(RadSec) to reach mist-nac. Set `use_ssl_port`==`true` to override that port with TCP43 (ssl), This is an org level setting that is applicable to wlans, switch_templates, and mxedge_clusters that have mist-nac enabled
default: false
usermac_expiry:
maximum: 1095
minimum: 0
type: integer
description: Allow customer to configure an expiry time for usermacs by attaching an `inactive_endpoint` label to those which have been inactive for the configured period of time (in days). 0 means no expiry
contentEncoding: int32
default: 0
examples:
- 30
description: Organization-level Mist NAC configuration
org_setting_mist_nac_fingerprinting:
title: org_setting_mist_nac_fingerprinting
type: object
properties:
enabled:
type: boolean
description: enable/disable writes to NAC DDB fingerprint table
default: false
generate_coa:
type: boolean
description: enable/disable CoA triggers on fingerprint change for wired clients, always port-bounce
default: false
generate_wireless_coa:
type: boolean
description: enable/disable CoA triggers on fingerprint change for wireless clients
default: false
wireless_coa_type:
allOf:
- $ref: '#/components/schemas/org_setting_mist_nac_fingerprinting_wireless_coa2'
- description: 'Change of Authorization action sent to wireless clients when fingerprints change. enum: `reauth`, `disconnect`.'
description: Client fingerprinting settings used for Mist NAC policy enforcement
org_setting_mist_nac_fingerprinting_wireless_coa:
title: org_setting_mist_nac_fingerprinting_wireless_coa
enum:
- reauth
- disconnect
type: string
description: 'Change of Authorization action sent to wireless clients when fingerprints change. enum: `reauth`, `disconnect`'
org_setting_mist_nac_idp:
title: org_setting_mist_nac_idp
type: object
properties:
exclude_realms:
type: array
items:
type: string
description: When the IDP is `mxedge_proxy` type, realms excluded from proxying in addition to other valid home realms in this org
id:
type: string
description: Unique identifier of the identity provider referenced by this Mist NAC mapping
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
user_realms:
type: array
items:
type: string
description: User realms that select this identity provider
description: Mist NAC identity provider realm mapping
org_setting_mist_nac_ip_version:
title: org_setting_mist_nac_ip_version
enum:
- v4
- v6
type: string
description: 'by default, NAS devices(switches/aps) and proxies(mxedge) are configured to reach mist-nac via IPv4. enum: `v4`, `v6`'
org_setting_mist_nac_mdm:
title: org_setting_mist_nac_mdm
type: object
properties:
coa_type:
allOf:
- $ref: '#/components/schemas/nac_coa_type2'
- description: 'Change of Authorization action sent for MDM posture changes. enum: `reauth`, `disconnect`.'
description: MDM (Mobile Device Management) CoA configuration
org_setting_mist_nac_server_cert:
title: org_setting_mist_nac_server_cert
type: object
properties:
cert:
type: string
description: PEM-encoded RADIUS server certificate presented during EAP-TLS
examples:
- '-----BEGIN CERTIFICATE-----\nMIIFZjCCA06gAwIBAgIIP61/1qm/uDowDQYJKoZIhvcNAQELBQE\n-----END CERTIFICATE-----'
key:
type: string
description: Private key paired with the Mist NAC RADIUS server certificate
contentEncoding: password
examples:
- '-----BEGIN PRI...'
password:
type: string
description: Optional password for the private key
contentEncoding: password
description: RADIUS server certificate presented by Mist NAC during EAP-TLS
org_setting_password_policy:
title: org_setting_password_policy
type: object
properties:
enabled:
type: boolean
description: Whether the policy is enabled
default: false
expiry_in_days:
maximum: 365
minimum: 1
type: integer
description: Password expiry in days. Password Expiry Notice banner will display in the UI 14 days before expiration
contentEncoding: int32
examples:
- 60
min_length:
type: integer
description: Minimum number of characters required for passwords
contentEncoding: int32
default: 8
requires_special_char:
type: boolean
description: Whether to require special character
default: false
requires_two_factor_auth:
type: boolean
description: Whether to require two-factor auth
default: false
description: Admin credential policy settings for the organization
org_setting_pcap:
title: org_setting_pcap
type: object
properties:
bucket:
type: string
description: Storage bucket name used for organization packet capture files
examples:
- myorg_pcap
max_pkt_len:
maximum: 128
type: integer
description: Maximum length of non-management packets to capture, in bytes
contentEncoding: int32
default: 128
examples:
- 128
description: Packet capture export settings for the organization
org_setting_scep:
title: org_setting_scep
type: object
properties:
cert_providers:
type: array
items:
$ref: '#/components/schemas/org_setting_scep_cert_provider'
description: Certificate providers enabled for Mist SCEP
enable:
type: boolean
description: Whether SCEP is enabled for this org
suspended:
type: boolean
description: Whether SCEP is suspended for this org
default: false
description: Mist SCEP settings for certificate enrollment
org_setting_scep_cert_provider:
title: org_setting_scep_cert_provider
enum:
- intune
- jamf
- byod
type: string
description: 'enum: `intune`, `jamf`, `byod`'
org_setting_scep_response:
title: org_setting_scep_response
type: object
properties:
cert_providers:
type: array
items:
$ref: '#/components/schemas/org_setting_scep_cert_provider'
description: Certificate providers configured for Mist SCEP
enabled:
type: boolean
description: Whether Mist SCEP is enabled for this organization
readOnly: true
intune_scep_url:
type: string
description: Intune SCEP enrollment URL for this organization
readOnly: true
examples:
- https://scep.mistsys.com/api/v1/incoming/intune/:org_id/scep
jamf_access_token:
type: string
description: Access token used by Jamf to call Mist SCEP
readOnly: true
examples:
- 1Z4QqEnCt05Jjt3TV5LgPJ4V_WL_RWnJ7dqVMLYHj81=
jamf_scep_url:
type: string
description: Jamf SCEP enrollment URL for this organization
readOnly: true
examples:
- https://scep.mistsys.com/api/v1/incoming/intune/:org_id/scep
jamf_webhook_url:
type: string
description: Jamf webhook URL for SCEP status callbacks
readOnly: true
examples:
- https://scep.mistsys.com/api/v1/webhook/jamf/:org_id/scep
suspended:
type: boolean
description: Whether SCEP is suspended for this org
default: false
description: Read-only Mist SCEP settings returned for the organization
org_setting_security:
title: org_setting_security
type: object
properties:
disable_local_ssh:
type: boolean
description: Whether to disable local SSH (by default, local SSH is enabled with allow_mist in Org is enabled
fips_zeroize_password:
type: string
description: password required to zeroize devices (FIPS) on site level
examples:
- NUKETHESITE
limit_ssh_access:
type: boolean
description: Whether to allow certain SSH keys to SSH into the AP (see Site:Setting)
default: false
description: Organization security controls for local SSH and FIPS zeroize access
org_setting_switch:
title: org_setting_switch
type: object
properties:
auto_upgrade:
allOf:
- $ref: '#/components/schemas/switch_auto_upgrade3'
- description: Auto-upgrade defaults for switches in this organization
description: Configuration defaults for switches in this organization
org_setting_switch_mgmt:
title: org_setting_switch_mgmt
type: object
properties:
ap_affinity_threshold:
type: integer
description: If the field is set in both site/setting and org/setting, the value from site/setting will be used.
contentEncoding: int32
default: 12
examples:
- 10
description: Organization-level switch management settings
org_setting_vpn_options:
title: org_setting_vpn_options
type: object
properties:
as_base:
maximum: 2147483647
minimum: 1
type: integer
description: Base BGP autonomous system number used for generated VPN configurations
contentEncoding: int32
enable_ipv6:
type: boolean
description: Whether IPv6 is enabled for organization VPN configuration
default: false
st_subnet:
type: string
description: requiring /12 or bigger to support 16 private IPs for 65535 gateways
default: 10.224.0.0/12
description: Organization VPN behavior options
org_setting_wan_pma:
title: org_setting_wan_pma
type: object
properties:
enabled:
type: boolean
description: Whether PMA is enabled for WAN Assurance
default: false
description: PMA feature settings for WAN Assurance
org_setting_wired_pma:
title: org_setting_wired_pma
type: object
properties:
enabled:
type: boolean
description: Whether PMA is enabled for Wired Assurance
default: false
description: PMA feature settings for Wired Assurance
org_setting_wireless_pma:
title: org_setting_wireless_pma
type: object
properties:
enabled:
type: boolean
description: Whether PMA is enabled for Wireless Assurance
default: true
description: PMA feature settings for Wireless Assurance
org_site_sle_type:
title: org_site_sle_type
enum:
- wan
- wifi
- wired
type: string
description: 'enum: `wan`, `wifi`, `wired`'
org_site_sle_wan_result:
title: org_site_sle_wan_result
required:
- gateway-health
- site_id
type: object
properties:
application_health:
type: number
description: Application health SLE score for this site
gateway-health:
type: number
description: Gateway health SLE score for this site
num_clients:
type: number
description: Number of WAN clients included in this site result
num_gateways:
type: number
description: Number of gateways included in this site result
site_id:
type: string
description: Site associated with this WAN SLE result
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
wan-link-health:
type: number
description: WAN link health SLE score for this site
description: WAN SLE scores and counts for one site
org_site_sle_wifi:
title: org_site_sle_wifi
required:
- end
- interval
- limit
- page
- results
- start
- total
type: object
properties:
end:
type: number
description: Query end timestamp for the returned SLE window
interval:
type: integer
description: Aggregation interval, in seconds, used for the SLE query
contentEncoding: int32
limit:
type: integer
description: Maximum number of site results returned per page
contentEncoding: int32
page:
type: integer
description: Result page number returned by the query
contentEncoding: int32
results:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/org_site_sle_wifi_result'
description: Wi-Fi SLE results for the current page
start:
type: number
description: Query start timestamp for the returned SLE window
total:
type: integer
description: Number of matching site results available for the query
contentEncoding: int32
description: Paginated Wi-Fi SLE results for organization sites
org_site_sle_wifi_result:
title: org_site_sle_wifi_result
required:
- ap-availability
- site_id
type: object
properties:
ap-availability:
type: number
description: AP availability SLE score for this site
ap-health:
type: number
description: AP health SLE score for this site
capacity:
type: number
description: Wi-Fi capacity SLE score for this site
coverage:
type: number
description: Wi-Fi coverage SLE score for this site
num_aps:
type: number
description: Number of APs included in this site result
num_clients:
type: number
description: Number of Wi-Fi clients included in this site result
roaming:
type: number
description: Wi-Fi roaming SLE score for this site
site_id:
type: string
description: Site associated with this Wi-Fi SLE result
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
successful-connect:
type: number
description: Successful connection SLE score for this site
throughput:
type: number
description: Wi-Fi throughput SLE score for this site
time-to-connect:
type: number
description: Client connection-time SLE score for this site
description: Wi-Fi SLE scores and counts for one site
org_site_sle_wired_result:
title: org_site_sle_wired_result
required:
- site_id
- switch-health
type: object
properties:
num_clients:
type: number
description: Number of wired clients included in this site result
num_switches:
type: number
description: Number of switches included in this site result
site_id:
type: string
description: Site associated with this wired SLE result
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
switch-bandwidth:
type: number
description: Switch bandwidth SLE score for this site
switch-health:
type: number
description: Switch health SLE score for this site
switch-throughput:
type: number
description: Switch throughput SLE score for this site
description: Wired SLE scores and counts for one site
org_site_wan_wifi:
title: org_site_wan_wifi
required:
- end
- interval
- limit
- page
- results
- start
- total
type: object
properties:
end:
type: number
description: Query end timestamp for the returned SLE window
interval:
type: integer
description: Aggregation interval, in seconds, used for the SLE query
contentEncoding: int32
limit:
type: integer
description: Maximum number of site results returned per page
contentEncoding: int32
page:
type: integer
description: Result page number returned by the query
contentEncoding: int32
results:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/org_site_sle_wan_result'
description: WAN SLE results for the current page
start:
type: number
description: Query start timestamp for the returned SLE window
total:
type: integer
description: Number of matching site results available for the query
contentEncoding: int32
description: Paginated WAN SLE results for organization sites
org_site_wired_wifi:
title: org_site_wired_wifi
required:
- end
- interval
- limit
- page
- results
- start
- total
type: object
properties:
end:
type: number
description: Query end timestamp for the returned SLE window
interval:
type: integer
description: Aggregation interval, in seconds, used for the SLE query
contentEncoding: int32
limit:
type: integer
description: Maximum number of site results returned per page
contentEncoding: int32
page:
type: integer
description: Result page number returned by the query
contentEncoding: int32
results:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/org_site_sle_wired_result'
description: Wired SLE results for the current page
start:
type: number
description: Query start timestamp for the returned SLE window
total:
type: integer
description: Number of matching site results available for the query
contentEncoding: int32
description: Paginated wired SLE results for organization sites
org_sites_count_distinct:
title: org_sites_count_distinct
enum:
- analytic_enabled
- app_waking
- asset_enabled
- auto_upgrade_enabled
- auto_upgrade_version
- country_code
- honeypot_enabled
- id
- locate_unconnected
- mesh_enabled
- name
- remote_syslog_enabled
- rogue_enabled
- rtsa_enabled
- vna_enabled
- wifi_enabled
type: string
description: 'enum: `analytic_enabled`, `app_waking`, `asset_enabled`, `auto_upgrade_enabled`, `auto_upgrade_version`, `country_code`, `honeypot_enabled`, `id`, `locate_unconnected`, `mesh_enabled`, `name`, `remote_syslog_enabled`, `rogue_enabled`, `rtsa_enabled`, `vna_enabled`, `wifi_enabled`'
org_ssl_proxy_cert:
title: org_ssl_proxy_cert
type: object
properties:
cert:
type: string
description: PEM-encoded SSL proxy certificate for the organization
examples:
- '-----BEGIN CERTIFICATE-----\nMIIowDQYJKoZIhvcNAQELBQE\n-----END CERTIFICATE-----'
description: SSL proxy certificate returned for the organization
org_system_event:
title: org_system_event
type: object
properties:
change_cat:
type: string
description: Category of configuration or administrative change for the event
examples:
- admin_action
metadata:
type: string
description: JSON-encoded event metadata, such as affected object IDs and admin details
org_id:
type: string
description: Organization where the system event occurred
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
scope:
type: string
description: Event scope, such as organization or site
examples:
- org
site_id:
type: string
description: Site associated with the event, when the event is site-scoped
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
timestamp:
type: number
description: Epoch timestamp when the system event occurred
readOnly: true
type:
type: string
description: System event type, such as `add-wlan` or `delete-wlan`
examples:
- delete-wlan
description: Organization system event record
org_tickets_count_distinct:
title: org_tickets_count_distinct
enum:
- status
- type
type: string
description: 'Distinct field used when counting organization tickets. enum: `status`, `type`'
org_tunnel_count_distinct:
title: org_tunnel_count_distinct
enum:
- ap
- auth_algo
- encrypt_algo
- ike_version
- ip
- last_event
- mac
- mxcluster_id
- mxedge_id
- node
- peer_host
- peer_ip
- peer_mxedge_id
- protocol
- remote_ip
- remote_port
- site_id
- state
- tunnel_name
- up
- wxtunnel_id
type: string
description: 'enum: `ap`, `auth_algo`, `encrypt_algo`, `ike_version`, `ip`, `last_event`, `mac`, `mxcluster_id`, `mxedge_id`, `node`, `peer_host`, `peer_ip`, `peer_mxedge_id`, `protocol`, `remote_ip`, `remote_port`, `site_id`, `state`, `tunnel_name`, `up`, `wxtunnel_id`'
org_tunnel_type_count:
title: org_tunnel_type_count
enum:
- wan
- wxtunnel
type: string
description: 'Tunnel type used when counting organization tunnels. enum: `wan`, `wxtunnel`'
org_ui_settings:
title: org_ui_settings
type: object
properties:
created_time:
type: number
description: Epoch timestamp when the databoard was created
readOnly: true
description:
type: string
description: Text describing the databoard
examples:
- This databoard shows AP stats
for_site:
type: boolean
description: Whether this databoard is scoped to a site
readOnly: true
examples:
- false
id:
type: string
description: Unique identifier of the databoard
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
isCustomDataboard:
type: boolean
description: Whether this is a custom databoard or not
modified_time:
type: number
description: Epoch timestamp when the databoard was last modified
readOnly: true
name:
type: string
description: Display name of the databoard
examples:
- AP Stats
org_id:
type: string
description: Organization that owns the databoard
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
purpose:
allOf:
- $ref: '#/components/schemas/org_ui_settings_purpose2'
- description: 'UI surface or purpose for this databoard. enum: `marvisdashboard`.'
site_id:
type: string
description: Site associated with the databoard when `for_site` is true
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
tiles:
type: array
items:
$ref: '#/components/schemas/org_ui_settings_tile'
description: Configured tiles for the databoard
description: Organization UI settings databoard
org_ui_settings_purpose:
title: org_ui_settings_purpose
const: marvisdashboard
type: string
description: 'UI surface or purpose for this databoard. enum: `marvisdashboard`'
org_ui_settings_tile:
title: org_ui_settings_tile
type: object
properties:
description:
type: string
description: Text describing the databoard tile
examples:
- This tile shows the top 10 APs by bandwidth
id:
type: string
description: Unique identifier of the databoard tile
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
isAutoTitle:
type: boolean
description: Whether the tile title is auto generated or not
name:
type: string
description: Display name of the databoard tile
examples:
- Top 10 APs by Bandwidth
nl_query:
type: string
description: Natural Language query for the tile
examples:
- List top 10 APs by bandwidth
position:
allOf:
- $ref: '#/components/schemas/org_ui_settings_tile_position2'
- description: Grid position and span for the databoard tile
description: Tile shown on an organization UI databoard
org_ui_settings_tile_position:
title: org_ui_settings_tile_position
type: object
properties:
col:
type: integer
description: Grid column index for the tile
contentEncoding: int32
examples:
- 1
colSpan:
type: integer
description: Grid column span for the tile
contentEncoding: int32
examples:
- 5
row:
type: integer
description: Grid row index for the tile
contentEncoding: int32
examples:
- 1
rowSpan:
type: integer
description: Grid row span for the tile
contentEncoding: int32
examples:
- 2
description: Grid position for a databoard tile
org_wan_clients_count_distinct:
title: org_wan_clients_count_distinct
enum:
- hostname
- ip
- mac
- mfg
- network
type: string
description: 'enum: `hostname`, `ip`, `mac`, `mfg`, `network`'
org_wan_clients_events_count_distinct:
title: org_wan_clients_events_count_distinct
enum:
- hostname
- ip
- mac
- mfg
- type
type: string
description: 'enum: `hostname`, `ip`, `mac`, `mfg`, `type`'
org_wired_clients_count_distinct:
title: org_wired_clients_count_distinct
enum:
- device_mac
- mac
- port_id
- site_id
- type
- vlan
type: string
description: 'enum: `device_mac`, `mac`, `port_id`, `site_id`, `type`, `vlan`'
orggroup:
title: orggroup
required:
- name
type: object
properties:
created_time:
type: number
description: Epoch timestamp when the organization group was created
readOnly: true
id:
type: string
description: Unique identifier of the organization group
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
modified_time:
type: number
description: Epoch timestamp when the organization group was last modified
readOnly: true
msp_id:
type: string
description: MSP account that owns the organization group
contentEncoding: uuid
readOnly: true
examples:
- b9d42c2e-88ee-41f8-b798-f009ce7fe909
name:
type: string
description: Display name of the organization group
org_ids:
type: array
items:
type: string
contentEncoding: uuid
description: Organizations included in this organization group
description: MSP organization group containing related organizations
ospf_area:
title: ospf_area
type: object
properties:
include_loopback:
type: boolean
description: Whether loopback interfaces are included in this OSPF area
default: false
networks:
type: object
additionalProperties:
$ref: '#/components/schemas/ospf_areas_network'
description: OSPF network settings keyed by network name
examples:
- corp:
auth_keys:
'1': auth-key-1
auth_type: md5
bfd_minimum_interval: 500
dead_interval: 40
hello_interval: 10
interface_type: nbma
metric: 10000
guest:
passive: true
type:
allOf:
- $ref: '#/components/schemas/ospf_area_type2'
- description: 'Area type for this OSPF area. enum: `default`, `nssa`, `stub`.'
examples:
- default
description: Property key is the OSPF Area (Area should be a number (0-255) / IP address)
ospf_area_network_auth_type:
title: ospf_area_network_auth_type
enum:
- md5
- none
- password
type: string
description: 'auth type. enum: `md5`, `none`, `password`'
examples:
- md5
ospf_area_network_interface_type:
title: ospf_area_network_interface_type
enum:
- broadcast
- nbma
- p2mp
- p2p
type: string
description: 'interface type (nbma = non-broadcast multi-access). enum: `broadcast`, `nbma`, `p2mp`, `p2p`'
ospf_area_type:
title: ospf_area_type
enum:
- default
- nssa
- stub
type: string
description: 'OSPF type. enum: `default`, `nssa`, `stub`'
examples:
- default
ospf_areas_network:
title: ospf_areas_network
type: object
properties:
auth_keys:
type: object
additionalProperties:
type: string
description: Required if `auth_type`==`md5`. Property key is the key number
examples:
- '1': auth-key-1
auth_password:
type: string
description: Required if `auth_type`==`password`, the password, max length is 8
examples:
- simple
auth_type:
allOf:
- $ref: '#/components/schemas/ospf_area_network_auth_type2'
- description: 'Authentication method used by this OSPF network. enum: `md5`, `none`, `password`.'
examples:
- md5
bfd_minimum_interval:
maximum: 255000
minimum: 1
type: integer
description: Minimum BFD interval for this OSPF network, in milliseconds
contentEncoding: int32
examples:
- 500
dead_interval:
maximum: 65535
minimum: 1
type: integer
description: OSPF dead interval for this network, in seconds
contentEncoding: int32
examples:
- 40
export_policy:
type: string
description: Routing policy used to export routes from this OSPF network
examples:
- export_policy
hello_interval:
maximum: 255
minimum: 1
type: integer
description: OSPF hello interval for this network, in seconds
contentEncoding: int32
import_policy:
type: string
description: Routing policy used to import routes for this OSPF network
examples:
- import_policy
interface_type:
allOf:
- $ref: '#/components/schemas/ospf_area_network_interface_type2'
- description: 'OSPF interface type used for this network. enum: `broadcast`, `nbma`, `p2mp`, `p2p`.'
metric:
maximum: 65535
minimum: 1
type:
- integer
- 'null'
description: OSPF metric assigned to this network
contentEncoding: int32
examples:
- 10000
no_readvertise_to_overlay:
type: boolean
description: By default, we'll re-advertise all learned OSPF routes toward overlay
default: false
passive:
type: boolean
description: Whether to send OSPF-Hello
default: false
description: Property key is the network name. Networks to participate in an OSPF area
ospf_peer_stats_count_distinct:
title: ospf_peer_stats_count_distinct
enum:
- site_id
- org_id
- mac
- peer_ip
- port_id
- state
- vrf_name
type: string
description: 'enum: `site_id`, `org_id`, `mac`, `peer_ip`, `port_id`, `state`, `vrf_name`'
ospf_peer_stats_search_result:
title: ospf_peer_stats_search_result
type: object
properties:
end:
type: integer
description: Query end timestamp for the OSPF peer statistics search
contentEncoding: int32
examples:
- 1711035686
limit:
type: integer
description: Maximum number of OSPF peer statistics returned per page
contentEncoding: int32
examples:
- 10
next:
type: string
description: URL for the next page of OSPF peer statistics, when available
results:
type: array
items:
$ref: '#/components/schemas/ospf_peer_stats_search_results_items'
description: OSPF peer statistic records returned for the current page
start:
type: integer
description: Query start timestamp for the OSPF peer statistics search
contentEncoding: int32
examples:
- 1710949286
total:
type: integer
description: Number of OSPF peer statistic records matching the search
contentEncoding: int32
examples:
- 232
description: Paginated OSPF peer statistics search result
ospf_peer_stats_search_results_items:
title: ospf_peer_stats_search_results_items
type: object
properties:
dead_time:
type: integer
description: Seconds remaining before the neighbor is considered inactive
contentEncoding: int32
mac:
type: string
description: Router MAC address of the device advertising the OSPF peer
org_id:
type: string
description: Organization identifier of the router reporting the peer state
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
peer_ip:
type: string
description: IP address of the OSPF neighbor
port_id:
type: string
description: Interface on which the OSPF neighbor is learned
priority:
maximum: 255
minimum: 0
type: integer
description: OSPF priority advertised by the neighbor, from 0 to 255
contentEncoding: int32
site_id:
type: string
description: Site identifier of the router reporting the peer state
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
state:
type: string
description: Eg. full, down, 2way, init, exstart, exchange, loading
timestamp:
type: number
description: Sampling time (in epoch seconds)
readOnly: true
up:
type: boolean
description: True if state is full
vrf_name:
type: string
description: Instance name, e.g. master
description: OSPF peer statistic record reported by a router
other_device_update:
title: other_device_update
type: object
properties:
device_mac:
type: string
description: Other-device MAC address to associate with a site
site_id:
type: string
description: Site ID to associate with the other device
contentEncoding: uuid
examples:
- 43e9c864-a7e4-4310-8031-d9817d2c5a43
description: Manual site association update for one other device
other_device_update_multi:
title: other_device_update_multi
required:
- op
type: object
properties:
macs:
type: array
items:
type: string
description: Other-device MAC addresses included in the bulk update
op:
allOf:
- $ref: '#/components/schemas/other_device_update_operation2'
- description: 'Action to perform on the other devices. enum: `assign`, `unassign`.'
site_id:
type: string
description: Site ID used when assigning other devices
contentEncoding: uuid
description: Bulk site assignment update for other devices
other_device_update_operation:
title: other_device_update_operation
enum:
- assign
- unassign
type: string
description: 'The operation being performed. enum: `assign`, `unassign`'
pcap_bucket:
title: pcap_bucket
required:
- bucket
type: object
properties:
bucket:
type: string
description: Customer bucket name to use for packet capture files
examples:
- company-private-pcap
description: Request to configure a custom packet capture bucket
pcap_bucket_verify:
title: pcap_bucket_verify
required:
- bucket
- verify_token
type: object
properties:
bucket:
type: string
description: Customer bucket name being verified for packet capture storage
examples:
- company-private-pcap
verify_token:
type: string
description: Token read from the MIST_TOKEN file written during bucket setup
examples:
- eyJhbGciOiJIUzI1J9.eyJzdWIiOiIxMjM0joiMjgxOG5MDIyfQ.2rzcRvMA3Eg09NnjCAC-1EWMRtxAnFDM
description: Request to verify ownership of a custom packet capture bucket
pcap_type:
title: pcap_type
enum:
- client
- gateway
- new_assoc
- radiotap
- radiotap,wired
- wired
- wireless
type: string
description: 'enum: `client`, `gateway`, `new_assoc`, `radiotap`, `radiotap,wired`, `wired`, `wireless`'
examples:
- client
pma_dashboard:
title: pma_dashboard
type: object
properties:
description:
type: string
description: Human-readable summary of the PMA dashboard
examples:
- Dashboard 1 description
label:
type: string
description: Group label that categorizes the PMA dashboard
examples:
- Wireless
name:
type: string
description: Display name of the PMA dashboard
examples:
- dashboard_1
url:
type: string
description: Access URL that redirects the user to the PMA dashboard
examples:
- https://api.mist.com/api/v1/forward/looker?jwt=...
description: PMA dashboard metadata and redirect URL
poe_priority:
title: poe_priority
enum:
- low
- high
type: string
description: 'PoE priority. enum: `low`, `high`'
port_auth_state:
title: port_auth_state
enum:
- authenticated
- authenticating
- held
- init
type: string
description: 'Port authentication state. enum: `""`, `authenticated`, `authenticating`, `held`, `init`'
port_stp_role:
title: port_stp_role
enum:
- alternate
- backup
- designated
- disabled
- root
- root-prevented
type: string
description: 'Spanning Tree Protocol role for the port. enum: `""`, `alternate`, `backup`, `designated`, `disabled`, `root`, `root-prevented`'
port_stp_state:
title: port_stp_state
enum:
- blocking
- disabled
- forwarding
- learning
- listening
type: string
description: 'Spanning Tree Protocol state for the port. enum: `""`, `blocking`, `disabled`, `forwarding`, `learning`, `listening`'
portal_template_alignment:
title: portal_template_alignment
enum:
- center
- left
- right
type: string
description: 'defines alignment on portal. enum: `center`, `left`, `right`'
privilege_msp:
title: privilege_msp
required:
- role
- scope
type: object
properties:
org_id:
type: string
description: If `scope`==`org`, organization ID this MSP privilege applies to
contentEncoding: uuid
org_name:
type: string
description: Name of the org (for a site belonging to org)
readOnly: true
orggroup_id:
type: string
description: If `scope`==`orggroup`, organization group ID this MSP privilege applies to
contentEncoding: uuid
role:
allOf:
- $ref: '#/components/schemas/privilege_msp_role2'
- description: 'Access role granted by this MSP privilege. enum: `admin`, `helpdesk`, `installer`, `read`, `write`.'
scope:
allOf:
- $ref: '#/components/schemas/privilege_msp_scope2'
- description: 'MSP hierarchy level where this privilege applies. enum: `msp`, `org`, `orggroup`.'
views:
type: array
items:
$ref: '#/components/schemas/admin_privilege_view'
description: UI views allowed by custom role restrictions
description: MSP privilege scope and role settings
privilege_msp_role:
title: privilege_msp_role
enum:
- admin
- helpdesk
- installer
- read
- write
type: string
description: 'access permissions. enum: `admin`, `helpdesk`, `installer`, `read`, `write`'
privilege_msp_scope:
title: privilege_msp_scope
enum:
- msp
- org
- orggroup
type: string
description: 'enum: `msp`, `org`, `orggroup`'
privilege_org_role:
title: privilege_org_role
enum:
- admin
- helpdesk
- installer
- read
- write
type: string
description: 'access permissions. enum: `admin`, `helpdesk`, `installer`, `read`, `write`'
privilege_org_scope:
title: privilege_org_scope
enum:
- org
- site
- sitegroup
- orgsites
type: string
description: 'enum: `org`, `site`, `sitegroup`, `orgsites`'
protect_re:
title: protect_re
type: object
properties:
allowed_services:
type: array
items:
$ref: '#/components/schemas/protect_re_allowed_service'
description: Built-in services explicitly allowed by the Protect RE policy
examples:
- - icmp
- ssh
custom:
type: array
items:
$ref: '#/components/schemas/protect_re_custom'
description: Additional ACL entries allowed by the Protect RE policy
enabled:
type: boolean
description: >-
When enabled, all traffic that is not essential to our operation will be dropped
e.g. ntp / dns / traffic to mist will be allowed by default
if dhcpd is enabled, we'll make sure it works
default: false
hit_count:
type: boolean
description: Whether to enable hit count for Protect_RE policy
default: false
trusted_hosts:
type: array
items:
type: string
description: Trusted host or subnet entries allowed by the Protect RE policy
description: "Restrict inbound-traffic to host\nwhen enabled, all traffic that is not essential to our operation will be dropped \ne.g. ntp / dns / traffic to mist will be allowed by default, if dhcpd is enabled, we'll make sure it works"
protect_re_allowed_service:
title: protect_re_allowed_service
enum:
- icmp
- ssh
type: string
description: 'Services allowed through protect-RE filters. enum: `icmp`, `ssh`'
protect_re_custom:
title: protect_re_custom
type: object
properties:
port_range:
type: string
description: Matched dst port, "0" means any
default: '0'
examples:
- 80,1035-1040
protocol:
allOf:
- $ref: '#/components/schemas/protect_re_custom_protocol2'
- description: 'Transport protocol matched by this custom Protect RE ACL. enum: `any`, `icmp`, `tcp`, `udp`.'
subnets:
type: array
items:
type: string
description: Source subnets matched by this custom Protect RE ACL
description: Custom Protect RE ACL entry
protect_re_custom_protocol:
title: protect_re_custom_protocol
enum:
- any
- icmp
- tcp
- udp
type: string
description: 'enum: `any`, `icmp`, `tcp`, `udp`'
proxy:
title: proxy
type: object
properties:
disabled:
type: boolean
description: Whether this proxy configuration is disabled
default: false
examples:
- true
url:
type: string
description: Proxy URL used to reach Mist
examples:
- https://proxy.corp.com:8080/
description: Proxy Configuration to talk to Mist
psk:
title: psk
required:
- name
- passphrase
- ssid
type: object
properties:
admin_sso_id:
type: string
description: sso id for psk created from psk portal
readOnly: true
created_time:
type: number
description: Epoch timestamp when the PSK was created
readOnly: true
email:
type: string
description: Notification recipient email address for PSK creation notification and expiration reminders
expire_time:
type:
- integer
- 'null'
description: Expire time for this PSK key (epoch time in seconds). Default `null` (as no expiration)
contentEncoding: int32
examples:
- 1614990263
expiry_notification_time:
type: integer
description: Number of days before psk is expired. Used as to when to start sending reminder notification when the psk is about to expire
contentEncoding: int32
id:
type: string
description: Unique identifier of the PSK
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
mac:
type: string
description: If `usage`==`single`, client MAC address this PSK is bound to; empty when auto-binding is used
macs:
type: array
items:
type: string
description: Client MAC addresses or MAC patterns allowed when `usage`==`macs`
examples:
- - 112233abcedf
- aabbcc*
max_usage:
type: integer
description: For Org PSK Only. Max concurrent users for this PSK key. Default is 0 (unlimited)
contentEncoding: int32
default: 0
modified_time:
type: number
description: Epoch timestamp when the PSK was last modified
readOnly: true
name:
type: string
description: Display name of the PSK
note:
type: string
description: Admin note or description stored with the PSK
notify_expiry:
type: boolean
description: If set to true, reminder notification will be sent when psk is about to expire
default: false
notify_on_create_or_edit:
type: boolean
description: If set to true, notification will be sent when psk is created or edited
old_passphrase:
type: string
description: previous passphrase of the PSK if it has been rotated
org_id:
type: string
description: Organization that owns the org-level PSK
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
passphrase:
maxLength: 64
minLength: 8
type: string
description: PSK passphrase, 8-63 characters or 64 hexadecimal characters
contentEncoding: password
role:
maxLength: 32
minLength: 0
type: string
description: Client role applied to users authenticated with this PSK
site_id:
type: string
description: Site associated with the site-level PSK
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
ssid:
type: string
description: WLAN SSID where this PSK can be used
usage:
allOf:
- $ref: '#/components/schemas/psk_usage2'
- description: 'Binding mode for this PSK, enum: `macs`, `multi`, `single`, `usermac_labels`'
usermac_labels:
maxItems: 100
type: array
items:
type: string
description: Usermac labels allowed when `usage`==`usermac_labels`; this list is capped at 100 entries
examples:
- - iot
- students
vlan_id:
oneOf:
- type: string
- maximum: 4094
minimum: 1
type: integer
contentEncoding: int32
description: VLAN ID returned for clients using this PSK
vlan_name:
type: string
description: VLAN name to be assigned. Optional, `vlan_id` takes precedence if both are provided
description: Personal pre-shared key configuration for WLAN access
psk_id_list:
title: psk_id_list
type: object
properties:
psk_ids:
type: array
items:
type: string
contentEncoding: uuid
description: PSK IDs to delete
examples:
- - 0039c16c-ca87-4d3f-bb94-b97c58199f18
- 6562cc8e-5893-418a-acaa-4d7c1af8084f
description: PSK delete request payload
psk_portal:
title: psk_portal
required:
- name
- ssid
type: object
properties:
auth:
allOf:
- $ref: '#/components/schemas/psk_portal_auth2'
- description: 'Portal access method, enum: `sponsor`, `sso`'
bg_image_url:
type: string
description: URL of the background image used by the PSK portal
cleanup_psk:
type: boolean
description: Whether to clean up existing PSKs when the portal is deleted or its SSID changes
default: false
created_time:
type: number
description: Epoch timestamp when the PSK portal was created
readOnly: true
expire_time:
type: integer
description: PSK lifetime, in minutes, for keys created through this portal
contentEncoding: int32
expiry_notification_time:
type: integer
description: Number of days before PSK expiration to start sending reminder notifications
contentEncoding: int32
hide_psks_created_by_other_admins:
type: boolean
description: Only if `type`==`admin`, hide PSKs created by other PSK admins
default: false
id:
type: string
description: Unique identifier of the PSK portal
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
max_usage:
minimum: 0
type: integer
description: Maximum concurrent clients for each PSK created through this portal; `0` means unlimited
contentEncoding: int32
default: 0
modified_time:
type: number
description: Epoch timestamp when the PSK portal was last modified
readOnly: true
name:
type: string
description: Display name of the PSK portal
notification_renew_url:
type: string
description: Optional renewal URL included in notification emails. Use a custom URL, a Mist-generated URL, or a shortened URL pointing to either
examples:
- https://custom-sso/url
notify_expiry:
type: boolean
description: Whether to send reminder notifications before PSKs created through this portal expire
notify_on_create_or_edit:
type: boolean
description: Whether to send notifications when a PSK is created or edited through this portal
default: false
org_id:
type: string
description: Organization that owns the PSK portal
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
passphrase_rules:
allOf:
- $ref: '#/components/schemas/psk_portal_passphrase_rules2'
- description: Generation rules for PSK passphrases created through this portal
required_fields:
type: array
items:
type: string
description: User information fields requested by the portal when generating a PSK
role:
type: string
description: Client role assigned to PSKs created through this portal
ssid:
type: string
description: WLAN SSID for PSKs created through this portal
sso:
allOf:
- $ref: '#/components/schemas/psk_portal_sso2'
- description: Single sign-on configuration used when `auth`==`sso`
template_url:
type: string
description: URL of the UI customization template for this portal
thumbnail_url:
type: string
description: URL of the thumbnail image used by the PSK portal
type:
allOf:
- $ref: '#/components/schemas/psk_portal_type2'
- description: Portal mode for personal PSK onboarding, either admin or BYOD
ui_url:
type: string
description: Public URL where users access the PSK portal
vlan_id:
oneOf:
- type: string
- maximum: 4094
minimum: 1
type: integer
contentEncoding: int32
description: VLAN ID returned for clients using PSKs from this portal
description: Self-service portal configuration for issuing personal PSKs
psk_portal_auth:
title: psk_portal_auth
enum:
- sponsor
- sso
type: string
description: 'Portal access method for guest authentication, either `sponsor` or `sso`. enum: `sponsor`, `sso`'
psk_portal_image:
title: psk_portal_image
type: object
properties:
file:
type: string
description: Image binary payload to upload for the PSK portal
contentEncoding: base64
json:
type: string
description: Metadata JSON string describing the PSK portal image upload
description: PSK portal image upload payload
psk_portal_passphrase_rules:
title: psk_portal_passphrase_rules
type: object
properties:
alphabets_enabled:
type: boolean
description: Whether generated passphrases may include alphabetic characters
default: true
length:
maximum: 63
minimum: 8
type: integer
description: Fixed generated passphrase length used when min and max length are not both valid
contentEncoding: int32
max_length:
maximum: 63
minimum: 8
type: integer
description: Maximum generated passphrase length when paired with a valid `min_length`. If `max_length` or `min_length` is invalid, the portal uses `length`; if `length` is unset or invalid, it uses 8. Valid values are integers from 8 through 63, and `max_length` must be greater than `min_length`
contentEncoding: int32
min_length:
maximum: 63
minimum: 8
type: integer
description: Minimum generated passphrase length when paired with a valid `max_length`. If `max_length` or `min_length` is invalid, the portal uses `length`; if `length` is unset or invalid, it uses 8. Valid values are integers from 8 through 63, and `max_length` must be greater than `min_length`
contentEncoding: int32
numerics_enabled:
type: boolean
description: Whether generated passphrases may include numeric characters
default: true
symbols:
type: string
description: Allowed symbol characters for generated passphrases
examples:
- ()[]{}_%@#&$
symbols_enabled:
type: boolean
description: Whether generated passphrases may include symbols
default: true
description: Passphrase generation rules for PSKs created through a portal
psk_portal_sso:
title: psk_portal_sso
type: object
properties:
allowed_roles:
type: array
items:
type: string
description: SSO roles allowed to access the PSK portal; if empty, any role is permitted
idp_cert:
type: string
description: Identity provider signing certificate in PEM format
idp_sign_algo:
allOf:
- $ref: '#/components/schemas/psk_portal_sso_idp_sign_algo2'
- description: 'SAML assertion signing algorithm expected from the identity provider. enum: `sha1`, `sha256`, `sha384`, `sha512`.'
idp_sso_url:
type: string
description: Identity provider SSO URL for SAML login
issuer:
type: string
description: SAML issuer value for the identity provider
nameid_format:
type: string
description: SAML NameID format used for the portal login
role_mapping:
type: object
additionalProperties:
type: string
description: Maps PSK portal role names to SSO attribute values
use_sso_role_for_psk_role:
type: boolean
description: Whether to use SSO role mapping for the PSK role and ignore the portal-level `role` field
description: Single sign-on settings used when `auth`==`sso`
psk_portal_sso_idp_sign_algo:
title: psk_portal_sso_idp_sign_algo
enum:
- sha1
- sha256
- sha384
- sha512
type: string
description: 'Signing algorithm for SAML Assertion. enum: `sha1`, `sha256`, `sha384`, `sha512`. enum: `sha1`, `sha256`, `sha384`, `sha512`'
psk_portal_template:
title: psk_portal_template
type: object
properties:
portal_template:
allOf:
- $ref: '#/components/schemas/psk_portal_template_setting2'
- description: Template settings for customizing the PSK portal UI
description: Portal UI customization payload
psk_portal_template_setting:
title: psk_portal_template_setting
type: object
properties:
alignment:
allOf:
- $ref: '#/components/schemas/portal_template_alignment2'
- description: 'Logo and text alignment for the PSK portal template. enum: `center`, `left`, `right`.'
color:
type: string
description: Primary hex color used by the portal template
default: '#1074bc'
logo:
type:
- string
- 'null'
description: Custom logo with "data:image/png;base64," format. default null, uses Juniper Mist Logo
poweredBy:
type: boolean
description: Whether to hide "Powered by Juniper Mist" and email footers
default: false
tos:
type: boolean
description: Whether to show Terms of Service
tosAcceptLabel:
type: string
description: Terms of Service accept button label
default: I accept the Terms of Service
tosError:
type: string
description: Error message shown when the user has not accepted the Terms of Service
default: Please review and accept the Terms of Service
tosLink:
type: string
description: Terms of Service link label displayed in the portal footer
default: Terms of Service
tosText:
type: string
description: Terms of Service text displayed in the footer when Terms are enabled
default: << provide your Terms of Service here >>
tosUrl:
type: string
description: Custom URL for the Terms of Service policy
examples:
- https://company.com/wifi-policy
description: Custom UI settings for the PSK portal template
psk_portal_type:
title: psk_portal_type
enum:
- admin
- byod
type: string
description: 'for personal psk portal. enum: `admin`, `byod`'
psk_usage:
title: psk_usage
enum:
- macs
- multi
- single
- usermac_labels
type: string
description: 'enum: `macs`, `multi`, `single`, `usermac_labels`'
psks_import_file:
title: psks_import_file
type: object
properties:
file:
type: string
description: Uploaded CSV or binary file containing PSKs to import
contentEncoding: base64
description: Multipart upload payload for importing PSKs
push_policy_push_window:
title: push_policy_push_window
type: object
properties:
enabled:
type: boolean
description: Whether configuration pushes are limited to the configured push window
default: false
hours:
allOf:
- $ref: '#/components/schemas/hours1'
- description: Day-of-week hour ranges when configuration pushes are allowed
description: If enabled, new config will only be pushed to device within the specified time window
radio_band_24_usage:
title: radio_band_24_usage
enum:
- '24'
- '5'
- '6'
- auto
type: string
description: 'enum: `24`, `5`, `6`, `auto`'
radio_band_antenna_beam_pattern:
title: radio_band_antenna_beam_pattern
enum:
- narrow
- medium
- wide
type: string
description: 'enum: `narrow`, `medium`, `wide`'
radio_band_antenna_mode:
title: radio_band_antenna_mode
enum:
- 1x1
- 2x2
- 3x3
- 4x4
- default
type: string
description: 'enum: `1x1`, `2x2`, `3x3`, `4x4`, `default`'
examples:
- default
radio_band_preamble:
title: radio_band_preamble
enum:
- auto
- long
- short
type: string
description: 'enum: `auto`, `long`, `short`'
radius_acct_server:
title: radius_acct_server
required:
- host
- secret
type: object
properties:
host:
type: string
description: Address or hostname of the RADIUS accounting server
examples:
- 1.2.3.4
keywrap_enabled:
type: boolean
description: Whether RADIUS keywrap is enabled for messages sent to this accounting server
keywrap_format:
allOf:
- $ref: '#/components/schemas/radius_keywrap_format1'
- description: 'Encoding format for RADIUS keywrap KEK and MACK values. enum: `ascii`, `hex`.'
keywrap_kek:
type: string
description: RADIUS keywrap key encryption key (KEK)
examples:
- '1122334455'
keywrap_mack:
type: string
description: RADIUS keywrap message authentication code key (MACK)
examples:
- '1122334455'
port:
anyOf:
- maximum: 65545
minimum: 1
type: integer
contentEncoding: int32
- type: string
description: UDP port used by the RADIUS accounting server
secret:
type: string
description: Shared secret used with this RADIUS accounting server
contentEncoding: password
examples:
- testing123
description: RADIUS accounting server settings
radius_auth_server:
title: radius_auth_server
required:
- host
- secret
type: object
properties:
host:
type: string
description: Address or hostname of the RADIUS authentication server
examples:
- 1.2.3.4
keywrap_enabled:
type: boolean
description: Whether RADIUS keywrap is enabled for messages sent to this authentication server
keywrap_format:
allOf:
- $ref: '#/components/schemas/radius_keywrap_format1'
- description: 'Encoding format for RADIUS keywrap KEK and MACK values. enum: `ascii`, `hex`.'
keywrap_kek:
type: string
description: RADIUS keywrap key encryption key (KEK)
examples:
- '1122334455'
keywrap_mack:
type: string
description: RADIUS keywrap message authentication code key (MACK)
examples:
- '1122334455'
port:
anyOf:
- maximum: 65545
minimum: 1
type: integer
contentEncoding: int32
- type: string
description: UDP port used by the RADIUS authentication server
require_message_authenticator:
type: boolean
description: Whether to require Message-Authenticator in requests
default: false
secret:
type: string
description: Shared secret used with this RADIUS authentication server
contentEncoding: password
examples:
- testing123
description: RADIUS authentication server settings
radius_config:
title: radius_config
type: object
properties:
acct_interim_interval:
maximum: 65535
minimum: 0
type: integer
description: How frequently should interim accounting be reported, 60-65535. default is 0 (use one specified in Access-Accept request from RADIUS Server). Very frequent messages can affect the performance of the RADIUS server, 600 and up is recommended when enabled
contentEncoding: int32
default: 0
acct_servers:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/radius_acct_server'
description: RADIUS accounting servers used by this Junos configuration
auth_servers:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/radius_auth_server'
description: RADIUS authentication servers used by this Junos configuration
auth_servers_retries:
type: integer
description: Number of RADIUS authentication request retries before failover
contentEncoding: int32
default: 3
auth_servers_timeout:
type: integer
description: RADIUS authentication server timeout, in seconds
contentEncoding: int32
default: 5
coa_enabled:
type: boolean
description: Whether RADIUS Change of Authorization (CoA) is enabled
default: false
coa_port:
maximum: 65535
minimum: 1
type: integer
description: UDP port used for RADIUS Change of Authorization (CoA)
contentEncoding: int32
default: 3799
network:
type: string
description: Use `network` or `source_ip`. Network where the RADIUS server resides; if the network has a static IP, Mist uses it as the source IP
source_ip:
type: string
description: Use `network` or `source_ip`. Explicit source IP address for RADIUS traffic
description: Junos RADIUS authentication and accounting configuration
radius_keywrap_format:
title: radius_keywrap_format
enum:
- ascii
- hex
type: string
description: 'Encoding format for RADIUS keywrap KEK and MACK values. enum: `ascii`, `hex`'
radsec:
title: radsec
type: object
properties:
coa_enabled:
type: boolean
description: Whether RADIUS Change of Authorization (CoA) is enabled for RadSec traffic
default: false
enabled:
type: boolean
description: Whether RadSec is enabled
idle_timeout:
anyOf:
- type: integer
contentEncoding: int32
default: 60
- type: string
description: Idle timeout, in seconds, for RadSec connections
mxcluster_ids:
type: array
items:
type: string
contentEncoding: uuid
description: Mist Edge cluster IDs used as RadSec proxies when the WLAN does not use mxtunnel
proxy_hosts:
type: array
items:
type: string
description: RadSec proxy hostnames advertised to APs
server_name:
type: string
description: TLS server name to verify against the CA certificates in Org Setting. Only if not Mist Edge.
examples:
- radsec.abc.com
servers:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/radsec_server'
description: External RadSec servers. Only if not Mist Edge.
use_mxedge:
type: boolean
description: Whether to use organization Mist Edge instances as RadSec proxies
use_site_mxedge:
type: boolean
description: Whether to use site Mist Edge instances when this WLAN does not use mxtunnel
default: false
description: RadSec settings for sending RADIUS traffic over TLS
radsec_server:
title: radsec_server
type: object
properties:
host:
type: string
description: Address or hostname of the RadSec server
examples:
- 1.1.1.1
port:
maximum: 65535
minimum: 1
type: integer
description: TCP port used by the RadSec server
contentEncoding: int32
examples:
- 1812
description: External RadSec server settings
random_mac:
title: random_mac
enum:
- 'true'
- 'false'
type: string
description: 'Whether the client is using randomized MAC address or not. enum: `true`, `false`'
recaptcha:
title: recaptcha
type: object
properties:
flavor:
allOf:
- $ref: '#/components/schemas/recaptcha_flavor1'
- description: CAPTCHA provider used for registration, such as Google reCAPTCHA or hCaptcha
examples:
- hcaptcha
required:
type: boolean
description: Whether CAPTCHA verification is required for registration
sitekey:
type: string
description: Public site key used to render the selected CAPTCHA provider
description: CAPTCHA settings returned for admin registration
recaptcha_flavor:
title: recaptcha_flavor
enum:
- google
- hcaptcha
type: string
description: 'CAPTCHA provider flavor. enum: `google`, `hcaptcha`'
examples:
- hcaptcha
recover:
title: recover
required:
- email
type: object
properties:
email:
maxLength: 64
type: string
description: Admin email address requesting password recovery
examples:
- test@mistsys.com
recaptcha:
type: string
description: CAPTCHA verification token submitted with the recovery request
recaptcha_flavor:
allOf:
- $ref: '#/components/schemas/recaptcha_flavor3'
- description: 'CAPTCHA provider flavor used for recovery verification. enum: `google`, `hcaptcha`.'
examples:
- hcaptcha
description: Password recovery request submitted for an administrator account
remote_syslog:
title: remote_syslog
type: object
properties:
archive:
allOf:
- $ref: '#/components/schemas/remote_syslog_archive3'
- description: Retention settings for generated syslog archive files
cacerts:
type: array
items:
type: string
description: CA certificates used to verify TLS syslog servers
examples:
- - '-----BEGIN CERTIFICATE-----\nMIIFZjCCA06gAwIBAgIIP61/1qm/uDowDQYJKoZIhvcNAQELBQE\n-----END CERTIFICATE-----'
- '-----BEGIN CERTIFICATE-----\nBhMCRVMxFDASBgNVBAoMC1N0YXJ0Q29tIENBMSwwKgYDVn-----END CERTIFICATE-----'
console:
allOf:
- $ref: '#/components/schemas/remote_syslog_console2'
- description: Log forwarding filters for console messages sent to remote syslog
enabled:
type: boolean
description: Whether remote syslog forwarding is enabled
default: false
files:
type: array
items:
$ref: '#/components/schemas/remote_syslog_file_config'
description: Local syslog file definitions to generate and forward
network:
type: string
description: Source network used for syslog traffic. If `source_address` is configured, Mist uses the VLAN first; otherwise it uses `source_ip`
examples:
- default
send_to_all_servers:
type: boolean
description: Whether each log entry is sent to all configured remote syslog servers
default: false
servers:
type: array
items:
$ref: '#/components/schemas/remote_syslog_server'
description: Remote syslog server destinations
examples:
- - facility: config
host: syslogd.internal
port: 514
protocol: udp
severity: info
tag: ''
time_format:
allOf:
- $ref: '#/components/schemas/remote_syslog_time_format2'
- description: 'Timestamp format used in forwarded syslog messages. enum: `millisecond`, `year`, `year millisecond`.'
examples:
- millisecond
users:
type: array
items:
$ref: '#/components/schemas/remote_syslog_user'
description: User-specific syslog logging rules
description: Remote syslog forwarding settings
remote_syslog_archive:
title: remote_syslog_archive
type: object
properties:
files:
anyOf:
- type: string
- type: integer
contentEncoding: int32
description: Number of archived syslog files to retain
examples:
- '20'
size:
type: string
description: Maximum size of each archived syslog file, such as 5m
examples:
- 5m
description: Syslog file archive retention settings
remote_syslog_console:
title: remote_syslog_console
type: object
properties:
contents:
type: array
items:
$ref: '#/components/schemas/remote_syslog_content'
description: Syslog facilities and severities forwarded from console logs
description: Console log forwarding filters for remote syslog
remote_syslog_content:
title: remote_syslog_content
type: object
properties:
facility:
allOf:
- $ref: '#/components/schemas/remote_syslog_facility3'
- description: 'Syslog facility to match for this selector. enum: `any`, `authorization`, `change-log`, `config`, `conflict-log`, `daemon`, `dfc`, `external`, `firewall`, `ftp`, `interactive-commands`, `kernel`, `ntp`, `pfe`, `security`, `user`.'
examples:
- config
severity:
allOf:
- $ref: '#/components/schemas/remote_syslog_severity3'
- description: 'Syslog severity to match for this selector. enum: `alert`, `any`, `critical`, `emergency`, `error`, `info`, `notice`, `warning`.'
description: Syslog message content selector for remote logging
remote_syslog_facility:
title: remote_syslog_facility
enum:
- any
- authorization
- change-log
- config
- conflict-log
- daemon
- dfc
- external
- firewall
- ftp
- interactive-commands
- kernel
- ntp
- pfe
- security
- user
type: string
description: 'enum: `any`, `authorization`, `change-log`, `config`, `conflict-log`, `daemon`, `dfc`, `external`, `firewall`, `ftp`, `interactive-commands`, `kernel`, `ntp`, `pfe`, `security`, `user`'
examples:
- config
remote_syslog_file_config:
title: remote_syslog_file_config
type: object
properties:
archive:
allOf:
- $ref: '#/components/schemas/remote_syslog_archive1'
- description: Retention settings for this generated syslog file
contents:
type: array
items:
$ref: '#/components/schemas/remote_syslog_content'
description: Syslog facilities and severities written to this file
enable_tls:
type: boolean
description: Only if `protocol`==`tcp`, enable TLS for this syslog file destination
explicit_priority:
type: boolean
description: Whether to include explicit syslog priority values in file output
file:
type: string
description: Generated syslog file name
examples:
- file-name
match:
type: string
description: Expression used to filter log messages written to this file
examples:
- '!alarm|ntp|errors.crc_error[chan]'
structured_data:
type: boolean
description: Whether to include structured syslog data in file output
description: Generated syslog file output settings
remote_syslog_server:
title: remote_syslog_server
type: object
properties:
contents:
type: array
items:
$ref: '#/components/schemas/remote_syslog_content'
description: Syslog facilities and severities sent to this server
explicit_priority:
type: boolean
description: Whether to include explicit syslog priority values in messages sent to this server
facility:
allOf:
- $ref: '#/components/schemas/remote_syslog_facility1'
- description: 'Default syslog facility for messages sent to this server. enum: `any`, `authorization`, `change-log`, `config`, `conflict-log`, `daemon`, `dfc`, `external`, `firewall`, `ftp`, `interactive-commands`, `kernel`, `ntp`, `pfe`, `security`, `user`.'
examples:
- config
host:
type: string
description: Address or hostname of the remote syslog server
examples:
- syslogd.internal
match:
type: string
description: Expression used to filter log messages sent to this server
examples:
- '!alarm|ntp|errors.crc_error[chan]'
port:
anyOf:
- maximum: 65545
minimum: 1
type: integer
contentEncoding: int32
default: 514
- type: string
description: Network port used by the remote syslog server
protocol:
allOf:
- $ref: '#/components/schemas/remote_syslog_server_protocol2'
- description: 'Transport protocol used for this remote syslog server. enum: `tcp`, `udp`.'
routing_instance:
type: string
description: Routing instance used to reach this remote syslog server
examples:
- routing-instance-name
server_name:
type: string
description: TLS server name used when verifying the remote syslog server certificate
examples:
- syslogd.internal
severity:
allOf:
- $ref: '#/components/schemas/remote_syslog_severity1'
- description: 'Default syslog severity for messages sent to this server. enum: `alert`, `any`, `critical`, `emergency`, `error`, `info`, `notice`, `warning`.'
source_address:
type: string
description: Source address for syslog traffic. If configured, Mist uses the VLAN first; otherwise it uses `source_ip`
structured_data:
type: boolean
description: Whether to include structured syslog data in messages sent to this server
tag:
type: string
description: Syslog tag value added to messages sent to this server
description: Remote syslog server destination settings
remote_syslog_server_protocol:
title: remote_syslog_server_protocol
enum:
- tcp
- udp
type: string
description: 'Transport protocol used for this remote syslog server. enum: `tcp`, `udp`'
remote_syslog_severity:
title: remote_syslog_severity
enum:
- alert
- any
- critical
- emergency
- error
- info
- notice
- warning
type: string
description: 'enum: `alert`, `any`, `critical`, `emergency`, `error`, `info`, `notice`, `warning`'
remote_syslog_time_format:
title: remote_syslog_time_format
enum:
- millisecond
- year
- year millisecond
type: string
description: 'enum: `millisecond`, `year`, `year millisecond`'
examples:
- millisecond
remote_syslog_user:
title: remote_syslog_user
type: object
properties:
contents:
type: array
items:
$ref: '#/components/schemas/remote_syslog_content'
description: Syslog facilities and severities logged for this user rule
match:
type: string
description: Expression used to filter user log messages
examples:
- '"!alarm|ntp|errors.crc_error[chan]"'
user:
type: string
description: Account name or wildcard matched by this syslog rule
examples:
- '*'
description: User-specific syslog logging rule
replace_device:
title: replace_device
type: object
properties:
discard:
type: array
items:
type: string
description: Existing device attributes that should not be copied to the replacement device
inventory_mac:
type: string
description: MAC address of the claimed, unassigned inventory device that will replace the old device
examples:
- 5c5b35000301
mac:
type: string
description: Device MAC address being replaced
examples:
- 5c5b35000101
site_id:
type: string
description: Site containing the device being replaced
contentEncoding: uuid
examples:
- 4ac1dcf4-9d8b-7211-65c4-057819f0862b
tunterm_port_config:
allOf:
- $ref: '#/components/schemas/tunterm_port_config1'
- description: Tunnel termination Ethernet port configuration for a Mist Edge replacement
description: Request payload for replacing an inventory device with a claimed, unassigned device
resolution:
title: resolution
enum:
- default
- fine
type: string
description: 'Location resolution mode for map or placement calculations. enum: `default`, `fine`'
response_anomaly_search:
title: response_anomaly_search
required:
- end
- limit
- page
- results
- start
type: object
properties:
end:
type: integer
description: Search window end timestamp for anomaly results, in epoch seconds
contentEncoding: int32
examples:
- 1711035686
limit:
type: integer
description: Maximum number of anomaly results requested per page
contentEncoding: int32
examples:
- 10
page:
type: integer
description: Current page number in the anomaly search results
contentEncoding: int32
examples:
- 1
results:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/anomaly'
description: Anomaly records returned for this page
start:
type: integer
description: Search window start timestamp for anomaly results, in epoch seconds
contentEncoding: int32
examples:
- 1710949286
total:
type: integer
description: Number of anomaly records matching the search
contentEncoding: int32
examples:
- 232
description: Paginated anomaly search response
response_assign_success:
title: response_assign_success
required:
- success
type: object
properties:
success:
uniqueItems: true
type: array
items:
type: string
description: Messages describing successful assignment results
description: Assignment operation success response
response_async_claim_create:
title: response_async_claim_create
type: object
properties:
claim_id:
type: string
description: Unique identifier for the async claim job, used to poll status
contentEncoding: uuid
inventory_pending:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/response_claim_license_inventory_pending_item'
description: Inventory devices queued for async claim processing
description: Response to an async inventory claim request
response_async_claim_status:
title: response_async_claim_status
type: object
properties:
claim_id:
type: string
description: Unique identifier of the async claim job
contentEncoding: uuid
completed:
type: array
items:
type: string
description: Device MAC addresses that completed async claim processing
details:
type: array
items:
$ref: '#/components/schemas/response_async_license_detail'
description: Per-device status details for async claim processing; present when `detail=true`
failed:
type: integer
description: Number of devices that failed claim processing
contentEncoding: int32
incompleted:
type: array
items:
type: string
description: Device MAC addresses not yet completed in async claim processing
org_id:
type: string
description: Organization that owns the async claim job
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
processed:
type: integer
description: Number of devices processed so far
contentEncoding: int32
scheduled_at:
type: integer
description: Epoch timestamp when the async claim was scheduled
contentEncoding: int32
status:
allOf:
- $ref: '#/components/schemas/response_async_license_status3'
- description: 'Current async claim processing state. enum: `prepared`, `ongoing`, `done`.'
succeed:
type: integer
description: Number of devices that successfully completed claim processing
contentEncoding: int32
timestamp:
type: number
description: Epoch timestamp of the last status report
readOnly: true
total:
type: integer
description: Total number of devices included in the claim
contentEncoding: int32
description: Async inventory claim job status
response_async_claims_list:
title: response_async_claims_list
type: object
properties:
claims:
type: array
items:
$ref: '#/components/schemas/response_async_claim_status'
description: Async claim job status records
description: List of async inventory claim jobs for the organization
response_async_license:
title: response_async_license
type: object
properties:
completed:
type: array
items:
type: string
description: Device MAC addresses that completed asynchronous license claim processing
details:
type: array
items:
$ref: '#/components/schemas/response_async_license_detail'
description: Per-device status details for asynchronous license claim processing
failed:
type: integer
description: Number of devices that failed license claim processing
contentEncoding: int32
incompleted:
type: array
items:
type: string
description: Device MAC addresses not yet completed in asynchronous license claim processing
processed:
type: integer
description: Number of devices processed so far by asynchronous license claim
contentEncoding: int32
scheduled_at:
type: integer
description: Epoch timestamp when the asynchronous license claim was scheduled
contentEncoding: int32
status:
allOf:
- $ref: '#/components/schemas/response_async_license_status1'
- description: 'Current asynchronous license claim processing state. enum: `prepared`, `ongoing`, `done`.'
succeed:
type: integer
description: Number of devices that successfully completed license claim processing
contentEncoding: int32
timestamp:
type: number
description: Epoch timestamp when this asynchronous license status was reported
readOnly: true
total:
type: integer
description: Number of devices included in the license claim
contentEncoding: int32
description: Asynchronous license claim progress response
response_async_license_detail:
title: response_async_license_detail
type: object
properties:
mac:
type: string
description: Device MAC address for this license claim detail
status:
type: string
description: Claim processing state for this device
timestamp:
type: number
description: Epoch timestamp when this device claim status was reported
readOnly: true
description: Per-device asynchronous license claim status
response_async_license_status:
title: response_async_license_status
enum:
- prepared
- ongoing
- done
type: string
description: 'Processing state for an asynchronous license claim. enum: `prepared`, `ongoing`, `done`'
response_auto_map_assignment:
title: response_auto_map_assignment
type: object
properties:
devices:
type: object
additionalProperties:
$ref: '#/components/schemas/response_auto_map_assignment_device'
description: Per-device validation results for auto map assignment, keyed by device MAC address
estimated_runtime:
type: integer
description: Estimated runtime for the process in seconds
contentEncoding: int32
reason:
type: string
description: Provides the reason for the status
started:
type: boolean
description: Indicates whether the auto map assignment process has started
valid:
type: boolean
description: Indicates whether the auto map assignment request is valid
description: Auto map assignment start response
response_auto_map_assignment_apply:
title: response_auto_map_assignment_apply
required:
- accepted_maps
- message
type: object
properties:
accepted_maps:
type: array
items:
type: string
contentEncoding: uuid
description: List of map IDs that were successfully accepted
message:
type: string
description: Human-readable description of the operation result
description: Result returned after applying accepted auto map assignments
response_auto_map_assignment_clear:
title: response_auto_map_assignment_clear
required:
- message
- rejected_maps
type: object
properties:
message:
type: string
description: Human-readable description of the operation result
rejected_maps:
type: array
items:
type: string
contentEncoding: uuid
description: List of map IDs that were successfully rejected
description: Result returned after clearing auto map assignment candidates
response_auto_map_assignment_device:
title: response_auto_map_assignment_device
type: object
properties:
reason:
type: string
description: Provides the reason for the status if the AP is invalid
valid:
type: boolean
description: Indicates whether the device meets requirements for auto map assignment
description: Per-device validation result for auto map assignment
response_auto_map_assignment_info:
title: response_auto_map_assignment_info
required:
- status
type: object
properties:
est_time_left:
type: number
description: Only when `status`==`in_progress`, estimated seconds remaining
start_time:
type: number
description: Unix timestamp when auto map assignment was started
status:
allOf:
- $ref: '#/components/schemas/response_auto_map_assignment_info_status2'
- description: 'Current auto map assignment processing state. enum: `not_started`, `in_progress`, `completed`, `error`.'
stop_time:
type: number
description: Only when `status`==`completed`, Unix timestamp when auto map assignment stopped
time_updated:
type: number
description: Unix timestamp when status was last updated
description: Auto map assignment status response
response_auto_map_assignment_info_status:
title: response_auto_map_assignment_info_status
enum:
- not_started
- in_progress
- completed
- error
type: string
description: >-
The status of auto map assignment for a given site. enum:
* `not_started`: Auto map assignment has not been requested
* `in_progress`: Auto map assignment is currently processing
* `completed`: The auto map assignment process has completed
* `error`: There was an error in the auto map assignment process
response_auto_orientation:
title: response_auto_orientation
type: object
properties:
devices:
type: object
additionalProperties:
$ref: '#/components/schemas/response_auto_orientation_device'
description: Per-device validation results for auto orientation, keyed by device MAC address
estimated_runtime:
type: integer
description: Estimated runtime for the process in seconds
contentEncoding: int32
reason:
type: string
description: Provides the reason for the status.
started:
type: boolean
description: Indicates whether the auto orient process has started.
valid:
type: boolean
description: Indicates whether the auto orient request is valid.
wifi_interrupting:
type: boolean
description: Indicates whether the auto orient process will interrupt WiFi traffic.
description: Auto orientation start response
response_auto_orientation_device:
title: response_auto_orientation_device
type: object
properties:
reason:
type: string
description: Provides the reason for the status if the AP is invalid.
valid:
type: boolean
description: Indicates whether the auto orient request is valid for the device.
description: Per-device validation result for auto orientation
response_auto_orientation_info:
title: response_auto_orientation_info
type: object
properties:
est_time_left:
type: number
description: Only when `status`==`inprogress`, estimate of the time to completion
start_time:
type: number
description: Timestamp when auto orient process was last queued for this map
status:
allOf:
- $ref: '#/components/schemas/response_auto_orientation_info_status2'
- description: 'Current auto orientation processing state. enum: `pending`, `inprogress`, `done`, `error`.'
stop_time:
type: number
description: Timestamp when auto orient completed or was manually stopped
description: Auto orientation status response
response_auto_orientation_info_status:
title: response_auto_orientation_info_status
enum:
- pending
- inprogress
- done
- error
type: string
description: >-
The status of auto orient for a given map. enum:
* `pending`: Auto orient has not been requested for this map
* `inprogress`: Auto orient is currently processing
* `done`: The auto orient process has completed
* `error`: There was an error in the auto orient process
response_auto_placement_info:
title: response_auto_placement_info
type: object
properties:
end_time:
type: number
description: Timestamp when autoplacement completed or was manually stopped
est_time_left:
type: number
description: (Only when inprogress) estimate of the time to completion
start_time:
type: integer
description: Timestamp when autoplacement process was last queued for this map
contentEncoding: int32
status:
allOf:
- $ref: '#/components/schemas/auto_placement_info_status1'
- description: 'Current autoplacement processing state. enum: `done`, `error`, `inprogress`, `pending`.'
description: Auto-placement status response with progress and validation details
response_auto_zone:
title: response_auto_zone
type: object
properties:
status:
allOf:
- $ref: '#/components/schemas/response_auto_zone_status2'
- description: 'Current auto zones service state for the map. enum: `in_progress`, `awaiting_review`, `not_started`, `error`.'
zones:
type: array
items:
$ref: '#/components/schemas/response_auto_zone_zone'
description: Suggested zones awaiting review for the map
description: Auto zones status and suggested zone response
response_auto_zone_status:
title: response_auto_zone_status
enum:
- in_progress
- awaiting_review
- not_started
- error
type: string
description: 'Status of auto-zone generation for a map. enum: `in_progress`, `awaiting_review`, `not_started`, `error`. `not_started` means the service has not run or results were cleared, `in_progress` means generation is active, `awaiting_review` means suggested zones are ready for review, and `error` means generation failed'
response_auto_zone_zone:
title: response_auto_zone_zone
type: object
properties:
name:
type: string
description: Human-readable name of the suggested zone
examples:
- zone1
vertices:
type: array
items:
$ref: '#/components/schemas/response_auto_zone_zone_vertex'
description: Polygon vertices defining the suggested zone on the map image
description: Suggested zone returned by the auto zones service
response_auto_zone_zone_vertex:
title: response_auto_zone_zone_vertex
type: object
properties:
x:
type: integer
description: Horizontal pixel coordinate of the vertex
contentEncoding: int32
examples:
- 10
y:
type: integer
description: Vertical pixel coordinate of the vertex
contentEncoding: int32
examples:
- 42
description: Pixel coordinate for a suggested zone vertex
response_autoplacement:
title: response_autoplacement
type: object
properties:
devices:
type: object
additionalProperties:
$ref: '#/components/schemas/response_autoplacement_device'
description: Per-device validation results for autoplacement, keyed by AP MAC address
readOnly: true
estimated_runtime:
type: integer
description: Estimated runtime for the process in seconds.
contentEncoding: int32
readOnly: true
reason:
type: string
description: Provides the reason for the status.
readOnly: true
started:
type: boolean
description: Indicates whether the autoplacement process has started.
readOnly: true
valid:
type: boolean
description: Indicates whether the autoplacement request is valid.
readOnly: true
wifi_interrupting:
type: boolean
description: Indicates whether the auto placement process will interrupt WiFi traffic.
description: Auto-placement start response returned after scheduling the run
response_autoplacement_device:
title: response_autoplacement_device
type: object
properties:
reason:
type: string
description: Provides the reason for the status if the AP is invalid.
readOnly: true
valid:
type: boolean
description: Indicates whether the ap is valid.
readOnly: true
description: Per-AP validation result for autoplacement
response_call_troubleshoot_summary:
title: response_call_troubleshoot_summary
type: object
properties:
mac:
type: string
description: Client MAC address for the summarized call troubleshooting result
examples:
- 983a78ea4a44
meeting_id:
type: string
description: Meeting identifier for the summarized call troubleshooting result
contentEncoding: uuid
examples:
- b784d744-9a7c-4fad-9af0-f78858a319b1
results:
type: array
items:
$ref: '#/components/schemas/call_troubleshoot_summary'
description: Summary troubleshooting results returned for matching calls
description: Site call troubleshooting summary response
response_certificate:
title: response_certificate
required:
- cert
type: object
properties:
cert:
type: string
description: Current organization CA certificate in PEM format
pending_cert:
type: string
description: Pending auto-renewed organization CA certificate returned when the current certificate nears expiry
pending_cert_expiry:
type: integer
description: Epoch timestamp when the pending certificate is expected to replace the current certificate
contentEncoding: int32
description: If the current Org CA certificate is set to expire within 30 days, a pending certificate will be returned along with the expected auto-renewal timestamp.
response_claim_license:
title: response_claim_license
required:
- inventory_added
- inventory_duplicated
- license_added
- license_duplicated
- license_error
type: object
properties:
inventory_added:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/response_claim_license_inventory_item'
description: Inventory devices added by the claim operation
inventory_duplicated:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/response_claim_license_inventory_item'
description: Inventory devices already present during the claim operation
inventory_pending:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/response_claim_license_inventory_pending_item'
description: Inventory devices pending asynchronous claim processing
license_added:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/response_claim_license_license_item'
description: License entitlements added by the claim operation
license_duplicated:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/response_claim_license_license_item'
description: License entitlements already present during the claim operation
license_error:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/response_claim_license_license_error_item'
description: License claim errors returned by order number
description: Result of claiming licenses or activation codes
response_claim_license_inventory_item:
title: response_claim_license_inventory_item
required:
- mac
- magic
- model
- serial
- type
type: object
properties:
mac:
type: string
description: Device MAC address for the claimed inventory item
magic:
type: string
description: Activation code or claim code associated with the inventory item
model:
type: string
description: Device model for the claimed inventory item
serial:
type: string
description: Device serial number for the claimed inventory item
type:
type: string
description: Device type for the claimed inventory item
description: Inventory device returned by a license claim
response_claim_license_inventory_pending_item:
title: response_claim_license_inventory_pending_item
type: object
properties:
mac:
type: string
description: Device MAC address pending asynchronous inventory claim
description: Inventory device pending asynchronous claim processing
response_claim_license_license_item:
title: response_claim_license_license_item
required:
- end
- quantity
- start
- type
type: object
properties:
end:
type: integer
description: Epoch timestamp when the license entitlement ends
contentEncoding: int32
quantity:
type: integer
description: Number of license units included in the entitlement
contentEncoding: int32
start:
type: integer
description: Epoch timestamp when the license entitlement starts
contentEncoding: int32
type:
type: string
description: License SKU or subscription type
description: License entitlement returned by a claim operation
response_claim_license_license_error_item:
title: response_claim_license_license_error_item
required:
- order
- reason
type: object
properties:
order:
type: string
description: License order number or claim identifier that failed
reason:
type: string
description: Explanation of why the license order could not be claimed
description: License order that could not be claimed
response_claim_mx_edge:
title: response_claim_mx_edge
required:
- id
- magic
type: object
properties:
id:
type: string
description: Unique identifier assigned to the claimed Mist Edge
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
magic:
type: string
description: Claim magic token returned for the Mist Edge
description: Mist Edge claim response
response_client_events_search:
title: response_client_events_search
required:
- end
- limit
- results
- start
- total
type: object
properties:
end:
type: integer
description: Search window end timestamp for client events, in epoch seconds
contentEncoding: int32
limit:
type: integer
description: Maximum number of client event results requested
contentEncoding: int32
next:
type: string
description: URL for the next page of client event results
results:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/events_client'
description: Client event records returned for this page
start:
type: integer
description: Search window start timestamp for client events, in epoch seconds
contentEncoding: int32
total:
type: integer
description: Number of client event records matching the search
contentEncoding: int32
description: Paginated client event search response
response_client_nac_search:
title: response_client_nac_search
type: object
properties:
end:
type: integer
description: Search window end timestamp for NAC clients, in epoch seconds
contentEncoding: int32
examples:
- 1513362753
limit:
type: integer
description: Maximum number of NAC client results requested
contentEncoding: int32
examples:
- 3
next:
type: string
description: URL for the next page of NAC client results
results:
type: array
items:
$ref: '#/components/schemas/client_nac'
description: NAC client records returned for this page
start:
type: integer
description: Search window start timestamp for NAC clients, in epoch seconds
contentEncoding: int32
examples:
- 1513276353
total:
type: integer
description: Number of NAC client records matching the search
contentEncoding: int32
examples:
- 2
description: Paginated NAC client search response
response_client_search:
title: response_client_search
required:
- end
- limit
- results
- start
- total
type: object
properties:
end:
type: number
description: Search window end timestamp for wireless clients, in epoch seconds
limit:
type: integer
description: Maximum number of wireless client results requested
contentEncoding: int32
next:
type: string
description: URL for the next page of wireless client results
results:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/client_wireless'
description: Wireless client records returned for this page
start:
type: number
description: Search window start timestamp for wireless clients, in epoch seconds
total:
type: integer
description: Number of wireless client records matching the search
contentEncoding: int32
description: Paginated wireless client search response
response_client_sessions_search:
title: response_client_sessions_search
required:
- end
- limit
- results
- start
- total
type: object
properties:
end:
type: integer
description: Search window end timestamp for wireless client sessions, in epoch seconds
contentEncoding: int32
limit:
type: integer
description: Maximum number of wireless client session results requested
contentEncoding: int32
next:
type: string
description: URL for the next page of wireless client session results
results:
type: array
items:
$ref: '#/components/schemas/response_client_sessions_search_item'
description: Wireless client session records returned for this page
start:
type: integer
description: Search window start timestamp for wireless client sessions, in epoch seconds
contentEncoding: int32
total:
type: integer
description: Number of wireless client session records matching the search
contentEncoding: int32
description: Paginated wireless client session search response
response_client_sessions_search_item:
title: response_client_sessions_search_item
required:
- ap
- band
- client_manufacture
- connect
- disconnect
- duration
- mac
- org_id
- site_id
- ssid
- timestamp
- wlan_id
type: object
properties:
ap:
type: string
description: Access point MAC address associated with the client session
readOnly: true
band:
type: string
description: Radio band used by the client session
readOnly: true
client_manufacture:
type: string
description: Manufacturer reported for the client device
readOnly: true
connect:
type: number
description: Epoch timestamp when the client session connected
readOnly: true
disconnect:
type: number
description: Epoch timestamp when the client session disconnected
readOnly: true
duration:
type: number
description: Length of the client session, in seconds
readOnly: true
mac:
type: string
description: Client MAC address for the session
readOnly: true
org_id:
type: string
description: Organization associated with the client session
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
site_id:
type: string
description: Site associated with the client session
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
ssid:
type: string
description: WLAN SSID used by the client session
readOnly: true
tags:
type: array
items:
type: string
description: Event or classification tags attached to the client session
readOnly: true
timestamp:
type: number
description: Epoch timestamp when the client session record was observed
readOnly: true
wlan_id:
type: string
description: WLAN identifier associated with the client session
contentEncoding: uuid
description: Wireless client session record
response_config_history_search:
title: response_config_history_search
required:
- end
- limit
- results
- start
- total
type: object
properties:
end:
type: integer
description: Search window end timestamp for config history, in epoch seconds
contentEncoding: int32
limit:
type: integer
description: Maximum number of config history entries requested
contentEncoding: int32
next:
type: string
description: URL for the next page of config history results
results:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/response_config_history_search_item'
description: Device config history entries returned for this page
start:
type: integer
description: Search window start timestamp for config history, in epoch seconds
contentEncoding: int32
total:
type: integer
description: Number of config history entries matching the search
contentEncoding: int32
description: Paginated device config history search response
response_config_history_search_item:
title: response_config_history_search_item
required:
- channel_24
- channel_5
- secpolicy_violated
- timestamp
- version
type: object
properties:
channel_24:
type: integer
description: 2.4 GHz channel configured in this history entry
contentEncoding: int32
channel_5:
type: integer
description: 5 GHz channel configured in this history entry
contentEncoding: int32
radio_macs:
uniqueItems: true
type: array
items:
type: string
description: Radio MAC addresses included in this config history entry
radios:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/response_config_history_search_item_radio'
description: Radio configuration details included in this history entry
secpolicy_violated:
type: boolean
description: Whether the device configuration violated a security policy
ssids:
uniqueItems: true
type: array
items:
type: string
description: WLAN SSIDs included in this config history entry
ssids_24:
uniqueItems: true
type: array
items:
type: string
description: 2.4 GHz WLAN SSIDs included in this config history entry
ssids_5:
uniqueItems: true
type: array
items:
type: string
description: 5 GHz WLAN SSIDs included in this config history entry
timestamp:
type: number
description: Epoch timestamp when this config history entry was recorded
readOnly: true
version:
type: string
description: Configuration version associated with this history entry
wlans:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/response_config_history_search_item_wlan'
description: WLAN configuration details included in this history entry
description: Device config history entry
response_config_history_search_item_radio:
title: response_config_history_search_item_radio
required:
- band
- channel
type: object
properties:
band:
type: string
description: Radio band for this config history detail
channel:
type: integer
description: Configured channel for this radio
contentEncoding: int32
description: Radio config history detail
response_config_history_search_item_wlan:
title: response_config_history_search_item_wlan
required:
- auth
- id
- ssid
type: object
properties:
auth:
type: string
description: Configured authentication method for this WLAN
bands:
uniqueItems: true
type: array
items:
type: string
description: Radio bands where this WLAN was configured
id:
type: string
description: Unique identifier of the WLAN configuration
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
ssid:
type: string
description: WLAN SSID for this config history detail
vlan_ids:
uniqueItems: true
type: array
items:
type: string
description: VLAN IDs configured for this WLAN
description: WLAN config history detail
response_count:
title: response_count
required:
- distinct
- end
- limit
- results
- start
- total
type: object
properties:
distinct:
type: string
description: Field used to group the count results
end:
type: integer
description: Search window end timestamp for the count request, in epoch seconds
contentEncoding: int32
limit:
type: integer
description: Maximum number of distinct count results requested
contentEncoding: int32
results:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/count_result'
description: Count results grouped by the distinct field
start:
type: integer
description: Search window start timestamp for the count request, in epoch seconds
contentEncoding: int32
total:
type: integer
description: Number of distinct result buckets returned
contentEncoding: int32
description: Distinct count response for time-bounded search results
response_count_marvis_actions:
title: response_count_marvis_actions
type: object
properties:
distinct:
type: string
description: Field used to group Marvis action count results
examples:
- status
limit:
type: integer
description: Maximum number of Marvis action count results requested
contentEncoding: int32
examples:
- 1000
results:
type: array
items:
$ref: '#/components/schemas/response_count_marvis_actions_result'
description: Marvis action count results grouped by the distinct field
examples:
- - count: 24
status: 002e176a-0000-000-1111-002e208b20e1
- count: 12
status: 2d3f176a-0000-000-2222-002e208f176a
- count: 15
status: 08b2176a-0000-000-3333-002e208b2d3f
total:
type: integer
description: Number of Marvis action count result buckets returned
contentEncoding: int32
examples:
- 3
description: Distinct count response for Marvis action suggestions
response_count_marvis_actions_result:
title: response_count_marvis_actions_result
type: object
properties:
count:
type: integer
description: Number of Marvis actions matching this distinct value
contentEncoding: int32
examples:
- 24
additionalProperties:
type: string
description: Marvis action count result for one distinct value
response_detail_string:
title: response_detail_string
type: object
properties:
detail:
type: string
description: Human-readable detail message returned by the API
description: Response containing a human-readable detail message
response_device_bios_upgrade:
title: response_device_bios_upgrade
type: object
properties:
status:
type: string
description: Current BIOS upgrade status for the device
timestamp:
type: number
description: Epoch timestamp when the BIOS upgrade status was reported
readOnly: true
description: Device BIOS upgrade status response
response_device_config_cli:
title: response_device_config_cli
required:
- cli
type: object
properties:
cli:
uniqueItems: true
type: array
items:
type: string
description: Command lines generated for the device configuration in CLI syntax
description: Device configuration rendered as CLI commands
response_device_config_cmd:
title: response_device_config_cmd
required:
- cmd
type: object
properties:
cmd:
type: string
description: Configuration command returned for the device
description: Device configuration command response
response_device_events_search:
title: response_device_events_search
required:
- end
- limit
- results
- start
- total
type: object
properties:
end:
type: integer
description: Epoch timestamp for the end of the event search window
contentEncoding: int32
limit:
type: integer
description: Maximum number of event records returned in this page
contentEncoding: int32
next:
type: string
description: Pagination cursor or URL for retrieving the next page of event records
results:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/device_event'
description: Device or system event records matching the search filters
start:
type: integer
description: Epoch timestamp for the start of the event search window
contentEncoding: int32
total:
type: integer
description: Number of event records matching the search filters across all pages
contentEncoding: int32
description: Paginated response for device or system event search results
response_device_flow_records_search:
title: response_device_flow_records_search
type: object
properties:
end:
type: integer
description: Epoch timestamp, in seconds, for the end of the flow record search window
contentEncoding: int32
limit:
type: integer
description: Maximum number of flow records returned in this page
contentEncoding: int32
results:
type: array
items:
$ref: '#/components/schemas/flow_record'
description: Flow records matching the search filters
search_after:
type: string
description: Cursor token for retrieving the next page of flow records
start:
type: integer
description: Epoch timestamp, in seconds, for the start of the flow record search window
contentEncoding: int32
total:
type: integer
description: Number of flow records matching the search filters
contentEncoding: int32
description: Paginated response for device flow record search results
response_device_metrics:
title: response_device_metrics
required:
- end
- interval
- results
- start
type: object
properties:
end:
type: integer
description: Epoch timestamp for the end of the metric query window
contentEncoding: int32
interval:
type: integer
description: Aggregation interval in seconds for each metric sample
contentEncoding: int32
limit:
type: integer
description: Maximum number of metric samples returned in this page
contentEncoding: int32
page:
type: integer
description: Returned page number for paginated metric samples
contentEncoding: int32
results:
type: array
items:
$ref: '#/components/schemas/response_device_metrics_results_items'
description: Metric values for the requested insight metric, aligned by position with the `rt` timestamps
rt:
uniqueItems: true
type: array
items:
type: string
description: Timestamps for the metric samples, aligned by position with the `results` values
start:
type: integer
description: Epoch timestamp for the start of the metric query window
contentEncoding: int32
description: Time-series insight metric response for a device
response_device_radio_channels:
title: response_device_radio_channels
required:
- band24_40mhz_allowed
- band24_channels
- band24_enabled
- band5_channels
- band5_enabled
- certified
- code
- dfs_ok
- key
- name
- uses
type: object
properties:
band24_40mhz_allowed:
type: boolean
description: Whether 40 MHz channels are allowed on the 2.4 GHz band
band24_channels:
type: object
additionalProperties:
type: array
items:
type: integer
format: int32
description: Allowed 2.4 GHz channels for this country or regulatory domain
example:
'20':
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
'40':
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
description: Allowed 2.4 GHz channels for this country or regulatory domain
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
band24_enabled:
type: boolean
description: Whether the 2.4 GHz band is enabled for this country or regulatory domain
band5_channels:
type: object
additionalProperties:
type: array
items:
type: integer
format: int32
description: Allowed 5 GHz channels for this country or regulatory domain
example:
'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
description: Allowed 5 GHz channels for this country or regulatory domain
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
band5_enabled:
type: boolean
description: Whether the 5 GHz band is enabled for this country or regulatory domain
band6_channels:
type: object
additionalProperties:
type: array
items:
type: integer
format: int32
description: Allowed 6 GHz channels for this country or regulatory domain
example:
'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
description: Allowed 6 GHz channels for this country or regulatory domain
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
band6_enabled:
type: boolean
description: Whether the 6 GHz band is enabled for this country or regulatory domain
certified:
type: boolean
description: Whether AP operation is certified for this country or regulatory domain
code:
type: integer
description: Country code in ISO 3166-1 numeric format
contentEncoding: int32
dfs_ok:
type: boolean
description: Whether DFS channels are allowed in this country or regulatory domain
key:
type: string
description: Two-character ISO 3166-1 country code
name:
type: string
description: Country or regulatory-domain display name
uses:
type: string
description: Regulatory ruleset used for AP channel validation
description: Country and regulatory-domain channel capabilities for AP radios
response_device_search:
title: response_device_search
required:
- end
- limit
- results
- start
- total
type: object
properties:
end:
type: integer
description: Epoch timestamp for the end of the device search window
contentEncoding: int32
limit:
type: integer
description: Maximum number of device records returned in this page
contentEncoding: int32
next:
type: string
description: Pagination cursor or URL for retrieving the next page of device records
results:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/response_device_search_results_items'
description: AP, switch, or gateway records matching the device search filters
start:
type: integer
description: Epoch timestamp for the start of the device search window
contentEncoding: int32
total:
type: integer
description: Number of device records matching the search filters across all pages
contentEncoding: int32
description: Paginated response for organization or site device search results
response_device_upgrade:
title: response_device_upgrade
required:
- status
- timestamp
type: object
properties:
status:
allOf:
- $ref: '#/components/schemas/upgrade_info_status2'
- description: 'Current status of the requested device upgrade. enum: `error`, `inprogress`, `scheduled`, `starting`, `success`.'
timestamp:
type: number
description: Epoch timestamp when the device upgrade status was reported
readOnly: true
description: Single-device upgrade status response
response_discovered_switch_metrics:
title: response_discovered_switch_metrics
required:
- end
- limit
- results
- start
- total
type: object
properties:
end:
type: number
description: Epoch timestamp, in seconds, for the end of the metric search window
limit:
type: integer
description: Maximum number of discovered switch metric records returned in this page
contentEncoding: int32
next:
type: string
description: Pagination cursor or URL for retrieving the next page of discovered switch metric records
results:
type: array
items:
$ref: '#/components/schemas/discovered_switch_metric'
description: Discovered switch metric records matching the search filters
start:
type: number
description: Epoch timestamp, in seconds, for the start of the metric search window
total:
type: integer
description: Number of discovered switch metric records matching the search filters across all pages
contentEncoding: int32
description: Paginated response for discovered switch metric search results
response_discovered_switches:
title: response_discovered_switches
required:
- end
- limit
- results
- start
- total
type: object
properties:
end:
type: number
description: Epoch timestamp, in seconds, for the end of the discovered switch search window
limit:
type: integer
description: Maximum number of discovered switch records returned in this page
contentEncoding: int32
next:
type: string
description: Pagination cursor or URL for retrieving the next page of discovered switch records
results:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/discovered_switch'
description: Discovered switch records matching the search filters
start:
type: number
description: Epoch timestamp, in seconds, for the start of the discovered switch search window
total:
type: integer
description: Number of discovered switch records matching the search filters across all pages
contentEncoding: int32
description: Paginated response for discovered switch search results
response_dswitches_metrics:
title: response_dswitches_metrics
required:
- inactive_wired_vlans
- poe_compliance
- switch_ap_affinity
- version_compliance
type: object
properties:
inactive_wired_vlans:
allOf:
- $ref: '#/components/schemas/dswitches_metrics_inactive_wired_vlans1'
- description: Metric for inactive wired VLANs on discovered switches
poe_compliance:
allOf:
- $ref: '#/components/schemas/dswitches_metrics_poe_compliance1'
- description: Metric for PoE compliance across APs connected to discovered switches
switch_ap_affinity:
allOf:
- $ref: '#/components/schemas/dswitches_metrics_switch_ap_affinity1'
- description: Metric comparing AP counts against the switch affinity threshold
version_compliance:
allOf:
- $ref: '#/components/schemas/dswitches_metrics_version_compliance1'
- description: Metric for discovered switch software version compliance
description: Metrics summary returned for discovered switch compliance checks
response_events_devices:
title: response_events_devices
required:
- end
- limit
- results
- start
- total
type: object
properties:
end:
type: integer
description: Epoch timestamp for the end of the device event search window
contentEncoding: int32
limit:
type: integer
description: Maximum number of device event records returned in this page
contentEncoding: int32
next:
type: string
description: Pagination cursor or URL for retrieving the next page of device event records
results:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/device_event'
description: Device event records matching the search filters
start:
type: integer
description: Epoch timestamp for the start of the device event search window
contentEncoding: int32
total:
type: integer
description: Number of device event records matching the search filters across all pages
contentEncoding: int32
description: Paginated response for site device event search results
response_events_fastroam:
title: response_events_fastroam
required:
- end
- limit
- results
- start
type: object
properties:
end:
type: integer
description: Epoch timestamp for the end of the roaming event search window
contentEncoding: int32
limit:
type: integer
description: Maximum number of roaming event records returned in this page
contentEncoding: int32
next:
type: string
description: Pagination cursor or URL for retrieving the next page of roaming event records; null when no next page exists
results:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/event_fastroam'
description: Fast roaming event records matching the search filters
start:
type: integer
description: Epoch timestamp for the start of the roaming event search window
contentEncoding: int32
description: Paginated response for fast roaming event results
response_events_nac_client_search:
title: response_events_nac_client_search
type: object
properties:
end:
type: integer
description: Epoch timestamp for the end of the NAC client event search window
contentEncoding: int32
examples:
- 1513176951
limit:
type: integer
description: Maximum number of NAC client event records returned in this page
contentEncoding: int32
examples:
- 10
next:
type: string
description: Pagination cursor or URL for retrieving the next page of NAC client event records
results:
type: array
items:
$ref: '#/components/schemas/nac_client_event'
description: NAC client event records matching the search filters
start:
type: integer
description: Epoch timestamp for the start of the NAC client event search window
contentEncoding: int32
examples:
- 1512572151
total:
type: integer
description: Number of NAC client event records matching the search filters across all pages
contentEncoding: int32
examples:
- 1
description: Paginated response for NAC client event search results
response_events_orgs_search:
title: response_events_orgs_search
type: object
properties:
end:
type: integer
description: Epoch timestamp for the end of the organization event search window
contentEncoding: int32
examples:
- 1688035193
limit:
type: integer
description: Maximum number of organization event records returned in this page
contentEncoding: int32
examples:
- 10
next:
type: string
description: Pagination cursor or URL for retrieving the next page of organization event records
results:
type: array
items:
$ref: '#/components/schemas/org_event'
description: Organization event records matching the search filters
start:
type: integer
description: Epoch timestamp for the start of the organization event search window
contentEncoding: int32
examples:
- 1687948793
total:
type: integer
description: Number of organization event records matching the search filters across all pages
contentEncoding: int32
description: Paginated response for organization event search results
response_events_other_devices_search:
title: response_events_other_devices_search
type: object
properties:
end:
type: integer
description: Epoch timestamp for the end of the other-device event search window
contentEncoding: int32
limit:
type: integer
description: Maximum number of other-device event records returned in this page
contentEncoding: int32
next:
type: string
description: Pagination cursor or URL for retrieving the next page of other-device event records
results:
type: array
items:
$ref: '#/components/schemas/event_otherdevice'
description: list of other-device event records matching the search filters
start:
type: integer
description: Epoch timestamp for the start of the other-device event search window
contentEncoding: int32
total:
type: integer
description: Number of other-device event records matching the search filters across all pages
contentEncoding: int32
description: Paginated response for other-device event search results
response_events_path_search:
title: response_events_path_search
type: object
properties:
end:
type: integer
description: Epoch timestamp for the end of the service path event search window
contentEncoding: int32
examples:
- 1697096379
limit:
type: integer
description: Maximum number of service path event records returned in this page
contentEncoding: int32
examples:
- 10
next:
type: string
description: Pagination cursor or URL for retrieving the next page of service path event records
results:
type: array
items:
$ref: '#/components/schemas/service_path_event'
description: Service path event records matching the search filters
start:
type: integer
description: Epoch timestamp for the start of the service path event search window
contentEncoding: int32
examples:
- 1697009979
total:
type: integer
description: Number of service path event records matching the search filters across all pages
contentEncoding: int32
examples:
- 2
description: Paginated response for service path event search results
service_path_event:
title: service_path_event
type: object
properties:
mac:
type: string
description: Device MAC address that reported the service path event
examples:
- 90ec7734b374
model:
type: string
description: Device model that reported the service path event
examples:
- SSR120
org_id:
type: string
description: Organization identifier associated with the service path event
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
policy:
type: string
description: Service policy name associated with the path event
examples:
- INTERNET
port_id:
type: string
description: Network interface associated with the service path event
examples:
- ge-1/0/6
site_id:
type: string
description: Site identifier associated with the service path event
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
text:
type: string
description: Human-readable message for the service path event
examples:
- Peer Path Down
timestamp:
type: number
description: Time when the service path event occurred, in epoch seconds
readOnly: true
type:
type: string
description: Event type for the service path change
examples:
- GW_SERVICE_PATH_REMOVE
version:
type: string
description: Device firmware version that reported the service path event
examples:
- 6.1.5-14.lts
vpn_name:
type: string
description: Peer name associated with the service path event
examples:
- Syracuse_HUB
vpn_path:
type: string
description: Peer path name associated with the service path event
examples:
- Syracuse_HUB-Wan0
description: Event describing a service path state change reported by a gateway or SSR device
response_events_rogue_search:
title: response_events_rogue_search
required:
- end
- limit
- results
- start
- total
type: object
properties:
end:
type: integer
description: Epoch timestamp for the end of the rogue AP event search window
contentEncoding: int32
limit:
type: integer
description: Maximum number of rogue AP event records returned in this page
contentEncoding: int32
next:
type: string
description: Pagination cursor or URL for retrieving the next page of rogue AP event records
results:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/events_rogue'
description: Rogue AP event records matching the search filters
start:
type: integer
description: Epoch timestamp for the start of the rogue AP event search window
contentEncoding: int32
total:
type: integer
description: Number of rogue AP event records matching the search filters across all pages
contentEncoding: int32
description: Paginated response for rogue AP event search results
response_events_rrm:
title: response_events_rrm
required:
- end
- limit
- results
- start
type: object
properties:
end:
type: integer
description: Epoch timestamp for the end of the RRM event search window
contentEncoding: int32
limit:
type: integer
description: Maximum number of RRM event records returned in this page
contentEncoding: int32
next:
type: string
description: Pagination cursor or URL for retrieving the next page of RRM event records; null when no next page exists
results:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/rrm_event'
description: RRM event records matching the search filters
start:
type: integer
description: Epoch timestamp for the start of the RRM event search window
contentEncoding: int32
description: Paginated response for RRM event results
rrm_event:
title: rrm_event
required:
- ap
- band
- bandwidth
- channel
- event
- power
- pre_bandwidth
- pre_channel
- pre_power
- pre_usage
- timestamp
- usage
type: object
properties:
ap:
type: string
description: MAC address of the AP associated with the RRM event
examples:
- 5c5b350e0001
band:
allOf:
- $ref: '#/components/schemas/dot11_band2'
- description: 'Radio band affected by the RRM event. enum: `24`, `5`, `5-dedicated`, `5-selectable`, `6`, `6-dedicated`, `6-selectable`.'
bandwidth:
allOf:
- $ref: '#/components/schemas/dot11_bandwidth3'
- description: 'Channel width after the RRM event, in MHz. enum: `0`, `20`, `40`, `80`, `160`.'
examples:
- 20
channel:
type: integer
description: RF channel after the RRM event
contentEncoding: int32
event:
allOf:
- $ref: '#/components/schemas/rrm_event_type2'
- description: 'RRM event type that caused or records the change. enum: `interference-ap-co-channel`, `interference-ap-non-wifi`, `neighbor-ap-down`, `neighbor-ap-recovered`, `radar-detected`, `rrm-radar`, `scheduled-site_rrm`, `triggered-site_rrm`.'
power:
type: integer
description: Transmit power after the RRM event
contentEncoding: int32
pre_bandwidth:
allOf:
- $ref: '#/components/schemas/rrm_event_pre_bandwidth2'
- description: 'Channel width before the RRM event, in MHz. enum: `0`, `20`, `40`, `80`, `160`.'
pre_channel:
type: integer
description: RF channel before the RRM event; 0 means no previous value was available
contentEncoding: int32
pre_power:
type: number
description: Transmit power before the RRM event; 0 means no previous value was available
pre_usage:
type: string
description: Radio usage band before the RRM event
timestamp:
type: number
description: Time when the RRM event occurred
readOnly: true
usage:
type: string
description: Radio usage band after the RRM event
description: RRM event record for radio setting changes or RF conditions
response_events_search:
title: response_events_search
required:
- end
- limit
- results
- start
- total
type: object
properties:
end:
type: integer
description: Epoch timestamp for the end of the wireless client event search window
contentEncoding: int32
limit:
type: integer
description: Maximum number of wireless client event records returned in this page
contentEncoding: int32
next:
type: string
description: Pagination cursor or URL for retrieving the next page of wireless client event records
results:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/events_client'
description: Wireless client event records matching the search filters
start:
type: integer
description: Epoch timestamp for the start of the wireless client event search window
contentEncoding: int32
total:
type: integer
description: Number of wireless client event records matching the search filters across all pages
contentEncoding: int32
description: Paginated response for wireless client event search results
response_events_sky_atp_search:
title: response_events_sky_atp_search
required:
- end
- limit
- results
- start
- total
type: object
properties:
end:
type: integer
description: Epoch timestamp for the end of the Sky ATP event search window
contentEncoding: int32
limit:
type: integer
description: Maximum number of Sky ATP event records returned in this page
contentEncoding: int32
next:
type: string
description: Pagination cursor or URL for retrieving the next page of Sky ATP event records
results:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/events_skyatp'
description: Sky ATP event records matching the search filters
start:
type: integer
description: Epoch timestamp for the start of the Sky ATP event search window
contentEncoding: int32
total:
type: integer
description: Number of Sky ATP event records matching the search filters across all pages
contentEncoding: int32
description: Paginated response for Sky ATP event search results
response_guest_search:
title: response_guest_search
required:
- end
- limit
- results
- start
- total
type: object
properties:
end:
type: integer
description: Epoch timestamp for the end of the guest authorization search window
contentEncoding: int32
limit:
type: integer
description: Maximum number of guest authorization records returned in this page
contentEncoding: int32
next:
type: string
description: Pagination cursor or URL for retrieving the next page of guest authorization records
results:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/guest'
description: Guest authorization records matching the search filters
start:
type: integer
description: Epoch timestamp for the start of the guest authorization search window
contentEncoding: int32
total:
type: integer
description: Number of guest authorization records matching the search filters across all pages
contentEncoding: int32
description: Paginated response for guest authorization search results
response_http400:
title: response_http400
type: object
properties:
detail:
type: string
description: Human-readable explanation of the bad request error
examples:
- 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
description: Standard HTTP 400 bad request error response
response_http400_webhook:
title: response_http400_webhook
type: object
properties:
detail:
type: string
description: Human-readable explanation of the invalid webhook request
examples:
- 'invalid field: assetfilter_ids'
reason:
type: string
description: Additional reason explaining why the webhook request was invalid
examples:
- contains duplicate uuids
description: Webhook-specific HTTP 400 bad request error response
response_http401:
title: response_http401
type: object
properties:
detail:
type: string
description: Human-readable explanation of the authentication error
examples:
- Authentication credentials were not provided.
description: Standard HTTP 401 authentication error response
response_http403:
title: response_http403
type: object
properties:
detail:
type: string
description: Human-readable explanation of the permission error
examples:
- You do not have permission to perform this action.
description: Standard HTTP 403 permission error response
response_http404:
title: response_http404
type: object
properties:
id:
type: string
description: Missing resource identifier, when the API includes one
description: Standard HTTP 404 not found error response
response_http429:
title: response_http429
type: object
properties:
detail:
type: string
description: Human-readable explanation of the rate limit error
examples:
- Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
description: Standard HTTP 429 rate limit error response
response_insight_rogue:
title: response_insight_rogue
required:
- end
- limit
- results
- start
type: object
properties:
end:
type: integer
description: Epoch timestamp for the end of the rogue AP insight window
contentEncoding: int32
limit:
type: integer
description: Maximum number of rogue or neighbor AP observations returned in this page
contentEncoding: int32
next:
type: string
description: Pagination cursor or URL for retrieving the next page of rogue or neighbor AP observations; null when no next page exists
results:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/insight_rogue_ap'
description: Rogue or neighbor AP observations returned for the site insight query
start:
type: integer
description: Epoch timestamp for the start of the rogue AP insight window
contentEncoding: int32
description: Paginated response for rogue or neighbor AP insight results
response_insight_rogue_client:
title: response_insight_rogue_client
required:
- end
- limit
- results
- start
type: object
properties:
end:
type: integer
description: Epoch timestamp for the end of the rogue client insight window
contentEncoding: int32
limit:
type: integer
description: Maximum number of rogue client observations returned in this page
contentEncoding: int32
next:
type: string
description: Pagination cursor or URL for retrieving the next page of rogue client observations
results:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/insight_rogue_client'
description: Rogue client observations returned for the site insight query
start:
type: integer
description: Epoch timestamp for the start of the rogue client insight window
contentEncoding: int32
description: Paginated response for rogue client insight results
response_inventory:
title: response_inventory
type: object
properties:
added:
type: array
items:
type: string
description: Claim codes accepted into organization inventory
duplicated:
type: array
items:
type: string
description: Claim codes already present in organization inventory
error:
type: array
items:
type: string
description: Claim codes rejected by the inventory add operation
inventory_added:
minItems: 1
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/response_inventory_inventory_added_items'
description: Detailed inventory records added by the claim operation
inventory_duplicated:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/response_inventory_inventory_duplicated_items'
description: Detailed inventory records already present during the claim operation
reason:
uniqueItems: true
type: array
items:
type: string
description: Error reasons for claim codes that could not be added
description: Result of adding device claim codes to organization inventory
response_inventory_inventory_added_items:
title: response_inventory_inventory_added_items
required:
- mac
- magic
- model
- serial
- type
type: object
properties:
mac:
type: string
description: Device MAC address for the claimed inventory item
examples:
- 5c5b35000018
magic:
type: string
description: Activation code or claim code associated with the inventory item
examples:
- 6JG8EPTFV2A9Z2N
model:
type: string
description: Device model for the claimed inventory item
examples:
- AP41
serial:
type: string
description: Device serial number for the claimed inventory item
examples:
- FXLH2015150025
type:
type: string
description: Device type for the claimed inventory item
examples:
- ap
description: Inventory device added by the claim operation
response_inventory_inventory_duplicated_items:
title: response_inventory_inventory_duplicated_items
required:
- mac
- magic
- model
- serial
- type
type: object
properties:
mac:
type: string
description: Device MAC address for the duplicate inventory item
examples:
- 5c5b35000012
magic:
type: string
description: Activation code or claim code associated with the duplicate inventory item
examples:
- DVH4VSNMSZPDXBR
model:
type: string
description: Device model for the duplicate inventory item
examples:
- AP41
serial:
type: string
description: Device serial number for the duplicate inventory item
examples:
- FXLH2015150027
type:
type: string
description: Device type for the duplicate inventory item
examples:
- ap
description: Inventory device already present during the claim operation
response_iot_endpoints_search:
title: response_iot_endpoints_search
required:
- end
- results
- start
- total
type: object
properties:
end:
type: number
description: Epoch timestamp, in seconds, for the end of the IoT endpoint search window
results:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/iotendpoint_stats'
description: IoT endpoint statistics matching the search filters
start:
type: number
description: Epoch timestamp, in seconds, for the start of the IoT endpoint search window
total:
type: integer
description: Number of IoT endpoint records matching the search filters
contentEncoding: int32
description: Time-bounded response for IoT endpoint search results
response_location_coverage:
title: response_location_coverage
required:
- beams_means
- end
- gridsize
- result_def
- results
- start
type: object
properties:
beams_means:
type: array
items:
type: array
items:
type: number
description: Grid beam mean samples as [x, y, mean] values for the coverage view
end:
type: integer
description: Epoch timestamp for the end of the coverage analysis window
contentEncoding: int32
gridsize:
type: number
description: Grid cell size in meters for coverage samples
result_def:
type: array
items:
type: string
description: Column names describing each value position in the coverage result rows
results:
type: array
items:
type: array
items:
type: number
description: Coverage result rows whose values follow the `result_def` column order
start:
type: integer
description: Epoch timestamp for the start of the coverage analysis window
contentEncoding: int32
description: Beam coverage overview for a site location map
response_log_search:
title: response_log_search
required:
- end
- limit
- results
- start
- total
type: object
properties:
end:
type: integer
description: Epoch timestamp for the end of the audit log search window
contentEncoding: int32
limit:
type: integer
description: Maximum number of audit log events returned in this page
contentEncoding: int32
next:
type: string
description: Pagination cursor or URL for retrieving the next page of audit log events
results:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/log_event'
description: Audit log events matching the search filters
start:
type: integer
description: Epoch timestamp for the start of the audit log search window
contentEncoding: int32
total:
type: integer
description: Number of audit log events matching the search filters across all pages
contentEncoding: int32
description: Paginated response for audit log search results
response_login_failure:
title: response_login_failure
required:
- detail
type: object
properties:
detail:
type: string
description: Human-readable login failure message returned by the API
forward_url:
type: string
description: SSO URL where the user should continue login, when provided
description: Login failure response returned when authentication cannot continue locally
response_login_lookup:
title: response_login_lookup
type: object
properties:
sso_url:
type: string
description: URL for SSO login when the account must authenticate through an identity provider
description: Login lookup response indicating whether SSO is available for the account
response_login_oauth_url:
title: response_login_oauth_url
required:
- authorization_url
- client_id
type: object
properties:
authorization_url:
type: string
description: OAuth2 provider authorization URL to open for login
client_id:
type: string
description: OAuth2 client identifier used for the authorization request
description: OAuth2 authorization URL response for login
response_login_success:
title: response_login_success
type: object
properties:
email:
type: string
description: Admin email address for a login flow that requires two-factor authentication
two_factor_passed:
type: boolean
description: Whether the supplied two-factor code has been accepted for this login
two_factor_required:
type: boolean
description: Whether this login requires a two-factor code before a session is established
description: Login response body, empty on normal success or populated with two-factor state
response_logout:
title: response_logout
type: object
properties:
forward_url:
type: string
description: If configured in SSO as custom_logout_url
description: Logout response with optional SSO forwarding URL
response_map_import:
title: response_map_import
required:
- aps
- floorplans
- site_id
- summary
type: object
properties:
aps:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/response_map_import_ap'
description: AP placement results produced by the map import
floorplans:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/response_map_import_floorplan'
description: Floorplan import results produced by the map import
for_site:
type: boolean
description: Whether this map import response is scoped to a site
readOnly: true
site_id:
type: string
description: Site associated with the map import result
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
summary:
allOf:
- $ref: '#/components/schemas/response_map_import_summary'
- description: Counts summarizing assignments made during the map import
description: Result of importing map files and matching AP placements
response_map_import_ap:
title: response_map_import_ap
required:
- action
- floorplan_id
- mac
- map_id
- orientation
type: object
properties:
action:
allOf:
- $ref: '#/components/schemas/response_map_import_ap_action2'
- description: 'Import action applied to this AP. enum: `assigned-named-placed`, `assigned-placed`, `ignored`, `named-placed`, `placed`.'
floorplan_id:
type: string
description: Floorplan identifier where the AP placement was imported
contentEncoding: uuid
height:
type: number
description: Mounting height for the AP on the imported floorplan
mac:
type: string
description: AP MAC address matched from the import file
map_id:
type: string
description: Map identifier associated with the imported AP placement
contentEncoding: uuid
orientation:
type: integer
description: AP orientation in degrees on the imported floorplan
contentEncoding: int32
reason:
type: string
description: Explanation of why the AP import action was not completed, when provided
description: AP placement result from a map import
response_map_import_ap_action:
title: response_map_import_ap_action
enum:
- assigned-named-placed
- assigned-placed
- ignored
- named-placed
- placed
type: string
description: 'enum: `assigned-named-placed`, `assigned-placed`, `ignored`, `named-placed`, `placed`'
response_map_import_floorplan:
title: response_map_import_floorplan
required:
- action
- id
- map_id
- name
type: object
properties:
action:
type: string
description: Import action applied to this floorplan
id:
type: string
description: Floorplan identifier returned by the import
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
map_id:
type: string
description: Map identifier associated with the imported floorplan
contentEncoding: uuid
name:
type: string
description: Floorplan name imported from the map file
reason:
type: string
description: Explanation of why the floorplan import action was not completed, when provided
description: Floorplan result from a map import
response_map_import_summary:
title: response_map_import_summary
required:
- num_ap_assigned
- num_inv_assigned
- num_map_assigned
type: object
properties:
num_ap_assigned:
type: integer
description: Number of AP placements assigned during the map import
contentEncoding: int32
num_inv_assigned:
type: integer
description: Number of inventory records assigned to the site during the map import
contentEncoding: int32
num_map_assigned:
type: integer
description: Number of map floorplans assigned during the map import
contentEncoding: int32
description: Counts summarizing assignments made during the map import
response_mobile_verify_secret:
title: response_mobile_verify_secret
required:
- name
- org_id
- secret
type: object
properties:
name:
type: string
description: Organization display name associated with the verified SDK invite
org_id:
type: string
description: Organization identifier associated with the verified SDK invite
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
secret:
type: string
description: Device-specific secret returned for mobile SDK activation
contentEncoding: password
description: Mobile SDK invite verification response
response_msp_inventory_device:
title: response_msp_inventory_device
required:
- mac
- model
- org_id
- serial
- site_id
- type
type: object
properties:
for_site:
type: boolean
description: Whether this inventory device is associated with a site
readOnly: true
mac:
type: string
description: Device MAC address for the inventory device
readOnly: true
model:
type: string
description: Device model for the inventory device
readOnly: true
org_id:
type: string
description: Organization that owns this inventory device
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
serial:
type: string
description: Device serial number for the inventory device
readOnly: true
site_id:
type: string
description: Site identifier for the inventory device
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
type:
type: string
description: Device type for the inventory device
readOnly: true
description: Inventory device record returned by MSP device MAC lookup
response_mxedge_events_search:
title: response_mxedge_events_search
type: object
properties:
end:
type: integer
description: Epoch timestamp for the end of the Mist Edge event search window
contentEncoding: int32
examples:
- 1694708579
limit:
type: integer
description: Maximum number of Mist Edge event records returned in this page
contentEncoding: int32
examples:
- 10
next:
type: string
description: Pagination cursor or URL for retrieving the next page of Mist Edge event records
page:
type: integer
description: Returned page number for Mist Edge event records
contentEncoding: int32
examples:
- 3
results:
minItems: 1
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/mxedge_event'
description: Mist Edge event records matching the search filters
start:
type: integer
description: Epoch timestamp for the start of the Mist Edge event search window
contentEncoding: int32
examples:
- 1694622179
description: Search response for Mist Edge event records
response_mxedge_search:
title: response_mxedge_search
type: object
properties:
end:
type: integer
description: Epoch timestamp for the end of the Mist Edge search window
contentEncoding: int32
examples:
- 1694708579
limit:
type: integer
description: Maximum number of Mist Edge records returned in this page
contentEncoding: int32
examples:
- 10
next:
type: string
description: Pagination cursor or URL for retrieving the next page of Mist Edge records
results:
type: array
items:
$ref: '#/components/schemas/search_mxedge'
description: Mist Edge records matching the search filters
start:
type: integer
description: Epoch timestamp for the start of the Mist Edge search window
contentEncoding: int32
examples:
- 1694622179
total:
type: integer
description: Number of Mist Edge records matching the search filters across all pages
contentEncoding: int32
examples:
- 2
description: Search response for Mist Edge records
search_mxedge:
title: search_mxedge
type: object
properties:
distro:
type: string
description: Linux distribution codename running on the Mist Edge
last_seen:
type: number
description: Time when the Mist Edge was last observed, in epoch seconds
model:
type: string
description: Mist Edge hardware or VM model
examples:
- ME-VM
mxcluster_id:
type: string
description: Cluster identifier associated with the Mist Edge
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
mxedge_id:
type: string
description: Mist Edge identifier for the search record
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
name:
type: string
description: Display name of the Mist Edge
examples:
- me-vm-1
org_id:
type: string
description: Organization identifier associated with the Mist Edge
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
site_id:
type: string
description: Site identifier associated with the Mist Edge, when assigned to a site
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
tunterm_version:
type: string
description: Tunnel termination service version running on the Mist Edge
uptime:
type: integer
description: Number of seconds the Mist Edge has been running since last boot
contentEncoding: int32
description: Mist Edge record returned by search APIs
response_mxedge_upgrade:
title: response_mxedge_upgrade
required:
- channel
- counts
- id
- status
- strategy
- versions
type: object
properties:
channel:
minLength: 1
type: string
description: Upgrade channel used to select Mist Edge package versions
counts:
allOf:
- $ref: '#/components/schemas/mxedge_upgrade_response_counts1'
- description: Per-status counts of Mist Edge targets in this upgrade
id:
type: string
description: Upgrade identifier for this Mist Edge upgrade request
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
status:
minLength: 1
type: string
description: Current status of the Mist Edge upgrade
strategy:
minLength: 1
type: string
description: Rollout strategy used for the Mist Edge upgrade
versions:
type: object
description: Per-service target versions for this Mist Edge upgrade
description: Mist Edge upgrade details response
response_mxtunnels_preempt_aps:
title: response_mxtunnels_preempt_aps
required:
- preempted_aps
type: object
properties:
preempted_aps:
uniqueItems: true
type: array
items:
type: string
description: AP identifiers moved to the preferred MxTunnel peer
description: Result of preempting APs onto preferred MxTunnel peers
response_nac_crl_files:
title: response_nac_crl_files
type: object
properties:
results:
type: array
items:
$ref: '#/components/schemas/nac_crl_file'
description: Uploaded NAC CRL files for the organization
description: Response containing uploaded NAC CRL file metadata
response_org_devices:
title: response_org_devices
required:
- results
type: object
properties:
results:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/org_device'
description: Device records returned by the organization device list operation
description: Response containing organization device records
response_org_devices_summary:
title: response_org_devices_summary
type: object
properties:
num_aps:
type: integer
description: Number of APs in the organization
contentEncoding: int32
readOnly: true
num_gateways:
type: integer
description: Number of gateways in the organization
contentEncoding: int32
readOnly: true
num_mxedges:
type: integer
description: Number of Mist Edges in the organization
contentEncoding: int32
readOnly: true
num_switches:
type: integer
description: Number of switches in the organization
contentEncoding: int32
readOnly: true
num_unassigned_aps:
type: integer
description: Number of APs in organization inventory that are not assigned to a site
contentEncoding: int32
readOnly: true
num_unassigned_gateways:
type: integer
description: Number of gateways in organization inventory that are not assigned to a site
contentEncoding: int32
readOnly: true
num_unassigned_switches:
type: integer
description: Number of switches in organization inventory that are not assigned to a site
contentEncoding: int32
readOnly: true
description: Organization device count summary
response_org_inventory_change:
title: response_org_inventory_change
required:
- error
- op
- reason
- success
type: object
properties:
error:
uniqueItems: true
type: array
items:
type: string
description: Device identifiers that failed during the inventory operation
op:
allOf:
- $ref: '#/components/schemas/response_org_inventory_change_op2'
- description: 'Inventory operation applied to the requested device identifiers. enum: `assign`, `delete`, `downgrade_to_jsi`, `unassign`, `upgrade_to_mist`.'
reason:
uniqueItems: true
type: array
items:
type: string
description: Failure reasons corresponding to entries in the error list
success:
uniqueItems: true
type: array
items:
type: string
description: Device identifiers successfully processed by the inventory operation
description: Result of an organization inventory assignment or deletion operation
response_org_inventory_change_op:
title: response_org_inventory_change_op
enum:
- assign
- delete
- downgrade_to_jsi
- unassign
- upgrade_to_mist
type: string
description: 'enum: `assign`, `delete`, `downgrade_to_jsi`, `unassign`, `upgrade_to_mist`'
response_org_search:
title: response_org_search
required:
- end
- limit
- results
- start
- total
type: object
properties:
end:
type: number
description: Epoch timestamp, in seconds, for the end of the organization search window
readOnly: true
limit:
type: integer
description: Maximum number of organization records returned in this page
contentEncoding: int32
readOnly: true
next:
type: string
description: URL for retrieving the next page of organization search results
results:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/response_org_search_item'
description: Organization records matching the MSP search filters
start:
type: number
description: Epoch timestamp, in seconds, for the start of the organization search window
readOnly: true
total:
type: integer
description: Number of organization records matching the search filters across all pages
contentEncoding: int32
readOnly: true
description: Paginated response for MSP organization search results
response_org_search_item:
title: response_org_search_item
type: object
properties:
msp_id:
type: string
description: MSP that owns or manages this organization
contentEncoding: uuid
readOnly: true
examples:
- b9d42c2e-88ee-41f8-b798-f009ce7fe909
name:
type: string
description: Display name of the organization
readOnly: true
num_aps:
type: integer
description: Number of APs in the organization
contentEncoding: int32
readOnly: true
num_gateways:
type: integer
description: Number of gateways in the organization
contentEncoding: int32
readOnly: true
num_sites:
type: integer
description: Number of sites in the organization
contentEncoding: int32
readOnly: true
num_switches:
type: integer
description: Number of switches in the organization
contentEncoding: int32
readOnly: true
num_unassigned_aps:
type: integer
description: Number of APs in organization inventory that are not assigned to a site
contentEncoding: int32
readOnly: true
org_id:
type: string
description: Organization identifier for this search result
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
sub_ana_entitled:
type: integer
description: Number of SUB-ANA subscriptions entitled for the organization
contentEncoding: int32
readOnly: true
sub_ana_required:
type: integer
description: Number of SUB-ANA subscriptions required by the organization
contentEncoding: int32
readOnly: true
sub_ast_entitled:
type: integer
description: Number of SUB-AST subscriptions entitled for the organization
contentEncoding: int32
readOnly: true
sub_ast_required:
type: integer
description: Number of SUB-AST subscriptions required by the organization
contentEncoding: int32
readOnly: true
sub_eng_entitled:
type: integer
description: Number of SUB-ENG subscriptions entitled for the organization
contentEncoding: int32
readOnly: true
sub_eng_required:
type: integer
description: Number of SUB-ENG subscriptions required by the organization
contentEncoding: int32
readOnly: true
sub_ex12_required:
type: integer
description: Number of SUB-EX12 subscriptions required by the organization
contentEncoding: int32
readOnly: true
sub_insufficient:
type: boolean
description: If this org has sufficient subscription
readOnly: true
sub_man_entitled:
type: integer
description: Number of SUB-MAN subscriptions entitled for the organization
contentEncoding: int32
readOnly: true
sub_man_required:
type: integer
description: Number of SUB-MAN subscriptions required by the organization
contentEncoding: int32
readOnly: true
sub_me_entitled:
type: integer
description: Number of SUB-ME subscriptions entitled for the organization
contentEncoding: int32
readOnly: true
sub_vna_entitled:
type: integer
description: Number of SUB-VNA subscriptions entitled for the organization
contentEncoding: int32
readOnly: true
sub_vna_required:
type: integer
description: Number of SUB-VNA subscriptions required by the organization
contentEncoding: int32
readOnly: true
timestamp:
type: number
description: Epoch timestamp, in seconds, when the organization search data was sampled
readOnly: true
trial_enabled:
type: boolean
description: If this org is under trial period
readOnly: true
usage_types:
type: array
items:
type: string
description: Subscription usage types enabled for the organization
readOnly: true
description: Organization record returned by MSP organization search
response_org_suppress_alarm:
title: response_org_suppress_alarm
type: object
properties:
results:
type: array
items:
$ref: '#/components/schemas/response_org_suppress_alarm_item'
description: Suppressed alarm entries currently configured for the organization
description: Response containing currently suppressed organization alarm entries
response_org_suppress_alarm_item:
title: response_org_suppress_alarm_item
type: object
properties:
duration:
type: integer
description: Number of seconds that alarms remain suppressed. Maximum duration is 86400 * 14 (14 days). Use 0 to remove suppression.
contentEncoding: int32
expire_time:
type: integer
description: Epoch timestamp, in seconds, when the alarm suppression expires
contentEncoding: int32
scheduled_time:
type: integer
description: Epoch timestamp, in seconds, when the alarm suppression starts
contentEncoding: int32
scope:
allOf:
- $ref: '#/components/schemas/suppressed_alarm_scope3'
- description: 'Alarm suppression scope, either organization-wide or site-specific. enum: `org`, `site`.'
site_id:
type: string
description: Site identifier for a site-scoped alarm suppression entry
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
description: Suppressed alarm entry for an organization or site alarm scope
response_org_system_events_search:
title: response_org_system_events_search
required:
- end
- limit
- results
- start
- total
type: object
properties:
end:
type: integer
description: Epoch timestamp, in seconds, for the end of the system event search window
contentEncoding: int32
limit:
type: integer
description: Maximum number of system event records returned in this page
contentEncoding: int32
next:
type: string
description: URL for retrieving the next page of system event search results
results:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/org_system_event'
description: Organization system event records matching the search filters
start:
type: integer
description: Epoch timestamp, in seconds, for the start of the system event search window
contentEncoding: int32
total:
type: integer
description: Number of system event records matching the search filters across all pages
contentEncoding: int32
description: Paginated response for organization system event search results
response_past_spectrum_analysis:
title: response_past_spectrum_analysis
type: object
properties:
end:
type: integer
description: Epoch timestamp, in seconds, for the end of the spectrum analysis query window
contentEncoding: int32
limit:
type: integer
description: Maximum number of spectrum analysis records returned in this page
contentEncoding: int32
page:
type: integer
description: Current page number returned for the spectrum analysis results
contentEncoding: int32
results:
type: array
items:
$ref: '#/components/schemas/response_past_spectrum_analysis_result'
description: Spectrum analysis records for the requested site and time window
start:
type: integer
description: Epoch timestamp, in seconds, for the start of the spectrum analysis query window
contentEncoding: int32
total:
type: integer
description: Number of spectrum analysis records available for the given time range
contentEncoding: int32
description: Paginated response for past site spectrum analysis records
response_past_spectrum_analysis_channel_usage:
title: response_past_spectrum_analysis_channel_usage
type: object
properties:
channel:
type: integer
description: Radio channel measured by this channel usage sample
contentEncoding: int32
examples:
- 36
noise:
type: number
description: Measured noise floor, in dBm, for the channel
examples:
- -90
non_wifi:
type: number
description: Percentage of channel usage by non-WiFi signals in the range [0, 1]
examples:
- 0.87
wifi:
type: number
description: Percentage of channel usage by WiFi in the range [0, 1]
examples:
- 0.13
description: Channel usage data for a specific channel
response_past_spectrum_analysis_fft_sample:
title: response_past_spectrum_analysis_fft_sample
type: object
properties:
frequency:
type: number
description: Sample frequency, in MHz, for this FFT point
examples:
- 2437
rssi:
type: number
description: Received signal strength, in dBm, for this FFT sample
examples:
- -70
signal7:
type: number
description: Additional signal level, in dBm, reported for this FFT sample
examples:
- -70
description: FFT sample data for a specific frequency
response_past_spectrum_analysis_result:
title: response_past_spectrum_analysis_result
type: object
properties:
band:
type: string
description: Radio band on which the spectrum analysis was run (for example, 24, 5, or 6)
channel_usage:
type: array
items:
$ref: '#/components/schemas/response_past_spectrum_analysis_channel_usage'
description: Per-channel utilization measurements captured during the analysis
fft_samples:
type: array
items:
$ref: '#/components/schemas/response_past_spectrum_analysis_fft_sample'
description: FFT signal samples captured during the analysis
mac:
type: string
description: AP MAC address for the access point that ran the spectrum analysis
org_id:
type: string
description: Organization that owns the site where the spectrum analysis was run
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
spectrogram_url:
type: string
description: URL to the generated spectrogram image for the spectrum analysis
timestamp:
type: integer
description: Epoch timestamp, in seconds, when the spectrum analysis was run
contentEncoding: int32
description: Result of a past spectrum analysis
response_pcap_ap:
title: response_pcap_ap
type: object
properties:
band:
type: integer
description: Radio band used for the AP packet capture
contentEncoding: int32
bandwidth:
type: integer
description: Channel bandwidth used for the AP packet capture, in MHz
contentEncoding: int32
channel:
type: integer
description: Radio channel used for the AP packet capture
contentEncoding: int32
tcpdump_expression:
type:
- string
- 'null'
description: Tcpdump filter expression applied to the AP packet capture, or null when no filter is applied
description: AP radio settings used for a packet capture
response_pcap_bucket_config:
title: response_pcap_bucket_config
type: object
properties:
bucket:
type: string
description: Custom bucket name used for packet capture storage
detail:
type: string
description: Status or error detail returned for the bucket operation
description: Result of a custom packet capture bucket setup or verification operation
response_pcap_search:
title: response_pcap_search
required:
- end
- limit
- results
- start
type: object
properties:
end:
type: integer
description: Epoch timestamp, in seconds, for the end of the packet capture search window
contentEncoding: int32
limit:
type: integer
description: Maximum number of packet capture records returned in this page
contentEncoding: int32
next:
type: string
description: URL for retrieving the next page of packet capture search results
results:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/response_pcap_search_item'
description: Packet capture records matching the search filters
start:
type: integer
description: Epoch timestamp, in seconds, for the start of the packet capture search window
contentEncoding: int32
total:
type: integer
description: Number of packet capture records matching the search filters across all pages
contentEncoding: int32
description: Paginated response for packet capture search results
response_pcap_search_item:
title: response_pcap_search_item
required:
- timestamp
- type
- url
type: object
properties:
ap_macs:
uniqueItems: true
type: array
items:
type: string
description: AP MAC addresses associated with the packet capture
aps:
type: array
items:
type: string
description: AP MAC addresses included in the packet capture
duration:
type: number
description: Packet capture duration in seconds
examples:
- 600
format:
type: string
description: Output format requested for the packet capture
examples:
- stream
id:
type: string
description: Unique identifier for the packet capture
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
last_seen:
type: number
description: Last seen timestamp of the capture
examples:
- 1693482149.417
max_num_packets:
type: number
description: Maximum number of packets requested for the capture
examples:
- 1024
mxedges:
type: array
items:
type: string
description: List of Mist Edge IDs included in the capture
org_id:
type: string
description: Organization associated with the packet capture
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
pcap_aps:
type: object
additionalProperties:
$ref: '#/components/schemas/response_pcap_search_item_pcap_aps_item'
description: Per-AP radio capture settings keyed by AP MAC address
examples:
- 5c5b35000010:
band: '6'
bandwidth: '20'
channel: 133
tcpdump_expression: null
pcap_url:
type: string
description: URL for downloading the generated PCAP file
site_id:
type:
- string
- 'null'
description: Site associated with the packet capture, when the capture is site-scoped
contentEncoding: uuid
termination_reason:
type: string
description: Reason the packet capture session ended
examples:
- default
timestamp:
type: number
description: Epoch timestamp, in seconds, when the packet capture record was created
readOnly: true
type:
type: string
description: Packet capture type represented by this record
url:
type: string
description: Link for accessing the packet capture output or stream
description: Packet capture record returned by organization or site packet capture search
response_pcap_search_item_pcap_aps_item:
title: response_pcap_search_item_pcap_aps_item
type: object
properties:
band:
type: string
description: Radio band used for this AP capture
bandwidth:
type: string
description: Channel bandwidth used for this AP capture, in MHz
channel:
type: integer
description: Radio channel used for this AP capture
contentEncoding: int32
tcpdump_expression:
type:
- string
- 'null'
description: Tcpdump filter expression applied to this AP capture, or null when no filter is applied
description: AP radio settings captured for a packet capture record
response_pcap_start:
title: response_pcap_start
required:
- id
- org_id
- site_id
- timestamp
- type
type: object
properties:
ap_count:
type: integer
description: Number of APs targeted by the packet capture
contentEncoding: int32
aps:
uniqueItems: true
type: array
items:
type: string
description: AP MAC addresses targeted by the packet capture
client_mac:
type:
- string
- 'null'
description: Client MAC address filter applied to the packet capture, or null when no client filter is used
duration:
type: number
description: Packet capture duration in seconds
enabled:
type: boolean
description: Whether the packet capture session is enabled after the start request
expiry:
type: number
description: Epoch timestamp, in seconds, when the capture session expires
format:
type: string
description: Output format for packet capture data
id:
type: string
description: Unique identifier for the packet capture session
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
include_mcast:
type: boolean
description: Whether multicast traffic is included in the packet capture
max_pkt_len:
type: integer
description: Maximum number of bytes captured from each packet
contentEncoding: int32
num_packets:
type: integer
description: Maximum number of packets to capture; use 0 for unlimited
contentEncoding: int32
org_id:
type: string
description: Organization associated with the packet capture session
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
raw:
type: boolean
description: Whether raw packet data is included in the capture output
site_id:
type:
- string
- 'null'
description: Site associated with the packet capture session, when site-scoped
contentEncoding: uuid
ssid:
type:
- string
- 'null'
description: Wireless network SSID filter applied to the packet capture, or null when no SSID filter is used
tcpdump_parser_expression:
type:
- string
- 'null'
description: Tcpdump parser expression applied to the packet capture, or null when no parser expression is used
timestamp:
type: number
description: Epoch timestamp, in seconds, when the packet capture session was created
readOnly: true
type:
type: string
description: Packet capture type requested by the start operation
description: Packet capture session created by a start request
response_pcap_status:
title: response_pcap_status
required:
- id
- type
type: object
properties:
ap_mac:
type:
- string
- 'null'
description: AP MAC address targeted by the packet capture, or null when no single AP filter is set
aps:
type: array
items:
type: string
description: AP MAC addresses targeted by the packet capture
client_mac:
type:
- string
- 'null'
description: Client MAC address filter applied to the packet capture, or null when no client filter is used
examples:
- 60a10a773412
duration:
type: integer
description: Configured packet capture duration, in seconds
contentEncoding: int32
examples:
- 300
enabled:
type: boolean
description: Whether the packet capture session is currently enabled
expiry:
type: number
description: Epoch timestamp, in seconds, when the capture session expires
examples:
- 1695838060.309526
failed:
type: array
items:
type: string
description: AP MAC addresses where capture configuration failed
format:
allOf:
- $ref: '#/components/schemas/capture_mxedge_format2'
- description: 'Output format for packet capture data. enum: `stream`, `tzsp`.'
gateways:
type: array
items:
type: string
description: Gateway devices included in the packet capture session
id:
type: string
description: Unique identifier for the packet capture session
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
includes_mcast:
type: boolean
description: Whether multicast traffic is included in the packet capture
invalid_mxedges:
type: object
description: Map of Mist Edge IDs that could not be configured for capture
max_num_packets:
type: integer
description: Max number of packets configured by user
contentEncoding: int32
examples:
- 1000
max_pkt_len:
type: integer
description: Maximum number of bytes captured from each packet
contentEncoding: int32
examples:
- 512
mxedge_count:
type: integer
description: Number of Mist Edges in the capture session
contentEncoding: int32
mxedges:
type: object
additionalProperties:
$ref: '#/components/schemas/response_pcap_status_mxedges_item'
description: Mist Edge capture settings keyed by Mist Edge ID
num_packets:
type: integer
description: total number of packets captured by all AP, not applicable for type [client, new_assoc]
contentEncoding: int32
ok:
type: array
items:
type: string
description: AP MAC addresses successfully configured for packet capture
org_id:
type: string
description: Organization associated with the packet capture session
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
pcap_aps:
type: object
additionalProperties:
$ref: '#/components/schemas/response_pcap_ap'
description: Per-AP radio capture settings keyed by AP MAC address
examples:
- 5c5b35000010:
band: 6
bandwidth: 20
channel: 133
tcpdump_expression: null
radiotap_tcpdump_expression:
type: string
description: When `type`==`radiotap`, radiotap_tcpdump_expression expression provided by the user
raw:
type: boolean
description: Whether raw packet data is included in the capture output
scan_tcpdump_expression:
type: string
description: When `type`==`scan`, scan_tcpdump_expression provided by the user
site_id:
type: string
description: Site associated with the packet capture session, when site-scoped
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
ssid:
type:
- string
- 'null'
description: Wireless network SSID filter applied to the packet capture, or null when no SSID filter is used
started_time:
type: integer
description: Epoch timestamp, in seconds, when the capture session started
contentEncoding: int32
examples:
- 1435080709
switches:
type: array
items:
type: string
description: Switch devices included in the packet capture session
tcpdump_expression:
type: string
description: tcpdump expression provided by the user (common)
timestamp:
type: number
description: Epoch timestamp, in seconds, when the packet capture status was reported
readOnly: true
type:
allOf:
- $ref: '#/components/schemas/pcap_type1'
- description: 'Packet capture type for the current session. enum: `client`, `gateway`, `new_assoc`, `radiotap`, `radiotap,wired`, `wired`, `wireless`.'
examples:
- client
tzsp_host:
type: string
description: Required if `format`==`tzsp`. Remote host accessible to Mist Edges over the network for receiving the captured packets.
examples:
- 192.168.1.2
tzsp_port:
maximum: 65535
minimum: 1
type: integer
description: If `format`==`tzsp`. Port on remote host for receiving the captured packets
contentEncoding: int32
wired_tcpdump_expression:
type: string
description: When `type`==`wired`, wired_tcpdump_expression provided by the user
wireless_tcpdump_expression:
type: string
description: When `type`==`‘wireless’`, wireless_tcpdump_expression provided by the user
description: Current status of a packet capture session
response_pcap_status_mxedges_item:
title: response_pcap_status_mxedges_item
type: object
properties:
interfaces:
type: object
additionalProperties:
$ref: '#/components/schemas/capture_mxedge_mxedges_interfaces'
description: Dict of interfaces to capture on, property key is the port name
description: Mist Edge interface settings for a packet capture
response_port_stats_search:
title: response_port_stats_search
required:
- limit
- results
- total
type: object
properties:
end:
type: integer
description: Epoch timestamp, in seconds, for the end of the port statistics reporting window
contentEncoding: int32
limit:
type: integer
description: Maximum number of port statistics records returned in this page
contentEncoding: int32
next:
type: string
description: URL for retrieving the next page of port statistics search results
results:
type: array
items:
$ref: '#/components/schemas/stats_switch_port'
description: Switch and gateway port statistics records matching the search filters
start:
type: integer
description: Epoch timestamp, in seconds, for the start of the port statistics reporting window
contentEncoding: int32
total:
type: integer
description: Number of port statistics records matching the search filters across all pages
contentEncoding: int32
description: Paginated response for switch and gateway port statistics search results
response_psk_portal_logs_search:
title: response_psk_portal_logs_search
type: object
properties:
end:
type: integer
description: Epoch timestamp, in seconds, for the end of the PSK Portal log search window
contentEncoding: int32
examples:
- 1428954000
limit:
type: integer
description: Maximum number of PSK Portal log entries returned in this page
contentEncoding: int32
examples:
- 100
next:
type: string
description: URL for retrieving the next page of PSK Portal log search results
results:
type: array
items:
$ref: '#/components/schemas/response_psk_portal_logs_search_item'
description: PSK Portal log entries matching the search filters
start:
type: integer
description: Epoch timestamp, in seconds, for the start of the PSK Portal log search window
contentEncoding: int32
examples:
- 1428939600
total:
type: integer
description: Number of PSK Portal log entries matching the search filters across all pages
contentEncoding: int32
examples:
- 135
description: Paginated response for organization PSK Portal log search results
response_psk_portal_logs_search_item:
title: response_psk_portal_logs_search_item
type: object
properties:
id:
type: string
description: Audit log identifier for this PSK Portal log entry
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
message:
type: string
description: Human-readable message describing the PSK Portal action
examples:
- Rotate PSK test@mist.com
name_id:
type: string
description: SSO NameID value associated with the PSK Portal action
examples:
- test@mist.com
org_id:
type: string
description: Organization associated with the PSK Portal log entry
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
psk_id:
type: string
description: Identifier of the PSK associated with the log entry
contentEncoding: uuid
examples:
- 608fe603-f9f0-4ce9-9473-04ef6c6ea749
psk_name:
type: string
description: Display name of the PSK associated with the log entry
examples:
- test@mist.com
pskportal_id:
type: string
description: Identifier of the PSK Portal associated with the log entry
contentEncoding: uuid
examples:
- c1742c09-af35-4161-96ef-7dc65c6d5674
timestamp:
type: number
description: Epoch timestamp, in seconds, when the PSK Portal log entry was recorded
readOnly: true
description: PSK Portal log entry returned by organization log search
response_router_ssr_register_cmd:
title: response_router_ssr_register_cmd
type: object
properties:
conductor_cmd:
type: string
description: Command to run in the SSR conductor CLI for Mist registration
registration_code:
type: string
description: Registration token used by the SSR registration commands
router_shell_cmd:
type: string
description: Shell command to run on the SSR router for Mist registration
description: SSR registration token and commands used to register the router with Mist
response_rrm_channel_scores:
title: response_rrm_channel_scores
required:
- results
type: object
properties:
results:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/rrm_channel_score'
description: Per-channel RRM score records for the requested band
description: Response containing RRM channel score records
rrm_channel_score:
title: rrm_channel_score
required:
- channel
- util_score
- util_score_noise_floor
- util_score_non_wifi
- util_score_other
- util_score_radar
- util_score_undecodable_wifi
- util_score_unknown_wifi
type: object
properties:
channel:
type: integer
description: RF channel number represented by this score record
contentEncoding: int32
util_score:
type: number
description: Utilization score for the channel, 0-1, lower means cleaner RF
util_score_noise_floor:
type: number
description: Score contribution from noise, 0-1, lower means cleaner RF
util_score_non_wifi:
type: number
description: Score contribution from non-wifi utilization, 0-1, lower means cleaner RF
util_score_other:
type: number
description: Score contribution from RxOtherBss utilization (wifi packets destined for other radios), 0-1, lower means cleaner RF
util_score_radar:
type: number
description: Score contribution from radar detections, 0-1, lower means cleaner RF
util_score_undecodable_wifi:
type: number
description: Score contribution from undecodable wifi utilization (wifi packets which can't be decoded), 0-1, lower means cleaner RF
util_score_unknown_wifi:
type: number
description: Score contribution from unknown wifi utilization (wifi packets of unknown type), 0-1, lower means cleaner RF
description: RRM utilization score for a channel
response_rrm_consideration:
title: response_rrm_consideration
required:
- results
type: object
properties:
results:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/rrm_consideration'
description: Channel consideration metrics used by RRM for the AP radio band
description: Response containing current RRM considerations for an AP radio band
rrm_consideration:
title: rrm_consideration
required:
- channel
- noise
- util_score
- util_score_non_wifi
- util_score_other
type: object
properties:
channel:
type: integer
description: Candidate RF channel evaluated by RRM
contentEncoding: int32
noise:
type: number
description: Observed noise floor for the candidate channel, in dBm
other_rssi:
type: number
description: Avg RSSI heard from other APs (that does NOT belongs to the same site)
other_ssid:
type: string
description: SSID from other AP that we heard from with the max RSSI
rssi:
type: number
description: Avg RSSI heard from APs (that belongs to the same site)
util_score:
type: number
description: utilization score, 0-1, lower means less utilization (cleaner RF)
util_score_non_wifi:
type: number
description: non-Wi-Fi utilization score, 0-1, lower means less utilization (cleaner RF)
util_score_other:
type: number
description: other utilization score, 0-1, lower means less utilization (cleaner RF)
description: RRM consideration metrics for one candidate channel
response_rrm_neighbors:
title: response_rrm_neighbors
required:
- end
- limit
- results
- start
type: object
properties:
end:
type: integer
description: Epoch timestamp, in seconds, for the end of the RRM neighbor observation window
contentEncoding: int32
limit:
type: integer
description: Maximum number of RRM neighbor records returned in this page
contentEncoding: int32
next:
type: string
description: Link to query next set of results. value is null if no next page exists.
results:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/rrm_neighbors'
description: RRM neighbor records observed for the requested site and band
start:
type: integer
description: Epoch timestamp, in seconds, for the start of the RRM neighbor observation window
contentEncoding: int32
description: Paginated response for current RRM neighbor observations
rrm_neighbors:
title: rrm_neighbors
type: object
properties:
mac:
type: string
description: AP MAC address whose neighbors are reported
examples:
- 5c5b35000001
neighbors:
type: array
items:
$ref: '#/components/schemas/rrm_neighbors_neighbor'
description: Neighbor AP observations heard by this AP
description: RRM neighbor observations for one AP
response_running_spectrum_analysis:
title: response_running_spectrum_analysis
type: object
properties:
band:
type: string
description: Radio band currently being scanned by spectrum analysis, such as 24, 5, or 6
channels:
type: array
items:
type: integer
contentEncoding: int32
description: List of channels being scanned in the spectrum analysis
device_id:
type: string
description: Device ID of the AP that is running spectrum analysis
contentEncoding: uuid
duration:
type: integer
description: Length of the running spectrum analysis session, in seconds
contentEncoding: int32
format:
type: string
description: Output format for the running spectrum analysis data, such as json or stream
started_time:
type: integer
description: Timestamp when the spectrum analysis was started
contentEncoding: int32
width:
type: integer
description: Channel width used during the spectrum analysis scan, in MHz
contentEncoding: int32
description: Running spectrum analysis session for a site
response_search:
title: response_search
required:
- limit
- page
- results
- total
type: object
properties:
limit:
type: integer
description: Maximum number of MSP search results returned in this page
contentEncoding: int32
next:
type: string
description: URL for retrieving the next page of MSP search results
page:
type: integer
description: Current page number returned for the MSP search results
contentEncoding: int32
results:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/response_search_item'
description: MSP search result entries matching the query
total:
type: integer
description: Number of MSP search results matching the query across all pages
contentEncoding: int32
description: Paginated response for MSP organization search results
response_search_bgps:
title: response_search_bgps
type: object
properties:
end:
type: number
description: Epoch timestamp, in seconds, for the end of the BGP statistics search window
limit:
type: integer
description: Maximum number of BGP peer statistics records returned in this page
contentEncoding: int32
next:
type: string
description: URL for retrieving the next page of BGP peer statistics results
results:
type: array
items:
$ref: '#/components/schemas/bgp_stats'
description: BGP peer statistics records matching the search filters
start:
type: number
description: Epoch timestamp, in seconds, for the start of the BGP statistics search window
total:
type: integer
description: Number of BGP peer statistics records matching the search filters across all pages
contentEncoding: int32
description: Paginated response for BGP peer statistics search results
response_search_item:
title: response_search_item
required:
- id
- text
- type
type: object
properties:
id:
type: string
description: Unique identifier for the matching MSP search result
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
text:
type: string
description: Display text for the MSP search result
type:
type: string
description: Category of MSP search result, such as `orgs`
description: MSP search result entry
response_search_var:
title: response_search_var
type: object
properties:
end:
type: integer
description: Epoch timestamp, in seconds, for the end of the variable search window
contentEncoding: int32
limit:
type: integer
description: Maximum number of variable records returned in this page
contentEncoding: int32
next:
type: string
description: URL for retrieving the next page of variable search results
results:
type: array
items:
$ref: '#/components/schemas/response_search_var_item'
description: Organization variable records matching the search filters
start:
type: integer
description: Epoch timestamp, in seconds, for the start of the variable search window
contentEncoding: int32
total:
type: integer
description: Number of variable records matching the search filters across all pages
contentEncoding: int32
description: Paginated response for organization variable search results
response_search_var_item:
title: response_search_var_item
type: object
properties:
created_time:
type: number
description: Timestamp when the organization variable was created
readOnly: true
modified_time:
type: number
description: Timestamp when the organization variable was last modified
readOnly: true
org_id:
type: string
description: Organization associated with the variable
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
site_id:
type: string
description: Site associated with the variable, when the source is site-scoped
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
src:
type: string
description: Source scope for the variable, such as `site` or `deviceprofile`
var:
type: string
description: Name of the variable matched by the search
description: Organization variable record returned by search
response_self_audit_logs:
title: response_self_audit_logs
required:
- end
- limit
- page
- results
- start
- total
type: object
properties:
end:
type: integer
description: Epoch timestamp, in seconds, for the end of the self audit log search window
contentEncoding: int32
limit:
type: integer
description: Maximum number of self audit log entries returned in this page
contentEncoding: int32
page:
type: integer
description: Current page number returned for self audit log results
contentEncoding: int32
results:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/audit_log'
description: Audit log entries for the current admin matching the filters
start:
type: integer
description: Epoch timestamp, in seconds, for the start of the self audit log search window
contentEncoding: int32
total:
type: integer
description: Number of self audit log entries matching the filters across all pages
contentEncoding: int32
description: Paginated response for audit logs for the current admin across organizations
response_self_oauth_link_failure:
title: response_self_oauth_link_failure
required:
- error
- error_description
type: object
properties:
error:
type: string
description: OAuth2 error code returned during account linking
error_description:
type: string
description: Human-readable description of the OAuth2 account-linking failure
description: OAuth2 account-linking failure response
response_self_oauth_link_success:
title: response_self_oauth_link_success
required:
- action
- id
type: object
properties:
action:
type: string
description: Completed OAuth2 account-linking action
id:
type: string
description: Linked OAuth2 account identifier returned by the provider
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
description: OAuth2 account-linking success response
response_self_oauth_url:
title: response_self_oauth_url
required:
- authorization_url
- linked
type: object
properties:
authorization_url:
type: string
description: OAuth2 provider authorization URL used to link the Mist account
linked:
type: boolean
description: Whether the Mist account is already linked with this OAuth2 provider
description: OAuth2 authorization URL response for linking the current Mist account
response_self_subscription:
title: response_self_subscription
required:
- org_id
type: object
properties:
org_id:
type: string
description: Organization associated with this subscription record
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
description: Subscription record visible to the current account
response_set_devices_map:
title: response_set_devices_map
type: object
properties:
locked:
type: array
items:
type: string
description: AP MAC addresses that were locked and not moved to the requested map
moved:
type: array
items:
type: string
description: AP MAC addresses successfully associated with the requested map
description: Result of assigning APs to a site map
response_site_device_upgrade:
title: response_site_device_upgrade
required:
- id
type: object
properties:
canary_phases:
type: array
items:
type: integer
contentEncoding: int32
description: Canary deployment phase percentages configured for the upgrade
default:
- 1
- 10
- 50
- 100
current_phase:
type: integer
description: Current canary or rrm phase in progress
contentEncoding: int32
enable_p2p:
type: boolean
description: Whether to allow local AP-to-AP FW upgrade
default: false
force:
type: boolean
description: Whether to force upgrade when requested version is same as running version
id:
type: string
description: Unique identifier for the site device upgrade job
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
max_failure_percentage:
type: integer
description: Percentage of failures allowed
contentEncoding: int32
max_failures:
type: array
items:
type: integer
contentEncoding: int32
description: Per-phase failure thresholds configured for a canary upgrade
p2p_cluster_size:
type: integer
description: size to split the devices for p2p
contentEncoding: int32
default: 10
p2p_parallelism:
type: integer
description: number of parallel p2p download batches to create
contentEncoding: int32
default: 1
reboot_at:
type: integer
description: reboot start time in epoch
contentEncoding: int32
start_time:
type: integer
description: Firmware download start time in epoch
contentEncoding: int32
status:
allOf:
- $ref: '#/components/schemas/upgrade_device_status1'
- description: 'Current status of the site device upgrade job. enum: `cancelled`, `completed`, `created`, `downloaded`, `downloading`, `failed`, `queued`, `upgrading`.'
strategy:
allOf:
- $ref: '#/components/schemas/upgrade_device_strategy1'
- description: 'Device upgrade strategy used by this job. enum: `big_bang`, `canary`, `rrm`, `serial`.'
target_version:
minLength: 1
type: string
description: Version to upgrade to
targets:
allOf:
- $ref: '#/components/schemas/upgrade_devices_targets3'
- description: Device targets grouped by upgrade and download status
readOnly: true
upgrade_plan:
type: object
additionalProperties:
type: array
items:
type: string
description: Phase-to-device upgrade plan for non-big-bang strategies
description: Phase-to-device upgrade plan for non-big-bang strategies
description: Site device upgrade job details
response_site_device_upgrades_item:
title: response_site_device_upgrades_item
required:
- id
type: object
properties:
counts:
allOf:
- $ref: '#/components/schemas/upgrade_site_devices_counts2'
- description: Device counts grouped by upgrade status for this job
readOnly: true
current_phase:
type: integer
description: Current canary or rrm phase in progress
contentEncoding: int32
enable_p2p:
type: boolean
description: Whether to allow local AP-to-AP FW upgrade
force:
type: boolean
description: Whether to force upgrade when requested version is same as running version
id:
type: string
description: Unique identifier for the site device upgrade job
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
max_failure_percentage:
type: integer
description: Percentage of failures allowed
contentEncoding: int32
max_failures:
type: array
items:
type: integer
contentEncoding: int32
description: Per-phase failure thresholds configured for a canary upgrade
reboot_at:
type: integer
description: reboot start time in epoch
contentEncoding: int32
start_time:
type: integer
description: Firmware download start time in epoch
contentEncoding: int32
status:
allOf:
- $ref: '#/components/schemas/upgrade_device_status1'
- description: 'Current status of the site device upgrade job. enum: `cancelled`, `completed`, `created`, `downloaded`, `downloading`, `failed`, `queued`, `upgrading`.'
strategy:
allOf:
- $ref: '#/components/schemas/upgrade_device_strategy1'
- description: 'Device upgrade strategy used by this job. enum: `big_bang`, `canary`, `rrm`, `serial`.'
target_version:
minLength: 1
type: string
description: Version to upgrade to
upgrade_plan:
type: object
description: a dictionary of rrm phase number to devices part of that phase
description: Site device upgrade job summary
response_site_search:
title: response_site_search
required:
- end
- limit
- results
- start
- total
type: object
properties:
end:
type: integer
description: Epoch timestamp, in seconds, for the end of the site search window
contentEncoding: int32
limit:
type: integer
description: Maximum number of site records returned in this page
contentEncoding: int32
next:
type: string
description: URL for retrieving the next page of site search results
results:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/response_site_search_item'
description: Site records matching the organization search filters
start:
type: integer
description: Epoch timestamp, in seconds, for the start of the site search window
contentEncoding: int32
total:
type: integer
description: Number of site records matching the search filters across all pages
contentEncoding: int32
description: Paginated response for organization site search results
response_site_search_item:
title: response_site_search_item
required:
- auto_upgrade_enabled
- auto_upgrade_version
- honeypot_enabled
- id
- name
- org_id
- site_id
- timestamp
- timezone
- vna_enabled
- wifi_enabled
type: object
properties:
auto_upgrade_enabled:
type: boolean
description: Whether automatic firmware upgrade is enabled for the site
auto_upgrade_version:
type: string
description: Desired automatic firmware upgrade version track for the site
readOnly: true
country_code:
type:
- string
- 'null'
description: Country code configured for the site, or null if unset
readOnly: true
honeypot_enabled:
type: boolean
description: Whether honeypot detection is enabled for the site
id:
type: string
description: Unique identifier for the site search result
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
name:
type: string
description: Display name of the site
readOnly: true
org_id:
type: string
description: Organization that owns the site
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
site_id:
type: string
description: Site identifier for this search result
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
timestamp:
type: number
description: Epoch timestamp, in seconds, for this site search result
readOnly: true
timezone:
type: string
description: Time zone configured for the site
readOnly: true
vna_enabled:
type: boolean
description: Whether Virtual Network Assistant is enabled for the site
wifi_enabled:
type: boolean
description: Whether Wi-Fi service is enabled for the site
description: Site record returned by organization site search
response_sso_failure_search:
title: response_sso_failure_search
required:
- results
type: object
properties:
results:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/response_sso_failure_search_item'
description: SSO authentication failure records returned by the request
description: Response containing recent SSO authentication failure records
response_sso_failure_search_item:
title: response_sso_failure_search_item
required:
- detail
- saml_assertion_xml
- timestamp
type: object
properties:
detail:
type: string
description: Failure details reported for the SSO authentication attempt
saml_assertion_xml:
type: string
description: SAML assertion XML captured for the failed SSO authentication attempt
timestamp:
type: number
description: Epoch timestamp, in seconds, when the SSO authentication failure occurred
readOnly: true
description: SSO authentication failure record
response_ssr_export_id_tokens:
title: response_ssr_export_id_tokens
type: object
properties:
results:
type: array
items:
$ref: '#/components/schemas/response_ssr_export_id_tokens_results_item'
description: Exported SSR ID token records for the requested devices
description: Response containing SSR ID tokens exported for device onboarding
response_ssr_export_id_tokens_results_item:
title: response_ssr_export_id_tokens_results_item
type: object
properties:
mac:
type: string
description: SSR device MAC address for the exported ID token
token:
type: string
description: ID token to import into Conductor for SSR device onboarding
description: SSR ID token record for a device
response_ssr_upgrade:
title: response_ssr_upgrade
required:
- channel
- counts
- device_type
- id
- status
- strategy
- versions
type: object
properties:
channel:
minLength: 1
type: string
description: Firmware release channel used for the SSR upgrade
counts:
allOf:
- $ref: '#/components/schemas/response_ssr_upgrade_counts'
- description: Device counts grouped by SSR upgrade status
device_type:
type: string
description: Type of devices targeted by the SSR upgrade
force:
type: boolean
description: Whether the upgrade was forced even when the requested version matched the running version
default: false
id:
type: string
description: Unique identifier for the SSR upgrade job
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
status:
minLength: 1
type: string
description: Current status of the SSR upgrade job
strategy:
minLength: 1
type: string
description: Upgrade strategy used by the SSR upgrade job
versions:
type: object
additionalProperties:
type: string
description: SSR firmware versions included in the upgrade job
description: SSR firmware upgrade job summary
response_ssr_upgrade_counts:
title: response_ssr_upgrade_counts
required:
- failed
- queued
- success
- upgrading
type: object
properties:
failed:
type: integer
description: Number of SSR devices that failed the upgrade
contentEncoding: int32
queued:
type: integer
description: Number of SSR devices queued for upgrade
contentEncoding: int32
success:
type: integer
description: Number of SSR devices successfully upgraded
contentEncoding: int32
upgrading:
type: integer
description: Number of SSR devices currently upgrading
contentEncoding: int32
description: Device counts grouped by SSR upgrade status
response_ssr_upgrade_status:
title: response_ssr_upgrade_status
required:
- channel
- id
- status
- targets
- versions
type: object
properties:
channel:
minLength: 1
type: string
description: Firmware release channel used for the SSR upgrade
device_type:
type: string
description: Type of devices targeted by the SSR upgrade
force:
type: boolean
description: Whether the upgrade was forced even when the requested version matched the running version
default: false
id:
type: string
description: Unique identifier for the SSR upgrade job
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
status:
minLength: 1
type: string
description: Current status of the SSR upgrade job
strategy:
minLength: 1
type: string
description: Upgrade strategy used by the SSR upgrade job
targets:
allOf:
- $ref: '#/components/schemas/response_ssr_upgrade_status_targets'
- description: SSR device IDs grouped by upgrade status
versions:
type: object
description: SSR firmware versions included in the upgrade job
description: Detailed status for an SSR firmware upgrade job
response_ssr_upgrade_status_targets:
title: response_ssr_upgrade_status_targets
required:
- failed
- queued
- success
- upgrading
type: object
properties:
failed:
uniqueItems: true
type: array
items:
type: string
description: SSR device IDs that failed the upgrade
queued:
uniqueItems: true
type: array
items:
type: string
description: SSR device IDs queued for upgrade
success:
uniqueItems: true
type: array
items:
type: string
description: SSR device IDs successfully upgraded
upgrading:
uniqueItems: true
type: array
items:
type: string
description: SSR device IDs currently upgrading
description: SSR device IDs grouped by upgrade status
response_stats_assets:
title: response_stats_assets
required:
- end
- limit
- results
- start
- total
type: object
properties:
end:
type: integer
description: Epoch timestamp, in seconds, for the end of the asset statistics search window
contentEncoding: int32
limit:
type: integer
description: Maximum number of asset statistics records returned in this page
contentEncoding: int32
next:
type: string
description: URL for retrieving the next page of asset statistics results
results:
type: array
items:
$ref: '#/components/schemas/stats_asset'
description: Asset statistics records matching the search filters
start:
type: integer
description: Epoch timestamp, in seconds, for the start of the asset statistics search window
contentEncoding: int32
total:
type: integer
description: Number of asset statistics records matching the search filters across all pages
contentEncoding: int32
description: Paginated response for asset statistics search results
response_stats_calls:
title: response_stats_calls
type: object
properties:
end:
type: number
description: Epoch timestamp, in seconds, for the end of the call statistics search window
limit:
type: integer
description: Maximum number of call statistics records returned in this page
contentEncoding: int32
next:
type: string
description: URL for retrieving the next page of call statistics results
results:
type: array
items:
$ref: '#/components/schemas/stats_call'
description: Call statistics records matching the search filters
start:
type: number
description: Epoch timestamp, in seconds, for the start of the call statistics search window
total:
type: integer
description: Number of call statistics records matching the search filters across all pages
contentEncoding: int32
description: Paginated response for site call statistics search results
response_stats_calls_summary:
title: response_stats_calls_summary
type: object
properties:
bad_minutes:
type: number
description: Total call minutes classified as bad across all quality categories
examples:
- 5566
bad_minutes_client:
type: number
description: Call minutes classified as bad due to client-side issues
examples:
- 526
bad_minutes_site_wan:
type: number
description: Call minutes classified as bad due to site WAN issues
examples:
- 3612
bad_minutes_wireless:
type: number
description: Call minutes classified as bad due to wireless issues
examples:
- 1428
num_aps:
type: integer
description: Number of APs represented in the call statistics summary
contentEncoding: int32
examples:
- 1
num_users:
type: integer
description: Number of users represented in the call statistics summary
contentEncoding: int32
examples:
- 3
total_minutes:
type: number
description: Total call minutes represented in the summary
examples:
- 5566
description: Aggregated site call statistics summary
response_switch_metrics:
title: response_switch_metrics
type: object
properties:
active_ports_summary:
allOf:
- $ref: '#/components/schemas/response_switch_metrics_active_ports_summary2'
- description: Summary metric for active switch ports
config_success:
allOf:
- $ref: '#/components/schemas/response_switch_metrics_config_success'
- description: Configuration success metric for switches in the requested scope
version_compliance:
allOf:
- $ref: '#/components/schemas/response_switch_metrics_version_compliance2'
- description: Software version compliance metric for switches in the requested scope
description: Switch metrics returned for the requested site or switch scope
response_switch_metrics_active_ports_summary:
title: response_switch_metrics_active_ports_summary
type: object
properties:
details:
allOf:
- $ref: '#/components/schemas/switch_metrics_active_ports_summary_details2'
- description: Port counts used to calculate the active-port summary metric
score:
type: integer
description: Reported metric score for active switch ports
contentEncoding: int32
total_switch_count:
type: integer
description: Number of switches included in the active-port summary metric
contentEncoding: int32
description: Active-port summary metric for switches in the requested scope
response_switch_metrics_config_success:
title: response_switch_metrics_config_success
type: object
properties:
details:
allOf:
- $ref: '#/components/schemas/response_switch_metrics_config_success_details2'
- description: Configuration success counts used to calculate the metric
score:
type: integer
description: Reported metric score for switch configuration success
contentEncoding: int32
total_switch_count:
type: integer
description: Number of switches included in the configuration success metric
contentEncoding: int32
description: Configuration success metric for switches in the requested scope
response_switch_metrics_config_success_details:
title: response_switch_metrics_config_success_details
type: object
properties:
config_success_count:
type: integer
description: Number of switches with successful configuration status
contentEncoding: int32
description: Detail values for the switch configuration success metric
response_switch_metrics_version_compliance:
title: response_switch_metrics_version_compliance
type: object
properties:
details:
allOf:
- $ref: '#/components/schemas/response_switch_metrics_version_compliance_details2'
- description: Version groupings used to calculate the compliance metric
score:
type: integer
description: Reported metric score for switch software version compliance
contentEncoding: int32
total_switch_count:
type: integer
description: Number of switches included in the version compliance metric
contentEncoding: int32
description: Version compliance metric for switches in the requested scope
response_switch_metrics_version_compliance_details:
title: response_switch_metrics_version_compliance_details
type: object
properties:
major_versions:
type: array
items:
$ref: '#/components/schemas/switch_metrics_compliance_major_version'
description: Software version groupings found among the evaluated switches
description: Detail values for the switch software version compliance metric
response_switch_port_search:
title: response_switch_port_search
required:
- limit
- results
- total
type: object
properties:
end:
type: integer
description: Epoch timestamp, in seconds, for the end of the port statistics reporting window
contentEncoding: int32
examples:
- 1513177200
limit:
type: integer
description: Maximum number of port statistics records returned in this page
contentEncoding: int32
examples:
- 10
next:
type: string
description: URL for retrieving the next page of switch and gateway port statistics results
results:
type: array
items:
$ref: '#/components/schemas/stats_switch_port'
description: Switch and gateway port statistics records matching the search filters
start:
type: integer
description: Epoch timestamp, in seconds, for the start of the port statistics reporting window
contentEncoding: int32
examples:
- 1511967600
total:
type: integer
description: Number of port statistics records matching the search filters across all pages
contentEncoding: int32
examples:
- 100
description: Paginated response for switch and gateway port statistics search results
stats_switch_port:
title: stats_switch_port
required:
- mac
- org_id
- port_id
- site_id
type: object
properties:
active:
type: boolean
description: Indicates if interface is active/inactive
readOnly: true
auth_state:
allOf:
- $ref: '#/components/schemas/port_auth_state1'
- description: 'Authentication state of the port. enum: ``, `authenticated`, `authenticating`, `held`, `init`.'
disabled:
type: boolean
description: Indicates if interface is disabled
readOnly: true
for_site:
type: boolean
description: Whether the reporting device is scoped to a specific site
readOnly: true
full_duplex:
type: boolean
description: Indicates full or half duplex
examples:
- true
jitter:
type: number
description: Last sampled jitter of the interface
readOnly: true
last_flapped:
type: number
description: Indicates when the port was last flapped
readOnly: true
latency:
type: number
description: Last sampled latency of the interface
readOnly: true
loss:
type: number
description: Last sampled loss of the interface
readOnly: true
lte_iccid:
type:
- string
- 'null'
description: LTE ICCID value, Check for null/empty
lte_imei:
type:
- string
- 'null'
description: LTE IMEI value, Check for null/empty
lte_imsi:
type:
- string
- 'null'
description: LTE IMSI value, Check for null/empty
mac:
type: string
description: Switch MAC address that reported these port statistics
readOnly: true
examples:
- 5c4527a96580
mac_count:
type: integer
description: Number of MAC addresses in the forwarding table
contentEncoding: int32
readOnly: true
mac_limit:
minimum: 0
type: integer
description: Limit on number of dynamically learned macs
contentEncoding: int32
readOnly: true
neighbor_mac:
type: string
description: chassis identifier of the chassis type listed
readOnly: true
examples:
- 64d814353400
neighbor_port_desc:
type: string
description: Description supplied by the system on the interface E.g. "GigabitEthernet2/0/39"
readOnly: true
examples:
- GigabitEthernet1/0/21
neighbor_system_name:
type: string
description: Name supplied by the system on the interface E.g. neighbor system name E.g. "Kumar-Acc-SW.mist.local"
readOnly: true
examples:
- CORP-D-SW-2
org_id:
type: string
description: Organization identifier of the reporting switch
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
poe_disabled:
type: boolean
description: Is the POE disabled
readOnly: true
poe_mode:
allOf:
- $ref: '#/components/schemas/stats_switch_port_poe_mode1'
- description: 'PoE mode reported for the port. enum: `802.3af`, `802.3at`, `802.3bt`.'
poe_on:
type: boolean
description: Is the device attached to POE
readOnly: true
poe_priority:
allOf:
- $ref: '#/components/schemas/poe_priority2'
- description: 'PoE priority configured for the port. enum: `low`, `high`.'
port_id:
type: string
description: Identifier of the port reporting these statistics
readOnly: true
examples:
- ge-0/0/0
port_mac:
type: string
description: MAC address assigned to the interface
readOnly: true
examples:
- 5c4527a96580
port_usage:
type: string
description: Logical usage assigned to the port
examples:
- lan
power_draw:
type: number
description: Amount of power being used by the interface at the time the command is executed. Unit in watts.
readOnly: true
rx_bcast_pkts:
type: integer
description: Number of broadcast packets received on the interface
contentEncoding: int32
readOnly: true
rx_bps:
type:
- integer
- 'null'
description: Receive throughput of the port, in bits per second
contentEncoding: int64
readOnly: true
examples:
- 60003
rx_bytes:
type:
- integer
- 'null'
description: Total bytes received on the port
contentEncoding: int64
readOnly: true
examples:
- 8515104416
rx_errors:
type: integer
description: Number of receive errors observed on the interface
contentEncoding: int32
readOnly: true
rx_mcast_pkts:
type: integer
description: Number of multicast packets received on the interface
contentEncoding: int32
readOnly: true
rx_pkts:
type:
- integer
- 'null'
description: Total packets received on the port
contentEncoding: int64
readOnly: true
examples:
- 57770567
site_id:
type: string
description: Site identifier of the reporting switch
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
speed:
type: integer
description: Current link speed of the port, in Mbps
contentEncoding: int32
readOnly: true
examples:
- 1000
stp_role:
allOf:
- $ref: '#/components/schemas/port_stp_role1'
- description: 'Current spanning tree role of the port. enum: ``, `alternate`, `backup`, `designated`, `disabled`, `root`, `root-prevented`.'
stp_state:
allOf:
- $ref: '#/components/schemas/port_stp_state1'
- description: 'Current spanning tree state of the port. enum: ``, `blocking`, `disabled`, `forwarding`, `learning`, `listening`.'
tx_bcast_pkts:
type: integer
description: Number of broadcast packets transmitted on the interface
contentEncoding: int32
readOnly: true
tx_bps:
type:
- integer
- 'null'
description: Transmit throughput of the port, in bits per second
contentEncoding: int64
readOnly: true
examples:
- 634301
tx_bytes:
type:
- integer
- 'null'
description: Total bytes transmitted on the port
contentEncoding: int64
readOnly: true
examples:
- 211217389682
tx_errors:
type: integer
description: Number of transmit errors observed on the interface
contentEncoding: int32
readOnly: true
tx_mcast_pkts:
type: integer
description: Number of multicast packets transmitted on the interface
contentEncoding: int32
readOnly: true
tx_pkts:
type:
- integer
- 'null'
description: Total packets transmitted on the port
contentEncoding: int64
readOnly: true
examples:
- 812204062
type:
allOf:
- $ref: '#/components/schemas/stats_switch_port_type1'
- description: 'Detected device category connected to the port, when available. enum: `ap`, `ble`, `gateway`, `mxedge`, `nac`, `switch`.'
examples:
- gateway
unconfigured:
type: boolean
description: Indicates if interface is unconfigured
readOnly: true
up:
type: boolean
description: Indicates if interface is up
readOnly: true
uplink:
type: boolean
description: Indicates if interface is an uplink port
readOnly: true
xcvr_model:
type: string
description: Optic Slot ModelName, Check for null/empty
readOnly: true
examples:
- SFP+-10G-SR
xcvr_part_number:
type: string
description: Optic Slot Partnumber, Check for null/empty
readOnly: true
examples:
- 740-021487
xcvr_serial:
type: string
description: Optic Slot SerialNumber, Check for null/empty
readOnly: true
examples:
- N6AA9HT
description: Switch port statistics record returned by stats APIs
response_synthetictest:
title: response_synthetictest
type: object
properties:
id:
type: string
description: Unique value for the queued synthetic test request
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
message:
type: string
description: Human-readable queuing result returned by the API
examples:
- Successfully queued synthetic test for the site.
status:
type: string
description: Queue status for the synthetic test request
examples:
- success
description: Result returned after a site synthetic test is queued
response_synthetictest_search:
title: response_synthetictest_search
required:
- end
- limit
- results
- start
- total
type: object
properties:
end:
type: integer
description: Epoch timestamp, in seconds, for the end of the synthetic test search window
contentEncoding: int32
limit:
type: integer
description: Maximum number of synthetic test results returned in this page
contentEncoding: int32
next:
type: string
description: URL for retrieving the next page of synthetic test results
results:
type: array
items:
$ref: '#/components/schemas/synthetictest_info'
description: Synthetic test result records matching the search filters
start:
type: integer
description: Epoch timestamp, in seconds, for the start of the synthetic test search window
contentEncoding: int32
total:
type: integer
description: Number of synthetic test results matching the search filters across all pages
contentEncoding: int32
description: Paginated response for site synthetic test search results
synthetictest_info:
title: synthetictest_info
type: object
properties:
by:
type: string
description: Actor that triggered the synthetic test
examples:
- user
device_type:
allOf:
- $ref: '#/components/schemas/device_type4'
- description: 'Device category that ran the synthetic test. enum: `ap`, `gateway`, `switch`.'
failed:
type: boolean
description: Whether the synthetic test failed
examples:
- false
latency:
type: integer
description: Measured latency for the synthetic test, in milliseconds
contentEncoding: int32
examples:
- 40
mac:
type: string
description: Device MAC address that ran the synthetic test
port_id:
type: string
description: Interface identifier used to run the synthetic test
examples:
- ge-0/0/2
reason:
type: string
description: Failure reason reported for the synthetic test, when available
examples:
- interface not ready to perform test
rx_mbps:
type: integer
description: Receive throughput measured by the synthetic speed test, in Mbps
contentEncoding: int32
examples:
- 322
start_time:
type: integer
description: Epoch timestamp, in seconds, when the synthetic test started
contentEncoding: int32
examples:
- 1675718807
status:
type: string
description: Current execution status of the synthetic test
timestamp:
type: number
description: Time when the synthetic test result was recorded
readOnly: true
tx_mbps:
type: integer
description: Transmit throughput measured by the synthetic speed test, in Mbps
contentEncoding: int32
examples:
- 199
type:
allOf:
- $ref: '#/components/schemas/synthetictest_type3'
- description: 'Synthetic test type for this result. enum: `arp`, `curl`, `dhcp`, `dhcp6`, `dns`, `lan_connectivity`, `radius`, `speedtest`.'
vlan_id:
type: integer
description: Identifier of the VLAN used by the synthetic test
contentEncoding: int32
examples:
- 20
description: Synthetic test status or result record
response_troubleshoot:
title: response_troubleshoot
type: object
properties:
end:
type: integer
description: Epoch timestamp, in seconds, for the end of the troubleshooting window
contentEncoding: int32
examples:
- 1655151856
results:
type: array
items:
$ref: '#/components/schemas/response_troubleshoot_item'
description: Troubleshooting findings returned for the requested target and window
start:
type: integer
description: Epoch timestamp, in seconds, for the start of the troubleshooting window
contentEncoding: int32
examples:
- 1655065456
description: Organization troubleshooting response for the requested time window
response_troubleshoot_item:
title: response_troubleshoot_item
type: object
properties:
category:
type: string
description: Entity category associated with the troubleshooting finding
examples:
- client
reason:
type: string
description: Issue reason identified by the troubleshooting analysis
examples:
- slow association
recommendation:
type: string
description: Recommended remediation guidance for the troubleshooting finding
examples:
- Ensure the IP helper-address is configured on the VLAN interface.
text:
type: string
description: Human-readable explanation of the troubleshooting finding
examples:
- Clients of the AP had slow association 8% of the time on Bhavabhi and 5 GHz. ...
description: Troubleshooting finding with reason and remediation guidance
response_tunnel_search:
title: response_tunnel_search
required:
- end
- limit
- results
- start
- total
type: object
properties:
end:
type: integer
description: Epoch timestamp, in seconds, for the end of the tunnel statistics search window
contentEncoding: int32
limit:
type: integer
description: Maximum number of tunnel statistics records returned in this page
contentEncoding: int32
next:
type: string
description: URL for retrieving the next page of tunnel statistics results
results:
type: array
items:
$ref: '#/components/schemas/response_tunnel_search_item'
description: Tunnel statistics records matching the search filters
start:
type: integer
description: Epoch timestamp, in seconds, for the start of the tunnel statistics search window
contentEncoding: int32
total:
type: integer
description: Number of tunnel statistics records matching the search filters across all pages
contentEncoding: int32
description: Paginated response for organization tunnel statistics search results
response_two_factor_json:
title: response_two_factor_json
type: object
properties:
two_factor_secret:
type: string
description: Generated secret key used to enroll a two-factor authentication app
contentEncoding: password
examples:
- NRMTSTRWNBVECY3GJVYEY3DDJFRGSNCZGJUDO4RVN5FDM3DUMJSA
description: Response body containing a generated two-factor authentication secret
response_upgrade_id:
title: response_upgrade_id
required:
- upgrade_id
type: object
properties:
upgrade_id:
type: string
description: Unique value identifying the queued upgrade job
contentEncoding: uuid
examples:
- 4316c116-0acb-4c43-8f06-6723154e741e
description: Response containing an upgrade job identifier
response_upgrade_org_devices:
title: response_upgrade_org_devices
type: object
properties:
enable_p2p:
type: boolean
description: Whether to allow local AP-to-AP FW upgrade
force:
type: boolean
description: Whether to force upgrade when requested version is same as running version
id:
type: string
description: Unique value identifying the organization upgrade job
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
strategy:
allOf:
- $ref: '#/components/schemas/upgrade_device_strategy2'
- description: 'Execution strategy used for the organization upgrade job. enum: `big_bang`, `canary`, `rrm`, `serial`.'
target_version:
type: string
description: Firmware version targeted by the organization AP upgrade
examples:
- 0.14.29411
upgrades:
type: array
items:
$ref: '#/components/schemas/upgrade_org_devices_upgrade'
description: Per-site upgrade jobs created for the organization upgrade
description: Organization AP upgrade job details
response_verify_token_success:
title: response_verify_token_success
type: object
properties:
detail:
type: string
description: Result message returned with the verification response
invite_not_applied:
type: boolean
description: Whether the invitation was verified but not applied automatically
min_length:
type: integer
description: Required minimum password length from the applicable password policy
contentEncoding: int32
return_to:
type: string
description: URL to redirect the user to after successful registration verification
description: Successful registration token verification response
response_virtual_chassis_config:
title: response_virtual_chassis_config
type: object
properties:
config_type:
type: string
description: Provisioning mode of the virtual chassis configuration
readOnly: true
id:
type: string
description: Unique value identifying the virtual chassis device record
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
locating:
type: boolean
description: Whether locate mode is active for the virtual chassis device
readOnly: true
mac:
type: string
description: Device MAC address for the virtual chassis device record
members:
minItems: 1
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/stats_switch_module_stat_item'
description: Virtual chassis member module statistics and topology details
model:
type: string
description: Switch model for the virtual chassis device record
readOnly: true
num_routing_engines:
type: integer
description: Number of routing engines in the virtual chassis
contentEncoding: int32
examples:
- 1
org_id:
type: string
description: Organization identifier for the virtual chassis device
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
serial:
type: string
description: Device serial number reported for the virtual chassis
readOnly: true
site_id:
type: string
description: Identifier of the site containing the virtual chassis
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
status:
type: string
description: Connection status of the virtual chassis device
readOnly: true
type:
type: string
description: Device type for the virtual chassis record
vc_mac:
type: string
description: Virtual Chassis MAC address used to identify the VC device
readOnly: true
description: Combined virtual chassis status, topology, and member statistics
response_wired_coa:
title: response_wired_coa
type: object
properties:
device_mac:
type: string
description: MAC address of the switch or gateway hosting the wired client session
examples:
- 5c5b35000002
port_id:
type: string
description: Interface identifier for the wired client session
examples:
- ge-0/0/0
session:
type: string
description: RADIUS session identifier used for the CoA request
contentEncoding: uuid
examples:
- 0a2a11b8-4b30-40d8-a6d1-e91ea540d86f
description: Response returned after triggering wired client CoA reauthentication
response_zone_search:
title: response_zone_search
type: object
properties:
end:
type: number
description: Epoch timestamp, in seconds, for the end of the zone visit search window
examples:
- 1541705289.769911
limit:
type: integer
description: Maximum number of zone visit records returned in this page
contentEncoding: int32
examples:
- 1
next:
type: string
description: URL for retrieving the next page of zone visit search results
examples:
- /api/v1/sites/67970e46-4e12-11e6-9188-0242ac110007/zones/visits/search?limit=2&end=1541705247.000&scope_id=85fbba9e-4e12-11e6-9188-0242ac110007&user_type=asset&start=1541618889.77
results:
type: array
items:
$ref: '#/components/schemas/response_zone_search_item'
description: Zone visit records matching the search filters
start:
type: number
description: Epoch timestamp, in seconds, for the start of the zone visit search window
examples:
- 1541618889.769886
total:
type: integer
description: Number of zone visit records matching the search filters across all pages
contentEncoding: int32
examples:
- 5892
description: Paginated response for site zone visit search results
response_zone_search_item:
title: response_zone_search_item
type: object
properties:
enter:
type: integer
description: Epoch timestamp, in seconds, when the zone visit started
contentEncoding: int32
examples:
- 1541705254
scope:
type: string
description: Zone scope represented by this visit record
examples:
- map
timestamp:
type: number
description: Time when the zone visit event was recorded
readOnly: true
user:
type: string
description: Client, asset, or SDK client identifier for the visit
examples:
- c4b301c81166
description: Zone visit record for a client, asset, or SDK client
rf_client_type:
title: rf_client_type
enum:
- asset
- client
- sdkclient
type: string
description: 'enum: `asset`, `client`, `sdkclient`'
rf_diag:
title: rf_diag
required:
- name
- type
type: object
properties:
duration:
maximum: 180
type: integer
description: Recording length, in seconds; maximum and default are 180
contentEncoding: int32
default: 180
mac:
type: string
description: If `type`==`client` or `asset`, MAC address of the device being recorded
name:
type: string
description: Recording name; the SDK client name is a good default for SDK-client recordings
sdkclient_id:
type: string
description: If `type`==`sdkclient`, SDK client identifier for this recording
contentEncoding: uuid
type:
allOf:
- $ref: '#/components/schemas/rf_client_type1'
- description: 'Target device category for the RF diagnostic recording. enum: `asset`, `client`, `sdkclient`.'
description: RF diagnostic recording request
rf_diag_info_item:
title: rf_diag_info_item
required:
- duration
- end_time
- frame_count
- map_id
- name
- raw_events
- ready
- start_time
- type
- url
type: object
properties:
asset_id:
type: string
description: If `type`==`asset`, id of the asset
contentEncoding: uuid
asset_name:
type: string
description: If `type`==`asset`, name of the asset
client_name:
type: string
description: If `type`==`client`, hostname of the client
duration:
type: integer
description: recording length in seconds, max is 120
contentEncoding: int32
end_time:
type: integer
description: Timestamp of end of recording
contentEncoding: int32
frame_count:
type: integer
description: Number of frames in the output
contentEncoding: int32
id:
type: string
description: Unique value identifying the RF diagnostic recording
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
mac:
type: string
description: If `type`==`client` or `asset`, MAC address of the recorded device
map_id:
type: string
description: Map identifier associated with the recording
contentEncoding: uuid
name:
type: string
description: Recording name returned for the RF diagnostic recording
next:
type: string
description: Optional. id of the next recoding if present. Only valid for site survey.
raw_events:
type: string
description: URL to a JSON file that contains array of raw location diag events
ready:
type: boolean
description: Whether it’s ready for playback
sdkclient_id:
type: string
description: If `type`==`sdkclient`, sdkclient_id of this recording
contentEncoding: uuid
sdkclient_name:
type: string
description: If `type`==`sdkclient`, name of the sdkclient
sdkclient_uuid:
type: string
description: If `type`==`sdkclient`, device_id of sdkclient
contentEncoding: uuid
start_time:
type: integer
description: Timestamp of the recording (the start)
contentEncoding: int32
type:
allOf:
- $ref: '#/components/schemas/rf_client_type2'
- description: 'Target device category for the recording. enum: `asset`, `client`, `sdkclient`.'
url:
type: string
description: JSON file URL for frame data captured by the recording
description: RF diagnostic recording metadata and output links
rf_template:
title: rf_template
required:
- name
type: object
properties:
ant_gain_24:
type: integer
description: External antenna gain for the 2.4 GHz radio
contentEncoding: int32
ant_gain_5:
type: integer
description: External antenna gain for the 5 GHz radio
contentEncoding: int32
ant_gain_6:
type: integer
description: External antenna gain for the 6 GHz radio
contentEncoding: int32
band_24:
allOf:
- $ref: '#/components/schemas/rftemplate_radio_band243'
- description: 2.4 GHz radio settings in this RF template
band_24_usage:
allOf:
- $ref: '#/components/schemas/radio_band_24_usage2'
- description: 'Radio usage mode for the 2.4 GHz-capable radio in this RF template. enum: `24`, `5`, `6`, `auto`.'
band_5:
allOf:
- $ref: '#/components/schemas/rftemplate_radio_band55'
- description: 5 GHz radio settings in this RF template
band_5_on_24_radio:
allOf:
- $ref: '#/components/schemas/rftemplate_radio_band51'
- description: 5 GHz settings used when the 2.4 GHz radio operates in 5 GHz mode
band_6:
allOf:
- $ref: '#/components/schemas/rftemplate_radio_band63'
- description: 6 GHz radio settings in this RF template
country_code:
type: string
description: Optional, country code to use. If specified, this gets applied to all sites using the RF Template
created_time:
type: number
description: Timestamp when the RF template was created
readOnly: true
enable_unii_4:
type: boolean
description: Whether U-NII-4 channels (169, 173, 177) are enabled
default: false
for_site:
type: boolean
description: Whether the RF template is scoped to a site rather than the organization
readOnly: true
id:
type: string
description: Unique identifier of the RF template
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
model_specific:
type: object
additionalProperties:
$ref: '#/components/schemas/rf_template_model_specific_property'
description: overwrites for a specific model. If a band is specified, it will shadow the default. Property key is the model name (e.g. "AP63")
modified_time:
type: number
description: Timestamp when the RF template was last modified
readOnly: true
name:
type: string
description: The name of the RF template
org_id:
type: string
description: Organization that owns this RF template
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
scanning_enabled:
type: boolean
description: Whether scanning radio is enabled
description: RF template used by the current RRM calculation
rf_template_model_specific_property:
title: rf_template_model_specific_property
type: object
properties:
ant_gain_24:
type: integer
description: Model-specific external antenna gain for the 2.4 GHz radio
contentEncoding: int32
default: 0
ant_gain_5:
type: integer
description: Model-specific external antenna gain for the 5 GHz radio
contentEncoding: int32
default: 0
ant_gain_6:
type: integer
description: Model-specific external antenna gain for the 6 GHz radio
contentEncoding: int32
default: 0
band_24:
allOf:
- $ref: '#/components/schemas/rftemplate_radio_band241'
- description: Model-specific 2.4 GHz radio settings that override RF template defaults
band_24_usage:
allOf:
- $ref: '#/components/schemas/radio_band_24_usage3'
- description: 'Model-specific radio usage mode for the 2.4 GHz-capable radio. enum: `24`, `5`, `6`, `auto`.'
band_5:
allOf:
- $ref: '#/components/schemas/rftemplate_radio_band52'
- description: Model-specific 5 GHz radio settings that override RF template defaults
band_5_on_24_radio:
allOf:
- $ref: '#/components/schemas/rftemplate_radio_band53'
- description: Model-specific 5 GHz settings used when the 2.4 GHz radio operates in 5 GHz mode
band_6:
allOf:
- $ref: '#/components/schemas/rftemplate_radio_band61'
- description: Model-specific 6 GHz radio settings that override RF template defaults
description: AP model-specific RF overrides for an RF template
rftemplate_radio_band24:
title: rftemplate_radio_band24
type: object
properties:
allow_rrm_disable:
type: boolean
description: Whether RRM may disable the 2.4 GHz radio when optimizing RF settings
default: false
ant_gain:
maximum: 10
minimum: 0
type:
- integer
- 'null'
description: External antenna gain for the 2.4 GHz radio
contentEncoding: int32
default: 0
antenna_mode:
allOf:
- $ref: '#/components/schemas/radio_band_antenna_mode4'
- description: 'Radio chain mode for the 2.4 GHz radio. enum: `1x1`, `2x2`, `3x3`, `4x4`, `default`.'
examples:
- default
bandwidth:
allOf:
- $ref: '#/components/schemas/dot11_bandwidth242'
- description: 'Channel width configured for the 2.4 GHz radio. enum: `0`, `20`, `40`.'
examples:
- 20
channels:
type:
- array
- 'null'
items:
type: integer
contentEncoding: int32
description: Allowed channel list for the 2.4 GHz radio; null or an empty array uses automatic selection
default: []
disabled:
type: boolean
description: Whether to disable the radio
default: false
power:
maximum: 25
minimum: 0
type:
- integer
- 'null'
description: Radio Tx power, in dBm. Can be an integer 0-25 for static power configuration, or `null` or unset for auto power mode
contentEncoding: int32
examples:
- 3
power_max:
maximum: 18
minimum: 3
type:
- integer
- 'null'
description: When power=null/unset, max tx power to use, HW-specific values will be used if not set
contentEncoding: int32
power_min:
maximum: 18
minimum: 3
type:
- integer
- 'null'
description: When power=null/unset, min tx power to use, HW-specific values will be used if not set
contentEncoding: int32
preamble:
allOf:
- $ref: '#/components/schemas/radio_band_preamble4'
- description: '802.11 preamble mode used by the 2.4 GHz radio. enum: `auto`, `long`, `short`.'
description: Radio Band AP settings
rftemplate_radio_band5:
title: rftemplate_radio_band5
type: object
properties:
allow_rrm_disable:
type: boolean
description: Whether RRM may disable the 5 GHz radio when optimizing RF settings
default: false
ant_gain:
maximum: 10
minimum: 0
type:
- integer
- 'null'
description: External antenna gain for the 5 GHz radio
contentEncoding: int32
default: 0
antenna_mode:
allOf:
- $ref: '#/components/schemas/radio_band_antenna_mode1'
- description: 'Radio chain mode for the 5 GHz radio. enum: `1x1`, `2x2`, `3x3`, `4x4`, `default`.'
examples:
- default
bandwidth:
allOf:
- $ref: '#/components/schemas/dot11_bandwidth52'
- description: 'Channel width configured for the 5 GHz radio. enum: `0`, `20`, `40`, `80`.'
examples:
- 40
channels:
type:
- array
- 'null'
items:
type: integer
contentEncoding: int32
description: Allowed channel list for the 5 GHz radio; null or an empty array uses automatic selection
default: []
disabled:
type: boolean
description: Whether to disable the radio
default: false
power:
maximum: 25
minimum: 0
type:
- integer
- 'null'
description: Radio Tx power, in dBm. Can be an integer 0-25 for static power configuration, or `null` or unset for auto power mode
contentEncoding: int32
examples:
- 6
power_max:
maximum: 17
minimum: 5
type:
- integer
- 'null'
description: When power=null/unset, max tx power to use, HW-specific values will be used if not set
contentEncoding: int32
power_min:
maximum: 17
minimum: 5
type:
- integer
- 'null'
description: When power=null/unset, min tx power to use, HW-specific values will be used if not set
contentEncoding: int32
preamble:
allOf:
- $ref: '#/components/schemas/radio_band_preamble1'
- description: '802.11 preamble mode used by the 5 GHz radio. enum: `auto`, `long`, `short`.'
description: Radio Band AP settings
rftemplate_radio_band6:
title: rftemplate_radio_band6
type: object
properties:
allow_rrm_disable:
type: boolean
description: Whether RRM may disable the 6 GHz radio when optimizing RF settings
default: false
ant_gain:
maximum: 10
minimum: 0
type:
- integer
- 'null'
description: External antenna gain for the 6 GHz radio
contentEncoding: int32
default: 0
antenna_mode:
allOf:
- $ref: '#/components/schemas/radio_band_antenna_mode2'
- description: 'Radio chain mode for the 6 GHz radio. enum: `1x1`, `2x2`, `3x3`, `4x4`, `default`.'
examples:
- default
bandwidth:
allOf:
- $ref: '#/components/schemas/dot11_bandwidth62'
- description: 'Channel width configured for the 6 GHz radio. enum: `0`, `20`, `40`, `80`, `160`.'
examples:
- 80
channels:
type:
- array
- 'null'
items:
type: integer
contentEncoding: int32
description: Allowed channel list for the 6 GHz radio; null or an empty array uses automatic selection
default: []
disabled:
type: boolean
description: Whether to disable the radio
default: false
power:
maximum: 25
minimum: 0
type:
- integer
- 'null'
description: Radio Tx power, in dBm. Can be an integer 0-25 for static power configuration, or `null` or unset for auto power mode
contentEncoding: int32
examples:
- 7
power_max:
maximum: 17
minimum: 5
type:
- integer
- 'null'
description: When power=null/unset, max tx power to use, HW-specific values will be used if not set
contentEncoding: int32
power_min:
maximum: 18
minimum: 5
type:
- integer
- 'null'
description: When power=null/unset, min tx power to use, HW-specific values will be used if not set
contentEncoding: int32
preamble:
allOf:
- $ref: '#/components/schemas/radio_band_preamble2'
- description: '802.11 preamble mode used by the 6 GHz radio. enum: `auto`, `long`, `short`.'
standard_power:
type: boolean
description: For 6GHz Only, standard-power operation, AFC (Automatic Frequency Coordination) will be performed, and we'll fall back to Low Power Indoor if AFC failed
default: false
description: Radio Band AP settings
rogue_details:
title: rogue_details
required:
- manufacture
- seen_as_client
type: object
properties:
manufacture:
type: string
description: Vendor or manufacturer name reported for the rogue AP
seen_as_client:
type: boolean
description: Whether this rogue AP was also observed as a client
description: Rogue AP detail response
rogue_type:
title: rogue_type
enum:
- honeypot
- lan
- others
- spoof
type: string
description: 'enum: `honeypot`, `lan`, `others`, `spoof`'
root_password_string:
title: root_password_string
required:
- root_password
type: object
properties:
root_password:
minLength: 1
type: string
description: Temporary root password returned for ZTP recovery
contentEncoding: password
description: Temporary root password response for device ZTP recovery
route_summary_stats:
title: route_summary_stats
type: object
properties:
fib_routes:
type: integer
description: Number of routes installed in the forwarding information base
contentEncoding: int32
max_unicast_routes_supported:
type: integer
description: Supported maximum number of unicast routes
contentEncoding: int32
rib_routes:
type: integer
description: Number of routes present in the routing information base
contentEncoding: int32
total_routes:
type: integer
description: Aggregate number of routes reported by the device
contentEncoding: int32
description: Route table capacity and usage summary
rrm:
title: rrm
required:
- band_24
- band_24_metric
- band_5
- band_5_metric
- rftemplate
- rftemplate_id
- rftemplate_name
- status
- timestamp
type: object
properties:
band_24:
type: object
additionalProperties:
$ref: '#/components/schemas/rrm_band'
description: RRM proposed channel, power, and usage settings for 2.4 GHz radios; property key is AP ID
band_24_metric:
allOf:
- $ref: '#/components/schemas/rrm_band_metric4'
- description: Aggregate RRM metrics for the 2.4 GHz band
band_5:
type: object
additionalProperties:
$ref: '#/components/schemas/rrm_band'
description: RRM proposed channel, power, and usage settings for 5 GHz radios; property key is AP ID
band_5_metric:
allOf:
- $ref: '#/components/schemas/rrm_band_metric1'
- description: Aggregate RRM metrics for the 5 GHz band
band_6:
type: object
additionalProperties:
$ref: '#/components/schemas/rrm_band'
description: RRM proposed channel, power, and usage settings for 6 GHz radios; property key is AP ID
band_6_metric:
allOf:
- $ref: '#/components/schemas/rrm_band_metric2'
- description: Aggregate RRM metrics for the 6 GHz band
rftemplate:
allOf:
- $ref: '#/components/schemas/rf_template'
- description: RF template used by the current RRM calculation
rftemplate_id:
type: string
description: RF template identifier used by the current RRM calculation
contentEncoding: uuid
rftemplate_name:
type: string
description: RF template name used by the current RRM calculation
status:
allOf:
- $ref: '#/components/schemas/rrm_status2'
- description: 'Current RRM calculation status. enum: `ready`, `unknown`, `updating`.'
timestamp:
type: number
description: Time when the current RRM data was generated
readOnly: true
description: Current RRM channel-planning state for a site
rrm_band:
title: rrm_band
type: object
properties:
bandwidth:
allOf:
- $ref: '#/components/schemas/dot11_bandwidth4'
- description: 'Proposed channel width for the radio band, in MHz. enum: `0`, `20`, `40`, `80`, `160`.'
examples:
- 20
channel:
type: integer
description: Proposed RF channel for the radio band
contentEncoding: int32
curr_bandwidth:
allOf:
- $ref: '#/components/schemas/dot11_bandwidth7'
- description: 'Current channel width for the radio band, in MHz. enum: `0`, `20`, `40`, `80`, `160`.'
examples:
- 20
curr_channel:
type: integer
description: Current RF channel for the radio band
contentEncoding: int32
curr_power:
type: integer
description: Current transmit power for the radio band
contentEncoding: int32
curr_usage:
minLength: 1
type: string
description: Current radio usage band for the AP radio
power:
type: integer
description: Proposed transmit power for the radio band
contentEncoding: int32
usage:
minLength: 1
type: string
description: Proposed radio usage band for the AP radio
description: RRM proposed and current radio settings for an AP band
rrm_band_metric:
title: rrm_band_metric
required:
- cochannel_neighbors
- density
- neighbors
- noise
type: object
properties:
avg_aps_per_channel:
type: number
description: Average number of APs per channel
channel_distribution_uniformity:
type: number
description: Distribution of channel across the Access Points
cochannel_neighbors:
type: number
description: Average number of co-channel neighbors
density:
maximum: 1
minimum: 0
type: number
description: defined by how APs can hear from one and another, 0 - 1 (everyone can hear everyone)
interferences:
type: object
additionalProperties:
$ref: '#/components/schemas/rrm_band_metric_interference'
description: Property key is the channel number
examples:
- '149':
radar: 0.3
'153':
radar: 0.2
naps_by_channel:
type: object
additionalProperties:
type: number
description: Number of APs grouped by channel for this band
naps_by_power:
type: object
additionalProperties:
type: number
description: Number of APs grouped by transmit power for this band
neighbors:
type: number
description: Average number of neighbors
noise:
type: number
description: Average noise in dBm
description: Aggregate RRM metrics for a radio band
rrm_band_metric_interference:
title: rrm_band_metric_interference
type: object
properties:
radar:
type: number
description: Interference value attributed to radar on the channel
description: Interference metrics observed for one channel
rrm_event_pre_bandwidth:
title: rrm_event_pre_bandwidth
enum:
- 0
- 20
- 40
- 80
- 160
type: integer
description: '(previously) channel width for the band , 0 means no previously available. enum: `0`, `20`, `40`, `80`, `160`'
rrm_event_type:
title: rrm_event_type
enum:
- interference-ap-co-channel
- interference-ap-non-wifi
- neighbor-ap-down
- neighbor-ap-recovered
- radar-detected
- rrm-radar
- scheduled-site_rrm
- triggered-site_rrm
type: string
description: 'enum: `interference-ap-co-channel`, `interference-ap-non-wifi`, `neighbor-ap-down`, `neighbor-ap-recovered`, `radar-detected`, `rrm-radar`, `scheduled-site_rrm`, `triggered-site_rrm`'
rrm_neighbors_neighbor:
title: rrm_neighbors_neighbor
type: object
properties:
mac:
type: string
description: Neighbor AP MAC address observed by RRM
examples:
- 5c5b35000311
rssi:
type: integer
description: Observed RSSI for the neighbor AP, in dBm
contentEncoding: int32
examples:
- -66
description: Neighbor AP observed by RRM
rrm_status:
title: rrm_status
enum:
- ready
- unknown
- updating
type: string
description: 'enum: `ready`, `unknown`, `updating`'
rssi_zone:
title: rssi_zone
required:
- devices
type: object
properties:
created_time:
type: number
description: Timestamp when the RSSI zone was created
readOnly: true
devices:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/rssi_zone_device'
description: AP devices and RSSI thresholds that define the zone
for_site:
type: boolean
description: Whether the RSSI zone is scoped to a site
readOnly: true
id:
type: string
description: Unique value identifying the RSSI zone
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
modified_time:
type: number
description: Timestamp when the RSSI zone was last modified
readOnly: true
name:
type: string
description: Display name of the RSSI zone
examples:
- zone name
org_id:
type: string
description: Organization identifier for the RSSI zone
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
site_id:
type: string
description: Identifier of the site containing the RSSI zone
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
description: RSSI-based zone configuration for a site
rssi_zone_device:
title: rssi_zone_device
required:
- device_id
- rssi
type: object
properties:
device_id:
type: string
description: Identifier of the AP device used by this RSSI zone
contentEncoding: uuid
readOnly: true
examples:
- 00000000-0000-0000-1000-d8695a0f9e61
rssi:
type: integer
description: Minimum RSSI threshold for considering the device inside the zone
contentEncoding: int32
examples:
- 0
description: AP device and RSSI threshold used by an RSSI zone
saml_metadata:
title: saml_metadata
type: object
properties:
acs_url:
type: string
description: If `idp_type`==`saml`, Assertion Consumer Service URL that receives SAML responses for this Mist SSO configuration
readOnly: true
examples:
- https://api.mist.com/api/v1/saml/llDfa13f/login
entity_id:
type: string
description: If `idp_type`==`saml`, service provider entity ID for this Mist SSO configuration
readOnly: true
examples:
- https://api.mist.com/api/v1/saml/llDfa13f/login
logout_url:
type: string
description: If `idp_type`==`saml`, Single Logout URL used by the identity provider to end the Mist SSO session
readOnly: true
examples:
- https://api.mist.com/api/v1/saml/llDfa13f/logout
metadata:
type: string
description: If `idp_type`==`saml`, service provider metadata XML for configuring the identity provider
readOnly: true
examples:
- urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified
scim_base_url:
type: string
description: If `idp_type`==`oauth` and `scim_enabled`==`true`, SCIM base URL that the identity provider uses to send provisioning requests to Mist
examples:
- https://scim.nac-staging.mistsys.com/S_41b2525a-e8b8-4809-8168-f1d8dcbe9735/azure/4d72b1dc-7503-4717-81ea-80d0125b886e
description: Read-only SAML and SCIM metadata generated for an SSO configuration
scan_data_item_band:
title: scan_data_item_band
enum:
- '2.4'
- '5'
type: string
description: '5GHz or 2.4GHz band, associated with the BSSID scanned. enum: `2.4`, `5`'
sdk_invite_sms:
title: sdk_invite_sms
required:
- number
type: object
properties:
number:
type: string
description: Destination phone number for the SDK invite SMS
description: Request body for sending an SDK invite by SMS
sdkinvite:
title: sdkinvite
required:
- name
type: object
properties:
created_time:
type: number
description: Timestamp when the SDK invite was created, in epoch seconds
readOnly: true
enabled:
type: boolean
description: Whether the SDK invite can currently be used
default: true
expire_time:
type: integer
description: Expiration time for the SDK invite, in epoch seconds
contentEncoding: int32
id:
type: string
description: Unique value identifying the SDK invite
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
modified_time:
type: number
description: Timestamp when the SDK invite was last modified, in epoch seconds
readOnly: true
name:
type: string
description: Display name shown for the SDK invite in the mobile experience
org_id:
type: string
description: Organization identifier associated with the SDK invite
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
quota:
type: integer
description: Number of times this SDK invite can be used
contentEncoding: int32
quota_limited:
type: boolean
description: Whether use of the SDK invite is limited by the quota value
default: false
site_id:
type: string
description: Site identifier associated with the SDK invite, when scoped to a site
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
description: SDK invite configuration used to onboard mobile SDK clients to an organization
sdkstats_wireless_client:
title: sdkstats_wireless_client
required:
- id
- uuid
type: object
properties:
id:
type: string
description: Unique value identifying the SDK client
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
last_seen:
type:
- number
- 'null'
description: Time when the SDK client was last observed, in epoch seconds
readOnly: true
examples:
- 1470417522
map_id:
type:
- string
- 'null'
description: Map identifier for the SDK client's location, if known
contentEncoding: uuid
name:
type: string
description: Display name provided for the SDK client
network_connection:
allOf:
- $ref: '#/components/schemas/stats_sdkclient_network_connection1'
- description: Current network connection details for the SDK client
uuid:
type: string
description: Application UUID for the SDK client
contentEncoding: uuid
vbeacons:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/sdkstats_wireless_client_vbeacon'
description: Virtual beacons currently associated with the SDK client and when each association began
x:
type: number
description: Horizontal map coordinate of the SDK client location, in pixels, if known
y:
type: number
description: Vertical map coordinate of the SDK client location, in pixels, if known
zones:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/sdkstats_wireless_client_zone'
description: Current zone memberships for the SDK client and when the client entered each zone
description: Detailed statistics for an individual SDK client
sdkstats_wireless_client_vbeacon:
title: sdkstats_wireless_client_vbeacon
required:
- id
- since
type: object
properties:
id:
type: string
description: Virtual beacon identifier currently associated with the SDK client
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
since:
type: number
description: Time when the SDK client began matching the virtual beacon, in epoch seconds
description: Virtual beacon currently associated with an SDK client
sdkstats_wireless_client_zone:
title: sdkstats_wireless_client_zone
required:
- id
- since
type: object
properties:
id:
type: string
description: Zone identifier that currently contains the SDK client
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
since:
type: number
description: Time when the SDK client entered the zone, in epoch seconds
description: Zone currently containing an SDK client
sdktemplate:
title: sdktemplate
required:
- name
type: object
properties:
bg_image:
type: string
description: Background image URL displayed by the SDK template
btn_flr_bgcolor:
type: string
description: Floor button background color used by the SDK template, as a hex color
created_time:
type: number
description: Timestamp when the SDK template was created, in epoch seconds
readOnly: true
default:
type: boolean
description: Whether this template is the default among available SDK templates
for_site:
type: boolean
description: Whether the SDK template is scoped to a site
readOnly: true
header_txt:
type: string
description: Header text displayed by the SDK template
id:
type: string
description: Unique value identifying the SDK template
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
modified_time:
type: number
description: Timestamp when the SDK template was last modified, in epoch seconds
readOnly: true
name:
type: string
description: Display name used to identify the SDK template
org_id:
type: string
description: Organization identifier associated with the SDK template
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
search_txtcolor:
type: string
description: Text color used for search controls in the SDK template, as a hex color
site_id:
type: string
description: Site identifier associated with the SDK template, when scoped to a site
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
welcome_msg:
type: string
description: Welcome message displayed by the SDK template
description: Visual customization template for the mobile SDK experience
search_events_wan_client:
title: search_events_wan_client
type: object
properties:
end:
type: integer
description: Upper bound timestamp of the WAN client event search window, in epoch seconds
contentEncoding: int32
limit:
type: integer
description: Maximum number of WAN client event results returned by this page
contentEncoding: int32
next:
type: string
description: URL for the next page of WAN client event results, when more results are available
results:
type: array
items:
$ref: '#/components/schemas/events_client_wan'
description: List of WAN client event result data returned by the search response
start:
type: integer
description: Lower bound timestamp of the WAN client event search window, in epoch seconds
contentEncoding: int32
total:
type: integer
description: Count of WAN client event results matching the search
contentEncoding: int32
description: Paginated response for WAN client event searches
search_org_devices_mxtunnel_status:
title: search_org_devices_mxtunnel_status
enum:
- down
- up
type: string
description: 'Mist Tunnel status filter for organization device search. enum: `down`, `up`'
search_org_sw_or_gw_ports_type:
title: search_org_sw_or_gw_ports_type
enum:
- switch
- gateway
- all
type: string
description: 'enum: `switch`, `gateway`, `all`'
search_site_devices_desc_sort:
title: search_site_devices_desc_sort
enum:
- mac
- model
- sku
- timestamp
type: string
description: 'enum: `mac`, `model`, `sku`, `timestamp`'
search_site_devices_mxtunnel_status:
title: search_site_devices_mxtunnel_status
enum:
- down
- up
type: string
description: 'Mist Tunnel status filter for site device search. enum: `down`, `up`'
search_site_devices_sort:
title: search_site_devices_sort
enum:
- mac
- model
- sku
- timestamp
type: string
description: 'enum: `mac`, `model`, `sku`, `timestamp`'
search_wan_client:
title: search_wan_client
type: object
properties:
end:
type: integer
description: Upper bound timestamp of the WAN client search window, in epoch seconds
contentEncoding: int32
limit:
type: integer
description: Maximum number of WAN client records returned by this page
contentEncoding: int32
next:
type: string
description: URL for the next page of WAN client records, when more results are available
results:
type: array
items:
$ref: '#/components/schemas/stats_wan_client'
description: WAN client records returned by the search response
start:
type: integer
description: Lower bound timestamp of the WAN client search window, in epoch seconds
contentEncoding: int32
total:
type: integer
description: Count of WAN client records matching the search
contentEncoding: int32
description: Paginated response for WAN client searches
search_wan_usage:
title: search_wan_usage
type: object
properties:
end:
type: number
description: Upper bound timestamp of the WAN usage search window, in epoch seconds
limit:
type: integer
description: Maximum number of WAN usage records returned by this page
contentEncoding: int32
results:
type: array
items:
$ref: '#/components/schemas/wan_usages'
description: WAN usage records returned by the search response
start:
type: number
description: Lower bound timestamp of the WAN usage search window, in epoch seconds
description: Paginated response for WAN usage searches
wan_usages:
title: wan_usages
type: object
properties:
mac:
type: string
description: Local router MAC address for the WAN usage record
examples:
- 5c5b35000001
path_type:
type: string
description: WAN path type used by this usage record
examples:
- vpn
path_weight:
type: integer
description: Configured weight for the WAN path
contentEncoding: int32
examples:
- 10
peer_mac:
type: string
description: Remote peer MAC address for the WAN path
examples:
- 0200018c95e1
peer_port_id:
type: string
description: Remote peer interface identifier for the WAN path
examples:
- ge-0/0/3
policy:
type: string
description: WAN path policy that selected this path
examples:
- policy1
port_id:
type: string
description: Local router interface identifier for the WAN path
examples:
- ge-0/0/0.0
tenant:
type: string
description: Network tenant context for the WAN usage record
examples:
- tenant1
description: WAN usage record returned by site WAN usage searches
search_webhook_delivery:
title: search_webhook_delivery
type: object
properties:
end:
type: integer
description: Upper bound timestamp of the webhook delivery search window, in epoch seconds
contentEncoding: int32
examples:
- 1688035193
limit:
type: integer
description: Maximum number of webhook delivery records returned by this page
contentEncoding: int32
examples:
- 10
next:
type: string
description: URL for the next page of webhook delivery records, when more results are available
results:
type: array
items:
$ref: '#/components/schemas/webhook_delivery'
description: Webhook delivery records returned by the search response
start:
type: integer
description: Lower bound timestamp of the webhook delivery search window, in epoch seconds
contentEncoding: int32
examples:
- 1687948793
total:
type: integer
description: Count of webhook delivery records matching the search
contentEncoding: int32
description: Paginated response for webhook delivery searches
webhook_delivery:
title: webhook_delivery
type: object
properties:
error:
type: string
description: Message returned for a failed delivery attempt, when available
id:
type: string
description: Unique identifier of the webhook delivery attempt
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
org_id:
type: string
description: Organization associated with the webhook delivery attempt
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
req_headers:
type: string
description: HTTP headers sent with the webhook delivery request
examples:
- '{\"Content-Type\":[\"application/json\"],\"User-Agent\":[\"Mist-webhook\"]}'
req_payload:
type: string
description: JSON payload sent in the webhook delivery request
examples:
- '{\"topic\":\"audits\",\"events\":[{\"admin_name\":\"John Doe john.doe@juniper.net\",\"after\":\"{\\"radio_config\\": {\\"band_24\\": {\\"disabled\\": false, \\"allow_rrm_disable\\": false, \\"power_min\\": null, \\"power_max\\": null, \\"power\\": 10, \\"preamble\\": \\"short\\", \\"channels\\": [1, 10], \\"bandwidth\\": 20}}}\",\"before\":\"{\\"radio_config\\": {\\"band_24\\": {\\"disabled\\": false, \\"allow_rrm_disable\\": false, \\"power_min\\": 8, \\"power_max\\": 18, \\"power\\": null, \\"preamble\\": \\"long\\", \\"channels\\": [1, 10], \\"bandwidth\\": 20}}}\",\"id\":\"737909a2-04ff-4aeb-b9da-cc924e74a4dd\",\"message\":\"Update Site Settings\",\"org_id\":\"fc7e2967-e7ef-41e6-b007-1217713de05a\",\"site_id\":\"256c3a35-9cb7-436e-bc6d-314972645d95\",\"site_name\":\"Test Site\",\"src_ip\":\"1.2.3.4\",\"timestamp\":1685956576.923601,\"user_agent\":\"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/112.0.0.0 Safari/537.36\"}]}'
req_url:
type: string
description: Destination URL used for the webhook delivery request
examples:
- https://example.com
resp_body:
type: string
description: Response body returned by the webhook destination
examples:
- Ok
resp_headers:
type: string
description: Response headers returned by the webhook destination
site_id:
type: string
description: Site associated with the webhook delivery attempt, when applicable
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
status:
allOf:
- $ref: '#/components/schemas/webhook_delivery_status2'
- description: 'Delivery result for the webhook request. enum: `failure`, `success`.'
examples:
- failure
status_code:
type: integer
description: HTTP status code returned by the webhook destination
contentEncoding: int32
examples:
- 200
timestamp:
type: number
description: Time when the webhook delivery attempt occurred, in epoch seconds
readOnly: true
topic:
allOf:
- $ref: '#/components/schemas/webhook_delivery_topic2'
- description: 'Webhook topic delivered in this request. enum: `alarms`, `audits`, `device-updowns`, `occupancy-alerts`, `ping`.'
examples:
- audits
webhook_id:
type: string
description: Unique identifier of the configured webhook used for this delivery attempt
contentEncoding: uuid
examples:
- 7a11b901-f719-4c91-8aef-deb8699a6364
description: Record of a webhook delivery attempt and the destination response
search_wired_client:
title: search_wired_client
required:
- end
- limit
- results
- start
- total
type: object
properties:
end:
type: number
description: Upper bound timestamp of the wired client search window, in epoch seconds
limit:
type: integer
description: Maximum number of wired client records returned by this page
contentEncoding: int32
next:
type: string
description: URL for the next page of wired client records, when more results are available
results:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/wired_client_response'
description: Wired client records returned by the search response
start:
type: number
description: Lower bound timestamp of the wired client search window, in epoch seconds
total:
type: integer
description: Count of wired client records matching the search
contentEncoding: int32
description: Paginated response for wired client searches
wired_client_response:
title: wired_client_response
type: object
properties:
auth_method:
type: string
description: Method used to authenticate the wired client
examples:
- mac_auth
auth_state:
type: string
description: State reported for wired client authentication
examples:
- authenticated
device_mac:
type: array
items:
type: string
description: MAC addresses of switches or gateways where the wired client was observed
readOnly: true
device_mac_port:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/wired_client_response_device_mac_port_item'
description: Per-port switch or gateway observations for the wired client
readOnly: true
dhcp_client_identifier:
type: string
description: Identifier value reported by the wired client in DHCP
examples:
- MAC address 00155df6d500
dhcp_client_options:
type: array
items:
$ref: '#/components/schemas/dhcp_client_option'
description: DHCP options observed from the wired client
dhcp_fqdn:
type: string
description: Fully qualified domain name reported by the wired client through DHCP
examples:
- ITS-VMMT0-D1N02.mgthub.local
dhcp_hostname:
type: string
description: Hostname reported by the wired client through DHCP
examples:
- ITS-VMMT0-D1N02
dhcp_request_params:
type: string
description: Parameter request list advertised by the wired client in DHCP
examples:
- 1 3 6 15 31 33 43 44 46 47 119 121 249 252
dhcp_vendor_class_identifier:
type: string
description: Vendor class identifier reported by the wired client in DHCP
examples:
- MSFT 5.0
ip:
type: array
items:
type: string
description: Client IP addresses observed for the wired client
readOnly: true
mac:
type: string
description: Client MAC address for the wired client record
readOnly: true
org_id:
type: string
description: Owning organization associated with the wired client record
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
port_id:
type: array
items:
type: string
description: Switch or gateway port identifiers where the wired client was observed
readOnly: true
site_id:
type: string
description: Mist site associated with the wired client record
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
timestamp:
type: number
description: Time when the wired client record was observed, in epoch seconds
readOnly: true
vlan:
type: array
items:
type: integer
contentEncoding: int32
description: Client VLAN identifiers observed for the wired client
readOnly: true
description: Wired client record returned by a wired client search
search_wireless_client_session:
title: search_wireless_client_session
required:
- end
- limit
- results
- start
- total
type: object
properties:
end:
type: number
description: Upper bound timestamp of the wireless client session search window, in epoch seconds
limit:
type: integer
description: Maximum number of wireless client session records returned by this page
contentEncoding: int32
next:
type: string
description: URL for the next page of wireless client session records, when more results are available
results:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/wireless_client_session'
description: Wireless client session records returned by the search response
start:
type: number
description: Lower bound timestamp of the wireless client session search window, in epoch seconds
total:
type: integer
description: Count of wireless client session records matching the search
contentEncoding: int32
description: Paginated response for wireless client session searches
wireless_client_session:
title: wireless_client_session
required:
- ap
- band
- connect
- disconnect
- duration
- mac
- org_id
- site_id
- ssid
- timestamp
- wlan_id
type: object
properties:
ap:
type: string
description: MAC address of the access point associated with the client session
readOnly: true
band:
type: string
description: Radio band used by the client session
readOnly: true
client_manufacture:
type:
- string
- 'null'
description: Manufacturer reported for the client device, when available
readOnly: true
connect:
type: integer
description: Time when the client session connected, in epoch seconds
contentEncoding: int32
readOnly: true
disconnect:
type: integer
description: Time when the client session disconnected, in epoch seconds
contentEncoding: int32
readOnly: true
duration:
type: number
description: Length of the client session, in seconds
readOnly: true
for_site:
type: boolean
description: Whether this client session record is scoped to a site
readOnly: true
mac:
type: string
description: Client MAC address for the session
readOnly: true
org_id:
type: string
description: Organization associated with the client session
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
site_id:
type: string
description: Site associated with the client session
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
ssid:
type: string
description: WLAN SSID used by the client session
readOnly: true
tags:
type: array
items:
type: string
description: Event or classification tags attached to the client session
readOnly: true
timestamp:
type: number
description: Time when the client session record was observed, in epoch seconds
readOnly: true
wlan_id:
type: string
description: Identifier of the WLAN associated with the client session
contentEncoding: uuid
readOnly: true
description: Wireless client session record returned by a session search
search_wxtag_apps_item:
title: search_wxtag_apps_item
required:
- group
- key
- name
type: object
properties:
group:
type: string
description: Application category group containing this WxTag app
examples:
- Emails
key:
type: string
description: Stable application key used in WxTag configuration
examples:
- gmail
name:
type: string
description: Display name of the application
examples:
- Gmail - web/app
description: Application metadata available for WxTag matching
secintel_profile:
title: secintel_profile
type: object
properties:
name:
type: string
description: Display name of the SecIntel profile
examples:
- secintel-custom
profiles:
type: array
items:
$ref: '#/components/schemas/secintel_profile_profile'
description: Category-specific SecIntel action settings included in this profile
description: SecIntel profile containing category-specific threat intelligence actions
secintel_profile_profile:
title: secintel_profile_profile
type: object
properties:
action:
allOf:
- $ref: '#/components/schemas/secintel_profile_profile_action2'
- description: 'Protection level applied to the SecIntel category. enum: `default`, `standard`, `strict`.'
category:
allOf:
- $ref: '#/components/schemas/secintel_profile_profile_category2'
- description: 'SecIntel feed category configured by this profile entry. enum: `CC`, `DNS`, `IH`.'
description: SecIntel action setting for a specific feed category
secintel_profile_profile_action:
title: secintel_profile_profile_action
enum:
- default
- standard
- strict
type: string
description: 'enum: `default`, `standard`, `strict`'
secintel_profile_profile_category:
title: secintel_profile_profile_category
enum:
- CC
- DNS
- IH
type: string
description: 'enum: `CC`, `IH` (Infected Host), `DNS`'
secpolicy:
title: secpolicy
type: object
properties:
created_time:
type: number
description: Timestamp when the security policy was created, in epoch seconds
readOnly: true
id:
type: string
description: Unique value identifying the security policy
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
modified_time:
type: number
description: Timestamp when the security policy was last modified, in epoch seconds
readOnly: true
name:
type: string
description: Display name of the security policy
org_id:
type: string
description: Organization identifier associated with the security policy
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
site_id:
type: string
description: Site identifier associated with the security policy, when scoped to a site
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
wlans:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/wlan'
description: WLAN configurations audited by this security policy
description: Security Policy is designed to audit / catch discrepancies between "what’s intended to be running" versus "what’s actually running" in a network. Many big organizations have separated Security and IT team (for good reasons). Each site can be assigned a security policy. Whenever an AP is provisioned, the configuration will be checked against the security policy. Any violations will be flagged in Device Config History where you can search for the when and where the violation occurs.
wlan:
title: wlan
required:
- ssid
type: object
properties:
acct_immediate_update:
type: boolean
description: Enable coa-immediate-update and address-change-immediate-update on the access profile.
default: false
acct_interim_interval:
maximum: 65535
minimum: 0
type: integer
description: How frequently should interim accounting be reported, 60-65535. default is 0 (use one specified in Access-Accept request from RADIUS Server). Very frequent messages can affect the performance of the RADIUS server, 600 and up is recommended when enabled
contentEncoding: int32
default: 0
examples:
- 0
acct_servers:
type: array
items:
$ref: '#/components/schemas/radius_acct_server'
description: RADIUS accounting servers used by this WLAN
airwatch:
allOf:
- $ref: '#/components/schemas/wlan_airwatch2'
- description: Integration settings for AirWatch device compliance on this WLAN
allow_ipv6_ndp:
type: boolean
description: Only applicable when `limit_bcast`==`true`, which allows or disallows ipv6 Neighbor Discovery packets to go through
default: true
allow_mdns:
type: boolean
description: Only applicable when `limit_bcast`==`true`, which allows mDNS / Bonjour packets to go through
default: false
allow_ssdp:
type: boolean
description: Only applicable when `limit_bcast`==`true`, which allows SSDP
default: false
ap_ids:
type:
- array
- 'null'
items:
type: string
contentEncoding: uuid
description: Access point identifiers used when `apply_to`==`aps`
app_limit:
allOf:
- $ref: '#/components/schemas/wlan_app_limit2'
- description: Bandwidth limits for applications on this WLAN
app_qos:
allOf:
- $ref: '#/components/schemas/wlan_app_qos2'
- description: QoS rules for application traffic on this WLAN
apply_to:
allOf:
- $ref: '#/components/schemas/wlan_apply_to2'
- description: 'Scope that determines where this WLAN is applied. enum: `aps`, `site`, `wxtags`.'
arp_filter:
type: boolean
description: Whether to enable smart arp filter
default: false
auth:
allOf:
- $ref: '#/components/schemas/wlan_auth2'
- description: Settings that control client authentication for this WLAN
auth_server_selection:
allOf:
- $ref: '#/components/schemas/wlan_auth_server_selection2'
- description: 'RADIUS authentication server selection behavior for this WLAN. enum: `ordered`, `unordered`.'
examples:
- ordered
auth_servers:
type: array
items:
$ref: '#/components/schemas/radius_auth_server'
description: RADIUS authentication servers used by this WLAN. Required when `auth.type`==`eap`
auth_servers_nas_id:
type:
- string
- 'null'
description: Optional, up to 48 bytes, will be dynamically generated if not provided. used only for authentication servers
examples:
- 5c5b350e0101-nas
auth_servers_nas_ip:
type:
- string
- 'null'
description: Optional, NAS-IP-ADDRESS to use
examples:
- 15.3.1.5
auth_servers_retries:
type: integer
description: RADIUS auth session retries. Following fast timers are set if "fast_dot1x_timers" knob is enabled. ‘retries’ are set to value of auth_servers_retries. ‘max-requests’ is also set when setting auth_servers_retries and is set to default value to 3.
contentEncoding: int32
default: 2
examples:
- 5
auth_servers_timeout:
type: integer
description: RADIUS auth session timeout. Following fast timers are set if "fast_dot1x_timers" knob is enabled. ‘quite-period’ and ‘transmit-period’ are set to half the value of auth_servers_timeout. ‘supplicant-timeout’ is also set when setting auth_servers_timeout and is set to default value of 10.
contentEncoding: int32
default: 5
band:
type: string
description: '`band` is deprecated and kept for backward compatibility. Use `bands` instead'
deprecated: true
band_steer:
type: boolean
description: Whether to enable band_steering, this works only when band==both
default: false
band_steer_force_band5:
type: boolean
description: Force dual_band capable client to connect to 5G
default: false
bands:
type: array
items:
$ref: '#/components/schemas/dot11_band'
description: Radio bands on which this WLAN is broadcast
block_blacklist_clients:
type: boolean
description: Whether to block the clients in the blacklist (up to first 256 macs)
default: false
bonjour:
allOf:
- $ref: '#/components/schemas/wlan_bonjour2'
- description: Service discovery gateway settings for Bonjour traffic on this WLAN
cisco_cwa:
allOf:
- $ref: '#/components/schemas/wlan_cisco_cwa2'
- description: Central web authentication settings for Cisco CWA on this WLAN
client_limit_down:
anyOf:
- maximum: 999000
minimum: 1
type: integer
contentEncoding: int32
- type: string
description: Downlink bandwidth limit applied per client
client_limit_down_enabled:
type: boolean
description: If downlink limiting per-client is enabled
default: false
client_limit_up:
anyOf:
- maximum: 999000
minimum: 1
type: integer
contentEncoding: int32
- type: string
description: Uplink bandwidth limit applied per client
client_limit_up_enabled:
type: boolean
description: If uplink limiting per-client is enabled
default: false
coa_servers:
type: array
items:
$ref: '#/components/schemas/coa_server'
description: RADIUS Change of Authorization servers available to this WLAN
created_time:
type: number
description: Time when this WLAN was created, in epoch seconds
readOnly: true
disable_11ax:
type: boolean
description: Some old WLAN drivers may not be compatible
default: false
disable_11be:
type: boolean
description: To disable Wi-Fi 7 EHT IEs
default: false
disable_ht_vht_rates:
type: boolean
description: To disable ht or vht rates
default: false
disable_message_authenticator_check:
type: boolean
description: whether to disable Message-Authenticator Check, which is used to verify the integrity of RADIUS messages, default is false (i.e. for better security)
default: false
disable_uapsd:
type: boolean
description: Whether to disable U-APSD
default: false
disable_v1_roam_notify:
type: boolean
description: Disable sending v2 roam notification messages
default: false
disable_v2_roam_notify:
type: boolean
description: Disable sending v2 roam notification messages
default: false
disable_when_gateway_unreachable:
type: boolean
description: >-
When any of the following is true, this WLAN will be disabled
* cannot get IP
* cannot obtain default gateway
* cannot reach default gateway
default: false
disable_when_mxtunnel_down:
type: boolean
description: Whether to disable this WLAN when the configured Mist tunnel is down
default: false
disable_wmm:
type: boolean
description: Whether to disable WMM
default: false
dns_server_rewrite:
allOf:
- oneOf:
- {}
- $ref: '#/components/schemas/wlan_dns_server_rewrite2'
- description: RADIUS group based DNS server rewrite settings for this WLAN
dtim:
type: integer
description: Delivery Traffic Indication Message interval for this WLAN
contentEncoding: int32
default: 2
dynamic_psk:
allOf:
- oneOf:
- {}
- $ref: '#/components/schemas/wlan_dynamic_psk2'
- description: Per-user PSK selection settings for this WLAN
dynamic_vlan:
allOf:
- oneOf:
- {}
- $ref: '#/components/schemas/wlan_dynamic_vlan2'
- description: VLAN assignment settings for 802.1X dynamic VLANs
enable_ftm:
type: boolean
description: Enable FTM (Fine-Time Measurement, 802.11mc); configures the AP as an FTM Responder (target), allowing clients to perform ranging requests against it
default: false
enable_local_keycaching:
type: boolean
description: Enable AP-AP keycaching via multicast
default: false
enable_wireless_bridging:
type: boolean
description: By default, we'd inspect all DHCP packets and drop those unrelated to the wireless client itself in the case where client is a wireless bridge (DHCP packets for other MACs will need to be forwarded), wireless_bridging can be enabled
default: false
enable_wireless_bridging_dhcp_tracking:
type: boolean
description: If the client bridge is doing DHCP on behalf of other devices (L2-NAT), enable dhcp_tracking will cut down DHCP response packets to be forwarded to wireless
default: false
enabled:
type: boolean
description: If this wlan is enabled
default: true
fast_dot1x_timers:
type: boolean
description: If set to true, sets default fast-timers with values calculated from ‘auth_servers_timeout’ and ‘auth_server_retries’ .
default: false
for_site:
type: boolean
description: Whether this WLAN record is scoped to a site
readOnly: true
hide_ssid:
type: boolean
description: Whether to hide SSID in beacon
default: false
hostname_ie:
type: boolean
description: Include hostname inside IE in AP beacons / probe responses
default: false
hotspot20:
allOf:
- $ref: '#/components/schemas/wlan_hotspot_202'
- description: Passpoint and Hotspot 2.0 settings for this WLAN
id:
type: string
description: Unique identifier for this WLAN
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
inject_dhcp_option_82:
allOf:
- $ref: '#/components/schemas/wlan_inject_dhcp_option_822'
- description: DHCP Option 82 insertion settings for this WLAN
interface:
allOf:
- $ref: '#/components/schemas/wlan_interface2'
- description: 'Network interface or tunnel where this WLAN bridges client traffic. enum: `all`, `eth0`, `eth1`, `eth2`, `eth3`, `mxtunnel`, `site_mxedge`, `wxtunnel`.'
examples:
- all
isolation:
type: boolean
description: Whether to stop clients to talk to each other
default: false
l2_isolation:
type: boolean
description: If isolation is enabled, whether to deny clients to talk to L2 on the LAN
default: false
legacy_overds:
type: boolean
description: Legacy devices requires the Over-DS (for Fast BSS Transition) bit set (while our chip doesn’t support it). Warning! Enabling this will cause problem for iOS devices.
default: false
limit_bcast:
type: boolean
description: Whether to limit broadcast packets going to wireless (i.e. only allow certain bcast packets to go through)
default: false
limit_probe_response:
type: boolean
description: Limit probe response base on some heuristic rules
default: false
max_idletime:
maximum: 86400
minimum: 60
type: integer
description: Max idle time in seconds
contentEncoding: int32
default: 1800
examples:
- 1800
max_num_clients:
maximum: 128
minimum: 0
type: integer
description: Maximum number of client connected to the SSID. `0` means unlimited
contentEncoding: int32
default: 0
mist_nac:
allOf:
- $ref: '#/components/schemas/wlan_mist_nac1'
- description: Juniper Mist NAC settings used by this WLAN
modified_time:
type: number
description: Time when this WLAN was last modified, in epoch seconds
readOnly: true
msp_id:
type: string
description: Managed service provider identifier associated with this WLAN
contentEncoding: uuid
readOnly: true
examples:
- b9d42c2e-88ee-41f8-b798-f009ce7fe909
mxtunnel_id:
type: string
description: (deprecated, use mxtunnel_ids instead) when `interface`==`mxtunnel`, id of the Mist Tunnel
contentEncoding: uuid
deprecated: true
mxtunnel_ids:
type: array
items:
type: string
description: Mist Tunnel identifiers used when `interface`==`mxtunnel`
mxtunnel_name:
type: array
items:
type: string
description: Mist Tunnel names used when `interface`==`site_mxedge`
no_static_dns:
type: boolean
description: Whether to only allow client to use DNS that we’ve learned from DHCP response
default: false
no_static_ip:
type: boolean
description: Whether to only allow client that we’ve learned from DHCP exchange to talk
default: false
org_id:
type: string
description: Owning organization associated with this WLAN
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
portal:
allOf:
- $ref: '#/components/schemas/wlan_portal2'
- description: Guest portal settings for this WLAN
portal_allowed_hostnames:
type: array
items:
type: string
description: Guest portal hostnames that clients may reach before authorization
default: []
examples:
- - snapchat.com
- ibm.com
portal_allowed_subnets:
type: array
items:
type: string
description: Guest portal CIDR subnets that clients may reach before authorization
default: []
examples:
- - 63.5.3.0/24
portal_api_secret:
type:
- string
- 'null'
description: API secret (auto-generated) that can be used to sign guest authorization requests, only generated when auth is set to `external`
examples:
- EIfPMOykI3lMlDdNPub2WcbqT6dNOtWwmYHAd6bY
portal_denied_hostnames:
type: array
items:
type: string
description: Guest portal hostnames denied before authorization, taking precedence over allowed hostnames
default: []
examples:
- - msg.snapchat.com
portal_image:
type:
- string
- 'null'
description: Url of portal background image
contentEncoding: uri
readOnly: true
examples:
- https://url/to/image.png
portal_sso_url:
type:
- string
- 'null'
description: URL used in the SSO process, auto-generated when auth is set to `sso`
readOnly: true
portal_template_url:
type:
- string
- 'null'
description: N.B portal_template will be forked out of wlan objects soon. To fetch portal_template, please query portal_template_url. To update portal_template, use Wlan Portal Template.
readOnly: true
qos:
allOf:
- $ref: '#/components/schemas/wlan_qos2'
- description: Quality-of-service settings for WLAN client traffic
radsec:
allOf:
- $ref: '#/components/schemas/radsec2'
- description: TLS-secured RADIUS transport settings for this WLAN
rateset:
type: object
additionalProperties:
$ref: '#/components/schemas/wlan_datarates'
description: Data rate settings by RF band for this WLAN
reconnect_clients_when_roaming_mxcluster:
type: boolean
description: When different mxcluster is on different subnet, we'd want to disconnect clients (so they'll reconnect and get new IPs)
default: false
roam_mode:
allOf:
- $ref: '#/components/schemas/wlan_roam_mode2'
- description: 'Fast roaming mode configured for this WLAN. enum: `11r`, `NONE`, `OKC`.'
examples:
- NONE
schedule:
allOf:
- $ref: '#/components/schemas/wlan_schedule2'
- description: Operating schedule controlling when this WLAN is active
site_id:
type: string
description: Mist site associated with this WLAN, when site-scoped
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
sle_excluded:
type: boolean
description: Whether to exclude this WLAN from SLE metrics
default: false
ssid:
type: string
description: Name of the SSID
examples:
- corporate
template_id:
type:
- string
- 'null'
description: Identifier of the WLAN template associated with this WLAN
contentEncoding: uuid
thumbnail:
type:
- string
- 'null'
description: Url of portal background image thumbnail
contentEncoding: uri
readOnly: true
use_eapol_v1:
type: boolean
description: If `auth.type`==`eap` or `auth.type`==`psk`, should only be set for legacy client, such as pre-2004, 802.11b devices
default: false
vlan_enabled:
type: boolean
description: If vlan tagging is enabled
default: false
vlan_id:
oneOf:
- type: string
- maximum: 4094
minimum: 1
type: integer
contentEncoding: int32
- {}
description: Default VLAN ID, range, or variable used when `vlan_enabled`==`true`
vlan_ids:
oneOf:
- type: string
examples:
- 1,2
- type: array
items:
$ref: '#/components/schemas/vlan_id_with_variable'
examples:
- - 3
- 4
- 5
description: Pool of VLAN IDs used when `vlan_enabled`==`true` and `vlan_pooling`==`true`
vlan_pooling:
type: boolean
description: Requires `vlan_enabled`==`true` to be set to `true`. Vlan pooling allows AP to place client on different VLAN using a deterministic algorithm
default: false
wlan_limit_down:
anyOf:
- maximum: 999000
minimum: 1
type: integer
contentEncoding: int32
- type: string
description: Downlink bandwidth limit applied to the whole WLAN
wlan_limit_down_enabled:
type: boolean
description: If downlink limiting for whole wlan is enabled
default: false
wlan_limit_up:
anyOf:
- maximum: 999000
minimum: 1
type: integer
contentEncoding: int32
- type: string
description: Uplink bandwidth limit applied to the whole WLAN
wlan_limit_up_enabled:
type: boolean
description: If uplink limiting for whole wlan is enabled
default: false
wxtag_ids:
type:
- array
- 'null'
items:
type: string
contentEncoding: uuid
description: Identifiers of WxLAN tags used when `apply_to`==`wxtags`
wxtunnel_id:
type:
- string
- 'null'
description: When `interface`=`wxtunnel`, id of the WXLAN Tunnel
wxtunnel_remote_id:
type:
- string
- 'null'
description: When `interface`=`wxtunnel`, remote tunnel identifier
description: '**Note**: portal_template will be forked out of wlan objects soon. To fetch portal_template, please query portal_template_url. To update portal_template, use Wlan Portal Template.'
service:
title: service
type: object
properties:
addresses:
type: array
items:
type: string
description: Custom IPv4 or IPv6 subnets matched by this service when `type`==`custom`
examples:
- - 10.0.0.0/8
- 172.21.0.0/16
- 2001:db8:abcd:12::/64
- fd28::/128
app_categories:
type: array
items:
type: string
description: Categories of applications matched by this service when `type`==`app_categories`
examples:
- - Sports
app_subcategories:
type: array
items:
type: string
description: Application subcategories matched by this service when `type`==`app_categories`
examples:
- - Shopping
apps:
type: array
items:
type: string
description: Application identifiers matched by this service when `type`==`apps`
examples:
- - office365
- okta
client_limit_down:
maximum: 107374182
minimum: 0
type: integer
description: 0 means unlimited, value from 0 to 107374182
contentEncoding: int32
default: 0
examples:
- 300000
client_limit_up:
maximum: 107374182
minimum: 0
type: integer
description: 0 means unlimited, value from 0 to 107374182
contentEncoding: int32
default: 0
examples:
- 300000
created_time:
type: number
description: Timestamp when the service definition was created, in epoch seconds
readOnly: true
description:
type: string
description: Free-form description of the service definition
dscp:
oneOf:
- type: string
- maximum: 63
minimum: 0
type: integer
contentEncoding: int32
description: QoS DSCP value used for custom SSR traffic classification
failover_policy:
allOf:
- $ref: '#/components/schemas/service_failover_policy2'
- description: 'Failover behavior for traffic matched by this service. enum: `non_revertible`, `none`, `revertible`.'
hostnames:
type: array
items:
type: string
description: Domain hostnames matched by this custom service for web filtering
id:
type: string
description: Unique value identifying the service definition
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
max_jitter:
oneOf:
- type: string
- maximum: 2147483647
minimum: 0
type: integer
contentEncoding: int32
description: Maximum jitter threshold used for SSR uplink selection when `traffic_type`==`custom`
max_latency:
oneOf:
- type: string
- maximum: 2147483647
minimum: 0
type: integer
contentEncoding: int32
description: Maximum latency threshold used for SSR uplink selection when `traffic_type`==`custom`
max_loss:
oneOf:
- type: string
- maximum: 100
minimum: 0
type: integer
contentEncoding: int32
description: Maximum packet loss threshold used for SSR uplink selection when `traffic_type`==`custom`
modified_time:
type: number
description: Timestamp when the service definition was last modified, in epoch seconds
readOnly: true
name:
type: string
description: Display name of the service definition
org_id:
type: string
description: Organization identifier associated with the service definition
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
service_limit_down:
maximum: 107374182
minimum: 0
type: integer
description: 0 means unlimited, value from 0 to 107374182
contentEncoding: int32
default: 0
examples:
- 300000
service_limit_up:
maximum: 107374182
minimum: 0
type: integer
description: 0 means unlimited, value from 0 to 107374182
contentEncoding: int32
default: 0
examples:
- 300000
sle_enabled:
type: boolean
description: Whether to enable measure SLE
default: false
specs:
type: array
items:
$ref: '#/components/schemas/service_spec'
description: Protocol and port match rules used when `type`==`custom`
ssr_relaxed_tcp_state_enforcement:
type: boolean
description: Whether SSR relaxes TCP state enforcement for this service
default: false
traffic_class:
allOf:
- $ref: '#/components/schemas/service_traffic_class2'
- description: 'Traffic class applied when `traffic_type`==`custom`. enum: `best_effort`, `high`, `low`, `medium`.'
traffic_type:
type: string
description: values from [List Traffic Types]($e/Constants%20Definitions/listTrafficTypes)
default: data_best_effort
type:
allOf:
- $ref: '#/components/schemas/service_type2'
- description: 'Matching mode that determines which app, URL, or custom fields are used. enum: `app_categories`, `apps`, `custom`, `urls`.'
urls:
type: array
items:
type: string
description: URL patterns matched by this service when `type`==`urls`
description: Traffic service definition for applications or destinations used by gateway and SSR policies
service_failover_policy:
title: service_failover_policy
enum:
- non_revertible
- none
- revertible
type: string
description: 'enum: `non_revertible`, `none`, `revertible`'
service_packet:
title: service_packet
type: object
properties:
service_data:
type: string
description: ata from service data
service_uuid:
type: string
description: UUID from service data
description: Service data packet observed from an asset or beacon
service_policy:
title: service_policy
type: object
properties:
action:
allOf:
- $ref: '#/components/schemas/allow_deny2'
- description: Allow or deny action for traffic matched by this service policy
antivirus:
allOf:
- $ref: '#/components/schemas/service_policy_antivirus1'
- description: Malware and virus inspection settings applied by this service policy
appqoe:
allOf:
- $ref: '#/components/schemas/service_policy_appqoe1'
- description: Application QoE settings applied by this service policy
ewf:
type: array
items:
$ref: '#/components/schemas/service_policy_ewf_rule'
description: Enhanced web filtering rules applied by this service policy
idp:
allOf:
- $ref: '#/components/schemas/idp_config2'
- description: Intrusion detection and prevention settings applied by this service policy
local_routing:
type: boolean
description: Whether the policy permits access within the same VRF
name:
type: string
description: Display name of the service policy
path_preference:
type: string
description: By default, we derive all paths available and use them. Optionally, you can customize by using `path_preference`
secintel:
allOf:
- $ref: '#/components/schemas/service_policy_secintel3'
- description: Threat intelligence settings applied by this service policy
servicepolicy_id:
type: string
description: Organization-level service policy identifier used to link and override selected attributes
contentEncoding: uuid
services:
uniqueItems: true
type: array
items:
type: string
description: Application services or service groups matched by this policy
skyatp:
allOf:
- $ref: '#/components/schemas/service_policy_skyatp2'
- description: Threat inspection settings provided by Sky ATP for this service policy
ssl_proxy:
allOf:
- $ref: '#/components/schemas/service_policy_ssl_proxy3'
- description: TLS inspection settings applied by this service policy
syslog:
allOf:
- $ref: '#/components/schemas/service_policy_syslog2'
- description: Remote logging settings applied by this service policy
tenants:
uniqueItems: true
type: array
items:
type: string
description: User or network tenants matched by this service policy
description: Site-level service policy that allows or denies traffic for tenants and services
service_policy_aamw:
title: service_policy_aamw
type: object
properties:
aamwprofile_id:
type: string
description: Organization-level advanced anti-malware profile ID; takes precedence over inline `profile` settings
contentEncoding: uuid
enabled:
type: boolean
description: Whether advanced anti-malware inspection is enabled for the service policy
default: false
profile:
allOf:
- $ref: '#/components/schemas/service_policy_aamw_profile2'
- description: 'Built-in advanced anti-malware inspection profile to apply. enum: `docsonly`, `executables`, `standard`.'
description: SRX advanced anti-malware settings for a service policy
service_policy_aamw_profile:
title: service_policy_aamw_profile
enum:
- docsonly
- executables
- standard
type: string
description: 'enum: `docsonly`, `executables`, `standard`'
service_policy_antivirus:
title: service_policy_antivirus
type: object
properties:
avprofile_id:
type: string
description: Organization-level antivirus profile ID; takes precedence over inline `profile` settings
contentEncoding: uuid
enabled:
type: boolean
description: Whether antivirus inspection is enabled for the service policy
default: false
profile:
type: string
description: Antivirus profile name to apply, such as `default`, `noftp`, `httponly`, or an AV profile key
description: SRX antivirus inspection settings for a service policy
service_policy_appqoe:
title: service_policy_appqoe
type: object
properties:
enabled:
type: boolean
description: Whether application QoE is enabled for the service policy
default: false
description: SRX application QoE settings for a service policy
service_policy_ewf_rule:
title: service_policy_ewf_rule
type: object
properties:
alert_only:
type: boolean
description: Whether matching enhanced web filtering traffic is logged without being blocked
block_message:
type: string
description: Message returned when enhanced web filtering blocks a request
examples:
- Access to this URL Category has been blocked
enabled:
type: boolean
description: Whether this enhanced web filtering rule is enabled
default: false
profile:
allOf:
- $ref: '#/components/schemas/service_policy_ewf_rule_profile2'
- description: 'Enhanced web filtering profile applied by this rule. enum: `critical`, `standard`, `strict`.'
description: Enhanced web filtering rule applied by a service policy
service_policy_ewf_rule_profile:
title: service_policy_ewf_rule_profile
enum:
- critical
- standard
- strict
type: string
description: 'enum: `critical`, `standard`, `strict`'
service_policy_secintel:
title: service_policy_secintel
type: object
properties:
enabled:
type: boolean
description: Whether SecIntel inspection is enabled for the service policy
default: false
profile:
allOf:
- $ref: '#/components/schemas/service_policy_secintel_profile2'
- description: 'Protection level applied by SecIntel inspection. enum: `default`, `standard`, `strict`.'
secintelprofile_id:
type: string
description: Organization-level SecIntel profile ID; takes precedence over inline `profile` settings
description: SRX SecIntel settings for a service policy
service_policy_secintel_profile:
title: service_policy_secintel_profile
enum:
- default
- standard
- strict
type: string
description: 'enum: `default`, `standard`, `strict`'
service_policy_skyatp:
title: service_policy_skyatp
type: object
properties:
dns_dga_detection:
allOf:
- $ref: '#/components/schemas/service_policy_skyatp_dns_dga_detection2'
- description: Detection settings for DNS DGA threats provided by Sky ATP
dns_tunnel_detection:
allOf:
- $ref: '#/components/schemas/service_policy_skyatp_dns_tunnel_detection2'
- description: Detection settings for DNS tunneling threats provided by Sky ATP
http_inspection:
allOf:
- $ref: '#/components/schemas/service_policy_skyatp_http_inspection2'
- description: Web traffic inspection settings provided by Sky ATP
iot_device_policy:
allOf:
- $ref: '#/components/schemas/service_policy_skyatp_iot_device_policy2'
- description: Device threat policy settings provided by Sky ATP for IoT clients
description: SRX Sky ATP threat inspection settings for a service policy
service_policy_skyatp_dns_dga_detection:
title: service_policy_skyatp_dns_dga_detection
type: object
properties:
enabled:
type: boolean
description: Whether Sky ATP DNS DGA detection is enabled
profile:
allOf:
- $ref: '#/components/schemas/service_policy_skyatp_dns_dga_detection_profile2'
- description: 'Sky ATP DNS DGA detection profile to apply. enum: `default`, `standard`, `strict`.'
description: Sky ATP DNS DGA detection settings
service_policy_skyatp_dns_dga_detection_profile:
title: service_policy_skyatp_dns_dga_detection_profile
enum:
- default
- standard
- strict
type: string
description: 'enum: `default`, `standard`, `strict`'
service_policy_skyatp_dns_tunnel_detection:
title: service_policy_skyatp_dns_tunnel_detection
type: object
properties:
enabled:
type: boolean
description: Whether Sky ATP DNS tunneling detection is enabled
profile:
allOf:
- $ref: '#/components/schemas/service_policy_skyatp_dns_tunnel_detection_profile2'
- description: 'Sky ATP DNS tunneling detection profile to apply. enum: `default`, `standard`, `strict`.'
description: Sky ATP DNS tunneling detection settings
service_policy_skyatp_dns_tunnel_detection_profile:
title: service_policy_skyatp_dns_tunnel_detection_profile
enum:
- default
- standard
- strict
type: string
description: 'enum: `default`, `standard`, `strict`'
service_policy_skyatp_http_inspection:
title: service_policy_skyatp_http_inspection
type: object
properties:
enabled:
type: boolean
description: Whether Sky ATP HTTP inspection is enabled
profile:
allOf:
- $ref: '#/components/schemas/service_policy_skyatp_http_inspection_profile2'
- description: 'Sky ATP HTTP inspection profile to apply. enum: `standard`, `strict`.'
description: Sky ATP HTTP inspection settings
service_policy_skyatp_http_inspection_profile:
title: service_policy_skyatp_http_inspection_profile
enum:
- standard
- strict
type: string
description: 'Sky ATP HTTP inspection profile to apply. enum: `standard`, `strict`'
service_policy_skyatp_iot_device_policy:
title: service_policy_skyatp_iot_device_policy
type: object
properties:
enabled:
type: boolean
description: Whether Sky ATP IoT device policy inspection is enabled
description: Sky ATP IoT device policy settings
service_policy_ssl_proxy:
title: service_policy_ssl_proxy
type: object
properties:
ciphers_category:
allOf:
- $ref: '#/components/schemas/ssl_proxy_ciphers_category2'
- description: 'Allowed cipher strength category for SSL proxy inspection. enum: `medium`, `strong`, `weak`.'
enabled:
type: boolean
description: Whether SSL proxy inspection is enabled for the service policy
default: false
description: SRX SSL proxy inspection settings for a service policy
service_policy_syslog:
title: service_policy_syslog
type: object
properties:
enabled:
type: boolean
description: Whether syslog logging is enabled for the service policy
default: false
server_names:
type: array
items:
type: string
description: Names of syslog servers that receive logs for this service policy
examples:
- - dc_syslog_server
description: Syslog logging settings for a service policy
service_spec:
title: service_spec
type: object
properties:
port_range:
type: string
description: Port number, port range, or variable
examples:
- 8080,8443
protocol:
type: string
description: '`https`/ `tcp` / `udp` / `icmp` / `gre` / `any` / `:protocol_number`, `protocol_number` is between 1-254'
default: any
examples:
- tcp
description: Protocol and port match rule for a custom service
service_stat_property:
title: service_stat_property
type: object
properties:
ash_version:
type: string
description: Version of the ASH service package
cia_version:
type: string
description: Version of the CIA service package
ember_version:
type: string
description: Version of the Ember service package
ipsec_client_version:
type: string
description: Version of the IPsec client package
mist_agent_version:
type: string
description: Version of the Mist agent package
package_version:
type: string
description: Version of the service package
testing_tools_version:
type: string
description: Version of the testing tools package
wheeljack_version:
type: string
description: Version of the Wheeljack service package
description: Version information for gateway service packages
service_traffic_class:
title: service_traffic_class
enum:
- best_effort
- high
- low
- medium
type: string
description: 'when `traffic_type`==`custom`. enum: `best_effort`, `high`, `low`, `medium`'
service_type:
title: service_type
enum:
- app_categories
- apps
- custom
- urls
type: string
description: 'enum: `app_categories`, `apps`, `custom`, `urls`'
setting_ssr:
title: setting_ssr
type: object
properties:
auto_upgrade:
allOf:
- $ref: '#/components/schemas/setting_ssr_auto_upgrade2'
- description: Automatic SSR firmware upgrade settings for newly onboarded devices
conductor_hosts:
type: array
items:
type: string
description: IP addresses or hostnames of conductors used by SSR devices
conductor_token:
type: string
description: Registration token used by SSR devices to connect to the conductor
disable_stats:
type: boolean
description: Whether stats collection is disabled on SSR devices
proxy:
allOf:
- $ref: '#/components/schemas/ssr_proxy2'
- description: Network proxy settings used by SSR devices to reach Mist
description: SSR management settings for device onboarding and connectivity
setting_ssr_auto_upgrade:
title: setting_ssr_auto_upgrade
type: object
properties:
channel:
allOf:
- $ref: '#/components/schemas/ssr_upgrade_channel4'
- description: 'Firmware release channel used for SSR auto-upgrade. enum: `alpha`, `beta`, `stable`.'
custom_versions:
type: object
additionalProperties:
type: string
description: Per-model SSR firmware versions used for auto-upgrade
enabled:
type: boolean
description: Whether SSR auto-upgrade is enabled for newly onboarded devices
default: false
version:
type: string
description: Firmware version to deploy (e.g. 6.3.0-107.r1). Optional, used when custom_versions not specified
examples:
- 6.3.0-107.r1
description: Automatic firmware upgrade settings applied when an SSR device is first onboarded
shell_node:
title: shell_node
type: object
properties:
node:
allOf:
- $ref: '#/components/schemas/ha_cluster_node_enum2'
- description: 'HA cluster node on which to create the shell session. enum: `node0`, `node1`.'
description: Request body for creating a shell session on a specific HA node
simple_alert:
title: simple_alert
type: object
properties:
arp_failure:
allOf:
- $ref: '#/components/schemas/simple_alert_arp_failure'
- description: Thresholds for ARP failure heuristic alerts
dhcp_failure:
allOf:
- $ref: '#/components/schemas/simple_alert_dhcp_failure'
- description: Thresholds for DHCP failure heuristic alerts
dns_failure:
allOf:
- $ref: '#/components/schemas/simple_alert_dns_failure'
- description: Thresholds for DNS failure heuristic alerts
description: Heuristic alert thresholds used when a Marvis subscription is unavailable
simple_alert_arp_failure:
title: simple_alert_arp_failure
type: object
properties:
client_count:
type: integer
description: Number of distinct clients that must encounter ARP failures before alerting
contentEncoding: int32
default: 10
duration:
maximum: 60
minimum: 5
type: integer
description: Time window in minutes for evaluating ARP failures
contentEncoding: int32
default: 20
incident_count:
type: integer
description: Number of ARP failure incidents required within the duration window
contentEncoding: int32
default: 10
description: Thresholds for ARP failure heuristic alerts
simple_alert_dhcp_failure:
title: simple_alert_dhcp_failure
type: object
properties:
client_count:
type: integer
description: Number of distinct clients that must encounter DHCP failures before alerting
contentEncoding: int32
default: 10
duration:
maximum: 60
minimum: 5
type: integer
description: Time window in minutes for evaluating DHCP failures
contentEncoding: int32
default: 10
incident_count:
type: integer
description: Number of DHCP failure incidents required within the duration window
contentEncoding: int32
default: 20
description: Thresholds for DHCP failure heuristic alerts
simple_alert_dns_failure:
title: simple_alert_dns_failure
type: object
properties:
client_count:
type: integer
description: Number of distinct clients that must encounter DNS failures before alerting
contentEncoding: int32
default: 20
duration:
maximum: 60
minimum: 5
type: integer
description: Time window in minutes for evaluating DNS failures
contentEncoding: int32
default: 10
incident_count:
type: integer
description: Number of DNS failure incidents required within the duration window
contentEncoding: int32
default: 30
description: Thresholds for DNS failure heuristic alerts
site:
title: site
required:
- name
type: object
properties:
address:
type:
- string
- 'null'
description: full address of the site
examples:
- 1601 S. Deanza Blvd., Cupertino, CA, 95014
alarmtemplate_id:
type:
- string
- 'null'
description: Alarm Template ID, this takes precedence over the Org-level alarmtemplate_id
contentEncoding: uuid
examples:
- 684dfc5c-fe77-2290-eb1d-ef3d677fe168
aptemplate_id:
type:
- string
- 'null'
description: AP Template ID, used by APs
contentEncoding: uuid
examples:
- 16bdf952-ade2-4491-80b0-85ce506c760b
country_code:
type: string
description: Country code for the site (for AP config generation), in two-character
examples:
- US
created_time:
type: number
description: Timestamp when the site was created, in epoch seconds
readOnly: true
gatewaytemplate_id:
type:
- string
- 'null'
description: Gateway Template ID, used by gateways
contentEncoding: uuid
examples:
- 6f9b2e75-9b2f-b5ae-81e3-e14c76f1a90f
id:
type: string
description: Unique value identifying the site
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
latlng:
allOf:
- $ref: '#/components/schemas/lat_lng2'
- description: Latitude and longitude for the site location
modified_time:
type: number
description: Timestamp when the site was last modified, in epoch seconds
readOnly: true
name:
type: string
description: Display name of the site
examples:
- Mist Office
networktemplate_id:
type:
- string
- 'null'
description: Network Template ID, this takes precedence over Site Settings
contentEncoding: uuid
examples:
- 12ae9bd2-e0ab-107b-72e8-a7a005565ec2
notes:
type:
- string
- 'null'
description: Optional, any notes about the site
org_id:
type: string
description: Organization identifier associated with the site
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
rftemplate_id:
type:
- string
- 'null'
description: RF Template ID, this takes precedence over Site Settings
contentEncoding: uuid
examples:
- bb8a9017-1e36-5d6c-6f2b-551abe8a76a2
routertemplate_id:
type:
- string
- 'null'
description: Router Template ID, used by gateways
contentEncoding: uuid
examples:
- 6f9b2e75-9b2f-b5ae-81e3-e14c76f1a90f
secpolicy_id:
type:
- string
- 'null'
description: Security policy identifier applied to this site
contentEncoding: uuid
examples:
- 3bcd0beb-5d0a-4cbd-92c1-14aea91e98ef
sitegroup_ids:
type: array
items:
type: string
contentEncoding: uuid
description: Site group identifiers for groups that include this site
sitetemplate_id:
type:
- string
- 'null'
description: Site template identifier applied to this site
contentEncoding: uuid
timezone:
type: string
description: IANA time zone name for the site
default: UTC
examples:
- America/Los_Angeles
tzoffset:
type: integer
description: Time zone offset value derived from the site's timezone
contentEncoding: int32
default: 0
description: Site configuration and metadata within an organization
site_app:
title: site_app
required:
- group
- key
- name
type: object
properties:
group:
minLength: 1
type: string
description: Application category group for the site app
key:
minLength: 1
type: string
description: Stable application key for the site app
name:
minLength: 1
type: string
description: Display name of the site app
description: Application summary returned by the site applications endpoint
site_apps_count_distinct:
title: site_apps_count_distinct
enum:
- ap
- app
- category
- device_mac
- port_id
- service
- src_ip
- ssid
- wcid
- wlan_id app
type: string
description: 'enum: `ap`, `app`, `category`, `device_mac`, `port_id`, `service`, `src_ip`, `ssid`, `wcid`, `wlan_id app`'
site_assets_count_distinct:
title: site_assets_count_distinct
enum:
- by
- device_name
- eddystone_uid_instance
- eddystone_uid_namespace
- eddystone_url
- ibeacon_major
- ibeacon_minor
- ibeacon_uuid
- mac
- map_id
- name
type: string
description: 'enum: `by`, `device_name`, `eddystone_uid_instance`, `eddystone_uid_namespace`, `eddystone_url`, `ibeacon_major`, `ibeacon_minor`, `ibeacon_uuid`, `mac`, `map_id`, `name`'
site_auto_upgrade_version:
title: site_auto_upgrade_version
enum:
- beta
- custom
- stable
type: string
description: 'desired version. enum: `beta`, `custom`, `stable`'
examples:
- beta
site_client_events_count_distinct:
title: site_client_events_count_distinct
enum:
- band
- channel
- proto
- ssid
- type
- wlan_id
type: string
description: 'enum: `band`, `channel`, `proto`, `ssid`, `type`, `wlan_id`'
site_client_sessions_count_distinct:
title: site_client_sessions_count_distinct
enum:
- ap
- client_family
- client_manufacture
- client_model
- client_os
- mac
- ssid
- wlan_id
type: string
description: 'enum: `ap`, `client_family`, `client_manufacture`, `client_model`, `client_os`, `mac`, `ssid`, `wlan_id`'
site_clients_count_distinct:
title: site_clients_count_distinct
enum:
- ap
- device
- hostname
- ip
- model
- os
- ssid
- vlan
type: string
description: 'enum: `ap`, `device`, `hostname`, `ip`, `model`, `os`, `ssid`, `vlan`'
site_device_events_count_distinct:
title: site_device_events_count_distinct
enum:
- mac
- model
- type
- type_code
type: string
description: 'enum: `mac`, `model`, `type`, `type_code`'
site_device_last_config_count_distinct:
title: site_device_last_config_count_distinct
enum:
- mac
- name
- site_id
- version
type: string
description: 'enum: `mac`, `name`, `site_id`, `version`'
site_devices_count_distinct:
title: site_devices_count_distinct
enum:
- hostname
- lldp_mgmt_addr
- lldp_port_id
- lldp_system_desc
- lldp_system_name
- map_id
- model
- mxedge_id
- mxtunnel_status
- version
type: string
description: 'enum: `hostname`, `lldp_mgmt_addr`, `lldp_port_id`, `lldp_system_desc`, `lldp_system_name`, `map_id`, `model`, `mxedge_id`, `mxtunnel_status`, `version`'
site_discovered_switches_count_distinct:
title: site_discovered_switches_count_distinct
enum:
- mgmt_addr
- model
- system_name
- version
type: string
description: 'enum: `mgmt_addr`, `model`, `system_name`, `version`'
site_engagement:
title: site_engagement
type: object
properties:
dwell_tag_names:
allOf:
- $ref: '#/components/schemas/site_engagement_dwell_tag_names2'
- description: Display labels for dwell-time visit categories
dwell_tags:
allOf:
- $ref: '#/components/schemas/site_engagement_dwell_tags2'
- description: Visit duration ranges used to assign engagement categories
hours:
allOf:
- $ref: '#/components/schemas/hours3'
- description: Schedule during which engagement analytics rules apply
max_dwell:
maximum: 68400
minimum: 1
type: integer
description: Maximum dwell time in seconds considered by engagement analytics
contentEncoding: int32
default: 43200
examples:
- 43200
min_dwell:
minimum: 0
type: integer
description: Minimum dwell time in seconds for engagement analytics
contentEncoding: int32
description: Engagement analytics dwell-time rules for classifying site visits. If hours is omitted, rules apply every day from 00:00 to 23:59. Multiple ranges for the same day are not supported.
site_engagement_dwell_tag_names:
title: site_engagement_dwell_tag_names
type: object
properties:
bounce:
type: string
description: Display label for bounce visits
default: Visitor
examples:
- Bounce
engaged:
type: string
description: Display label for engaged visits
default: Associates
examples:
- Engaged
passerby:
type: string
description: Display label for passerby visits
default: Passerby
examples:
- Passer By
stationed:
type: string
description: Display label for stationed visits
default: Assets
examples:
- Stationed
description: Display labels for engagement dwell-time categories
site_engagement_dwell_tags:
title: site_engagement_dwell_tags
type: object
properties:
bounce:
type:
- string
- 'null'
description: Visit duration range for bounce visits, in seconds
default: 301-14400
engaged:
type:
- string
- 'null'
description: Visit duration range for engaged visits, in seconds
default: 14401-28800
passerby:
type:
- string
- 'null'
description: Visit duration range for passerby visits, in seconds
default: 1-300
stationed:
type:
- string
- 'null'
description: Visit duration range for stationed visits, in seconds
default: 28801-42000
description: Visit duration ranges in seconds used to assign engagement tags
site_guests_count_distinct:
title: site_guests_count_distinct
enum:
- auth_method
- company
- ssid
type: string
description: 'enum: `auth_method`, `company`, `ssid`'
site_iotendpoints_count_distinct:
title: site_iotendpoints_count_distinct
enum:
- ap_mac
- mac
- site_id
- type
type: string
description: 'enum: `ap_mac`, `mac`, `site_id`, `type`'
site_mxedge_events_count_distinct:
title: site_mxedge_events_count_distinct
enum:
- mxcluster_id
- mxedge_id
- package
- type
type: string
description: 'enum: `mxcluster_id`, `mxedge_id`, `package`, `type`'
site_mxtunnel:
title: site_mxtunnel
type: object
properties:
additional_mxtunnels:
type: object
additionalProperties:
$ref: '#/components/schemas/site_mxtunnel_additional_mxtunnel'
description: Additional named Mist Tunnel definitions configured for the site
ap_subnets:
type: array
items:
type: string
description: AP source subnets allowed to establish Mist Tunnels
auto_preemption:
allOf:
- $ref: '#/components/schemas/auto_preemption1'
- description: Preemption behavior for restoring preferred tunnel peers after failover
clusters:
type: array
items:
$ref: '#/components/schemas/site_mxtunnel_cluster'
description: Tunnel peer clusters used by APs for this site Mist Tunnel
created_time:
type: number
description: Timestamp when the site Mist Tunnel configuration was created
readOnly: true
enabled:
type: boolean
description: Whether site Mist Tunnel tunneling is enabled
for_site:
type: boolean
description: Whether this Mist Tunnel configuration is scoped to a site
readOnly: true
hello_interval:
maximum: 300
minimum: 1
type: integer
description: In seconds, used as heartbeat to detect if a tunnel is alive. AP will try another peer after missing N hellos specified by hello_retries
contentEncoding: int32
default: 60
examples:
- 60
hello_retries:
maximum: 30
minimum: 2
type: integer
description: Number of missed hello heartbeats before an AP tries another tunnel peer
contentEncoding: int32
default: 7
examples:
- 3
hosts:
type: array
items:
type: string
description: Tunnel peer hostnames or IP addresses reachable from APs
id:
type: string
description: Unique value identifying the site Mist Tunnel configuration
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
modified_time:
type: number
description: Timestamp when the site Mist Tunnel configuration was last modified
readOnly: true
mtu:
maximum: 1500
minimum: 0
type: integer
description: 0 to enable MTU, 552-1500 to start MTU with a lower MTU
contentEncoding: int32
default: 0
examples:
- 1100
org_id:
type: string
description: Identifier of the org that owns the site Mist Tunnel configuration
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
protocol:
allOf:
- $ref: '#/components/schemas/mxtunnel_protocol2'
- description: 'Encapsulation protocol used for the site Mist Tunnel. enum: `ip`, `udp`.'
radsec:
allOf:
- $ref: '#/components/schemas/site_mxtunnel_radsec2'
- description: TLS-secured RADIUS proxy settings for the site Mist Tunnel
site_id:
type: string
description: Identifier of the site that owns this Mist Tunnel configuration
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
vlan_ids:
type: array
items:
type: integer
contentEncoding: int32
description: List of VLAN IDs carried by this site Mist Tunnel
description: Site Mist Tunnel configuration for tunneling AP user VLANs to Mist Edge tunnel peers
site_mxtunnel_additional_mxtunnel:
title: site_mxtunnel_additional_mxtunnel
type: object
properties:
clusters:
type: array
items:
$ref: '#/components/schemas/site_mxtunnel_cluster'
description: Tunnel peer clusters used by APs for this additional Mist Tunnel
hello_interval:
maximum: 300
minimum: 1
type: integer
description: In seconds, used as heartbeat to detect if a tunnel is alive. AP will try another peer after missing N hellos specified by hello_retries
contentEncoding: int32
default: 60
examples:
- 60
hello_retries:
maximum: 30
minimum: 2
type: integer
description: Number of missed hello heartbeats before an AP tries another tunnel peer
contentEncoding: int32
default: 7
examples:
- 3
protocol:
allOf:
- $ref: '#/components/schemas/site_mxtunnel_protocol2'
- description: 'Encapsulation protocol used for this additional Mist Tunnel. enum: `ip`, `udp`.'
examples:
- udp
vlan_ids:
type: array
items:
type: integer
contentEncoding: int32
description: List of VLAN IDs carried by this additional Mist Tunnel
examples:
- - 300
- 310
- 320
description: Additional named Mist Tunnel configuration for a site
site_mxtunnel_cluster:
title: site_mxtunnel_cluster
type: object
properties:
name:
type: string
description: Peer cluster name used in the site Mist Tunnel configuration
examples:
- primary
tunterm_hosts:
type: array
items:
type: string
description: Tunnel termination hostnames or IP addresses in this peer cluster
examples:
- - mxedge1
- mxedge2.local
description: Mist Tunnel peer cluster definition for a site
site_mxtunnel_protocol:
title: site_mxtunnel_protocol
enum:
- ip
- udp
type: string
description: 'Encapsulation protocol used for this additional Mist Tunnel. enum: `ip`, `udp`'
examples:
- udp
site_mxtunnel_radsec:
title: site_mxtunnel_radsec
type: object
properties:
acct_servers:
type: array
items:
$ref: '#/components/schemas/radius_acct_server'
description: RADIUS accounting servers used by the site Mist Tunnel RadSec proxy
auth_servers:
type: array
items:
$ref: '#/components/schemas/radius_auth_server'
description: RADIUS authentication servers used by the site Mist Tunnel RadSec proxy
enabled:
type: boolean
description: Whether RadSec proxying is enabled for this site Mist Tunnel
default: false
use_mxedge:
type: boolean
description: Whether RadSec proxying uses Mist Edge
description: RadSec proxy settings for a site Mist Tunnel
site_nac_client_events_count_distinct:
title: site_nac_client_events_count_distinct
enum:
- ap
- auth_type
- dryrun_nacrule_id
- mac
- nacrule_id
- nas_vendor
- ssid
- type
- username
- vlan
type: string
description: 'enum: `ap`, `auth_type`, `dryrun_nacrule_id`, `mac`, `nacrule_id`, `nas_vendor`, `ssid`, `type`, `username`, `vlan`'
site_nac_clients_count_distinct:
title: site_nac_clients_count_distinct
enum:
- ap
- auth_type
- device_mac
- edr_managed
- edr_provider
- edr_status
- family
- hostname
- idp_id
- mfg
- mdm_compliance
- mdm_managed
- mdm_provider
- model
- mxedge_id
- nacrule_matched
- nacrule_name
- nacrule_id
- nas_ip
- nas_vendor
- os
- ssid
- status
- type
- usermac_label
- username
- vlan
type: string
description: 'enum: `ap`, `auth_type`, `device_mac`, `edr_managed`, `edr_provider`, `edr_status`, `family`, `hostname`, `idp_id`, `mfg`, `mdm_compliance`, `mdm_managed`, `mdm_provider`, `model`, `mxedge_id`, `nacrule_matched`, `nacrule_name`, `nacrule_id`, `nas_ip`, `nas_vendor`, `os`, `ssid`, `status`, `type`, `usermac_label`, `username`, `vlan`'
site_occupancy_analytics:
title: site_occupancy_analytics
type: object
properties:
assets_enabled:
type: boolean
description: Indicate whether named BLE assets should be included in the zone occupancy calculation
default: false
clients_enabled:
type: boolean
description: Indicate whether connected Wi-Fi clients should be included in the zone occupancy calculation
default: true
min_duration:
type: integer
description: Minimum dwell duration before a client or asset is counted in occupancy analytics
contentEncoding: int32
default: 3000
examples:
- 3000
sdkclients_enabled:
type: boolean
description: Indicate whether SDK clients should be included in the zone occupancy calculation
default: false
unconnected_clients_enabled:
type: boolean
description: Indicate whether unconnected Wi-Fi clients should be included in the zone occupancy calculation
default: false
description: Analytics settings for site occupancy
site_other_device_events_count_distinct:
title: site_other_device_events_count_distinct
enum:
- mac
- site_id
- type
- vendor
type: string
description: 'enum: `mac`, `site_id`, `type`, `vendor`'
site_ports_count_distinct:
title: site_ports_count_distinct
enum:
- full_duplex
- mac
- neighbor_mac
- neighbor_port_desc
- neighbor_system_name
- poe_disabled
- poe_mode
- poe_on
- port_id
- port_mac
- speed
- up
type: string
description: 'enum: `full_duplex`, `mac`, `neighbor_mac`, `neighbor_port_desc`, `neighbor_system_name`, `poe_disabled`, `poe_mode`, `poe_on`, `port_id`, `port_mac`, `speed`, `up`'
site_rogue:
title: site_rogue
type: object
properties:
allowed_vlan_ids:
type: array
items:
maximum: 4096
minimum: 0
type: integer
contentEncoding: int32
description: VLAN IDs allowed by the rogue detection policy
enabled:
type: boolean
description: Whether rogue detection is enabled
default: false
honeypot_enabled:
type: boolean
description: Whether honeypot detection is enabled
default: false
min_duration:
maximum: 59
type: integer
description: Minimum duration for a bssid to be considered neighbor
contentEncoding: int32
default: 10
examples:
- 10
min_rogue_duration:
maximum: 59
type: integer
description: Minimum duration for a bssid to be considered rogue
contentEncoding: int32
default: 10
examples:
- 10
min_rogue_rssi:
minimum: -85
type: integer
description: Minimum RSSI for an AP to be considered rogue
contentEncoding: int32
default: -80
examples:
- -80
min_rssi:
minimum: -85
type: integer
description: Minimum RSSI for an AP to be considered neighbor (ignoring APs that’s far away)
contentEncoding: int32
default: -80
examples:
- -80
whitelisted_bssids:
type: array
items:
type: string
description: BSSID values or wildcard patterns excluded from rogue detection
examples:
- - NeighborSSID
whitelisted_ssids:
type: array
items:
type: string
description: SSID names excluded from rogue detection
examples:
- - cc:8e:6f:d4:bf:16
- cc-8e-6f-d4-bf-16
- cc-73-*
- cc:82:*
description: Rogue AP detection settings for a site
site_rogue_events_count_distinct:
title: site_rogue_events_count_distinct
enum:
- ap
- bssid
- ssid
- type
type: string
description: 'enum: `ap`, `bssid`, `ssid`, `type`'
site_service_events_count_distinct:
title: site_service_events_count_distinct
enum:
- mac
- model
- policy
- port_id
- site_id
- type
- vpn_name
- vpn_path
type: string
description: 'enum: `mac`, `model`, `policy`, `port_id`, `site_id`, `type`, `vpn_name`, `vpn_path`'
site_setting:
title: site_setting
type: object
properties:
acl_policies:
type: array
items:
$ref: '#/components/schemas/acl_policy'
description: Access control policies configured for the site
acl_tags:
type: object
additionalProperties:
$ref: '#/components/schemas/acl_tag'
description: Access control tag definitions available to site policies
additional_config_cmds:
type: array
items:
type: string
description: Additional CLI configuration commands applied through the site setting
allow_mist:
type: boolean
description: whether to allow Mist to look at this org
default: false
analytic:
allOf:
- $ref: '#/components/schemas/site_setting_analytic2'
- description: Advanced analytics configuration for the site
ap_matching:
allOf:
- $ref: '#/components/schemas/site_setting_ap_matching2'
- description: Rules that apply model-specific AP port configuration
ap_port_config:
allOf:
- $ref: '#/components/schemas/site_setting_ap_port_config2'
- description: Ethernet port configuration overrides for APs at the site
ap_synthetic_test:
allOf:
- $ref: '#/components/schemas/site_setting_ap_synthetic_test2'
- description: Synthetic test configuration for APs at the site
ap_updown_threshold:
maximum: 240
minimum: 0
type:
- integer
- 'null'
description: Enable threshold-based device down delivery for AP devices only. When configured it takes effect for AP devices and `device_updown_threshold` is ignored.
contentEncoding: int32
default: 0
auto_placement:
allOf:
- $ref: '#/components/schemas/site_setting_auto_placement2'
- description: Automatic AP placement settings for the site
auto_upgrade:
allOf:
- $ref: '#/components/schemas/site_setting_auto_upgrade2'
- description: Automatic AP firmware upgrade settings for the site. Overrides org setting when provided.
auto_upgrade_esl:
allOf:
- $ref: '#/components/schemas/site_setting_auto_upgrade_esl2'
- description: Automatic ESL firmware upgrade settings for the site
auto_upgrade_linecard:
type: boolean
description: Whether line cards are included in automatic switch upgrades
default: true
bgp_neighbor_updown_threshold:
minimum: 0
type:
- integer
- 'null'
description: enable threshold-based bgp neighbor down delivery.
contentEncoding: int32
blacklist_url:
type: string
description: Read-only URL for the site blacklist file
readOnly: true
examples:
- https://papi.s3.amazonaws.com/blacklist/xxx...
ble_config:
allOf:
- $ref: '#/components/schemas/ble_config3'
- description: Bluetooth Low Energy configuration applied to APs at the site
config_auto_revert:
type: boolean
description: Whether to enable ap auto config revert
default: false
config_push_policy:
allOf:
- $ref: '#/components/schemas/site_setting_config_push_policy2'
- description: Policy controlling how site configuration pushes are applied
created_time:
type: number
description: Timestamp when the site settings were created
readOnly: true
critical_url_monitoring:
allOf:
- $ref: '#/components/schemas/site_setting_critical_url_monitoring2'
- description: Monitoring configuration for critical URLs at the site
device_updown_threshold:
maximum: 240
minimum: 0
type:
- integer
- 'null'
description: By default, device_updown_threshold, if set, will apply to all devices types if different values for specific device type is desired, use the following
contentEncoding: int32
default: 0
dhcp_snooping:
allOf:
- $ref: '#/components/schemas/dhcp_snooping4'
- description: Layer 2 DHCP snooping settings for the site
disabled_system_defined_port_usages:
type: array
items:
$ref: '#/components/schemas/system_defined_port_usages'
description: System-defined switch port usages disabled for the site
dns_servers:
type: array
items:
type: string
description: Name server addresses configured for the site
dns_suffix:
type: array
items:
type: string
description: Search suffixes used for DNS lookups at the site
enable_unii_4:
type: boolean
description: Whether UNII-4 channels are enabled for the site
default: false
engagement:
allOf:
- $ref: '#/components/schemas/site_engagement1'
- description: Dwell-time analytics rules for the site
evpn_options:
allOf:
- $ref: '#/components/schemas/evpn_options3'
- description: Fabric EVPN options for the site
extra_routes:
type: object
additionalProperties:
$ref: '#/components/schemas/extra_route'
description: Additional IPv4 routes configured for the site
examples:
- 0.0.0.0/0:
via: 192.168.1.10
extra_routes6:
type: object
additionalProperties:
$ref: '#/components/schemas/extra_route6'
description: Additional IPv6 routes configured for the site
examples:
- 2a02:1234:420a:10c9::/64:
via: 2a02:1234:200a::100
flags:
type: object
additionalProperties:
type: string
description: Feature flags enabled for the site
for_site:
type: boolean
description: Whether this settings object is scoped to a site
readOnly: true
gateway:
allOf:
- $ref: '#/components/schemas/gateway_template1'
- description: Template settings applied to site gateways
gateway_additional_config_cmds:
type: array
items:
type: string
description: Additional CLI configuration commands applied to gateways at the site
gateway_mgmt:
allOf:
- $ref: '#/components/schemas/gateway_mgmt3'
- description: Management access settings for gateways at the site
gateway_tunnel_updown_threshold:
minimum: 0
type:
- integer
- 'null'
description: enable threshold-based gateway tunnel (secure edge tunnels) up-down delivery.
contentEncoding: int32
gateway_updown_threshold:
maximum: 240
minimum: 0
type:
- integer
- 'null'
description: Enable threshold-based device down delivery for Gateway devices only. When configured it takes effect for GW devices and `device_updown_threshold` is ignored.
contentEncoding: int32
default: 0
id:
type: string
description: Unique value identifying the site settings object
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
iotproxy:
allOf:
- $ref: '#/components/schemas/iotproxy1'
- description: Proxy settings for IoT traffic at the site
juniper_srx:
allOf:
- $ref: '#/components/schemas/site_setting_juniper_srx2'
- description: SRX integration settings for the site
led:
allOf:
- $ref: '#/components/schemas/ap_led3'
- description: AP LED behavior configured for the site
marvis:
allOf:
- $ref: '#/components/schemas/marvis1'
- description: AI assistant settings for Marvis at the site
mist_nac:
allOf:
- $ref: '#/components/schemas/switch_mist_nac3'
- description: Network access control settings for switches at the site
modified_time:
type: number
description: Timestamp when the site settings were last modified
readOnly: true
mxedge:
allOf:
- $ref: '#/components/schemas/site_setting_mxedge2'
- description: Site Mist Edge service settings
mxedge_mgmt:
allOf:
- $ref: '#/components/schemas/mxedge_mgmt4'
- description: Mist Edge management access settings for the site
mxtunnel:
allOf:
- $ref: '#/components/schemas/site_mxtunnel1'
- description: Site Mist Tunnel configuration
networks:
type: object
additionalProperties:
$ref: '#/components/schemas/switch_network'
description: Switch network definitions configured for the site
ntp_servers:
type: array
items:
type: string
description: Time synchronization server addresses configured for the site
occupancy:
allOf:
- $ref: '#/components/schemas/site_occupancy_analytics'
- description: Analytics settings for site occupancy
org_id:
type: string
description: Identifier of the org that owns the site settings
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
ospf_areas:
type: object
additionalProperties:
$ref: '#/components/schemas/ospf_area'
description: Routing area settings for OSPF on site switches
paloalto_networks:
allOf:
- $ref: '#/components/schemas/site_setting_paloalto_networks2'
- description: Firewall integration settings for Palo Alto Networks at the site
persist_config_on_device:
type: boolean
description: Whether to store the config on AP
default: false
port_mirroring:
type: object
additionalProperties:
$ref: '#/components/schemas/switch_port_mirroring_property'
description: Switch port mirroring settings for the site
port_usages:
type: object
additionalProperties:
$ref: '#/components/schemas/switch_port_usage'
description: Switch port usage profiles available at the site
proxy:
allOf:
- $ref: '#/components/schemas/proxy3'
- description: Network proxy settings for devices at the site
radio_config:
allOf:
- $ref: '#/components/schemas/ap_radio3'
- description: AP radio configuration for the site
radius_config:
allOf:
- $ref: '#/components/schemas/switch_radius_config4'
- description: Switch RADIUS configuration for the site
remote_syslog:
allOf:
- $ref: '#/components/schemas/remote_syslog4'
- description: Syslog forwarding settings for devices at the site
remove_existing_configs:
type: boolean
description: By default, only the configuration generated by Mist is cleaned up during the configuration process. If `true`, all the existing configuration will be removed.
default: false
report_gatt:
type: boolean
description: Whether AP should periodically connect to BLE devices and report GATT device info (device name, manufacturer name, serial number, battery %, temperature, humidity)
default: false
rogue:
allOf:
- $ref: '#/components/schemas/site_rogue1'
- description: AP threat detection settings for the site
routing_policies:
type: object
additionalProperties:
$ref: '#/components/schemas/sw_routing_policy'
description: Switch routing policy definitions for the site
rtsa:
allOf:
- $ref: '#/components/schemas/site_setting_rtsa2'
- description: Managed mobility and asset tracking settings for the site
simple_alert:
allOf:
- $ref: '#/components/schemas/simple_alert2'
- description: Threshold alert settings for the site
site_id:
type: string
description: Identifier of the site these settings apply to
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
skyatp:
allOf:
- $ref: '#/components/schemas/site_setting_skyatp2'
- description: Threat intelligence settings from Sky ATP for the site
sle_thresholds:
allOf:
- $ref: '#/components/schemas/sle_thresholds2'
- description: Service level expectation threshold settings for the site
snmp_config:
allOf:
- $ref: '#/components/schemas/snmp_config3'
- description: Management polling settings for SNMP on site devices
srx_app:
allOf:
- $ref: '#/components/schemas/site_setting_srx_app'
- description: Juniper SRX application visibility settings for the site
ssh_keys:
type: array
items:
type: string
description: Public SSH keys configured for the site
ssr:
allOf:
- $ref: '#/components/schemas/setting_ssr2'
- description: Session Smart Router settings for the site
status_portal:
allOf:
- $ref: '#/components/schemas/site_setting_status_portal'
- description: End-user status portal settings for the site
switch:
allOf:
- $ref: '#/components/schemas/site_setting_switch2'
- description: Site-level switch feature configuration
switch_matching:
allOf:
- $ref: '#/components/schemas/switch_matching1'
- description: Rules for matching switches to model-specific settings
switch_mgmt:
allOf:
- $ref: '#/components/schemas/switch_mgmt4'
- description: Management access settings for switches at the site
switch_updown_threshold:
maximum: 240
minimum: 0
type:
- integer
- 'null'
description: Enable threshold-based device down delivery for Switch devices only. When configured it takes effect for SW devices and `device_updown_threshold` is ignored.
contentEncoding: int32
default: 0
synthetic_test:
allOf:
- $ref: '#/components/schemas/synthetictest_config1'
- description: Active monitoring test configuration for the site
track_anonymous_devices:
type: boolean
description: Whether to track anonymous BLE assets (requires ‘track_asset’ enabled)
default: false
tunterm_monitoring:
type: array
items:
$ref: '#/components/schemas/tunterm_monitoring_item'
description: Tunnel termination monitoring settings for the Mist Edges assigned to the site
tunterm_monitoring_disabled:
type: boolean
description: Whether tunnel termination monitoring is disabled for the site
default: false
tunterm_multicast_config:
allOf:
- $ref: '#/components/schemas/site_setting_tunterm_multicast_config2'
- description: Multicast settings for tunnel termination at the site
uplink_port_config:
allOf:
- $ref: '#/components/schemas/ap_uplink_port_config3'
- description: AP uplink port configuration for the site
uses_description_from_port_usage:
type: boolean
description: by default, we only honor description provided in port_config. This allows fallback to those defined in port_usages
default: false
uwb_config:
allOf:
- $ref: '#/components/schemas/ap_uwb_config3'
- description: UWB RTLS (OMLOX asset visibility) settings for the site, only effective on AP models with a UWB radio and in countries where the UWB radio is permitted. Overridden by the device profile and device-level settings
vars:
type: object
additionalProperties:
type: string
description: Template variables defined for the site
examples:
- RADIUS_IP1: 172.31.2.5
RADIUS_SECRET: 11s64632d
vars_annotations:
type: object
additionalProperties:
$ref: '#/components/schemas/vars_annotation'
description: Metadata annotations for site template variables
examples:
- MXTUNNEL_GUEST:
type: mxtunnel_id
RADIUS_IP1:
note: RADIUS server IP address for US East Campus
vna:
allOf:
- $ref: '#/components/schemas/site_setting_vna2'
- description: Virtual Network Assistant settings for the site
vpn_path_updown_threshold:
minimum: 0
type:
- integer
- 'null'
description: enable threshold-based vpn path down delivery.
contentEncoding: int32
vpn_peer_updown_threshold:
minimum: 0
type:
- integer
- 'null'
description: enable threshold-based vpn peer down delivery.
contentEncoding: int32
vrf_config:
allOf:
- $ref: '#/components/schemas/vrf_config6'
- description: Routing instance configuration for the site
vrf_instances:
type: object
additionalProperties:
$ref: '#/components/schemas/switch_vrf_instance'
description: Switch VRF instances configured for the site
examples:
- guest:
extra_routes:
0.0.0.0/0:
via: 192.168.31.1
networks:
- guest
vrrp_groups:
type: object
additionalProperties:
$ref: '#/components/schemas/vrrp_group'
description: High-availability VRRP group settings for the site
vs_instance:
type: object
additionalProperties:
$ref: '#/components/schemas/vs_instance_property'
description: EX9200 virtual switch instance definitions for the site
wan_vna:
allOf:
- $ref: '#/components/schemas/site_setting_wan_vna2'
- description: Virtual Network Assistant settings for WAN experiences at the site
watched_station_url:
type: string
description: Read-only URL for the watched station list file
readOnly: true
examples:
- https://papi.s3.amazonaws.com/watched_station/xxx...
whitelist_url:
type: string
description: Read-only URL for the site whitelist file
readOnly: true
examples:
- https://papi.s3.amazonaws.com/whitelist/xxx...
wids:
allOf:
- $ref: '#/components/schemas/site_wids2'
- description: Wireless intrusion detection settings for the site
wifi:
allOf:
- $ref: '#/components/schemas/site_wifi2'
- description: Wireless LAN configuration settings for the site
wired_vna:
allOf:
- $ref: '#/components/schemas/site_setting_wired_vna2'
- description: Virtual Network Assistant settings for wired experiences at the site
zone_occupancy_alert:
allOf:
- $ref: '#/components/schemas/site_zone_occupancy_alert2'
- description: Occupancy alert settings for site zones
description: Configuration settings applied at the site level
site_setting_analytic:
title: site_setting_analytic
type: object
properties:
enabled:
type: boolean
description: Enable Advanced Analytic feature (using SUB-ANA license)
default: false
description: Advanced analytics feature settings for a site
site_setting_ap_matching:
title: site_setting_ap_matching
type: object
properties:
enabled:
type: boolean
description: Whether AP matching rules are enabled
rules:
type: array
items:
$ref: '#/components/schemas/site_setting_ap_matching_rule'
description: Ordered AP matching rules for applying port configuration
description: Rules for applying AP port configuration by AP model or name
site_setting_ap_matching_rule:
title: site_setting_ap_matching_rule
type: object
properties:
match_model:
type: string
description: AP model matched by this rule
examples:
- AP12
name:
type: string
description: Display name of the AP matching rule
examples:
- AP12
port_config:
type: object
additionalProperties:
$ref: '#/components/schemas/ap_port_config'
description: Property key is the interface(s) (e.g. "eth1,eth2")
description: AP matching rule for selecting APs and applying port configuration
site_setting_ap_port_config:
title: site_setting_ap_port_config
type: object
properties:
model_specific:
type: object
additionalProperties:
$ref: '#/components/schemas/ap_port_config'
description: Property key is the AP model (e.g. "AP32")
description: AP Ethernet port configuration overrides by model
site_setting_ap_synthetic_test:
title: site_setting_ap_synthetic_test
type: object
properties:
additional_vlan_ids:
anyOf:
- type: string
- type: array
items:
$ref: '#/components/schemas/vlan_id_with_variable'
description: VLAN IDs included in addition to the default VLAN set for AP synthetic tests
description: AP Synthetic Test configuration
site_setting_auto_placement:
title: site_setting_auto_placement
type: object
properties:
orientation:
type: integer
description: AP orientation angle in degrees on the map
contentEncoding: int32
examples:
- 45
x:
type: number
description: Map x-coordinate determined by auto placement
examples:
- 30
y:
type: number
description: Map y-coordinate determined by auto placement
examples:
- 60
description: Automatically determined AP placement coordinates and orientation
site_setting_auto_upgrade:
title: site_setting_auto_upgrade
type: object
properties:
custom_versions:
type: object
additionalProperties:
type: string
description: Per-AP-model firmware versions or channels used for auto-upgrade
examples:
- AP21: alpha
AP41: 0.1.5135
AP61: 0.1.7215
day_of_week:
allOf:
- $ref: '#/components/schemas/day_of_week4'
- description: 'Weekly AP auto-upgrade day for the maintenance window. enum: `any`, `fri`, `mon`, `sat`, `sun`, `thu`, `tue`, `wed`.'
enabled:
type: boolean
description: Whether auto upgrade should happen (Note that Mist may auto-upgrade if the version is not supported)
default: false
time_of_day:
type: string
description: '`any` / HH:MM (24-hour format), upgrade will happen within up to 1-hour from this time'
examples:
- 12:00
version:
allOf:
- $ref: '#/components/schemas/site_auto_upgrade_version2'
- description: 'Firmware release channel or custom version used for AP auto-upgrade. enum: `beta`, `custom`, `stable`.'
examples:
- beta
description: Automatic AP firmware upgrade policy
site_setting_auto_upgrade_esl:
title: site_setting_auto_upgrade_esl
type: object
properties:
allow_downgrade:
type: boolean
description: If true, it will allow downgrade to a lower version
default: false
custom_versions:
type: object
additionalProperties:
type: string
description: Custom versions for different models. Property key is the model name (e.g. "AP41")
examples:
- AP41: 2.4.6
AP61: 2.5.0
day_of_week:
allOf:
- $ref: '#/components/schemas/day_of_week5'
- description: 'Weekly ESL auto-upgrade day for the maintenance window. enum: `any`, `fri`, `mon`, `sat`, `sun`, `thu`, `tue`, `wed`.'
enabled:
type: boolean
description: Whether auto upgrade should happen (Note that Mist may auto-upgrade if the version is not supported)
default: false
time_of_day:
type: string
description: '`any` / HH:MM (24-hour format), upgrade will happen within up to 1-hour from this time'
examples:
- 12:00
version:
type: string
description: ESL firmware version used for auto-upgrade
examples:
- 2.5.0
description: Automatic AP ESL firmware upgrade policy. When both firmware and ESL auto-upgrade are enabled, ESL upgrade will be done only after firmware upgrade
site_setting_config_push_policy:
title: site_setting_config_push_policy
type: object
properties:
no_push:
type: boolean
description: Stop any new config from being pushed to the device
default: false
push_window:
allOf:
- $ref: '#/components/schemas/push_policy_push_window1'
- description: Allowed time window during which configuration pushes may run
description: Mist also uses some heuristic rules to prevent destructive configs from being pushed
site_setting_critical_url_monitoring:
title: site_setting_critical_url_monitoring
type: object
properties:
enabled:
type: boolean
description: Whether critical URL monitoring is enabled
default: true
monitors:
type: array
items:
$ref: '#/components/schemas/site_setting_critical_url_monitoring_monitor'
description: Critical URLs monitored for site health latency
description: Critical URLs whose latency is measured and included in site health
site_setting_critical_url_monitoring_monitor:
title: site_setting_critical_url_monitoring_monitor
type: object
properties:
url:
type: string
description: Monitored HTTP or HTTPS URL used for site health latency
examples:
- http://50.1.3.5:8080
vlan_id:
oneOf:
- type: string
- maximum: 4094
minimum: 1
type: integer
contentEncoding: int32
description: Source VLAN ID used to run the critical URL monitor
description: Critical URL monitor definition for site health
site_setting_derived:
title: site_setting_derived
type: object
properties:
acl_policies:
type: array
items:
$ref: '#/components/schemas/acl_policy'
description: Access control policies configured for the site
acl_tags:
type: object
additionalProperties:
$ref: '#/components/schemas/acl_tag'
description: Access control tag definitions available to site policies
additional_config_cmds:
type: array
items:
type: string
description: Additional CLI configuration commands applied through the site setting
allow_mist:
type: boolean
description: whether to allow Mist to look at this org
default: false
analytic:
allOf:
- $ref: '#/components/schemas/site_setting_analytic2'
- description: Advanced analytics configuration for the site
ap_matching:
allOf:
- $ref: '#/components/schemas/site_setting_ap_matching2'
- description: Rules that apply model-specific AP port configuration
ap_port_config:
allOf:
- $ref: '#/components/schemas/site_setting_ap_port_config2'
- description: Ethernet port configuration overrides for APs at the site
ap_synthetic_test:
allOf:
- $ref: '#/components/schemas/site_setting_ap_synthetic_test2'
- description: Synthetic test configuration for APs at the site
ap_updown_threshold:
maximum: 240
minimum: 0
type:
- integer
- 'null'
description: Enable threshold-based device down delivery for AP devices only. When configured it takes effect for AP devices and `device_updown_threshold` is ignored.
contentEncoding: int32
default: 0
auto_placement:
allOf:
- $ref: '#/components/schemas/site_setting_auto_placement2'
- description: Automatic AP placement settings for the site
auto_upgrade:
allOf:
- $ref: '#/components/schemas/site_setting_auto_upgrade2'
- description: Automatic AP firmware upgrade settings for the site. Overrides org setting when provided.
auto_upgrade_esl:
allOf:
- $ref: '#/components/schemas/site_setting_auto_upgrade_esl2'
- description: Automatic ESL firmware upgrade settings for the site
auto_upgrade_linecard:
type: boolean
description: Whether line cards are included in automatic switch upgrades
default: true
bgp_neighbor_updown_threshold:
minimum: 0
type:
- integer
- 'null'
description: enable threshold-based bgp neighbor down delivery.
contentEncoding: int32
blacklist_url:
type: string
description: Read-only URL for the site blacklist file
readOnly: true
examples:
- https://papi.s3.amazonaws.com/blacklist/xxx...
ble_config:
allOf:
- $ref: '#/components/schemas/ble_config3'
- description: Bluetooth Low Energy configuration applied to APs at the site
config_auto_revert:
type: boolean
description: Whether to enable ap auto config revert
default: false
config_push_policy:
allOf:
- $ref: '#/components/schemas/site_setting_config_push_policy2'
- description: Policy controlling how site configuration pushes are applied
created_time:
type: number
description: Timestamp when the site settings were created
readOnly: true
critical_url_monitoring:
allOf:
- $ref: '#/components/schemas/site_setting_critical_url_monitoring2'
- description: Monitoring configuration for critical URLs at the site
device_updown_threshold:
maximum: 240
minimum: 0
type:
- integer
- 'null'
description: By default, device_updown_threshold, if set, will apply to all devices types if different values for specific device type is desired, use the following
contentEncoding: int32
default: 0
dhcp_snooping:
allOf:
- $ref: '#/components/schemas/dhcp_snooping4'
- description: Layer 2 DHCP snooping settings for the site
disabled_system_defined_port_usages:
type: array
items:
$ref: '#/components/schemas/system_defined_port_usages'
description: System-defined switch port usages disabled for the site
dns_servers:
type: array
items:
type: string
description: Name server addresses configured for the site
dns_suffix:
type: array
items:
type: string
description: Search suffixes used for DNS lookups at the site
enable_unii_4:
type: boolean
description: Whether UNII-4 channels are enabled for the site
default: false
engagement:
allOf:
- $ref: '#/components/schemas/site_engagement1'
- description: Dwell-time analytics rules for the site
evpn_options:
allOf:
- $ref: '#/components/schemas/evpn_options3'
- description: Fabric EVPN options for the site
extra_routes:
type: object
additionalProperties:
$ref: '#/components/schemas/extra_route'
description: Additional IPv4 routes configured for the site
examples:
- 0.0.0.0/0:
via: 192.168.1.10
extra_routes6:
type: object
additionalProperties:
$ref: '#/components/schemas/extra_route6'
description: Additional IPv6 routes configured for the site
examples:
- 2a02:1234:420a:10c9::/64:
via: 2a02:1234:200a::100
flags:
type: object
additionalProperties:
type: string
description: Feature flags enabled for the site
for_site:
type: boolean
description: Whether this settings object is scoped to a site
readOnly: true
gateway:
allOf:
- $ref: '#/components/schemas/gateway_template1'
- description: Template settings applied to site gateways
gateway_additional_config_cmds:
type: array
items:
type: string
description: Additional CLI configuration commands applied to gateways at the site
gateway_mgmt:
allOf:
- $ref: '#/components/schemas/gateway_mgmt3'
- description: Management access settings for gateways at the site
gateway_tunnel_updown_threshold:
minimum: 0
type:
- integer
- 'null'
description: enable threshold-based gateway tunnel (secure edge tunnels) up-down delivery.
contentEncoding: int32
gateway_updown_threshold:
maximum: 240
minimum: 0
type:
- integer
- 'null'
description: Enable threshold-based device down delivery for Gateway devices only. When configured it takes effect for GW devices and `device_updown_threshold` is ignored.
contentEncoding: int32
default: 0
id:
type: string
description: Unique value identifying the site settings object
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
iotproxy:
allOf:
- $ref: '#/components/schemas/iotproxy1'
- description: Proxy settings for IoT traffic at the site
juniper_srx:
allOf:
- $ref: '#/components/schemas/site_setting_juniper_srx2'
- description: SRX integration settings for the site
led:
allOf:
- $ref: '#/components/schemas/ap_led3'
- description: AP LED behavior configured for the site
marvis:
allOf:
- $ref: '#/components/schemas/marvis1'
- description: AI assistant settings for Marvis at the site
mist_nac:
allOf:
- $ref: '#/components/schemas/switch_mist_nac3'
- description: Network access control settings for switches at the site
modified_time:
type: number
description: Timestamp when the site settings were last modified
readOnly: true
mxedge:
allOf:
- $ref: '#/components/schemas/site_setting_mxedge2'
- description: Site Mist Edge service settings
mxedge_mgmt:
allOf:
- $ref: '#/components/schemas/mxedge_mgmt4'
- description: Mist Edge management access settings for the site
mxtunnel:
allOf:
- $ref: '#/components/schemas/site_mxtunnel1'
- description: Site Mist Tunnel configuration
networks:
type: object
additionalProperties:
$ref: '#/components/schemas/switch_network'
description: Switch network definitions configured for the site
ntp_servers:
type: array
items:
type: string
description: Time synchronization server addresses configured for the site
occupancy:
allOf:
- $ref: '#/components/schemas/site_occupancy_analytics'
- description: Analytics settings for site occupancy
org_id:
type: string
description: Identifier of the org that owns the site settings
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
ospf_areas:
type: object
additionalProperties:
$ref: '#/components/schemas/ospf_area'
description: Routing area settings for OSPF on site switches
paloalto_networks:
allOf:
- $ref: '#/components/schemas/site_setting_paloalto_networks2'
- description: Firewall integration settings for Palo Alto Networks at the site
persist_config_on_device:
type: boolean
description: Whether to store the config on AP
default: false
port_mirroring:
type: object
additionalProperties:
$ref: '#/components/schemas/switch_port_mirroring_property'
description: Switch port mirroring settings for the site
port_usages:
type: object
additionalProperties:
$ref: '#/components/schemas/switch_port_usage'
description: Switch port usage profiles available at the site
proxy:
allOf:
- $ref: '#/components/schemas/proxy3'
- description: Network proxy settings for devices at the site
radio_config:
allOf:
- $ref: '#/components/schemas/ap_radio3'
- description: AP radio configuration for the site
radius_config:
allOf:
- $ref: '#/components/schemas/switch_radius_config4'
- description: Switch RADIUS configuration for the site
remote_syslog:
allOf:
- $ref: '#/components/schemas/remote_syslog4'
- description: Syslog forwarding settings for devices at the site
remove_existing_configs:
type: boolean
description: By default, only the configuration generated by Mist is cleaned up during the configuration process. If `true`, all the existing configuration will be removed.
default: false
report_gatt:
type: boolean
description: Whether AP should periodically connect to BLE devices and report GATT device info (device name, manufacturer name, serial number, battery %, temperature, humidity)
default: false
rogue:
allOf:
- $ref: '#/components/schemas/site_rogue1'
- description: AP threat detection settings for the site
routing_policies:
type: object
additionalProperties:
$ref: '#/components/schemas/sw_routing_policy'
description: Switch routing policy definitions for the site
rtsa:
allOf:
- $ref: '#/components/schemas/site_setting_rtsa2'
- description: Managed mobility and asset tracking settings for the site
simple_alert:
allOf:
- $ref: '#/components/schemas/simple_alert2'
- description: Threshold alert settings for the site
site_id:
type: string
description: Identifier of the site these settings apply to
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
skyatp:
allOf:
- $ref: '#/components/schemas/site_setting_skyatp2'
- description: Threat intelligence settings from Sky ATP for the site
sle_thresholds:
allOf:
- $ref: '#/components/schemas/sle_thresholds2'
- description: Service level expectation threshold settings for the site
snmp_config:
allOf:
- $ref: '#/components/schemas/snmp_config3'
- description: Management polling settings for SNMP on site devices
srx_app:
allOf:
- $ref: '#/components/schemas/site_setting_srx_app'
- description: Juniper SRX application visibility settings for the site
ssh_keys:
type: array
items:
type: string
description: Public SSH keys configured for the site
ssr:
allOf:
- $ref: '#/components/schemas/setting_ssr2'
- description: Session Smart Router settings for the site
status_portal:
allOf:
- $ref: '#/components/schemas/site_setting_status_portal'
- description: End-user status portal settings for the site
switch:
allOf:
- $ref: '#/components/schemas/site_setting_switch2'
- description: Site-level switch feature configuration
switch_matching:
allOf:
- $ref: '#/components/schemas/switch_matching1'
- description: Rules for matching switches to model-specific settings
switch_mgmt:
allOf:
- $ref: '#/components/schemas/switch_mgmt4'
- description: Management access settings for switches at the site
switch_updown_threshold:
maximum: 240
minimum: 0
type:
- integer
- 'null'
description: Enable threshold-based device down delivery for Switch devices only. When configured it takes effect for SW devices and `device_updown_threshold` is ignored.
contentEncoding: int32
default: 0
synthetic_test:
allOf:
- $ref: '#/components/schemas/synthetictest_config1'
- description: Active monitoring test configuration for the site
track_anonymous_devices:
type: boolean
description: Whether to track anonymous BLE assets (requires ‘track_asset’ enabled)
default: false
tunterm_monitoring:
type: array
items:
$ref: '#/components/schemas/tunterm_monitoring_item'
description: Tunnel termination monitoring settings for the Mist Edges assigned to the site
tunterm_monitoring_disabled:
type: boolean
description: Whether tunnel termination monitoring is disabled for the site
default: false
tunterm_multicast_config:
allOf:
- $ref: '#/components/schemas/site_setting_tunterm_multicast_config2'
- description: Multicast settings for tunnel termination at the site
uplink_port_config:
allOf:
- $ref: '#/components/schemas/ap_uplink_port_config3'
- description: AP uplink port configuration for the site
uses_description_from_port_usage:
type: boolean
description: by default, we only honor description provided in port_config. This allows fallback to those defined in port_usages
default: false
uwb_config:
allOf:
- $ref: '#/components/schemas/ap_uwb_config3'
- description: UWB RTLS (OMLOX asset visibility) settings for the site, only effective on AP models with a UWB radio and in countries where the UWB radio is permitted. Overridden by the device profile and device-level settings
vars:
type: object
additionalProperties:
type: string
description: Template variables defined for the site
examples:
- RADIUS_IP1: 172.31.2.5
RADIUS_SECRET: 11s64632d
vars_annotations:
type: object
additionalProperties:
$ref: '#/components/schemas/vars_annotation'
description: Metadata annotations for site template variables
examples:
- MXTUNNEL_GUEST:
type: mxtunnel_id
RADIUS_IP1:
note: RADIUS server IP address for US East Campus
vna:
allOf:
- $ref: '#/components/schemas/site_setting_vna2'
- description: Virtual Network Assistant settings for the site
vpn_path_updown_threshold:
minimum: 0
type:
- integer
- 'null'
description: enable threshold-based vpn path down delivery.
contentEncoding: int32
vpn_peer_updown_threshold:
minimum: 0
type:
- integer
- 'null'
description: enable threshold-based vpn peer down delivery.
contentEncoding: int32
vrf_config:
allOf:
- $ref: '#/components/schemas/vrf_config6'
- description: Routing instance configuration for the site
vrf_instances:
type: object
additionalProperties:
$ref: '#/components/schemas/switch_vrf_instance'
description: Switch VRF instances configured for the site
examples:
- guest:
extra_routes:
0.0.0.0/0:
via: 192.168.31.1
networks:
- guest
vrrp_groups:
type: object
additionalProperties:
$ref: '#/components/schemas/vrrp_group'
description: High-availability VRRP group settings for the site
vs_instance:
type: object
additionalProperties:
$ref: '#/components/schemas/vs_instance_property'
description: EX9200 virtual switch instance definitions for the site
wan_vna:
allOf:
- $ref: '#/components/schemas/site_setting_wan_vna2'
- description: Virtual Network Assistant settings for WAN experiences at the site
watched_station_url:
type: string
description: Read-only URL for the watched station list file
readOnly: true
examples:
- https://papi.s3.amazonaws.com/watched_station/xxx...
whitelist_url:
type: string
description: Read-only URL for the site whitelist file
readOnly: true
examples:
- https://papi.s3.amazonaws.com/whitelist/xxx...
wids:
allOf:
- $ref: '#/components/schemas/site_wids2'
- description: Wireless intrusion detection settings for the site
wifi:
allOf:
- $ref: '#/components/schemas/site_wifi2'
- description: Wireless LAN configuration settings for the site
wired_vna:
allOf:
- $ref: '#/components/schemas/site_setting_wired_vna2'
- description: Virtual Network Assistant settings for wired experiences at the site
zone_occupancy_alert:
allOf:
- $ref: '#/components/schemas/site_zone_occupancy_alert2'
- description: Occupancy alert settings for site zones
account_id:
type: string
description: Linked app account id
readOnly: true
examples:
- iojzXIJWEuiD73ZvydOfg
auto_probe_subnet:
type: string
description: For Prisma accounts only, tunnel auto probe subnet
readOnly: true
examples:
- 11.0.0.0/8
client_id:
type: string
description: Customer account Client ID
readOnly: true
cloud_name:
type: string
description: Name of the company whose account mist has subscribed to
readOnly: true
examples:
- Tapi.sase.paloaltonetworks.com
company:
type: string
description: Name of the company whose account mist has subscribed to
readOnly: true
examples:
- Test Company1 Ltd
enable_probe:
type: boolean
description: For Prisma accounts only, tunnel probe enable/disable
readOnly: true
examples:
- false
error:
type: string
description: This error is provided when the account fails to fetch token/data
readOnly: true
examples:
- OAuth token refresh failed, please re-link your account
errors:
type: array
items:
type: string
description: Problems reported during OAuth token refresh or account data sync
readOnly: true
examples:
- - OAuth token refresh failed, please re-link your account
- API daily rate limit reached for your account
instance_url:
type: string
description: Customer account instance URL
readOnly: true
key_id:
type: string
description: For ZDX Account only, Customer account API key ID
examples:
- L72frZcK3JvrZc
last_status:
type: string
description: Is the last data pull for account is successful or not
readOnly: true
examples:
- failed
last_sync:
type: integer
description: Last data pull timestamp, background jobs that pull account data
contentEncoding: int64
readOnly: true
examples:
- 1665465339000
linked_by:
type: string
description: First name of the user who linked the account
readOnly: true
examples:
- Testname1
linked_timestamp:
type: number
description: Timestamp when this third-party account was linked
readOnly: true
examples:
- 1665465339000
max_daily_api_requests:
type: integer
description: Zoom daily api request quota, https://developers.zoom.us/docs/api/rest/rate-limits/
contentEncoding: int32
readOnly: true
examples:
- 5000
name:
type: string
description: Display name of the linked third-party account or company
readOnly: true
examples:
- Test Compay1 Ltd
password:
type: string
description: Customer account password instance URL
contentEncoding: password
readOnly: true
region:
type: string
description: For Prisma accounts only
readOnly: true
examples:
- americas
regions:
type: object
additionalProperties:
$ref: '#/components/schemas/account_oauth_info_account_region'
description: Prisma Access regions with allocated bandwidth for this linked account
service_account_name:
type: string
description: For Prisma accounts only
readOnly: true
examples:
- Corp SA
service_connections:
type: object
additionalProperties:
$ref: '#/components/schemas/account_oauth_info_account_service_connection'
description: Prisma Access service connections configured for this linked account
smartgroup_name:
type: string
description: Smart group membership for determining compliance status
readOnly: true
examples:
- CompliantGroup1
tsg_id:
type: string
description: For Prisma accounts only, Prisma Tenant Service Group id
readOnly: true
examples:
- '189953456'
username:
type: string
description: Login name configured for the linked third-party account
readOnly: true
webhook_auth_type:
type: string
description: For Crowdstrike, JAMF, SentinelOne and VMWare accounts only
examples:
- Basic
- Bearer
webhook_enabled:
type: boolean
description: For Crowdstrike, JAMF, SentinelOne and VMWare accounts only
webhook_password:
type: string
description: For VMWare accounts only
contentEncoding: password
examples:
- password_1234
webhook_secret:
type: string
description: For Crowdstrike accounts only
contentEncoding: password
examples:
- secret-value
webhook_token:
type: string
description: For JAMF and SentinelOne accounts only
examples:
- token-value
webhook_url:
type: string
description: For Crowdstrike, JAMF, SentinelOne and VMWare accounts only
examples:
- https://websync.nac-staging.mistsys.com/v1/S_org-8dcbe9005/ae9dee49-69e7-4710-a114-5b827a777738/crowdstrike/edr
- https://websync.nac-staging.mistsys.com/v1/S_org-8dcbe9005/ae9dee49-69e7-4710-a114-5b827a777738/jamf/mdm
- https://websync.nac-staging.mistsys.com/v1/S_org-8dcbe9005/00fd8b39-cf92-4b43-a2ff-a461b48e7059/sentinelone/edr
- https://websync.nac-staging.mistsys.com/v1/S_41b2525af1d8dcbe9005/f43ea4c48f22/vmware/mdm
webhook_username:
type: string
description: For VMWare accounts only
examples:
- username_1234
zdx_org_id:
type: string
description: For ZDX Account only, ZDX organization id
examples:
- '123456'
additionalProperties:
allOf:
- $ref: '#/components/schemas/account_oauth_info_account'
- description: OAuth linked apps account info
description: Site settings with derived OAuth account integration data
system_defined_port_usages:
title: system_defined_port_usages
enum:
- ap
- iot
- uplink
type: string
description: 'system-default port usages. enum: `ap`, `iot`, `uplink``'
site_setting_juniper_srx:
title: site_setting_juniper_srx
type: object
properties:
auto_upgrade:
allOf:
- $ref: '#/components/schemas/juniper_srx_auto_upgrade2'
- description: SRX auto-upgrade settings applied when SRX devices are onboarded
gateways:
type: array
items:
$ref: '#/components/schemas/site_setting_juniper_srx_gateway'
description: SRX gateways integrated with this site
send_mist_nac_user_info:
type: boolean
description: Whether Mist NAC user information is sent to Juniper SRX gateways
description: Site-level Juniper SRX integration settings
site_setting_juniper_srx_gateway:
title: site_setting_juniper_srx_gateway
type: object
properties:
api_key:
type: string
description: Authentication key used to access the Juniper SRX gateway API
examples:
- 5abf7c8a-1a1c-4398-ba2d-b0c297094d1a
api_password:
type: string
description: Authentication password used to access the Juniper SRX gateway API
examples:
- abc@123
api_url:
type: string
description: Base URL for the Juniper SRX gateway API
examples:
- https://23.43.12.78:8443
description: Juniper SRX gateway API connection settings
site_setting_mxedge:
title: site_setting_mxedge
type: object
properties:
mist_das:
allOf:
- $ref: '#/components/schemas/mxedge_das2'
- description: DAS service settings for the site Mist Edge cluster
mist_nac:
allOf:
- $ref: '#/components/schemas/mxcluster_nac2'
- description: RADIUS settings for Mist NAC on the site Mist Edge cluster
mist_nacedge:
allOf:
- $ref: '#/components/schemas/mist_nacedge1'
- description: NAC Edge service settings for the site Mist Edge cluster
radsec:
allOf:
- $ref: '#/components/schemas/mxcluster_radsec2'
- description: TLS-secured RADIUS proxy settings for the site Mist Edge cluster
description: Service settings for the site Mist Edge cluster
site_setting_paloalto_network_gateway:
title: site_setting_paloalto_network_gateway
type: object
properties:
api_key:
type: string
description: Authentication key used to access the Palo Alto Networks gateway API
examples:
- 5abf7c8a-1a1c-4398-ba2d-b0c297094d1a
api_url:
type: string
description: Base URL for the Palo Alto Networks gateway API
examples:
- https://23.43.12.78:8443
description: Palo Alto Networks gateway API connection settings
site_setting_paloalto_networks:
title: site_setting_paloalto_networks
type: object
properties:
gateways:
type: array
items:
$ref: '#/components/schemas/site_setting_paloalto_network_gateway'
description: Palo Alto Networks gateways integrated with this site
send_mist_nac_user_info:
type: boolean
description: Whether Mist NAC user information is sent to Palo Alto Networks gateways
default: false
description: Palo Alto Networks integration settings for the site
site_setting_rtsa:
title: site_setting_rtsa
type: object
properties:
app_waking:
type: boolean
description: Whether app wake-up support is enabled for managed mobility
default: false
disable_dead_reckoning:
type: boolean
description: Whether dead reckoning is disabled for managed mobility
disable_pressure_sensor:
type: boolean
description: Whether pressure sensor use is disabled for managed mobility
default: false
enabled:
type: boolean
description: Whether managed mobility features are enabled
track_asset:
type: boolean
description: Whether BLE asset tracking is enabled for managed mobility
default: false
description: Managed mobility and asset tracking settings
site_setting_skyatp:
title: site_setting_skyatp
type: object
properties:
enabled:
type: boolean
description: Whether Sky ATP is enabled for the site
send_ip_mac_mapping:
type: boolean
description: Whether IP-to-MAC mappings are sent to Sky ATP
default: false
description: Sky ATP threat intelligence settings for the site
site_setting_srx_app:
title: site_setting_srx_app
type: object
properties:
enabled:
type: boolean
description: Whether Juniper SRX application visibility is enabled
default: false
description: Juniper SRX application visibility settings for the site
site_setting_status_portal:
title: site_setting_status_portal
type: object
properties:
enabled:
type: boolean
description: Whether the site status portal is enabled
default: false
hostnames:
type: array
items:
type: string
description: Portal hostnames served by the site status portal
description: End-user status portal settings for the site
site_setting_switch:
title: site_setting_switch
type: object
properties:
acl_policies:
type: array
items:
$ref: '#/components/schemas/acl_policy'
description: ACL policy defaults provided by this network template
acl_tags:
type: object
additionalProperties:
$ref: '#/components/schemas/acl_tag'
description: ACL tags available to access policies in this network template
additional_config_cmds:
type: array
items:
type: string
description: Additional CLI configuration commands provided by this network template
bgp_config:
type: object
additionalProperties:
$ref: '#/components/schemas/switch_bgp_config'
description: BGP routing defaults for this network template. Property key is the BGP session name
created_time:
type: number
description: Timestamp when the network template was created
readOnly: true
dhcp_snooping:
allOf:
- $ref: '#/components/schemas/dhcp_snooping3'
- description: DHCP snooping defaults provided by this network template
dns_servers:
type: array
items:
type: string
description: DNS servers provided by this network template
dns_suffix:
type: array
items:
type: string
description: DNS search suffixes provided by this network template
extra_routes:
type: object
additionalProperties:
$ref: '#/components/schemas/extra_route'
description: Additional IPv4 route defaults in this network template
examples:
- 0.0.0.0/0:
via: 192.168.1.10
extra_routes6:
type: object
additionalProperties:
$ref: '#/components/schemas/extra_route6'
description: Additional IPv6 route defaults in this network template
examples:
- 2a02:1234:420a:10c9::/64:
via: 2a02:1234:200a::100
id:
type: string
description: Unique identifier of the network template
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
import_org_networks:
type: array
items:
type: string
description: Organization network names imported into this network template
mist_nac:
allOf:
- $ref: '#/components/schemas/switch_mist_nac2'
- description: Mist NAC defaults applied by this network template
modified_time:
type: number
description: Timestamp when the network template was last modified
readOnly: true
multicast_config:
allOf:
- $ref: '#/components/schemas/switch_multicast_config1'
- description: Multicast settings for networks in the master VRF (not assigned to any vrf_instances); PIM is automatically enabled when any master-VRF network has `multicast.enabled`==`true`
name:
type: string
description: Display name of the network template
networks:
type: object
additionalProperties:
$ref: '#/components/schemas/switch_network'
description: Layer 3 networks configured by this network template
ntp_servers:
type: array
items:
type: string
description: NTP servers provided by this network template
org_id:
type: string
description: Organization that owns this network template
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
ospf_areas:
type: object
additionalProperties:
$ref: '#/components/schemas/ospf_area'
description: OSPF area defaults provided by this network template
port_mirroring:
type: object
additionalProperties:
$ref: '#/components/schemas/switch_port_mirroring_property'
description: Port mirroring defaults provided by this network template
port_usages:
type: object
additionalProperties:
$ref: '#/components/schemas/switch_port_usage'
description: Reusable switch port usage profiles provided by this network template
radius_config:
allOf:
- $ref: '#/components/schemas/switch_radius_config3'
- description: RADIUS authentication and accounting defaults in this network template
remote_syslog:
allOf:
- $ref: '#/components/schemas/remote_syslog2'
- description: Remote syslog defaults provided by this network template
remove_existing_configs:
type: boolean
description: By default, only the configuration generated by Mist is cleaned up during the configuration process. If `true`, all the existing configuration will be removed.
default: false
routing_policies:
type: object
additionalProperties:
$ref: '#/components/schemas/sw_routing_policy'
description: Routing policy defaults applied by this network template
snmp_config:
allOf:
- $ref: '#/components/schemas/snmp_config2'
- description: SNMP defaults provided by this network template
switch_matching:
allOf:
- $ref: '#/components/schemas/switch_matching3'
- description: Matching rules that select switches for this network template
switch_mgmt:
allOf:
- $ref: '#/components/schemas/switch_mgmt3'
- description: Management-plane defaults provided by this network template
vrf_config:
allOf:
- $ref: '#/components/schemas/vrf_config5'
- description: VRF defaults applied by this network template
vrf_instances:
type: object
additionalProperties:
$ref: '#/components/schemas/switch_vrf_instance'
description: VRF instances configured by this network template
examples:
- guest:
extra_routes:
0.0.0.0/0:
via: 192.168.31.1
networks:
- guest
auto_upgrade:
allOf:
- $ref: '#/components/schemas/switch_auto_upgrade1'
- description: Switch firmware auto-upgrade configuration
description: Site switch settings combining a network template and auto-upgrade controls
site_setting_tunterm_multicast_config:
title: site_setting_tunterm_multicast_config
type: object
properties:
mdns:
allOf:
- $ref: '#/components/schemas/site_setting_tunterm_multicast_config_mdns2'
- description: Multicast DNS forwarding settings for tunneled VLANs
multicast_all:
type: boolean
description: Whether all multicast traffic is forwarded through tunnel termination
default: false
ssdp:
allOf:
- $ref: '#/components/schemas/site_setting_tunterm_multicast_config_ssdp2'
- description: Simple Service Discovery Protocol forwarding settings for tunneled VLANs
description: Multicast forwarding settings for tunnel termination at the site
site_setting_tunterm_multicast_config_mdns:
title: site_setting_tunterm_multicast_config_mdns
type: object
properties:
enabled:
type: boolean
description: Whether mDNS multicast forwarding is enabled
default: false
vlan_ids:
type: array
items:
type: integer
contentEncoding: int32
description: VLAN IDs where mDNS multicast forwarding is enabled
examples:
- - 2
- 3
- 5
description: mDNS multicast forwarding settings for tunneled VLANs
site_setting_tunterm_multicast_config_ssdp:
title: site_setting_tunterm_multicast_config_ssdp
type: object
properties:
enabled:
type: boolean
description: Whether SSDP multicast forwarding is enabled
default: false
vlan_ids:
type: array
items:
type: integer
contentEncoding: int32
description: VLAN IDs where SSDP multicast forwarding is enabled
examples:
- - 2
- 3
- 5
description: SSDP multicast forwarding settings for tunneled VLANs
site_setting_vna:
title: site_setting_vna
type: object
properties:
enabled:
type: boolean
description: Enable Virtual Network Assistant (using SUB-VNA license). This applied to AP / Switch / Gateway
default: false
description: Virtual Network Assistant settings for AP, switch, and gateway experiences at a site
vrrp_group:
title: vrrp_group
type: object
properties:
auth_key:
type: string
description: If `auth_type`==`md5`, authentication key used by the VRRP group
examples:
- auth-key-1
auth_password:
type: string
description: If `auth_type`==`simple`, password used by the VRRP group
contentEncoding: password
auth_type:
allOf:
- $ref: '#/components/schemas/vrrp_group_auth_type2'
- description: 'Authentication method used by the VRRP group. enum: `md5`, `simple`.'
examples:
- md5
networks:
type: object
additionalProperties:
$ref: '#/components/schemas/vrrp_group_network'
description: VRRP network mappings and their virtual IP addresses
examples:
- data:
ip: 10.182.96.1
mgmt:
ip: 10.182.104.1
v10:
ip: 10.182.104.129
wap:
ip: 10.182.102.1
description: Junos VRRP group authentication and network settings
site_setting_wan_vna:
title: site_setting_wan_vna
type: object
properties:
enabled:
type: boolean
description: Whether WAN VNA is enabled for the site
default: false
description: WAN Virtual Network Assistant settings for the site
site_setting_wired_vna:
title: site_setting_wired_vna
type: object
properties:
enabled:
type: boolean
description: Whether Wired VNA is enabled for the site
default: false
description: Wired Virtual Network Assistant settings for the site
site_sky_atp_events_count_distinct:
title: site_sky_atp_events_count_distinct
enum:
- device_mac
- mac
- threat_level
- type
type: string
description: 'enum: `device_mac`, `mac`, `threat_level`, `type`'
site_sle_histogram_scope_parameters:
title: site_sle_histogram_scope_parameters
enum:
- ap
- client
- gateway
- site
- switch
type: string
description: 'enum: `ap`, `client`, `gateway`, `site`, `switch`'
site_sle_impact_summary_fields_parameter:
title: site_sle_impact_summary_fields_parameter
enum:
- ap
- band
- chassis
- client
- device_os
- device_type
- gateway
- gateway_zones
- interface
- mxedge
- peer_path
- server
- switch
- vlan
- wlan
type: string
description: 'enum: `ap`, `band`, `chassis`, `client`, `device_os`, `device_type`, `gateway`, `gateway_zones`, `interface`, `mxedge`, `peer_path`, `server`, `switch`, `vlan`, `wlan`'
site_sle_impact_summary_scope_parameters:
title: site_sle_impact_summary_scope_parameters
enum:
- ap
- client
- gateway
- site
- switch
type: string
description: 'enum: `ap`, `client`, `gateway`, `site`, `switch`'
site_sle_impacted_aps_scope_parameters:
title: site_sle_impacted_aps_scope_parameters
const: site
type: string
description: 'Scope parameter value for impacted AP SLE queries. enum: `site`'
site_sle_impacted_chassis_scope_parameters:
title: site_sle_impacted_chassis_scope_parameters
enum:
- gateway
- site
- switch
type: string
description: 'enum: `gateway`, `site`, `switch`'
site_sle_impacted_clients_scope_parameters:
title: site_sle_impacted_clients_scope_parameters
enum:
- gateway
- site
- switch
type: string
description: 'enum: `gateway`, `site`, `switch`'
site_sle_impacted_gateways_scope_parameters:
title: site_sle_impacted_gateways_scope_parameters
const: site
type: string
description: 'Scope parameter value for impacted gateway SLE queries. enum: `site`'
site_sle_impacted_interfaces_scope_parameters:
title: site_sle_impacted_interfaces_scope_parameters
enum:
- gateway
- site
- switch
type: string
description: 'enum: `gateway`, `site`, `switch`'
site_sle_impacted_switches_scope_parameters:
title: site_sle_impacted_switches_scope_parameters
const: site
type: string
description: 'Scope parameter value for impacted switch SLE queries. enum: `site`'
site_sle_impacted_users_scope_parameter:
title: site_sle_impacted_users_scope_parameter
enum:
- ap
- site
type: string
description: 'Scope parameter value for impacted user SLE queries. enum: `ap`, `site`'
site_sle_metric_classifiers_scope_parameters:
title: site_sle_metric_classifiers_scope_parameters
enum:
- ap
- client
- gateway
- site
- switch
type: string
description: 'enum: `ap`, `client`, `gateway`, `site`, `switch`'
site_sle_metric_summary_scope_parameters:
title: site_sle_metric_summary_scope_parameters
enum:
- ap
- client
- gateway
- site
- switch
type: string
description: 'enum: `ap`, `client`, `gateway`, `site`, `switch`'
site_sle_metrics:
title: site_sle_metrics
required:
- enabled
- supported
type: object
properties:
enabled:
uniqueItems: true
type: array
items:
type: string
description: SLE metric names enabled for the site
supported:
uniqueItems: true
type: array
items:
type: string
description: SLE metric names supported for the site
description: SLE metrics available for a site
site_sle_metrics_scope_parameters:
title: site_sle_metrics_scope_parameters
enum:
- ap
- client
- gateway
- site
- switch
type: string
description: 'enum: `ap`, `client`, `gateway`, `site`, `switch`'
site_sle_scope:
title: site_sle_scope
enum:
- gateway
- site
- switch
type: string
description: 'enum: `gateway`, `site`, `switch`'
site_sle_threshold_scope_parameter:
title: site_sle_threshold_scope_parameter
enum:
- ap
- client
- gateway
- site
- switch
type: string
description: 'enum: `ap`, `client`, `gateway`, `site`, `switch`'
site_system_events_count_distinct:
title: site_system_events_count_distinct
const: type
type: string
description: 'Distinct field used when counting site system events. enum: `type`'
site_template:
title: site_template
type: object
properties:
auto_upgrade:
allOf:
- $ref: '#/components/schemas/site_template_auto_upgrade2'
- description: Automatic upgrade settings applied by this site template
name:
type: string
description: Display name of the site template
vars:
type: object
additionalProperties:
type: string
description: Template variables available to WLAN configuration in this site template
examples:
- RADIUS_IP1: 172.31.2.5
RADIUS_SECRET: 11s64632d
description: Site template containing auto-upgrade settings and template variables
site_template_auto_upgrade:
title: site_template_auto_upgrade
type: object
properties:
day_of_week:
allOf:
- $ref: '#/components/schemas/day_of_week6'
- description: 'Day of week when the automatic upgrade window runs. enum: `any`, `fri`, `mon`, `sat`, `sun`, `thu`, `tue`, `wed`.'
enabled:
type: boolean
description: Whether automatic upgrades are enabled for sites using this site template
time_of_day:
type: string
description: Local time of day when the automatic upgrade window starts
version:
type: string
description: Target firmware version installed during automatic upgrades
description: Automatic upgrade settings applied by a site template
site_wan_client_events_distinct:
title: site_wan_client_events_distinct
enum:
- hostname
- ip
- mac
- mfg
- type
type: string
description: 'enum: `hostname`, `ip`, `mac`, `mfg`, `type`'
site_wan_clients_count_distinct:
title: site_wan_clients_count_distinct
enum:
- hostname
- ip
- mac
- mfg
type: string
description: 'enum: `hostname`, `ip`, `mac`, `mfg`'
site_wids:
title: site_wids
type: object
properties:
repeated_auth_failures:
allOf:
- $ref: '#/components/schemas/site_wids_repeated_auth_failures'
- description: Detection settings for repeated authentication failures
description: Wireless intrusion detection settings for a site
site_wids_repeated_auth_failures:
title: site_wids_repeated_auth_failures
type: object
properties:
duration:
type: integer
description: Window where a trigger will be detected and action to be taken (in seconds)
contentEncoding: int32
examples:
- 60
threshold:
type: integer
description: Count of events to trigger
contentEncoding: int32
description: Detection settings for repeated authentication failures
site_wifi:
title: site_wifi
type: object
properties:
cisco_enabled:
type: boolean
description: Whether Cisco compatibility features are enabled for site Wi-Fi
default: true
disable_11k:
type: boolean
description: Whether to disable 11k
default: false
disable_radios_when_power_constrained:
type: boolean
description: Whether AP radios are disabled when AP power is constrained
default: false
enable_arp_spoof_check:
type: boolean
description: When proxy_arp is enabled, check for arp spoofing.
default: false
enable_shared_radio_scanning:
type: boolean
description: Whether shared radio scanning is enabled for site Wi-Fi
default: true
enabled:
type: boolean
description: Enable Wi-Fi feature (using SUB-MAN license)
default: true
locate_connected:
type: boolean
description: Whether to locate connected clients
default: true
locate_unconnected:
type: boolean
description: Whether to locate unconnected clients
default: false
mesh_allow_dfs:
type: boolean
description: Whether to allow Mesh to use DFS channels. For DFS channels, Remote Mesh AP would have to do CAC when scanning for new Base AP, which is slow and will disrupt the connection. If roaming is desired, keep it disabled.
default: false
mesh_enable_crm:
type: boolean
description: Used to enable/disable CRM
default: false
mesh_enabled:
type: boolean
description: Whether to enable Mesh feature for the site
default: false
mesh_psk:
type:
- string
- 'null'
description: Optional passphrase of mesh networking, default is generated randomly
mesh_ssid:
type:
- string
- 'null'
description: Optional ssid of mesh networking, default is based on site_id
proxy_arp:
allOf:
- oneOf:
- {}
- $ref: '#/components/schemas/site_wifi_proxy_arp2'
- description: 'ARP proxy mode for site Wi-Fi. enum: `default`, `disabled`, `enabled`.'
description: Wi-Fi configuration settings for a site
site_wifi_proxy_arp:
title: site_wifi_proxy_arp
enum:
- default
- disabled
- enabled
type: string
description: 'enum: `default`, `disabled`, `enabled`'
site_wired_clients_count_distinct:
title: site_wired_clients_count_distinct
enum:
- mac
- port_id
- vlan
type: string
description: 'enum: `mac`, `port_id`, `vlan`'
site_zone_count_distinct:
title: site_zone_count_distinct
enum:
- scope
- scope_id
- user
- user_type
type: string
description: 'enum: `scope`, `scope_id`, `user`, `user_type`'
site_zone_occupancy_alert:
title: site_zone_occupancy_alert
type: object
properties:
email_notifiers:
type: array
items:
type: string
description: Notification email recipients for zone occupancy alerts
examples:
- - foo@juniper.net
- bar@juniper.net
enabled:
type: boolean
description: Indicate whether zone occupancy alert is enabled for the site
default: false
threshold:
maximum: 30
minimum: 0
type: integer
description: Sending zone-occupancy-alert webhook message only if a zone stays non-compliant (i.e. actual occupancy > occupancy_limit) for a minimum duration specified in the threshold, in minutes
contentEncoding: int32
default: 5
examples:
- 5
description: Zone occupancy alert settings for a site
sitegroup:
title: sitegroup
required:
- name
type: object
properties:
created_time:
type: number
description: Timestamp when the site group was created
readOnly: true
id:
type: string
description: Unique value identifying the site group
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
modified_time:
type: number
description: Timestamp when the site group was last modified
readOnly: true
name:
type: string
description: Display name of the site group
org_id:
type: string
description: Identifier of the org that owns the site group
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
site_ids:
type: array
items:
type: string
contentEncoding: uuid
description: Site identifiers included in the site group
description: Group of sites within an organization
skyatp_list:
title: skyatp_list
type: object
properties:
domains:
type: array
items:
$ref: '#/components/schemas/skyatp_list_domain'
description: SecIntel domain entries in this Sky ATP list
ip:
type: array
items:
$ref: '#/components/schemas/skyatp_list_ip'
description: SecIntel IP address entries in this Sky ATP list
description: Sky ATP SecIntel allowlist or blocklist entries
skyatp_list_domain:
title: skyatp_list_domain
required:
- value
type: object
properties:
comment:
type: string
description: Optional note describing the domain list entry
examples:
- restricted
value:
type: string
description: Domain name included in the Sky ATP SecIntel list
examples:
- unsafe.com
description: Domain entry in a Sky ATP SecIntel list
skyatp_list_ip:
title: skyatp_list_ip
required:
- value
type: object
properties:
comment:
type: string
description: Optional note describing the IP address list entry
examples:
- nas
value:
type: string
description: IP address included in the Sky ATP SecIntel list
examples:
- 10.1.3.5
description: IP address entry in a Sky ATP SecIntel list
sle_classifier:
title: sle_classifier
required:
- impact
- interval
- name
- x_label
- y_label
type: object
properties:
impact:
allOf:
- $ref: '#/components/schemas/sle_classifier_impact2'
- description: Counts of affected APs and users for this classifier
interval:
type: number
description: Sample interval in seconds for classifier time-series data
name:
minLength: 1
type: string
description: Classifier name for the SLE metric
samples:
allOf:
- $ref: '#/components/schemas/sle_classifier_samples3'
- description: Time-series sample arrays for the classifier
x_label:
minLength: 1
type: string
description: Label for the classifier sample x-axis
y_label:
minLength: 1
type: string
description: Label for the classifier sample y-axis
description: Time-series classifier detail for an SLE metric
sle_classifier_impact:
title: sle_classifier_impact
required:
- num_aps
- num_users
- total_aps
- total_users
type: object
properties:
num_aps:
type: number
description: Number of APs affected by degraded SLE experience
num_users:
type: number
description: Number of users affected by degraded SLE experience
total_aps:
type: number
description: Total number of APs considered for the classifier
total_users:
type: number
description: Total number of users considered for the classifier
description: AP and user impact counts for an SLE classifier
sle_classifier_samples:
title: sle_classifier_samples
required:
- degraded
- duration
- total
type: object
properties:
degraded:
type: array
items:
$ref: '#/components/schemas/number_or_null'
description: Per-interval degraded SLE values for the classifier
duration:
type: array
items:
type: number
description: Per-interval observation durations for the classifier
total:
type: array
items:
$ref: '#/components/schemas/number_or_null'
description: Per-interval total SLE values for the classifier
description: Per-interval sample arrays for an SLE classifier
sle_classifier_summary:
title: sle_classifier_summary
required:
- classifier
- end
- failures
- impact
- metric
- start
type: object
properties:
classifier:
allOf:
- $ref: '#/components/schemas/sle_classifier1'
- description: Requested SLE classifier detail for the metric
end:
type: number
description: Last timestamp in the classifier summary window
failures:
type: array
items:
type: object
description: Failure records included in the classifier summary
impact:
allOf:
- $ref: '#/components/schemas/sle_classifier_summary_impact2'
- description: AP and user impact counts for the classifier summary window
metric:
minLength: 1
type: string
description: SLE metric name summarized by this response
start:
type: number
description: First timestamp in the classifier summary window
description: Deprecated SLE classifier summary response
deprecated: true
sle_classifier_summary_impact:
title: sle_classifier_summary_impact
required:
- num_aps
- num_users
- total_aps
- total_users
type: object
properties:
num_aps:
type: number
description: Number of APs affected by degraded SLE experience
num_users:
type: number
description: Number of users affected by degraded SLE experience
total_aps:
type: number
description: Total number of APs considered in the summary window
total_users:
type: number
description: Total number of users considered in the summary window
description: AP and user impact counts for a classifier summary window
sle_classifier_summary_trend:
title: sle_classifier_summary_trend
required:
- classifier
- end
- metric
- start
type: object
properties:
classifier:
allOf:
- $ref: '#/components/schemas/sle_trend_classifier2'
- description: Requested SLE classifier trend detail for the metric
end:
type: number
description: Last timestamp in the classifier trend window
metric:
minLength: 1
type: string
description: SLE metric name represented by the trend
start:
type: number
description: First timestamp in the classifier trend window
description: Time-series trend response for an SLE classifier
sle_histogram:
title: sle_histogram
required:
- data
- end
- metric
- start
- x_label
- y_label
type: object
properties:
data:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/sle_histogram_data_item'
description: Histogram buckets for the SLE metric
end:
type: number
description: Last timestamp in the histogram window
metric:
minLength: 1
type: string
description: SLE metric name represented by the histogram
start:
type: number
description: First timestamp in the histogram window
x_label:
minLength: 1
type: string
description: Label for the histogram x-axis
y_label:
minLength: 1
type: string
description: Label for the histogram y-axis
description: Histogram response for an SLE metric
sle_histogram_data_item:
title: sle_histogram_data_item
required:
- value
type: object
properties:
range:
type: array
items:
type:
- number
- 'null'
description: Boundary values for this histogram bucket
value:
type: number
description: Measured amount for this histogram bucket
description: Single bucket in an SLE histogram
sle_impact_summary:
title: sle_impact_summary
required:
- ap
- band
- classifier
- device_os
- device_type
- end
- failure
- metric
- start
- wlan
type: object
properties:
ap:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/sle_impact_summary_ap_item'
description: Impact rows grouped by AP
band:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/sle_impact_summary_band_item'
description: Impact rows grouped by radio band
classifier:
type: string
description: Requested SLE classifier filter applied to the impact summary
device_os:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/sle_impact_summary_device_os_item'
description: Impact rows grouped by client device OS
device_type:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/sle_impact_summary_device_type_item'
description: Impact rows grouped by client device type
end:
type: number
description: Last timestamp in the impact summary window
failure:
type: string
description: Requested SLE failure filter applied to the impact summary
metric:
minLength: 1
type: string
description: SLE metric name summarized by this response
start:
type: number
description: First timestamp in the impact summary window
wlan:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/sle_impact_summary_wlan_item'
description: Impact rows grouped by WLAN
description: SLE impact summary grouped by client, device, AP, WLAN, and band dimensions
sle_impact_summary_ap_item:
title: sle_impact_summary_ap_item
required:
- ap_mac
- degraded
- duration
- name
- total
type: object
properties:
ap_mac:
minLength: 1
type: string
description: MAC address of the AP represented by this impact row
degraded:
type: number
description: Portion of the SLE total that was degraded for this AP
duration:
type: number
description: Observation time represented by this AP impact row
name:
minLength: 1
type: string
description: Display name for the AP impact row
total:
type: number
description: Overall SLE total measured for this AP impact row
description: SLE impact summary row for an AP
sle_impact_summary_band_item:
title: sle_impact_summary_band_item
required:
- band
- degraded
- duration
- name
- total
type: object
properties:
band:
minLength: 1
type: string
description: Radio band represented by this impact row
degraded:
type: number
description: Portion of the SLE total that was degraded for this radio band
duration:
type: number
description: Observation time represented by this radio-band impact row
name:
minLength: 1
type: string
description: Display name for the radio-band impact row
total:
type: number
description: Overall SLE total measured for this radio-band impact row
description: SLE impact summary row for a radio band
sle_impact_summary_device_os_item:
title: sle_impact_summary_device_os_item
required:
- degraded
- device_os
- duration
- name
- total
type: object
properties:
degraded:
type: number
description: Portion of the SLE total that was degraded for this device OS
device_os:
type: string
description: Client device OS represented by this impact row
duration:
type: number
description: Observation time represented by this device-OS impact row
name:
minLength: 1
type: string
description: Display name for the device-OS impact row
total:
type: number
description: Overall SLE total measured for this device-OS impact row
description: SLE impact summary row for a client device OS
sle_impact_summary_device_type_item:
title: sle_impact_summary_device_type_item
required:
- degraded
- device_type
- duration
- name
- total
type: object
properties:
degraded:
type: number
description: Portion of the SLE total that was degraded for this device type
device_type:
type: string
description: Client device type represented by this impact row
duration:
type: number
description: Observation time represented by this device-type impact row
name:
minLength: 1
type: string
description: Display name for the device-type impact row
total:
type: number
description: Overall SLE total measured for this device-type impact row
description: SLE impact summary row for a client device type
sle_impact_summary_wlan_item:
title: sle_impact_summary_wlan_item
required:
- degraded
- duration
- name
- total
- wlan_id
type: object
properties:
degraded:
type: number
description: Portion of the SLE total that was degraded for this WLAN
duration:
type: number
description: Observation time represented by this WLAN impact row
name:
minLength: 1
type: string
description: Display name for the WLAN impact row
total:
type: number
description: Overall SLE total measured for this WLAN impact row
wlan_id:
minLength: 1
type: string
description: Identifier of the WLAN represented by this impact row
description: SLE impact summary row for a WLAN
sle_impacted_applications:
title: sle_impacted_applications
type: object
properties:
apps:
type: array
items:
$ref: '#/components/schemas/sle_impacted_applications_app'
description: Impacted application rows returned for the SLE query
classifier:
type: string
description: Requested SLE classifier filter applied to the query
end:
type: integer
description: Last timestamp in the impacted applications window
contentEncoding: int32
failure:
type: string
description: Requested SLE failure filter applied to the query
limit:
type: integer
description: Maximum number of impacted application rows returned per page
contentEncoding: int32
metric:
type: string
description: SLE metric name used for the impacted applications query
page:
type: integer
description: Current page number for impacted application results
contentEncoding: int32
start:
type: integer
description: First timestamp in the impacted applications window
contentEncoding: int32
total_count:
type: integer
description: Number of impacted application rows matching the query
contentEncoding: int32
description: Paginated list of applications impacted by an SLE metric
sle_impacted_applications_app:
title: sle_impacted_applications_app
type: object
properties:
app:
type: string
description: Identifier of the application represented by this impacted row
degraded:
type: integer
description: Portion of the SLE total that was degraded for this application
contentEncoding: int32
duration:
type: integer
description: Observation time represented by this application impact row
contentEncoding: int32
name:
type: string
description: Display name for the application impact row
threshold:
type: integer
description: SLE threshold value used for this application
contentEncoding: int32
total:
type: integer
description: Overall SLE total measured for this application impact row
contentEncoding: int32
description: SLE impact row for an application
sle_impacted_aps:
title: sle_impacted_aps
required:
- aps
- classifier
- end
- failure
- limit
- metric
- page
- start
- total_count
type: object
properties:
aps:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/sle_impacted_aps_ap'
description: Impacted access point rows returned for the SLE query
classifier:
type: string
description: Requested SLE classifier filter applied to the query
end:
type: number
description: Last timestamp in the impacted APs window
failure:
type: string
description: Requested SLE failure filter applied to the query
limit:
type: integer
description: Maximum number of impacted AP rows returned per page
contentEncoding: int32
metric:
minLength: 1
type: string
description: SLE metric name used for the impacted APs query
page:
type: number
description: Current page number for impacted AP results
start:
type: number
description: First timestamp in the impacted APs window
total_count:
type: number
description: Number of impacted AP rows matching the query
description: Paginated list of APs impacted by an SLE metric
sle_impacted_aps_ap:
title: sle_impacted_aps_ap
required:
- ap_mac
- degraded
- duration
- name
- total
type: object
properties:
ap_mac:
minLength: 1
type: string
description: MAC address of the AP represented by this impacted row
degraded:
type: number
description: Portion of the SLE total that was degraded for this AP
duration:
type: number
description: Observation time represented by this AP impact row
name:
minLength: 1
type: string
description: Display name for the AP impact row
total:
type: number
description: Overall SLE total measured for this AP impact row
description: SLE impact row for an AP
sle_impacted_chassis:
title: sle_impacted_chassis
type: object
properties:
chassis:
type: array
items:
$ref: '#/components/schemas/sle_impacted_chassis_chassis_item'
description: Impacted chassis rows returned for the SLE query
classifier:
type: string
description: Requested SLE classifier filter applied to the query
end:
type: integer
description: Last timestamp in the impacted chassis window
contentEncoding: int32
failure:
type: string
description: Requested SLE failure filter applied to the query
limit:
type: integer
description: Maximum number of impacted chassis rows returned per page
contentEncoding: int32
metric:
type: string
description: SLE metric name used for the impacted chassis query
page:
type: integer
description: Current page number for impacted chassis results
contentEncoding: int32
start:
type: integer
description: First timestamp in the impacted chassis window
contentEncoding: int32
total_count:
type: integer
description: Number of impacted chassis rows matching the query
contentEncoding: int32
description: Paginated list of chassis impacted by an SLE metric
sle_impacted_chassis_chassis_item:
title: sle_impacted_chassis_chassis_item
type: object
properties:
chassis:
type: string
description: Identifier of the chassis represented by this impacted row
degraded:
type: number
description: Portion of the SLE total that was degraded for this chassis
duration:
type: number
description: Observation time represented by this chassis impact row
role:
type: string
description: Virtual Chassis role for the switch member
switch_mac:
type: string
description: MAC address of the switch represented by this chassis row
switch_name:
type: string
description: Display name of the switch represented by this chassis row
total:
type: number
description: Overall SLE total measured for this chassis impact row
description: SLE impact row for a chassis
sle_impacted_client_gateway:
title: sle_impacted_client_gateway
type: object
properties:
chassis_mac:
type: string
description: MAC address of the chassis associated with this client gateway row
gateway_mac:
type: string
description: MAC address of the gateway associated with this client row
gateway_name:
type: string
description: Display name of the gateway associated with this client row
interfaces:
uniqueItems: true
type: array
items:
type: string
description: Network interfaces associated with this client gateway row
description: Gateway association for an impacted client
sle_impacted_clients:
title: sle_impacted_clients
type: object
properties:
classifier:
type: string
description: Requested SLE classifier filter applied to the query
clients:
type: array
items:
$ref: '#/components/schemas/sle_impacted_clients_client'
description: Impacted client rows returned for the SLE query
end:
type: integer
description: Last timestamp in the impacted clients window
contentEncoding: int32
failure:
type: string
description: Requested SLE failure filter applied to the query
limit:
type: integer
description: Maximum number of impacted client rows returned per page
contentEncoding: int32
metric:
type: string
description: SLE metric name used for the impacted clients query
page:
type: integer
description: Current page number for impacted client results
contentEncoding: int32
start:
type: integer
description: First timestamp in the impacted clients window
contentEncoding: int32
total_count:
type: integer
description: Number of impacted client rows matching the query
contentEncoding: int32
description: Paginated list of clients impacted by an SLE metric
sle_impacted_clients_client:
title: sle_impacted_clients_client
type: object
properties:
degraded:
type: integer
description: Portion of the SLE total that was degraded for this client
contentEncoding: int32
duration:
type: integer
description: Observation time represented by this client impact row
contentEncoding: int32
mac:
type: string
description: Client MAC address for the impacted client
name:
type: string
description: Display name for the client impact row
switches:
type: array
items:
$ref: '#/components/schemas/sle_impacted_clients_client_switch'
description: Switch rows associated with the impacted client
total:
type: integer
description: Overall SLE total measured for this client impact row
contentEncoding: int32
description: SLE impact row for a client
sle_impacted_clients_client_switch:
title: sle_impacted_clients_client_switch
type: object
properties:
interfaces:
uniqueItems: true
type: array
items:
type: string
description: Switch interfaces associated with this impacted client
switch_mac:
type: string
description: MAC address of the switch associated with this impacted client
switch_name:
type: string
description: Display name of the switch associated with this impacted client
description: Switch association for an impacted client
sle_impacted_gateways:
title: sle_impacted_gateways
type: object
properties:
classifier:
type: string
description: Requested SLE classifier filter applied to the query
end:
type: integer
description: Last timestamp in the impacted gateways window
contentEncoding: int32
failure:
type: string
description: Requested SLE failure filter applied to the query
gateways:
type: array
items:
$ref: '#/components/schemas/sle_impacted_gateways_gateway'
description: Impacted gateway rows returned for the SLE query
limit:
type: integer
description: Maximum number of impacted gateway rows returned per page
contentEncoding: int32
metric:
type: string
description: SLE metric name used for the impacted gateways query
page:
type: integer
description: Current page number for impacted gateway results
contentEncoding: int32
start:
type: integer
description: First timestamp in the impacted gateways window
contentEncoding: int32
total_count:
type: integer
description: Number of impacted gateway rows matching the query
contentEncoding: int32
description: Paginated list of gateways impacted by an SLE metric
sle_impacted_gateways_gateway:
title: sle_impacted_gateways_gateway
type: object
properties:
degraded:
type: number
description: Portion of the SLE total that was degraded for this gateway
duration:
type: integer
description: Observation time represented by this gateway impact row
contentEncoding: int32
gateway_mac:
type: string
description: MAC address of the gateway represented by this impacted row
gateway_model:
type: string
description: Model of the gateway represented by this impacted row
gateway_version:
type: string
description: Firmware version of the gateway represented by this impacted row
name:
type: string
description: Display name for the gateway impact row
total:
type: integer
description: Overall SLE total measured for this gateway impact row
contentEncoding: int32
description: SLE impact row for a gateway
sle_impacted_interfaces:
title: sle_impacted_interfaces
type: object
properties:
classifier:
type: string
description: Requested SLE classifier filter applied to the query
end:
type: integer
description: Last timestamp in the impacted interfaces window
contentEncoding: int32
failure:
type: string
description: Requested SLE failure filter applied to the query
interfaces:
type: array
items:
$ref: '#/components/schemas/sle_impacted_interfaces_interface'
description: Impacted interface rows returned for the SLE query
limit:
type: integer
description: Maximum number of impacted interface rows returned per page
contentEncoding: int32
metric:
type: string
description: SLE metric name used for the impacted interfaces query
page:
type: integer
description: Current page number for impacted interface results
contentEncoding: int32
start:
type: integer
description: First timestamp in the impacted interfaces window
contentEncoding: int32
total_count:
type: integer
description: Number of impacted interface rows matching the query
contentEncoding: int32
description: Paginated list of interfaces impacted by an SLE metric
sle_impacted_interfaces_interface:
title: sle_impacted_interfaces_interface
type: object
properties:
degraded:
type: number
description: Portion of the SLE total that was degraded for this interface
duration:
type: number
description: Observation time represented by this interface impact row
interface_name:
type: string
description: Name of the switch interface represented by this impacted row
switch_mac:
type: string
description: MAC address of the switch associated with this interface
switch_name:
type: string
description: Display name of the switch associated with this interface
total:
type: number
description: Overall SLE total measured for this interface impact row
description: SLE impact row for a switch interface
sle_impacted_switches:
title: sle_impacted_switches
type: object
properties:
classifier:
type: string
description: Requested SLE classifier filter applied to the query
end:
type: integer
description: Last timestamp in the impacted switches window
contentEncoding: int32
failure:
type: string
description: Requested SLE failure filter applied to the query
limit:
type: integer
description: Maximum number of impacted switch rows returned per page
contentEncoding: int32
metric:
type: string
description: SLE metric name used for the impacted switches query
page:
type: integer
description: Current page number for impacted switch results
contentEncoding: int32
start:
type: integer
description: First timestamp in the impacted switches window
contentEncoding: int32
switches:
type: array
items:
$ref: '#/components/schemas/sle_impacted_switches_switch'
description: Impacted switch rows returned for the SLE query
total_count:
type: integer
description: Number of impacted switch rows matching the query
contentEncoding: int32
description: Paginated list of switches impacted by an SLE metric
sle_impacted_switches_switch:
title: sle_impacted_switches_switch
type: object
properties:
degraded:
type: number
description: Portion of the SLE total that was degraded for this switch
duration:
type: number
description: Observation time represented by this switch impact row
interface:
uniqueItems: true
type: array
items:
type: string
description: Switch interfaces contributing to this impacted switch row
name:
type: string
description: Display name for the switch impact row
switch_mac:
type: string
description: MAC address of the switch represented by this impacted row
switch_model:
type: string
description: Model of the switch represented by this impacted row
switch_version:
type: string
description: Firmware version of the switch represented by this impacted row
total:
type: number
description: Overall SLE total measured for this switch impact row
description: SLE impact row for a switch
sle_impacted_users:
title: sle_impacted_users
required:
- classifier
- end
- failure
- limit
- metric
- page
- start
- total_count
type: object
properties:
classifier:
type: string
description: Requested SLE classifier filter applied to the query
clients:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/sle_impacted_users_client'
description: Impacted client rows returned for the SLE query
end:
type: number
description: Last timestamp in the impacted users window
failure:
type: string
description: Requested SLE failure filter applied to the query
limit:
type: integer
description: Maximum number of impacted user rows returned per page
contentEncoding: int32
metric:
minLength: 1
type: string
description: SLE metric name used for the impacted users query
page:
type: number
description: Current page number for impacted user results
start:
type: number
description: First timestamp in the impacted users window
total_count:
type: number
description: Number of impacted user rows matching the query
users:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/sle_impacted_users_user'
description: Impacted user rows returned for the SLE query
description: Paginated list of users impacted by an SLE metric
sle_impacted_users_client:
title: sle_impacted_users_client
type: object
properties:
degraded:
type: number
description: Portion of the SLE total that was degraded for this client
duration:
type: number
description: Observation time represented by this client impact row
gateways:
type: array
items:
$ref: '#/components/schemas/sle_impacted_client_gateway'
description: Gateway rows associated with the impacted client
mac:
type: string
description: Client MAC address for the impacted client
name:
type: string
description: Display name for the client impact row
src_ip:
type: string
description: Client source IP address for the impacted client
total:
type: number
description: Overall SLE total measured for this client impact row
description: SLE impact row for a client in an impacted users response
sle_impacted_users_user:
title: sle_impacted_users_user
type: object
properties:
ap_mac:
type: string
description: MAC address of the AP associated with this impacted user
ap_name:
type: string
description: Display name of the AP associated with this impacted user
degraded:
type: number
description: Portion of the SLE total that was degraded for this user
device_os:
type: string
description: Client device OS for this impacted user
device_type:
type: string
description: Client device type for this impacted user
duration:
type: number
description: Observation time represented by this user impact row
mac:
type: string
description: Client MAC address for this impacted user
name:
type: string
description: Display name for the user impact row
ssid:
type: string
description: Wireless network SSID used by this impacted user
total:
type: number
description: Overall SLE total measured for this user impact row
wlan_id:
type: string
description: Identifier of the WLAN used by this impacted user
description: SLE impact row for a user
sle_summary:
title: sle_summary
required:
- classifiers
- end
- events
- impact
- sle
- start
type: object
properties:
classifiers:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/sle_classifier'
description: SLE classifier details included in the summary
end:
type: number
description: Last timestamp in the SLE summary window
events:
type: array
items:
type: object
description: Event records included in the SLE summary
impact:
allOf:
- $ref: '#/components/schemas/sle_summary_impact2'
- description: AP and user impact counts for the summary window
sle:
allOf:
- $ref: '#/components/schemas/sle_summary_sle3'
- description: Time-series SLE samples for the summary window
start:
type: number
description: First timestamp in the SLE summary window
description: Deprecated SLE summary response for a metric window
deprecated: true
sle_summary_impact:
title: sle_summary_impact
required:
- num_aps
- num_users
- total_aps
- total_users
type: object
properties:
num_aps:
type: number
description: Number of APs affected by degraded SLE experience
num_users:
type: number
description: Number of users affected by degraded SLE experience
total_aps:
type: number
description: Total number of APs considered in the summary window
total_users:
type: number
description: Total number of users considered in the summary window
description: AP and user impact counts for an SLE summary window
sle_summary_scope:
title: sle_summary_scope
enum:
- ap
- client
- gateway
- site
- switch
type: string
description: 'enum: `ap`, `client`, `gateway`, `site`, `switch`'
sle_summary_sle:
title: sle_summary_sle
required:
- interval
- name
- samples
- x_label
- y_label
type: object
properties:
interval:
type: number
description: Sample interval in seconds for SLE summary data
name:
minLength: 1
type: string
description: SLE metric name represented by the summary samples
samples:
allOf:
- $ref: '#/components/schemas/sle_summary_sle_samples2'
- description: Per-interval sample arrays for the SLE metric
x_label:
minLength: 1
type: string
description: Label for the SLE summary x-axis
y_label:
minLength: 1
type: string
description: Label for the SLE summary y-axis
description: Time-series SLE metric samples for a summary response
sle_summary_sle_samples:
title: sle_summary_sle_samples
required:
- degraded
- total
- value
type: object
properties:
degraded:
type: array
items:
$ref: '#/components/schemas/number_or_null'
description: Per-interval degraded SLE values for the summary
total:
type: array
items:
$ref: '#/components/schemas/number_or_null'
description: Per-interval total SLE values for the summary
value:
type: array
items:
$ref: '#/components/schemas/number_or_null'
description: Per-interval SLE score values for the summary
description: Per-interval sample arrays for an SLE summary
sle_summary_trend:
title: sle_summary_trend
required:
- classifiers
- end
- sle
- start
type: object
properties:
classifiers:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/sle_trend_classifier'
description: SLE classifier trend details included in the response
end:
type: number
description: Last timestamp in the SLE summary trend window
sle:
allOf:
- $ref: '#/components/schemas/sle_summary_sle2'
- description: Time-series SLE samples for the trend window
start:
type: number
description: First timestamp in the SLE summary trend window
description: Time-series SLE summary trend response
sle_trend_classifier:
title: sle_trend_classifier
required:
- interval
- name
- x_label
- y_label
type: object
properties:
interval:
type: number
description: Sample interval in seconds for classifier trend data
name:
minLength: 1
type: string
description: Classifier name for the SLE metric trend
samples:
allOf:
- $ref: '#/components/schemas/sle_classifier_samples2'
- description: Time-series sample arrays for the classifier trend
x_label:
minLength: 1
type: string
description: Label for the classifier trend x-axis
y_label:
minLength: 1
type: string
description: Label for the classifier trend y-axis
description: Time-series classifier trend detail for an SLE metric
sle_threshold:
title: sle_threshold
type: object
properties:
default:
type: number
description: Built-in threshold value for this SLE metric
readOnly: true
direction:
minLength: 1
type: string
description: Comparison direction used for SLE threshold evaluation
readOnly: true
maximum:
type: number
description: Highest allowed threshold value for this SLE metric
metric:
minLength: 1
type: string
description: SLE metric name associated with this threshold
readOnly: true
minimum:
type: number
description: Lowest allowed threshold value for this SLE metric
threshold:
minLength: 1
type: string
description: Configured threshold value for this SLE metric
readOnly: true
units:
minLength: 1
type: string
description: Measurement units for this SLE threshold
readOnly: true
description: Threshold metadata and configured value for an SLE metric
sle_thresholds:
title: sle_thresholds
type: object
properties:
capacity:
maximum: 50
minimum: 5
type: integer
description: Threshold percentage for capacity SLE scoring
contentEncoding: int32
default: 20
coverage:
maximum: -60
minimum: -90
type: integer
description: RSSI threshold for coverage SLE scoring, in dBm
contentEncoding: int32
default: -72
throughput:
maximum: 100
minimum: 1
type: integer
description: Minimum throughput threshold for SLE scoring, in Mbps
contentEncoding: int32
default: 10
time-to-connect:
maximum: 10
minimum: 2
type: integer
description: Time to connect, in seconds
contentEncoding: int32
default: 4
description: Site SLE threshold overrides for capacity, coverage, throughput, and time to connect
snmp_config:
title: snmp_config
type: object
properties:
client_list:
type: array
items:
$ref: '#/components/schemas/snmp_config_client_list'
description: SNMP client allowlists that can be referenced by communities
contact:
type: string
description: Administrative contact string advertised through SNMP
examples:
- cns@juniper.net
description:
type: string
description: Device description string advertised through SNMP
examples:
- Juniper QFX Series Switch - 1K_5LA
enabled:
type: boolean
description: Whether SNMP is enabled
default: true
engine_id:
maxLength: 27
type: string
description: SNMP engine ID used for SNMPv3
engine_id_type:
allOf:
- $ref: '#/components/schemas/snmp_config_engine_id_type2'
- description: 'Method used to derive the SNMP engine ID. enum: `local`, `use_mac_address`.'
location:
type: string
description: Physical location string advertised through SNMP
examples:
- Las Vegas, NV
name:
type: string
description: System name advertised through SNMP
examples:
- TGH-1K-QFX10K
network:
type: string
description: Management network used for SNMP traffic
default: default
trap_groups:
type: array
items:
$ref: '#/components/schemas/snmp_config_trap_group'
description: SNMP trap group definitions
v2c_config:
type: array
items:
$ref: '#/components/schemas/snmp_config_v2c_config'
description: SNMPv2c community configuration entries for this SNMP profile
v3_config:
allOf:
- $ref: '#/components/schemas/snmpv3_config2'
- description: SNMPv3 user, VACM, notify, and target configuration
views:
type: array
items:
$ref: '#/components/schemas/snmp_config_view'
description: SNMP MIB view definitions
description: SNMP configuration for managed network devices
snmp_config_client_list:
title: snmp_config_client_list
type: object
properties:
client_list_name:
type: string
description: Name of the SNMP client list
examples:
- clist-1
clients:
type: array
items:
type: string
description: SNMP client IP addresses or CIDR ranges allowed by this list
description: SNMP client allowlist definition
snmp_config_engine_id_type:
title: snmp_config_engine_id_type
enum:
- local
- use_mac_address
type: string
description: 'Method used to derive the SNMP engine ID. enum: `local`, `use_mac_address`'
snmp_config_trap_group:
title: snmp_config_trap_group
type: object
properties:
categories:
type: array
items:
type: string
description: Trap categories included in this SNMP trap group
group_name:
type: string
description: Trap group name for this SNMP trap group
examples:
- profiler
targets:
type: array
items:
type: string
description: Trap target addresses for this SNMP trap group
version:
allOf:
- $ref: '#/components/schemas/snmp_config_trap_version2'
- description: 'SNMP trap protocol version used by this group. enum: `all`, `v1`, `v2`.'
description: SNMP trap group definition
snmp_config_trap_version:
title: snmp_config_trap_version
enum:
- all
- v1
- v2
type: string
description: 'enum: `all`, `v1`, `v2`'
snmp_config_v2c_config:
title: snmp_config_v2c_config
type: object
properties:
authorization:
type: string
description: Access level for the SNMPv2c community
examples:
- read-only
client_list_name:
type: string
description: SNMP client list name referenced by this community
examples:
- clist-1
community_name:
type: string
description: SNMPv2c community string name
examples:
- abc123
view:
type: string
description: SNMP view name that must be defined in the views list
examples:
- all
description: SNMPv2c community configuration entry
snmp_config_view:
title: snmp_config_view
type: object
properties:
include:
type: boolean
description: Whether the root OID is included in this SNMP view
oid:
type: string
description: Root OID for this SNMP view
examples:
- 1.3.6.1
view_name:
type: string
description: Name of the SNMP MIB view definition
examples:
- all
description: SNMP MIB view definition
snmp_usm:
title: snmp_usm
type: object
properties:
engine_type:
allOf:
- $ref: '#/components/schemas/snmp_usm_engine_type2'
- description: 'SNMP engine type used for this USM configuration. enum: `local_engine`, `remote_engine`.'
remote_engine_id:
type: string
description: Required only if `engine_type`==`remote_engine`
examples:
- 00:00:00:0b:00:00:70:10:6f:08:b6:3f
users:
type: array
items:
$ref: '#/components/schemas/snmp_usm_user'
description: SNMPv3 USM users for this engine
description: SNMPv3 User-based Security Model configuration
snmp_usm_engine_type:
title: snmp_usm_engine_type
enum:
- local_engine
- remote_engine
type: string
description: 'SNMP engine type used for this USM configuration. enum: `local_engine`, `remote_engine`'
snmp_usm_user:
title: snmp_usm_user
type: object
properties:
authentication_password:
minLength: 7
type: string
description: Not required if `authentication_type`==`authentication-none`. Include alphabetic, numeric, and special characters, but it cannot include control characters.
authentication_type:
allOf:
- $ref: '#/components/schemas/snmp_usm_user_authentication_type2'
- description: 'Authentication protocol used by this SNMPv3 USM user. enum: `authentication-md5`, `authentication-none`, `authentication-sha`, `authentication-sha224`, `authentication-sha256`, `authentication-sha384`, `authentication-sha512`.'
encryption_password:
minLength: 8
type: string
description: Not required if `encryption_type`==`privacy-none`. Include alphabetic, numeric, and special characters, but it cannot include control characters
encryption_type:
allOf:
- $ref: '#/components/schemas/snmp_usm_user_encryption_type2'
- description: 'Privacy protocol used by this SNMPv3 USM user. enum: `privacy-3des`, `privacy-aes128`, `privacy-des`, `privacy-none`.'
name:
type: string
description: Username for the SNMPv3 USM user
description: SNMPv3 USM user definition
snmp_usm_user_authentication_type:
title: snmp_usm_user_authentication_type
enum:
- authentication-md5
- authentication-none
- authentication-sha
- authentication-sha224
- authentication-sha256
- authentication-sha384
- authentication-sha512
type: string
description: 'sha224, sha256, sha384, sha512 are supported in 21.1 and newer release. enum: `authentication-md5`, `authentication-none`, `authentication-sha`, `authentication-sha224`, `authentication-sha256`, `authentication-sha384`, `authentication-sha512`'
snmp_usm_user_encryption_type:
title: snmp_usm_user_encryption_type
enum:
- privacy-3des
- privacy-aes128
- privacy-des
- privacy-none
type: string
description: 'enum: `privacy-3des`, `privacy-aes128`, `privacy-des`, `privacy-none`'
snmp_vacm:
title: snmp_vacm
type: object
properties:
access:
type: array
items:
$ref: '#/components/schemas/snmp_vacm_access_item'
description: VACM access rules for SNMPv3
security_to_group:
allOf:
- $ref: '#/components/schemas/snmp_vacm_security_to_group2'
- description: VACM security-name to group mappings
description: SNMPv3 View-based Access Control Model configuration
snmp_vacm_access_item:
title: snmp_vacm_access_item
type: object
properties:
group_name:
type: string
description: SNMP VACM group name
prefix_list:
type: array
items:
$ref: '#/components/schemas/snmp_vacm_access_item_prefix_list_item'
description: Context prefix rules for this VACM group
description: VACM access rule for an SNMP group
snmp_vacm_access_item_prefix_list_item:
title: snmp_vacm_access_item_prefix_list_item
type: object
properties:
context_prefix:
type: string
description: Context prefix for this VACM access rule. Required only if `type`==`context_prefix`
examples:
- iil
notify_view:
type: string
description: Notify view name referenced by this VACM access rule
examples:
- all
read_view:
type: string
description: Read view name referenced by this VACM access rule
examples:
- all
security_level:
allOf:
- $ref: '#/components/schemas/snmp_vacm_access_item_prefix_list_item_level2'
- description: 'Required security level for this VACM access rule. enum: `authentication`, `none`, `privacy`.'
security_model:
allOf:
- $ref: '#/components/schemas/snmp_vacm_access_item_prefix_list_item_model2'
- description: 'Required security model for this VACM access rule. enum: `any`, `usm`, `v1`, `v2c`.'
type:
allOf:
- $ref: '#/components/schemas/snmp_vacm_access_item_type2'
- description: 'VACM context matching type for this access rule. enum: `context_prefix`, `default_context_prefix`.'
write_view:
type: string
description: Write view name referenced by this VACM access rule
examples:
- all
description: Context prefix rule for a VACM access entry
snmp_vacm_access_item_prefix_list_item_level:
title: snmp_vacm_access_item_prefix_list_item_level
enum:
- authentication
- none
- privacy
type: string
description: 'enum: `authentication`, `none`, `privacy`'
snmp_vacm_access_item_prefix_list_item_model:
title: snmp_vacm_access_item_prefix_list_item_model
enum:
- any
- usm
- v1
- v2c
type: string
description: 'enum: `any`, `usm`, `v1`, `v2c`'
snmp_vacm_access_item_type:
title: snmp_vacm_access_item_type
enum:
- context_prefix
- default_context_prefix
type: string
description: 'VACM context matching type for this access rule. enum: `context_prefix`, `default_context_prefix`'
snmp_vacm_security_model:
title: snmp_vacm_security_model
enum:
- usm
- v1
- v2c
type: string
description: 'enum: `usm`, `v1`, `v2c`'
snmp_vacm_security_to_group:
title: snmp_vacm_security_to_group
type: object
properties:
content:
type: array
items:
$ref: '#/components/schemas/snmp_vacm_security_to_group_content_item'
description: VACM security-name to group mapping entries
security_model:
allOf:
- $ref: '#/components/schemas/snmp_vacm_security_model2'
- description: 'Required security model for these VACM group mappings. enum: `usm`, `v1`, `v2c`.'
description: VACM security-name to group mapping configuration
snmp_vacm_security_to_group_content_item:
title: snmp_vacm_security_to_group_content_item
type: object
properties:
group:
type: string
description: VACM group name referenced by this mapping
security_name:
type: string
description: Name of the SNMP security principal mapped to a VACM group
description: VACM security-name to group mapping entry
snmpv3_config:
title: snmpv3_config
type: object
properties:
notify:
type: array
items:
$ref: '#/components/schemas/snmpv3_config_notify_items'
description: SNMPv3 notification definitions used for traps and informs
notify_filter:
type: array
items:
$ref: '#/components/schemas/snmpv3_config_notify_filter_item'
description: SNMPv3 notification filter profiles
target_address:
type: array
items:
$ref: '#/components/schemas/snmpv3_config_target_address_item'
description: SNMPv3 notification target addresses
target_parameters:
type: array
items:
$ref: '#/components/schemas/snmpv3_config_target_param'
description: SNMPv3 target parameter profiles
usm:
type: array
items:
$ref: '#/components/schemas/snmp_usm'
description: SNMPv3 USM engine configurations
vacm:
allOf:
- $ref: '#/components/schemas/snmp_vacm2'
- description: SNMPv3 VACM access control configuration
description: SNMPv3 notification, target, USM, and VACM configuration
snmpv3_config_notify_items:
title: snmpv3_config_notify_items
type: object
properties:
name:
type: string
description: Identifier for this SNMPv3 notification definition
tag:
type: string
description: Notification tag used to select target addresses
type:
allOf:
- $ref: '#/components/schemas/snmpv3_config_notify_type2'
- description: Delivery mode for this SNMPv3 notification, such as trap or inform
description: SNMPv3 notification definition for traps or informs
snmpv3_config_notify_filter_item:
title: snmpv3_config_notify_filter_item
type: object
properties:
categories:
type: array
items:
type: string
description: CX only. List of SNMP trap group categories included in this filter profile. See https://www.juniper.net/documentation/software/topics/task/configuration/snmp-trap-groups-configuring-junos-nm.html for valid category names.
examples:
- - link
- authentication
contents:
type: array
items:
$ref: '#/components/schemas/snmpv3_config_notify_filter_item_content'
description: OID filter rules in this notification filter profile
profile_name:
type: string
description: Notification filter profile name
description: SNMPv3 notification filter profile
snmpv3_config_notify_filter_item_content:
title: snmpv3_config_notify_filter_item_content
type: object
properties:
include:
type: boolean
description: Whether the matching OID subtree is included
oid:
type: string
description: Matched OID subtree for this notification filter rule
examples:
- 1.3.6.1.4.1
description: OID filter rule for an SNMPv3 notification profile
snmpv3_config_notify_type:
title: snmpv3_config_notify_type
enum:
- inform
- trap
type: string
description: 'Delivery mode for this SNMPv3 notification, such as trap or inform. enum: `inform`, `trap`'
snmpv3_config_target_address_item:
title: snmpv3_config_target_address_item
type: object
properties:
address:
type: string
description: IP address or hostname of the SNMP target
examples:
- 10.11.0.2
address_mask:
type: string
description: Mask applied to the SNMP target address
examples:
- 255.255.255.0
port:
type:
- string
- 'null'
description: UDP port used by the SNMP target
default: '161'
tag_list:
type: string
description: Set of notification tags for this target address; use spaces between multiple tags
target_address_name:
type: string
description: Name of the SNMP target address entry
examples:
- target_address_name
target_parameters:
type: string
description: Target parameter profile referenced by this target address
description: SNMPv3 notification target address entry
snmpv3_config_target_param:
title: snmpv3_config_target_param
type: object
properties:
message_processing_model:
allOf:
- $ref: '#/components/schemas/snmpv3_config_target_param_mess_process_model2'
- description: 'SNMP message processing model used by this target parameter profile. enum: `v1`, `v2c`, `v3`.'
name:
type: string
description: Target parameter profile name
notify_filter:
type: string
description: Notification filter profile referenced by this target parameter profile
security_level:
allOf:
- $ref: '#/components/schemas/snmpv3_config_target_param_security_level2'
- description: 'Required security level for this target parameter profile. enum: `authentication`, `none`, `privacy`.'
security_model:
allOf:
- $ref: '#/components/schemas/snmpv3_config_target_param_security_model2'
- description: 'Required security model for this target parameter profile. enum: `usm`, `v1`, `v2c`.'
security_name:
type: string
description: USM security name referenced by this target parameter profile
examples:
- m01620
description: SNMPv3 target parameter profile
snmpv3_config_target_param_mess_process_model:
title: snmpv3_config_target_param_mess_process_model
enum:
- v1
- v2c
- v3
type: string
description: 'enum: `v1`, `v2c`, `v3`'
snmpv3_config_target_param_security_level:
title: snmpv3_config_target_param_security_level
enum:
- authentication
- none
- privacy
type: string
description: 'enum: `authentication`, `none`, `privacy`'
snmpv3_config_target_param_security_model:
title: snmpv3_config_target_param_security_model
enum:
- usm
- v1
- v2c
type: string
description: 'enum: `usm`, `v1`, `v2c`'
spectrum_analysis:
title: spectrum_analysis
required:
- band
type: object
properties:
band:
allOf:
- $ref: '#/components/schemas/spectrum_analysis_band2'
- description: 'Radio band to scan during spectrum analysis. enum: `24`, `5`, `6`.'
channels:
type: array
items:
type: integer
contentEncoding: int32
description: Optional list of channels to scan. If not specified, all supported channels will be scanned
examples:
- - 36
- 40
- 44
- 48
device_id:
type: string
description: Device ID of the AP that is performing spectrum analysis
contentEncoding: uuid
duration:
maximum: 600
minimum: 60
type: integer
description: Length of the spectrum analysis run, in seconds
contentEncoding: int32
default: 300
format:
allOf:
- $ref: '#/components/schemas/spectrum_analysis_format2'
- description: 'Output format for the spectrum analysis results. enum: `json`, `stream`.'
description: Request parameters for starting AP spectrum analysis at a site
spectrum_analysis_band:
title: spectrum_analysis_band
enum:
- '24'
- '5'
- '6'
type: string
description: 'Band for spectrum analysis. enum: `24`, `5`, `6`'
spectrum_analysis_format:
title: spectrum_analysis_format
enum:
- json
- stream
type: string
description: 'Format of the spectrum analysis data. enum: `json`, `stream`'
ssl_proxy_ciphers_category:
title: ssl_proxy_ciphers_category
enum:
- medium
- strong
- weak
type: string
description: 'enum: `medium`, `strong`, `weak`'
sso:
title: sso
required:
- name
type: object
properties:
created_time:
type: number
description: Time when this SSO configuration was created, in epoch seconds
readOnly: true
custom_logout_url:
type: string
description: If `idp_type`==`saml`, a URL we will redirect the user after user logout from Mist (for some IdP which supports a custom logout URL that is different from SP-initiated SLO process)
default_role:
type: string
description: If `idp_type`==`saml`, default role to assign if there’s no match. By default, an assertion is treated as invalid when there’s no role matched
domain:
type: string
description: >-
Random string generated during the SSO creation and used to generate the SAML URLs:
* ACS URL = `/api/v1/saml/{domain}/login` (e.g. `https://api.mist.com/api/v1/saml/s4t5vwv8/login`)
* Single Logout URL = `/api/v1/saml/{domain}/logout` (e.g. `https://api.mist.com/api/v1/saml/s4t5vwv8/logout`)
readOnly: true
group_filter:
type: string
description: Required if `ldap_type`==`custom`, LDAP filter that will identify the type of group
id:
type: string
description: Unique identifier for this SSO configuration
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
idp_cert:
type: string
description: If `idp_type`==`saml`. IDP Cert (used to verify the signed response)
idp_sign_algo:
allOf:
- $ref: '#/components/schemas/sso_idp_sign_algo2'
- description: 'SAML assertion signing algorithm. Required if `idp_type`==`saml`. enum: `sha1`, `sha256`, `sha384`, `sha512`.'
idp_sso_url:
type: string
description: Required if `idp_type`==`saml`, IDP Single-Sign-On URL
idp_type:
allOf:
- $ref: '#/components/schemas/sso_idp_type2'
- description: 'Identity provider type for this SSO configuration. enum: `ldap`, `mxedge_proxy`, `oauth`, `saml`, `openroaming`.'
ignore_unmatched_roles:
type: boolean
description: If `idp_type`==`saml`, ignore any unmatched roles provided in assertion. By default, an assertion is treated as invalid for any unmatched role
issuer:
type: string
description: If `idp_type`==`saml`. IDP issuer URL
ldap_base_dn:
type: string
description: Required if `idp_type`==`ldap`, whole domain or a specific organization unit (container) in Search base to specify where users and groups are found in the LDAP tree
examples:
- DC=abc,DC=com
ldap_bind_dn:
type: string
description: Required if `idp_type`==`ldap`, the account used to authenticate against the LDAP
examples:
- CN=nas,CN=users,DC=abc,DC=com
ldap_bind_password:
type: string
description: Required if `idp_type`==`ldap`, the password used to authenticate against the LDAP
examples:
- secret
ldap_cacerts:
type: array
items:
type: string
description: CA certificates used to validate LDAP or LDAPS server certificates. Required if `idp_type`==`ldap`
examples:
- - '-----BEGIN CERTIFICATE-----\nMIIFZjCCA06gAwIBAgIIP61/1qm/uDowDQYJKoZIhvcNAQELBQE\n-----END CERTIFICATE-----'
- '-----BEGIN CERTIFICATE-----\nBhMCRVMxFDASBgNVBAoMC1N0YXJ0Q29tIENBMSwwKgYDVn-----END CERTIFICATE-----'
ldap_client_cert:
type: string
description: If `idp_type`==`ldap`, LDAPS Client certificate
examples:
- '-----BEGIN CERTIFICATE-----\nMIIFZjCCA06gAwIBAgIIP61/1qm/uDowDQYJKoZIhvcNAQELBQE\n-----END CERTIFICATE-----'
ldap_client_key:
type: string
description: If `idp_type`==`ldap`, Key for the `ldap_client_cert`
examples:
- '-----BEGIN PRI...'
ldap_group_attr:
type: string
description: Group attribute used to resolve LDAP memberships. If `ldap_type`==`custom`
default: memberOf
ldap_group_dn:
type: string
description: Group search base used for custom LDAP group lookup. If `ldap_type`==`custom`
default: base_dn
ldap_resolve_groups:
type: boolean
description: If `idp_type`==`ldap`, whether to recursively resolve LDAP groups
default: false
ldap_server_hosts:
type: array
items:
type: string
description: Server hostnames or IP addresses for LDAP or LDAPS when `idp_type`==`ldap`
examples:
- - hostname
- 63.1.3.5
ldap_type:
allOf:
- $ref: '#/components/schemas/sso_ldap_type2'
- description: 'Provider template for LDAP SSO when `idp_type`==`ldap`. enum: `azure`, `custom`, `google`, `okta`.'
ldap_user_filter:
type: string
description: Required if `ldap_type`==`custom`, LDAP filter that will identify the type of user
examples:
- (mail=%s)
member_filter:
type: string
description: Required if `ldap_type`==`custom`,LDAP filter that will identify the type of member
examples:
- (CN=%s)
modified_time:
type: number
description: Time when this SSO configuration was last modified, in epoch seconds
readOnly: true
msp_id:
type: string
description: Owning MSP identifier for this SSO configuration, when MSP-scoped
contentEncoding: uuid
readOnly: true
examples:
- b9d42c2e-88ee-41f8-b798-f009ce7fe909
mxedge_proxy:
allOf:
- $ref: '#/components/schemas/sso_mxedge_proxy2'
- description: Mist Edge proxy settings used when `idp_type`==`mxedge_proxy`
name:
type: string
description: Display name of the SSO configuration
nameid_format:
allOf:
- $ref: '#/components/schemas/sso_nameid_format2'
- description: 'SAML NameID format used when `idp_type`==`saml`. enum: `email`, `unspecified`.'
oauth_cc_client_id:
type: string
description: Required if `idp_type`==`oauth`, Client Credentials
examples:
- e60da615-7def-4c5a-8196-43675f45e174
oauth_cc_client_secret:
type: string
description: Required if `idp_type`==`oauth`, oauth_cc_client_secret is RSA private key, of the form "-----BEGIN RSA PRIVATE KEY--...."
contentEncoding: password
examples:
- REDACTED_AZURE_AD_CLIENT_SECRET
oauth_discovery_url:
type: string
description: OAuth discovery document URL used when `idp_type`==`oauth`
oauth_ping_identity_region:
allOf:
- $ref: '#/components/schemas/oauth_ping_identity_region1'
- description: 'Ping Identity region for OAuth SSO when `oauth_type`==`ping_identity`. enum: `asia`, `au`, `ca`, `eu`, `us`.'
oauth_provider_domain:
allOf:
- $ref: '#/components/schemas/oauth_provider_domain1'
- description: 'Provider domain for Okta OAuth SSO when `oauth_type`==`okta`. enum: `okta.com`, `oktapreview.com`, `okta-emea.com`, `okta-gov.com`, `okta.mil`, `mtls.okta.com`.'
examples:
- okta.com
oauth_ropc_client_id:
type: string
description: If `idp_type`==`oauth`, ropc = Resource Owner Password Credentials
examples:
- 9ce04c97-b5b1-4ec8-af17-f5ed42d2daf7
oauth_ropc_client_secret:
type: string
description: If `oauth_type`==`azure` or `oauth_type`==`azure-gov`. oauth_ropc_client_secret can be empty
contentEncoding: password
examples:
- blM9R~6kWFMVFYl4TFZ3fi~8cMdyDONi6cj01dqI
oauth_tenant_id:
type: string
description: Required if `idp_type`==`oauth`, oauth_tenant_id
examples:
- dev-88336535
oauth_type:
allOf:
- $ref: '#/components/schemas/sso_oauth_type2'
- description: 'Provider type for OAuth SSO when `idp_type`==`oauth`. enum: `azure`, `azure-gov`, `okta`, `ping_identity`.'
openroaming_ssids:
type: array
items:
type: string
description: SSIDs that support OpenRoaming, used when `idp_type`==`openroaming`
examples:
- - ssid_name1
- ssid_name2
openroaming_wba_client_cert:
type: string
description: Optional WBA-issued client certificate for OpenRoaming. If not provided, the default WBA-issued certificate for Juniper will be used.
contentEncoding: password
examples:
- '-----BEGIN CERTIFICATE-----\nMIIFZjCCA06gAwIBAgIIP61/1qm/uDowDQYJKoZIhvcNAQELBQE\n-----END CERTIFICATE-----'
openroaming_wba_client_key:
type: string
description: Optional WBA-issued client private key for OpenRoaming. If not provided, the default WBA-issued key for Juniper will be used.
contentEncoding: password
examples:
- 'REDACTED_PRIVATE_KEY_EXAMPLE'
org_id:
type: string
description: Owning organization identifier for this SSO configuration
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
role_attr_extraction:
type: string
description: If `idp_type`==`saml`, custom role attribute parsing scheme. Supported Role Parsing Schemes | Name | Scheme |
|---|
| `cn` | - The expected role attribute format in SAML Assertion is "CN=cn,OU=ou1,OU=ou2,…"
- CN (the key) is case-insensitive and exactly 1 CN is expected (or the entire entry will be ignored)
E.g. if role attribute is "CN=cn,OU=ou1,OU=ou2" then parsed role value is "cn" |
role_attr_from:
type: string
description: If `idp_type`==`saml`, name of the attribute in SAML Assertion to extract role from
default: Role
scim_enabled:
type: boolean
description: If `idp_type`==`oauth`, indicates if SCIM provisioning is enabled for the OAuth IDP
default: false
scim_secret_token:
type: string
description: If `idp_type`==`oauth`, scim_secret_token (auto-generated when not provided by caller and `scim_enabled`==`true`, empty string when `scim_enabled`==`false`) is used as the Bearer token in the Authorization header of SCIM provisioning requests by the IDP
contentEncoding: password
examples:
- FBitbKPE1aecSloPGBuqqPxDUrFeZyZk
site_id:
type: string
description: Associated site identifier for this SSO configuration, when site-scoped
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
description: Single sign-on identity provider configuration
sso_delete_admins:
title: sso_delete_admins
required:
- emails
type: object
properties:
emails:
type: array
items:
type: string
description: List of admin email addresses to delete
description: Request body listing SSO admin email addresses to delete
sso_delete_admins_response:
title: sso_delete_admins_response
type: object
properties:
deleted:
type: array
items:
type: string
description: List of email addresses that were successfully deleted
errors:
type: array
items:
type: string
description: List of error messages for emails that could not be deleted
description: Result of deleting SSO admin accounts
sso_idp_sign_algo:
title: sso_idp_sign_algo
enum:
- sha1
- sha256
- sha384
- sha512
type: string
description: 'Required if `idp_type`==`saml`, Signing algorithm for SAML Assertion. enum: `sha1`, `sha256`, `sha384`, `sha512`'
sso_idp_type:
title: sso_idp_type
enum:
- ldap
- mxedge_proxy
- oauth
- saml
- openroaming
type: string
description: >-
SSO IDP Type:
* For Admin SSO, enum: `saml`
* For NAC SSO, enum: `ldap`, `mxedge_proxy`, `oauth`, `openroaming`
sso_ldap_type:
title: sso_ldap_type
enum:
- azure
- custom
- google
- okta
type: string
description: 'if `idp_type`==`ldap`. enum: `azure`, `custom`, `google`, `okta`, `ping_identity`'
sso_mxedge_proxy:
title: sso_mxedge_proxy
type: object
properties:
acct_servers:
type: array
items:
$ref: '#/components/schemas/sso_mxedge_proxy_acct_server'
description: RADIUS accounting servers used by the Mist Edge SSO proxy
auth_servers:
type: array
items:
$ref: '#/components/schemas/sso_mxedge_proxy_auth_server'
description: RADIUS authentication servers used by the Mist Edge SSO proxy
mxcluster_id:
type: string
description: Mist Edge cluster identifier that provides the SSO proxy
contentEncoding: uuid
examples:
- 572586b7-f97b-a22b-526c-8b97a3f609c4
operator_name:
type: string
description: Operator name as RADIUS attribute while proxying
proxy_hosts:
type: array
items:
type: string
description: Public hostnames or IP addresses that clients use to reach the Mist Edge SSO proxy
examples:
- - mxedge1.corp.com
- 63.1.3.5
ssids:
type: array
items:
type: string
description: Eduroam SSIDs handled by the Mist Edge SSO proxy
examples:
- - eduroam_test, eduroam_main
description: Mist Edge proxy settings for NAC SSO. If `idp_type`==`mxedge_proxy`, this requires `mist_nac` to be enabled on the mxcluster
sso_mxedge_proxy_acct_server:
title: sso_mxedge_proxy_acct_server
type: object
properties:
host:
type: string
description: RADIUS accounting server hostname or IP address
examples:
- 1.2.3.4
port:
type: integer
description: UDP port for RADIUS accounting requests
contentEncoding: int32
default: 1813
secret:
type: string
description: Shared secret used with the RADIUS accounting server
contentEncoding: password
examples:
- testing123
description: RADIUS accounting server for the Mist Edge SSO proxy
sso_mxedge_proxy_auth_server:
title: sso_mxedge_proxy_auth_server
type: object
properties:
host:
type: string
description: RADIUS authentication server hostname or IP address
examples:
- 1.2.3.4
port:
type: integer
description: UDP port for RADIUS authentication requests
contentEncoding: int32
default: 1812
require_message_authenticator:
type: boolean
description: Whether to require Message-Authenticator in requests
default: false
retry:
type: integer
description: Number of retry attempts for RADIUS authentication requests
contentEncoding: int32
default: 2
secret:
type: string
description: Shared secret used with the RADIUS authentication server
contentEncoding: password
examples:
- testing123
timeout:
type: integer
description: Authentication request timeout, in seconds
contentEncoding: int32
default: 5
description: RADIUS authentication server for the Mist Edge SSO proxy
sso_nameid_format:
title: sso_nameid_format
enum:
- email
- unspecified
type: string
description: 'if `idp_type`==`saml`. enum: `email`, `unspecified`'
sso_oauth_type:
title: sso_oauth_type
enum:
- azure
- azure-gov
- okta
- ping_identity
type: string
description: 'if `idp_type`==`oauth`. enum: `azure`, `azure-gov`, `okta`, `ping_identity`'
sso_openroaming:
title: sso_openroaming
type: object
properties:
ssids:
type: array
items:
type: string
description: Network SSID names enabled for OpenRoaming SSO
examples:
- - ssid_name1
- ssid_name2
wba_cert:
type: string
description: Deprecated. Use `openroaming_wba_client_cert` instead.
deprecated: true
description: 'Deprecated. OpenRoaming configuration is now expressed as top-level fields on the SSO object: `openroaming_ssids`, `openroaming_wba_client_cert`, and `openroaming_wba_client_key`.'
deprecated: true
sso_role_msp:
title: sso_role_msp
required:
- name
- privileges
type: object
properties:
created_time:
type: number
description: Time when this MSP SSO role was created, in epoch seconds
readOnly: true
for_site:
type: boolean
description: Whether this MSP SSO role is scoped for site-level access
readOnly: true
id:
type: string
description: Unique identifier for this MSP SSO role
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
modified_time:
type: number
description: Time when this MSP SSO role was last modified, in epoch seconds
readOnly: true
msp_id:
type: string
description: Owning MSP identifier for this SSO role
contentEncoding: uuid
readOnly: true
examples:
- b9d42c2e-88ee-41f8-b798-f009ce7fe909
name:
type: string
description: Display name of the MSP SSO role
org_id:
type: string
description: Organization identifier associated with this MSP SSO role, when applicable
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
privileges:
minItems: 1
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/privilege_msp'
description: Access privileges granted by this MSP SSO role
description: MSP SSO role definition
sso_role_org:
title: sso_role_org
required:
- name
- privileges
type: object
properties:
created_time:
type: number
description: Time when this organization SSO role was created, in epoch seconds
readOnly: true
for_site:
type: boolean
description: Whether this organization SSO role is scoped for site-level access
readOnly: true
id:
type: string
description: Unique identifier for this organization SSO role
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
modified_time:
type: number
description: Time when this organization SSO role was last modified, in epoch seconds
readOnly: true
msp_id:
type: string
description: Managing MSP identifier for this organization SSO role, when applicable
contentEncoding: uuid
readOnly: true
examples:
- b9d42c2e-88ee-41f8-b798-f009ce7fe909
name:
type: string
description: Display name of the organization SSO role
org_id:
type: string
description: Owning organization identifier for this SSO role
contentEncoding: uuid
examples:
- 60f6bfdb-2f45-4022-8e2a-e00d977953fe
privileges:
minItems: 1
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/privilege_org'
description: Access privileges granted by this organization SSO role
description: Organization SSO role definition
ssr_proxy:
title: ssr_proxy
type: object
properties:
disabled:
type: boolean
description: Whether the SSR proxy configuration is disabled
default: false
examples:
- true
url:
type: string
description: Proxy URL that SSR devices use to reach Mist
examples:
- https://proxy.corp.com:8080/
description: SSR proxy configuration to talk to Mist
ssr_upgrade:
title: ssr_upgrade
required:
- version
type: object
properties:
channel:
allOf:
- $ref: '#/components/schemas/ssr_upgrade_channel1'
- description: 'Firmware release channel to use for the SSR upgrade. enum: `alpha`, `beta`, `stable`.'
force:
type: boolean
description: When true, forces the upgrade even when the requested version matches the currently running version; default is false
default: false
reboot_at:
type: integer
description: Reboot start time in epoch seconds, default is start_time, -1 disables reboot
contentEncoding: int32
start_time:
type: integer
description: 128T firmware download start time in epoch seconds, default is now, -1 disables download
contentEncoding: int32
version:
minLength: 1
type: string
description: 128T firmware version to upgrade (e.g. 5.3.0-93)
description: Request to upgrade a single SSR device
ssr_upgrade_channel:
title: ssr_upgrade_channel
enum:
- alpha
- beta
- stable
type: string
description: 'upgrade channel to follow. enum: `alpha`, `beta`, `stable`'
ssr_upgrade_multi:
title: ssr_upgrade_multi
required:
- device_ids
type: object
properties:
channel:
allOf:
- $ref: '#/components/schemas/ssr_upgrade_channel1'
- description: 'Firmware release channel to use for the SSR upgrade. enum: `alpha`, `beta`, `stable`.'
device_ids:
type: array
items:
type: string
contentEncoding: uuid
description: List of 128T device IDs to upgrade; currently only one 128T device is allowed
force:
type: boolean
description: When true, forces the upgrade even when the requested version matches the currently running version; default is false
default: false
reboot_at:
type: integer
description: Reboot start time in epoch seconds, default is start_time, -1 disables reboot
contentEncoding: int32
start_time:
type: integer
description: 128T firmware download start time in epoch seconds, default is now, -1 disables download
contentEncoding: int32
strategy:
allOf:
- $ref: '#/components/schemas/ssr_upgrade_strategy2'
- description: 'Upgrade rollout strategy for the targeted SSR devices. enum: `big_bang`, `serial`.'
version:
minLength: 1
type: string
description: 128T firmware version to upgrade (e.g. 5.3.0-93)
description: Request to upgrade multiple SSR devices
ssr_upgrade_strategy:
title: ssr_upgrade_strategy
enum:
- big_bang
- serial
type: string
description: >-
enum:
* `big_bang`: upgrade all at once
* `serial`: one at a time
ssr_version:
title: ssr_version
required:
- package
- version
type: object
properties:
default:
type: boolean
description: Whether this is the default SSR firmware version for its channel
readOnly: true
package:
type: string
description: Firmware package name for this SSR version
readOnly: true
tags:
uniqueItems: true
type: array
items:
type: string
description: Metadata labels associated with this SSR firmware version
version:
type: string
description: Firmware version string available for SSR upgrades
readOnly: true
description: SSR firmware version available for upgrade
ssr_version_channel:
title: ssr_version_channel
enum:
- alpha
- beta
- stable
type: string
description: 'enum: `stable`, `beta`, `alpha`'
stat_device_status_filter:
title: stat_device_status_filter
enum:
- all
- connected
- disconnected
type: string
description: 'enum: `all`, `connected`, `disconnected`'
stats_ap:
title: stats_ap
required:
- type
type: object
properties:
antenna_select:
allOf:
- $ref: '#/components/schemas/antenna_select2'
- description: 'Selectable antenna mode reported for the AP. enum: ``, `external`, `internal`.'
examples:
- external
auto_placement:
allOf:
- $ref: '#/components/schemas/stats_ap_auto_placement2'
- description: Auto placement result and status for the AP
auto_upgrade_stat:
allOf:
- $ref: '#/components/schemas/stats_ap_auto_upgrade4'
- description: Automatic firmware upgrade status for the AP
ble_stat:
allOf:
- $ref: '#/components/schemas/stats_ap_ble2'
- description: BLE radio and beacon statistics reported by the AP
cert_expiry:
type:
- number
- 'null'
description: Certificate expiry timestamp for the AP, in epoch seconds
readOnly: true
examples:
- 1534534392
config_reverted:
type:
- boolean
- 'null'
description: Whether the AP configuration was reverted by the device
readOnly: true
cpu_system:
type:
- integer
- 'null'
description: CPU system utilization reported by the AP
contentEncoding: int64
readOnly: true
cpu_user:
type:
- integer
- 'null'
description: CPU user utilization reported by the AP
contentEncoding: int32
readOnly: true
cpu_util:
type:
- integer
- 'null'
description: Total CPU utilization reported by the AP
contentEncoding: int32
readOnly: true
created_time:
type: number
description: Time when the AP record was created, in epoch seconds
readOnly: true
deviceprofile_id:
type:
- string
- 'null'
description: Device profile identifier applied to the AP, when present
contentEncoding: uuid
readOnly: true
env_stat:
allOf:
- $ref: '#/components/schemas/stats_ap_env_stat2'
- description: Environmental sensor readings reported by the AP
esl_stat:
allOf:
- oneOf:
- {}
- $ref: '#/components/schemas/stats_ap_esl_stat2'
- description: Electronic shelf label dongle status reported by the AP
readOnly: true
evpntopo_id:
type:
- string
- 'null'
description: EVPN topology identifier associated with the AP, when present
contentEncoding: uuid
readOnly: true
expiring_certs:
type: object
additionalProperties:
type: integer
format: int32
description: Certificates on the AP that are expiring within 30 days
ext_ip:
type:
- string
- 'null'
description: Public IP address observed for the AP
readOnly: true
examples:
- 73.92.124.103
fwupdate:
allOf:
- $ref: '#/components/schemas/fwupdate_stat2'
- description: Firmware update status for the AP
gps_stat:
allOf:
- $ref: '#/components/schemas/stats_ap_gps_stat2'
- description: GPS location data reported for the AP
hw_rev:
type:
- string
- 'null'
description: Hardware revision reported by the AP
readOnly: true
id:
type: string
description: Unique identifier for the AP
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
inactive_wired_vlans:
type: array
items:
type: integer
contentEncoding: int32
description: Wired VLAN identifiers currently inactive on the AP
iot_stat:
type: object
additionalProperties:
$ref: '#/components/schemas/stats_ap_iot_stat_additional_properties'
description: IoT input statistics reported by the AP
examples:
- DI2:
value: 0
ip:
type:
- string
- 'null'
description: Management IP address currently reported by the AP
readOnly: true
examples:
- 10.2.9.159
ip_config:
allOf:
- $ref: '#/components/schemas/ap_ip_config3'
- description: IP configuration applied to the AP management interface
ip_stat:
allOf:
- $ref: '#/components/schemas/ip_stat1'
- description: Read-only IP addressing status reported by the AP
l2tp_stat:
type: object
additionalProperties:
$ref: '#/components/schemas/stats_ap_l2tp_stat'
description: L2TP tunnel status (key is the wxtunnel_id)
last_seen:
type:
- number
- 'null'
description: Time when the AP was last seen by Mist, in epoch seconds
readOnly: true
examples:
- 1470417522
last_trouble:
allOf:
- $ref: '#/components/schemas/last_trouble1'
- description: Most recent AP trouble indicator and timestamp
led:
allOf:
- $ref: '#/components/schemas/ap_led4'
- description: Light indicator state for the AP
lldp_stat:
allOf:
- $ref: '#/components/schemas/stats_ap_lldp_stat2'
- description: Primary LLDP neighbor and power negotiation details for the AP
lldp_stats:
type: object
additionalProperties:
$ref: '#/components/schemas/stats_ap_lldp_stat'
description: Per-port LLDP neighbor and power negotiation details for the AP
locating:
type:
- boolean
- 'null'
description: Whether AP locating mode is currently active
readOnly: true
examples:
- false
locked:
type:
- boolean
- 'null'
description: Whether this AP is considered locked (placement / orientation has been vetted)
readOnly: true
examples:
- true
mac:
type:
- string
- 'null'
description: AP MAC address reported by Mist
readOnly: true
examples:
- 5c5b35000010
map_id:
type:
- string
- 'null'
description: Map identifier where the AP is placed, when available
contentEncoding: uuid
readOnly: true
examples:
- 63eda950-c6da-11e4-a628-60f81dd250cc
mem_total_kb:
type:
- integer
- 'null'
description: Total memory available on the AP, in kilobytes
contentEncoding: int64
readOnly: true
mem_used_kb:
type:
- integer
- 'null'
description: Memory currently used on the AP, in kilobytes
contentEncoding: int64
readOnly: true
mesh_downlinks:
type: object
additionalProperties:
$ref: '#/components/schemas/ap_stat_mesh_downlink'
description: Property key is the mesh downlink id (e.g. `00000000-0000-0000-1000-5c5b35000010`)
mesh_uplink:
allOf:
- $ref: '#/components/schemas/ap_stat_mesh_uplink1'
- description: Mesh uplink status for the AP
model:
type:
- string
- 'null'
description: AP model identifier reported by Mist
readOnly: true
examples:
- AP200
modified_time:
type: number
description: Time when the AP record was last modified, in epoch seconds
readOnly: true
mount:
type:
- string
- 'null'
description: Orientation configured for the AP mount
readOnly: true
examples:
- faceup
name:
type:
- string
- 'null'
description: Display name of the AP
readOnly: true
examples:
- conference room
notes:
type:
- string
- 'null'
description: Free-form notes configured on the AP record
readOnly: true
num_clients:
type:
- integer
- 'null'
description: How many wireless clients are currently connected
contentEncoding: int32
readOnly: true
num_wlans:
type: integer
description: How many WLANs are applied to the device
contentEncoding: int32
org_id:
type: string
description: Organization identifier that owns the AP
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
port_stat:
type:
- object
- 'null'
additionalProperties:
$ref: '#/components/schemas/stats_ap_port_stat'
description: Property key is the port name (e.g. `eth0`)
readOnly: true
power_budget:
type:
- integer
- 'null'
description: In mW, surplus if positive or deficit if negative
contentEncoding: int32
readOnly: true
examples:
- 1000
power_constrained:
type:
- boolean
- 'null'
description: Whether the AP is operating with insufficient power
readOnly: true
examples:
- false
power_opmode:
type:
- string
- 'null'
description: Operating mode used while AP power is constrained
readOnly: true
examples:
- '[20] 6GHz(2x2) 5GHz(4x4) 2.4GHz(2x2).'
power_src:
type:
- string
- 'null'
description: DC Input / PoE 802.3at / PoE 802.3af / LLDP / ? (unknown)
readOnly: true
examples:
- PoE 802.3af
radio_config:
allOf:
- $ref: '#/components/schemas/stats_ap_radio_config2'
- description: Radio configuration currently applied to the AP
radio_stat:
allOf:
- $ref: '#/components/schemas/stats_ap_radio_stat2'
- description: Radio statistics reported by AP bands
rx_bps:
type:
- integer
- 'null'
description: Receive throughput for AP traffic, in bits per second
contentEncoding: int64
readOnly: true
examples:
- 60003
rx_bytes:
type:
- integer
- 'null'
description: Total bytes received by the AP since connection
contentEncoding: int64
readOnly: true
examples:
- 8515104416
rx_pkts:
type:
- integer
- 'null'
description: Total packets received by the AP since connection
contentEncoding: int64
readOnly: true
examples:
- 57770567
serial:
type:
- string
- 'null'
description: Device serial number for the AP
readOnly: true
examples:
- FXLH2015170017
site_id:
type: string
description: Site identifier where the AP is assigned
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
status:
type:
- string
- 'null'
description: Connection status reported for the AP
readOnly: true
switch_redundancy:
allOf:
- $ref: '#/components/schemas/stats_ap_switch_redundancy2'
- description: Switch redundancy status reported for the AP
tx_bps:
type:
- integer
- 'null'
description: Transmit throughput for AP traffic, in bits per second
contentEncoding: int64
readOnly: true
examples:
- 634301
tx_bytes:
type:
- integer
- 'null'
description: Total bytes transmitted by the AP since connection
contentEncoding: int64
readOnly: true
examples:
- 211217389682
tx_pkts:
type:
- integer
- 'null'
description: Total packets transmitted by the AP since connection
contentEncoding: int64
readOnly: true
examples:
- 812204062
type:
const: ap
type: string
description: 'Device type for this statistics record. enum: `ap`.'
readOnly: true
uptime:
type:
- number
- 'null'
description: How long, in seconds, has the device been up (or rebooted)
readOnly: true
examples:
- 13500
usb_stat:
allOf:
- $ref: '#/components/schemas/stats_ap_usb_stat2'
- description: USB peripheral status reported by the AP
version:
type:
- string
- 'null'
description: Firmware version running on the AP
readOnly: true
examples:
- 0.14.12345
x:
type:
- number
- 'null'
description: Map X coordinate of the AP placement, in pixels
readOnly: true
examples:
- 53.5
y:
type:
- number
- 'null'
description: Map Y coordinate of the AP placement, in pixels
readOnly: true
examples:
- 173.1
zigbee_stat:
allOf:
- $ref: '#/components/schemas/stats_ap_zigbee_stat2'
- description: ZigBee statistics reported by the AP, present only when ZigBee is enabled on the AP
description: AP runtime statistics, placement data, and inventory metadata
stats_ap_auto_placement:
title: stats_ap_auto_placement
type: object
properties:
info:
allOf:
- $ref: '#/components/schemas/stats_ap_auto_placement_info2'
- description: Additional diagnostics for the AP auto placement result
recommended_anchor:
type: boolean
description: Flag to represent if AP is recommended as an anchor by auto placement service
status:
type: string
description: Current auto placement status for the AP
examples:
- localized
status_detail:
type: string
description: Additional info about placement status
examples:
- localized
x:
type: number
description: Auto-placed X coordinate, in pixels
examples:
- 53.5
x_m:
type: number
description: Auto-placed X coordinate, in meters
examples:
- 5.35
y:
type: number
description: Auto-placed Y coordinate, in pixels
examples:
- 173.1
y_m:
type: number
description: Auto-placed Y coordinate, in meters
examples:
- 17.31
description: Auto placement result and status for an AP
stats_ap_auto_placement_info:
title: stats_ap_auto_placement_info
type: object
properties:
cluster_number:
type: integer
description: All APs sharing a given cluster number can be placed relative to each other
contentEncoding: int32
examples:
- 0
orientation_stats:
type: integer
description: The orientation of an AP
contentEncoding: int32
examples:
- 0
probability_surface:
allOf:
- $ref: '#/components/schemas/stats_ap_auto_placement_info_probability_surface2'
- description: Uncertainty area for the AP auto placement result
description: Additional diagnostics for AP auto placement
stats_ap_auto_placement_info_probability_surface:
title: stats_ap_auto_placement_info_probability_surface
type: object
properties:
radius:
type: number
description: The RADIUS representing placement uncertainty, measured in pixels
examples:
- 2.1
radius_m:
type: number
description: The RADIUS representing placement uncertainty, measured in meters
x:
type: number
description: Potential placement center X coordinate, in pixels
examples:
- 17
description: Circular uncertainty area for an AP auto placement result
stats_ap_auto_upgrade:
title: stats_ap_auto_upgrade
type: object
properties:
lastcheck:
type:
- integer
- 'null'
description: Time when the AP last checked for auto-upgrade, in epoch seconds
contentEncoding: int64
readOnly: true
examples:
- 1720594762
description: Auto-upgrade status for an AP
stats_ap_ble:
title: stats_ap_ble
type: object
properties:
beacon_enabled:
type:
- boolean
- 'null'
description: Whether Mist BLE beacon transmission is enabled
readOnly: true
beacon_rate:
type:
- integer
- 'null'
description: Mist BLE beacon transmit rate, in beacons per second
contentEncoding: int32
readOnly: true
examples:
- 3
eddystone_uid_enabled:
type:
- boolean
- 'null'
description: Whether Eddystone-UID beacon transmission is enabled
readOnly: true
examples:
- false
eddystone_uid_freq_msec:
type:
- integer
- 'null'
description: Interval for Eddystone-UID advertisements, in milliseconds
contentEncoding: int32
readOnly: true
examples:
- 2000
eddystone_uid_instance:
type:
- string
- 'null'
description: Eddystone-UID instance value broadcast by the AP
readOnly: true
examples:
- 5c5b35000001
eddystone_uid_namespace:
type:
- string
- 'null'
description: Eddystone-UID namespace value broadcast by the AP
readOnly: true
examples:
- 2818e3868dec25629ede
eddystone_url_enabled:
type:
- boolean
- 'null'
description: Whether Eddystone-URL beacon transmission is enabled
readOnly: true
examples:
- true
eddystone_url_freq_msec:
type:
- integer
- 'null'
description: Interval for Eddystone-URL advertisements, in milliseconds
contentEncoding: int32
readOnly: true
examples:
- 100
eddystone_url_url:
type:
- string
- 'null'
description: URL broadcast by the Eddystone-URL beacon
readOnly: true
examples:
- https://www.abc.com
ibeacon_enabled:
type:
- boolean
- 'null'
description: Whether iBeacon transmission is enabled
readOnly: true
examples:
- true
ibeacon_freq_msec:
type:
- integer
- 'null'
description: Interval for iBeacon advertisements, in milliseconds
contentEncoding: int32
readOnly: true
examples:
- 2000
ibeacon_major:
maximum: 65535
minimum: 1
type:
- integer
- 'null'
description: Major value broadcast in iBeacon advertisements
contentEncoding: int32
examples:
- 1234
ibeacon_minor:
maximum: 65535
minimum: 1
type:
- integer
- 'null'
description: Minor value broadcast in iBeacon advertisements
contentEncoding: int32
examples:
- 1234
ibeacon_uuid:
type:
- string
- 'null'
description: UUID value broadcast in iBeacon advertisements
contentEncoding: uuid
examples:
- f3f17139-704a-f03a-2786-0400279e37c3
major:
type:
- integer
- 'null'
description: Reported iBeacon major value for BLE statistics
contentEncoding: int32
readOnly: true
examples:
- 12345
minors:
type: array
items:
type: integer
contentEncoding: int32
description: Reported iBeacon minor values for BLE statistics
power:
type:
- integer
- 'null'
description: BLE transmit power setting reported by the AP
contentEncoding: int32
readOnly: true
examples:
- 10
rx_bytes:
type:
- integer
- 'null'
description: BLE bytes received by the AP
contentEncoding: int64
readOnly: true
examples:
- 8515104416
rx_pkts:
type:
- integer
- 'null'
description: BLE packets received by the AP
contentEncoding: int64
readOnly: true
examples:
- 57770567
tx_bytes:
type:
- integer
- 'null'
description: BLE bytes transmitted by the AP
contentEncoding: int64
readOnly: true
examples:
- 211217389682
tx_pkts:
type:
- integer
- 'null'
description: BLE packets transmitted by the AP
contentEncoding: int64
readOnly: true
examples:
- 812204062
tx_resets:
type:
- integer
- 'null'
description: Resets due to tx hung
contentEncoding: int32
readOnly: true
examples:
- 0
uuid:
type:
- string
- 'null'
description: Beacon UUID reported by BLE statistics
contentEncoding: uuid
readOnly: true
examples:
- ada72f8f-1643-e5c6-94db-f2a5636f1a64
description: BLE beacon and traffic statistics reported by an AP
stats_ap_env_stat:
title: stats_ap_env_stat
type: object
properties:
accel_x:
type:
- number
- 'null'
description: X-axis accelerometer reading reported by the AP
readOnly: true
examples:
- 0
accel_y:
type:
- number
- 'null'
description: Y-axis accelerometer reading reported by the AP
readOnly: true
examples:
- 0.032
accel_z:
type:
- number
- 'null'
description: Z-axis accelerometer reading reported by the AP
readOnly: true
examples:
- -1.088
ambient_temp:
type:
- integer
- 'null'
description: Temperature reading from the AP ambient sensor
contentEncoding: int32
readOnly: true
examples:
- 43
attitude:
type:
- integer
- 'null'
description: Device attitude or orientation reading reported by the AP
contentEncoding: int32
readOnly: true
examples:
- 0
cpu_temp:
type:
- integer
- 'null'
description: Temperature reading from the AP CPU sensor
contentEncoding: int32
readOnly: true
examples:
- 61
humidity:
type:
- integer
- 'null'
description: Relative humidity sensor reading reported by the AP
contentEncoding: int32
readOnly: true
examples:
- 9
magne_x:
type:
- number
- 'null'
description: X-axis magnetometer reading reported by the AP
readOnly: true
examples:
- 0
magne_y:
type:
- number
- 'null'
description: Y-axis magnetometer reading reported by the AP
readOnly: true
examples:
- 0
magne_z:
type:
- number
- 'null'
description: Z-axis magnetometer reading reported by the AP
readOnly: true
examples:
- 0
pressure:
type:
- number
- 'null'
description: Barometric pressure sensor reading reported by the AP
readOnly: true
examples:
- 968
vcore_voltage:
type:
- integer
- 'null'
description: Core voltage sensor reading reported by the AP
contentEncoding: int32
readOnly: true
examples:
- 0
description: Device environment, including CPU temperature, Ambient temperature, Humidity, Attitude, Pressure, Accelerometers, Magnetometers and vCore Voltage
stats_ap_esl_stat:
title: stats_ap_esl_stat
type: object
properties:
channel:
type:
- integer
- 'null'
description: Radio channel used by the ESL dongle
contentEncoding: int32
readOnly: true
connected:
type:
- boolean
- 'null'
description: Whether the ESL dongle is connected
readOnly: true
ip:
type:
- string
- 'null'
description: Network IP address of Hanshow and SoluM dongles
readOnly: true
examples:
- 172.16.2.249
mac:
type:
- string
- 'null'
description: Dongle MAC address for Hanshow and SoluM dongles
readOnly: true
examples:
- 98-6d-35-79-76-3b
product_id:
type:
- string
- 'null'
description: Product ID of Hanshow and SoluM dongles
readOnly: true
examples:
- A4A2
type:
type:
- string
- 'null'
description: ESL dongle type reported by the AP
readOnly: true
examples:
- imagotag
up:
type:
- boolean
- 'null'
description: Whether the ESL dongle is operational
readOnly: true
vendor_id:
type:
- string
- 'null'
description: Vendor ID of Hanshow and SoluM dongles
readOnly: true
examples:
- '0525'
description: Electronic shelf label dongle status reported by an AP
stats_ap_gps_stat:
title: stats_ap_gps_stat
type: object
properties:
accuracy:
type: number
description: The estimated accuracy or accuracy of the GPS coordinates, measured in meters.
examples:
- 12.5
altitude:
type: number
description: The elevation of the AP above sea level, measured in meters.
examples:
- 99.939
latitude:
type: number
description: The geographic latitude of the AP, measured in degrees.
examples:
- 37.29548
longitude:
type: number
description: The geographic longitude of the AP, measured in degrees.
examples:
- -122.03304
src:
allOf:
- $ref: '#/components/schemas/stats_ap_gps_stat_src2'
- description: 'Source of the GPS location data. enum: `gps`, `other_ap`, `other_aps`.'
timestamp:
type: number
description: Time when the GPS location data was observed, in epoch seconds
readOnly: true
description: GPS location data reported by an AP
stats_ap_gps_stat_src:
title: stats_ap_gps_stat_src
enum:
- gps
- other_ap
- other_aps
type: string
description: 'The origin of the GPS data. enum: `gps`: from this device GPS estimates, `other_aps` from neighboring devices GPS estimates. Note: API responses may return `other_aps` which should be treated as `other_ap`'
stats_ap_iot_stat_additional_properties:
title: stats_ap_iot_stat_additional_properties
type: object
properties:
value:
type:
- integer
- 'null'
description: Reported value for this IoT input
contentEncoding: int32
readOnly: true
description: IoT input statistic value
stats_ap_l2tp_stat:
title: stats_ap_l2tp_stat
type: object
properties:
sessions:
type: array
items:
$ref: '#/components/schemas/stats_ap_l2tp_stat_session'
description: L2TP session entries for this tunnel
state:
allOf:
- $ref: '#/components/schemas/l2tp_state2'
- description: 'L2TP tunnel state reported by the AP. enum: `established`, `established_with_session`, `idle`, `wait-ctrl-conn`, `wait-ctrl-reply`.'
examples:
- established
uptime:
type:
- integer
- 'null'
description: Tunnel uptime, in seconds
contentEncoding: int32
readOnly: true
examples:
- 135
wxtunnel_id:
type:
- string
- 'null'
description: Identifier of the associated WxLAN tunnel
contentEncoding: uuid
readOnly: true
examples:
- 7dae216d-7c98-a51b-e068-dd7d477b7216
description: L2TP tunnel status reported by an AP
stats_ap_l2tp_stat_session:
title: stats_ap_l2tp_stat_session
type: object
properties:
local_sid:
type:
- integer
- 'null'
description: Local L2TP session identifier for this tunnel session
contentEncoding: int32
readOnly: true
examples:
- 31
remote_id:
type:
- string
- 'null'
description: User-configured remote identifier for the WxLAN tunnel
readOnly: true
examples:
- vpn1
remote_sid:
type:
- integer
- 'null'
description: Remote L2TP session identifier for this tunnel session
contentEncoding: int32
readOnly: true
examples:
- 13
state:
allOf:
- $ref: '#/components/schemas/l2tp_state1'
- description: 'L2TP session state reported by the AP. enum: `established`, `established_with_session`, `idle`, `wait-ctrl-conn`, `wait-ctrl-reply`.'
examples:
- established
description: L2TP tunnel session reported by an AP
stats_ap_lldp_stat:
title: stats_ap_lldp_stat
type: object
properties:
chassis_id:
type:
- string
- 'null'
description: LLDP neighbor chassis identifier
readOnly: true
lldp_med_supported:
type:
- boolean
- 'null'
description: Whether it support LLDP-MED
readOnly: true
mgmt_addr:
type:
- string
- 'null'
description: Management IP address of the switch
readOnly: true
mgmt_addrs:
type: array
items:
type: string
description: Management IP addresses advertised by the LLDP neighbor
port_desc:
type:
- string
- 'null'
description: Port description, e.g. “2/20”, “Port 2 on Switch0”
readOnly: true
examples:
- 2/20
port_id:
type:
- string
- 'null'
description: LLDP neighbor port identifier
readOnly: true
examples:
- ge-0/0/4
power_allocated:
type:
- number
- 'null'
description: In mW, power allocated by PSE
readOnly: true
power_avail:
type: integer
description: In mW, total Power Avail at AP from pwr source
contentEncoding: int32
power_budget:
type: integer
description: In mW, surplus if positive or deficit if negative
contentEncoding: int32
power_constrained:
type: boolean
description: Whether power is insufficient
power_draw:
type:
- number
- 'null'
description: In mW, total power needed by PD
readOnly: true
power_needed:
type: integer
description: In mW, total Power needed incl Peripherals
contentEncoding: int32
power_opmode:
type: string
description: Power operating mode negotiated through LLDP
power_request_count:
type:
- integer
- 'null'
description: Number of negotiations, if it keeps increasing, we don’ t have a stable power
contentEncoding: int32
readOnly: true
power_requested:
type:
- number
- 'null'
description: In mW, power requested by PD
readOnly: true
power_src:
type: string
description: Primary AP power source reported through LLDP
power_srcs:
type: array
items:
type: string
description: AP power sources reported through LLDP
system_desc:
type:
- string
- 'null'
description: Description provided by switch
readOnly: true
examples:
- 'uniper Networks, Inc. ex4300-48t internet router, kernel JUNOS 20.4R3-S7.2, Build date: 2023-04-21 19:47:18 UTC Copyright (c) 1996-2023 Juniper Networks, Inc.'
system_name:
type:
- string
- 'null'
description: Name of the switch
readOnly: true
examples:
- Core-AE23
description: LLDP neighbor information and power negotiations. For backward compatibility, when multiple neighbors exist, only information from the first neighbor is displayed.
stats_ap_port_stat:
title: stats_ap_port_stat
type: object
properties:
full_duplex:
type:
- boolean
- 'null'
description: Whether the AP Ethernet port is operating in full-duplex mode
readOnly: true
examples:
- true
rx_bytes:
type:
- integer
- 'null'
description: Bytes received on the AP Ethernet port
contentEncoding: int64
readOnly: true
examples:
- 8515104416
rx_errors:
type:
- integer
- 'null'
description: Receive error count reported for the AP Ethernet port
contentEncoding: int32
readOnly: true
examples:
- 0
rx_peak_bps:
type:
- integer
- 'null'
description: Peak receive throughput on the AP Ethernet port, in bits per second
contentEncoding: int32
readOnly: true
examples:
- 22185
rx_pkts:
type:
- integer
- 'null'
description: Packets received on the AP Ethernet port
contentEncoding: int64
readOnly: true
examples:
- 57770567
speed:
type:
- integer
- 'null'
description: Negotiated Ethernet link speed for the AP port, in Mbps
contentEncoding: int32
readOnly: true
examples:
- 1000
tx_bytes:
type:
- integer
- 'null'
description: Bytes transmitted on the AP Ethernet port
contentEncoding: int64
readOnly: true
examples:
- 211217389682
tx_peak_bps:
type:
- integer
- 'null'
description: Peak transmit throughput on the AP Ethernet port, in bits per second
contentEncoding: int32
readOnly: true
examples:
- 43922
tx_pkts:
type:
- integer
- 'null'
description: Packets transmitted on the AP Ethernet port
contentEncoding: int64
readOnly: true
examples:
- 812204062
up:
type:
- boolean
- 'null'
description: Whether the AP Ethernet port link is up
readOnly: true
examples:
- true
description: Ethernet port statistics reported by an AP
stats_ap_radio_config:
title: stats_ap_radio_config
type: object
properties:
band_24:
allOf:
- $ref: '#/components/schemas/stats_ap_radio_config_band4'
- description: 2.4 GHz radio configuration reported by the AP
band_24_usage:
type:
- string
- 'null'
description: Current operating use for the 2.4 GHz radio
readOnly: true
examples:
- '5'
band_5:
allOf:
- $ref: '#/components/schemas/stats_ap_radio_config_band1'
- description: 5 GHz radio configuration reported by the AP
band_6:
allOf:
- $ref: '#/components/schemas/stats_ap_radio_config_band2'
- description: 6 GHz radio configuration reported by the AP
scanning_enabled:
type: boolean
description: Whether radio scanning is enabled on the AP
description: Radio configuration reported by an AP
stats_ap_radio_config_band:
title: stats_ap_radio_config_band
type: object
properties:
allow_rrm_disable:
type:
- boolean
- 'null'
description: Whether RRM disablement is allowed for this radio band
readOnly: true
bandwidth:
type:
- number
- 'null'
description: Channel bandwidth configured for this radio band
readOnly: true
examples:
- 20
channel:
type: integer
description: Operating channel configured for this radio band
contentEncoding: int32
examples:
- 1
disabled:
type:
- boolean
- 'null'
description: Whether this radio band is disabled
readOnly: true
dynamic_chaining_enabled:
type:
- boolean
- 'null'
description: Whether dynamic chaining is enabled for this radio band
readOnly: true
examples:
- false
power:
type:
- number
- 'null'
description: Transmit power configured for this radio band
readOnly: true
examples:
- 10
power_max:
type:
- number
- 'null'
description: Maximum transmit power allowed for this radio band
readOnly: true
examples:
- 10
power_min:
type:
- number
- 'null'
description: Minimum transmit power allowed for this radio band
readOnly: true
examples:
- 10
rx_chain:
type:
- integer
- 'null'
description: Number of receive chains enabled for this radio band
contentEncoding: int32
readOnly: true
examples:
- 4
tx_chain:
type:
- integer
- 'null'
description: Number of transmit chains enabled for this radio band
contentEncoding: int32
readOnly: true
examples:
- 4
description: Per-band radio configuration reported by an AP
stats_ap_radio_stat:
title: stats_ap_radio_stat
type: object
properties:
band_24:
allOf:
- $ref: '#/components/schemas/ap_radio_stat1'
- description: 2.4 GHz radio statistics reported by the AP
band_5:
allOf:
- $ref: '#/components/schemas/ap_radio_stat2'
- description: 5 GHz radio statistics reported by the AP
band_6:
allOf:
- $ref: '#/components/schemas/ap_radio_stat3'
- description: 6 GHz radio statistics reported by the AP
description: Per-band radio statistics reported by an AP
stats_ap_switch_redundancy:
title: stats_ap_switch_redundancy
type: object
properties:
num_redundant_aps:
type:
- integer
- 'null'
description: Number of redundant APs available for switch redundancy
contentEncoding: int32
readOnly: true
examples:
- 1
description: Switch redundancy status reported by an AP
stats_ap_usb_stat:
title: stats_ap_usb_stat
type: object
properties:
channel:
type:
- integer
- 'null'
description: Radio channel used by the USB peripheral
contentEncoding: int32
readOnly: true
examples:
- 3
connected:
type:
- boolean
- 'null'
description: Whether the USB peripheral is connected
readOnly: true
examples:
- true
last_activity:
type:
- integer
- 'null'
description: Time of the last USB peripheral activity, in epoch seconds
contentEncoding: int32
readOnly: true
examples:
- 1586873254
type:
type:
- string
- 'null'
description: USB peripheral type reported by the AP
readOnly: true
examples:
- imagotag
up:
type:
- boolean
- 'null'
description: Whether the USB peripheral is operational
readOnly: true
examples:
- true
description: USB peripheral status reported by an AP
stats_ap_zigbee_stat:
title: stats_ap_zigbee_stat
type: object
properties:
iotproxy_status:
type:
- string
- 'null'
description: Connection status of the IoT proxy
readOnly: true
examples:
- connected
num_iotendpoints:
type:
- integer
- 'null'
description: Number of IoT endpoints connected through the AP
contentEncoding: int32
readOnly: true
examples:
- 3
description: ZigBee statistics reported by an AP, present only when ZigBee is enabled on the AP
stats_asset:
title: stats_asset
required:
- mac
type: object
properties:
_ttl:
type: integer
description: Time-to-live in seconds; how long this asset data is valid in cache
contentEncoding: int32
battery_percent:
type: integer
description: Estimated battery level (1–100%); currently supported for Aruba/HPE asset tags
contentEncoding: int32
examples:
- 50
battery_voltage:
type: number
description: Battery voltage, in mV
examples:
- 2970
beam:
type: integer
description: BLE beam number where the asset was observed
contentEncoding: int32
examples:
- 6
by:
type: string
description: Observation source type for the asset statistic
examples:
- asset
device_id:
type: string
description: Device ID of the loudest AP
contentEncoding: uuid
readOnly: true
examples:
- 00000000-0000-0000-1000-5c5b35000001
device_name:
type: string
description: Display name of the loudest AP observing the asset
examples:
- a
duration:
type: integer
description: Length of the current asset observation, in seconds
contentEncoding: int32
examples:
- 120
eddystone_uid_instance:
type: string
description: Eddystone-UID instance value advertised by the asset
examples:
- 5c5b35000001
eddystone_uid_namespace:
type: string
description: Eddystone-UID namespace value advertised by the asset
examples:
- 2818e3868dec25629ede
eddystone_url_url:
type: string
description: URL value advertised by the asset through Eddystone-URL
examples:
- https://www.abc.com
ibeacon_major:
maximum: 65535
minimum: 1
type:
- integer
- 'null'
description: iBeacon major value advertised by the asset
contentEncoding: int32
examples:
- 1234
ibeacon_minor:
maximum: 65535
minimum: 1
type:
- integer
- 'null'
description: iBeacon minor value advertised by the asset
contentEncoding: int32
examples:
- 1234
ibeacon_uuid:
type:
- string
- 'null'
description: iBeacon UUID advertised by the asset
contentEncoding: uuid
examples:
- f3f17139-704a-f03a-2786-0400279e37c3
id:
type: string
description: Unique identifier for the asset statistic
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
last_seen:
type:
- number
- 'null'
description: Time when the BLE asset was last observed, in epoch seconds
readOnly: true
examples:
- 1470417522
mac:
type: string
description: Bluetooth MAC address for the asset
examples:
- 6fa474be7ae5
manufacture:
type: string
description: Vendor name resolved from the BLE manufacturer company ID
map_id:
type: string
description: Map where the device belongs to
contentEncoding: uuid
examples:
- c45be59f-854d-4ef7-b782-dcd6309c84a9
mfg_company_id:
type: integer
description: BLE manufacturer company ID from advertisement
contentEncoding: int32
examples:
- 935
mfg_data:
type: string
description: Manufacturer-specific data (hex encoded)
examples:
- 648520a1020000
name:
type: string
description: Display label for the BLE asset
examples:
- 6fa474be7ae5
rssi:
type: integer
description: Signal strength (RSSI) of the loudest AP in dBm
contentEncoding: int32
examples:
- -60
rssizones:
type: array
items:
$ref: '#/components/schemas/asset_rssi_zone'
description: RSSI zones currently containing this asset
service_packets:
maxItems: 10
type: array
items:
$ref: '#/components/schemas/stats_asset_service_packet'
description: Service data advertisements observed from this asset
temperature:
type: number
description: Reported temperature value from the BLE asset
examples:
- 23
x:
type: number
description: Map X coordinate of the asset location, in pixels
examples:
- 280.19918140310193
y:
type: number
description: Map Y coordinate of the asset location, in pixels
examples:
- 420.2987721046529
zones:
type: array
items:
$ref: '#/components/schemas/asset_zone'
description: Map zones currently containing this asset
description: BLE asset location and advertisement statistics
stats_asset_service_packet:
title: stats_asset_service_packet
type: object
properties:
data:
type: string
description: Service data payload (hex encoded)
examples:
- '640'
last_rx_time:
type: integer
description: Unix timestamp when this service data was last received
contentEncoding: int32
examples:
- 1645855923
rx_cnt:
type: integer
description: Total number of times this service data was received
contentEncoding: int32
examples:
- 213065
uuid:
type: string
description: BLE service UUID advertised by the asset service packet
examples:
- 00003e10-0000-1000-8000-00805f9b34fb
description: Service data advertisement from a BLE asset
stats_beacon:
title: stats_beacon
required:
- mac
- map_id
- name
- power
- type
- x
- y
type: object
properties:
battery_voltage:
type: number
description: Battery voltage, in mV
eddystone_instance:
type: string
description: Eddystone-UID instance value advertised by the beacon
eddystone_namespace:
type: string
description: Eddystone-UID namespace value advertised by the beacon
last_seen:
type:
- number
- 'null'
description: Time when the beacon was last observed, in epoch seconds
readOnly: true
examples:
- 1470417522
mac:
type: string
description: Beacon MAC address observed by Mist
map_id:
type: string
description: Map identifier where the beacon is placed
contentEncoding: uuid
name:
type: string
description: Display name of the beacon
power:
type: integer
description: Transmit power configured for the beacon
contentEncoding: int32
type:
type: string
description: Advertisement protocol type used by the beacon, such as iBeacon or Eddystone
x:
type: number
description: Map X coordinate of the beacon placement, in pixels
y:
type: number
description: Map Y coordinate of the beacon placement, in pixels
description: BLE beacon runtime statistics and placement data
stats_call:
title: stats_call
type: object
properties:
app:
type: string
description: Third-party collaboration application that reported the call statistics
audio_quality:
type: integer
description: Quality score reported for the call audio stream
contentEncoding: int32
end_time:
type: integer
description: Time when the call ended, in epoch seconds
contentEncoding: int32
mac:
type: string
description: Client MAC address associated with the call statistics record
meeting_id:
type: string
description: Collaboration meeting identifier reported for the call
org_id:
type: string
description: Owning organization identifier for the call statistics record
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
rating:
type: integer
description: Overall call rating reported by the collaboration application, when available
contentEncoding: int32
screen_share_quality:
type: integer
description: Quality score reported for screen sharing during the call
contentEncoding: int32
site_id:
type: string
description: Associated site identifier for the call statistics record
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
start_time:
type: integer
description: Time when the call started, in epoch seconds
contentEncoding: int32
video_quality:
type: integer
description: Quality score reported for the call video stream
contentEncoding: int32
description: Statistics record for a detected collaboration call, such as Zoom or Teams
stats_cluster_config:
title: stats_cluster_config
type: object
properties:
configuration:
type: string
description: Configured high-availability mode for the gateway cluster, such as active-active
control_link_info:
allOf:
- $ref: '#/components/schemas/stats_cluster_config_control_link_info2'
- description: Control link interface and operational state for the gateway cluster
ethernet_connection:
type: array
items:
$ref: '#/components/schemas/stats_cluster_config_ethernet_connection_item'
description: Ethernet interface connection states used by the gateway cluster
fabric_link_info:
allOf:
- $ref: '#/components/schemas/stats_cluster_config_fabric_link_info2'
- description: Fabric link state and data-plane notification details for the gateway cluster
last_status_change_reason:
type: string
description: Reason reported for the most recent gateway cluster status change
operational:
type: string
description: Current operational high-availability mode of the gateway cluster
primary_node_health:
type: string
description: Health state reported for the primary gateway cluster node
redundancy_group_information:
type: array
items:
$ref: '#/components/schemas/stats_cluster_config_redundancy_group_info_item'
description: Redundancy group monitoring state reported by the gateway cluster
secondary_node_health:
type: string
description: Health state reported for the secondary gateway cluster node
status:
type: string
description: Overall health status reported for the gateway cluster
description: High-availability cluster configuration and health reported by a gateway
stats_cluster_config_control_link_info:
title: stats_cluster_config_control_link_info
type: object
properties:
name:
type: string
description: Control link interface name reported by the gateway cluster
status:
type: string
description: Operational state reported for the control link
description: Control link status details for a gateway cluster
stats_cluster_config_ethernet_connection_item:
title: stats_cluster_config_ethernet_connection_item
type: object
properties:
name:
type: string
description: Ethernet interface name reported for cluster connectivity
status:
type: string
description: Operational state reported for the Ethernet interface
description: Ethernet interface connection state for a gateway cluster member
stats_cluster_config_fabric_link_info:
title: stats_cluster_config_fabric_link_info
type: object
properties:
DataPlaneNotifiedStatus:
type: string
description: Fabric link data-plane notification status reported by the gateway
Interface:
uniqueItems: true
type: array
items:
type: string
description: Fabric link interfaces reported for the gateway cluster
InternalStatus:
type: string
description: Gateway-reported internal status for the fabric link
State:
type: string
description: Administrative state of the fabric link
Status:
type: string
description: Operational status of the fabric link
description: Fabric link status details for a gateway cluster
stats_cluster_config_redundancy_group_info_item:
title: stats_cluster_config_redundancy_group_info_item
type: object
properties:
Id:
type: integer
description: Redundancy group identifier reported by the gateway
contentEncoding: int32
MonitoringFailure:
type: string
description: Detected monitoring failure condition for the redundancy group
Threshold:
type: integer
description: Configured monitoring threshold for the redundancy group
contentEncoding: int32
description: Redundancy group monitoring entry for a gateway cluster
stats_device_other:
title: stats_device_other
type: object
properties:
cached_stats:
type: boolean
description: Whether the response was served from cached vendor statistics
config_status:
type: string
description: Synchronization status of the other device configuration in Mist
examples:
- synced
connected_devices:
type: object
additionalProperties:
$ref: '#/components/schemas/stats_device_other_connected_device'
description: LLDP neighbor devices discovered from the other device
interfaces:
type: object
additionalProperties:
$ref: '#/components/schemas/stats_device_other_interface'
description: Network interface statistics reported for the other device
last_config:
type: integer
description: Timestamp of the last configuration update reported for the other device, in epoch seconds
contentEncoding: int32
examples:
- 1675392788
last_seen:
type:
- number
- 'null'
description: Time when Mist last observed the other device, in epoch seconds
readOnly: true
examples:
- 1470417522
lldp_enabled:
type: boolean
description: Whether LLDP is enabled on the other device
mac:
type: string
description: Other device MAC address reported in the statistics response
examples:
- 5c5b35000018
status:
type: string
description: Connectivity status reported for the other device, such as online
examples:
- online
uptime:
type: integer
description: Elapsed time since the other device last booted, in seconds
contentEncoding: int32
examples:
- 20296
vendor:
type: string
description: Device vendor name, such as Cradlepoint
examples:
- cradlepoint
vendor_specific:
allOf:
- $ref: '#/components/schemas/stats_device_other_vendor_specific2'
- description: Additional statistics returned by the device vendor
version:
type: string
description: Vendor software version reported for the other device
examples:
- 7.22.70
description: Statistics for a third-party or other device tracked by Mist
stats_device_other_connected_device:
title: stats_device_other_connected_device
type: object
properties:
mac:
type: string
description: Connected device MAC address learned from LLDP
examples:
- 020001abcdef
name:
type: string
description: LLDP system name reported for the connected device
examples:
- DNT-NTR-GWE
port_id:
type: string
description: LLDP port identifier reported for the connected device
examples:
- ge-0/0/1
type:
type: string
description: Detected Mist device type for the connected neighbor
examples:
- gateway
description: LLDP neighbor device discovered from an other-device statistics record
stats_device_other_interface:
title: stats_device_other_interface
type: object
properties:
bytes_in:
type: integer
description: Total bytes received on the interface
contentEncoding: int64
examples:
- 5623096929
bytes_out:
type: integer
description: Total bytes transmitted from the interface
contentEncoding: int64
examples:
- 12372750366
carrier:
type: string
description: Cellular carrier name reported for the interface, when applicable
examples:
- Orange
imei:
type: string
description: Modem IMEI serving the interface, when applicable
examples:
- '866401234567893'
imsi:
type: string
description: Subscriber IMSI associated with the interface, when applicable
examples:
- '2080101234567893'
ip:
type: string
description: Interface IP address reported by the vendor
examples:
- 10.134.237.57
link:
type: boolean
description: Whether the interface link is up
examples:
- true
mode:
type: string
description: Interface role reported by the vendor, such as wan or lan
examples:
- wan
mtu:
type: integer
description: Maximum transmission unit configured on the interface, in bytes
contentEncoding: int32
examples:
- 1500
rsrp:
type: number
description: Reference signal received power for a cellular interface, in dBm
examples:
- -108
rsrq:
type: number
description: Reference signal received quality for a cellular interface, in dB
examples:
- -14
rssi:
type: integer
description: Received signal strength indicator for a cellular interface, in dBm
contentEncoding: int32
examples:
- -74
service_mode:
type: string
description: Cellular service mode reported for the interface, such as 5G NSA
examples:
- 5G NSA
sinr:
type: number
description: Signal-to-interference-plus-noise ratio for a cellular interface, in dB
examples:
- -1.2
state:
type: string
description: Operational state reported for the interface
examples:
- READY
type:
type: string
description: Interface type reported by the vendor, such as mdm or ethernet
examples:
- mdm
uptime:
type: integer
description: Elapsed time since the interface last became active, in seconds
contentEncoding: int32
examples:
- 2095779
description: Network interface statistics for a third-party device tracked by Mist
stats_device_other_vendor_specific:
title: stats_device_other_vendor_specific
type: object
properties:
interfaces:
type: object
additionalProperties:
$ref: '#/components/schemas/stats_device_other_vendor_specific_port'
description: Cradlepoint interface statistics keyed by vendor interface identifier
examples:
- mdm-4d0e073b:
bytes_in: 5623096929
bytes_out: 12372750366
carrier: Orange
imei: '866401234567893'
imsi: '2080101234567893'
ip: 10.134.237.57
link: true
mode: wan
rsrp: -108
rsrq: -14
rssi: -74
service_mode: 5G NSA
sinr: -1.2
state: READY
type: mdm
uptime: 2095779
target_version:
type: string
description: Cradlepoint software version targeted for the device
examples:
- 7.23.40
description: When `vendor`==`cradlepoint`, contains Cradlepoint-specific statistics reported for the other device
stats_device_other_vendor_specific_port:
title: stats_device_other_vendor_specific_port
type: object
properties:
bytes_in:
type: integer
description: Total bytes received on the Cradlepoint interface
contentEncoding: int64
examples:
- 5623096929
bytes_out:
type: integer
description: Total bytes transmitted from the Cradlepoint interface
contentEncoding: int64
examples:
- 12372750366
carrier:
type: string
description: Cellular carrier name reported for the Cradlepoint interface, when applicable
examples:
- Orange
display_name:
type: string
description: Human-readable interface name reported by Cradlepoint
examples:
- mdm-4d0e073b
imei:
type: string
description: Modem IMEI serving the Cradlepoint interface, when applicable
examples:
- '866401234567893'
imsi:
type: string
description: Subscriber IMSI associated with the Cradlepoint interface, when applicable
examples:
- '2080101234567893'
ip:
type: string
description: Cradlepoint interface IP address reported by the vendor
examples:
- 10.134.237.57
link:
type: boolean
description: Whether the Cradlepoint interface link is up
examples:
- true
mode:
type: string
description: Interface role reported by Cradlepoint, such as wan or lan
examples:
- wan
mtu:
type: integer
description: Maximum transmission unit configured on the Cradlepoint interface, in bytes
contentEncoding: int32
examples:
- 1500
port_parent:
type: string
description: Parent Cradlepoint port or interface group for this interface
examples:
- mdm
rsrp:
type: number
description: Reference signal received power for a Cradlepoint cellular interface, in dBm
examples:
- -108
rsrq:
type: number
description: Reference signal received quality for a Cradlepoint cellular interface, in dB
examples:
- -14
rssi:
type: integer
description: Received signal strength indicator for a Cradlepoint cellular interface, in dBm
contentEncoding: int32
examples:
- -74
service_mode:
type: string
description: Cellular service mode reported for the Cradlepoint interface, such as 5G NSA
examples:
- 5G NSA
sinr:
type: number
description: Signal-to-interference-plus-noise ratio for a Cradlepoint cellular interface, in dB
examples:
- -1.2
state:
type: string
description: Operational state reported for the Cradlepoint interface
examples:
- READY
type:
type: string
description: Interface type reported by Cradlepoint, such as mdm or ethernet
examples:
- mdm
uptime:
type: integer
description: Elapsed time since the Cradlepoint interface last became active, in seconds
contentEncoding: int32
examples:
- 2095779
description: Cradlepoint interface statistics for a device tracked by Mist
stats_gateway:
title: stats_gateway
required:
- mac
- type
type: object
properties:
ap_redundancy:
allOf:
- $ref: '#/components/schemas/ap_redundancy2'
- description: AP redundancy statistics associated with the gateway
arp_table_stats:
allOf:
- $ref: '#/components/schemas/arp_table_stats2'
- description: ARP table utilization statistics for the gateway
auto_upgrade_stat:
allOf:
- $ref: '#/components/schemas/stats_ap_auto_upgrade3'
- description: Automatic firmware upgrade status for the gateway
bgp_peers:
type: array
items:
$ref: '#/components/schemas/bgp_peer'
description: BGP peer statistics reported by the gateway
cert_expiry:
type: integer
description: Time when the gateway certificate expires, in epoch seconds
contentEncoding: int64
cluster_config:
allOf:
- $ref: '#/components/schemas/stats_cluster_config1'
- description: High-availability cluster configuration and health for the gateway
cluster_stat:
allOf:
- $ref: '#/components/schemas/stats_gateway_cluster2'
- description: High-availability cluster state summary for the gateway
conductor_name:
type: string
description: SSR conductor name associated with the gateway, when applicable
readOnly: true
config_status:
type: string
description: Configuration synchronization status reported for the gateway
readOnly: true
config_timestamp:
type: integer
description: Time when the gateway configuration status was last updated, in epoch seconds
contentEncoding: int32
config_version:
type: integer
description: Currently applied configuration version for the gateway
contentEncoding: int32
cpu2_stat:
allOf:
- $ref: '#/components/schemas/cpu_stat3'
- description: Processor utilization statistics for the secondary HA node
cpu_stat:
allOf:
- $ref: '#/components/schemas/cpu_stat4'
- description: Processor utilization statistics for the gateway or primary HA node
created_time:
type: number
description: Time when the gateway record was created, in epoch seconds
readOnly: true
deviceprofile_id:
type:
- string
- 'null'
description: Applied device profile identifier for the gateway, when present
contentEncoding: uuid
readOnly: true
deviceprofile_name:
type: string
description: Applied device profile name for the gateway
dhcpd2_stat:
type: object
additionalProperties:
$ref: '#/components/schemas/dhcpd_stat_lan'
description: Lease pool statistics from the secondary-node DHCP service
dhcpd_stat:
type: object
additionalProperties:
$ref: '#/components/schemas/dhcpd_stat_lan'
description: Lease pool statistics from the gateway DHCP service
evpntopo_id:
type:
- string
- 'null'
description: Associated EVPN topology identifier for the gateway, when present
contentEncoding: uuid
readOnly: true
ext_ip:
type:
- string
- 'null'
description: Public IP address observed for the gateway
readOnly: true
examples:
- 66.129.234.224
fwupdate:
allOf:
- $ref: '#/components/schemas/fwupdate_stat4'
- description: Firmware update status for the gateway
has_pcap:
type:
- boolean
- 'null'
description: Whether packet capture is available for the gateway
readOnly: true
hostname:
type: string
description: Device-reported hostname for the gateway
examples:
- sj1
id:
type: string
description: Unique identifier of the gateway record
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
if2_stat:
type: object
additionalProperties:
$ref: '#/components/schemas/if_stat_property'
description: Interface traffic statistics for the secondary HA node
if_stat:
type: object
additionalProperties:
$ref: '#/components/schemas/if_stat_property'
description: Interface traffic statistics for the gateway or primary HA node
ip:
type:
- string
- 'null'
description: Management IP address reported for the gateway
readOnly: true
examples:
- 10.2.11.137
ip2_stat:
allOf:
- $ref: '#/components/schemas/ip_stat3'
- description: Layer 3 address statistics for the secondary HA node
ip_stat:
allOf:
- $ref: '#/components/schemas/ip_stat4'
- description: Layer 3 address statistics for the gateway or primary HA node
is_ha:
type:
- boolean
- 'null'
description: Whether the gateway is part of an HA cluster
readOnly: true
last_seen:
type:
- number
- 'null'
description: Time when Mist last observed the gateway, in epoch seconds
readOnly: true
examples:
- 1470417522
mac:
type: string
description: Gateway MAC address reported by Mist
examples:
- dc38e1dbf3cd
mac_table_stats:
allOf:
- $ref: '#/components/schemas/stats_gateway_mac_table_stats2'
- description: Layer 2 MAC table utilization statistics for the gateway
map_id:
type:
- string
- 'null'
description: Placement map identifier associated with the gateway, when present
contentEncoding: uuid
readOnly: true
memory2_stat:
allOf:
- $ref: '#/components/schemas/memory_stat3'
- description: Secondary-node memory utilization statistics for the gateway
memory_stat:
allOf:
- $ref: '#/components/schemas/memory_stat4'
- description: Utilization statistics for gateway memory
model:
type: string
description: Gateway model name reported by Mist
examples:
- SRX320
modified_time:
type: number
description: Time when the gateway record was last modified, in epoch seconds
readOnly: true
module2_stat:
maxItems: 1
minItems: 0
type: array
items:
$ref: '#/components/schemas/stats_gateway_module_stat_item'
description: Hardware module statistics for the secondary HA node
module_stat:
maxItems: 1
minItems: 0
type: array
items:
$ref: '#/components/schemas/stats_gateway_module_stat_item'
description: Hardware module statistics for the gateway or primary HA node
name:
type: string
description: Device name if configured
readOnly: true
examples:
- sj1
node_name:
type: string
description: HA node name for the gateway, such as node0 or node1
readOnly: true
examples:
- node0
org_id:
type: string
description: Owning organization identifier for the gateway statistics record
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
ports:
type: array
items:
$ref: '#/components/schemas/stats_gateway_port'
description: Port statistics reported by the gateway
route_summary_stats:
allOf:
- $ref: '#/components/schemas/route_summary_stats2'
- description: Route table summary statistics for the gateway
router_name:
type: string
description: Device name if configured
readOnly: true
examples:
- sj1
serial:
type: string
description: Gateway serial number reported by Mist
readOnly: true
examples:
- TC3714190003
service2_stat:
type: object
additionalProperties:
$ref: '#/components/schemas/service_stat_property'
description: System service statistics for the secondary HA node
service_stat:
type: object
additionalProperties:
$ref: '#/components/schemas/service_stat_property'
description: System service statistics for the gateway or primary HA node
service_status:
allOf:
- $ref: '#/components/schemas/stats_gateway_service_status2'
- description: Security service status reported by the gateway
site_id:
type: string
description: Associated site identifier for the gateway statistics record
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
spu2_stat:
type: array
items:
$ref: '#/components/schemas/stats_gateway_spu_item'
description: Secondary-node Services Processing Unit statistics for the gateway
spu_stat:
type: array
items:
$ref: '#/components/schemas/stats_gateway_spu_item'
description: Services Processing Unit statistics for the gateway or primary HA node
status:
type: string
description: Connection status reported for the gateway, such as connected
readOnly: true
examples:
- connected
tag_id:
type: integer
description: Numeric inventory tag identifier associated with the gateway
contentEncoding: int32
tag_uuid:
type: string
description: Inventory tag UUID associated with the gateway
contentEncoding: uuid
tunnels:
type: array
items:
$ref: '#/components/schemas/stats_gateway_wan_tunnel'
description: WAN tunnel statistics for the gateway
type:
const: gateway
type: string
description: Device type discriminator for gateway statistics
readOnly: true
uptime:
type:
- number
- 'null'
description: Elapsed time since the gateway last booted, in seconds
readOnly: true
examples:
- 3671219
version:
type:
- string
- 'null'
description: Software version running on the gateway
readOnly: true
examples:
- 18.4R1.8
vpn_peers:
type: array
items:
$ref: '#/components/schemas/stats_gateway_vpn_peer'
description: Remote VPN peer statistics for the gateway
description: Gateway statistics reported by Mist for a site or organization stats response
stats_gateway_cluster:
title: stats_gateway_cluster
type: object
properties:
state:
type:
- string
- 'null'
description: Current HA cluster state for the gateway
readOnly: true
description: High-availability cluster state reported by a gateway
stats_gateway_mac_table_stats:
title: stats_gateway_mac_table_stats
type: object
properties:
mac_table_count:
type: integer
description: Number of MAC table entries currently learned by the gateway
contentEncoding: int32
max_mac_entries_supported:
type: integer
description: Maximum MAC table entries supported by the gateway
contentEncoding: int32
description: Gateway MAC table utilization counters
stats_gateway_module_stat_item:
title: stats_gateway_module_stat_item
type: object
properties:
backup_version:
type:
- string
- 'null'
description: Backup software version stored on the gateway module
readOnly: true
bios_version:
type:
- string
- 'null'
description: BIOS firmware version reported for the gateway module
readOnly: true
boot_partition:
type: string
description: Active boot partition used by the gateway module
cpld_version:
type:
- string
- 'null'
description: CPLD firmware version reported for the gateway module
readOnly: true
fans:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/module_stat_item_fans_items'
description: Cooling fan status records for the gateway module
fpga_version:
type:
- string
- 'null'
description: FPGA firmware version reported for the gateway module
readOnly: true
last_seen:
type:
- number
- 'null'
description: Time when Mist last observed this gateway module, in epoch seconds
readOnly: true
examples:
- 1470417522
locating:
type: boolean
description: Whether the gateway module locator indicator is active
mac:
type: string
description: Gateway module MAC address reported by Mist
examples:
- fc3342123456
memory_stat:
allOf:
- $ref: '#/components/schemas/memory_stat5'
- description: Utilization statistics for gateway module memory
model:
type:
- string
- 'null'
description: Gateway module model name reported by Mist
readOnly: true
examples:
- EX4300-48P
network_resources:
type: array
items:
$ref: '#/components/schemas/module_stat_item_network_resource'
description: Network resource utilization counters for the gateway module
optics_cpld_version:
type:
- string
- 'null'
description: Optics CPLD firmware version reported for the gateway module
readOnly: true
pending_version:
type:
- string
- 'null'
description: Pending software version staged for the gateway module
readOnly: true
poe:
allOf:
- $ref: '#/components/schemas/module_stat_item_poe2'
- description: Power over Ethernet telemetry for the gateway module
poe_version:
type:
- string
- 'null'
description: PoE controller firmware version reported for the gateway module
readOnly: true
power_cpld_version:
type:
- string
- 'null'
description: Power CPLD firmware version reported for the gateway module
readOnly: true
psus:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/module_stat_item_psus_item'
description: Power supply status records for the gateway module
re_fpga_version:
type:
- string
- 'null'
description: Routing Engine FPGA firmware version reported for the gateway module
readOnly: true
recovery_version:
type:
- string
- 'null'
description: Recovery software version stored on the gateway module
readOnly: true
serial:
type:
- string
- 'null'
description: Gateway module serial number reported by Mist
readOnly: true
examples:
- PX8716230021
status:
type:
- string
- 'null'
description: Connection status reported for the gateway module
readOnly: true
temperatures:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/module_stat_item_temperatures_item'
description: Temperature sensor readings for the gateway module
tmc_fpga_version:
type:
- string
- 'null'
description: TMC FPGA firmware version reported for the gateway module
readOnly: true
uboot_version:
type:
- string
- 'null'
description: U-Boot firmware version reported for the gateway module
readOnly: true
uptime:
type:
- integer
- 'null'
description: Elapsed time since the gateway module last booted, in seconds
contentEncoding: int32
readOnly: true
vc_links:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/module_stat_item_vc_links_item'
description: Virtual chassis link records for the gateway module
vc_mode:
type:
- string
- 'null'
description: Virtual chassis mode reported for the gateway module
readOnly: true
vc_role:
type:
- string
- 'null'
description: 'Virtual chassis role reported for the gateway module. enum: `master`, `backup`, `linecard`'
readOnly: true
examples:
- master
vc_state:
type:
- string
- 'null'
description: Virtual chassis state reported for the gateway module
readOnly: true
version:
type:
- string
- 'null'
description: Software version running on the gateway module
readOnly: true
description: Hardware module status and firmware inventory for a gateway
stats_gateway_port:
title: stats_gateway_port
required:
- neighbor_mac
- port_id
- port_mac
type: object
properties:
active:
type: boolean
description: Indicates if interface is active/inactive
readOnly: true
auth_state:
allOf:
- $ref: '#/components/schemas/port_auth_state1'
- description: 'Authentication state of the port. enum: ``, `authenticated`, `authenticating`, `held`, `init`.'
disabled:
type: boolean
description: Indicates if interface is disabled
readOnly: true
for_site:
type: boolean
description: Whether the reporting device is scoped to a specific site
readOnly: true
full_duplex:
type: boolean
description: Indicates full or half duplex
examples:
- true
jitter:
type: number
description: Last sampled jitter of the interface
readOnly: true
latency:
type: number
description: Last sampled latency of the interface
readOnly: true
loss:
type: number
description: Last sampled loss of the interface
readOnly: true
lte_iccid:
type:
- string
- 'null'
description: LTE ICCID value, Check for null/empty
lte_imei:
type:
- string
- 'null'
description: LTE IMEI value, Check for null/empty
lte_imsi:
type:
- string
- 'null'
description: LTE IMSI value, Check for null/empty
mac_count:
type: integer
description: Number of MAC addresses in the forwarding table
contentEncoding: int32
readOnly: true
mac_limit:
minimum: 0
type: integer
description: Limit on number of dynamically learned macs
contentEncoding: int32
readOnly: true
neighbor_mac:
type: string
description: chassis identifier of the chassis type listed
readOnly: true
examples:
- 64d814353400
neighbor_port_desc:
type: string
description: Description supplied by the system on the interface E.g. "GigabitEthernet2/0/39"
readOnly: true
examples:
- GigabitEthernet1/0/21
neighbor_system_name:
type: string
description: Name supplied by the system on the interface E.g. neighbor system name E.g. "Kumar-Acc-SW.mist.local"
readOnly: true
examples:
- CORP-D-SW-2
poe_disabled:
type: boolean
description: Is the POE configured not be disabled.
readOnly: true
poe_mode:
allOf:
- $ref: '#/components/schemas/stats_switch_port_poe_mode1'
- description: 'PoE mode reported for the port. enum: `802.3af`, `802.3at`, `802.3bt`.'
poe_on:
type: boolean
description: Is the device attached to POE
readOnly: true
port_id:
type: string
description: Identifier of the port reporting these statistics
readOnly: true
examples:
- ge-0/0/0
port_mac:
type: string
description: MAC address assigned to the interface
readOnly: true
examples:
- 5c4527a96580
port_usage:
type: string
description: Logical usage assigned to the port
examples:
- lan
power_draw:
type: number
description: Amount of power being used by the interface at the time the command is executed. Unit in watts.
readOnly: true
rx_bcast_pkts:
type: integer
description: Number of broadcast packets received on the interface
contentEncoding: int32
readOnly: true
rx_bps:
type:
- integer
- 'null'
description: Receive throughput of the port, in bits per second
contentEncoding: int64
readOnly: true
examples:
- 60003
rx_bytes:
type:
- integer
- 'null'
description: Total bytes received on the port
contentEncoding: int64
readOnly: true
examples:
- 8515104416
rx_errors:
type: integer
description: Number of receive errors observed on the interface
contentEncoding: int32
readOnly: true
rx_mcast_pkts:
type: integer
description: Number of multicast packets received on the interface
contentEncoding: int32
readOnly: true
rx_pkts:
type:
- integer
- 'null'
description: Total packets received on the port
contentEncoding: int64
readOnly: true
examples:
- 57770567
speed:
type: integer
description: Current link speed of the port, in Mbps
contentEncoding: int32
readOnly: true
examples:
- 1000
stp_role:
allOf:
- $ref: '#/components/schemas/port_stp_role1'
- description: 'Current spanning tree role of the port. enum: ``, `alternate`, `backup`, `designated`, `disabled`, `root`, `root-prevented`.'
stp_state:
allOf:
- $ref: '#/components/schemas/port_stp_state1'
- description: 'Current spanning tree state of the port. enum: ``, `blocking`, `disabled`, `forwarding`, `learning`, `listening`.'
tx_bcast_pkts:
type: integer
description: Number of broadcast packets transmitted on the interface
contentEncoding: int32
readOnly: true
tx_bps:
type:
- integer
- 'null'
description: Transmit throughput of the port, in bits per second
contentEncoding: int64
readOnly: true
examples:
- 634301
tx_bytes:
type:
- integer
- 'null'
description: Total bytes transmitted on the port
contentEncoding: int64
readOnly: true
examples:
- 211217389682
tx_errors:
type: integer
description: Number of transmit errors observed on the interface
contentEncoding: int32
readOnly: true
tx_mcast_pkts:
type: integer
description: Number of multicast packets transmitted on the interface
contentEncoding: int32
readOnly: true
tx_pkts:
type:
- integer
- 'null'
description: Total packets transmitted on the port
contentEncoding: int64
readOnly: true
examples:
- 812204062
type:
allOf:
- $ref: '#/components/schemas/stats_switch_port_type1'
- description: 'Detected device category connected to the port, when available. enum: `ap`, `ble`, `gateway`, `mxedge`, `nac`, `switch`.'
examples:
- gateway
unconfigured:
type: boolean
description: Indicates if interface is unconfigured
readOnly: true
up:
type: boolean
description: Indicates if interface is up
readOnly: true
xcvr_model:
type: string
description: Optic Slot ModelName, Check for null/empty
readOnly: true
examples:
- SFP+-10G-SR
xcvr_part_number:
type: string
description: Optic Slot Partnumber, Check for null/empty
readOnly: true
examples:
- 740-021487
xcvr_serial:
type: string
description: Optic Slot SerialNumber, Check for null/empty
readOnly: true
examples:
- N6AA9HT
description: Gateway port statistics record returned by stats APIs
stats_gateway_service_status:
title: stats_gateway_service_status
type: object
properties:
appid_install_result:
type: string
description: Installation result reported for the AppID package
appid_install_timestamp:
type: string
description: Installation time reported for the AppID package
appid_status:
type: string
description: Operational status of the AppID service on the gateway
appid_version:
type: integer
description: Installed AppID package version number
contentEncoding: int32
ewf_status:
type: string
description: Enhanced Web Filtering service status reported by the gateway
idp_install_result:
type: string
description: Installation result reported for the intrusion detection and prevention package
idp_install_timestamp:
type: string
description: Installation time reported for the intrusion detection and prevention package
idp_policy:
type: string
description: Intrusion detection and prevention policy applied to the gateway
idp_status:
type: string
description: Intrusion detection and prevention service status reported by the gateway
idp_update_timestamp:
type: string
description: Last update time reported for the intrusion detection and prevention package
description: Gateway security service installation and runtime status
stats_gateway_spu_item:
title: stats_gateway_spu_item
type: object
properties:
spu_cpu:
type: integer
description: CPU utilization reported for the Services Processing Unit
contentEncoding: int32
examples:
- 3670632
spu_current_session:
type: integer
description: Current session count handled by the Services Processing Unit
contentEncoding: int32
examples:
- 215
spu_max_session:
type: integer
description: Maximum sessions supported by the Services Processing Unit
contentEncoding: int32
examples:
- 131072
spu_memory:
type: integer
description: Memory utilization reported for the Services Processing Unit
contentEncoding: int32
examples:
- 46
spu_pending_session:
type: integer
description: Pending session count on the Services Processing Unit
contentEncoding: int32
examples:
- 0
spu_uptime:
type: integer
description: Elapsed time since the Services Processing Unit started, in seconds
contentEncoding: int32
examples:
- 0
spu_valid_session:
type: integer
description: Valid session count currently tracked by the Services Processing Unit
contentEncoding: int32
description: Services Processing Unit resource and session counters
stats_gateway_vpn_peer:
title: stats_gateway_vpn_peer
type: object
properties:
is_active:
type: boolean
description: Whether this VPN peer path is the active redundant path
jitter:
minimum: 0
type: number
description: Last sampled VPN peer jitter, in milliseconds
last_seen:
type:
- number
- 'null'
description: Time when this VPN peer was last observed, in epoch seconds
readOnly: true
examples:
- 1470417522
latency:
minimum: 0
type: number
description: Last sampled VPN peer latency, in milliseconds
loss:
maximum: 100
minimum: 0
type: number
description: Packet loss observed for the VPN peer, as a percentage
mos:
maximum: 5
minimum: 0
type: number
description: Mean Opinion Score for VPN link quality, from 0 to 5
mtu:
type: integer
description: Maximum transmission unit for the VPN peer path, in bytes
contentEncoding: int32
peer_mac:
minLength: 1
type: string
description: Peer router MAC address for the VPN link
peer_port_id:
minLength: 1
type: string
description: Peer router interface identifier for the VPN link
peer_router_name:
minLength: 1
type: string
description: Peer router name reported for the VPN link
peer_site_id:
type: string
description: Site identifier for the peer side of the VPN link
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
port_id:
minLength: 1
type: string
description: Local router interface identifier for the VPN link
router_name:
minLength: 1
type: string
description: Local router name reported for the VPN link
type:
minLength: 1
type: string
description: VPN implementation type for the peer, such as `ipsec` for SRX or `svr` for SSR
up:
type: boolean
description: Whether the VPN peer is currently up
uptime:
type: integer
description: Gateway-reported VPN peer uptime value, in seconds
contentEncoding: int32
description: VPN peer path statistics reported by a gateway
stats_gateway_wan_tunnel:
title: stats_gateway_wan_tunnel
type: object
properties:
auth_algo:
type: string
description: Authentication algorithm negotiated for the tunnel
encrypt_algo:
type: string
description: Encryption algorithm negotiated for the tunnel
ike_version:
type: string
description: IKE version used to establish the tunnel
ip:
type: string
description: Local IP address used by the tunnel
last_event:
type: string
description: Most recent reason the tunnel went down
last_flapped:
type: number
description: Indicates when the tunnel last flapped
node:
type: string
description: HA node handling the tunnel, such as node0 or node1
peer_host:
type: string
description: Hostname or configured peer host of the remote tunnel endpoint
peer_ip:
type: string
description: IP address of the remote tunnel endpoint
priority:
allOf:
- $ref: '#/components/schemas/tunnel_priority1'
- description: 'Relative preference assigned to the tunnel. enum: `primary`, `secondary`.'
protocol:
allOf:
- $ref: '#/components/schemas/wan_tunnel_protocol1'
- description: 'Tunnel protocol used for the connection. enum: `gre`, `ipsec`.'
rx_bytes:
type:
- integer
- 'null'
description: Total bytes received on the tunnel
contentEncoding: int64
readOnly: true
examples:
- 8515104416
rx_pkts:
type:
- integer
- 'null'
description: Total packets received on the tunnel
contentEncoding: int64
readOnly: true
examples:
- 57770567
tunnel_name:
type: string
description: Name of the Mist-managed WAN tunnel
tx_bytes:
type:
- integer
- 'null'
description: Total bytes transmitted on the tunnel
contentEncoding: int64
readOnly: true
examples:
- 211217389682
tx_pkts:
type:
- integer
- 'null'
description: Total packets transmitted on the tunnel
contentEncoding: int64
readOnly: true
examples:
- 812204062
up:
type: boolean
description: Indicates whether the tunnel is currently up
uptime:
type: integer
description: Duration since the tunnel security association was established
contentEncoding: int32
wan_name:
type: string
description: Name of the WAN interface carrying the tunnel
examples:
- wan
description: WAN tunnel statistics reported by a gateway
stats_marvis_client:
title: stats_marvis_client
type: object
properties:
battery_charging:
type: boolean
description: Whether the device battery is currently charging
battery_level:
type: integer
description: Battery level percentage (0–100)
contentEncoding: int32
cpu_background:
type: number
description: Background CPU utilization (0–100)
cpu_idle:
type: number
description: Idle CPU percentage (0–100)
cpu_system:
type: number
description: System CPU utilization (0–100)
cpu_user:
type: number
description: User-space CPU utilization (0–100)
device_id:
type: string
description: UUID of the device the Marvis Client is installed on
contentEncoding: uuid
hostname:
type: string
description: Device hostname
location:
allOf:
- $ref: '#/components/schemas/stats_marvis_client_location1'
- description: Last known device location
memory_total:
type: integer
description: Total device memory, in bytes
contentEncoding: int32
memory_usage:
type: integer
description: Memory in use, in bytes
contentEncoding: int32
mfg:
type: string
description: Device manufacturer
model:
type: string
description: Device model name
org_id:
type: string
description: Organization UUID
contentEncoding: uuid
os_type:
type: string
description: OS type or platform (e.g. Android, iOS)
os_version:
type: string
description: OS version string
serial:
type: string
description: Device serial number
storage_total:
type: integer
description: Total device storage, in bytes
contentEncoding: int32
storage_usage:
type: integer
description: Storage in use, in bytes
contentEncoding: int32
timestamp:
type: integer
description: Timestamp of the stats record, in epoch seconds
contentEncoding: int32
wifi_band:
type: string
description: Wi-Fi band the device is connected on
wifi_bssid:
type: string
description: BSSID the device is connected to
wifi_channel:
type: integer
description: Wi-Fi channel the device is on
contentEncoding: int32
wifi_ip:
type: string
description: Device Wi-Fi IP address
wifi_mac:
type: string
description: Device Wi-Fi MAC address
wifi_rssi:
type: integer
description: Wi-Fi RSSI, in dBm
contentEncoding: int32
wifi_ssid:
type: string
description: SSID the device is connected to
description: Marvis Client stats record returned by search
stats_marvis_client_location:
title: stats_marvis_client_location
type: object
properties:
map_id:
type: string
description: UUID of the floor-plan map
contentEncoding: uuid
site_id:
type: string
description: UUID of the site the device was located in
contentEncoding: uuid
timestamp:
type: integer
description: Timestamp of the location fix, in epoch seconds
contentEncoding: int32
x:
type: number
description: X coordinate on the floor-plan map, in pixels
y:
type: number
description: Y coordinate on the floor-plan map, in pixels
description: Last known location fix for a Marvis Client device
stats_marvis_clients_search:
title: stats_marvis_clients_search
type: object
properties:
limit:
type: integer
description: Maximum number of results requested
contentEncoding: int32
results:
type: array
items:
$ref: '#/components/schemas/stats_marvis_client'
description: List of Marvis Client stats records
total:
type: integer
description: Total number of matching results
contentEncoding: int32
description: Paginated list of Marvis Client stats records
stats_mxedge:
title: stats_mxedge
type: object
properties:
cpu_stat:
allOf:
- $ref: '#/components/schemas/stats_mxedge_cpu_stat2'
- description: CPU utilization statistics reported by the Mist Edge
created_time:
type: number
description: Time when the Mist Edge record was created, in epoch seconds
readOnly: true
fips_enabled:
type: boolean
description: Whether FIPS mode is enabled on the Mist Edge
for_site:
type: boolean
description: Whether the Mist Edge is assigned directly to a site
examples:
- false
fwupdate:
allOf:
- $ref: '#/components/schemas/fwupdate_stat5'
- description: Firmware or package update status for the Mist Edge
id:
type: string
description: Unique identifier of the Mist Edge
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
idrac_version:
type: string
description: IDRAC version of the mist edge device
examples:
- 7.00.00.00
inactive_vlan_strs:
allOf:
- $ref: '#/components/schemas/stats_mxedge_inactive_vlan_strs2'
- description: Inactive VLAN identifiers reported by the Mist Edge
ip_stat:
allOf:
- $ref: '#/components/schemas/stats_mxedge_ip_stat2'
- description: IP address statistics reported by the Mist Edge
kernel_abi:
type: string
description: Kernel release version running on the Mist Edge
examples:
- 6.1.0-47
kernel_version:
type: string
description: Kernel package version running on the Mist Edge
examples:
- 6.1.170-3
lag_stat:
type: object
additionalProperties:
$ref: '#/components/schemas/stats_mxedge_lag_stat'
description: Link aggregation statistics reported by the Mist Edge
examples:
- lacp0:
active_ports:
- port0
- port1
last_seen:
type:
- number
- 'null'
description: Time when Mist last observed the Mist Edge, in epoch seconds
readOnly: true
examples:
- 1470417522
mac:
type: string
description: Mist Edge MAC address reported by Mist
examples:
- 020000a80cb4
magic:
type: string
description: Claim magic token associated with the Mist Edge
memory_stat:
allOf:
- $ref: '#/components/schemas/stats_mxedge_memory_stat2'
- description: Memory utilization statistics reported by the Mist Edge
model:
type: string
description: Mist Edge hardware or VM model
examples:
- ME-VM
modified_time:
type: number
description: Time when the Mist Edge record was last modified, in epoch seconds
readOnly: true
mxagent_registered:
type: boolean
description: Whether the Mist Edge management agent is registered with Mist
examples:
- true
mxcluster_id:
type: string
description: Mist Edge cluster identifier associated with this Mist Edge
contentEncoding: uuid
examples:
- 678bc339-7635-4556-bbc0-e77ad493ef8b
name:
type: string
description: Display name of the Mist Edge
examples:
- me-vm-1
num_tunnels:
type: integer
description: Number of tunnels currently terminated by the Mist Edge
contentEncoding: int32
examples:
- 0
oob_ip_config:
allOf:
- $ref: '#/components/schemas/mxedge_oob_ip_config2'
- description: Configured out-of-band management IP settings for the Mist Edge
oob_ip_stat:
allOf:
- $ref: '#/components/schemas/stats_mxedge_oob_ip_stat2'
- description: Observed out-of-band management IP status for the Mist Edge
org_id:
type: string
description: Organization identifier associated with the Mist Edge
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
port_stat:
type: object
additionalProperties:
$ref: '#/components/schemas/stats_mxedge_port_stat'
description: Port statistics reported by the Mist Edge
examples:
- port0:
full_duplex: true
mac: 9e294e49091d
rx_bytes: 646898375700
rx_errors: 0
rx_pkts: 8784449574
speed: 10000
state: forwarding
tx_bytes: 647200748038
tx_errors: 0
tx_pkts: 8788647466
up: true
port1:
full_duplex: true
mac: a270fe53437e
rx_bytes: 647200437652
rx_errors: 0
rx_pkts: 8788644886
speed: 10000
state: forwarding
tx_bytes: 646898681650
tx_errors: 0
tx_pkts: 8784452092
up: true
serial:
type:
- string
- 'null'
description: Device serial number reported for the Mist Edge, when available
service_stat:
type: object
additionalProperties:
$ref: '#/components/schemas/stats_mxedge_service_stat'
description: Per-service runtime statistics reported by the Mist Edge
examples:
- mxagent:
ext_ip: 99.0.86.164
last_seen: 1633721215
package_state: Installed
package_version: 3.1.1037-1
running_state: Running
uptime: 21240
tunterm:
ext_ip: 99.0.86.164
last_seen: 1633721203
package_state: Installed
package_version: 0.1.2449+deb10
running_state: Running
uptime: 76261
services:
type: array
items:
type: string
description: Mist Edge services enabled or running on the device
examples:
- - tunterm
site_id:
type: string
description: Site identifier associated with the Mist Edge, when assigned to a site
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
status:
type: string
description: Connection status reported for the Mist Edge, such as connected
examples:
- connected
tunterm_ip_config:
allOf:
- $ref: '#/components/schemas/stats_mxedge_tunterm_ip_config2'
- description: Configured tunnel termination IP settings for the Mist Edge
tunterm_port_config:
allOf:
- $ref: '#/components/schemas/stats_mxedge_tunterm_port_config2'
- description: Tunnel termination port configuration reported for the Mist Edge
tunterm_registered:
type: boolean
description: Whether the tunnel termination service is registered with Mist
examples:
- true
tunterm_stat:
allOf:
- $ref: '#/components/schemas/stats_mxedge_tunterm_stat2'
- description: Tunnel termination monitoring status reported by the Mist Edge
uptime:
type: integer
description: Number of seconds the Mist Edge has been running since last boot
contentEncoding: int32
examples:
- 76281
virtualization_type:
type: string
description: Virtualization platform or environment running the Mist Edge VM
examples:
- KVM
description: Statistics for a Mist Edge appliance returned by stats endpoints
stats_mxedge_cpu_stat:
title: stats_mxedge_cpu_stat
type: object
properties:
cpus:
type: object
additionalProperties:
$ref: '#/components/schemas/cpu_stat'
description: Per-core CPU utilization statistics keyed by CPU name
examples:
- cpu0:
idle: 89
interrupt: 0
system: 8
usage: 10
user: 1
cpu1:
idle: 81
interrupt: 0
system: 4
usage: 18
user: 13
cpu2:
idle: 81
interrupt: 0
system: 4
usage: 18
user: 13
cpu3:
idle: 2
interrupt: 0
system: 50
usage: 97
user: 46
idle:
type: integer
description: Percentage of Idle, Idle/(Idle + Busy) since last sampling
contentEncoding: int32
examples:
- 62
interrupt:
type: integer
description: Percentage of Interrupt, (Irq + SoftIrq)/(Idle + Busy) since last sampling
contentEncoding: int32
examples:
- 0
system:
type: integer
description: Percentage of System, System/(Idle + Busy) since last sampling
contentEncoding: int32
examples:
- 17
usage:
type: integer
description: Percentage of load, Busy/(Idle + Busy) since last sampling
contentEncoding: int32
examples:
- 37
user:
type: integer
description: Percentage of User, User/(Idle + Busy) since last sampling
contentEncoding: int32
examples:
- 19
description: Aggregate and per-core CPU utilization statistics for a Mist Edge
stats_mxedge_inactive_vlan_strs:
title: stats_mxedge_inactive_vlan_strs
type: object
properties:
l2tp:
type: array
items:
type: string
description: Inactive L2TP VLANs. Entries can be individual VLANs or ranges.
wired:
type: array
items:
type: string
description: Inactive wired VLANs. Entries can be individual VLANs or ranges.
examples:
- - '100'
- 102-106
description: Inactive wired/L2TP VLANs. Entries can be individual VLANs or ranges.
stats_mxedge_ip_stat:
title: stats_mxedge_ip_stat
type: object
properties:
ip:
type: string
description: Primary IPv4 address reported for the Mist Edge
examples:
- 192.168.1.244
ip6:
type: string
description: Primary IPv6 address reported for the Mist Edge
examples:
- fd4e:c615:b27d:5555::45
ips:
type: object
additionalProperties:
type: string
description: Interface IP addresses keyed by interface name
examples:
- ens18: 92.168.1.244/24,fd4e:c615:b27d:5555::45/128,fd4e:c615:b27d:5555:20c:29ff:fe44:af25/64,fe80::104c:ffff:fee0:caf8/64
macs:
type: object
additionalProperties:
type: string
description: Interface MAC addresses keyed by interface name
examples:
- ens18: e4434b217044
netmask:
type: string
description: IPv4 netmask reported for the primary Mist Edge address
examples:
- 255.255.255.0
netmask6:
type: string
description: IPv6 prefix length reported for the primary Mist Edge address
examples:
- /128
description: IP address statistics reported by a Mist Edge
stats_mxedge_lag_stat:
title: stats_mxedge_lag_stat
type: object
properties:
active_ports:
type: array
items:
type: string
description: Ports currently active in the link aggregation group
description: Link aggregation group status for a Mist Edge
stats_mxedge_memory_stat:
title: stats_mxedge_memory_stat
type: object
properties:
active:
type: integer
description: The amount of memory, in kilobytes, that has been used more recently and is usually not reclaimed unless absolutely necessary.
contentEncoding: int32
examples:
- 394936320
available:
type: integer
description: An estimate of how much memory is available for starting new applications, without swapping.
contentEncoding: int64
examples:
- 4699291648
buffers:
type: integer
description: The amount, in kilobytes, of temporary storage for raw disk blocks.
contentEncoding: int32
examples:
- 107646976
cached:
type: integer
description: The amount of physical RAM, in kilobytes, used as cache memory.
contentEncoding: int32
examples:
- 478060544
free:
type: integer
description: The amount of physical RAM, in kilobytes, left unused by the system
contentEncoding: int64
examples:
- 4330659840
inactive:
type: integer
description: The amount of memory, in kilobytes, that has been used less recently and is more eligible to be reclaimed for other purposes.
contentEncoding: int32
examples:
- 211980288
swap_cached:
type: integer
description: The amount of memory, in kilobytes, that has once been moved into swap, then back into the main memory, but still also remains in the swapfile.
contentEncoding: int32
examples:
- 0
swap_free:
type: integer
description: The total amount of swap free, in kilobytes.
contentEncoding: int32
examples:
- 1022357504
swap_total:
type: integer
description: The total amount of swap available, in kilobytes.
contentEncoding: int32
examples:
- 1022357504
total:
type: integer
description: Usable RAM total, in kilobytes, which is physical RAM minus a number of reserved bits and the kernel binary code
contentEncoding: int64
examples:
- 8365957120
usage:
type: integer
description: Memory utilization percentage reported by the Mist Edge
contentEncoding: int32
examples:
- 48
description: Memory usage counters reported by a Mist Edge
stats_mxedge_oob_ip_stat:
title: stats_mxedge_oob_ip_stat
type: object
properties:
dns:
uniqueItems: true
type: array
items:
type: string
description: Out-of-band management DNS servers
gateway:
type: string
description: IPv4 default gateway for out-of-band management
gateway6:
type: string
description: IPv6 default gateway for out-of-band management
ip:
type: string
description: Out-of-band management IPv4 address
ip6:
type: string
description: Out-of-band management IPv6 address
netmask:
type: string
description: IPv4 netmask for the out-of-band management interface
netmask6:
type: string
description: IPv6 prefix length for the out-of-band management interface
type:
allOf:
- $ref: '#/components/schemas/mxedge_mgmt_oob_ip_type2'
- description: 'IPv4 address assignment mode for out-of-band management. enum: `dhcp`, `disabled`, `static`.'
type8:
allOf:
- $ref: '#/components/schemas/mxedge_mgmt_oob_ip_type62'
- description: 'IPv6 address assignment mode for out-of-band management. enum: `autoconf`, `dhcp`, `disabled`, `static`.'
description: Observed out-of-band management IP settings for a Mist Edge
stats_mxedge_port_stat:
title: stats_mxedge_port_stat
type: object
properties:
full_duplex:
type: boolean
description: Whether the port is operating in full-duplex mode
lacp:
allOf:
- $ref: '#/components/schemas/stats_mxedge_port_stat_lacp2'
- description: Link aggregation control protocol state and packet counters for the port
lldp_stats:
allOf:
- $ref: '#/components/schemas/stats_mxedge_port_stat_lldp_stats2'
- description: LLDP neighbor information learned on the port
mac:
type: string
description: Mist Edge port MAC address reported by Mist
rx_bytes:
type:
- integer
- 'null'
description: Total bytes received on the port
contentEncoding: int64
readOnly: true
examples:
- 8515104416
rx_errors:
type: integer
description: Number of receive errors observed on the port
contentEncoding: int32
rx_pkts:
type:
- integer
- 'null'
description: Total packets received on the port
contentEncoding: int64
readOnly: true
examples:
- 57770567
sfp:
allOf:
- $ref: '#/components/schemas/stats_mxedge_port_stat_sfp2'
- description: Transceiver details reported for the SFP module on the port
speed:
type: integer
description: Current link speed of the port, in Mbps
contentEncoding: int32
state:
type: string
description: Forwarding or operational state reported for the port
tx_bytes:
type:
- integer
- 'null'
description: Total bytes transmitted from the port
contentEncoding: int64
readOnly: true
examples:
- 211217389682
tx_errors:
type: integer
description: Number of transmit errors observed on the port
contentEncoding: int32
tx_pkts:
type:
- integer
- 'null'
description: Total packets transmitted from the port
contentEncoding: int64
readOnly: true
examples:
- 812204062
up:
type: boolean
description: Whether the Mist Edge port link is up
description: Mist Edge port traffic and link status statistics
stats_mxedge_port_stat_lacp:
title: stats_mxedge_port_stat_lacp
type: object
properties:
mux_state:
type: string
description: LACP multiplexer state reported for the port
rx_lacpdu:
type: integer
description: Number of LACPDUs received on the port
contentEncoding: int32
rx_state:
type: string
description: LACP receive state reported for the port
tx_lacpdu:
type: integer
description: Number of LACPDUs transmitted from the port
contentEncoding: int32
description: LACP state and counters for a Mist Edge port
stats_mxedge_port_stat_lldp_stats:
title: stats_mxedge_port_stat_lldp_stats
type: object
properties:
chassis_id:
type: string
description: LLDP chassis identifier advertised by the neighbor
mgmt_addr:
type: string
description: Management address advertised by the LLDP neighbor
port_desc:
type: string
description: Port description advertised by the LLDP neighbor
port_id:
type: string
description: Port identifier advertised by the LLDP neighbor
system_desc:
type: string
description: System description advertised by the LLDP neighbor
system_name:
type: string
description: System name advertised by the LLDP neighbor
description: LLDP neighbor information reported for a Mist Edge port
stats_mxedge_port_stat_sfp:
title: stats_mxedge_port_stat_sfp
type: object
properties:
codes:
type: string
description: Transceiver capability codes reported by the SFP module
mbps:
type: integer
description: Nominal transceiver speed, in Mbps
contentEncoding: int32
part_no:
type: string
description: Manufacturer part number reported by the SFP module
serial_no:
type: string
description: Manufacturer serial number reported by the SFP module
type:
type: integer
description: Transceiver type code reported by the SFP module
contentEncoding: int32
vendor:
type: string
description: Manufacturer name reported by the SFP module
description: SFP transceiver details reported for a Mist Edge port
stats_mxedge_service_stat:
title: stats_mxedge_service_stat
type: object
properties:
ext_ip:
type: string
description: External IP from ep-terminator’s point of view. valid only for service having its own cloud connection
last_seen:
type: number
description: Cloud Unix time, in seconds, when stats were last seen for this service, or the latest service last_seen time for whole-system records
package_state:
type: string
description: Installation state of the Mist Edge service package
package_version:
type: string
description: Installed version of the Mist Edge service package
running_state:
type: string
description: Runtime state reported by the Mist Edge service
uptime:
type: integer
description: Elapsed running time reported by the Mist Edge service, in seconds
contentEncoding: int32
description: Runtime and package state for one Mist Edge service
stats_mxedge_tunterm_ip_config:
title: stats_mxedge_tunterm_ip_config
type: object
properties:
gateway:
type: string
description: IPv4 default gateway for tunnel termination traffic
examples:
- 192.168.11.1
ip:
type: string
description: Tunnel termination IPv4 address used by the Mist Edge
examples:
- 192.168.11.91
netmask:
type: string
description: IPv4 netmask for the tunnel termination address
examples:
- 255.255.255.0
description: Tunnel termination IP configuration reported by a Mist Edge
stats_mxedge_tunterm_port_config:
title: stats_mxedge_tunterm_port_config
type: object
properties:
downstream_ports:
type: array
items:
type: string
description: Ports configured for downstream tunnel termination traffic
examples:
- - '0'
- '1'
separate_upstream_downstream:
type: boolean
description: Whether separate port sets are used for upstream and downstream tunnel termination traffic
examples:
- false
upstream_ports:
type: array
items:
type: string
description: Ports configured for upstream tunnel termination traffic
examples:
- - '0'
- '1'
description: Tunnel termination port role configuration reported by a Mist Edge
stats_mxedge_tunterm_stat:
title: stats_mxedge_tunterm_stat
type: object
properties:
monitoring_failed:
type: boolean
description: Whether tunnel termination monitoring is currently failing
examples:
- false
description: Tunnel termination monitoring status reported by a Mist Edge
stats_mxtunnel:
title: stats_mxtunnel
required:
- remote_ip
type: object
properties:
ap:
type: string
description: MAC address of the AP associated with the tunnel statistics
readOnly: true
for_site:
type: boolean
description: Whether the tunnel statistics are scoped to a site
readOnly: true
fwupdate:
allOf:
- $ref: '#/components/schemas/fwupdate_stat1'
- description: Firmware update status included with the tunnel statistics, when available
last_seen:
type:
- number
- 'null'
description: Time when the tunnel statistics were last observed
readOnly: true
examples:
- 1470417522
mtu:
type: integer
description: Maximum transmission unit reported for the tunnel path
contentEncoding: int32
readOnly: true
mxcluster_id:
type: string
description: Mist Edge cluster identifier associated with the tunnel statistics
contentEncoding: uuid
readOnly: true
mxedge_id:
type: string
description: Mist Edge identifier for the tunnel endpoint
contentEncoding: uuid
readOnly: true
mxtunnel_id:
type: string
description: Mist tunnel identifier associated with the tunnel statistics
contentEncoding: uuid
readOnly: true
org_id:
type: string
description: Organization identifier associated with the tunnel statistics
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
peer_mxedge_id:
type: string
description: MxEdge ID of the peer(mist edge to mist edge tunnel)
contentEncoding: uuid
readOnly: true
remote_ip:
type: string
description: Remote endpoint IP address for the tunnel
readOnly: true
remote_port:
type: integer
description: Remote endpoint port for the tunnel
contentEncoding: int32
readOnly: true
sessions:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/stats_mxtunnel_session'
description: WxLAN tunnel sessions reported for this tunnel
readOnly: true
site_id:
type: string
description: Site identifier associated with the tunnel statistics
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
start_time:
type: integer
description: Epoch timestamp when the tunnel was established
contentEncoding: int32
readOnly: true
state:
allOf:
- $ref: '#/components/schemas/stats_mxtunnel_state2'
- description: 'Current state of the WxLAN or Mist tunnel. enum: `established`, `established_with_sessions`, `idle`, `wait-ctrl-conn`, `wait-ctrl-reply`.'
readOnly: true
description: WxLAN or Mist tunnel statistics record
stats_mxtunnel_session:
title: stats_mxtunnel_session
required:
- local_sid
- remote_id
- remote_sid
- state
type: object
properties:
local_sid:
type: integer
description: Local session identifier for the tunnel session
contentEncoding: int32
remote_id:
type: string
description: Configured remote identifier for the tunnel session
remote_sid:
type: integer
description: Peer session identifier for the tunnel session
contentEncoding: int32
state:
type: string
description: Current state of the tunnel session
description: Session information for a WxLAN or Mist tunnel
stats_mxtunnel_state:
title: stats_mxtunnel_state
enum:
- established
- established_with_sessions
- idle
- wait-ctrl-conn
- wait-ctrl-reply
type: string
description: 'enum: `established`, `established_with_sessions`, `idle`, `wait-ctrl-conn`, `wait-ctrl-reply`'
stats_org:
title: stats_org
required:
- alarmtemplate_id
- allow_mist
- created_time
- id
- modified_time
- msp_id
- name
- num_devices
- num_devices_connected
- num_devices_disconnected
- num_inventory
- num_sites
- orggroup_ids
- session_expiry
- sle
type: object
properties:
alarmtemplate_id:
type: string
description: Organization-level alarm template identifier used as the default for sites
contentEncoding: uuid
allow_mist:
type: boolean
description: Whether Mist support access is allowed for this organization
created_time:
type: number
description: Time when the organization was created, in epoch seconds
readOnly: true
id:
type: string
description: Unique identifier of the organization
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
modified_time:
type: number
description: Time when the organization was last modified, in epoch seconds
readOnly: true
msp_id:
type: string
description: Managed service provider identifier associated with the organization
contentEncoding: uuid
readOnly: true
examples:
- b9d42c2e-88ee-41f8-b798-f009ce7fe909
name:
type: string
description: Display name of the organization
num_devices:
type: integer
description: Total number of devices in the organization
contentEncoding: int32
num_devices_connected:
type: integer
description: Number of organization devices currently connected to Mist
contentEncoding: int32
num_devices_disconnected:
type: integer
description: Number of organization devices currently disconnected from Mist
contentEncoding: int32
num_inventory:
type: integer
description: Number of devices in the organization's inventory
contentEncoding: int32
num_sites:
type: integer
description: Number of sites in the organization
contentEncoding: int32
orggroup_ids:
type: array
items:
type: string
contentEncoding: uuid
description: Organization group identifiers that include this organization
session_expiry:
type: integer
description: Admin session lifetime for the organization, in minutes
contentEncoding: int64
sle:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/stats_org_sle'
description: Service level expectation summaries for the organization
description: Organization statistics summary returned by the org stats endpoint
stats_org_sle:
title: stats_org_sle
required:
- path
type: object
properties:
path:
type: string
description: SLE path represented by this organization summary
user_minutes:
allOf:
- $ref: '#/components/schemas/stats_org_sle_user_minutes2'
- description: User-minute totals for this SLE path
description: Organization SLE summary for a service path
stats_org_sle_user_minutes:
title: stats_org_sle_user_minutes
required:
- ok
- total
type: object
properties:
ok:
type: number
description: User minutes that met the SLE target
total:
type: number
description: Observed total user minutes for the SLE path
description: User-minute totals for an organization SLE summary
stats_rssi_zone:
title: stats_rssi_zone
required:
- devices
- id
- name
type: object
properties:
assets_wait:
allOf:
- $ref: '#/components/schemas/stats_zone_assets_waits3'
- description: BLE asset wait-time summary for the RSSI zone
clients_wait:
allOf:
- $ref: '#/components/schemas/stats_zone_clients_waits3'
- description: Wi-Fi client wait-time summary for the RSSI zone
created_time:
type: number
description: Time when the RSSI zone was created, in epoch seconds
readOnly: true
devices:
type: array
items:
$ref: '#/components/schemas/stats_rssi_zones_device'
description: AP devices and RSSI thresholds that define the RSSI zone
discovered_assets_wait:
allOf:
- $ref: '#/components/schemas/stats_zone_discovered_assets_waits3'
- description: Discovered BLE asset wait-time summary for the RSSI zone
id:
type: string
description: Unique identifier of the RSSI zone
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
modified_time:
type: number
description: Time when the RSSI zone was last modified, in epoch seconds
readOnly: true
name:
type: string
description: Display name of the RSSI zone
examples:
- Zone A
num_assets:
type: integer
description: Number of BLE assets currently counted in the RSSI zone
contentEncoding: int32
examples:
- 0
num_clients:
type: integer
description: Number of Wi-Fi clients (unconnected + connected)
contentEncoding: int32
examples:
- 80
num_discovered_assets:
type: integer
description: Number of discovered BLE assets currently counted in the RSSI zone
contentEncoding: int32
examples:
- 0
num_sdkclients:
type: integer
description: Number of SDK clients currently counted in the RSSI zone
contentEncoding: int32
examples:
- 10
num_unconnected_clients:
type: integer
description: Number of unconnected Wi-Fi clients
contentEncoding: int32
examples:
- 80
occupancy_limit:
type: integer
description: Configured occupancy limit for the RSSI zone
contentEncoding: int32
examples:
- 4
org_id:
type: string
description: Organization identifier associated with the RSSI zone
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
sdkclients_wait:
allOf:
- $ref: '#/components/schemas/stats_zone_sdkclients_waits3'
- description: SDK client wait-time summary for the RSSI zone
site_id:
type: string
description: Site identifier associated with the RSSI zone
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
unconnected_clients_wait:
allOf:
- $ref: '#/components/schemas/stats_zone_unconnected_clients_waits3'
- description: Unconnected Wi-Fi client wait-time summary for the RSSI zone
description: RSSI-based zone statistics for a site
stats_rssi_zones_device:
title: stats_rssi_zones_device
type: object
properties:
device_id:
type: string
description: Identifier of the AP device used by this RSSI zone
contentEncoding: uuid
rssi:
type: integer
description: Minimum RSSI threshold for considering a device inside the zone
contentEncoding: int32
description: AP device and RSSI threshold used by an RSSI zone
stats_sdkclient:
title: stats_sdkclient
required:
- id
- network_connection
- uuid
type: object
properties:
id:
type: string
description: Unique value identifying the SDK client
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
last_seen:
type:
- number
- 'null'
description: Time when the SDK client was last observed, in epoch seconds
readOnly: true
examples:
- 1470417522
map_id:
type:
- string
- 'null'
description: Map identifier for the SDK client's location, if known
contentEncoding: uuid
examples:
- 845a23bf-bed9-e43c-4c86-6fa474be7ae5
name:
type: string
description: Display name provided for the SDK client
examples:
- John's iPhone
network_connection:
allOf:
- $ref: '#/components/schemas/stats_sdkclient_network_connection1'
- description: Current network connection details for the SDK client
uuid:
type: string
description: Application UUID for the SDK client
contentEncoding: uuid
examples:
- ada72f8f-1643-e5c6-94db-f2a5636f1a64
x:
type: number
description: Horizontal map coordinate of the SDK client location, in pixels, if known
examples:
- 60
y:
type: number
description: Vertical map coordinate of the SDK client location, in pixels, if known
examples:
- 80
description: Detailed statistics for an individual SDK client
stats_sdkclient_network_connection:
title: stats_sdkclient_network_connection
required:
- mac
- rssi
- signal_level
- type
type: object
properties:
mac:
type: string
description: Current network connection MAC address reported for the SDK client
rssi:
type: number
description: Received signal strength indicator for the SDK client's current network connection, in dBm
signal_level:
type: number
description: Numeric signal quality level reported with the SDK client's current network connection
type:
type: string
description: Network connection type reported for the SDK client, such as WiFi
description: Current network connection details reported for an SDK client
stats_site:
title: stats_site
required:
- country_code
- created_time
- id
- latlng
- modified_time
- name
- num_ap
- num_ap_connected
- num_clients
- num_devices
- num_devices_connected
- num_gateway
- num_gateway_connected
- num_switch
- num_switch_connected
- org_id
- timezone
- tzoffset
type: object
properties:
address:
type: string
description: Configured physical address for the site
alarmtemplate_id:
type:
- string
- 'null'
description: Alarm template applied to the site, when one overrides the organization-level alarm template
contentEncoding: uuid
analyticEnabled:
type: boolean
description: Whether analytics features are enabled for the site
aptemplate_id:
type:
- string
- 'null'
description: AP template applied to access points in the site, when configured
contentEncoding: uuid
country_code:
type: string
description: Two-letter country code used for site configuration generation
created_time:
type: number
description: Time when the site was created, in epoch seconds
readOnly: true
engagementEnabled:
type: boolean
description: Whether engagement features are enabled for the site
gatewaytemplate_id:
type:
- string
- 'null'
description: Gateway template applied to gateways in the site, when configured
contentEncoding: uuid
id:
type: string
description: Unique identifier for the site
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
lat:
type: number
description: Geographic latitude coordinate for the site location
latlng:
allOf:
- $ref: '#/components/schemas/lat_lng2'
- description: Latitude and longitude for the site location
lng:
type: number
description: Longitude coordinate for the site location
modified_time:
type: number
description: Time when the site was last modified, in epoch seconds
readOnly: true
msp_id:
type: string
description: Managing MSP identifier for the site, when applicable
contentEncoding: uuid
readOnly: true
examples:
- b9d42c2e-88ee-41f8-b798-f009ce7fe909
name:
type: string
description: Display name of the site
networktemplate_id:
type:
- string
- 'null'
description: Network template applied to the site, when configured
contentEncoding: uuid
notes:
type: string
description: Free-form notes configured for the site
num_ap:
type: integer
description: Number of access points in the site
contentEncoding: int32
num_ap_connected:
type: integer
description: Number of access points currently connected in the site
contentEncoding: int32
num_clients:
type: integer
description: Number of clients currently counted in the site
contentEncoding: int32
num_devices:
type: integer
description: Number of managed devices in the site
contentEncoding: int32
num_devices_connected:
type: integer
description: Number of managed devices currently connected in the site
contentEncoding: int32
num_gateway:
type: integer
description: Number of gateways in the site
contentEncoding: int32
num_gateway_connected:
type: integer
description: Number of gateways currently connected in the site
contentEncoding: int32
num_switch:
type: integer
description: Number of switches in the site
contentEncoding: int32
num_switch_connected:
type: integer
description: Number of switches currently connected in the site
contentEncoding: int32
org_id:
type: string
description: Owning organization identifier for the site
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
rftemplate_id:
type:
- string
- 'null'
description: RF template applied to the site, when configured
contentEncoding: uuid
secpolicy_id:
type:
- string
- 'null'
description: Security policy applied to the site, when configured
contentEncoding: uuid
sitegroup_ids:
type: array
items:
type: string
contentEncoding: uuid
description: Site group identifiers for groups that include this site
sitetemplate_id:
type:
- string
- 'null'
description: Site template applied to the site, when configured
contentEncoding: uuid
timezone:
type: string
description: IANA time zone name for the site
tzoffset:
type: integer
description: Time zone offset value derived from the site's timezone
contentEncoding: int32
description: Site metadata and aggregate device/client counts returned by organization site stats endpoints
stats_switch:
title: stats_switch
required:
- type
type: object
properties:
ap_redundancy:
allOf:
- $ref: '#/components/schemas/stats_switch_ap_redundancy2'
- description: AP redundancy statistics associated with the switch
arp_table_stats:
allOf:
- $ref: '#/components/schemas/arp_table_stats1'
- description: ARP table utilization statistics for the switch
auto_upgrade_stat:
allOf:
- $ref: '#/components/schemas/stats_ap_auto_upgrade2'
- description: Automatic firmware upgrade status for the switch
cert_expiry:
type: integer
description: Time when the switch certificate expires, in epoch seconds
contentEncoding: int64
clients:
type: array
items:
$ref: '#/components/schemas/stats_switch_client_item'
description: Switch port clients currently observed by the switch
clients_stats:
allOf:
- $ref: '#/components/schemas/stats_switch_clients_stats2'
- description: Aggregate client counts reported for the switch
config_status:
type: string
description: Configuration synchronization status reported for the switch
readOnly: true
config_timestamp:
type: integer
description: Time when the switch configuration status was last updated, in epoch seconds
contentEncoding: int32
config_version:
type: integer
description: Currently applied configuration version for the switch
contentEncoding: int32
cpu_stat:
allOf:
- $ref: '#/components/schemas/cpu_stat2'
- description: Processor utilization statistics for the switch
created_time:
type: number
description: Time when the switch record was created, in epoch seconds
readOnly: true
deviceprofile_id:
type:
- string
- 'null'
description: Applied device profile identifier for the switch, when present
contentEncoding: uuid
readOnly: true
dhcpd_stat:
type: object
additionalProperties:
$ref: '#/components/schemas/dhcpd_stat_lan'
description: Lease pool statistics from the switch DHCP service
evpntopo_id:
type:
- string
- 'null'
description: Associated EVPN topology identifier for the switch, when present
contentEncoding: uuid
readOnly: true
ext_ip:
type: string
description: Public IP address observed for the switch
fw_versions_outofsync:
type: boolean
description: Whether firmware versions are out of sync across switch members
readOnly: true
fwupdate:
allOf:
- $ref: '#/components/schemas/fwupdate_stat3'
- description: Firmware update status for the switch
has_pcap:
type: boolean
description: Whether the switch supports packet capture
readOnly: true
examples:
- false
hostname:
type: string
description: Device-reported hostname for the switch
readOnly: true
examples:
- sj-sw1
hw_rev:
type: string
description: Device hardware revision number
id:
type: string
description: Unique identifier of the switch record
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
if_stat:
type: object
additionalProperties:
$ref: '#/components/schemas/if_stat_property'
description: Interface traffic statistics for the switch
ip:
type: string
description: Management IP address reported for the switch
readOnly: true
examples:
- 10.2.11.137
ip_stat:
allOf:
- $ref: '#/components/schemas/ip_stat2'
- description: Layer 3 address statistics for the switch
last_seen:
type:
- number
- 'null'
description: Time when Mist last observed the switch, in epoch seconds
readOnly: true
examples:
- 1470417522
last_trouble:
allOf:
- $ref: '#/components/schemas/last_trouble2'
- description: Most recent trouble-code summary reported for the switch
mac:
type: string
description: Switch MAC address reported by Mist
readOnly: true
mac_table_stats:
allOf:
- $ref: '#/components/schemas/mac_table_stats1'
- description: Layer 2 MAC table utilization statistics for the switch
map_id:
type:
- string
- 'null'
description: Placement map identifier associated with the switch, when present
contentEncoding: uuid
readOnly: true
memory_stat:
allOf:
- $ref: '#/components/schemas/memory_stat2'
- description: Utilization statistics for switch memory
model:
type: string
description: Switch model name reported by Mist
readOnly: true
examples:
- EX4600
modified_time:
type: number
description: Time when the switch record was last modified, in epoch seconds
readOnly: true
module_stat:
minItems: 1
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/stats_switch_module_stat_item'
description: Hardware module statistics for the switch
name:
type: string
description: Device name if configured
readOnly: true
examples:
- sj-sw1
org_id:
type: string
description: Owning organization identifier for the switch statistics record
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
ports:
type: array
items:
$ref: '#/components/schemas/stats_switch_port'
description: Port statistics reported by the switch
route_summary_stats:
allOf:
- $ref: '#/components/schemas/route_summary_stats1'
- description: Route table summary statistics for the switch
serial:
type: string
description: Switch serial number reported by Mist
readOnly: true
examples:
- TC3714190003
service_stat:
type: object
additionalProperties:
$ref: '#/components/schemas/service_stat_property'
description: System service statistics for the switch
site_id:
type: string
description: Associated site identifier for the switch statistics record
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
status:
type: string
description: Connection status reported for the switch, such as connected
readOnly: true
examples:
- connected
tag_id:
type: integer
description: Numeric inventory tag identifier associated with the switch
contentEncoding: int32
tag_uuid:
type: string
description: Inventory tag UUID associated with the switch
contentEncoding: uuid
type:
const: switch
type: string
description: Device type discriminator for switch statistics
uptime:
type:
- number
- 'null'
description: Elapsed time since the switch last booted, in seconds
readOnly: true
examples:
- 13501
vc_mac:
type:
- string
- 'null'
description: Virtual Chassis MAC address reported for the switch, when present
readOnly: true
vc_setup_info:
allOf:
- $ref: '#/components/schemas/stats_switch_vc_setup_info2'
- description: Virtual Chassis setup request and status details for the switch
version:
type:
- string
- 'null'
description: Software version running on the switch
readOnly: true
examples:
- 18.4R1.8
description: Switch statistics reported by Mist for a site or organization stats response
stats_switch_ap_redundancy:
title: stats_switch_ap_redundancy
type: object
properties:
modules:
type: object
additionalProperties:
$ref: '#/components/schemas/stats_switch_ap_redundancy_module'
description: Per-module AP redundancy counts for VC or stacked switches
num_aps:
type: integer
description: Total number of APs considered for switch redundancy
contentEncoding: int32
examples:
- 15
num_aps_with_switch_redundancy:
type: integer
description: Number of APs that have switch redundancy coverage
contentEncoding: int32
examples:
- 8
description: AP switch redundancy coverage summary for a switch
stats_switch_ap_redundancy_module:
title: stats_switch_ap_redundancy_module
type: object
properties:
num_aps:
type: integer
description: Total number of APs connected through this switch member
contentEncoding: int32
examples:
- 15
num_aps_with_switch_redundancy:
type: integer
description: Number of APs on this switch member with switch redundancy coverage
contentEncoding: int32
examples:
- 8
description: AP switch redundancy counts for one VC or stack member
stats_switch_client_item:
title: stats_switch_client_item
type: object
properties:
device_mac:
type: string
description: Switch MAC address for the device reporting this client entry
hostname:
type: string
description: Reported client hostname, when known
mac:
type: string
description: Client MAC address observed on the switch port
port_id:
type: string
description: Switch port identifier where the client was observed
description: Client observed on a switch port in switch statistics
stats_switch_clients_stats:
title: stats_switch_clients_stats
type: object
properties:
total:
allOf:
- $ref: '#/components/schemas/stats_switch_clients_stats_total2'
- description: Aggregate client counts across the switch
description: Aggregate switch client counts
stats_switch_clients_stats_total:
title: stats_switch_clients_stats_total
type: object
properties:
num_aps:
type: array
items:
type: integer
contentEncoding: int32
description: AP counts included in the aggregate switch client statistics
num_wired_clients:
type: integer
description: Number of wired clients included in the aggregate switch client statistics
contentEncoding: int32
description: Total AP and wired-client counts for switch client statistics
stats_switch_module_stat_item:
title: stats_switch_module_stat_item
type: object
properties:
backup_version:
type:
- string
- 'null'
description: Backup software version stored on the switch module
readOnly: true
bios_version:
type:
- string
- 'null'
description: BIOS firmware version reported for the switch module
readOnly: true
boot_partition:
type: string
description: Active boot partition used by the switch module
cpld_version:
type:
- string
- 'null'
description: CPLD firmware version reported for the switch module
readOnly: true
cpu_stat:
allOf:
- $ref: '#/components/schemas/cpu_stat1'
- description: Processor utilization statistics for the switch module
errors:
type: array
items:
$ref: '#/components/schemas/module_stat_item_errors_items'
description: Hardware error records reported for the switch module
fans:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/module_stat_item_fans_items'
description: Cooling fan status records for the switch module
fpc_idx:
type: integer
description: FPC index identifying this switch module
contentEncoding: int32
readOnly: true
fpga_version:
type:
- string
- 'null'
description: FPGA firmware version reported for the switch module
readOnly: true
last_seen:
type:
- number
- 'null'
description: Time when Mist last observed this switch module, in epoch seconds
readOnly: true
examples:
- 1470417522
locating:
type: boolean
description: Whether the switch module locator indicator is active
mac:
type: string
description: Switch module MAC address reported by Mist
examples:
- fc3342123456
memory_stat:
allOf:
- $ref: '#/components/schemas/memory_stat1'
- description: Utilization statistics for switch module memory
model:
type:
- string
- 'null'
description: Switch module model name reported by Mist
readOnly: true
examples:
- EX4300-48P
optics_cpld_version:
type:
- string
- 'null'
description: Optics CPLD firmware version reported for the switch module
readOnly: true
pending_version:
type:
- string
- 'null'
description: Pending software version staged for the switch module
readOnly: true
pics:
type: array
items:
$ref: '#/components/schemas/module_stat_item_pics_item'
description: Physical Interface Card status records for the switch module
poe:
allOf:
- $ref: '#/components/schemas/module_stat_item_poe1'
- description: Power over Ethernet telemetry for the switch module
poe_version:
type:
- string
- 'null'
description: PoE controller firmware version reported for the switch module
readOnly: true
power_cpld_version:
type:
- string
- 'null'
description: Power CPLD firmware version reported for the switch module
readOnly: true
psus:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/module_stat_item_psus_item'
description: Power supply status records for the switch module
re_fpga_version:
type:
- string
- 'null'
description: Routing Engine FPGA firmware version reported for the switch module
readOnly: true
recovery_version:
type:
- string
- 'null'
description: Recovery software version stored on the switch module
readOnly: true
serial:
type:
- string
- 'null'
description: Switch module serial number reported by Mist
readOnly: true
examples:
- PX8716230021
status:
type:
- string
- 'null'
description: Connection status reported for the switch module
readOnly: true
temperatures:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/module_stat_item_temperatures_item'
description: Temperature sensor readings for the switch module
tmc_fpga_version:
type:
- string
- 'null'
description: TMC FPGA firmware version reported for the switch module
readOnly: true
type:
type:
- string
- 'null'
description: Module type reported for the switch module
readOnly: true
uboot_version:
type:
- string
- 'null'
description: U-Boot firmware version reported for the switch module
readOnly: true
uptime:
type:
- integer
- 'null'
description: Elapsed time since the switch module last booted, in seconds
contentEncoding: int32
readOnly: true
vc_links:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/module_stat_item_vc_links_item'
description: Virtual chassis link records for the switch module
vc_mode:
type:
- string
- 'null'
description: Virtual chassis mode reported for the switch module
readOnly: true
vc_role:
type:
- string
- 'null'
description: 'enum: `master`, `backup`, `linecard`'
readOnly: true
examples:
- master
vc_state:
type:
- string
- 'null'
description: Virtual chassis state reported for the switch module
readOnly: true
version:
type:
- string
- 'null'
description: Software version running on the switch module
readOnly: true
description: Hardware module status and firmware inventory for a switch
stats_switch_port_poe_mode:
title: stats_switch_port_poe_mode
enum:
- 802.3af
- 802.3at
- 802.3bt
type: string
description: 'enum: `802.3af`, `802.3at`, `802.3bt`'
stats_switch_port_type:
title: stats_switch_port_type
enum:
- ap
- ble
- gateway
- mxedge
- nac
- switch
type: string
description: 'device type. enum: `ap`, `ble`, `gateway`, `mxedge`, `nac`, `switch`'
examples:
- gateway
stats_switch_vc_setup_info:
title: stats_switch_vc_setup_info
type: object
properties:
config_type:
type: string
description: Provisioning mode used for the Virtual Chassis setup
readOnly: true
examples:
- nonprovisioned
current_stats:
type: string
description: Status currently reported for the Virtual Chassis setup workflow
readOnly: true
examples:
- VCSETUP_WAITING
err_missing_dev_id_fpc:
type: boolean
description: Whether the Virtual Chassis setup is missing a device ID for an FPC member
readOnly: true
last_update:
type: number
description: Most recent update time for the Virtual Chassis setup status
readOnly: true
request_time:
type: number
description: Time when the Virtual Chassis setup request was submitted
readOnly: true
request_type:
type: string
description: Virtual Chassis setup request type
readOnly: true
examples:
- vc_create
description: Virtual Chassis setup request and status details reported by a switch
stats_unconnected_client:
title: stats_unconnected_client
required:
- ap_mac
- mac
- manufacture
- rssi
- y
type: object
properties:
ap_mac:
type: string
description: MAC address of the AP that heard the client
last_seen:
type:
- number
- 'null'
description: Time when Mist last observed the unconnected client, in epoch seconds
readOnly: true
examples:
- 1470417522
mac:
type: string
description: Unconnected client MAC address observed by an AP
manufacture:
type: string
description: Device manufacture, through fingerprinting or OUI
map_id:
type:
- string
- 'null'
description: Map identifier for the unconnected client's location, if known
contentEncoding: uuid
rssi:
type: integer
description: Client RSSI observed by the AP that heard the client (in dBm)
contentEncoding: int32
x:
type: number
description: Horizontal map coordinate of the unconnected client location, in pixels, if known
y:
type: number
description: Vertical map coordinate of the unconnected client location, in pixels, if known
description: Location statistics for an unconnected Wi-Fi client observed by an AP
stats_wan_client:
title: stats_wan_client
type: object
properties:
dhcp_expire_time:
type: number
description: DHCP lease expiration time for the WAN client, in epoch seconds
dhcp_start_time:
type: number
description: DHCP lease start time for the WAN client, in epoch seconds
hostname:
type: array
items:
type: string
description: Observed hostnames for the WAN client during the search window
ip:
type: array
items:
type: string
description: Observed IP addresses for the WAN client during the search window
ip_src:
type: string
description: Source used to learn the WAN client IP address, such as dhcp
examples:
- dhcp
last_hostname:
type: string
description: Most recent hostname observed for the WAN client
examples:
- sonoszp
last_ip:
type: string
description: Most recent IP address observed for the WAN client
examples:
- 192.168.1.139
mfg:
type: string
description: Manufacturer inferred for the WAN client
examples:
- Sonos
network:
type: string
description: Mist network name associated with the WAN client
examples:
- lan
org_id:
type: string
description: Owning organization identifier for the WAN client record
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
site_id:
type: string
description: Site identifier associated with the WAN client record
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
timestamp:
type: number
description: Time when the WAN client record was observed, in epoch seconds
readOnly: true
wcid:
type: string
description: WAN client identifier associated with the record
examples:
- 8bbe7389-212b-c65d-2208-00fab2017936
description: WAN client record returned by WAN client search
stats_wan_tunnel:
title: stats_wan_tunnel
required:
- peer_ip
type: object
properties:
auth_algo:
type: string
description: Authentication algorithm negotiated for the tunnel
encrypt_algo:
type: string
description: Encryption algorithm negotiated for the tunnel
ike_version:
type: string
description: IKE version used to establish the tunnel
ip:
type: string
description: Local IP address used by the tunnel
last_event:
type: string
description: Most recent reason the tunnel went down
mac:
type: string
description: Router MAC address reporting the tunnel statistics
node:
type: string
description: HA node handling the tunnel, such as node0 or node1
org_id:
type: string
description: Organization identifier of the router reporting the tunnel statistics
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
peer_host:
type: string
description: Hostname or configured peer host of the remote tunnel endpoint
peer_ip:
type: string
description: IP address of the remote tunnel endpoint
priority:
allOf:
- $ref: '#/components/schemas/tunnel_priority1'
- description: 'Relative preference assigned to the tunnel. enum: `primary`, `secondary`.'
protocol:
allOf:
- $ref: '#/components/schemas/wan_tunnel_protocol1'
- description: 'Tunnel protocol used for the connection. enum: `gre`, `ipsec`.'
rx_bytes:
type:
- integer
- 'null'
description: Total bytes received on the tunnel
contentEncoding: int64
readOnly: true
examples:
- 8515104416
rx_pkts:
type:
- integer
- 'null'
description: Total packets received on the tunnel
contentEncoding: int64
readOnly: true
examples:
- 57770567
site_id:
type: string
description: Site identifier of the router reporting the tunnel statistics
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
tunnel_name:
type: string
description: Name of the Mist-managed WAN tunnel
tx_bytes:
type:
- integer
- 'null'
description: Total bytes transmitted on the tunnel
contentEncoding: int64
readOnly: true
examples:
- 211217389682
tx_pkts:
type:
- integer
- 'null'
description: Total packets transmitted on the tunnel
contentEncoding: int64
readOnly: true
examples:
- 812204062
up:
type: boolean
description: Indicates whether the tunnel is currently up
uptime:
type: integer
description: Duration since the tunnel security association was established
contentEncoding: int32
wan_name:
type: string
description: Name of the WAN interface carrying the tunnel
examples:
- wan
description: WAN tunnel statistics record returned by tunnel search
stats_wired_client:
title: stats_wired_client
required:
- mac
type: object
properties:
auth_state:
minLength: 1
type: string
description: Authorization state reported for the wired client
device_id:
minLength: 1
type: string
description: Identifier of the AP the wired client is connected to
eth_port:
minLength: 1
type: string
description: AP Ethernet port where the wired client is connected
last_seen:
type: number
description: Time when transmit or receive traffic was last observed for the wired client
mac:
minLength: 1
type: string
description: Wired client MAC address observed on the AP Ethernet port
rx_bytes:
type:
- integer
- 'null'
description: Total bytes received by the wired client connection
contentEncoding: int64
readOnly: true
examples:
- 8515104416
rx_pkts:
type:
- integer
- 'null'
description: Total packets received by the wired client connection
contentEncoding: int64
readOnly: true
examples:
- 57770567
site_id:
type: string
description: Site identifier associated with the wired client statistics record
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
tx_bytes:
type:
- integer
- 'null'
description: Total bytes transmitted by the wired client connection
contentEncoding: int64
readOnly: true
examples:
- 211217389682
tx_pkts:
type:
- integer
- 'null'
description: Total packets transmitted by the wired client connection
contentEncoding: int64
readOnly: true
examples:
- 812204062
uptime:
type: number
description: Elapsed time since the wired client connected, in seconds
vlan_id:
type: number
description: VLAN identifier used by the wired client, when present
description: Wired client statistics for a client connected through an AP Ethernet port
stats_wireless_client:
title: stats_wireless_client
required:
- ap_id
- ap_mac
- band
- channel
- is_guest
- key_mgmt
- mac
- proto
- rssi
- snr
- ssid
- wlan_id
type: object
properties:
accuracy:
type: integer
description: Estimated client location accuracy, in meter
contentEncoding: int32
airespace_ifname:
type: string
description: RADIUS Airespace interface name reported for the wireless client, when available
airwatch:
allOf:
- $ref: '#/components/schemas/stats_wireless_client_airwatch2'
- description: Mobile device management authorization information from AirWatch for the wireless client
annotation:
type: string
description: User-visible annotation label applied to the wireless client
ap_id:
type: string
description: AP ID the client is connected to
contentEncoding: uuid
ap_mac:
type: string
description: AP the client is connected to
assoc_time:
type: integer
description: Time when the wireless client associated to the AP, in epoch seconds
contentEncoding: int32
band:
allOf:
- $ref: '#/components/schemas/dot11_band3'
- description: 'Wi-Fi radio band used by the wireless client connection. enum: `24`, `5`, `5-dedicated`, `5-selectable`, `6`, `6-dedicated`, `6-selectable`.'
bssid:
type: string
description: AP radio BSSID serving the wireless client connection
channel:
type: integer
description: Radio channel used by the wireless client connection
contentEncoding: int32
dual_band:
type: boolean
description: Whether the client is dual_band capable (determined by whether we’ve seen probe requests from both bands)
family:
type: string
description: Device family, through fingerprinting. iPod / Nexus Galaxy / Windows Mobile or CE …
group:
type: string
description: Client group label reported for the wireless client
guest:
allOf:
- $ref: '#/components/schemas/guest1'
- description: Portal guest details for the wireless client
hostname:
type: string
description: DHCP hostname learned for the wireless client
idle_time:
type: number
description: How long, in seconds, has the client been idle (since the last RX packet)
ip:
type: string
description: Current IP address reported for the wireless client
is_guest:
type: boolean
description: Whether this is a guest
key_mgmt:
type: string
description: Security key-management and cipher suite used by the wireless client
last_seen:
type:
- number
- 'null'
description: Time when Mist last observed the wireless client, in epoch seconds
readOnly: true
examples:
- 1470417522
mac:
type: string
description: Wireless client MAC address observed by Mist
manufacture:
type: string
description: Device manufacture, through fingerprinting or OUI
map_id:
type: string
description: Estimated client location - map_id
contentEncoding: uuid
model:
type: string
description: Device model, may be available if we can identify them
mxedge_id:
type: string
description: Mist Edge the wireless client connection is tunneled through, when applicable
contentEncoding: uuid
num_locating_aps:
type: integer
description: Number of APs used to locate this client
contentEncoding: int32
os:
type: string
description: Device os, through fingerprinting
power_saving:
type: boolean
description: If it’s currently in power-save mode
proto:
allOf:
- $ref: '#/components/schemas/dot11_proto2'
- description: '802.11 protocol amendment used by the wireless client. enum: `a`, `ac`, `ax`, `b`, `be`, `g`, `n`.'
psk_id:
type: string
description: PSK id (if multi-psk is used)
contentEncoding: uuid
rssi:
type: number
description: Received signal strength indicator for the wireless client, in dBm
rssizones:
type: array
items:
$ref: '#/components/schemas/stats_wireless_client_rssi_zone'
description: RSSI zone memberships for the wireless client
rx_bps:
type:
- integer
- 'null'
description: Receive throughput for the wireless client, in bits per second
contentEncoding: int64
readOnly: true
examples:
- 60003
rx_bytes:
type:
- integer
- 'null'
description: Total bytes received by the wireless client connection
contentEncoding: int64
readOnly: true
examples:
- 8515104416
rx_pkts:
type:
- integer
- 'null'
description: Total packets received by the wireless client connection
contentEncoding: int64
readOnly: true
examples:
- 57770567
rx_rate:
type:
- number
- 'null'
description: Receive PHY rate for the wireless client connection, in Mbps
readOnly: true
rx_retries:
type:
- integer
- 'null'
description: Receive retry count for the wireless client connection
contentEncoding: int32
readOnly: true
site_id:
type: string
description: Site identifier associated with the wireless client statistics record
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
snr:
type: number
description: Signal-to-noise ratio for the wireless client connection
ssid:
type: string
description: Wireless SSID used by the client connection
tx_bps:
type:
- integer
- 'null'
description: Transmit throughput for the wireless client, in bits per second
contentEncoding: int64
readOnly: true
examples:
- 634301
tx_bytes:
type:
- integer
- 'null'
description: Total bytes transmitted by the wireless client connection
contentEncoding: int64
readOnly: true
examples:
- 211217389682
tx_pkts:
type:
- integer
- 'null'
description: Total packets transmitted by the wireless client connection
contentEncoding: int64
readOnly: true
examples:
- 812204062
tx_rate:
type:
- number
- 'null'
description: Transmit PHY rate for the wireless client connection, in Mbps
readOnly: true
tx_retries:
type:
- integer
- 'null'
description: Transmit retry count for the wireless client connection
contentEncoding: int32
readOnly: true
type:
type: string
description: Client’s type, regular / vip / resource / blocked (if client object is created)
uptime:
type: number
description: How long, in seconds, has the client been connected
username:
type: string
description: User identity learned from 802.1X, per-user PSK, or user portal authentication
vbeacons:
type: array
items:
$ref: '#/components/schemas/stats_wireless_client_vbeacon'
description: Virtual beacon associations for the wireless client
vlan_id:
type: string
description: VLAN ID, could be empty (from older AP)
wlan_id:
type: string
description: WLAN ID the client is connected to
contentEncoding: uuid
wxrule_id:
type: string
description: Current WxlanRule using for a Client or an authorized Guest (portal user). null if default rule is matched.
contentEncoding: uuid
wxrule_usage:
type: array
items:
$ref: '#/components/schemas/stats_wireless_client_wxrule_usage'
description: WxLAN rule usage counters for the wireless client
x:
type: number
description: Estimated client location in pixels
x_m:
type: number
description: Estimated client location in meter
y:
type: number
description: Estimated client location in pixels
y_m:
type: number
description: Estimated client location in meter
zones:
type: array
items:
$ref: '#/components/schemas/stats_wireless_client_zone'
description: Zone memberships for the wireless client
description: Wireless client connection, traffic, and location statistics
stats_wireless_client_airwatch:
title: stats_wireless_client_airwatch
required:
- authorized
type: object
properties:
authorized:
type: boolean
description: Whether the wireless client is authorized by AirWatch
description: AirWatch authorization information reported for a wireless client
stats_wireless_client_rssi_zone:
title: stats_wireless_client_rssi_zone
type: object
properties:
id:
type: string
description: RSSI zone identifier that currently contains the wireless client
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
since:
type: number
description: Time when the wireless client entered the RSSI zone, in epoch seconds
description: RSSI zone currently containing a wireless client
stats_wireless_client_vbeacon:
title: stats_wireless_client_vbeacon
type: object
properties:
id:
type: string
description: Virtual beacon identifier currently associated with the wireless client
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
since:
type: number
description: Time when the wireless client began matching the virtual beacon, in epoch seconds
description: Virtual beacon currently associated with a wireless client
stats_wireless_client_wxrule_usage:
title: stats_wireless_client_wxrule_usage
type: object
properties:
tag_id:
type: string
description: WxLAN tag identifier for this rule usage entry
contentEncoding: uuid
usage:
type: integer
description: Count recorded for this WxLAN rule usage entry
contentEncoding: int32
description: WxLAN rule usage counter for one wireless tag
stats_wireless_client_zone:
title: stats_wireless_client_zone
type: object
properties:
id:
type: string
description: Zone identifier that currently contains the wireless client
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
since:
type: number
description: Time when the wireless client entered the zone, in epoch seconds
description: Zone currently containing a wireless client
stats_wxrule:
title: stats_wxrule
required:
- action
- client_mac
- dst_allow_wxtags
- dst_deny_wxtags
- dst_wxtags
- name
- order
- src_wxtags
- usage
type: object
properties:
action:
allOf:
- $ref: '#/components/schemas/stats_wxrule_action2'
- description: Allow or block behavior enforced by this WxLAN rule
examples:
- allow
client_mac:
type: array
items:
type: string
description: Wireless client MAC addresses matching this WxLAN rule
examples:
- - 3bbbf819bb6f
- bd96cbc4910f
dst_allow_wxtags:
type: array
items:
type: string
contentEncoding: uuid
description: Destination WxLAN tags explicitly allowed by this rule
examples:
- - fff34466-eec0-3756-6765-381c728a6037
- eee2c7b0-d1d0-5a30-f349-e35fa43dc3b3
dst_deny_wxtags:
type: array
items:
type: string
contentEncoding: uuid
description: Destination WxLAN tags denied by this rule
examples:
- - aaa34466-eec0-3756-6765-381c728a6037
- bbb2c7b0-d1d0-5a30-f349-e35fa43dc3b3
dst_wxtags:
type: array
items:
type: string
contentEncoding: uuid
description: Destination WxLAN tags matched by this rule
examples:
- - d4134466-eec0-3756-6765-381c728a6037
- 1a42c7b0-d1d0-5a30-f349-e35fa43dc3b3
name:
type: string
description: Display name of the WxLAN rule
examples:
- Guest
order:
type: integer
description: Rule evaluation order for WxLAN matching
contentEncoding: int32
examples:
- 1
src_wxtags:
type: array
items:
type: string
contentEncoding: uuid
description: Source WxLAN tags matched by this rule
examples:
- - 8bfc2490-d726-3587-038d-cb2e71bd2330
- 3aa8e73f-9f46-d827-8d6a-567bb7e67fc9
usage:
type: object
additionalProperties:
$ref: '#/components/schemas/stats_wxrule_usage_properties'
description: Flow counts keyed by destination WxLAN tag identifier
examples:
- 1a42c7b0-d1d0-5a30-f349-e35fa43dc3b3:
num_flows: 60
d4134466-eec0-3756-6765-381c728a6037:
num_flows: 60
description: WxLAN rule usage statistics for a site
stats_wxrule_action:
title: stats_wxrule_action
enum:
- allow
- block
type: string
description: 'Allow or block behavior enforced by this WxLAN rule. enum: `allow`, `block`'
examples:
- allow
stats_wxrule_usage_properties:
title: stats_wxrule_usage_properties
type: object
properties:
num_flows:
type: integer
description: Number of flows counted for this WxLAN rule and destination tag
contentEncoding: int32
description: Usage counters for one WxLAN rule destination tag
stats_zone:
title: stats_zone
required:
- id
- map_id
- name
type: object
properties:
assets_wait:
allOf:
- $ref: '#/components/schemas/stats_zone_assets_waits1'
- description: BLE asset wait-time summary for the zone
clients_wait:
allOf:
- $ref: '#/components/schemas/stats_zone_clients_waits1'
- description: Wi-Fi client wait-time summary for the zone
created_time:
type: number
description: Time when the zone was created, in epoch seconds
readOnly: true
discovered_assets_wait:
allOf:
- $ref: '#/components/schemas/stats_zone_discovered_assets_waits1'
- description: Discovered BLE asset wait-time summary for the zone
id:
type: string
description: Unique identifier of the zone
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
map_id:
type: string
description: Map identifier for the zone
contentEncoding: uuid
examples:
- 123449d4-d12f-4feb-b40f-5be0e2ae1234
modified_time:
type: number
description: Time when the zone was last modified, in epoch seconds
readOnly: true
name:
type: string
description: Display name of the zone
examples:
- Zone A
num_assets:
type: integer
description: Number of BLE assets currently counted in the zone
contentEncoding: int32
examples:
- 0
num_clients:
type: integer
description: Number of Wi-Fi clients currently counted in the zone, including connected and unconnected clients
contentEncoding: int32
examples:
- 80
num_discovered_assets:
type: integer
description: Number of discovered BLE assets currently counted in the zone
contentEncoding: int32
examples:
- 0
num_sdkclients:
type: integer
description: Number of SDK clients currently counted in the zone
contentEncoding: int32
examples:
- 10
num_unconnected_clients:
type: integer
description: Number of unconnected Wi-Fi clients currently counted in the zone
contentEncoding: int32
examples:
- 80
occupancy_limit:
type: integer
description: Configured occupancy limit for the zone
contentEncoding: int32
examples:
- 4
org_id:
type: string
description: Organization identifier associated with the zone
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
sdkclients_wait:
allOf:
- $ref: '#/components/schemas/stats_zone_sdkclients_waits1'
- description: SDK client wait-time summary for the zone
site_id:
type: string
description: Site identifier associated with the zone
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
unconnected_clients_wait:
allOf:
- $ref: '#/components/schemas/stats_zone_unconnected_clients_waits1'
- description: Unconnected Wi-Fi client wait-time summary for the zone
vertices:
type: array
items:
$ref: '#/components/schemas/zone_vertex'
description: Zone polygon vertices in map pixel coordinates
examples:
- - x: 732
y: 1821
- x: 732.5
y: 1731
- x: 837.5
y: 1731.5
- x: 839
y: 1821
vertices_m:
type: array
items:
$ref: '#/components/schemas/zone_vertex_m'
description: Zone polygon vertices in meters
examples:
- - x: 24.1983341951072
y: 60.198314985369144
- x: 24.21486311190714
y: 57.22310996138056
- x: 27.685935639893827
y: 57.23963887818049
- x: 27.73552239029364
y: 60.198314985369144
description: Zone statistics and occupancy counts for a site map zone
stats_zone_assets_waits:
title: stats_zone_assets_waits
type: object
properties:
avg:
type: number
description: Average wait time in seconds
examples:
- 0
max:
type: number
description: Longest wait time in seconds
examples:
- 0
min:
type: number
description: Shortest wait time in seconds
examples:
- 0
p95:
type: number
description: 95th percentile of all the wait time(s)
examples:
- 0
description: BLE asset wait time right now
stats_zone_clients_waits:
title: stats_zone_clients_waits
type: object
properties:
avg:
type: number
description: Average wait time in seconds
examples:
- 1200
max:
type: number
description: Longest wait time in seconds
examples:
- 3610
min:
type: number
description: Shortest wait time in seconds
examples:
- 600
p95:
type: number
description: 95th percentile of all the wait time(s)
examples:
- 2800
description: Client wait time right now
stats_zone_details:
title: stats_zone_details
required:
- client_waits
- id
- map_id
- name
- num_clients
- num_sdkclients
type: object
properties:
assets:
type: array
items:
type: string
description: BLE asset identifiers currently in the zone
client_waits:
allOf:
- $ref: '#/components/schemas/stats_zone_details_client_waits2'
- description: Wi-Fi client wait-time summary for the zone
clients:
type: array
items:
type: string
description: Wi-Fi client MAC addresses currently in the zone
id:
type: string
description: Unique identifier of the zone
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
map_id:
type: string
description: Map identifier for the zone
contentEncoding: uuid
examples:
- 63eda950-c6da-11e4-a628-60f81dd250cc
name:
type: string
description: Display name of the zone
examples:
- Board Room
num_clients:
type: integer
description: Number of Wi-Fi clients currently counted in the zone
contentEncoding: int32
examples:
- 80
num_sdkclients:
type: integer
description: Number of SDK clients currently counted in the zone
contentEncoding: int32
examples:
- 0
sdkclients:
type: array
items:
type: string
description: SDK client identifiers currently in the zone
description: Detailed zone statistics and occupants for a site map zone
stats_zone_details_client_waits:
title: stats_zone_details_client_waits
required:
- avg
- max
- min
- p95
type: object
properties:
avg:
type: integer
description: Average wait time in seconds
contentEncoding: int32
examples:
- 1200
max:
type: integer
description: Longest wait time in seconds
contentEncoding: int32
examples:
- 3610
min:
type: integer
description: Shortest wait time in seconds
contentEncoding: int32
examples:
- 600
p95:
type: integer
description: 95th percentile of all the wait time(s)
contentEncoding: int32
examples:
- 2800
description: Client wait time right now
stats_zone_discovered_assets_waits:
title: stats_zone_discovered_assets_waits
type: object
properties:
avg:
type: number
description: Average wait time in seconds
examples:
- 0
max:
type: number
description: Longest wait time in seconds
examples:
- 0
min:
type: number
description: Shortest wait time in seconds
examples:
- 0
p95:
type: number
description: 95th percentile of all the wait time(s)
examples:
- 0
description: Discovered asset wait time right now
stats_zone_sdkclients_waits:
title: stats_zone_sdkclients_waits
type: object
properties:
avg:
type: number
description: Average wait time in seconds
examples:
- 0
max:
type: number
description: Longest wait time in seconds
examples:
- 0
min:
type: number
description: Shortest wait time in seconds
examples:
- 0
p95:
type: number
description: 95th percentile of all the wait time(s)
examples:
- 0
description: SDK client wait time right now
stats_zone_unconnected_clients_waits:
title: stats_zone_unconnected_clients_waits
type: object
properties:
avg:
type: number
description: Average wait time in seconds
examples:
- 0
max:
type: number
description: Longest wait time in seconds
examples:
- 0
min:
type: number
description: Shortest wait time in seconds
examples:
- 0
p95:
type: number
description: 95th percentile of all the wait time(s)
examples:
- 0
description: Unconnected Wi-Fi client wait time right now
support_contract_status:
title: support_contract_status
enum:
- Active
- Declined
- EOL
- Service Available
type: string
description: 'Service contract status. enum: `Active`, `Declined`, `EOL`, `Service Available`'
suppressed_alarm:
title: suppressed_alarm
type: object
properties:
applies:
allOf:
- $ref: '#/components/schemas/suppressed_alarm_applies2'
- description: If `scope`==`site`. Site and site-group targets where alarms are suppressed
duration:
maximum: 15552000
minimum: 0
type: number
description: Suppression length, in seconds. Maximum duration is 86400 * 180 (180 days). 0 is to un-suppress alarms
default: 3600
scheduled_time:
type: integer
description: Time when alarm suppression starts, in epoch seconds. Defaults to now; accepted range is from now to now + 7 days
contentEncoding: int32
scope:
allOf:
- $ref: '#/components/schemas/suppressed_alarm_scope1'
- description: 'Alarm suppression target level. enum: `org`, `site`.'
description: Request body for suppressing organization alarms
suppressed_alarm_applies:
title: suppressed_alarm_applies
type: object
properties:
org_id:
type: string
description: UUID of the current org (if provided, the alarms will be suppressed at org level)
contentEncoding: uuid
site_ids:
type: array
items:
type: string
contentEncoding: uuid
description: Site identifiers included in the suppression scope. If provided, alarms are suppressed for the listed sites.
sitegroup_ids:
type: array
items:
type: string
contentEncoding: uuid
description: Site group identifiers included in the suppression scope. If provided, alarms are suppressed for all sites in the listed site groups.
description: If `scope`==`site`. Object defines the scope (within the org e.g. whole org, and/or some site_groups, and/or some sites) for which the alarm service has to be suppressed for some `duration`
suppressed_alarm_scope:
title: suppressed_alarm_scope
enum:
- org
- site
type: string
description: 'level of scope. enum: `org`, `site`'
sw_routing_policy:
title: sw_routing_policy
type: object
properties:
terms:
minItems: 1
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/sw_routing_policy_term'
description: Ordered terms evaluated by this switch routing policy
description: Switch routing policy made of ordered match-action terms
sw_routing_policy_term:
title: sw_routing_policy_term
required:
- name
type: object
properties:
actions:
allOf:
- $ref: '#/components/schemas/sw_routing_policy_term_action2'
- description: Policy actions applied when this routing policy term matches
matching:
allOf:
- $ref: '#/components/schemas/sw_routing_policy_term_matching2'
- description: Route match criteria that must be satisfied before actions are applied
name:
type: string
description: Display name of the switch routing policy term
description: Switch routing policy term with match criteria and actions
sw_routing_policy_term_action:
title: sw_routing_policy_term_action
type: object
properties:
accept:
type: boolean
description: Whether to accept routes that match this term
community:
type: array
items:
type: string
description: BGP communities to set when this term is used as an export policy
local_preference:
anyOf:
- type: string
- maximum: 4294967295
minimum: 1
type: integer
contentEncoding: int32
description: Preference value to set when this term is used as an import policy
prepend_as_path:
type: array
items:
type: string
description: AS path values to prepend when this term is used as an export policy
description: Actions applied to routes matched by a switch routing policy term
sw_routing_policy_term_matching:
title: sw_routing_policy_term_matching
type: object
properties:
as_path:
type: array
items:
$ref: '#/components/schemas/bgp_as'
description: AS path values that routes must match
community:
type: array
items:
type: string
description: BGP communities that routes must match
prefix:
type: array
items:
type: string
description: Route prefixes that routes must match
protocol:
type: array
items:
$ref: '#/components/schemas/sw_routing_policy_term_matching_protocol_enum'
description: Routing protocols that routes must match
description: Route match criteria for a switch routing policy term; all specified criteria must match
sw_routing_policy_term_matching_protocol_enum:
title: sw_routing_policy_term_matching_protocol_enum
enum:
- bgp
- direct
- evpn
- ospf
- static
type: string
description: 'enum: `bgp`, `direct`, `evpn`, `ospf`, `static`'
switch_auto_upgrade:
title: switch_auto_upgrade
type: object
properties:
custom_versions:
type: object
additionalProperties:
type: string
description: Per-model switch firmware versions to use for auto-upgrade
examples:
- QFX5120-32C: 23.4R2-S2.1
QFX5130-32CD: 23.4R2-S2.3
enabled:
type: boolean
description: Whether switch auto-upgrade is enabled
snapshot:
type: boolean
description: Whether to create a recovery snapshot during the upgrade process
default: false
description: Switch firmware auto-upgrade settings
switch_auto_upgrade_container:
title: switch_auto_upgrade_container
type: object
properties:
auto_upgrade:
allOf:
- $ref: '#/components/schemas/switch_auto_upgrade1'
- description: Switch firmware auto-upgrade configuration
description: Wrapper for switch firmware auto-upgrade settings
switch_bgp_config:
title: switch_bgp_config
required:
- local_as
- type
type: object
properties:
auth_key:
type: string
description: Authentication key used for BGP neighbor sessions, when configured
bfd_minimum_interval:
maximum: 255000
minimum: 1
type: integer
description: Minimum interval in milliseconds for BFD hello packets. A neighbor is considered failed when the device stops receiving replies after the specified interval. Value must be between 1 and 255000.
contentEncoding: int32
export_policy:
type: string
description: Export policy must match one of the policy names defined in the `routing_policies` property.
hold_time:
oneOf:
- $ref: '#/components/schemas/switch_bgp_config_hold_time_zero'
- maximum: 65535
minimum: 3
type: integer
contentEncoding: int32
description: 'Default BGP hold time for switch BGP sessions. enum: `0`.'
import_policy:
type: string
description: Import policy must match one of the policy names defined in the `routing_policies` property.
local_as:
anyOf:
- type: string
- maximum: 4294967294
minimum: 1
type: integer
contentEncoding: int32
description: Local BGP Autonomous System (AS) number for the switch
examples:
- '65000'
neighbors:
type: object
additionalProperties:
$ref: '#/components/schemas/switch_bgp_config_neighbor'
description: BGP neighbor settings keyed by neighbor IP address
networks:
type: array
items:
type: string
description: Network names used to add BGP groups to the corresponding VRFs
type:
allOf:
- $ref: '#/components/schemas/switch_bgp_config_type2'
- description: 'BGP session type for this switch BGP configuration. enum: `external`, `internal`.'
description: Switch BGP configuration for a routing instance
switch_bgp_config_hold_time_zero:
title: switch_bgp_config_hold_time_zero
const: 0
type: integer
description: BGP hold time value of 0
switch_bgp_config_neighbor:
title: switch_bgp_config_neighbor
required:
- neighbor_as
type: object
properties:
export_policy:
type: string
description: Export policy must match one of the policy names defined in the `routing_policies` property.
hold_time:
oneOf:
- $ref: '#/components/schemas/switch_bgp_config_hold_time_zero'
- maximum: 65535
minimum: 3
type: integer
contentEncoding: int32
description: 'BGP hold time for this neighbor. enum: `0`.'
import_policy:
type: string
description: Import policy must match one of the policy names defined in the `routing_policies` property.
multihop_ttl:
maximum: 255
minimum: 1
type: integer
description: Time-to-live value for multihop BGP sessions to this neighbor
contentEncoding: int32
neighbor_as:
anyOf:
- type: string
- maximum: 4294967294
minimum: 1
type: integer
contentEncoding: int32
description: Autonomous System (AS) number of the BGP neighbor. For internal BGP, this must match `local_as`. For external BGP, this must differ from `local_as`.
examples:
- '65000'
description: Per-neighbor switch BGP session settings
switch_bgp_config_type:
title: switch_bgp_config_type
enum:
- external
- internal
type: string
description: 'BGP session type for this switch BGP configuration. enum: `external`, `internal`'
switch_dhcpd_config:
title: switch_dhcpd_config
type: object
properties:
enabled:
type: boolean
description: Whether switch DHCP server or relay configuration is enabled
default: false
additionalProperties:
allOf:
- $ref: '#/components/schemas/switch_dhcpd_config_property'
- description: DHCP server or relay configuration for one switch network. 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 used here (e.g. "net1,net2")
description: Switch DHCP server or relay configuration keyed by network name
switch_dhcpd_config_property:
title: switch_dhcpd_config_property
type: object
properties:
dns_servers:
type: array
items:
type: string
description: If `type`==`server` or `type6`==`server`, DNS servers advertised to DHCP clients
examples:
- - 8.8.8.8
- 4.4.4.4
- 2001:4860:4860::8888
dns_suffix:
type: array
items:
type: string
description: If `type`==`server` or `type6`==`server`, DNS search suffixes advertised to DHCP clients
examples:
- - .mist.local
- .mist.com
fixed_bindings:
type: object
additionalProperties:
$ref: '#/components/schemas/dhcpd_config_fixed_binding'
description: If `type`==`server` or `type6`==`server`, fixed client bindings for DHCP service
examples:
- 5684dae9ac8b:
ip: 192.168.70.35
name: John
gateway:
type: string
description: If `type`==`server` - optional, `ip` will be used if not provided
examples:
- 192.168.70.1
ip_end:
type: string
description: If `type`==`server`, ending IPv4 address for the DHCP lease pool
examples:
- 192.168.70.200
ip_end6:
type: string
description: If `type6`==`server`, ending IPv6 address for the DHCP lease pool
examples:
- 2607:f8b0:4005:808::ff
ip_start:
type: string
description: If `type`==`server`, starting IPv4 address for the DHCP lease pool
examples:
- 192.168.70.100
ip_start6:
type: string
description: If `type6`==`server`, starting IPv6 address for the DHCP lease pool
examples:
- 2607:f8b0:4005:808::2
lease_time:
maximum: 604800
minimum: 3600
type: integer
description: In seconds, lease time has to be between 3600 [1hr] - 604800 [1 week], default is 86400 [1 day]
contentEncoding: int32
default: 86400
options:
type: object
additionalProperties:
$ref: '#/components/schemas/dhcpd_config_option'
description: If `type`==`server` or `type6`==`server`, custom DHCP options advertised to clients
server_id_override:
type: boolean
description: "`server_id_override`==`true` means the device, when acts as DHCP relay and forwards DHCP responses from DHCP server to clients, \nshould overwrite the Sever Identifier option (i.e. DHCP option 54) in DHCP responses with its own IP address."
default: false
servers:
type: array
items:
type: string
description: If `type`==`relay`, upstream IPv4 DHCP servers
examples:
- - 11.2.3.4
servers6:
type: array
items:
type: string
description: If `type6`==`relay`, upstream IPv6 DHCP servers
examples:
- - 2607:f8b0:4005:808::64
type:
allOf:
- $ref: '#/components/schemas/switch_dhcpd_config_type2'
- description: 'IPv4 DHCP mode for this switch network. enum: `none`, `relay`, `server`.'
type6:
allOf:
- $ref: '#/components/schemas/switch_dhcpd_config_type62'
- description: 'IPv6 DHCP mode for this switch network. enum: `none`, `relay`, `server`.'
vendor_encapsulated:
type: object
additionalProperties:
$ref: '#/components/schemas/dhcpd_config_vendor_option'
description: If `type`==`server` or `type6`==`server`, vendor-encapsulated DHCP options advertised to clients
description: DHCP server or relay configuration for one switch network. 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 used here (e.g. "net1,net2")
switch_dhcpd_config_type:
title: switch_dhcpd_config_type
enum:
- none
- relay
- server
type: string
description: 'enum: `none`, `relay` (DHCP Relay), `server` (DHCP Server)'
switch_iot_port:
title: switch_iot_port
type: object
properties:
alarm_class:
allOf:
- $ref: '#/components/schemas/switch_iot_port_alarm_class2'
- description: 'Alarm severity class raised for input-triggered switch IOT port events. enum: `minor`, `major`.'
enabled:
type: boolean
description: Whether this switch IOT port is enabled
default: false
input_src:
allOf:
- $ref: '#/components/schemas/switch_iot_port_input_src2'
- description: 'Only for `OUT` ports. Input port that triggers this output port. enum: `IN0`, `IN1`.'
name:
type: string
description: Display name for the switch IOT port
description: Switch IOT port configuration
switch_iot_port_alarm_class:
title: switch_iot_port_alarm_class
enum:
- minor
- major
type: string
description: 'Alarm class for the switch iot port in. enum: `minor`, `major`'
switch_iot_port_input_src:
title: switch_iot_port_input_src
enum:
- IN0
- IN1
type: string
description: 'Only for "OUT" ports, input source for the switch iot port out. enum: `IN0`, `IN1`'
switch_matching:
title: switch_matching
type: object
properties:
enable:
type: boolean
description: Whether custom switch matching rules are enabled
rules:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/switch_matching_rule'
description: Switch matching rules evaluated to apply custom configuration
description: Defines custom switch configuration based on different criteria
switch_matching_rule:
title: switch_matching_rule
type: object
properties:
additional_config_cmds:
type: array
items:
type: string
description: Additional Junos CLI commands applied when this matching rule matches
default_port_usage:
type: string
description: 'Port usage to assign to switch ports without any port usage assigned. Default: `default` to preserve default behavior'
default: default
ip_config:
allOf:
- $ref: '#/components/schemas/switch_matching_rule_ip_config2'
- description: In-band management IP configuration applied when this matching rule matches
name:
maxLength: 32
minLength: 1
type: string
description: 'Rule name. WARNING: the name `default` is reserved and can only be used for the last rule in the list'
oob_ip_config:
allOf:
- $ref: '#/components/schemas/switch_matching_rule_oob_ip_config2'
- description: Out-of-band management IP configuration applied when this matching rule matches
port_config:
type: object
additionalProperties:
$ref: '#/components/schemas/junos_port_config'
description: Per-port wired configuration applied when this matching rule matches
port_mirroring:
type: object
additionalProperties:
$ref: '#/components/schemas/switch_port_mirroring_property'
description: Port mirroring configuration applied when this matching rule matches
stp_config:
allOf:
- $ref: '#/components/schemas/switch_stp_config2'
- description: Spanning Tree Protocol configuration applied when this matching rule matches
switch_mgmt:
allOf:
- $ref: '#/components/schemas/switch_mgmt2'
- description: Management-plane settings applied when this matching rule matches
additionalProperties:
type: string
description: >-
Property key defines the type of matching, value is the string to match. e.g:
* `match_name[0:3]`: switch name must match the first 3 letters of the property value
* `match_name[2:6]`: switch name must match the property value from the 2nd to the 6th letter
* `match_model[0-8]`: switch model must match the first 8 letters of the property value
* `match_role`: switch role must match the property value
examples:
- match_model: EX4300
match_name[0:3]: abc
switch_matching_rule_ip_config:
title: switch_matching_rule_ip_config
type: object
properties:
network:
type: string
description: VLAN Name for the management interface
type:
allOf:
- $ref: '#/components/schemas/ip_type11'
- description: 'IP assignment mode for in-band switch management. enum: `dhcp`, `static`.'
examples:
- static
description: In-Band Management interface configuration
switch_matching_rule_oob_ip_config:
title: switch_matching_rule_oob_ip_config
type: object
properties:
type:
allOf:
- $ref: '#/components/schemas/ip_type12'
- description: 'IP assignment mode for out-of-band switch management. enum: `dhcp`, `static`.'
examples:
- static
use_mgmt_vrf:
type: boolean
description: If supported on the platform. If enabled, DNS will be using this routing-instance, too
default: false
use_mgmt_vrf_for_host_out:
type: boolean
description: For host-out traffic (NTP/TACPLUS/RADIUS/SYSLOG/SNMP), if alternative source network/ip is desired
default: false
description: Out-of-Band Management interface configuration
switch_metric_scope:
title: switch_metric_scope
enum:
- site
- switch
type: string
description: 'Scope level used when querying switch metrics. enum: `site`, `switch`'
switch_metric_type:
title: switch_metric_type
const: active_ports_summary
type: string
description: 'Switch metric type requested for active port summaries. enum: `active_ports_summary`'
switch_metrics_active_ports_summary_details:
title: switch_metrics_active_ports_summary_details
type: object
properties:
active_port_count:
type: integer
description: Number of active ports observed across evaluated switches
contentEncoding: int32
total_port_count:
type: integer
description: Total number of ports evaluated for the active-port metric
contentEncoding: int32
description: Port counts used by the active-port switch metric
switch_metrics_compliance_major_version:
title: switch_metrics_compliance_major_version
type: object
properties:
major_count:
type: integer
description: Number of switches in this software version grouping
contentEncoding: int32
major_version:
type: string
description: Software version represented by this compliance grouping
model:
type: string
description: Switch model represented by this compliance grouping
system_names:
uniqueItems: true
type: array
items:
type: string
description: Switch system names included in this compliance grouping
description: Version compliance grouping for one switch model
switch_mgmt:
title: switch_mgmt
type: object
properties:
ap_affinity_threshold:
type: integer
description: AP affinity threshold for switch management. If set in both site settings and organization settings, the site setting value is used.
contentEncoding: int32
default: 10
cli_banner:
type: string
description: Set Banners for switches. Allows markup formatting
examples:
- '\t\tWELCOME!'
cli_idle_timeout:
maximum: 60
minimum: 1
type: integer
description: Sets timeout for switches
contentEncoding: int32
config_revert_timer:
maximum: 30
minimum: 1
type: integer
description: Rollback timer for commit confirmed
contentEncoding: int32
default: 10
dhcp_option_fqdn:
type: boolean
description: Enable to provide the FQDN with DHCP option 81
default: false
disable_oob_down_alarm:
type: boolean
description: Whether to suppress alarms when the switch out-of-band management interface is down
fips_enabled:
type: boolean
description: Whether FIPS mode is enabled on the switch
default: false
local_accounts:
type: object
additionalProperties:
$ref: '#/components/schemas/config_switch_local_accounts_user'
description: Local switch user accounts keyed by username
mxedge_proxy_host:
type: string
description: IP address or FQDN of the Mist Edge used to proxy the switch management traffic to the Mist Cloud
mxedge_proxy_port:
anyOf:
- maximum: 65535
minimum: 1
type: integer
contentEncoding: int32
default: 2222
- type: string
description: Mist Edge proxy port used for switch management traffic
protect_re:
allOf:
- $ref: '#/components/schemas/protect_re3'
- description: Control-plane protection settings for the switch
radius:
allOf:
- $ref: '#/components/schemas/switch_radius2'
- description: Management authentication settings using RADIUS
remove_existing_configs:
type: boolean
description: By default, only the configuration generated by Mist is cleaned up during the configuration process. If `true`, all the existing configuration will be removed.
default: false
root_password:
type: string
description: Root password for local switch access
contentEncoding: password
tacacs:
allOf:
- $ref: '#/components/schemas/tacacs2'
- description: Management authentication settings using TACACS+
use_mxedge_proxy:
type: boolean
description: Whether to use Mist Edge as a proxy for switch management traffic
description: Switch management-plane access and proxy settings
switch_mist_nac:
title: switch_mist_nac
type: object
properties:
enabled:
type: boolean
description: Whether Mist NAC RadSec is enabled for the switch
network:
type: string
description: Switch network used for Mist NAC RadSec connectivity
description: Mist NAC RadSec settings for a switch
switch_multicast_config:
title: switch_multicast_config
type: object
properties:
anycast_rp:
type: boolean
description: When `true`, auto-generates a shared RP on `is_l3_border` devices (ERB/IPClos topologies only)
default: false
rp_ip:
type: string
description: RP address used when `anycast_rp`==`false`. If the address matches a device SVI, it is configured as a local RP; otherwise a static RP is configured
examples:
- 10.2.1.10
sbd_subnet:
type: string
description: SBD IRB subnet; Mist auto-assigns per-device IPs from this range (EVPN eOISM only)
examples:
- 10.99.0.0/24
sbd_vlan_id:
type: integer
description: Supplemental Bridge Domain VLAN ID (EVPN topology / eOISM only)
contentEncoding: int32
examples:
- 3900
description: Multicast configuration for a VRF. When set at the network template level it applies to networks in the master VRF (not assigned to any vrf_instances). PIM is automatically enabled when any network in the VRF has `multicast.enabled`==`true`.
switch_network:
title: switch_network
required:
- vlan_id
type: object
properties:
gateway:
type: string
description: Only required for EVPN-VXLAN networks, IPv4 Virtual Gateway
gateway6:
type: string
description: Only required for EVPN-VXLAN networks, IPv6 Virtual Gateway
isolation:
type: boolean
description: 'whether to stop clients to talk to each other, default is false (when enabled, a unique isolation_vlan_id is required). NOTE: this features requires uplink device to also a be Juniper device and `inter_switch_link` to be set. See also `inter_isolation_network_link` and `community_vlan_id` in port_usage'
default: false
isolation_vlan_id:
type: string
description: Required when `isolation`==`true`. Unique VLAN ID used for client isolation
examples:
- '3070'
multicast:
allOf:
- $ref: '#/components/schemas/switch_network_multicast2'
- description: Multicast (IGMP snooping) settings for this VLAN
subnet:
type: string
description: Optional for pure switching, required when L3 / routing features are used
subnet6:
type: string
description: Optional for pure switching, required when L3 / routing features are used
vlan_id:
oneOf:
- type: string
- maximum: 4094
minimum: 1
type: integer
contentEncoding: int32
description: VLAN identifier for this switch network
description: 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 later be used to create addition routes. Used for ports doing `family ethernet-switching`. It can also be a pure L3-subnet that can then be used against a port that with `family inet`.
switch_network_multicast:
title: switch_network_multicast
type: object
properties:
enabled:
type: boolean
description: Whether to enable IGMP snooping on this VLAN
default: false
igmp_version:
allOf:
- $ref: '#/components/schemas/switch_network_multicast_igmp_version'
- description: IGMP version. '2' (default, ASM/IGMPv2) / '3' (SSM/IGMPv3)
description: Multicast settings for a switch network (VLAN)
switch_network_multicast_igmp_version:
title: switch_network_multicast_igmp_version
enum:
- '2'
- '3'
type: string
description: IGMP version. '2' (default, ASM/IGMPv2) / '3' (SSM/IGMPv3)
switch_oob_ip_config:
title: switch_oob_ip_config
type: object
properties:
gateway:
type: string
description: Default gateway for the out-of-band management interface when `type`==`static`
ip:
type: string
description: Static IPv4 address for the out-of-band management interface when `type`==`static`
netmask:
type: string
description: Used only if `subnet` is not specified in `networks`
network:
type: string
description: Optional, the network to be used for mgmt
type:
allOf:
- $ref: '#/components/schemas/ip_type2'
- description: 'IP assignment mode for the out-of-band management interface. enum: `dhcp`, `static`.'
examples:
- static
use_mgmt_vrf:
type: boolean
description: If supported on the platform. If enabled, DNS will be using this routing-instance, too
default: false
use_mgmt_vrf_for_host_out:
type: boolean
description: For host-out traffic (NTP/TACPLUS/RADIUS/SYSLOG/SNMP), if alternative source network/ip is desired
default: false
description: >-
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 desired): key parameter = `re1`
switch_ospf_config:
title: switch_ospf_config
type: object
properties:
areas:
type: object
additionalProperties:
$ref: '#/components/schemas/switch_ospf_config_area'
description: OSPF areas configured on the switch
enabled:
type: boolean
description: Enable OSPF on the switch
default: false
export_policy:
type: string
description: optional, for basic scenario, `import_policy` can be specified and can be applied to all networks in all areas if not explicitly specified
import_policy:
type: string
description: optional, for basic scenario, `import_policy` can be specified and can be applied to all networks in all areas if not explicitly specified
reference_bandwidth:
anyOf:
- type: integer
contentEncoding: int32
- type: string
description: Reference bandwidth used for OSPF cost calculation
examples:
- '100000'
description: OSPF routing configuration for a Junos switch
switch_ospf_config_area:
title: switch_ospf_config_area
type: object
properties:
no_summary:
type: boolean
description: Disable OSPF summary routes for this area
default: false
description: Settings for a single OSPF area on a switch
switch_port_config_overwrite:
title: switch_port_config_overwrite
type: object
properties:
description:
type: string
description: Administrative description applied to the switch port override
disabled:
type: boolean
description: Whether the port is disabled
default: false
duplex:
allOf:
- $ref: '#/components/schemas/switch_port_usage_duplex_overwrite2'
- description: 'Link duplex mode override for the switch port. enum: `auto`, `full`, `half`.'
mac_limit:
anyOf:
- maximum: 16383
minimum: 0
type: integer
contentEncoding: int32
default: 0
- type: string
description: MAC address learning limit override for the switch port
poe_disabled:
type: boolean
description: Whether PoE capabilities are disabled for a port
default: false
poe_keep_state_when_reboot:
type: boolean
description: Whether Perpetual PoE is enabled; keeps PoE state across reboots
default: false
port_network:
type: string
description: Native network/vlan for untagged traffic
speed:
allOf:
- $ref: '#/components/schemas/switch_port_usage_speed_overwrite2'
- description: 'Link speed override for the switch port. enum: `10m`, `100m`, `1g`, `2.5g`, `5g`, `10g`, `25g`, `40g`, `100g`, `auto`.'
description: Switch port configuration overrides
switch_port_local_usage_dot1x:
title: switch_port_local_usage_dot1x
const: dot1x
type: string
description: 'if dot1x is desired, set to dot1x. enum: `dot1x`'
switch_port_local_usage_duplex:
title: switch_port_local_usage_duplex
enum:
- auto
- full
- half
type: string
description: 'link connection mode. enum: `auto`, `full`, `half`'
switch_port_local_usage_mac_auth_protocol:
title: switch_port_local_usage_mac_auth_protocol
enum:
- eap-md5
- eap-peap
- pap
type: string
description: 'Only if `enable_mac_auth` ==`true`. This type is ignored if mist_nac is enabled. enum: `eap-md5`, `eap-peap`, `pap`'
switch_port_local_usage_mode:
title: switch_port_local_usage_mode
enum:
- access
- inet
- trunk
type: string
description: 'enum: `access`, `inet`, `trunk`'
switch_port_local_usage_storm_control:
title: switch_port_local_usage_storm_control
type: object
properties:
disable_port:
type: boolean
description: Whether to disable the port when storm control is triggered
default: false
no_broadcast:
type: boolean
description: Whether to disable storm control on broadcast traffic
default: false
no_multicast:
type: boolean
description: Whether to disable storm control on multicast traffic
default: false
no_registered_multicast:
type: boolean
description: Whether to disable storm control on registered multicast traffic
default: false
no_unknown_unicast:
type: boolean
description: Whether to disable storm control on unknown unicast traffic
default: false
percentage:
maximum: 100
minimum: 0
type: integer
description: Bandwidth-percentage, configures the storm control level as a percentage of the available bandwidth
contentEncoding: int32
default: 80
description: Storm-control settings for this local port configuration
switch_port_mirroring_property:
title: switch_port_mirroring_property
type: object
properties:
input_networks_ingress:
type: array
items:
type: string
description: At least one mirror input source should be specified. Networks whose ingress traffic is mirrored
input_port_ids_egress:
type: array
items:
type: string
description: At least one mirror input source should be specified. Switch ports whose egress traffic is mirrored
input_port_ids_ingress:
type: array
items:
type: string
description: At least one mirror input source should be specified. Switch ports whose ingress traffic is mirrored
output_ip_address:
type: string
description: Exactly one of the `output_ip_address`, `output_port_id` or `output_network` should be provided
examples:
- 1.2.3.4
output_network:
type: string
description: Exactly one of the `output_ip_address`, `output_port_id` or `output_network` should be provided
examples:
- analyze
output_port_id:
type: string
description: Exactly one of the `output_ip_address`, `output_port_id` or `output_network` should be provided
examples:
- ge-0/0/5
description: Input and output settings for one switch port mirroring session
switch_port_usage:
title: switch_port_usage
type: object
properties:
all_networks:
type: boolean
description: Only if `mode`==`trunk`. Whether to trunk all network/vlans
default: false
allow_dhcpd:
type: boolean
description: 'Only applies when `mode`!=`dynamic`. Controls whether DHCP server traffic is allowed on ports using this configuration if DHCP snooping is enabled. This is a tri-state setting; `true`: ports become trusted ports allowing DHCP server traffic, `false`: ports become untrusted blocking DHCP server traffic, undefined: use system defaults (access ports default to untrusted, trunk ports default to trusted).'
allow_multiple_supplicants:
type: boolean
description: Only if `mode`!=`dynamic`
default: false
bypass_auth_when_server_down:
type: boolean
description: Only if `mode`!=`dynamic` and `port_auth`==`dot1x`. Bypass auth for known clients if set to true when RADIUS server is down
default: false
bypass_auth_when_server_down_for_unknown_client:
type: boolean
description: Only if `mode`!=`dynamic` and `port_auth`=`dot1x`. Bypass auth for all (including unknown clients) if set to true when RADIUS server is down
default: false
bypass_auth_when_server_down_for_voip:
type: boolean
description: Only if `mode`!=`dynamic` and `port_auth`==`dot1x`. Bypass auth for VOIP if set to true when RADIUS server is down
default: false
community_vlan_id:
type: integer
description: Only if `mode`!=`dynamic`. To be used together with `isolation` under networks. Signaling that this port connects to the networks isolated but wired clients belong to the same community can talk to each other
contentEncoding: int32
description:
type: string
description: Only if `mode`!=`dynamic`
disable_autoneg:
type: boolean
description: Only if `mode`!=`dynamic`. If speed and duplex are specified, whether to disable autonegotiation
default: false
disabled:
type: boolean
description: Only if `mode`!=`dynamic`. Whether the port is disabled
default: false
duplex:
allOf:
- $ref: '#/components/schemas/switch_port_usage_duplex2'
- description: 'Only if `mode`!=`dynamic`. Link duplex mode for this port usage. enum: `auto`, `full`, `half`.'
dynamic_vlan_networks:
type: array
items:
type: string
description: Only if `mode`!=`dynamic` and `port_auth`==`dot1x`. Networks or VLANs that RADIUS can return for dynamic VLAN assignment
examples:
- - corp
- user
enable_mac_auth:
type: boolean
description: Only if `mode`!=`dynamic` and `port_auth`==`dot1x`. Whether to enable MAC Auth
default: false
enable_qos:
type: boolean
description: Only if `mode`!=`dynamic`
default: false
guest_network:
type:
- string
- 'null'
description: Only if `mode`!=`dynamic` and `port_auth`==`dot1x`. Which network to put the device into if the device cannot do dot1x. default is null (i.e. not allowed)
inter_isolation_network_link:
type: boolean
description: Only if `mode`!=`dynamic`. `inter_isolation_network_link` is used together with `isolation` under networks, signaling that this port connects to isolated networks
default: false
inter_switch_link:
type: boolean
description: 'Only if `mode`!=`dynamic`. `inter_switch_link` is used together with `isolation` under networks. NOTE: `inter_switch_link` works only between Juniper devices. This has to be applied to both ports connected together'
default: false
mac_auth_only:
type: boolean
description: Only if `mode`!=`dynamic` and `enable_mac_auth`==`true`
mac_auth_preferred:
type: boolean
description: Only if `mode`!=`dynamic` + `enable_mac_auth`==`true` + `mac_auth_only`==`false`, dot1x will be given priority then mac_auth. Enable this to prefer mac_auth over dot1x.
mac_auth_protocol:
allOf:
- $ref: '#/components/schemas/switch_port_usage_mac_auth_protocol2'
- description: 'Only if `mode`!=`dynamic` and `enable_mac_auth`==`true`. MAC authentication protocol to use; ignored if Mist NAC is enabled. enum: `eap-md5`, `eap-peap`, `pap`.'
mac_limit:
anyOf:
- maximum: 16383
minimum: 0
type: integer
contentEncoding: int32
default: 0
- type: string
description: Only if `mode`!=`dynamic`. Maximum number of MAC addresses allowed on the port; 0 means unlimited
mode:
allOf:
- $ref: '#/components/schemas/switch_port_usage_mode2'
- description: 'Switching mode for this port usage. enum: `access`, `dynamic`, `inet`, `trunk`.'
mtu:
anyOf:
- maximum: 9216
minimum: 256
type: integer
contentEncoding: int32
- type: string
description: Only if `mode`!=`dynamic`. MTU for ports using this port usage
networks:
type: array
items:
type: string
description: Only if `mode`==`trunk`. Network or VLAN names to trunk
persist_mac:
type: boolean
description: Only if `mode`==`access` and `port_auth`!=`dot1x`. Whether the port should retain dynamically learned MAC addresses
default: false
poe_disabled:
type: boolean
description: Only if `mode`!=`dynamic`. Whether PoE capabilities are disabled for a port
default: false
poe_keep_state_when_reboot:
type: boolean
description: Only if `mode`!=`dynamic`. Whether Perpetual PoE is enabled; keeps PoE state across reboots
default: false
poe_priority:
allOf:
- $ref: '#/components/schemas/poe_priority3'
- description: 'Only if `mode`!=`dynamic`. PoE priority for ports using this port usage. enum: `low`, `high`.'
port_auth:
allOf:
- oneOf:
- {}
- $ref: '#/components/schemas/switch_port_usage_dot1x2'
- description: 'Only if `mode`!=`dynamic`. 802.1X authentication mode for this port usage. enum: `dot1x`.'
port_network:
type: string
description: Only if `mode`!=`dynamic`. Native network/vlan for untagged traffic
reauth_interval:
anyOf:
- maximum: 65535
minimum: 10
type: integer
contentEncoding: int32
default: 3600
- type: string
description: Only if `mode`!=`dynamic` and `port_auth`==`dot1x`. RADIUS reauthentication interval for clients on the port
reset_default_when:
allOf:
- $ref: '#/components/schemas/switch_port_usage_dynamic_reset_default_when2'
- description: 'Only if `mode`==`dynamic`. Condition that resets a dynamic port to the default port usage. enum: `link_down`, `none`.'
examples:
- link_down
rules:
type: array
items:
$ref: '#/components/schemas/switch_port_usage_dynamic_rule'
description: Only if `mode`==`dynamic`. Dynamic matching rules that select the port usage to apply
server_fail_network:
type:
- string
- 'null'
description: Only if `mode`!=`dynamic` and `port_auth`==`dot1x`. Sets server fail fallback vlan
server_fail_retry_interval:
maximum: 65535
minimum: 120
type: integer
description: Only if `mode`!=`dynamic` and `port_auth`==`dot1x`. Interval, in seconds. Sets the wait time before retrying authentication after RADIUS failure to reduce client flapping. Range 120-65535
contentEncoding: int32
default: 120
server_reject_network:
type:
- string
- 'null'
description: Only if `mode`!=`dynamic` and `port_auth`==`dot1x`. When RADIUS server reject / fails
speed:
allOf:
- $ref: '#/components/schemas/switch_port_usage_speed2'
- description: 'Only if `mode`!=`dynamic`. Link speed for this port usage. enum: `10m`, `100m`, `1g`, `2.5g`, `5g`, `10g`, `25g`, `40g`, `100g`, `auto`.'
storm_control:
allOf:
- $ref: '#/components/schemas/switch_port_usage_storm_control2'
- description: Only if `mode`!=`dynamic`. Storm-control settings for this port usage
stp_disable:
type: boolean
description: Only if `mode`!=`dynamic` and `stp_required`==`false`. Drop bridge protocol data units (BPDUs ) that enter any interface or a specified interface
default: false
stp_edge:
type: boolean
description: Only if `mode`!=`dynamic`. When enabled, the port is not expected to receive BPDU frames
default: false
stp_no_root_port:
type: boolean
description: Only if `mode`!=`dynamic`
default: false
stp_p2p:
type: boolean
description: Only if `mode`!=`dynamic`
default: false
stp_required:
type: boolean
description: Only if `mode`!=`dynamic`. Whether to remain in block state if no BPDU is received
default: false
ui_evpntopo_id:
type: string
description: Optional for Campus Fabric Core-Distribution ESI-LAG profile. Helper used by the UI to select this port profile as the ESI-Lag between Distribution and Access switches
contentEncoding: uuid
use_vstp:
type: boolean
description: If this is connected to a vstp network
default: false
voip_network:
type:
- string
- 'null'
description: Only if `mode`!=`dynamic`. Network/vlan for voip traffic, must also set port_network. to authenticate device, set port_auth
description: Junos switch port usage template and authentication settings
switch_port_usage_dot1x:
title: switch_port_usage_dot1x
const: dot1x
type: string
description: 'Only if `mode`!=`dynamic`. If dot1x is desired, set to dot1x. enum: `dot1x`'
switch_port_usage_duplex:
title: switch_port_usage_duplex
enum:
- auto
- full
- half
type: string
description: 'Only if `mode`!=`dynamic`. Link connection mode. enum: `auto`, `full`, `half`'
switch_port_usage_duplex_overwrite:
title: switch_port_usage_duplex_overwrite
enum:
- auto
- full
- half
type: string
description: 'Link connection mode. enum: `auto`, `full`, `half`'
switch_port_usage_dynamic_reset_default_when:
title: switch_port_usage_dynamic_reset_default_when
enum:
- link_down
- none
type: string
description: 'Only if `mode`==`dynamic` Control when the DPC port should be changed to the default port usage. enum: `link_down`, `none` (let the DPC port keep at the current port usage)'
examples:
- link_down
switch_port_usage_dynamic_rule:
title: switch_port_usage_dynamic_rule
required:
- src
type: object
properties:
description:
type: string
description: Optional description of the rule
equals:
type: string
description: Exact value that the selected source attribute must match
equals_any:
type: array
items:
type: string
description: List of values where any match satisfies this dynamic rule
expression:
type: string
description: >-
"[0:3]":"abcdef" -> "abc"
"split(.)[1]": "a.b.c" -> "b"
"split(-)[1][0:3]: "a1234-b5678-c90" -> "b56"
src:
allOf:
- $ref: '#/components/schemas/switch_port_usage_dynamic_rule_src2'
- description: 'Source attribute evaluated by this dynamic rule. enum: `link_peermac`, `lldp_chassis_id`, `lldp_hardware_revision`, `lldp_manufacturer_name`, `lldp_oui`, `lldp_serial_number`, `lldp_system_description`, `lldp_system_name`, `radius_dynamicfilter`, `radius_usermac`, `radius_username`.'
usage:
type: string
description: Port usage name to apply when this dynamic rule matches
description: Dynamic port usage rule evaluated against LLDP, RADIUS, or peer MAC attributes
switch_port_usage_dynamic_rule_src:
title: switch_port_usage_dynamic_rule_src
enum:
- link_peermac
- lldp_chassis_id
- lldp_hardware_revision
- lldp_manufacturer_name
- lldp_oui
- lldp_serial_number
- lldp_system_description
- lldp_system_name
- radius_dynamicfilter
- radius_usermac
- radius_username
type: string
description: 'enum: `link_peermac`, `lldp_chassis_id`, `lldp_hardware_revision`, `lldp_manufacturer_name`, `lldp_oui`, `lldp_serial_number`, `lldp_system_description`, `lldp_system_name`, `radius_dynamicfilter`, `radius_usermac`, `radius_username`'
switch_port_usage_mac_auth_protocol:
title: switch_port_usage_mac_auth_protocol
enum:
- eap-md5
- eap-peap
- pap
type: string
description: 'Only if `mode`!=`dynamic` and `enable_mac_auth` ==`true`. This type is ignored if mist_nac is enabled. enum: `eap-md5`, `eap-peap`, `pap`'
switch_port_usage_mode:
title: switch_port_usage_mode
enum:
- access
- dynamic
- inet
- trunk
type: string
description: '`mode`==`dynamic` must only be used if the port usage name is `dynamic`. enum: `access`, `dynamic`, `inet`, `trunk`'
switch_port_usage_speed:
title: switch_port_usage_speed
enum:
- 10m
- 100m
- 1g
- 2.5g
- 5g
- 10g
- 25g
- 40g
- 100g
- auto
type: string
description: '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_port_usage_speed_overwrite:
title: switch_port_usage_speed_overwrite
enum:
- 10m
- 100m
- 1g
- 2.5g
- 5g
- 10g
- 25g
- 40g
- 100g
- auto
type: string
description: 'Port Speed, default is auto to automatically negotiate speed enum: `100m`, `10m`, `1g`, `2.5g`, `5g`, `10g`, `25g`, `40g`, `100g`,`auto`'
switch_port_usage_storm_control:
title: switch_port_usage_storm_control
type: object
properties:
disable_port:
type: boolean
description: Whether to disable the port when storm control is triggered
default: false
no_broadcast:
type: boolean
description: Whether to disable storm control on broadcast traffic
default: false
no_multicast:
type: boolean
description: Whether to disable storm control on multicast traffic
default: false
no_registered_multicast:
type: boolean
description: Whether to disable storm control on registered multicast traffic
default: false
no_unknown_unicast:
type: boolean
description: Whether to disable storm control on unknown unicast traffic
default: false
percentage:
maximum: 100
minimum: 0
type: integer
description: Bandwidth-percentage, configures the storm control level as a percentage of the available bandwidth
contentEncoding: int32
default: 80
description: Switch storm control. Only if `mode`!=`dynamic`
switch_radius:
title: switch_radius
type: object
properties:
enabled:
type: boolean
description: Whether RADIUS is enabled for switch management authentication
radius_config:
allOf:
- $ref: '#/components/schemas/switch_radius_config1'
- description: RADIUS configuration used when alternate RADIUS settings are required
use_different_radius:
type: string
description: Selector for alternate RADIUS settings instead of the default switch `radius_config`
description: Switch RADIUS override settings. By default, the switch `radius_config` is used; set `use_different_radius` to use alternate RADIUS settings.
switch_radius_config:
title: switch_radius_config
type: object
properties:
acct_immediate_update:
type: boolean
description: Whether immediate RADIUS accounting updates are sent
acct_interim_interval:
maximum: 65535
minimum: 0
type: integer
description: How frequently should interim accounting be reported, 60-65535. default is 0 (use one specified in Access-Accept request from RADIUS Server). Very frequent messages can affect the performance of the RADIUS server, 600 and up is recommended when enabled
contentEncoding: int32
default: 0
acct_servers:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/radius_acct_server'
description: RADIUS accounting servers used by this switch configuration
auth_server_selection:
allOf:
- $ref: '#/components/schemas/switch_radius_config_auth_server_selection2'
- description: 'Selection strategy for RADIUS authentication servers. enum: `ordered`, `unordered`.'
auth_servers:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/radius_auth_server'
description: RADIUS authentication servers used by this switch configuration
auth_servers_retries:
type: integer
description: RADIUS auth session retries
contentEncoding: int32
default: 3
auth_servers_timeout:
type: integer
description: RADIUS auth session timeout
contentEncoding: int32
default: 5
coa_enabled:
type: boolean
description: Whether RADIUS Change of Authorization (CoA) is enabled
default: false
coa_port:
anyOf:
- maximum: 65545
minimum: 1
type: integer
contentEncoding: int32
- type: string
description: UDP port used for RADIUS Change of Authorization (CoA)
fast_dot1x_timers:
type: boolean
description: Whether fast 802.1X timers are enabled for RADIUS authentication
default: false
network:
type: string
description: Use `network`or `source_ip`. Which network the RADIUS server resides, if there's static IP for this network, we'd use it as source-ip
source_ip:
type: string
description: Use `network` or `source_ip`. Explicit source IP address for RADIUS traffic
description: Switch RADIUS authentication and accounting configuration
switch_radius_config_auth_server_selection:
title: switch_radius_config_auth_server_selection
enum:
- ordered
- unordered
type: string
description: 'Selection strategy for RADIUS authentication servers. enum: `ordered`, `unordered`'
switch_search:
title: switch_search
required:
- type
type: object
properties:
clustered:
type: boolean
description: Whether the switch is part of a virtual chassis or cluster
evpn_missing_links:
type: boolean
description: Whether EVPN topology links are missing for this switch
evpntopo_id:
type: string
description: EVPN topology ID associated with this switch
ext_ip:
type: string
description: External IP address observed for switch management traffic
hostname:
uniqueItems: true
type: array
items:
type: string
description: Observed hostnames detected for the switch in search results
ip:
type: string
description: Management IP address currently reported for the switch
last_config_status:
type: string
description: Most recent configuration status reported for the switch
last_hostname:
type: string
description: Most recent hostname detected for the switch
last_trouble_code:
type: string
description: Most recent trouble code reported for the switch
last_trouble_timestamp:
type: number
description: Time when the most recent switch trouble code was reported
readOnly: true
mac:
type: string
description: Switch MAC address reported in search results
managed:
type: boolean
description: Whether the switch is managed by Mist. Deprecated in favor of `mist_configured`
deprecated: true
mist_configured:
type: boolean
description: whether the device can be configured by Mist or not. This deprecates `managed` (for adopted device) and `disable_auto_config` for claimed device)
model:
type: string
description: Switch model reported for this search result
num_members:
type: integer
description: Number of members in the switch virtual chassis, when applicable
contentEncoding: int32
org_id:
type: string
description: Organization that owns this switch search result
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
radius_stats:
type: object
additionalProperties:
$ref: '#/components/schemas/device_search_radius_stat'
description: RADIUS statistics for this switch keyed by server IP address
role:
type: string
description: Switch role reported for this search result
site_id:
type: string
description: Site that contains this switch search result
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
time_drifted:
type: boolean
description: Whether the switch clock has drifted from the expected time
timestamp:
type: number
description: Time associated with this switch search result
readOnly: true
type:
const: switch
type: string
description: Device type for this switch search result
uptime:
type: integer
description: Device uptime for the switch, in seconds
contentEncoding: int32
version:
type: string
description: Software version currently running on the switch
description: Switch record returned by device search endpoints
switch_stp_config:
title: switch_stp_config
type: object
properties:
bridge_priority:
type: string
description: Switch STP priority. Range [0, 4k, 8k.. 60k] in steps of 4k. Bridge priority applies to both VSTP and RSTP.
default: 32k
examples:
- 40k
description: Switch spanning-tree protocol configuration
switch_virtual_chassis:
title: switch_virtual_chassis
type: object
properties:
members:
type: array
items:
$ref: '#/components/schemas/switch_virtual_chassis_member'
description: Virtual Chassis members and their expected roles
preprovisioned:
type: boolean
description: To configure whether the VC is preprovisioned or nonprovisioned
default: false
description: Required for preprovisioned Virtual Chassis
switch_virtual_chassis_member:
title: switch_virtual_chassis_member
required:
- mac
- member_id
- vc_role
type: object
properties:
mac:
type: string
description: Virtual Chassis member MAC address; for FPC0 this matches the device ID MAC
examples:
- aff827549235
member_id:
type: integer
description: Virtual Chassis member identifier
contentEncoding: int32
vc_role:
allOf:
- $ref: '#/components/schemas/switch_virtual_chassis_member_vc_role2'
- description: 'Role of this member in the Virtual Chassis. enum: `backup`, `linecard`, `master`.'
description: Virtual Chassis member identified by MAC address and role
switch_virtual_chassis_member_vc_role:
title: switch_virtual_chassis_member_vc_role
enum:
- backup
- linecard
- master
type: string
description: 'Both vc_role master and backup will be matched to routing-engine role in Junos preprovisioned VC config. enum: `backup`, `linecard`, `master`'
switch_vrf_instance:
title: switch_vrf_instance
type: object
properties:
aggregate_routes:
type: object
additionalProperties:
$ref: '#/components/schemas/aggregate_route'
description: IPv4 aggregate routes configured for this VRF instance
examples:
- 172.16.3.0/24:
discard: false
metric: null
preference: 30
aggregate_routes6:
type: object
additionalProperties:
$ref: '#/components/schemas/aggregate_route'
description: IPv6 aggregate routes configured for this VRF instance
examples:
- 2a02:1234:420a:10c9::/64:
discard: false
metric: null
preference: 30
evpn_auto_loopback_subnet:
type: string
description: IPv4 subnet used for automatic EVPN loopback addresses in this VRF instance
examples:
- 100.101.0.0/24
evpn_auto_loopback_subnet6:
type: string
description: IPv6 subnet used for automatic EVPN loopback addresses in this VRF instance
extra_routes:
type: object
additionalProperties:
$ref: '#/components/schemas/vrf_extra_route'
description: Additional IPv4 static routes configured for this VRF instance
examples:
- 0.0.0.0/0:
via: 192.168.1.10
extra_routes6:
type: object
additionalProperties:
$ref: '#/components/schemas/vrf_extra_route6'
description: Additional IPv6 static routes configured for this VRF instance
examples:
- 2a02:1234:420a:10c9::/64:
via: 2a02:1234:200a::100
multicast_config:
allOf:
- $ref: '#/components/schemas/switch_multicast_config3'
- description: Multicast configuration for this VRF instance. PIM is automatically enabled when any network in this VRF has `multicast.enabled`==`true`
networks:
uniqueItems: true
type: array
items:
type: string
description: Names of switch networks included in this VRF instance
description: Switch VRF instance routing and network membership settings
examples:
- extra_routes:
0.0.0.0/0:
via: 192.168.31.1
networks:
- guest
synthetictest:
title: synthetictest
type: object
properties:
email:
type: string
description: Contact email address supplied when triggering the site synthetic test
contentEncoding: email
examples:
- test@mist.com
description: Request body for triggering a site synthetic test
synthetictest_config:
title: synthetictest_config
type: object
properties:
aggressiveness:
allOf:
- $ref: '#/components/schemas/synthetictest_config_aggressiveness3'
- description: 'Overall aggressiveness level for synthetic test probes. enum: `auto`, `high`, `med`, `low`.'
custom_probes:
type: object
additionalProperties:
$ref: '#/components/schemas/synthetictest_config_custom_probe'
description: Custom synthetic probe definitions keyed by probe name
disabled:
type: boolean
description: Whether synthetic tests are disabled
default: false
lan_networks:
type: array
items:
$ref: '#/components/schemas/synthetictest_config_lan_network'
description: LAN network probe groups used by synthetic tests
vlans:
type: array
items:
$ref: '#/components/schemas/synthetictest_config_vlan'
description: Deprecated VLAN-based synthetic test settings
deprecated: true
wan_speedtest:
allOf:
- $ref: '#/components/schemas/synthetictest_config_wan_speedtest2'
- description: WAN speedtest settings for synthetic tests
description: Synthetic test configuration for Marvis Minis
synthetictest_config_aggressiveness:
title: synthetictest_config_aggressiveness
enum:
- auto
- high
- med
- low
type: string
description: 'Aggressiveness level for a synthetic test. enum: `auto`, `high`, `med`, `low`'
synthetictest_config_custom_probe:
title: synthetictest_config_custom_probe
type: object
properties:
aggressiveness:
allOf:
- $ref: '#/components/schemas/synthetictest_config_aggressiveness1'
- description: 'Probe aggressiveness level for this custom synthetic probe. enum: `auto`, `high`, `med`, `low`.'
target:
type: string
description: Can be URL (e.g. http://x.com, https://x.com:8080/path/to/resource), IP address, or IP:port combination
examples:
- 10.3.5.3:8080
threshold:
type: integer
description: Response-time threshold for this custom probe, in milliseconds
contentEncoding: int32
examples:
- 100
type:
allOf:
- $ref: '#/components/schemas/synthetictest_config_custom_probe_type3'
- description: 'Probe type used by this custom synthetic probe. enum: `application`, `curl`, `icmp`, `reachability`, `tcp`.'
description: Custom probe definition for synthetic tests
synthetictest_config_custom_probe_type:
title: synthetictest_config_custom_probe_type
enum:
- application
- curl
- icmp
- reachability
- tcp
type: string
description: 'enum: `application`, `curl`, `icmp`, `reachability`, `tcp`'
synthetictest_config_lan_network:
title: synthetictest_config_lan_network
type: object
properties:
networks:
type: array
items:
type: string
description: LAN network names where synthetic probes are run
examples:
- - pos-stations
- pos-machines
probes:
type: array
items:
type: string
description: Synthetic probe names to run on the listed LAN networks
description: configure minis probes to be tested on lan networks of gateways
synthetictest_config_vlan:
title: synthetictest_config_vlan
type: object
properties:
custom_test_urls:
type: array
items:
type: string
description: Deprecated custom URLs tested by VLAN-based synthetic probes
examples:
- - https://www.abc.com/
- https://10.3.5.1:8080/about
deprecated: true
disabled:
type: boolean
description: For some vlans where we don't want this to run
default: false
probes:
type: array
items:
type: string
description: Synthetic probe names to run for the listed VLANs
vlan_ids:
type: array
items:
$ref: '#/components/schemas/vlan_id_with_variable'
description: VLAN identifiers where synthetic probes are run
examples:
- - 10
- 20
- '{{vlan}}'
description: Deprecated VLAN-based synthetic test settings
synthetictest_config_wan_speedtest:
title: synthetictest_config_wan_speedtest
type: object
properties:
enabled:
type: boolean
description: Whether scheduled WAN speedtests are enabled
time_of_day:
type: string
description: Scheduled time of day for WAN speedtests
default: any
examples:
- 12:00
description: WAN speedtest scheduling settings for synthetic tests
synthetictest_device:
title: synthetictest_device
required:
- type
type: object
properties:
host:
type: string
description: If `type`==`lan_connectivity`. Hostname or IP address to probe for LAN connectivity testing
examples:
- www.example.com
hostname:
type: string
description: If `type`==`dns`. Hostname to resolve during the DNS synthetic test
examples:
- google.com"
ip:
type: string
description: If `type`==`arp`. IP address to resolve through ARP during the synthetic test
examples:
- 192.168.3.5
password:
type: string
description: If `type`==`radius`. Password used for RADIUS authentication testing
contentEncoding: password
examples:
- test123
ping_count:
maximum: 60
minimum: 10
type: integer
description: If `type`==`lan_connectivity`. Number of ping probes to send during the LAN connectivity test
contentEncoding: int32
default: 10
ping_details:
type: boolean
description: If `type`==`lan_connectivity`. Whether to include per-ping results in the LAN connectivity test output
default: false
ping_size:
maximum: 65535
minimum: 56
type: integer
description: If `type`==`lan_connectivity`. Payload size, in bytes, for each ping probe
contentEncoding: int32
default: 56
port_id:
type: string
description: If `type`==`speedtest`, required for ssr
examples:
- wan0
protocol:
allOf:
- $ref: '#/components/schemas/synthetictest_device_protocol2'
- description: 'If `type`==`lan_connectivity`. Protocol or protocol combination used for the connectivity test. enum: `ping`, `ping+traceroute`, `traceroute`.'
tenant:
type: string
description: If `type`==`curl` or `type`==`lan_connectivity`
examples:
- lan_network1
timeout:
maximum: 120
minimum: 30
type: integer
description: If `type`==`curl`. Timeout, in seconds, for the HTTP request
contentEncoding: int32
default: 60
examples:
- 60
traceroute_udp_port:
maximum: 65535
minimum: 0
type: integer
description: SRX only, traceroute udp port
contentEncoding: int32
default: 33434
type:
allOf:
- $ref: '#/components/schemas/synthetictest_type1'
- description: 'Synthetic test type to run against the target. enum: `arp`, `curl`, `dhcp`, `dhcp6`, `dns`, `lan_connectivity`, `radius`, `speedtest`.'
url:
type: string
description: If `type`==`curl`. URL requested during the HTTP synthetic test
examples:
- https://www.example.com
username:
type: string
description: If `type`==`radius`. Username used for RADIUS authentication testing
examples:
- user
vlan_id:
oneOf:
- type: string
- maximum: 4094
minimum: 1
type: integer
contentEncoding: int32
description: Required for AP. VLAN ID used by the synthetic test when the target device is an AP
description: Request body for triggering a synthetic test on a device
synthetictest_device_protocol:
title: synthetictest_device_protocol
enum:
- ping
- ping+traceroute
- traceroute
type: string
description: 'If `type`==`lan_connectivity`. Protocol or protocol combination used by the LAN connectivity test. enum: `ping`, `traceroute`, `ping+traceroute`'
synthetictest_protocol:
title: synthetictest_protocol
enum:
- ping
- traceroute
type: string
description: 'Protocol used by a synthetic test probe. enum: `ping`, `traceroute`'
synthetictest_radius_server:
title: synthetictest_radius_server
required:
- password
- user
type: object
properties:
password:
type: string
description: Specify the password associated with the username
contentEncoding: password
profile:
type: string
description: Specify the access profile associated with the subscriber
default: dot1x
user:
type: string
description: Specify the subscriber username to test
description: Request body for testing RADIUS server availability from a switch
synthetictest_type:
title: synthetictest_type
enum:
- arp
- curl
- dhcp
- dhcp6
- dns
- lan_connectivity
- radius
- speedtest
type: string
description: 'enum: `arp`, `curl`, `dhcp`, `dhcp6`, `dns`, `lan_connectivity`, `radius`, `speedtest`'
tacacs:
title: tacacs
type: object
properties:
acct_servers:
type: array
items:
$ref: '#/components/schemas/tacacs_acct_server'
description: TACACS+ accounting servers used for switch management sessions
default_role:
allOf:
- $ref: '#/components/schemas/tacacs_default_role2'
- description: 'Default switch-management role to use for TACACS+ logins. enum: `admin`, `helpdesk`, `none`, `read`.'
enabled:
type: boolean
description: Whether TACACS+ is enabled for switch management authentication
network:
type: string
description: Source network used for connectivity to the TACACS+ servers
tacplus_servers:
type: array
items:
$ref: '#/components/schemas/tacacs_auth_server'
description: TACACS+ authentication servers used for switch management logins
description: TACACS+ settings for switch management authentication and accounting
tacacs_acct_server:
title: tacacs_acct_server
type: object
properties:
host:
type: string
description: Address or hostname of the TACACS+ accounting server
port:
type: string
description: TCP port used by the TACACS+ accounting server
secret:
type: string
description: Shared secret used with this TACACS+ accounting server
contentEncoding: password
timeout:
type: integer
description: TACACS+ accounting server timeout, in seconds
contentEncoding: int32
default: 10
description: TACACS+ accounting server settings
tacacs_auth_server:
title: tacacs_auth_server
type: object
properties:
host:
type: string
description: Address or hostname of the TACACS+ authentication server
port:
type: string
description: TCP port used by the TACACS+ authentication server
secret:
type: string
description: Shared secret used with this TACACS+ authentication server
contentEncoding: password
timeout:
type: integer
description: TACACS+ authentication server timeout, in seconds
contentEncoding: int32
default: 10
description: TACACS+ authentication server settings
tacacs_default_role:
title: tacacs_default_role
enum:
- admin
- helpdesk
- none
- read
type: string
description: 'enum: `admin`, `helpdesk`, `none`, `read`'
template:
title: template
required:
- name
type: object
properties:
applies:
allOf:
- $ref: '#/components/schemas/template_applies2'
- description: Organizations, sites, or site groups targeted by this WLAN template
created_time:
type: number
description: Timestamp when the WLAN template was created
readOnly: true
deviceprofile_ids:
type: array
items:
type: string
contentEncoding: uuid
description: Device profile IDs that further limit where this WLAN template applies
exceptions:
allOf:
- $ref: '#/components/schemas/template_exceptions2'
- description: Sites or site groups excluded from this WLAN template even when included by the application scope
filter_by_deviceprofile:
type: boolean
description: Whether to further filter by Device Profile
id:
type: string
description: Unique identifier of the WLAN template
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
modified_time:
type: number
description: Timestamp when the WLAN template was last modified
readOnly: true
name:
type: string
description: Display name of the WLAN template
org_id:
type: string
description: Organization that owns this WLAN template
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
description: WLAN template configuration applied across sites or site groups
template_applies:
title: template_applies
type: object
properties:
org_id:
type: string
description: Organization included in the WLAN template application scope
contentEncoding: uuid
site_ids:
type: array
items:
type: string
contentEncoding: uuid
description: Sites included in the WLAN template application scope
sitegroup_ids:
type: array
items:
type: string
contentEncoding: uuid
description: Site groups included in the WLAN template application scope
description: Where this template should be applied to, can be org_id, site_ids, sitegroup_ids
template_exceptions:
title: template_exceptions
type: object
properties:
site_ids:
type: array
items:
type: string
contentEncoding: uuid
description: Sites excluded from the WLAN template application scope
sitegroup_ids:
type: array
items:
type: string
contentEncoding: uuid
description: Site groups excluded from the WLAN template application scope
description: Where this template should not be applied to (takes precedence)
test_cradlepoint:
title: test_cradlepoint
type: object
properties:
alert_config_id:
type: string
description: Cradlepoint alert configuration ID created by the integration setup
readOnly: true
examples:
- 8b7e06ac-0yu5-11f1-88h2-42628k552c3d
cp_api_id:
type: string
description: Cradlepoint API ID stored for the integration (masked)
readOnly: true
examples:
- '********'
cp_api_key:
type: string
description: Cradlepoint API key stored for the integration (masked)
contentEncoding: password
readOnly: true
examples:
- '********'
destination_config_id:
type: string
description: Cradlepoint destination configuration ID created by the integration setup
readOnly: true
examples:
- 8ad364de-0yu5-13r1-9abc-263675be6074
ecm_api_id:
type: string
description: Cradlepoint ECM API ID stored for the integration (masked)
readOnly: true
examples:
- '********'
ecm_api_key:
type: string
description: Cradlepoint ECM API key stored for the integration (masked)
contentEncoding: password
readOnly: true
examples:
- '********'
enable_lldp:
type: boolean
description: Whether Mist uses Cradlepoint LLDP data to link routers to Mist sites and devices
readOnly: true
error:
type: string
description: if status is `inactive` this field returns the reason for it being inactive.
readOnly: true
examples:
- Cradlepoint API keys are no longer valid, please verify and update the keys under organization settings.
last_status:
allOf:
- $ref: '#/components/schemas/test_cradlepoint_last_status2'
- description: 'Integration status detected during the most recent Cradlepoint sync. enum: `active`, `inactive`.'
examples:
- inactive
readOnly: true
shared_secret:
type: string
description: Shared secret generated by the integration setup (masked)
contentEncoding: password
readOnly: true
examples:
- '********'
description: Cradlepoint integration connectivity test result
test_cradlepoint_last_status:
title: test_cradlepoint_last_status
enum:
- active
- inactive
type: string
description: 'status of integration detected during last sync. enum: `active`, `inactive`'
examples:
- inactive
test_sms_global:
title: test_sms_global
required:
- smsglobal_api_key
- smsglobal_api_secret
- to
type: object
properties:
smsglobal_api_key:
type: string
description: SMSGlobal API key used to send the test SMS
examples:
- '123456'
smsglobal_api_secret:
type: string
description: SMSGlobal API secret used to send the test SMS
contentEncoding: password
examples:
- abcdef
smsglobal_sender:
type: string
description: Optional sender's number or sender ID. If not provided, uses the default number associated with the account
examples:
- '61400000002'
to:
type: string
description: Phone number of the recipient of SMS with country code
examples:
- '+911122334455'
description: Request body for validating SMSGlobal SMS gateway credentials
test_telstra:
title: test_telstra
required:
- telstra_client_id
- telstra_client_secret
- to
type: object
properties:
telstra_client_id:
type: string
description: Telstra client identifier used to send the test SMS
examples:
- '123456'
telstra_client_secret:
type: string
description: Telstra client secret used to send the test SMS
contentEncoding: password
examples:
- abcdef
to:
type: string
description: Phone number of the recipient of SMS with country code
examples:
- '+911122334455'
description: Request body for validating Telstra SMS gateway credentials
test_twilio:
title: test_twilio
required:
- from
- to
- twilio_auth_token
- twilio_sid
type: object
properties:
from:
type: string
description: One of the numbers you have in your Twilio account
examples:
- '+185051234567'
to:
type: string
description: Phone number of the recipient of SMS
examples:
- '+19999999999'
twilio_auth_token:
type: string
description: Twilio Auth Token used to send the test SMS
examples:
- 2135be04736a1a0a314bce432d61721a
twilio_sid:
type: string
description: Twilio account SID used to send the test SMS
examples:
- REDACTED_TWILIO_ACCOUNT_SID
description: Request body for validating Twilio SMS gateway credentials
ticket:
title: ticket
required:
- subject
- type
type: object
properties:
case_number:
type: string
description: Support case number associated with this ticket
readOnly: true
comments:
type: array
items:
$ref: '#/components/schemas/ticket_comment'
description: Discussion comments recorded on this support ticket
created_at:
type: integer
description: Time when this support ticket was created, in epoch seconds
contentEncoding: int32
readOnly: true
id:
type: string
description: Unique identifier for this support ticket
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
requester:
type: string
description: User who opened or requested this support ticket
readOnly: true
requester_email:
type: string
description: Email of the requester
contentEncoding: email
status:
allOf:
- $ref: '#/components/schemas/ticket_status2'
- description: 'Current lifecycle status of this support ticket. enum: `closed`, `open`, `pending`, `solved`.'
subject:
type: string
description: Short summary of the support request
type:
type: string
description: Question (default) / bug / critical
updated_at:
type: integer
description: Time when this support ticket was last updated, in epoch seconds
contentEncoding: int32
readOnly: true
description: Support ticket record with status, comments, and metadata
ticket_attachment:
title: ticket_attachment
type: object
properties:
content_url:
type: string
description: Download URL for the support ticket attachment
examples:
- https://api.mist.com/api/v1/forward/download?jwt=...
description: Download information for a support ticket attachment
ticket_comment:
title: ticket_comment
required:
- author
- comment
- created_at
type: object
properties:
attachment_ids:
type: array
items:
type: string
contentEncoding: uuid
description: Identifiers of attachments linked to this ticket comment
readOnly: true
examples:
- - 00000000-0000-0000-0000-15231a659c78
attachments:
type: array
items:
$ref: '#/components/schemas/ticket_comments_attachment'
description: Attachment metadata returned with this ticket comment
readOnly: true
author:
type: string
description: User who wrote this ticket comment
readOnly: true
comment:
type: string
description: Text body of this ticket comment
created_at:
type: integer
description: Time when this ticket comment was created, in epoch seconds
contentEncoding: int32
readOnly: true
description: Comment on a support ticket
ticket_comment_import_file:
title: ticket_comment_import_file
type: object
properties:
comment:
type: string
description: Text body for the ticket comment submitted with the uploaded file
examples:
- this is urgent
file:
type: string
description: Binary file payload to attach to the ticket comment
contentEncoding: base64
description: Multipart payload for adding a ticket comment with an attachment
ticket_comments_attachment:
title: ticket_comments_attachment
type: object
properties:
content_type:
type: string
description: MIME type of the ticket comment attachment
examples:
- image/png
content_url:
type: string
description: Download URL for the ticket comment attachment
examples:
- https://api.mist.com/api/v1/forward/download?jwt=...
created_at:
type: integer
description: Time when this ticket comment attachment was created, in epoch seconds
contentEncoding: int32
examples:
- 1453908369
file_name:
type: string
description: Original file name of the ticket comment attachment
examples:
- crash.png
id:
type: string
description: Unique identifier for this ticket comment attachment
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
size_in_bytes:
type: integer
description: Attachment file size, in bytes
contentEncoding: int32
examples:
- 1943
description: Metadata for an attachment on a ticket comment
ticket_status:
title: ticket_status
enum:
- closed
- open
- pending
- solved
type: string
description: 'Ticket status. enum: `closed`, `open`, `pending`, `solved`. `open` means Mist is working on it, `pending` means requester attention is needed, `solved` means Mist considers it resolved but it can still be updated or rated, and `closed` means it is archived'
ticket_upload_attachments_file:
title: ticket_upload_attachments_file
type: object
properties:
file:
type: string
description: Ekahau or ibwave file
contentEncoding: base64
description: Multipart upload payload containing a ticket attachment file
troubleshoot_type:
title: troubleshoot_type
enum:
- wan
- wired
- wireless
type: string
description: 'enum: `wan`, `wired`, `wireless`'
tunnel_config:
title: tunnel_config
type: object
properties:
auto_provision:
allOf:
- $ref: '#/components/schemas/tunnel_config_auto_provision2'
- description: Provider auto-provisioning settings for tunnel endpoints
ike_lifetime:
type: integer
description: Only if `provider`==`custom-ipsec`. IKE lifetime configured for the custom IPsec tunnel
contentEncoding: int32
ike_mode:
allOf:
- $ref: '#/components/schemas/tunnel_config_ike_mode2'
- description: 'Only if `provider`==`custom-ipsec`. IKE negotiation mode for the tunnel. enum: `aggressive`, `main`.'
ike_proposals:
type: array
items:
$ref: '#/components/schemas/tunnel_config_ike_proposal'
description: If `provider`==`custom-ipsec`, IKE proposals used for custom IPsec negotiation
ipsec_lifetime:
type: integer
description: If `provider`==`custom-ipsec`, IPsec lifetime configured for the custom tunnel
contentEncoding: int32
ipsec_proposals:
type: array
items:
$ref: '#/components/schemas/tunnel_config_ipsec_proposal'
description: Only if `provider`==`custom-ipsec`. IPsec proposals used for custom IPsec negotiation
local_id:
type: string
description: Required if `provider`==`zscaler-ipsec`, `provider`==`jse-ipsec` or `provider`==`custom-ipsec`
local_subnets:
type: array
items:
type: string
description: Local protected subnets advertised by this tunnel
mode:
allOf:
- $ref: '#/components/schemas/tunnel_config_tunnel_mode2'
- description: 'Tunnel failover mode used for primary and secondary endpoints. enum: `active-active`, `active-standby`.'
networks:
type: array
items:
type: string
description: Destination networks reachable through this tunnel
primary:
allOf:
- $ref: '#/components/schemas/tunnel_config_node3'
- description: Main remote tunnel endpoint settings
probe:
allOf:
- $ref: '#/components/schemas/tunnel_config_probe'
- description: Tunnel health probe settings
protocol:
allOf:
- $ref: '#/components/schemas/tunnel_config_protocol2'
- description: 'Only if `provider`==`custom-ipsec`. Tunnel protocol for custom tunnel negotiation. enum: `gre`, `ipsec`.'
provider:
allOf:
- $ref: '#/components/schemas/tunnel_config_provider2'
- description: 'Tunnel provider used when auto provisioning is disabled. enum: `custom-ipsec`, `custom-gre`, `jse-ipsec`, `prisma-ipsec`, `zscaler-gre`, `zscaler-ipsec`.'
psk:
type: string
description: Required if `provider`==`zscaler-ipsec`, `provider`==`jse-ipsec` or `provider`==`custom-ipsec`
remote_subnets:
type: array
items:
type: string
description: Remote protected subnets reached through policy-based IPsec
secondary:
allOf:
- $ref: '#/components/schemas/tunnel_config_node1'
- description: Backup remote tunnel endpoint settings
version:
allOf:
- $ref: '#/components/schemas/tunnel_config_version2'
- description: 'Only if `provider`==`custom-gre` or `provider`==`custom-ipsec`. Tunnel version value for custom tunnel configuration. enum: `1`, `2`.'
description: Gateway tunnel configuration for provider-managed or custom tunnels
tunnel_config_auth_algo:
title: tunnel_config_auth_algo
enum:
- md5
- sha1
- sha2
type: string
description: 'enum: `md5`, `sha1`, `sha2`'
tunnel_config_auto_provision:
title: tunnel_config_auto_provision
required:
- provider
type: object
properties:
enabled:
type: boolean
description: Enable auto provisioning for the tunnel. If enabled, the `primary` and `secondary` nodes will be ignored.
latlng:
allOf:
- $ref: '#/components/schemas/tunnel_config_auto_provision_lat_lng2'
- description: Geographic coordinate override used for tunnel POP selection
primary:
allOf:
- $ref: '#/components/schemas/tunnel_config_auto_provision_node3'
- description: Main auto-provisioned tunnel endpoint settings
provider:
allOf:
- $ref: '#/components/schemas/tunnel_config_auto_provision_provider2'
- description: 'Tunnel provider used for automatic endpoint provisioning. enum: `jse-ipsec`, `zscaler-ipsec`.'
region:
type: string
description: API override for POP selection in the case user wants to override the auto discovery of remote network location and force the tunnel to use the specified peer location.
secondary:
allOf:
- $ref: '#/components/schemas/tunnel_config_auto_provision_node1'
- description: Backup auto-provisioned tunnel endpoint settings
service_connection:
type: string
description: if `provider`==`prisma-ipsec`. By default, we'll use the location of the site to determine the optimal Remote Network location, optionally, service_connection can be considered, then we'll also consider this along with the site location. Define service_connection if the traffic is to be routed to a specific service connection. This field takes a service connection name that is configured in the Prisma cloud, Prisma Access Setup -> Service Connections.
examples:
- Juniper-Lab-SC-1
description: Auto-provisioning configuration for the tunnel. This takes precedence over the `primary` and `secondary` nodes.
tunnel_config_auto_provision_lat_lng:
title: tunnel_config_auto_provision_lat_lng
required:
- lat
- lng
type: object
properties:
lat:
type: number
description: Geographic latitude used for POP selection override
examples:
- 37.295833
lng:
type: number
description: Geographic longitude used for POP selection override
examples:
- -122.032946
description: Geographic coordinate override for tunnel POP selection
tunnel_config_auto_provision_node:
title: tunnel_config_auto_provision_node
type: object
properties:
probe_ips:
uniqueItems: true
type: array
items:
type: string
description: Probe IP addresses used to monitor auto-provisioned tunnel reachability
wan_names:
type: array
items:
type: string
description: WAN interface names used by the auto-provisioned tunnel endpoint
description: Auto-provisioned tunnel endpoint settings
tunnel_config_auto_provision_provider:
title: tunnel_config_auto_provision_provider
enum:
- jse-ipsec
- zscaler-ipsec
type: string
description: 'Tunnel provider used for automatic endpoint provisioning. enum: `jse-ipsec`, `zscaler-ipsec`'
tunnel_config_dh_group:
title: tunnel_config_dh_group
enum:
- '1'
- '14'
- '15'
- '16'
- '19'
- '2'
- '20'
- '21'
- '24'
- '5'
type: string
description: 'Only if `provider`==`custom-ipsec`. Diffie-Hellman group for IPsec phase 2. enum: `1`, `14`, `15`, `16`, `19`, `2`, `20`, `21`, `24`, `5`. `14` is the default 2048-bit group; `19`, `20`, `21`, and `24` are ECP groups'
tunnel_config_enc_algo:
title: tunnel_config_enc_algo
enum:
- 3des
- aes128
- aes256
- aes_gcm128
- aes_gcm256
type: string
description: 'enum: `3des`, `aes128`, `aes256`, `aes_gcm128`, `aes_gcm256`'
tunnel_config_ike_dh_group:
title: tunnel_config_ike_dh_group
enum:
- '1'
- '14'
- '15'
- '16'
- '19'
- '2'
- '20'
- '21'
- '24'
- '5'
type: string
description: 'Diffie-Hellman group for IKE phase 1. enum: `1`, `14`, `15`, `16`, `19`, `2`, `20`, `21`, `24`, `5`. `14` is the default 2048-bit group; `19`, `20`, `21`, and `24` are ECP groups'
tunnel_config_ike_mode:
title: tunnel_config_ike_mode
enum:
- aggressive
- main
type: string
description: 'Only if `provider`==`custom-ipsec`. enum: `aggressive`, `main`'
tunnel_config_ike_proposal:
title: tunnel_config_ike_proposal
type: object
properties:
auth_algo:
allOf:
- $ref: '#/components/schemas/tunnel_config_auth_algo3'
- description: 'Integrity algorithm used by this IKE proposal. enum: `md5`, `sha1`, `sha2`.'
dh_group:
allOf:
- $ref: '#/components/schemas/tunnel_config_ike_dh_group2'
- description: 'Diffie-Hellman group used by this IKE proposal. enum: `1`, `14`, `15`, `16`, `19`, `2`, `20`, `21`, `24`, `5`.'
enc_algo:
allOf:
- oneOf:
- {}
- $ref: '#/components/schemas/tunnel_config_enc_algo3'
- description: 'Cipher algorithm used by this IKE proposal. enum: `3des`, `aes128`, `aes256`, `aes_gcm128`, `aes_gcm256`.'
description: IKE proposal settings for custom IPsec tunnels
tunnel_config_ipsec_proposal:
title: tunnel_config_ipsec_proposal
type: object
properties:
auth_algo:
allOf:
- $ref: '#/components/schemas/tunnel_config_auth_algo1'
- description: 'Integrity algorithm used by this IPsec proposal. enum: `md5`, `sha1`, `sha2`.'
dh_group:
allOf:
- $ref: '#/components/schemas/tunnel_config_dh_group2'
- description: 'Diffie-Hellman group used by this IPsec proposal. enum: `1`, `14`, `15`, `16`, `19`, `2`, `20`, `21`, `24`, `5`.'
enc_algo:
allOf:
- oneOf:
- {}
- $ref: '#/components/schemas/tunnel_config_enc_algo1'
- description: 'Cipher algorithm used by this IPsec proposal. enum: `3des`, `aes128`, `aes256`, `aes_gcm128`, `aes_gcm256`.'
description: IPsec proposal settings for custom IPsec tunnels
tunnel_config_node:
title: tunnel_config_node
required:
- hosts
- wan_names
type: object
properties:
hosts:
type: array
items:
type: string
description: Remote gateway host addresses for this tunnel node
internal_ip6s:
uniqueItems: true
type: array
items:
type: string
description: IPv6 addresses configured on this tunnel node
internal_ips:
type: array
items:
type: string
description: Internal IP addresses configured on this tunnel node
probe_hostnames:
uniqueItems: true
type: array
items:
type: string
description: Hostnames used as ICMP probe destinations for this tunnel node; applicable for both IPv4 and IPv6
probe_http:
allOf:
- $ref: '#/components/schemas/tunnel_config_node_probe_http2'
- description: HTTP probe settings for this tunnel node; success from any ICMP or HTTP probe indicates the tunnel is up
probe_ip6s:
uniqueItems: true
type: array
items:
type: string
description: IPv6 ICMP probe addresses used to monitor this tunnel node
probe_ips:
uniqueItems: true
type: array
items:
type: string
description: Health-check IP addresses used to monitor this tunnel node
remote_ids:
type: array
items:
type: string
description: IKE identities expected from this tunnel node
wan_names:
type: array
items:
type: string
description: Interface names that source tunnel traffic for this node
description: Only if `provider`==`zscaler-ipsec`, `provider`==`jse-ipsec` or `provider`==`custom-ipsec`
tunnel_config_node_probe_http:
title: tunnel_config_node_probe_http
type: object
properties:
accepted_status_codes:
type: array
items:
type: integer
contentEncoding: int32
description: HTTP response status codes that indicate a successful probe. Defaults to 200 if not specified.
examples:
- - 204
urls:
type: array
items:
type: string
description: HTTP or HTTPS URLs to probe
examples:
- - http://www.google.com/generate_204
- https://www.google.com/generate_204
description: HTTP probe settings for a custom IPsec tunnel node
tunnel_config_probe:
title: tunnel_config_probe
type: object
properties:
interval:
type: integer
description: How often to trigger the probe
contentEncoding: int32
threshold:
type: integer
description: Number of consecutive misses before declaring the tunnel down
contentEncoding: int32
timeout:
type: integer
description: Time within which to complete the connectivity check
contentEncoding: int32
type:
allOf:
- $ref: '#/components/schemas/tunnel_config_probe_type2'
- description: 'Protocol used by the custom IPsec tunnel health probe. enum: `http`, `icmp`.'
description: Tunnel health probe settings
tunnel_config_probe_type:
title: tunnel_config_probe_type
enum:
- http
- icmp
type: string
description: 'Protocol used by the custom IPsec tunnel health probe. `http` is deprecated — use `probe_ips`/`probe_hostnames` for ICMP probes and `probe_http` for HTTP probes instead. enum: `http`, `icmp`'
tunnel_config_protocol:
title: tunnel_config_protocol
enum:
- gre
- ipsec
type: string
description: 'Only if `provider`==`custom-ipsec`. enum: `gre`, `ipsec`'
tunnel_config_provider:
title: tunnel_config_provider
enum:
- custom-ipsec
- custom-gre
- jse-ipsec
- prisma-ipsec
- zscaler-gre
- zscaler-ipsec
type: string
description: 'Only if `auto_provision.enabled`==`false`. enum: `custom-ipsec`, `custom-gre`, `jse-ipsec`, `prisma-ipsec`, `zscaler-gre`, `zscaler-ipsec`'
tunnel_config_tunnel_mode:
title: tunnel_config_tunnel_mode
enum:
- active-active
- active-standby
type: string
description: 'Required if `provider`==`zscaler-gre`, `provider`==`jse-ipsec`. enum: `active-active`, `active-standby`'
tunnel_config_version:
title: tunnel_config_version
enum:
- '1'
- '2'
type: string
description: 'Only if `provider`==`custom-gre` or `provider`==`custom-ipsec`. enum: `1`, `2`'
tunnel_priority:
title: tunnel_priority
enum:
- primary
- secondary
type: string
description: 'Relative preference assigned to the tunnel. enum: `primary`, `secondary`'
tunnel_provider_options:
title: tunnel_provider_options
type: object
properties:
jse:
allOf:
- $ref: '#/components/schemas/tunnel_provider_options_jse2'
- description: Juniper Secure Edge provisioning options for tunnel endpoints
prisma:
allOf:
- $ref: '#/components/schemas/tunnel_provider_options_prisma2'
- description: Palo Alto Prisma Access provisioning options for tunnel endpoints
zscaler:
allOf:
- $ref: '#/components/schemas/tunnel_provider_options_zscaler2'
- description: Provider settings for Zscaler tunnel endpoints
description: Provider-specific options for gateway tunnel auto provisioning
tunnel_provider_options_jse:
title: tunnel_provider_options_jse
type: object
properties:
num_users:
type: integer
description: User capacity to provision on Juniper Secure Edge
contentEncoding: int32
examples:
- 5
org_name:
type: string
description: JSE Organization name. The list of available organizations can be retrieved with the [Get Org JSE Info]($e/Orgs%20Integration%20JSE/getOrgJseInfo) API Call
examples:
- JSE_ORG1
description: For jse-ipsec, this allows provisioning of adequate resource on JSE. Make sure adequate licenses are added
tunnel_provider_options_prisma:
title: tunnel_provider_options_prisma
type: object
properties:
service_account_name:
type: string
description: For prisma-ipsec, service account name to used for tunnel auto provisioning
examples:
- sa1@1823425211
description: Prisma Access provider options for tunnel auto provisioning
tunnel_provider_options_zscaler:
title: tunnel_provider_options_zscaler
type: object
properties:
aup_block_internet_until_accepted:
type: boolean
description: Whether Zscaler blocks internet access until the Acceptable Use Policy is accepted
default: false
aup_enabled:
type: boolean
description: Can only be `true` when `auth_required`==`false`, display Acceptable Use Policy (AUP)
default: false
aup_force_ssl_inspection:
type: boolean
description: Proxy HTTPs traffic, requiring Zscaler cert to be installed in browser
default: false
aup_timeout_in_days:
maximum: 180
minimum: 1
type: integer
description: Required if `aup_enabled`==`true`. Days before AUP is requested again
contentEncoding: int32
auth_required:
type: boolean
description: Enable this option to enforce user authentication
default: false
caution_enabled:
type: boolean
description: Can only be `true` when `auth_required`==`false`, display caution notification for non-authenticated users
default: false
dn_bandwidth:
maximum: 99999
minimum: 0.1
type:
- number
- 'null'
description: Download bandwidth cap of the link, in Mbps. Disabled if not set
examples:
- 200
idle_time_in_minutes:
maximum: 43200
minimum: 0
type: integer
description: Required if `surrogate_IP`==`true`, idle Time to Disassociation
contentEncoding: int32
ofw_enabled:
type: boolean
description: If `true`, enable the firewall control option
default: false
sub_locations:
type: array
items:
$ref: '#/components/schemas/tunnel_provider_options_zscaler_sub_location'
description: Per-network Zscaler sub-location settings
surrogate_IP:
type: boolean
description: Can only be `true` when `auth_required`==`true`. Map a user to a private IP address so it applies the user's policies, instead of the location's policies
default: false
surrogate_IP_enforced_for_known_browsers:
type: boolean
description: Can only be `true` when `surrogate_IP`==`true`, enforce surrogate IP for known browsers
surrogate_refresh_time_in_minutes:
maximum: 43200
minimum: 1
type: integer
description: Required if `surrogate_IP_enforced_for_known_browsers`==`true`, must be lower or equal than `idle_time_in_minutes`, refresh Time for re-validation of Surrogacy
contentEncoding: int32
up_bandwidth:
maximum: 99999
minimum: 0.1
type:
- number
- 'null'
description: Download bandwidth cap of the link, in Mbps. Disabled if not set
examples:
- 200
xff_forward_enabled:
type: boolean
description: Location uses proxy chaining to forward traffic
default: false
description: For zscaler-ipsec and zscaler-gre
tunnel_provider_options_zscaler_sub_location:
title: tunnel_provider_options_zscaler_sub_location
type: object
properties:
aup_block_internet_until_accepted:
type: boolean
description: Whether this sub-location blocks internet access until the Acceptable Use Policy is accepted
default: false
aup_enabled:
type: boolean
description: Can only be `true` when `auth_required`==`false`, display Acceptable Use Policy (AUP)
default: false
aup_force_ssl_inspection:
type: boolean
description: Proxy HTTPs traffic, requiring Zscaler cert to be installed in browser
default: false
aup_timeout_in_days:
maximum: 180
minimum: 1
type: integer
description: Required if `aup_enabled`==`true`. Days before AUP is requested again
contentEncoding: int32
auth_required:
type: boolean
description: Enable this option to authenticate users
default: false
caution_enabled:
type: boolean
description: Can only be `true` when `auth_required`==`false`, display caution notification for non-authenticated users
default: false
dn_bandwidth:
maximum: 99999
minimum: 0.1
type:
- number
- 'null'
description: Download bandwidth cap of the link, in Mbps. Disabled if not set
examples:
- 200
idle_time_in_minutes:
maximum: 43200
minimum: 0
type: integer
description: Required if `surrogate_IP`==`true`, idle Time to Disassociation
contentEncoding: int32
name:
type: string
description: '[network]($h/Orgs%20Networks/_overview) name'
ofw_enabled:
type: boolean
description: If `true`, enable the firewall control option
default: false
surrogate_IP:
type: boolean
description: Can only be `true` when `auth_required`==`true`. Map a user to a private IP address so it applies the user's policies, instead of the location's policies
default: false
surrogate_IP_enforced_for_known_browsers:
type: boolean
description: Can only be `true` when `surrogate_IP`==`true`, enforce surrogate IP for known browsers
surrogate_refresh_time_in_minutes:
maximum: 43200
minimum: 1
type: integer
description: Required if `surrogate_IP_enforced_for_known_browsers`==`true`, must be lower or equal than `idle_time_in_minutes`, refresh Time for re-validation of Surrogacy
contentEncoding: int32
up_bandwidth:
maximum: 99999
minimum: 0.1
type:
- number
- 'null'
description: Download bandwidth cap of the link, in Mbps. Disabled if not set
examples:
- 200
description: Zscaler sub-location settings for a specific network
tunnel_type:
title: tunnel_type
enum:
- wan
- wxtunnel
type: string
description: 'Tunnel category, either WAN tunnel or WxLAN tunnel. enum: `wan`, `wxtunnel`'
tunnel_via:
title: tunnel_via
enum:
- primary
- secondary
type: string
description: 'If `via`==`tunnel`, specifies which tunnel (primary/secondary) this neighbor is associated with. enum: `primary`, `secondary`'
tunterm_dhcpd_config:
title: tunterm_dhcpd_config
type: object
properties:
enabled:
type: boolean
description: Whether DHCP relay is enabled for tunnel termination VLANs
default: false
servers:
uniqueItems: true
type: array
items:
type: string
description: DHCP server IP addresses used as relay targets
type:
allOf:
- $ref: '#/components/schemas/tunterm_dhcpd_type3'
- description: 'DHCP forwarding mode for tunnel termination VLANs. enum: `relay`.'
additionalProperties:
allOf:
- $ref: '#/components/schemas/tunterm_dhcpd_config_property'
- description: Per-VLAN DHCP relay configuration for tunnel termination
description: DHCP server/relay configuration of Mist Tunneled VLANs. Property key is the VLAN ID
tunterm_dhcpd_config_property:
title: tunterm_dhcpd_config_property
type: object
properties:
enabled:
type: boolean
description: Whether DHCP relay is enabled for this tunneled VLAN
default: false
servers:
uniqueItems: true
type: array
items:
type: string
description: DHCP server IP addresses used as relay targets for this VLAN
type:
allOf:
- $ref: '#/components/schemas/tunterm_dhcpd_type1'
- description: 'DHCP forwarding mode for this tunneled VLAN. enum: `relay`.'
description: Per-VLAN DHCP relay configuration for tunnel termination
tunterm_dhcpd_type:
title: tunterm_dhcpd_type
const: relay
type: string
description: 'DHCP handling mode for tunnel termination. enum: `relay`'
tunterm_monitoring_protocol:
title: tunterm_monitoring_protocol
enum:
- arp
- ping
- tcp
type: string
description: 'enum: `arp`, `ping`, `tcp`'
examples:
- tcp
tunterm_port_config:
title: tunterm_port_config
type: object
properties:
downstream_ports:
type: array
items:
type: string
description: Ports connected downstream toward APs for tunnel termination
examples:
- - '2'
- '3'
separate_upstream_downstream:
type: boolean
description: Whether to separate upstream / downstream ports. default is false where all ports will be used.
default: false
upstream_port_vlan_id:
oneOf:
- type: string
- maximum: 4094
minimum: 1
type: integer
contentEncoding: int32
description: Native VLAN ID applied to upstream tunnel termination ports
upstream_ports:
type: array
items:
type: string
description: Ports connected upstream toward the LAN for tunnel termination
examples:
- - '0'
- '1'
description: Ethernet port configuration for tunnel termination interfaces
two_factor_code:
title: two_factor_code
required:
- two_factor
type: object
properties:
two_factor:
type: string
description: One-time password generated by the user's authenticator app
examples:
- '123456'
description: Request body for verifying a 2FA one-time password
two_factor_string:
title: two_factor_string
required:
- two_factor
type: object
properties:
two_factor:
type: string
description: One-time 2FA login code generated by the user's authenticator app
examples:
- '123456'
description: Request body for submitting a 2FA login code
ui_settings:
title: ui_settings
required:
- description
- purpose
type: object
properties:
created_time:
type: number
description: Time when the databoard was created, in epoch seconds
readOnly: true
defaultScopeId:
type: string
description: Scope identifier used by default for this databoard
examples:
- 67970e46-4e12-11e6-9188-0242ad112847
defaultScopeType:
type: string
description: Scope type used by default for this databoard
examples:
- site
defaultTimeRange:
allOf:
- $ref: '#/components/schemas/ui_settings_default_time_range2'
- description: Time range used by default for this databoard
description:
type: string
description: Text describing the databoard
examples:
- Description of the databoard
for_site:
type: boolean
description: Whether this databoard is scoped to a site
readOnly: true
examples:
- true
id:
type: string
description: Unique identifier for the databoard
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
isCustomDataboard:
type: boolean
description: Whether this databoard is custom-created
isScopeLinked:
type: boolean
description: Whether tile scopes are linked to the databoard default scope
isTimeRangeLinked:
type: boolean
description: Whether tile time ranges are linked to the databoard default time range
modified_time:
type: number
description: Time when the databoard was last modified, in epoch seconds
readOnly: true
name:
type: string
description: Display name of the databoard
examples:
- New Databoard
org_id:
type: string
description: Organization that owns the databoard
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
purpose:
type: string
description: UI surface or purpose for this databoard
examples:
- databoard
site_id:
type: string
description: Site associated with this databoard
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
tiles:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/ui_settings_tile'
description: Configured tiles for this databoard
description: Site UI settings databoard
ui_settings_default_time_range:
title: ui_settings_default_time_range
type: object
properties:
end:
type: integer
description: Upper bound of the default databoard time range, in epoch seconds
contentEncoding: int32
examples:
- 1508828400
endDate:
type: string
description: Display date for the end of the default databoard time range
examples:
- 10/23/2017
interval:
type: string
description: Bucket interval used for the default databoard time range
examples:
- 1d
name:
type: string
description: Display name for the default databoard time range
examples:
- This Week
shortName:
type: string
description: Compact display label for the default databoard time range
examples:
- thisWeek
start:
type: integer
description: Lower bound of the default databoard time range, in epoch seconds
contentEncoding: int32
examples:
- 1508655600
usePreset:
type: boolean
description: Whether the default databoard time range uses a named preset
examples:
- true
description: Default time range applied to a site UI databoard
ui_settings_tile:
title: ui_settings_tile
type: object
properties:
chartBand:
type: string
description: Band or category filter applied to the tile chart
examples:
- 2.4 ghz
chartColor:
type: string
description: Hex color used to render the tile chart
examples:
- '#00B4AD'
chartDirection:
type: string
description: Traffic direction displayed by the tile chart
examples:
- tx + rx
chartRankBy:
type: string
description: Ranking field used by the tile chart
chartType:
type: string
description: Visualization chart type for this tile
examples:
- timeSeries
colspan:
type: integer
description: Number of grid columns spanned by this tile
contentEncoding: int32
examples:
- 5
column:
type: integer
description: Grid column where this tile starts
contentEncoding: int32
examples:
- 1
hideEmptyRows:
type: boolean
description: Whether empty rows are hidden in this tile
id:
type: string
description: Unique identifier for this databoard tile
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
metric:
allOf:
- $ref: '#/components/schemas/ui_settings_tile_metric2'
- description: Selected measurement configuration displayed by this tile
name:
type: string
description: Display name of this databoard tile
examples:
- New Analysis
row:
type: integer
description: Grid row where this tile starts
contentEncoding: int32
examples:
- 1
rowspan:
type: integer
description: Number of grid rows spanned by this tile
contentEncoding: int32
examples:
- 2
scopeId:
type: string
description: Identifier of the scope used by this tile
examples:
- e0c767834b4c
scopeType:
type: string
description: Type of scope used by this tile
examples:
- client
sortedColumnIds:
type: array
items:
type: string
description: Column identifiers that define the tile sort order
timeRange:
allOf:
- $ref: '#/components/schemas/ui_settings_tile_time_range2'
- description: Time range override for this tile
trendType:
type: string
description: Rendering style for trend data in this tile
examples:
- line
vizType:
type: string
description: Display visualization type used by this tile
examples:
- averageTimeSeriesChart
description: Tile shown on a site UI databoard
ui_settings_tile_metric:
title: ui_settings_tile_metric
type: object
properties:
apiName:
type: string
description: Metric API name requested by this tile
examples:
- client_dhcp_latency
description: Metric selected for a site UI databoard tile
ui_settings_tile_time_range:
title: ui_settings_tile_time_range
type: object
properties:
end:
type: number
description: Upper bound of the tile time range, in epoch seconds
examples:
- 1508823743
endDate:
type: string
description: Display date for the end of the tile time range
examples:
- 10/23/2017
interval:
type: string
description: Bucket interval used for the tile time range
examples:
- 1d
name:
type: string
description: Display name for the tile time range
examples:
- Past 7 Days
shortName:
type: string
description: Compact display label for the tile time range
examples:
- 7d
start:
type: integer
description: Lower bound of the tile time range, in epoch seconds
contentEncoding: int32
examples:
- 1508223600
usePreset:
type: boolean
description: Whether the tile time range uses a named preset
examples:
- true
description: Time range override for a site UI databoard tile
upgrade_bios:
title: upgrade_bios
type: object
properties:
reboot:
type: boolean
description: Whether to restart the device immediately after the upgrade completes
default: false
version:
type: string
description: BIOS version to install on the device
examples:
- CDEN_P_EX1_00.20.01.00
description: BIOS upgrade request for a single device
upgrade_bios_multi:
title: upgrade_bios_multi
type: object
properties:
device_ids:
type: array
items:
type: string
contentEncoding: uuid
description: Specific device IDs to include in the BIOS upgrade
models:
type: array
items:
type: string
description: Device models to include in the BIOS upgrade
reboot:
type: boolean
description: Whether to restart the selected devices immediately after the upgrade completes
default: false
version:
type: string
description: BIOS version to install on the selected devices
examples:
- CDEN_P_EX1_00.15.01.00
description: BIOS upgrade request for multiple devices
upgrade_device_rrm_mesh_upgrade:
title: upgrade_device_rrm_mesh_upgrade
enum:
- parallel
- sequential
type: string
description: 'For APs only and if `strategy`==`rrm`. Whether to upgrade mesh AP’s parallelly or sequentially at the end of the upgrade. enum: `parallel`, `sequential`'
upgrade_device_rrm_node_order:
title: upgrade_device_rrm_node_order
enum:
- center_to_fringe
- fringe_to_center
type: string
description: 'For APs only and if `strategy`==`rrm`. Used in rrm to determine whether to start upgrade from fringe or center AP’s. enum: `center_to_fringe`, `fringe_to_center`'
upgrade_device_status:
title: upgrade_device_status
enum:
- cancelled
- completed
- created
- downloaded
- downloading
- failed
- queued
- upgrading
type: string
description: 'status upgrade is in. enum: `cancelled`, `completed`, `created`, `downloaded`, `downloading`, `failed`, `upgrading`, `queued`'
upgrade_device_strategy:
title: upgrade_device_strategy
enum:
- big_bang
- canary
- rrm
- serial
type: string
description: 'enum: `big_bang` (upgrade all at once), `canary`, `rrm` (APs only), `serial` (one at a time)'
upgrade_device_strategy_deprecated:
title: upgrade_device_strategy_deprecated
enum:
- big_bang
- canary
- rrm
- serial
type: string
description: Deprecated; use `download_strategy` and `reboot_strategy` instead. `big_bang` (upgrade all at once, no orchestration), `serial` (one at a time), `canary`, or `rrm` (AP only); default is big_bang
deprecated: true
upgrade_devices_targets:
title: upgrade_devices_targets
type: object
properties:
download_requested:
type: array
items:
type: string
description: Device MAC addresses for devices requested to download firmware
downloaded:
type: array
items:
type: string
description: Device MAC addresses for devices that have downloaded firmware
downloading:
type: array
items:
type: string
description: Device MAC addresses for devices currently downloading firmware
failed:
type: array
items:
type: string
description: Device MAC addresses for devices that failed to upgrade
reboot_in_progress:
type: array
items:
type: string
description: Device MAC addresses for devices currently rebooting
rebooted:
type: array
items:
type: string
description: Device MAC addresses for devices that rebooted successfully
scheduled:
type: array
items:
type: string
description: Device MAC addresses for devices scheduled for upgrade by the cloud
skipped:
type: array
items:
type: string
description: Device MAC addresses for devices skipped because the requested version matched the running version
total:
type: integer
description: Count of devices part of this upgrade
contentEncoding: int32
upgraded:
type: array
items:
type: string
description: Device MAC addresses for devices that upgraded successfully
description: Read-only device target lists grouped by upgrade status
upgrade_fpga:
title: upgrade_fpga
type: object
properties:
reboot:
type: boolean
description: Whether to restart the device immediately after the upgrade completes
default: false
version:
type: string
description: FPGA version to install on the device
examples:
- REV37
description: FPGA upgrade request for a single device
upgrade_fpga_multi:
title: upgrade_fpga_multi
type: object
properties:
device_ids:
type: array
items:
type: string
contentEncoding: uuid
description: Specific device IDs to include in the FPGA upgrade
models:
type: array
items:
type: string
description: Device models to include in the FPGA upgrade
reboot:
type: boolean
description: Whether to restart the selected devices immediately after the upgrade completes
default: false
version:
type: string
description: FPGA version to install on the selected devices
examples:
- REV37
description: FPGA upgrade request for multiple devices
upgrade_info_status:
title: upgrade_info_status
enum:
- error
- inprogress
- scheduled
- starting
- success
type: string
description: 'enum: `error`, `inprogress`, `scheduled`, `starting`, `success`'
upgrade_org_devices:
title: upgrade_org_devices
type: object
properties:
all_sites:
type: boolean
description: If `true`, will upgrade all sites in this org; overrides `site_ids`
default: false
canary_phases:
type: array
items:
type: integer
contentEncoding: int32
description: Only if `strategy`==`canary`. Canary phase percentages for the organization upgrade
default:
- 1
- 10
- 50
- 100
device_type:
allOf:
- $ref: '#/components/schemas/device_type5'
- description: 'Device family selected for the organization upgrade. enum: `ap`, `gateway`, `switch`.'
download_strategy:
allOf:
- $ref: '#/components/schemas/upgrade_org_devices_download_strategy2'
- description: 'Firmware download orchestration strategy for the organization upgrade. enum: `canary`, `big_bang`, `serial`.'
enable_p2p:
type: boolean
description: For APs only. Whether to allow local AP-to-AP firmware upgrade
max_failure_percentage:
maximum: 100
minimum: 0
type: integer
description: If `strategy`!=`big_bang`. Allowed failure percentage across the organization upgrade
contentEncoding: int32
default: 5
max_failures:
type: array
items:
type: integer
contentEncoding: int32
description: If `strategy`==`canary`. Per-phase failure limits for the organization upgrade
models:
type: array
items:
type: array
items:
type: string
description: Device models selected for the organization upgrade
p2p_cluster_size:
minimum: 0
type: integer
description: For APs only. Size to split devices for peer-to-peer download batches; default 10
contentEncoding: int32
default: 10
examples:
- 10
p2p_parallelism:
type: integer
description: For APs only. Number of parallel peer-to-peer download batches to create. If not set, automatically determined based on device count (<=50 uses 1, 51-100 uses 3, >100 uses 10)
contentEncoding: int32
reboot_at:
type: integer
description: Reboot start time in epoch seconds, default is `start_time`; deprecated, use `reboot_datetime` instead
contentEncoding: int32
examples:
- 1624399840
deprecated: true
reboot_datetime:
type: string
description: Reboot start time in ISO 8601 format; default is `start_datetime`. Exclude timezone component to use site local timezone
examples:
- 2024-06-13 15:00:00-07:00
reboot_strategy:
allOf:
- $ref: '#/components/schemas/upgrade_device_strategy4'
- description: 'Device reboot orchestration strategy for selected devices. enum: `big_bang`, `canary`, `rrm`, `serial`.'
rrm_first_batch_percentage:
type: integer
description: For APs only and if `strategy`==`rrm`. Percentage of APs that need to be present in the first RRM batch
contentEncoding: int32
examples:
- 2
rrm_max_batch_percentage:
type: integer
description: For APs only and if `strategy`==`rrm`. Max percentage of APs that need to be present in each RRM batch
contentEncoding: int32
examples:
- 10
rrm_mesh_upgrade:
allOf:
- $ref: '#/components/schemas/upgrade_device_rrm_mesh_upgrade1'
- description: 'For APs only and if `strategy`==`rrm`. Mesh AP upgrade order for the organization upgrade. enum: `parallel`, `sequential`.'
rrm_node_order:
allOf:
- $ref: '#/components/schemas/upgrade_device_rrm_node_order1'
- description: 'For APs only and if `strategy`==`rrm`. AP ordering direction for RRM upgrade batches. enum: `center_to_fringe`, `fringe_to_center`.'
rrm_slow_ramp:
type: boolean
description: For APs only and if `strategy`==`rrm`. True will make rrm batch sizes slowly ramp up
rules:
type: array
items:
type: object
additionalProperties:
type: string
description: Selection rules used to choose devices for this organization upgrade
examples:
- - match_model: AP43
match_name[2:8]: access
- match_model: AP45
description: Selection rules used to choose devices for this organization upgrade
examples:
- - match_model: AP43
match_name[2:8]: access
- match_model: AP45
site_ids:
type: array
items:
type: string
contentEncoding: uuid
description: Identifiers of sites used to limit the organization upgrade
snapshot:
type: boolean
description: For Junos devices only. Perform recovery snapshot after device is rebooted
default: false
start_datetime:
type: string
description: Firmware download start time in ISO 8601 format; default is now. Exclude timezone component to use site local timezone
examples:
- 2024-06-13 15:00:00-07:00
start_time:
type: integer
description: Firmware download start time in epoch seconds, default is now; deprecated, use `start_datetime` instead
contentEncoding: int32
examples:
- 1624399840
deprecated: true
strategy:
allOf:
- $ref: '#/components/schemas/upgrade_device_strategy_deprecated'
- description: Deprecated; use `download_strategy` and `reboot_strategy` instead. `big_bang` (upgrade all at once, no orchestration), `serial` (one at a time), `canary`, or `rrm` (AP only); default is big_bang
deprecated: true
version:
type: string
description: Deprecated; use `versions` instead. Specific firmware version, `suggested`, or `alpha`; default is latest
deprecated: true
versions:
type: array
items:
$ref: '#/components/schemas/upgrade_org_devices_version'
description: Target firmware versions for this organization upgrade
description: Organization-wide device upgrade request
upgrade_org_devices_download_strategy:
title: upgrade_org_devices_download_strategy
enum:
- canary
- big_bang
- serial
type: string
description: >-
enum:
* `big_bang`: download all at once, no orchestration
* `serial`: one at a time'
* `canary`: upgrade in phases
upgrade_org_devices_item:
title: upgrade_org_devices_item
type: object
properties:
id:
type: string
description: Unique identifier for the organization upgrade job
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
site_upgrades:
type: array
items:
$ref: '#/components/schemas/upgrade_org_devices_item_site_upgrade'
description: Per-site upgrade jobs created by this organization upgrade
description: Organization device upgrade job returned by upgrade APIs
upgrade_org_devices_item_site_upgrade:
title: upgrade_org_devices_item_site_upgrade
type: object
properties:
site_id:
type: string
description: Identifier of the site that received this upgrade job
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
upgrade_id:
type: string
description: Identifier of the site-level upgrade job
contentEncoding: uuid
examples:
- ebbdbd0b-1bcf-4e55-8a6a-3416049a52b1
description: Site upgrade mapping returned for an organization upgrade
upgrade_org_devices_upgrade:
title: upgrade_org_devices_upgrade
type: object
properties:
site_id:
type: string
description: Identifier of the site for this upgrade entry
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
upgrade:
allOf:
- $ref: '#/components/schemas/upgrade_org_devices_upgrade_info2'
- description: Site-level job details for this upgrade entry
description: Upgrade entry for a single site within an organization upgrade job
upgrade_org_devices_upgrade_info:
title: upgrade_org_devices_upgrade_info
type: object
properties:
id:
type: string
description: Unique value identifying the site-level upgrade job
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
start_time:
type: integer
description: Epoch timestamp, in seconds, when the site-level upgrade starts
contentEncoding: int32
examples:
- 1717658765
status:
allOf:
- $ref: '#/components/schemas/upgrade_device_status2'
- description: 'Current status of the site-level upgrade job. enum: `cancelled`, `completed`, `created`, `downloaded`, `downloading`, `failed`, `queued`, `upgrading`.'
targets:
allOf:
- $ref: '#/components/schemas/upgrade_devices_targets1'
- description: Device targets grouped by upgrade state
readOnly: true
description: Site-level upgrade job details within an organization upgrade
upgrade_org_devices_version:
title: upgrade_org_devices_version
type: object
properties:
firmware_type:
allOf:
- $ref: '#/components/schemas/upgrade_org_devices_version_firmware_type2'
- description: 'Firmware family this version entry applies to. enum: `ap`, `junos`, `ssr`.'
force:
type: boolean
description: Set to `true` to force upgrade. For `device_type`==`ap`, applies when target version <= running version. For `device_type`==`gateway` with `firmware_type`==`ssr`, applies only when target version == running version; default false
default: false
model_version:
type: object
additionalProperties:
type: string
description: Map of device model to firmware version; overrides `version` for the specified models
version:
type: string
description: Firmware version to deploy for this entry
description: Target firmware version entry for an organization upgrade request
upgrade_org_devices_version_firmware_type:
title: upgrade_org_devices_version_firmware_type
enum:
- ap
- junos
- ssr
type: string
description: 'Firmware family this version entry applies to. enum: `ap`, `junos`, `ssr`'
upgrade_site_devices:
title: upgrade_site_devices
type: object
properties:
canary_phases:
type: array
items:
type: integer
contentEncoding: int32
description: Only if `strategy`==`canary`. Canary phase percentages for the site upgrade
default:
- 1
- 10
- 50
- 100
device_ids:
type: array
items:
type: string
contentEncoding: uuid
description: Specific device IDs selected for the site upgrade
enable_p2p:
type: boolean
description: For APs only. Whether to allow local AP-to-AP FW upgrade
force:
type: boolean
description: '`force`==`true` will force upgrade when requested version is same as running version'
default: false
max_failure_percentage:
maximum: 100
minimum: 0
type: integer
description: If `strategy`!=`big_bang`. Allowed failure percentage across the site upgrade
contentEncoding: int32
default: 5
max_failures:
type: array
items:
type: integer
contentEncoding: int32
description: If `strategy`==`canary`. Per-phase failure limits for the site upgrade
models:
type: array
items:
type: string
description: Device models selected for the site upgrade
p2p_cluster_size:
minimum: 0
type: integer
description: For APs only and if `enable_p2p`==`true`. Size to split devices for peer-to-peer download batches; default 10
contentEncoding: int32
default: 10
examples:
- 10
p2p_parallelism:
type: integer
description: For APs only and if `enable_p2p`==`true`. Number of parallel peer-to-peer download batches to create. If not set, automatically determined based on device count (<=50 uses 1, 51-100 uses 3, >100 uses 10)
contentEncoding: int32
reboot:
type: boolean
description: For Switches and Gateways only (APs are automatically rebooted). Reboot device immediately after upgrade is completed
default: false
reboot_at:
type: integer
description: For Switches and Gateways only and if `reboot`==`true`. Reboot start time in epoch seconds, default is `start_time`
contentEncoding: int32
examples:
- 1624399840
rrm_first_batch_percentage:
type: integer
description: For APs only and if `strategy`==`rrm`. Percentage of APs that need to be present in the first RRM batch
contentEncoding: int32
examples:
- 2
rrm_max_batch_percentage:
type: integer
description: For APs only and if `strategy`==`rrm`. Max percentage of APs that need to be present in each RRM batch
contentEncoding: int32
examples:
- 10
rrm_mesh_upgrade:
allOf:
- $ref: '#/components/schemas/upgrade_device_rrm_mesh_upgrade2'
- description: 'For APs only and if `strategy`==`rrm`. Mesh AP upgrade order for the site upgrade. enum: `parallel`, `sequential`.'
rrm_node_order:
allOf:
- $ref: '#/components/schemas/upgrade_device_rrm_node_order1'
- description: 'For APs only and if `strategy`==`rrm`. AP ordering direction for RRM upgrade batches. enum: `center_to_fringe`, `fringe_to_center`.'
rrm_slow_ramp:
type: boolean
description: For APs only and if `strategy`==`rrm`. True will make rrm batch sizes slowly ramp up
rules:
type: array
items:
type: object
additionalProperties:
type: string
description: Selection rules used to choose devices for this site upgrade
examples:
- - match_model: AP43
match_name[2:8]: access
- match_model: AP45
description: Selection rules used to choose devices for this site upgrade
examples:
- - match_model: AP43
match_name[2:8]: access
- match_model: AP45
snapshot:
type: boolean
description: For Junos devices only. Perform recovery snapshot after device is rebooted
default: false
start_time:
type: integer
description: Upgrade start time in epoch seconds, default is now
contentEncoding: int32
examples:
- 1624399840
strategy:
allOf:
- $ref: '#/components/schemas/upgrade_device_strategy5'
- description: 'Upgrade orchestration strategy for selected devices. enum: `big_bang`, `canary`, `rrm`, `serial`.'
version:
type: string
description: Specific version / stable, default is to use the latest available version
examples:
- 3.1.5
description: Site device upgrade request
upgrade_site_devices_counts:
title: upgrade_site_devices_counts
type: object
properties:
download_requested:
type: integer
description: Count of devices which cloud has requested to download firmware
contentEncoding: int32
downloaded:
type: integer
description: Count of ap's which have the firmware downloaded
contentEncoding: int32
failed:
type: integer
description: Count of devices which have failed to upgrade
contentEncoding: int32
reboot_in_progress:
type: integer
description: Count of devices which are rebooting
contentEncoding: int32
rebooted:
type: integer
description: Count of devices which have rebooted successfully
contentEncoding: int32
scheduled:
type: integer
description: Count of devices which cloud has scheduled an upgrade for
contentEncoding: int32
skipped:
type: integer
description: Count of devices which skipped upgrade since requested version was same as running version. Use force to always upgrade
contentEncoding: int32
total:
type: integer
description: Count of devices part of this upgrade
contentEncoding: int32
upgraded:
type: integer
description: Count of devices which have upgraded successfully
contentEncoding: int32
description: Device counts grouped by status for a site upgrade job
use_auto_ap_values:
title: use_auto_ap_values
type: object
properties:
accept:
type: boolean
description: Whether to accept cached values; false rejects them for the selected APs
default: false
for:
allOf:
- $ref: '#/components/schemas/use_auto_ap_values_for2'
- description: 'Localization value type to accept or reject. enum: `orientation`, `placement`.'
macs:
type: array
items:
type: string
description: AP MAC addresses whose cached values are accepted or rejected
description: Request to accept or reject cached AP placement or orientation values on a map
use_auto_ap_values_for:
title: use_auto_ap_values_for
enum:
- orientation
- placement
type: string
description: 'The selector to choose auto placement or auto orientation. enum: `orientation`, `placement`'
user_apitoken:
title: user_apitoken
type: object
properties:
created_time:
type: number
description: Time when this user API token was created, in epoch seconds
readOnly: true
id:
type: string
description: Unique identifier for this user API token
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
key:
type: string
description: Secret API token value returned for this token
readOnly: true
examples:
- 1qkb...QQCL
last_used:
type:
- integer
- 'null'
description: Time when this user API token was last used, in epoch seconds; null if never used
contentEncoding: int32
readOnly: true
examples:
- 1690115110
name:
type: string
description: Display label for this user API token
examples:
- org_token_xyz
description: User API token metadata
user_mac:
title: user_mac
required:
- mac
type: object
properties:
id:
type: string
description: Unique identifier for this user MAC entry
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
labels:
type: array
items:
type: string
description: Applied labels for this user MAC entry
examples:
- - byod
- flr1
mac:
type: string
description: Client MAC address for this entry. Only non-local-admin MAC addresses are accepted
examples:
- 5684dae9ac8b
name:
type: string
description: Display name for this user MAC entry
examples:
- Printer2
notes:
type: string
description: Free-form notes about this user MAC entry
examples:
- MAC address refers to Canon printers
radius_group:
type: string
description: RADIUS group associated with this user MAC entry
examples:
- VIP
site_ids:
type: array
items:
type: string
contentEncoding: uuid
description: Optional list of site IDs this user MAC entry is scoped to
vlan:
type: string
description: Network VLAN value associated with this user MAC entry
examples:
- '30'
description: Organization user MAC entry
user_mac_import:
title: user_mac_import
type: object
properties:
added:
type: array
items:
type: string
description: MAC addresses added by the import
examples:
- - 921b638445cd
detail:
type: string
description: Status message returned for asynchronous imports
errors:
type: array
items:
type: string
description: Import error messages for user MAC entries
examples:
- - 921b638445ce - mac invalid
- 921b638445cf - mac already provided
updated:
type: array
items:
type: string
description: MAC addresses updated by the import
examples:
- - 721b638445ef
- 721b638445ee
description: Result of importing user MAC entries
user_macs_count:
title: user_macs_count
type: object
properties:
end:
type: integer
description: Query end timestamp for user MAC counts
contentEncoding: int32
limit:
type: integer
description: Maximum number of distinct count results to return
contentEncoding: int32
results:
type: array
items:
$ref: '#/components/schemas/user_mac'
description: User MAC entries returned by the count query
start:
type: integer
description: Query start timestamp for user MAC counts
contentEncoding: int32
total:
type: integer
description: Overall number of user MAC count results
contentEncoding: int32
description: User MACs count response
user_macs_update:
title: user_macs_update
type: object
properties:
detail:
type: string
description: Status message returned for asynchronous batch updates
errors:
uniqueItems: true
type: array
items:
type: string
description: Update errors reported for user MAC entries
updated:
type: array
items:
type: string
contentEncoding: uuid
description: User MAC entry IDs updated by the request
description: Result of a bulk user MAC update
usermacs_id:
title: usermacs_id
type: object
properties:
usermac_ids:
type: array
items:
type: string
contentEncoding: uuid
description: User MAC entry IDs to delete
description: Request body for deleting multiple user MAC entries
username_password:
title: username_password
type: object
properties:
password:
type: string
description: Credential password used for the validation attempt
contentEncoding: password
username:
type: string
description: Credential username used for the validation attempt
description: Credential payload used to validate an identity provider login
utils_bounce_port:
title: utils_bounce_port
type: object
properties:
ports:
type: array
items:
type: string
description: Device ports to bounce
description: Request to bounce one or more device ports
utils_cable_tests:
title: utils_cable_tests
required:
- port
type: object
properties:
port:
type: string
description: The port to run the cable test
description: Request body for running a switch cable test on a port
utils_clear_arp:
title: utils_clear_arp
type: object
properties:
ip:
type: string
description: The IP address for which to clear an ARP entry. port_id must be specified.
examples:
- 10.1.1.1
node:
allOf:
- $ref: '#/components/schemas/ha_cluster_node_enum3'
- description: 'HA cluster node on which to clear ARP entries. enum: `node0`, `node1`.'
port_id:
type: string
description: The device interface on which to clear the ARP cache.
examples:
- wan
vlan:
type: integer
description: The VLAN on which to clear the ARP cache. port_id must be specified.
contentEncoding: int32
examples:
- 1000
vrf:
type: string
description: The vrf for which to clear an ARP entry. applicable for switch.
examples:
- guest
description: Request to clear ARP entries on a device
utils_clear_bgp:
title: utils_clear_bgp
required:
- neighbor
- type
type: object
properties:
neighbor:
type: string
description: can be ip, ipv6, all
node:
allOf:
- $ref: '#/components/schemas/ha_cluster_node_enum4'
- description: 'HA cluster node on which to clear BGP sessions. enum: `node0`, `node1`.'
type:
allOf:
- $ref: '#/components/schemas/utils_clear_bgp_type2'
- description: 'BGP clear operation type to run. enum: `hard`, `in`, `out`, `soft`.'
vrf:
type: string
description: Routing instance or VRF containing the BGP session
description: Request to clear BGP sessions on a device
utils_clear_bgp_type:
title: utils_clear_bgp_type
enum:
- hard
- in
- out
- soft
type: string
description: 'enum: `hard`, `in`, `out`, `soft`'
utils_clear_bpdu:
title: utils_clear_bpdu
type: object
properties:
ports:
type: array
items:
type: string
description: Switch ports on which to clear detected BPDU errors
description: Request to clear detected BPDU errors on switch ports
utils_clear_macs:
title: utils_clear_macs
type: object
properties:
ports:
type: array
items:
type: string
description: Switch ports on which to clear learned MAC addresses
description: Request to clear learned MAC addresses from device ports
utils_clear_session:
title: utils_clear_session
type: object
properties:
node:
allOf:
- $ref: '#/components/schemas/ha_cluster_node_enum5'
- description: 'HA cluster node on which to clear sessions. enum: `node0`, `node1`.'
service_name:
type: string
description: Service name, only supported in SSR
examples:
- internet-wan_and_lte
session_ids:
type: array
items:
type: string
contentEncoding: uuid
description: Session identifiers to clear
examples:
- - 88776655-0123-4567-890a-112233445566
description: To use five tuples to lookup the session to be cleared, all must be provided
utils_devices_restart:
title: utils_devices_restart
type: object
properties:
member:
maximum: 9
minimum: 0
type: integer
description: Virtual Chassis member number to restart
contentEncoding: int32
node:
allOf:
- $ref: '#/components/schemas/utils_devices_restart_node2'
- description: 'SRX or SSR node to restart. enum: `node0`, `node1`.'
description: Request to restart a device or device node
utils_devices_restart_multi:
title: utils_devices_restart_multi
required:
- device_ids
type: object
properties:
device_ids:
type: array
items:
type: string
contentEncoding: uuid
description: Identifiers of devices to restart
node:
type: string
description: 'Only for SSR: if node is not present, both nodes are restarted. For other devices: node should not be present'
description: Request to restart multiple devices
utils_devices_restart_node:
title: utils_devices_restart_node
enum:
- node0
- node1
type: string
description: 'only for SRX/SSR: if node is not present, both nodes are restarted. For other devices: node should not be present. enum: `node0`, `node1`'
utils_mac_table:
title: utils_mac_table
type: object
properties:
mac_address:
type: string
description: Client MAC address filter for the MAC table lookup
examples:
- f8c1165c6400
port_id:
type: string
description: Interface identifier filter for the MAC table lookup
examples:
- ge-0/0/0.0
vlan_id:
type: string
description: VLAN identifier filter for the MAC table lookup
examples:
- ge-0/0/0.0
description: MAC table lookup filters
utils_monitor_traffic:
title: utils_monitor_traffic
type: object
properties:
port:
type: string
description: Interface name to monitor; omit this field to monitor all ports
examples:
- ge-0/0/1
description: Request body for monitoring traffic on one port or all ports
utils_ping:
title: utils_ping
required:
- host
type: object
properties:
count:
type: integer
description: Number of echo requests to send
contentEncoding: int32
default: 10
egress_interface:
type: string
description: Interface through which ping packets should egress
host:
type: string
description: Destination IP address, IPv6 address, or hostname to ping
examples:
- 1.1.1.1
node:
allOf:
- $ref: '#/components/schemas/ha_cluster_node_enum6'
- description: 'HA cluster node from which to send ping packets. enum: `node0`, `node1`.'
size:
maximum: 65535
minimum: 56
type: integer
description: ICMP payload size, in bytes
contentEncoding: int32
default: 56
use_ipv6:
type: boolean
description: applicable when host is hostname
default: false
vrf:
type: string
description: Routing instance or VRF through which ping packets are sent
description: Request body for running a ping utility command
utils_release_dhcp:
title: utils_release_dhcp
required:
- port_id
type: object
properties:
node:
allOf:
- $ref: '#/components/schemas/ha_cluster_node_enum7'
- description: 'HA cluster node on which to release the DHCP lease. enum: `node0`, `node1`.'
port_id:
minLength: 1
type: string
description: Network interface whose current DHCP lease should be released
examples:
- ge-0/0/1.10
description: Request to release the DHCP lease on a device interface
utils_release_dhcp_leases:
title: utils_release_dhcp_leases
required:
- port_id
type: object
properties:
macs:
type: array
items:
type: string
description: Client MAC addresses whose DHCP leases should be released
examples:
- - 90ec77aabbcc
- 90ec77aabbdd
network:
type: string
description: DHCP network containing the leases to release
examples:
- guest
node:
allOf:
- $ref: '#/components/schemas/ha_cluster_node_enum8'
- description: 'HA cluster node on which to release DHCP leases. enum: `node0`, `node1`.'
port_id:
minLength: 1
type: string
description: Network interface containing the DHCP leases to release
examples:
- ge-0/0/1.10
description: "Note: \n * valid combinations for Junos: \n * `port_id` \n * `macs` + `network`\n * valid combinations for SSR: \n * `port_id` \n * `macs` + `network`\n * `port_id` + `network`\n * `network`\n * if network or port_id is specified and macs is empty, it means all clients under network or port_id"
utils_reset_radio_config:
title: utils_reset_radio_config
required:
- bands
type: object
properties:
bands:
type: array
items:
type: string
description: Radio bands to reset to RRM management
force:
type: boolean
description: Whether to reset radios that are currently disabled; default `false` honors radios intentionally disabled by the user
default: false
description: Request to reset AP radio settings to RRM-managed values
utils_rrm_optimize:
title: utils_rrm_optimize
required:
- bands
type: object
properties:
bands:
type: array
items:
type: string
description: Radio bands to include in the RRM optimization
macs:
type: array
items:
type: string
description: AP MAC addresses to target for optimization; omitted or empty targets all APs
txpower_only:
type: boolean
description: When true, adjust only transmit power so clients are not disconnected
default: false
description: Request to optimize RRM for selected AP radio bands
utils_send_ble_beacon:
title: utils_send_ble_beacon
type: object
properties:
beacon_frame:
type: string
description: Raw BLE beacon frame payload to transmit
examples:
- 68b329da9893e34099c7d8ad5cb9c940
beacon_freq:
type: integer
description: Transmission interval for the arbitrary BLE beacon frame
contentEncoding: int32
examples:
- 100
duration:
maximum: 60
minimum: 1
type: integer
description: Number of seconds to continue sending the BLE beacon frame
contentEncoding: int32
examples:
- 10
macs:
type: array
items:
type: string
description: AP MAC addresses of devices that should transmit the BLE beacon
examples:
- - 5c5b35584a6f
- 5c5b350ea3b3
map_ids:
type: array
items:
type: string
description: Identifiers of maps whose APs should transmit the BLE beacon
examples:
- - 845a23bf-bed9-e43c-4c86-6fa474be7ae5
description: Request to transmit an arbitrary BLE beacon frame from selected APs
utils_send_support_logs:
title: utils_send_support_logs
type: object
properties:
info:
allOf:
- $ref: '#/components/schemas/utils_send_support_logs_info2'
- description: 'Support file bundle type to upload. enum: `code-dumps`, `full`, `messages`, `outbound-ssh`, `process`, `var-logs`.'
node:
type: string
description: 'Optional for SSR: if node is not present, both nodes support files are uploaded'
num_messages_files:
maximum: 10
minimum: 1
type: integer
description: Number of most recent messages files to upload when `info`==`messages`
contentEncoding: int32
default: 1
description: Request to upload support files from a device
utils_send_support_logs_info:
title: utils_send_support_logs_info
enum:
- code-dumps
- full
- messages
- outbound-ssh
- process
- var-logs
type: string
description: "Optional, enum: \n * `code-dumps`: Upload all core dump files, if any found. Uploads for all members of VC on switches.\n * `full`: Upload 1 file with output of `request support information`, 1 file that concatenates all `/var/log/outbound-ssh.log*` files, all core dump files, the 5 most recent `/var/log/messages*` files, and Mist agent logs\n * `messages`: Upload 1 to 10 `/var/log/messages*` files\n * `outbound-ssh`: Upload 1 file that concatenates all `/var/log/outbound-ssh.log*` files\n * `process`: Upload 1 file with output of show `system processes extensive``\n * `var-logs`: Upload all non-empty files in the `/var/log/` directory"
utils_service_ping:
title: utils_service_ping
required:
- host
- service
type: object
properties:
count:
type: integer
description: Number of ICMP echo requests to send for the service ping
contentEncoding: int32
default: 10
host:
type: string
description: Destination IPv4 address for the service ping
contentEncoding: ipv4
node:
allOf:
- $ref: '#/components/schemas/ha_cluster_node_enum9'
- description: 'HA cluster node from which to send the service ping. enum: `node0`, `node1`.'
service:
type: string
description: Ping packet takes the same path as the service
size:
maximum: 65535
minimum: 56
type: integer
description: ICMP payload size, in bytes
contentEncoding: int32
default: 56
tenant:
type: string
description: Routing tenant context in which the packet is sent
description: Service ping request for SSR devices
utils_show_arp:
title: utils_show_arp
type: object
properties:
duration:
maximum: 300
minimum: 0
type: integer
description: Refresh duration in seconds; set only when `interval` is nonzero
contentEncoding: int32
default: 0
interval:
maximum: 10
minimum: 0
type: integer
description: Refresh interval in seconds for repeated command output
contentEncoding: int32
default: 0
ip:
type: string
description: Address filter for the ARP table lookup
examples:
- 192.168.30.7
node:
allOf:
- $ref: '#/components/schemas/ha_cluster_node_enum10'
- description: 'HA cluster node to run the command on, required for Gateways. enum: `node0`, `node1`.'
port_id:
type: string
description: Device port identifier filter for the ARP table lookup
examples:
- ge-0/0/0.0
vrf:
type: string
description: Routing instance or VRF filter for the ARP table lookup
examples:
- guest
description: ARP table lookup request for device command output
utils_show_bgp_summary:
title: utils_show_bgp_summary
type: object
properties:
node:
allOf:
- $ref: '#/components/schemas/ha_cluster_node_enum11'
- description: 'HA cluster node on which to show the BGP summary. enum: `node0`, `node1`.'
description: BGP summary command request
utils_show_dhcp_leases:
title: utils_show_dhcp_leases
required:
- network
type: object
properties:
network:
type: string
description: DHCP network for the leases, returns full table if not specified
examples:
- guest
node:
allOf:
- $ref: '#/components/schemas/ha_cluster_node_enum12'
- description: 'HA cluster node on which to show DHCP leases. enum: `node0`, `node1`.'
description: DHCP leases command request
utils_show_dot1x:
title: utils_show_dot1x
type: object
properties:
duration:
maximum: 300
minimum: 0
type: integer
description: Refresh duration in seconds; set only when `interval` is nonzero
contentEncoding: int32
default: 0
interval:
maximum: 10
minimum: 0
type: integer
description: Refresh interval in seconds for repeated command output
contentEncoding: int32
default: 0
port_id:
type: string
description: Device port identifier filter for the 802.1X table lookup
examples:
- ge-0/0/0.0
description: 802.1X table lookup request for device command output
utils_show_evpn_database:
title: utils_show_evpn_database
type: object
properties:
duration:
maximum: 300
minimum: 0
type: integer
description: Refresh duration in seconds; set only when `interval` is nonzero
contentEncoding: int32
default: 0
interval:
maximum: 10
minimum: 0
type: integer
description: Refresh interval in seconds for repeated command output
contentEncoding: int32
default: 0
mac:
type: string
description: Client MAC address filter for the EVPN database lookup
examples:
- f8c1165c6400
port_id:
type: string
description: Interface identifier filter for the EVPN database lookup
examples:
- ge-0/0/0.0
description: EVPN database lookup request for device command output
utils_show_forwarding_table:
title: utils_show_forwarding_table
type: object
properties:
node:
allOf:
- $ref: '#/components/schemas/ha_cluster_node_enum13'
- description: 'HA cluster node on which to show the forwarding table. enum: `node0`, `node1`.'
prefix:
type: string
description: IPv4 or IPv6 prefix filter for forwarding table entries
examples:
- 3.1.1.0/24
service_ip:
type: string
description: Only supported with SSR
examples:
- 3.1.1.10
service_name:
type: string
description: Only supported with SSR
examples:
- internet-wan_and_lte
service_port:
type: integer
description: Only supported with SSR
contentEncoding: int32
examples:
- 32768
service_protocol:
type: string
description: Only supported with SSR
examples:
- udp
service_tenant:
type: string
description: Only supported with SSR
examples:
- branch1-wifi-mgt
vrf:
type: string
description: Routing instance or VRF filter for forwarding table entries
examples:
- guest
description: Forwarding table lookup request for device command output
utils_show_ospf_database:
title: utils_show_ospf_database
type: object
properties:
node:
allOf:
- $ref: '#/components/schemas/ha_cluster_node_enum14'
- description: 'HA cluster node on which to show the OSPF database. enum: `node0`, `node1`.'
self_originate:
type: boolean
description: Whether to show only self-originated OSPF database entries
default: false
vrf:
type: string
description: Routing instance or VRF filter for OSPF database output
examples:
- lan
description: OSPF database command request for SSR and SRX devices
utils_show_ospf_interfaces:
title: utils_show_ospf_interfaces
type: object
properties:
node:
allOf:
- $ref: '#/components/schemas/ha_cluster_node_enum15'
- description: 'HA cluster node on which to show OSPF interfaces. enum: `node0`, `node1`.'
port_id:
type: string
description: Network interface filter for OSPF interface output
examples:
- ge-0/0/3
vrf:
type: string
description: Routing instance or VRF filter for OSPF interface output
examples:
- lan
description: OSPF interfaces command request for SSR and SRX devices
utils_show_ospf_neighbors:
title: utils_show_ospf_neighbors
type: object
properties:
neighbor:
type: string
description: OSPF neighbor IP address filter
examples:
- 10.1.1.1
node:
allOf:
- $ref: '#/components/schemas/ha_cluster_node_enum16'
- description: 'HA cluster node on which to show OSPF neighbors. enum: `node0`, `node1`.'
port_id:
type: string
description: Network interface filter for OSPF neighbor output
examples:
- ge-0/0/3
vrf:
type: string
description: Routing instance or VRF filter for OSPF neighbor output
examples:
- lan
description: OSPF neighbors command request for SSR and SRX devices
utils_show_ospf_summary:
title: utils_show_ospf_summary
type: object
properties:
node:
allOf:
- $ref: '#/components/schemas/ha_cluster_node_enum17'
- description: 'HA cluster node on which to show the OSPF summary. enum: `node0`, `node1`.'
vrf:
type: string
description: Routing instance or VRF filter for OSPF summary output
examples:
- lan
description: OSPF summary command request for SSR and SRX devices
utils_show_route:
title: utils_show_route
type: object
properties:
duration:
maximum: 300
minimum: 0
type: integer
description: Refresh duration in seconds; set only when `interval` is nonzero
contentEncoding: int32
default: 0
interval:
maximum: 10
minimum: 0
type: integer
description: Refresh interval in seconds for repeated command output
contentEncoding: int32
default: 0
neighbor:
type: string
description: BGP neighbor IP address filter for received or advertised routes
examples:
- 192.168.4.1
node:
allOf:
- $ref: '#/components/schemas/ha_cluster_node1'
- description: HA cluster node on which to show routes
prefix:
type: string
description: IPv4 or IPv6 prefix filter for route entries
examples:
- 192.168.0.5/30
protocol:
allOf:
- $ref: '#/components/schemas/utils_show_route_protocol2'
- description: 'Routing protocol filter for route entries. enum: `any`, `bgp`, `direct`, `evpn`, `ospf`, `static`.'
route:
type: string
description: >-
if neighbor is specified, received / advertised; if not specified, both will be shown
* for SSR, show bgp neighbors 10.250.18.202 received-routes/advertised-routes
* for SRX and Switches, show route receive-protocol/advertise-protocol bgp 192.168.255.12
examples:
- advertised
vrf:
type: string
description: Routing instance or VRF filter for route entries
examples:
- default
description: Route table lookup request for device command output
utils_show_route_protocol:
title: utils_show_route_protocol
enum:
- any
- bgp
- direct
- evpn
- ospf
- static
type: string
description: 'enum: `any`, `bgp`, `direct`, `evpn`, `ospf`, `static`'
utils_show_service_path:
title: utils_show_service_path
type: object
properties:
node:
allOf:
- $ref: '#/components/schemas/ha_cluster_node_enum18'
- description: 'HA cluster node on which to show the service path. enum: `node0`, `node1`.'
service_name:
type: string
description: Exact service name for which to display the service path
examples:
- any
description: Service path lookup request for SSR devices
utils_show_session:
title: utils_show_session
type: object
properties:
node:
allOf:
- $ref: '#/components/schemas/ha_cluster_node_enum19'
- description: 'HA cluster node on which to show active sessions. enum: `node0`, `node1`.'
service_name:
type: string
description: The exact service name for which to display the active sessions
examples:
- any
session_id:
type: string
description: Identifier of the session to show in detail
description: Active session lookup request for device command output
utils_traceroute:
title: utils_traceroute
type: object
properties:
host:
type: string
description: Destination IP address, IPv6 address, or hostname for traceroute
network:
type: string
description: For SSR, source network from which to initiate traceroute
default: internal
node:
allOf:
- $ref: '#/components/schemas/ha_cluster_node_enum20'
- description: 'HA cluster node from which to run traceroute. enum: `node0`, `node1`.'
port:
type: integer
description: When `protocol`==`udp`, not supported in SSR. The udp port to use
contentEncoding: int32
default: 33434
protocol:
allOf:
- $ref: '#/components/schemas/utils_traceroute_protocol2'
- description: 'Transport protocol to use for traceroute. enum: `icmp`, `udp`.'
timeout:
type: integer
description: Not supported in SSR. Maximum time in seconds to wait for the response
contentEncoding: int32
default: 60
use_ipv6:
type: boolean
description: Whether to resolve hostname targets over IPv6
default: false
vrf:
type: string
description: For SRX, routing instance or VRF from which to initiate traceroute; master VRF/RI is used by default
description: Request body for running a traceroute utility command
utils_traceroute_protocol:
title: utils_traceroute_protocol
enum:
- icmp
- udp
type: string
description: 'enum: `icmp` (Only supported by AP/MxEdge), `udp`'
utils_tunterm_bounce_port:
title: utils_tunterm_bounce_port
required:
- ports
type: object
properties:
hold_time:
type: integer
description: In milli seconds, hold time between multiple port bounces
contentEncoding: int32
ports:
type: array
items:
type: string
description: TunTerm data ports to bounce
description: Request to bounce Mist Edge TunTerm data ports
utils_zeroize_fips:
title: utils_zeroize_fips
required:
- password
type: object
properties:
password:
type: string
description: Confirmation password for the FIPS zeroize operation
contentEncoding: password
description: Request body for confirming FIPS AP zeroize operations
utils_zigbee_join:
title: utils_zigbee_join
type: object
properties:
duration:
maximum: 600
minimum: 60
type: integer
description: Number of seconds to permit new Zigbee end-device joins; range is 60-600
contentEncoding: int32
default: 600
description: Request body for temporarily allowing Zigbee end-device joins
utils_zigbee_kick:
title: utils_zigbee_kick
required:
- macs
type: object
properties:
macs:
minItems: 1
type: array
items:
type: string
description: One or more Zigbee EUI-64 (8-byte) MACs. Accepts colon-separated (`00:17:7a:01:06:0c:ae:9f`) or plain hex (`00177a01060cae9f`). Must be non-empty.
examples:
- - 00177a01060cae9f
- 00177a01060caea1
description: Request body for kicking one or more Zigbee clients from an AP
var_source:
title: var_source
enum:
- deviceprofile
- site
type: string
description: 'Source level where a variable is defined. enum: `deviceprofile`, `site`'
vars_annotation:
title: vars_annotation
type: object
properties:
note:
type: string
description: User-provided note to describe what this var was created for
type:
type: string
description: >-
Used to identify where to enumerate / auto-complete the field from. Default is `generic` (plain string, no special handling).
enum: `generic`, `mxtunnel_id`
default: generic
description: Annotation for a single var, helping identify its purpose and enabling auto-complete/enumeration in UI
vbeacon:
title: vbeacon
type: object
properties:
created_time:
type: number
description: Epoch timestamp when the virtual beacon was created
readOnly: true
for_site:
type: boolean
description: Whether this virtual beacon is defined at site scope
readOnly: true
id:
type: string
description: Unique identifier of the virtual beacon
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
major:
type: integer
description: Bluetooth beacon major value used for proximity matching
contentEncoding: int32
examples:
- 1356
map_id:
type: string
description: Floorplan map identifier containing the virtual beacon
contentEncoding: uuid
examples:
- 63eda950-c6da-11e4-a628-60f81dd250cc
message:
type: string
description: Notification message displayed by the SDK application when a client is near the virtual beacon
examples:
- Welcome to Mist
minor:
type: integer
description: Bluetooth beacon minor value used for proximity matching
contentEncoding: int32
examples:
- 21
modified_time:
type: number
description: Epoch timestamp when the virtual beacon was last modified
readOnly: true
name:
type: string
description: Display name or label for the virtual beacon
examples:
- conference room
org_id:
type: string
description: Organization identifier that owns the virtual beacon
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
power:
maximum: 100
minimum: -30
type: integer
description: Required if `power_mode`==`custom`, -30 - 100, in dBm. For default power_mode, power = 4 dBm.
contentEncoding: int32
default: 4
power_mode:
allOf:
- $ref: '#/components/schemas/ble_config_power_mode2'
- description: 'Transmit power mode for the virtual beacon. enum: `custom`, `default`.'
examples:
- custom
site_id:
type: string
description: Site identifier that owns the virtual beacon
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
url:
type: string
description: Destination URL shown by the SDK application when a client is near the virtual beacon
examples:
- https://www.mist.com/any
uuid:
type: string
description: Bluetooth beacon UUID used for proximity matching
contentEncoding: uuid
examples:
- 31375aeb-b8d3-1ea6-83bf-a31eb04e1c38
wayfinding_nodename:
type: string
description: Name to be used in wayfinding_path or wayfinding_grid blob
examples:
- node1
x:
type: number
description: Horizontal pixel coordinate of the virtual beacon on the map
examples:
- 53.5
y:
type: number
description: Vertical pixel coordinate of the virtual beacon on the map
examples:
- 173.1
description: Virtual beacon configuration for SDK proximity notifications
vc_port:
title: vc_port
type: object
properties:
mode:
allOf:
- $ref: '#/components/schemas/vc_port_mode2'
- description: 'Virtual Chassis port mode to apply. enum: `network`, `vcp-higig`, `vcp-hgoe`.'
description: Request to change the Virtual Chassis port mode on a switch
vc_port_mode:
title: vc_port_mode
enum:
- network
- vcp-higig
- vcp-hgoe
type: string
description: 'enum: `network`, `vcp-higig`, `vcp-hgoe`'
version_string:
title: version_string
type: object
properties:
version:
type: string
description: Target software version for the JSI device upgrade
description: JSI device upgrade target version request
virtual_chassis_config:
title: virtual_chassis_config
type: object
properties:
locating:
type: boolean
description: Whether the Virtual Chassis is currently in locate mode
readOnly: true
members:
type: array
items:
$ref: '#/components/schemas/virtual_chassis_config_member'
description: Virtual Chassis members and their expected roles and VC ports
preprovisioned:
type: boolean
description: Whether to create the Virtual Chassis in pre-provisioned mode
default: false
description: Virtual Chassis creation or configuration request
virtual_chassis_config_member:
title: virtual_chassis_config_member
required:
- mac
- vc_role
type: object
properties:
locating:
type: boolean
description: Whether this Virtual Chassis member is currently in locate mode
readOnly: true
mac:
type: string
description: Member MAC address; for FPC0 this matches the device MAC address
member_id:
type: integer
description: Member ID used for a pre-provisioned Virtual Chassis
contentEncoding: int32
vc_ports:
uniqueItems: true
type: array
items:
type: string
description: Port names to use as Virtual Chassis ports on this member
vc_role:
allOf:
- $ref: '#/components/schemas/virtual_chassis_config_member_vc_role2'
- description: 'Role of this member in the Virtual Chassis. enum: `backup`, `linecard`, `master`.'
description: Virtual Chassis member configuration
virtual_chassis_config_member_vc_role:
title: virtual_chassis_config_member_vc_role
enum:
- backup
- linecard
- master
type: string
description: 'enum: `backup`, `linecard`, `master`'
virtual_chassis_member_update:
title: virtual_chassis_member_update
type: object
properties:
mac:
type: string
description: Required if `op`==`add` or `op`==`preprovision`; MAC address of the member to add or preprovision
member:
type: integer
description: Required if `op`==`remove`; member ID to remove from the Virtual Chassis
contentEncoding: int32
member_id:
type: integer
description: Required if `op`==`preprovision`. Optional if `op`==`add`; target member ID for the Virtual Chassis member
contentEncoding: int32
vc_ports:
type: array
items:
type: string
description: Required if `op`==`add` or `op`==`preprovision`; port names to use as Virtual Chassis ports
vc_role:
allOf:
- $ref: '#/components/schemas/virtual_chassis_member_update_vc_role2'
- description: 'Required if `op`==`add` or `op`==`preprovision`; role of the member in the Virtual Chassis. enum: `backup`, `linecard`, `master`.'
description: Member update for a Virtual Chassis add, remove, or preprovision operation
virtual_chassis_member_update_vc_role:
title: virtual_chassis_member_update_vc_role
enum:
- backup
- linecard
- master
type: string
description: 'Required if `op`==`add` or `op`==`preprovision`. enum: `backup`, `linecard`, `master`'
virtual_chassis_port:
title: virtual_chassis_port
required:
- members
- op
type: object
properties:
members:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/config_vc_port_member'
description: Virtual Chassis members and ports affected by the operation
op:
allOf:
- $ref: '#/components/schemas/virtual_chassis_port_operation2'
- minLength: 1
description: 'Action to perform on the specified Virtual Chassis ports. enum: `delete`, `set`.'
description: Request to set or delete Virtual Chassis ports on members
virtual_chassis_port_operation:
title: virtual_chassis_port_operation
enum:
- delete
- set
type: string
description: 'Action to perform on the specified Virtual Chassis ports. enum: `delete`, `set`'
virtual_chassis_update:
title: virtual_chassis_update
type: object
properties:
member:
type: integer
description: Only if `op`==`renumber`; existing member ID to renumber
contentEncoding: int32
members:
type: array
items:
$ref: '#/components/schemas/virtual_chassis_member_update'
description: Member updates for add, remove, or preprovision operations
new-member:
type: integer
description: Only if `op`==`renumber`; new member ID to assign
contentEncoding: int32
op:
allOf:
- $ref: '#/components/schemas/virtual_chassis_update_op2'
- description: 'Action to perform on the Virtual Chassis. enum: `add`, `preprovision`, `remove`, `renumber`.'
remove_inventory:
type: boolean
description: Only if `op`==`preprovision`. When removing members from a pre-provisioned VC, set to `true` to delete the inventory records for removed members (e.g. for RMA). Members being removed must be in "not-present" state.
default: false
description: Virtual Chassis member update request
virtual_chassis_update_op:
title: virtual_chassis_update_op
enum:
- add
- preprovision
- remove
- renumber
type: string
description: 'enum: `add`, `preprovision`, `remove`, `renumber`'
visits_scope:
title: visits_scope
enum:
- map
- rssizone
- site
- zone
type: string
description: 'enum: `map`, `rssizone`, `site`, `zone`'
vpn:
title: vpn
required:
- name
- paths
type: object
properties:
created_time:
type: number
description: Epoch timestamp when the VPN configuration was created
readOnly: true
id:
type: string
description: Unique identifier of the VPN configuration
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
modified_time:
type: number
description: Epoch timestamp when the VPN configuration was last modified
readOnly: true
name:
minLength: 1
type: string
description: Display name of the VPN configuration
org_id:
type: string
description: Organization that owns the VPN configuration
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
path_selection:
allOf:
- $ref: '#/components/schemas/vpn_path_selection2'
- description: Path selection settings used when `type`==`hub_spoke`
paths:
type: object
additionalProperties:
$ref: '#/components/schemas/vpn_path'
description: VPN path definitions keyed by VPN name for `hub_spoke` mode or interface name for `mesh` mode
type:
allOf:
- $ref: '#/components/schemas/vpn_mode2'
- description: 'VPN topology mode for this configuration. enum: `hub_spoke`, `mesh`.'
description: Organization VPN overlay configuration
vpn_mode:
title: vpn_mode
enum:
- hub_spoke
- mesh
type: string
description: 'VPN topology mode for this configuration. enum: `hub_spoke`, `mesh`'
vpn_path:
title: vpn_path
type: object
properties:
bfd_profile:
allOf:
- $ref: '#/components/schemas/vpn_path_bfd_profile2'
- description: 'BFD profile used for this VPN path. enum: `broadband`, `lte`.'
bfd_use_tunnel_mode:
type: boolean
description: If `type`==`mesh` and for SSR only, whether to use tunnel mode
default: false
ip:
type: string
description: Source IP address for this VPN path, if different from the WAN port IP
peer_paths:
type: object
additionalProperties:
$ref: '#/components/schemas/vpn_path_peer_paths_peer'
description: Peer path preferences used when `type`==`mesh`
pod:
maximum: 128
minimum: 1
type: integer
description: Grouping index used to place this VPN path into a pod
contentEncoding: int32
default: 1
examples:
- 2
traffic_shaping:
allOf:
- $ref: '#/components/schemas/vpn_path_traffic_shaping2'
- description: Traffic shaping settings applied to this VPN path
description: VPN path settings used by an organization VPN
vpn_path_bfd_profile:
title: vpn_path_bfd_profile
enum:
- broadband
- lte
type: string
description: 'BFD profile used for this VPN path. enum: `broadband`, `lte`'
vpn_path_peer_paths_peer:
title: vpn_path_peer_paths_peer
type: object
properties:
preference:
type: integer
description: Lower numeric value makes this outgoing WAN path more preferred
contentEncoding: int32
description: Peer path preference settings for mesh VPN routing
vpn_path_selection:
title: vpn_path_selection
type: object
properties:
strategy:
allOf:
- $ref: '#/components/schemas/vpn_path_selection_strategy2'
- description: 'Path selection strategy for a hub-and-spoke VPN. enum: `disabled`, `simple`, `manual`.'
description: Only if `type`==`hub_spoke`; path selection behavior for VPN paths
vpn_path_selection_strategy:
title: vpn_path_selection_strategy
enum:
- disabled
- simple
- manual
type: string
description: 'enum: `disabled`, `simple`, `manual`'
vpn_path_traffic_shaping:
title: vpn_path_traffic_shaping
type: object
properties:
class_percentage:
maxItems: 4
minItems: 4
type: array
items:
type: integer
contentEncoding: int32
description: Bandwidth percentages for high, medium, low, and best-effort traffic classes
default:
- 80
- 10
- 9
- 1
enabled:
type: boolean
description: Whether traffic shaping is enabled for this VPN path
max_tx_kbps:
type:
- integer
- 'null'
description: Maximum transmit rate for this VPN path, in Kbps; `null` means no explicit limit
contentEncoding: int32
description: Traffic shaping settings for a VPN path
vpn_peer_stat:
title: vpn_peer_stat
type: object
properties:
is_active:
type: boolean
description: Whether this VPN peer path is the active redundant path
jitter:
minimum: 0
type: number
description: Last sampled VPN peer jitter, in milliseconds
last_seen:
type:
- number
- 'null'
description: Time when this VPN peer was last observed, in epoch seconds
readOnly: true
examples:
- 1470417522
latency:
minimum: 0
type: number
description: Last sampled VPN peer latency, in milliseconds
loss:
maximum: 100
minimum: 0
type: number
description: Packet loss in percentage
mac:
minLength: 1
type: string
description: Local router MAC address for the VPN link
mos:
maximum: 5
minimum: 0
type: number
description: Mean Opinion Score, a measure of the quality of the VPN link
mtu:
type: integer
description: Maximum transmission unit for the VPN peer path, in bytes
contentEncoding: int32
org_id:
type: string
description: Organization identifier for the VPN peer statistic
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
peer_mac:
minLength: 1
type: string
description: Peer router MAC address for the VPN link
peer_port_id:
minLength: 1
type: string
description: Peer router interface identifier for the VPN link
peer_router_name:
minLength: 1
type: string
description: Peer router name reported for the VPN link
peer_site_id:
type: string
description: Site identifier for the peer side of the VPN link
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
port_id:
minLength: 1
type: string
description: Local router interface identifier for the VPN link
router_name:
minLength: 1
type: string
description: Local router name reported for the VPN link
site_id:
type: string
description: Site identifier for the local side of the VPN link
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
type:
minLength: 1
type: string
description: VPN implementation type for the peer, such as `ipsec` for SRX or `svr` for SSR
up:
type: boolean
description: Whether the VPN peer is currently up
uptime:
type: integer
description: Gateway-reported VPN peer uptime value, in seconds
contentEncoding: int32
description: VPN peer path statistics returned by organization VPN peer searches
vpn_peer_stat_search:
title: vpn_peer_stat_search
required:
- end
- limit
- results
- start
- total
type: object
properties:
end:
type: number
description: Search window end timestamp, in epoch seconds
limit:
type: integer
description: Maximum number of VPN peer statistics returned
contentEncoding: int32
next:
type: string
description: URL for the next page of VPN peer statistics, when more results are available
results:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/vpn_peer_stat'
description: VPN peer statistic rows returned by the search
start:
type: number
description: Search window start timestamp, in epoch seconds
total:
type: integer
description: Number of VPN peer statistics matching the search
contentEncoding: int32
description: Search response containing VPN peer path statistics
vpn_type:
title: vpn_type
enum:
- ipsec
- svr
type: string
description: 'VPN type for tunnel or peer configuration. enum: `ipsec`, `svr`'
vrf_config:
title: vrf_config
type: object
properties:
enabled:
type: boolean
description: Whether to enable VRF (when supported on the device)
description: VRF enablement settings applied when supported on the device
vrf_extra_route:
title: vrf_extra_route
type: object
properties:
via:
type: string
description: IPv4 next-hop address for this VRF extra route
contentEncoding: ipv4
description: Additional IPv4 static route for a VRF instance
vrf_extra_route6:
title: vrf_extra_route6
type: object
properties:
via:
type: string
description: IPv6 next-hop address for this VRF extra route
contentEncoding: ipv6
description: Additional IPv6 static route for a VRF instance
vrrp_config:
title: vrrp_config
type: object
properties:
enabled:
type: boolean
description: Whether VRRP configuration is enabled
groups:
type: object
additionalProperties:
$ref: '#/components/schemas/vrrp_config_group'
description: VRRP groups keyed by group name
description: Junos VRRP configuration applied to a switch or switch profile
vrrp_config_group:
title: vrrp_config_group
type: object
properties:
preempt:
type: boolean
description: If `true`, allow preemption (a backup router can preempt a primary router)
default: false
priority:
type: integer
description: VRRP priority for this router in the group
contentEncoding: int32
description: VRRP group behavior settings
vrrp_group_auth_type:
title: vrrp_group_auth_type
enum:
- md5
- simple
type: string
description: 'Authentication method used by the VRRP group. enum: `md5`, `simple`'
examples:
- md5
vrrp_group_network:
title: vrrp_group_network
type: object
properties:
ip:
type: string
description: Virtual IP address used by the VRRP group on this network
description: Virtual IP assignment for a VRRP network
vs_instance_property:
title: vs_instance_property
type: object
properties:
networks:
type: array
items:
type: string
description: List of network names included in this virtual-switch instance
description: EX9200 virtual-switch instance settings
wan_extra_routes:
title: wan_extra_routes
type: object
properties:
via:
type: string
description: IPv4 next-hop address for this WAN extra route
contentEncoding: ipv4
description: Additional IPv4 route for a WAN interface
wan_extra_routes6:
title: wan_extra_routes6
type: object
properties:
via:
type: string
description: IPv6 next-hop address for this WAN extra route
contentEncoding: ipv6
description: Additional IPv6 route for a WAN interface
wan_tunnel_protocol:
title: wan_tunnel_protocol
enum:
- gre
- ipsec
type: string
description: 'Tunnel protocol used for the connection. enum: `gre`, `ipsec`'
wan_usages_count_distinct:
title: wan_usages_count_distinct
enum:
- mac
- path_type
- peer_mac
- peer_port_id
- policy
- port_id
- tenant
type: string
description: 'enum: `mac`, `path_type`, `peer_mac`, `peer_port_id`, `policy`, `port_id`, `tenant`'
webhook:
title: webhook
type: object
properties:
assetfilter_ids:
type: array
items:
type: string
contentEncoding: uuid
description: Asset filter identifiers used to restrict `asset-raw-rssi` webhook events
created_time:
type: number
description: Epoch timestamp when the webhook was created
readOnly: true
default_action:
allOf:
- $ref: '#/components/schemas/webhook_action3'
- description: 'Default action applied when none of the `rules` match the incoming event. enum: `permit`, `block`.'
enabled:
type: boolean
description: Whether webhook is enabled
default: true
for_site:
type: boolean
description: Whether this webhook is scoped to a site rather than the organization
readOnly: true
headers:
type:
- object
- 'null'
additionalProperties:
type: string
description: If `type`=`http-post`, additional custom HTTP headers to add. The headers name and value must be string, total bytes of headers name and value must be less than 1000
examples:
- x-custom-1: your_custom_header_value1
x-custom-2: your_custom_header_value2
id:
type: string
description: Unique identifier of the webhook
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
modified_time:
type: number
description: Epoch timestamp when the webhook was last modified
readOnly: true
name:
type:
- string
- 'null'
description: Display name of the webhook
oauth2_client_id:
type: string
description: Required when `oauth2_grant_type`==`client_credentials`; OAuth2 client identifier used to request an access token
oauth2_client_secret:
type: string
description: Required when `oauth2_grant_type`==`client_credentials`; OAuth2 client secret used to request an access token
contentEncoding: password
oauth2_grant_type:
allOf:
- $ref: '#/components/schemas/webhook_oauth2_grant_type2'
- description: 'OAuth2 grant type used when `type`==`oauth2`. enum: `client_credentials`, `password`.'
oauth2_password:
type: string
description: Required when `oauth2_grant_type`==`password`; password used for the OAuth2 token request
contentEncoding: password
oauth2_scopes:
type: array
items:
type: string
description: OAuth2 scopes included in the token request when `type`==`oauth2`
oauth2_token_url:
type: string
description: Required when `type`==`oauth2`; token endpoint URL used to obtain the OAuth2 access token
oauth2_username:
type: string
description: Required when `oauth2_grant_type`==`password`; username used for the OAuth2 token request
org_id:
type: string
description: Organization that owns the webhook
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
rules:
type: array
items:
$ref: '#/components/schemas/webhook_rule'
description: Optional filtering rules to override `topics`. Each rule permits or blocks events for a topic, optionally based on event payload matching criteria
secret:
type:
- string
- 'null'
description: "Only if `type`=`http-post` \n\nwhen `secret` is provided, two HTTP headers will be added: \n * X-Mist-Signature-v2: HMAC_SHA256(secret, body)\n * X-Mist-Signature: HMAC_SHA1(secret, body)"
single_event_per_message:
type: boolean
description: Some solutions may not be able to parse multiple events from a single message (e.g. IBM Qradar, DSM). When set to `true`, only a single event will be sent per message. this feature is only available on certain topics (see [List Webhook Topics]($e/Constants%20Definitions/listWebhookTopics))
default: false
site_id:
type: string
description: Site associated with this webhook when it is site-scoped
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
splunk_token:
type:
- string
- 'null'
description: Required if `type`=`splunk`. If splunk_token is not defined for a type Splunk webhook, it will not send, regardless if the webhook receiver is configured to accept it.
topics:
type: array
items:
type: string
description: Event topics delivered by this webhook
type:
allOf:
- $ref: '#/components/schemas/webhook_type2'
- description: 'Delivery mechanism used by this webhook. enum: `aws-sns`, `google-pubsub`, `http-post`, `oauth2`, `splunk`.'
url:
type: string
description: Destination URL that receives webhook deliveries
verify_cert:
type: boolean
description: When url uses HTTPS, whether to verify the certificate
default: true
description: Webhook configuration for delivering selected Mist events to an external destination
webhook_action:
title: webhook_action
enum:
- permit
- block
type: string
description: 'Webhook filtering action. enum: `permit`, `block`'
webhook_alarm_event:
title: webhook_alarm_event
required:
- id
- org_id
- site_id
- timestamp
- type
type: object
properties:
aps:
type: array
items:
type: string
description: Representative AP MAC addresses related to this alarm event
readOnly: true
bssids:
type: array
items:
type: string
description: Representative BSSIDs related to this alarm event
readOnly: true
count:
type: integer
description: If present, number of events of this type that occurred in the current interval; defaults to 1
contentEncoding: int32
readOnly: true
event_id:
type: string
description: Unique identifier for this alarm webhook event
contentEncoding: uuid
readOnly: true
for_site:
type: boolean
description: Whether this alarm event is scoped to a site rather than only to the organization
readOnly: true
id:
type: string
description: Unique identifier of the alarm associated with this event
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
last_seen:
type:
- number
- 'null'
description: Time when the most recent incident in the alarm window was seen, in epoch seconds
readOnly: true
examples:
- 1470417522
node:
allOf:
- $ref: '#/components/schemas/ha_cluster_node_enum21'
- description: 'HA cluster node associated with this alarm event when applicable. enum: `node0`, `node1`.'
org_id:
type: string
description: Organization associated with this alarm event
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
site_id:
type: string
description: Site associated with this alarm event
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
ssids:
type: array
items:
type: string
description: Representative wireless SSIDs related to this alarm event
readOnly: true
timestamp:
type: number
description: Time when this alarm event was raised, in epoch seconds
readOnly: true
type:
type: string
description: Alarm type key for this event
readOnly: true
update:
type: boolean
description: Whether this payload updates an alarm event that was sent earlier; defaults to false
readOnly: true
description: Alarm event delivered inside an `alarms` webhook payload
webhook_alarms:
title: webhook_alarms
required:
- events
- topic
type: object
properties:
events:
minItems: 1
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/webhook_alarm_event'
description: Alarm events included in this webhook delivery
topic:
const: alarms
type: string
description: 'Webhook topic name for alarm event deliveries. enum: `alarms`.'
description: >-
Sample of the `alarms` webhook payload.
**N.B.**: Fields like `aps`, `bssids`, `ssids` are event specific. They are relevant to this event type ( rogue-ap-detected). For a different event type, different fields may be sent. These don’t contain all affected entities and are representative samples of entities (capped at 10). For marvis action related events, we expose `details` to include more event specific details.
Events specific fields for other alarm event type can be found with API [List Alarm Definitions#]($e/Constants%20Events/listAlarmDefinitions), under "fields" array of /alarm_defs response object.
webhook_alarms_topic:
title: webhook_alarms_topic
const: alarms
type: string
description: 'Webhook topic name for alarm event deliveries. enum: `alarms`'
webhook_asset_raw_rssi:
title: webhook_asset_raw_rssi
required:
- events
- topic
type: object
properties:
events:
minItems: 1
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/webhook_asset_raw_rssi_event'
description: Raw RSSI event records included in this webhook delivery
topic:
const: asset-raw-rssi
type: string
description: 'Webhook topic name for asset raw RSSI deliveries. enum: `asset-raw-rssi`.'
description: "Sample of the `asset-raw-rssi` webhook payload.\n\n\nThis webhook topic provides raw data from packets emitted by named and filtered assets.\n\n\nRaw data webhooks are a special subset of webhooks that provide insight into raw data packets emitted by a client,\nidentified by their advertising MAC address (assets, discovered ble, connected wifi, unconnected wifi). \nThe data that client raw data webhooks encompasses are reporting AP information, RSSI Data, and any special packets/telemetry\npackets that the client may emit.\n\nNote that client raw webhooks are the raw data coming from the client and do not contain the X,Y location data of the client.\nIn order to get the location data for a client please see our location webhooks. \nClients can be identified uniquely across these client raw data topics and location webhook topic using MAC address as the Unique identifier (client identifier)."
webhook_asset_raw_rssi_event:
title: webhook_asset_raw_rssi_event
type: object
properties:
ap_loc:
type: array
items:
type: number
description: Location coordinates of the reporting AP when available, updated about once per minute per client
beam:
maximum: 9
minimum: 1
type: integer
description: antenna index, clock-wise starting from the LED
contentEncoding: int32
device_id:
type: string
description: Identifier of the AP or device that reported the raw RSSI sample
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
ibeacon_major:
maximum: 65535
minimum: 1
type:
- integer
- 'null'
description: iBeacon major value decoded from the packet when present
contentEncoding: int32
examples:
- 1234
ibeacon_minor:
maximum: 65535
minimum: 1
type:
- integer
- 'null'
description: iBeacon minor value decoded from the packet when present
contentEncoding: int32
examples:
- 1234
ibeacon_uuid:
type:
- string
- 'null'
description: iBeacon UUID decoded from the packet when present
contentEncoding: uuid
examples:
- f3f17139-704a-f03a-2786-0400279e37c3
is_asset:
type: boolean
description: Whether the advertising MAC address is recognized as an asset
mac:
type: string
description: Client MAC address for the asset or beacon that emitted the packet
map_id:
type: string
description: Map associated with the reporting AP when location context is available
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
mfg_company_id:
type:
- integer
- 'null'
description: optional, BLE manufacturing company ID
contentEncoding: int32
mfg_data:
type:
- string
- 'null'
description: optional, BLE manufacturing data in hex byte-string format (ie “112233AABBCC”)
org_id:
type: string
description: Organization associated with the raw RSSI sample
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
rssi:
type: integer
description: Received signal strength of the packet at the reporting AP, in dBm
contentEncoding: int32
service_packets:
type: array
items:
$ref: '#/components/schemas/webhook_asset_raw_rssi_event_service_packet'
description: BLE service data packets decoded from the advertised payload
site_id:
type: string
description: Site associated with the raw RSSI sample
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
timestamp:
type: number
description: Time when the raw RSSI sample was observed, in epoch seconds
readOnly: true
description: Raw RSSI sample reported for an asset or beacon packet
webhook_asset_raw_rssi_event_service_packet:
title: webhook_asset_raw_rssi_event_service_packet
type: object
properties:
service_data:
type:
- string
- 'null'
description: optional, data from service data
service_uuid:
type:
- string
- 'null'
description: optional, UUID from service data
description: BLE service data decoded from an asset raw RSSI packet
webhook_asset_raw_rssi_topic:
title: webhook_asset_raw_rssi_topic
const: asset-raw-rssi
type: string
description: 'Webhook topic name for asset raw RSSI deliveries. enum: `asset-raw-rssi`'
webhook_audits:
title: webhook_audits
required:
- events
- topic
type: object
properties:
events:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/log_event'
description: Audit log events included in this webhook delivery
topic:
const: audits
type: string
description: 'Webhook topic name for audit event deliveries. enum: `audits`.'
description: Sample of the `audits` webhook payload.
webhook_audits_topic:
title: webhook_audits_topic
const: audits
type: string
description: 'Webhook topic name for audit event deliveries. enum: `audits`'
webhook_client_info:
title: webhook_client_info
type: object
properties:
events:
type: array
items:
$ref: '#/components/schemas/webhook_client_info_event'
description: Client information events included in this webhook delivery
topic:
allOf:
- $ref: '#/components/schemas/webhook_client_info_topic2'
- description: 'Webhook topic name for client information deliveries. enum: `client-info`.'
description: Sample of the `client-info` webhook payload.
webhook_client_info_event:
title: webhook_client_info_event
type: object
properties:
hostname:
type: string
description: Client hostname reported in the event
examples:
- service.company.net
ip:
type: string
description: Client IP address reported in the event
mac:
type: string
description: Client MAC address reported in the event
org_id:
type: string
description: Organization associated with the client information event
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
site_id:
type: string
description: Site associated with the client information event
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
timestamp:
type: number
description: Time when the client information event was generated, in epoch seconds
readOnly: true
description: Client identity and addressing details delivered by a `client-info` webhook
webhook_client_info_topic:
title: webhook_client_info_topic
const: client-info
type: string
description: 'Webhook topic name for client information deliveries. enum: `client-info`'
webhook_client_join:
title: webhook_client_join
required:
- events
- topic
type: object
properties:
events:
minItems: 1
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/webhook_client_join_event'
description: Client join events included in this webhook delivery
topic:
const: client-join
type: string
description: 'Webhook topic name for client join deliveries. enum: `client-join`.'
description: Sample of the `client-join` webhook payload.
webhook_client_join_event:
title: webhook_client_join_event
required:
- ap
- ap_name
- band
- bssid
- connect
- connect_float
- mac
- org_id
- rssi
- site_id
- site_name
- ssid
- timestamp
- version
- wlan_id
type: object
properties:
ap:
type: string
description: MAC address of the AP the client connected to
ap_name:
type: string
description: user-friendly name of the AP the client connected to.
band:
type: string
description: 5GHz or 2.4GHz band
bssid:
type: string
description: WLAN radio BSSID that the client associated with
connect:
type: integer
description: Time when the client connected, in epoch seconds
contentEncoding: int32
connect_float:
type: number
description: Client connection timestamp with millisecond precision
mac:
type: string
description: Client MAC address that joined the WLAN
org_id:
type: string
description: Organization associated with the client join event
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
rssi:
type: number
description: Signal strength when the client associated, in dBm
site_id:
type: string
description: Site associated with the client join event
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
site_name:
type: string
description: Site name associated with the client join event
ssid:
type: string
description: WLAN SSID that the client joined
timestamp:
type: number
description: Time when the client join event was generated, in epoch seconds
readOnly: true
version:
type: number
description: schema version of this message
wlan_id:
type: string
description: Unique identifier of the WLAN the client joined
contentEncoding: uuid
description: Wireless client association event delivered when a client joins a WLAN
webhook_client_join_topic:
title: webhook_client_join_topic
const: client-join
type: string
description: 'Webhook topic name for client join deliveries. enum: `client-join`'
webhook_client_latency:
title: webhook_client_latency
type: object
properties:
events:
type: array
items:
$ref: '#/components/schemas/webhook_client_latency_event'
description: Client latency summary events included in this webhook delivery
topic:
allOf:
- $ref: '#/components/schemas/webhook_client_latency_topic2'
- description: 'Webhook topic name for client latency deliveries. enum: `client-latency`.'
description: Sample of the `client-latency` webhook payload.
webhook_client_latency_event:
title: webhook_client_latency_event
type: object
properties:
avg_auth:
type: number
description: Average authentication latency observed during the reporting interval
examples:
- 0.17170219
avg_dhcp:
type: number
description: Average DHCP latency observed during the reporting interval
examples:
- 0.017828934
avg_dns:
type: number
description: Average DNS latency observed during the reporting interval
examples:
- 0.024532124
max_auth:
type: number
description: Maximum authentication latency observed during the reporting interval
examples:
- 0.18170219
max_dhcp:
type: number
description: Maximum DHCP latency observed during the reporting interval
examples:
- 0.027828934
max_dns:
type: number
description: Maximum DNS latency observed during the reporting interval
examples:
- 0.022532124
min_auth:
type: number
description: Minimum authentication latency observed during the reporting interval
examples:
- 0.16050219
min_dhcp:
type: number
description: Minimum DHCP latency observed during the reporting interval
examples:
- 0.015828934
min_dns:
type: number
description: Minimum DNS latency observed during the reporting interval
examples:
- 0.029532124
org_id:
type: string
description: Organization associated with the client latency metrics
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
site_id:
type: string
description: Site associated with the client latency metrics
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
timestamp:
type: number
description: Time when the client latency metrics were reported, in epoch seconds
readOnly: true
description: Site-level client latency metrics for authentication, DHCP, and DNS operations
webhook_client_latency_topic:
title: webhook_client_latency_topic
const: client-latency
type: string
description: 'Webhook topic name for client latency deliveries. enum: `client-latency`'
webhook_client_sessions:
title: webhook_client_sessions
required:
- events
- topic
type: object
properties:
events:
minItems: 1
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/webhook_client_sessions_event'
description: Client session events included in this webhook delivery
topic:
const: client-sessions
type: string
description: 'Webhook topic name for client session deliveries. enum: `client-sessions`.'
description: Sample of the `client-sessions` webhook payload.
webhook_client_sessions_event:
title: webhook_client_sessions_event
required:
- ap
- ap_name
- band
- bssid
- client_family
- client_manufacture
- client_model
- client_os
- connect
- connect_float
- disconnect
- disconnect_float
- duration
- mac
- next_ap
- org_id
- rssi
- site_id
- site_name
- ssid
- termination_reason
- timestamp
- version
- wlan_id
type: object
properties:
ap:
type: string
description: MAC address of the AP the client roamed or disconnected from
ap_name:
type: string
description: user-friendly name of the AP the client roamed or disconnected from.
band:
type: string
description: 5GHz or 2.4GHz band
bssid:
type: string
description: WLAN radio BSSID that the client was associated with
client_family:
type: string
description: Device family E.g. "Mac", "iPhone", "Apple watch"
client_manufacture:
type: string
description: Device manufacturer E.g. "Apple"
client_model:
type: string
description: Device model E.g. "8+", "XS"
client_os:
type: string
description: Device operating system E.g. "Mojave", "Windows 10", "Linux"
connect:
type: integer
description: Time when the client connected, in epoch seconds
contentEncoding: int32
connect_float:
type: number
description: Client connection timestamp with millisecond precision
disconnect:
type: integer
description: Time when the client disconnected, in epoch seconds
contentEncoding: int32
disconnect_float:
type: number
description: Client disconnect timestamp with millisecond precision
duration:
type: integer
description: Length of the roamed or completed client session indicated by the `termination_reason` value
contentEncoding: int32
mac:
type: string
description: Client MAC address for the roaming or disconnected session
next_ap:
type: string
description: the AP the client has roamed to.
org_id:
type: string
description: Organization associated with the client session event
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
rssi:
type: number
description: Latest average RSSI before the user disconnects
site_id:
type: string
description: Site associated with the client session event
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
site_name:
type: string
description: Site name associated with the client session event
ssid:
type: string
description: WLAN SSID for the client session
termination_reason:
type: integer
description: 1 disassociate - when the client disassociates. 2 inactive - when the client is timeout. 3 roamed - when the client is roamed between APs
contentEncoding: int32
timestamp:
type: number
description: Time when the client session event was generated, in epoch seconds
readOnly: true
version:
type: number
description: schema version of this message
wlan_id:
type: string
description: Unique identifier of the WLAN for the client session
contentEncoding: uuid
description: Wireless client session event delivered when a client roams or disconnects
webhook_client_sessions_topic:
title: webhook_client_sessions_topic
const: client-sessions
type: string
description: 'Webhook topic name for client session deliveries. enum: `client-sessions`'
webhook_delivery_distinct:
title: webhook_delivery_distinct
enum:
- status
- status_code
- topic
- webhook_id
type: string
description: 'webhook topic. enum: `status`, `status_code`, `topic`, `webhook_id`'
examples:
- webhook_id
webhook_delivery_status:
title: webhook_delivery_status
enum:
- failure
- success
type: string
description: 'webhook delivery status. enum: `failure`, `success`'
examples:
- failure
webhook_delivery_topic:
title: webhook_delivery_topic
enum:
- alarms
- audits
- device-updowns
- occupancy-alerts
- ping
type: string
description: 'webhook topic. enum: `alarms`, `audits`, `device-updowns`, `occupancy-alerts`, `ping`'
examples:
- audits
webhook_device_events:
title: webhook_device_events
required:
- events
- topic
type: object
properties:
events:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/device_event'
description: Device events included in this webhook delivery
topic:
const: device-events
type: string
description: 'Webhook topic name for device event deliveries. enum: `device-events`.'
description: Sample of the `device-events` webhook payload.
webhook_device_events_event_ev_type:
title: webhook_device_events_event_ev_type
enum:
- notice
- warn
type: string
description: '(optional) event advisory. enum: `notice`, `warn`'
webhook_device_events_topic:
title: webhook_device_events_topic
const: device-events
type: string
description: 'Webhook topic name for device event deliveries. enum: `device-events`'
webhook_device_updowns:
title: webhook_device_updowns
required:
- events
- topic
type: object
properties:
events:
minItems: 1
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/webhook_device_updowns_event'
description: Device up/down events included in this webhook delivery
topic:
const: device-updowns
type: string
description: 'Webhook topic name for device up/down deliveries. enum: `device-updowns`.'
description: Sample of the `device-updowns` webhook payload.
webhook_device_updowns_event:
title: webhook_device_updowns_event
required:
- ap
- ap_name
- org_id
- site_id
- site_name
- timestamp
- type
type: object
properties:
ap:
type: string
description: MAC address for the AP whose availability changed
readOnly: true
ap_name:
type: string
description: AP name for the device whose availability changed
readOnly: true
for_site:
type: boolean
description: Whether this device up/down event is scoped to a site rather than only to the organization
readOnly: true
org_id:
type: string
description: Organization associated with the device up/down event
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
site_id:
type: string
description: Site associated with the device up/down event
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
site_name:
type: string
description: Site name associated with the device up/down event
readOnly: true
timestamp:
type: number
description: Time when the device availability event occurred, in epoch seconds
readOnly: true
type:
type: string
description: Reported up/down event type for the device
readOnly: true
description: Device availability event delivered when a monitored AP changes up/down state
webhook_device_updowns_topic:
title: webhook_device_updowns_topic
const: device-updowns
type: string
description: 'Webhook topic name for device up/down deliveries. enum: `device-updowns`'
webhook_discovered_raw_rssi:
title: webhook_discovered_raw_rssi
required:
- topic
type: object
properties:
events:
type: array
items:
$ref: '#/components/schemas/webhook_discovered_raw_rssi_event'
description: Discovered raw RSSI event records included in this webhook delivery
topic:
const: discovered-raw-rssi
type: string
description: 'Webhook topic name for discovered raw RSSI deliveries. enum: `discovered-raw-rssi`.'
description: Sample of the `discovered-raw-rssi` webhook payload.
webhook_discovered_raw_rssi_event:
title: webhook_discovered_raw_rssi_event
required:
- beam
- device_id
- mac
- map_id
- org_id
- rssi
- site_id
type: object
properties:
ap_loc:
type: array
items:
type: number
description: Location coordinates of the reporting AP when available, updated about once per minute per client
beam:
type: integer
description: Antenna index, from 1-8, clock-wise starting from the LED
contentEncoding: int32
device_id:
type: string
description: Identifier of the AP that reported the raw RSSI sample
contentEncoding: uuid
ibeacon_major:
maximum: 65535
minimum: 1
type:
- integer
- 'null'
description: iBeacon major value decoded from the packet when present
contentEncoding: int32
examples:
- 1234
ibeacon_minor:
maximum: 65535
minimum: 1
type:
- integer
- 'null'
description: iBeacon minor value decoded from the packet when present
contentEncoding: int32
examples:
- 1234
ibeacon_uuid:
type:
- string
- 'null'
description: iBeacon UUID decoded from the packet when present
contentEncoding: uuid
examples:
- f3f17139-704a-f03a-2786-0400279e37c3
is_asset:
type: boolean
description: Whether the advertising MAC address is recognized as an asset
mac:
type: string
description: Client MAC address for the passive BLE device or beacon that emitted the packet
map_id:
type: string
description: Map associated with the reporting AP when location context is available
contentEncoding: uuid
mfg_company_id:
type: string
description: BLE manufacturing company ID
mfg_data:
type: string
description: 'BLE manufacturing data in hex byte-string format (ie: "112233AABBCC")'
org_id:
type: string
description: Organization associated with the raw RSSI sample
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
rssi:
type: number
description: Received signal strength of the packet at the reporting AP, in dBm
service_packets:
type: array
items:
$ref: '#/components/schemas/service_packet'
description: BLE service data packets decoded from the advertised payload
site_id:
type: string
description: Site associated with the raw RSSI sample
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
timestamp:
type: number
description: Time when the raw RSSI sample was observed, in epoch seconds
readOnly: true
description: Raw RSSI sample reported for a passive BLE device packet
webhook_discovered_raw_rssi_topic:
title: webhook_discovered_raw_rssi_topic
const: discovered-raw-rssi
type: string
description: 'Webhook topic name for discovered raw RSSI deliveries. enum: `discovered-raw-rssi`'
webhook_guest_authorizations:
title: webhook_guest_authorizations
type: object
properties:
events:
type: array
items:
$ref: '#/components/schemas/webhook_guest_authorizations_event'
description: Guest authorization events included in this webhook delivery
topic:
allOf:
- $ref: '#/components/schemas/webhook_guest_authorizations_topic2'
- description: 'Webhook topic name for guest authorization deliveries. enum: `guest-authorizations`.'
description: Sample of the `guest-authorizations` webhook payload.
webhook_guest_authorizations_event:
title: webhook_guest_authorizations_event
type: object
properties:
ap:
type: string
description: MAC address of the AP handling the guest authorization
examples:
- 5c5b350e55c8
auth_method:
type: string
description: Guest portal authentication method used for this authorization event
examples:
- passphrase
authorized_expiring_time:
type: integer
description: Unix timestamp when the guest authorization expires
contentEncoding: int32
examples:
- 1677076639
authorized_time:
type: integer
description: Unix timestamp when the guest authorization was granted
contentEncoding: int32
examples:
- 1677076519
carrier:
type: string
description: Mobile carrier used when authentication relies on a cellular provider
examples:
- docomo
client:
type: string
description: MAC address of the guest client device
examples:
- ac2316eca70a
company:
type: string
description: Guest company name provided during registration
examples:
- MIST
email:
type: string
description: Guest email address provided during registration
examples:
- abcd@abcd.com
field1:
type: string
description: Value submitted for custom guest field 1
examples:
- field1 value
field2:
type: string
description: Value submitted for custom guest field 2
examples:
- field2 value
field3:
type: string
description: Value submitted for custom guest field 3
examples:
- field3 value
field4:
type: string
description: Value submitted for custom guest field 4
examples:
- field4 value
mobile:
type: string
description: Guest mobile phone number provided during registration
examples:
- '+0123456789'
name:
type: string
description: Full name provided by the guest during registration
examples:
- Dr Strange
org_id:
type: string
description: Organization associated with the guest authorization event
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
site_id:
type: string
description: Site associated with the guest authorization event
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
sms_gateway:
type: string
description: SMS provider used for text-message authentication
examples:
- Telstra
sponsor_email:
type: string
description: Sponsor email address associated with the guest authorization
examples:
- sponsor@gmail.com
ssid:
type: string
description: WLAN SSID on which the guest was authorized
examples:
- Portal Auth
wlan_id:
type: string
description: WLAN identifier on which the guest was authorized
examples:
- 7681be9a-044a-4622-90cf-3accde5ad853
description: Guest portal authorization event with registration and WLAN context
webhook_guest_authorizations_topic:
title: webhook_guest_authorizations_topic
const: guest-authorizations
type: string
description: 'Webhook topic name for guest authorization deliveries. enum: `guest-authorizations`'
webhook_location:
title: webhook_location
required:
- events
- topic
type: object
properties:
events:
minItems: 1
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/webhook_location_event'
description: Location events included in this webhook delivery
topic:
const: location
type: string
description: Webhook topic name for generic location deliveries
description: Sample of the `location` webhook payload.
webhook_location_asset:
title: webhook_location_asset
required:
- events
- topic
type: object
properties:
events:
type: array
items:
$ref: '#/components/schemas/webhook_location_asset_event'
description: Asset location events included in this webhook delivery
topic:
const: location-asset
type: string
description: 'Webhook topic name for asset location deliveries. enum: `location-asset`.'
description: Sample of the `location_asset` webhook payload.
webhook_location_asset_event:
title: webhook_location_asset_event
type: object
properties:
battery_voltage:
type: integer
description: Battery voltage value reported by the asset tag
contentEncoding: int32
examples:
- 3370
eddystone_uid_instance:
type: string
description: Eddystone UID instance value advertised by the asset tag
examples:
- 5c5b35000001
eddystone_uid_namespace:
type: string
description: Eddystone UID namespace value advertised by the asset tag
examples:
- 2818e3868dec25629ede
eddystone_url_url:
type: string
description: Eddystone URL advertised by the asset tag
examples:
- https://www.abc.com
ibeacon_major:
maximum: 65535
minimum: 1
type:
- integer
- 'null'
description: iBeacon major value advertised by the asset tag when present
contentEncoding: int32
examples:
- 1234
ibeacon_minor:
maximum: 65535
minimum: 1
type:
- integer
- 'null'
description: iBeacon minor value advertised by the asset tag when present
contentEncoding: int32
examples:
- 1234
ibeacon_uuid:
type:
- string
- 'null'
description: iBeacon UUID advertised by the asset tag when present
contentEncoding: uuid
examples:
- f3f17139-704a-f03a-2786-0400279e37c3
mac:
type: string
description: Asset MAC address used as the location identifier
examples:
- 7fc2936fd243
map_id:
type: string
description: Map where the asset location was calculated
contentEncoding: uuid
examples:
- 845a23bf-bed9-e43c-4c86-6fa474be7ae5
mfg_company_id:
type: integer
description: Optional, BLE manufacturing company ID
contentEncoding: int32
examples:
- 935
mfg_data:
type: string
description: 'Optional, BLE manufacturing data in hex byte-string format (ie: "112233AABBCC")'
examples:
- 648520a1020000
site_id:
type: string
description: Site associated with the asset location event
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
timestamp:
type: number
description: Time when the asset location was calculated, in epoch seconds
readOnly: true
type:
type: string
description: Location object type for the asset event; defaults to `asset`
default: asset
x:
type: number
description: Horizontal map coordinate of the asset position, in meters
examples:
- 13.5
y:
type: number
description: Vertical map coordinate of the asset position, in meters
examples:
- 3.2
description: Asset location update with map coordinates and optional BLE beacon metadata
webhook_location_asset_topic:
title: webhook_location_asset_topic
const: location-asset
type: string
description: 'Webhook topic name for asset location deliveries. enum: `location-asset`'
webhook_location_centrak:
title: webhook_location_centrak
required:
- events
- topic
type: object
properties:
events:
minItems: 1
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/webhook_location_centrak_event'
description: CenTrak location events included in this webhook delivery
topic:
const: location-centrak
type: string
description: 'Webhook topic name for CenTrak location deliveries. enum: `location-centrak`.'
description: Sample of the `location-centrak` webhook payload.
webhook_location_centrak_event:
title: webhook_location_centrak_event
type: object
properties:
mac:
type: string
description: Device MAC address used as the CenTrak location identifier
map_id:
type: string
description: Identifier of the map where the CenTrak location was calculated
mfg_company_id:
type: integer
description: Optional, BLE manufacturing company ID
contentEncoding: int32
mfg_data:
type: string
description: Optional, BLE manufacturing data in hex byte-string format (i.e. "112233AABBCC")
site_id:
type: string
description: Site associated with the CenTrak location event
contentEncoding: uuid
timestamp:
type: number
description: Time when the CenTrak location was calculated, in epoch seconds
readOnly: true
type:
allOf:
- $ref: '#/components/schemas/webhook_location_centrak_event_type2'
- description: 'Location object type for the CenTrak event. enum: `wifi`.'
wifi_beacon_extended_info:
type: array
items:
$ref: '#/components/schemas/wifi_beacon_extended_info_items'
description: Extended Wi-Fi beacon metadata included with this CenTrak location event
x:
type: number
description: Horizontal map coordinate of the CenTrak device, in meters
y:
type: number
description: Vertical map coordinate of the CenTrak device, in meters
description: CenTrak location update with map coordinates and Wi-Fi beacon metadata
webhook_location_centrak_event_type:
title: webhook_location_centrak_event_type
const: wifi
type: string
description: 'Location object type for CenTrak Wi-Fi beacon events. enum: `wifi`'
webhook_location_centrak_topic:
title: webhook_location_centrak_topic
const: location-centrak
type: string
description: 'Webhook topic name for CenTrak location deliveries. enum: `location-centrak`'
webhook_location_client:
title: webhook_location_client
required:
- events
- topic
type: object
properties:
events:
type: array
items:
$ref: '#/components/schemas/webhook_location_client_event'
description: Connected client location events included in this webhook delivery
topic:
const: location-client
type: string
description: 'Webhook topic name for connected client location deliveries. enum: `location-client`.'
description: Sample of the `location-client` webhook payload.
webhook_location_client_event:
title: webhook_location_client_event
type: object
properties:
mac:
type: string
description: Connected client MAC address used as the location identifier
examples:
- 5684dae9ac8b
map_id:
type: string
description: Map where the connected client location was calculated
contentEncoding: uuid
examples:
- 845a23bf-bed9-e43c-4c86-6fa474be7ae5
site_id:
type: string
description: Site associated with the connected client location event
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
timestamp:
type: number
description: Time when the connected client location was calculated, in epoch seconds
readOnly: true
type:
type: string
description: Location object type for the connected client event; defaults to `wifi`
default: wifi
wifi_beacon_extended_info:
type: array
items:
$ref: '#/components/schemas/wifi_beacon_extended_info_items'
description: Extended Wi-Fi beacon metadata included with this connected client location event
x:
type: number
description: Horizontal map coordinate of the connected client, in meters
examples:
- 13.5
y:
type: number
description: Vertical map coordinate of the connected client, in meters
examples:
- 3.2
description: Connected Wi-Fi client location update with map coordinates
webhook_location_client_topic:
title: webhook_location_client_topic
const: location-client
type: string
description: 'Webhook topic name for connected client location deliveries. enum: `location-client`'
webhook_location_event:
title: webhook_location_event
required:
- id
- map_id
- site_id
- timestamp
- type
- x
- y
type: object
properties:
battery_voltage:
type: integer
description: Battery voltage value reported by the located entity
contentEncoding: int32
eddystone_uid_instance:
type: string
description: Eddystone UID instance value advertised by the located entity
eddystone_uid_namespace:
type: string
description: Eddystone UID namespace value advertised by the located entity
eddystone_url_url:
type: string
description: Eddystone URL advertised by the located entity
ibeacon_major:
maximum: 65535
minimum: 1
type:
- integer
- 'null'
description: iBeacon major value advertised by the located entity when present
contentEncoding: int32
examples:
- 1234
ibeacon_minor:
maximum: 65535
minimum: 1
type:
- integer
- 'null'
description: iBeacon minor value advertised by the located entity when present
contentEncoding: int32
examples:
- 1234
ibeacon_uuid:
type:
- string
- 'null'
description: iBeacon UUID advertised by the located entity when present
contentEncoding: uuid
examples:
- f3f17139-704a-f03a-2786-0400279e37c3
id:
type: string
description: Unique identifier for the located entity in this event
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
mac:
type: string
description: Located entity MAC address for this location event
map_id:
type: string
description: Identifier of the map where the location was calculated
contentEncoding: uuid
mfg_company_id:
type: integer
description: Optional, BLE manufacturing company ID
contentEncoding: int32
mfg_data:
type: string
description: Optional, BLE manufacturing data in hex byte-string format (ie "112233AABBCC")
name:
type: string
description: Client or asset display name, when available
site_id:
type: string
description: Site associated with the location event
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
timestamp:
type: number
description: Time when the location was calculated, in epoch seconds
readOnly: true
type:
type: string
description: Location object type for this event
wifi_beacon_extended_info:
type: array
items:
$ref: '#/components/schemas/wifi_beacon_extended_info_items'
description: Extended Wi-Fi beacon metadata included with this location event
x:
type: number
description: Horizontal map coordinate of the located entity, in meters
y:
type: number
description: Vertical map coordinate of the located entity, in meters
description: Generic location update with map coordinates and optional BLE or Wi-Fi metadata
webhook_location_sdk:
title: webhook_location_sdk
required:
- events
- topic
type: object
properties:
events:
type: array
items:
$ref: '#/components/schemas/webhook_location_sdk_event'
description: SDK client location events included in this webhook delivery
topic:
const: location-sdk
type: string
description: 'Webhook topic name for SDK client location deliveries. enum: `location-sdk`.'
description: Sample of the `location-sdk` webhook payload.
webhook_location_sdk_event:
title: webhook_location_sdk_event
type: object
properties:
id:
type: string
description: Unique identifier of the SDK client for this location event
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
map_id:
type: string
description: Map where the SDK client location was calculated
contentEncoding: uuid
examples:
- 845a23bf-bed9-e43c-4c86-6fa474be7ae5
name:
type: string
description: Display name of the SDK client when available
examples:
- optional
site_id:
type: string
description: Site associated with the SDK client location event
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
timestamp:
type: number
description: Time when the SDK client location was calculated, in epoch seconds
readOnly: true
type:
type: string
description: Location object type for the SDK client event; defaults to `sdk`
default: sdk
x:
type: number
description: Horizontal map coordinate of the SDK client, in meters
examples:
- 13.5
y:
type: number
description: Vertical map coordinate of the SDK client, in meters
examples:
- 3.2
description: SDK client location update with map coordinates
webhook_location_sdk_topic:
title: webhook_location_sdk_topic
const: location-sdk
type: string
description: 'Webhook topic name for SDK client location deliveries. enum: `location-sdk`'
webhook_location_topic:
title: webhook_location_topic
const: location
type: string
description: 'Webhook topic name for generic location deliveries. enum: `location`'
webhook_location_unclient:
title: webhook_location_unclient
required:
- events
- topic
type: object
properties:
events:
type: array
items:
$ref: '#/components/schemas/webhook_location_unclient_event'
description: Unconnected client location events included in this webhook delivery
topic:
const: location-unclient
type: string
description: 'Webhook topic name for unconnected client location deliveries. enum: `location-unclient`.'
description: Sample of the `location-unclient` webhook payload.
webhook_location_unclient_event:
title: webhook_location_unclient_event
type: object
properties:
mac:
type: string
description: Unconnected client MAC address used as the location identifier
examples:
- 5684dae9ac8b
map_id:
type: string
description: Map where the unconnected client location was calculated
contentEncoding: uuid
examples:
- 845a23bf-bed9-e43c-4c86-6fa474be7ae5
site_id:
type: string
description: Site associated with the unconnected client location event
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
timestamp:
type: number
description: Time when the unconnected client location was calculated, in epoch seconds
readOnly: true
type:
type: string
description: Location object type for the unconnected client event; defaults to `wifi`
default: wifi
wifi_beacon_extended_info:
type: array
items:
$ref: '#/components/schemas/wifi_beacon_extended_info_items'
description: Extended Wi-Fi beacon metadata included with this unconnected client location event
x:
type: number
description: Horizontal map coordinate of the unconnected client, in meters
examples:
- 13.5
y:
type: number
description: Vertical map coordinate of the unconnected client, in meters
examples:
- 3.2
description: Unconnected Wi-Fi client location update with map coordinates
webhook_location_unclient_topic:
title: webhook_location_unclient_topic
const: location-unclient
type: string
description: 'Webhook topic name for unconnected client location deliveries. enum: `location-unclient`'
webhook_minis_application:
title: webhook_minis_application
required:
- events
- topic
type: object
properties:
events:
type: array
items:
$ref: '#/components/schemas/webhook_minis_application_event'
description: Minis application test events included in this webhook delivery
topic:
const: minis-application
type: string
description: 'Webhook topic name for Minis application test deliveries. enum: `minis-application`.'
description: Sample of the `minis-application` webhook payload.
webhook_minis_application_event:
title: webhook_minis_application_event
type: object
properties:
device_mac:
type: string
description: MAC address of the device
ip:
type: string
description: Destination IP address used for the application test
latency:
type: integer
description: Application test latency measured in milliseconds
contentEncoding: int32
org_id:
type: string
description: Organization associated with the Minis application test result
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
probe_name:
type: string
description: Name of the probe
examples:
- connectivitycheck.gstatic.com
probe_type:
type: string
description: Probe category used for the Minis application test
examples:
- application
site_id:
type: string
description: Site associated with the Minis application test result
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
src_ip:
type: string
description: Source IP address of the test
success:
type: boolean
description: Whether the test was successful
test_type:
allOf:
- $ref: '#/components/schemas/synthetictest_config_custom_probe_type2'
- description: 'Synthetic test type used for the Minis application result. enum: `application`, `curl`, `icmp`, `reachability`, `tcp`.'
timestamp:
type: number
description: Time when the Minis application test result was reported, in epoch seconds
readOnly: true
vlan:
type: integer
description: Network VLAN ID used for the application test
contentEncoding: int32
examples:
- 12
description: Marvis Minis application synthetic test result
webhook_minis_application_topic:
title: webhook_minis_application_topic
const: minis-application
type: string
description: 'Webhook topic name for Minis application test deliveries. enum: `minis-application`'
webhook_minis_reachability:
title: webhook_minis_reachability
required:
- events
- topic
type: object
properties:
events:
type: array
items:
$ref: '#/components/schemas/webhook_minis_reachability_event'
description: Minis reachability test events included in this webhook delivery
topic:
const: minis-reachability
type: string
description: 'Webhook topic name for Minis reachability test deliveries. enum: `minis-reachability`.'
description: Sample of the `minis-reachability` webhook payload.
webhook_minis_reachability_event:
title: webhook_minis_reachability_event
type: object
properties:
avg_latency:
type: number
description: Average latency in milliseconds
device_mac:
type: string
description: MAC address of the device performing the test
examples:
- 7cb68d8f0440
loss_percentage:
type: number
description: Percentage of packets lost during the reachability test
max_latency:
type: number
description: Maximum latency in milliseconds
min_latency:
type: number
description: Minimum latency in milliseconds
org_id:
type: string
description: Organization associated with the Minis reachability test result
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
probe_name:
type: string
description: Name of the probe
examples:
- google ping
probe_target:
type: string
description: Target host or IP for the probe
examples:
- google.com
probe_type:
type: string
description: Probe category used for the Minis reachability test
examples:
- reachability
protocol:
type: string
description: Network protocol used for the reachability test
examples:
- icmp
site_id:
type: string
description: Site associated with the Minis reachability test result
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
test_type:
type: string
description: Type of test performed
examples:
- ping
timestamp:
type: number
description: Time when the Minis reachability test result was reported, in epoch seconds
readOnly: true
vlan:
type: integer
description: Network VLAN ID used for the reachability test
contentEncoding: int32
examples:
- 12
description: Marvis Minis reachability synthetic test result
webhook_minis_reachability_topic:
title: webhook_minis_reachability_topic
const: minis-reachability
type: string
description: 'Webhook topic name for Minis reachability test deliveries. enum: `minis-reachability`'
webhook_mxedge_event_topic:
title: webhook_mxedge_event_topic
const: mxedge-events
type: string
description: 'Webhook topic name for Mist Edge event deliveries. enum: `mxedge-events`'
webhook_mxedge_events:
title: webhook_mxedge_events
required:
- events
- topic
type: object
properties:
events:
minItems: 1
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/mxedge_event'
description: Mist Edge events included in this webhook delivery
topic:
const: mxedge-events
type: string
description: 'Webhook topic name for Mist Edge event deliveries. enum: `mxedge-events`.'
description: Sample of the `mxedge-events` webhook payload.
webhook_nac_accounting:
title: webhook_nac_accounting
type: object
properties:
events:
type: array
items:
$ref: '#/components/schemas/webhook_nac_accounting_event'
description: NAC accounting events included in this webhook delivery
topic:
allOf:
- $ref: '#/components/schemas/webhook_nac_accounting_topic2'
- description: 'Webhook topic name for NAC accounting deliveries. enum: `nac-accounting`.'
description: Sample of the `nac-accounting` webhook payload.
webhook_nac_accounting_event:
title: webhook_nac_accounting_event
type: object
properties:
ap:
type: string
description: MAC address of the AP the client roamed or disconnected from
examples:
- 5c5b355005be
auth_type:
allOf:
- $ref: '#/components/schemas/nac_auth_type4'
- description: 'Authentication method used for the NAC accounting session. enum: `cert`, `device-auth`, `eap-teap`, `eap-tls`, `eap-ttls`, `idp`, `mab`, `eap-peap`.'
examples:
- eap-tls
bssid:
type: string
description: Wireless BSSID used for the NAC accounting session
examples:
- 5c5b35546bb4
client_ip:
type: string
description: Client IP address observed for the NAC accounting session
examples:
- 172.16.87.4
client_type:
type: string
description: Client type E.g. "wired", "wireless", "vty"
examples:
- wireless
mac:
type: string
description: Client MAC address for the NAC accounting session
examples:
- 6e795836d5f9
nas_vendor:
type: string
description: NAS Device vendor name E.g. "Juniper", "Cisco"
examples:
- juniper-mist
org_id:
type: string
description: Organization associated with the NAC accounting event
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
rx_pkts:
type:
- integer
- 'null'
description: Number of packets received during the NAC accounting session
contentEncoding: int64
readOnly: true
examples:
- 57770567
site_id:
type: string
description: Site associated with the NAC accounting event
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
ssid:
type: string
description: Wireless SSID used for the NAC accounting session
examples:
- Test-CMR SSID
timestamp:
type: number
description: Time when the NAC accounting event was reported, in epoch seconds
readOnly: true
tx_pkts:
type:
- integer
- 'null'
description: Number of packets sent during the NAC accounting session
contentEncoding: int64
readOnly: true
examples:
- 812204062
type:
type: string
description: NAC accounting event type, such as `ACCOUNTING_START`, `ACCOUNTING_UPDATE`, or `ACCOUNTING_STOP`
examples:
- NAC_ACCOUNTING_STOP
username:
type: string
description: Client-presented username for NAC authentication
examples:
- hi
description: NAC accounting event for a client session with traffic counters
webhook_nac_accounting_topic:
title: webhook_nac_accounting_topic
const: nac-accounting
type: string
description: 'Webhook topic name for NAC accounting deliveries. enum: `nac-accounting`'
webhook_nac_events:
title: webhook_nac_events
type: object
properties:
events:
type: array
items:
$ref: '#/components/schemas/nac_client_event'
description: NAC authentication events included in this webhook delivery
topic:
allOf:
- $ref: '#/components/schemas/webhook_nac_events_topic2'
- description: 'Webhook topic name for NAC event deliveries. enum: `nac-events`.'
description: Sample of the `nac-events` webhook payload.
webhook_nac_events_topic:
title: webhook_nac_events_topic
const: nac-events
type: string
description: 'Webhook topic name for NAC event deliveries. enum: `nac-events`'
webhook_oauth2_grant_type:
title: webhook_oauth2_grant_type
enum:
- client_credentials
- password
type: string
description: 'required when `type`==`oauth2`. enum: `client_credentials`, `password`'
webhook_occupancy_alert_type:
title: webhook_occupancy_alert_type
enum:
- COMPLIANCE-OK
- COMPLIANCE-VIOLATION
type: string
description: 'Occupancy compliance state reported for the zone. enum: `COMPLIANCE-OK`, `COMPLIANCE-VIOLATION`'
webhook_occupancy_alerts:
title: webhook_occupancy_alerts
required:
- events
- topic
type: object
properties:
events:
minItems: 1
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/webhook_occupancy_alerts_event'
description: Occupancy alert batches included in this webhook delivery
topic:
const: occupancy-alerts
type: string
description: 'Webhook topic name for occupancy alert deliveries. enum: `occupancy-alerts`.'
description: Sample of the `occupancy-alerts` webhook payload.
webhook_occupancy_alerts_event:
title: webhook_occupancy_alerts_event
required:
- site_id
- site_name
type: object
properties:
alert_events:
minItems: 1
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/webhook_occupancy_alerts_event_alert_events_items'
description: Occupancy zone alerts detected for this site around the same time
readOnly: true
for_site:
type: boolean
description: Whether this occupancy alert batch is scoped to a site rather than only to the organization
readOnly: true
site_id:
type: string
description: Site associated with the occupancy alert batch
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
site_name:
type: string
description: Site name associated with the occupancy alert batch
readOnly: true
description: Site-level occupancy alert batch containing one or more zone alerts
webhook_occupancy_alerts_event_alert_events_items:
title: webhook_occupancy_alerts_event_alert_events_items
required:
- current_occupancy
- map_id
- occupancy_limit
- org_id
- timestamp
- type
- zone_id
- zone_name
type: object
properties:
current_occupancy:
type: integer
description: Current number of occupants detected in the zone
contentEncoding: int32
map_id:
type: string
description: Map associated with the occupancy zone
contentEncoding: uuid
occupancy_limit:
type: integer
description: Configured occupancy limit for the zone
contentEncoding: int32
org_id:
type: string
description: Organization associated with the occupancy alert
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
timestamp:
type: number
description: Time when the occupancy alert was generated, in epoch seconds
readOnly: true
type:
allOf:
- $ref: '#/components/schemas/webhook_occupancy_alert_type1'
- description: 'Occupancy compliance state reported for the zone. enum: `COMPLIANCE-OK`, `COMPLIANCE-VIOLATION`.'
zone_id:
type: string
description: Zone identifier associated with the occupancy alert
contentEncoding: uuid
zone_name:
type: string
description: Zone name associated with the occupancy alert
description: Occupancy compliance alert for a single zone
webhook_occupancy_alerts_topic:
title: webhook_occupancy_alerts_topic
const: occupancy-alerts
type: string
description: 'Webhook topic name for occupancy alert deliveries. enum: `occupancy-alerts`'
webhook_ping:
title: webhook_ping
required:
- events
- topic
type: object
properties:
events:
minItems: 1
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/webhook_ping_event'
description: Ping events included in this webhook delivery
topic:
const: ping
type: string
description: Webhook topic name for ping deliveries
description: Sample of the `ping` webhook payload.\n\nThe `ping` webhook can be manually sent with the following API calls:\n- for a Site level webhook with the [Ping Site Webhook]($e/Orgs%20Webhooks/pingOrgWebhook) endpoint\n- for an Org level webhook with the [Ping Org Webhook]($e/Orgs%20Webhooks/pingOrgWebhook) endpoint
webhook_ping_event:
title: webhook_ping_event
required:
- id
- name
- site_id
- timestamp
type: object
properties:
id:
type: string
description: Unique identifier of the webhook ping event
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
name:
type: string
description: Display name associated with the webhook ping event
site_id:
type: string
description: Site associated with the webhook ping event
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
timestamp:
type: number
description: Time when the webhook ping event was generated, in epoch seconds
readOnly: true
description: Ping webhook event generated to verify webhook delivery
webhook_ping_topic:
title: webhook_ping_topic
const: ping
type: string
description: 'Webhook topic name for ping deliveries. enum: `ping`'
webhook_rssizone:
title: webhook_rssizone
required:
- events
- topic
type: object
properties:
events:
minItems: 1
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/webhook_rssizone_event'
description: RSSI zone events included in this webhook delivery
topic:
const: rssizone
type: string
description: 'Webhook topic name for RSSI zone event deliveries. enum: `rssizone`.'
description: Sample of the `rssizone` webhook payload.
webhook_rssizone_event:
title: webhook_rssizone_event
required:
- mac
- map_id
- rssizone_id
- site_id
- timestamp
- trigger
- type
type: object
properties:
mac:
type: string
description: Client MAC address associated with the RSSI zone event
map_id:
type: string
description: Map associated with the RSSI zone event
contentEncoding: uuid
rssizone_id:
type: string
description: RSSI zone identifier associated with the event
contentEncoding: uuid
site_id:
type: string
description: Site associated with the RSSI zone event
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
timestamp:
type: number
description: Time when the RSSI zone transition was reported, in epoch seconds
readOnly: true
trigger:
allOf:
- $ref: '#/components/schemas/webhook_zone_event_trigger3'
- description: 'Whether the client entered or exited the RSSI zone. enum: `enter`, `exit`.'
type:
allOf:
- $ref: '#/components/schemas/webhook_zone_event_type3'
- description: 'Client type reported for the RSSI zone event. enum: `asset`, `sdk`, `wifi`.'
description: RSSI zone transition event for a Wi-Fi, SDK, or asset client
webhook_rssizone_topic:
title: webhook_rssizone_topic
const: rssizone
type: string
description: 'Webhook topic name for RSSI zone event deliveries. enum: `rssizone`'
webhook_rule:
title: webhook_rule
required:
- topic
type: object
properties:
action:
allOf:
- $ref: '#/components/schemas/webhook_action1'
- description: 'Action applied when the rule matches the incoming event. enum: `permit`, `block`.'
matching:
type: object
additionalProperties:
type: array
items:
type: string
description: Optional event payload matching criteria. Property key is the event field name and the value is the list of accepted values
example:
type:
- AP_DISCONNECTED
description: Optional event payload matching criteria. Property key is the event field name and the value is the list of accepted values
examples:
- type:
- AP_DISCONNECTED
topic:
type: string
description: Webhook topic this rule applies to
description: Filtering rule that permits or blocks webhook events for a topic
webhook_sdkclient_scan_data:
title: webhook_sdkclient_scan_data
required:
- events
- topic
type: object
properties:
events:
minItems: 1
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/webhook_sdkclient_scan_data_event'
description: SDK client scan data events included in this webhook delivery
topic:
const: sdkclient-scan-data
type: string
description: 'Webhook topic name for SDK client scan data deliveries. enum: `sdkclient-scan-data`.'
description: Sample of the `sdkclient-scan-data` webhook payload.
webhook_sdkclient_scan_data_event:
title: webhook_sdkclient_scan_data_event
required:
- connection_ap
- connection_band
- connection_bssid
- connection_channel
- connection_rssi
- mac
- site_id
type: object
properties:
connection_ap:
type: string
description: MAC address of the AP the client is connected to
connection_band:
type: string
description: 5GHz or 2.4GHz band, of the BSSID the client is connected to
connection_bssid:
type: string
description: Connected AP BSSID for the SDK client
connection_channel:
type: integer
description: Channel of the band the client is connected to
contentEncoding: int32
connection_rssi:
type: number
description: RSSI of the client’s connection to the AP/BSSID
last_seen:
type:
- number
- 'null'
description: Time when the SDK client scan data was last observed, in epoch seconds
readOnly: true
examples:
- 1470417522
mac:
type: string
description: SDK client MAC address
scan_data:
minItems: 1
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/webhook_sdkclient_scan_data_event_scan_data_item'
description: Background Wi-Fi scan observations reported by the SDK client
site_id:
type: string
description: Site associated with the SDK client scan data event
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
description: SDK client connection state and background Wi-Fi scan observations
webhook_sdkclient_scan_data_event_scan_data_item:
title: webhook_sdkclient_scan_data_event_scan_data_item
required:
- ap
- band
- bssid
- channel
- rssi
- ssid
- timestamp
type: object
properties:
ap:
type: string
description: MAC address of the AP associated with the BSSID scanned
band:
allOf:
- $ref: '#/components/schemas/scan_data_item_band1'
- minLength: 1
description: 'Radio band on which the SDK client scanned the BSSID. enum: `2.4`, `5`.'
bssid:
type: string
description: Scanned BSSID found during the SDK client's background Wi-Fi scan
channel:
type: integer
description: Radio channel found in the SDK client's background scan
contentEncoding: int32
rssi:
type: number
description: Signal strength measured by the SDK client for the scanned BSSID
ssid:
type: string
description: Network SSID containing the BSSID scanned by the SDK client
timestamp:
type: number
description: Time when the SDK client scan observation was recorded, in epoch seconds
readOnly: true
description: Single BSSID observation from an SDK client's background Wi-Fi scan
webhook_sdkclient_scan_data_topic:
title: webhook_sdkclient_scan_data_topic
const: sdkclient-scan-data
type: string
description: 'Webhook topic name for SDK client scan data deliveries. enum: `sdkclient-scan-data`'
webhook_site_sle:
title: webhook_site_sle
required:
- events
- topic
type: object
properties:
events:
type: array
items:
$ref: '#/components/schemas/webhook_site_sle_event'
description: Site SLE score events included in this webhook delivery
topic:
const: site-sle
type: string
description: 'Webhook topic name for site SLE score deliveries. enum: `site-sle`.'
description: Sample of the `site-sle` webhook payload.
webhook_site_sle_event:
title: webhook_site_sle_event
type: object
properties:
org_id:
type: string
description: Organization associated with the site SLE score event
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
site_id:
type: string
description: Site associated with the SLE score event
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
sle:
allOf:
- $ref: '#/components/schemas/webhook_site_sle_event_sle2'
- description: Service-level experience scores reported for the site
timestamp:
type: number
description: Time when the site SLE scores were reported, in epoch seconds
readOnly: true
description: Site-level Wi-Fi SLE score snapshot
webhook_site_sle_event_sle:
title: webhook_site_sle_event_sle
type: object
properties:
ap-availability:
type: number
description: Wireless AP availability SLE score for the site
examples:
- 0.6
successful-connect:
type: number
description: Connection success SLE score for the site
examples:
- 0.7
time-to-connect:
type: number
description: Client connection-time SLE score for the site
examples:
- 0.9
description: Wi-Fi SLE scores reported by a site SLE webhook event
webhook_site_sle_topic:
title: webhook_site_sle_topic
const: site-sle
type: string
description: 'Webhook topic name for site SLE score deliveries. enum: `site-sle`'
webhook_type:
title: webhook_type
enum:
- aws-sns
- google-pubsub
- http-post
- oauth2
- splunk
type: string
description: 'enum: `aws-sns`, `google-pubsub`, `http-post`, `oauth2`, `splunk`'
webhook_wifi_conn_raw:
title: webhook_wifi_conn_raw
required:
- events
- topic
type: object
properties:
events:
minItems: 1
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/webhook_wifi_conn_raw_event'
description: Connected Wi-Fi raw packet events included in this webhook delivery
topic:
const: wifi-conn-raw
type: string
description: 'Webhook topic name for connected Wi-Fi raw packet deliveries. enum: `wifi-conn-raw`.'
description: "Sample of the `wifi-conn-raw` webhook payload.\n\n\nThis webhook topic provides raw data from packets emitted by connected devices.\n\n\nRaw data webhooks are a special subset of webhooks that provide insight into raw data packets emitted by a client,\nidentified by their advertising MAC address (assets, discovered ble, connected wifi, unconnected wifi). \nThe data that client raw data webhooks encompasses are reporting AP information, RSSI Data, and any special packets/telemetry\npackets that the client may emit.\n\nNote that client raw webhooks are the raw data coming from the client and do not contain the X,Y location data of the client.\nIn order to get the location data for a client please see our location webhooks. \nClients can be identified uniquely across these client raw data topics and location webhook topic using MAC address as the Unique identifier (client identifier)."
webhook_wifi_conn_raw_event:
title: webhook_wifi_conn_raw_event
type: object
properties:
ap_id:
type: string
description: AP MAC address that reported the connected client packet
ap_loc:
type: array
items:
type: number
description: Location coordinates of the reporting AP when available, updated about once per minute per client
client_id:
type: string
description: Client MAC address that emitted the connected Wi-Fi packet
connected_site:
type: boolean
description: Whether the client is connected to the reporting site
extended_info_list:
type: array
items:
$ref: '#/components/schemas/webhook_wifi_conn_raw_event_extended_info'
description: Extended telemetry packets decoded from the connected Wi-Fi client payload
map_id:
type: string
description: Map associated with the reporting AP when location context is available
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
org_id:
type: string
description: Organization associated with the connected Wi-Fi raw event
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
packets:
type: array
items:
$ref: '#/components/schemas/webhook_wifi_conn_raw_event_packet'
description: RSSI packet observations reported for the connected Wi-Fi client
site_id:
type: string
description: Site associated with the connected Wi-Fi raw event
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
description: Raw packet observation for a connected Wi-Fi client
webhook_wifi_conn_raw_event_extended_info:
title: webhook_wifi_conn_raw_event_extended_info
type: object
properties:
frame_ctrl:
type: integer
description: IEEE 802.11 frame control value from the telemetry packet
contentEncoding: int32
payload:
type: string
description: Raw telemetry payload carried by the connected Wi-Fi packet
sequence_ctrl:
type: integer
description: IEEE 802.11 sequence control value from the telemetry packet
contentEncoding: int32
description: Extended telemetry details decoded from a connected Wi-Fi packet
webhook_wifi_conn_raw_event_packet:
title: webhook_wifi_conn_raw_event_packet
type: object
properties:
band:
type: string
description: Radio band on which the connected Wi-Fi packet was observed
rssi:
type: integer
description: Received signal strength of the connected Wi-Fi packet at the reporting AP, in dBm
contentEncoding: int32
description: RSSI observation for a connected Wi-Fi client packet
webhook_wifi_conn_raw_topic:
title: webhook_wifi_conn_raw_topic
const: wifi-conn-raw
type: string
description: 'Webhook topic name for connected Wi-Fi raw packet deliveries. enum: `wifi-conn-raw`'
webhook_wifi_unconn_raw:
title: webhook_wifi_unconn_raw
required:
- events
- topic
type: object
properties:
events:
minItems: 1
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/webhook_wifi_unconn_raw_event'
description: Unconnected Wi-Fi raw packet events included in this webhook delivery
topic:
const: wifi-unconn-raw
type: string
description: 'Webhook topic name for unconnected Wi-Fi raw packet deliveries. enum: `wifi-unconn-raw`.'
description: "Sample of the `wifi-unconn-raw` webhook payload.\n\n\nThis webhook topic provides raw data from packets emitted by unconnected devices.\n\n\nRaw data webhooks are a special subset of webhooks that provide insight into raw data packets emitted by a client,\nidentified by their advertising MAC address (assets, discovered ble, connected wifi, unconnected wifi). \nThe data that client raw data webhooks encompasses are reporting AP information, RSSI Data, and any special packets/telemetry\npackets that the client may emit.\n\nNote that client raw webhooks are the raw data coming from the client and do not contain the X,Y location data of the client.\nIn order to get the location data for a client please see our location webhooks. \nClients can be identified uniquely across these client raw data topics and location webhook topic using MAC address as the Unique identifier (client identifier)."
webhook_wifi_unconn_raw_event:
title: webhook_wifi_unconn_raw_event
type: object
properties:
ap_id:
type: string
description: AP MAC address that reported the unconnected client packet
ap_loc:
type: array
items:
type: number
description: Location coordinates of the reporting AP when available, updated about once per minute per client
client_id:
type: string
description: Client MAC address that emitted the unconnected Wi-Fi packet
connected_site:
type: boolean
description: Whether the observed client is connected to the reporting site
map_id:
type: string
description: Map associated with the reporting AP when location context is available
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
org_id:
type: string
description: Organization associated with the unconnected Wi-Fi raw event
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
packets:
type: array
items:
$ref: '#/components/schemas/webhook_wifi_unconn_raw_event_packet'
description: RSSI packet observations reported for the unconnected Wi-Fi client
site_id:
type: string
description: Site associated with the unconnected Wi-Fi raw event
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
description: Raw packet observation for an unconnected Wi-Fi client
webhook_wifi_unconn_raw_event_packet:
title: webhook_wifi_unconn_raw_event_packet
type: object
properties:
band:
type: string
description: Radio band on which the unconnected Wi-Fi packet was observed
rssi:
type: integer
description: Received signal strength of the unconnected Wi-Fi packet at the reporting AP, in dBm
contentEncoding: int32
description: RSSI observation for an unconnected Wi-Fi client packet
webhook_wifi_unconn_raw_topic:
title: webhook_wifi_unconn_raw_topic
const: wifi-unconn-raw
type: string
description: 'Webhook topic name for unconnected Wi-Fi raw packet deliveries. enum: `wifi-unconn-raw`'
webhook_zone:
title: webhook_zone
required:
- events
- topic
type: object
properties:
events:
minItems: 1
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/webhook_zone_event'
description: Zone transition events included in this webhook delivery
topic:
const: zone
type: string
description: Webhook topic name for zone transition deliveries
description: Sample of the `zone` webhook payload.
webhook_zone_event:
title: webhook_zone_event
required:
- map_id
- site_id
- timestamp
- trigger
- type
- zone_id
type: object
properties:
asset_id:
type: string
description: Only if `type`==`asset`. UUID of named asset
contentEncoding: uuid
id:
type: string
description: Only if `type`==`sdk`. UUID of the SDK Client
contentEncoding: uuid
mac:
type: string
description: Client or asset MAC address associated with the zone event
map_id:
type: string
description: Map associated with the zone event
contentEncoding: uuid
name:
type: string
description: Display name of the client or asset, when available
site_id:
type: string
description: Site associated with the zone event
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
timestamp:
type: number
description: Time when the zone transition was reported, in epoch seconds
readOnly: true
trigger:
allOf:
- $ref: '#/components/schemas/webhook_zone_event_trigger1'
- description: 'Whether the client or asset entered or exited the zone. enum: `enter`, `exit`.'
type:
allOf:
- $ref: '#/components/schemas/webhook_zone_event_type1'
- description: 'Client or asset type reported for the zone event. enum: `asset`, `sdk`, `wifi`.'
zone_id:
type: string
description: Zone identifier associated with the event
contentEncoding: uuid
description: Zone enter or exit event for a Wi-Fi client, SDK client, or asset
webhook_zone_event_trigger:
title: webhook_zone_event_trigger
enum:
- enter
- exit
type: string
description: 'Zone transition direction, either enter or exit. enum: `enter`, `exit`'
webhook_zone_event_type:
title: webhook_zone_event_type
enum:
- asset
- sdk
- wifi
type: string
description: 'Type of client. enum: `asset` (BLE Tag), `sdk`, `wifi`'
webhook_zone_topic:
title: webhook_zone_topic
const: zone
type: string
description: 'Webhook topic name for zone transition deliveries. enum: `zone`'
websocket_session:
title: websocket_session
required:
- session
type: object
properties:
session:
type: string
description: Identifier used to correlate output on the WebSocket stream
examples:
- 19e73828-937f-05e6-f709-e29efdb0a82b
description: Response containing the WebSocket session handle for asynchronous command output
websocket_session_with_url:
title: websocket_session_with_url
required:
- session
- url
type: object
properties:
session:
type: string
description: Identifier used to correlate output on the WebSocket stream
examples:
- 19e73828-937f-05e6-f709-e29efdb0a82b
url:
type: string
description: WebSocket URL returned for connecting to this session
examples:
- wss://api-ws.mist.com/ssh?jwt=xxxx
description: Response containing a WebSocket session handle and connection URL
wifi_beacon_extended_info_items:
title: wifi_beacon_extended_info_items
type: object
properties:
frame_ctrl:
type: integer
description: Frame control field of 802.11 header
contentEncoding: int32
payload:
type: string
description: Extended Info Payload associated with frame
seq_ctrl:
type: integer
description: Sequence control field of 802.11 header
contentEncoding: int32
description: Extended Wi-Fi beacon packet metadata with frame and sequence control fields
wired_client_response_device_mac_port_item:
title: wired_client_response_device_mac_port_item
type: object
properties:
device_mac:
minLength: 1
type: string
description: Switch or gateway MAC address for this wired client observation
ip:
type: string
description: Client IP address observed for this port entry
readOnly: true
port_id:
type: string
description: Interface identifier where the wired client was observed
readOnly: true
port_parent:
type: string
description: Parent interface or port group associated with this port entry
start:
type: string
description: Time when this wired client observation began
readOnly: true
vlan:
type: integer
description: Client VLAN identifier observed for this port entry
contentEncoding: int32
readOnly: true
when:
type: string
description: Time when this wired client port entry was recorded
readOnly: true
description: Switch or gateway port observation for a wired client
wlan_airwatch:
title: wlan_airwatch
type: object
properties:
api_key:
type: string
description: API key used to authenticate to the AirWatch service
examples:
- aHhlbGxvYXNkZmFzZGZhc2Rmc2RmCg=="
console_url:
type: string
description: Base console URL of the AirWatch deployment
examples:
- https://hs1.airwatchportals.com
enabled:
type: boolean
description: Whether AirWatch integration is enabled for the WLAN
default: false
password:
type: string
description: AirWatch integration account password for this WLAN
contentEncoding: password
examples:
- user1
username:
type: string
description: AirWatch integration account username for this WLAN
examples:
- test123
description: AirWatch integration settings for the WLAN
wlan_app_limit:
title: wlan_app_limit
type: object
properties:
apps:
type: object
additionalProperties:
type: integer
format: int32
description: "Map from app key to bandwidth in kbps. \nProperty key is the app key, defined in Get Application List"
default: {}
examples:
- dropbox: 300
netflix: 60
enabled:
type: boolean
description: Whether application bandwidth limits are enabled for this WLAN
default: false
wxtag_ids:
type: object
additionalProperties:
type: integer
format: int32
description: Map from wxtag_id of Hostname Wxlan Tags to bandwidth in kbps. Property key is the `wxtag_id`
default: {}
examples:
- f99862d9-2726-931f-7559-3dfdf5d070d3: 30
description: Bandwidth limiting for apps (applies to up/down)
wlan_app_qos:
title: wlan_app_qos
type: object
properties:
apps:
type: object
additionalProperties:
$ref: '#/components/schemas/wlan_app_qos_apps_properties'
description: Map of application keys to QoS rewrite settings
examples:
- skype-business-video:
dscp: 32
dst_subnet: 10.2.0.0/16
src_subnet: 10.2.0.0/16
enabled:
type: boolean
description: Whether application QoS rewrite rules are enabled for this WLAN
default: false
others:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/wlan_app_qos_others_item'
description: Custom traffic QoS rules that are not tied to named applications
description: APP qos wlan settings
wlan_app_qos_apps_properties:
title: wlan_app_qos_apps_properties
type: object
properties:
dscp:
anyOf:
- type: string
- maximum: 63
minimum: 0
type: integer
contentEncoding: int32
description: Differentiated Services Code Point value applied to matching application traffic
dst_subnet:
type: string
description: Subnet filter is not required but helps AP to only inspect certain traffic (thus reducing AP load)
src_subnet:
type: string
description: Subnet filter is not required but helps AP to only inspect certain traffic (thus reducing AP load)
description: QoS rewrite settings for traffic matching a named application
wlan_app_qos_others_item:
title: wlan_app_qos_others_item
type: object
properties:
dscp:
anyOf:
- type: string
- maximum: 63
minimum: 0
type: integer
contentEncoding: int32
description: Differentiated Services Code Point value applied to matching traffic
dst_subnet:
type: string
description: Destination subnet filter for this custom QoS rule
examples:
- 10.2.0.0/16
port_ranges:
type: string
description: TCP or UDP port ranges matched by this custom QoS rule
examples:
- 80,1024-6553
protocol:
type: string
description: IP protocol matched by this custom QoS rule
examples:
- udp
src_subnet:
type: string
description: Source subnet filter for this custom QoS rule
examples:
- 10.2.0.0/16
description: Custom QoS rewrite rule for traffic not matched by a named application
wlan_apply_to:
title: wlan_apply_to
enum:
- aps
- site
- wxtags
type: string
description: 'enum: `aps`, `site`, `wxtags`'
wlan_auth:
title: wlan_auth
required:
- type
type: object
properties:
anticlog_threshold:
maximum: 32
minimum: 16
type: integer
description: SAE anti-clogging token threshold
contentEncoding: int32
default: 16
examples:
- 16
eap_reauth:
type: boolean
description: Whether to trigger EAP reauth when the session ends
default: false
enable_beacon_protection:
type: boolean
description: Enable Beacon Protection; default is false for better compatibility
default: false
enable_gcmp256:
type: boolean
description: Enable GCMP-256 encryption suite; default is false for better compatibility
default: false
enable_mac_auth:
type: boolean
description: Whether to enable MAC Auth, uses the same auth_servers
default: false
key_idx:
maximum: 4
minimum: 1
type: integer
description: When `type`==`wep`, index of the WEP key used as the default transmit key
contentEncoding: int32
default: 1
keys:
type: array
items:
type:
- string
- 'null'
description: When `type`==`wep`, WEP keys configured for this WLAN
default: []
multi_psk_only:
type: boolean
description: When `type`==`psk`, whether to only use multi_psk
default: false
owe:
allOf:
- $ref: '#/components/schemas/wlan_auth_owe2'
- description: 'When `type`==`open`, Opportunistic Wireless Encryption mode for this WLAN. enum: `disabled`, `enabled`, `required`.'
pairwise:
type: array
items:
oneOf:
- {}
- $ref: '#/components/schemas/wlan_auth_pairwise_item'
description: When `type`==`psk` or `type`==`eap`, pairwise cipher suites allowed for this WLAN
private_wlan:
type: boolean
description: When `multi_psk_only`==`true`, whether private wlan is enabled
default: false
psk:
maxLength: 64
minLength: 8
type:
- string
- 'null'
description: When `type`==`psk`, 8-64 characters, or 64 hex characters
examples:
- foryoureyesonly
type:
allOf:
- $ref: '#/components/schemas/wlan_auth_type2'
- description: 'Authentication mode used by this WLAN. enum: `eap`, `eap192`, `open`, `psk`, `psk-tkip`, `psk-wpa2-tkip`, `wep`.'
examples:
- psk
wep_as_secondary_auth:
type: boolean
description: Enable WEP as secondary auth
default: false
description: WLAN client authentication settings
wlan_auth_owe:
title: wlan_auth_owe
enum:
- disabled
- enabled
- required
type: string
description: 'if `type`==`open`. enum: `disabled`, `enabled` (means transition mode), `required`'
wlan_auth_pairwise_item:
title: wlan_auth_pairwise_item
enum:
- wpa1-ccmp
- wpa1-tkip
- wpa2-ccmp
- wpa2-tkip
- wpa3
type: string
description: 'enum: `wpa1-ccmp`, `wpa1-tkip`, `wpa2-ccmp`, `wpa2-tkip`, `wpa3`'
examples:
- wpa3
wlan_auth_server_selection:
title: wlan_auth_server_selection
enum:
- ordered
- unordered
type: string
description: 'When ordered, AP will prefer and go back to the first server if possible. enum: `ordered`, `unordered`'
examples:
- ordered
wlan_auth_type:
title: wlan_auth_type
enum:
- eap
- eap192
- open
- psk
- psk-tkip
- psk-wpa2-tkip
- wep
type: string
description: 'enum: `eap`, `eap192`, `open`, `psk`, `psk-tkip`, `psk-wpa2-tkip`, `wep`'
examples:
- psk
wlan_bonjour:
title: wlan_bonjour
type: object
properties:
additional_vlan_ids:
anyOf:
- type: string
- type: array
items:
$ref: '#/components/schemas/vlan_id_with_variable'
description: VLAN IDs, beyond the client VLAN, where Bonjour queries and responses are forwarded
enabled:
type: boolean
description: Whether to enable bonjour for this WLAN. Once enabled, limit_bcast is assumed true, allow_mdns is assumed false
default: false
services:
type: object
additionalProperties:
$ref: '#/components/schemas/wlan_bonjour_service_properties'
description: "What services are allowed. \nProperty key is the service name"
examples:
- airplay:
radius_groups:
- teachers
scope: same_ap
description: Bonjour gateway wlan settings
wlan_bonjour_service_properties:
title: wlan_bonjour_service_properties
type: object
properties:
disable_local:
type: boolean
description: Whether to prevent wireless clients to discover bonjour devices on the same WLAN
default: false
radius_groups:
type: array
items:
type: string
description: RADIUS groups allowed to discover this Bonjour service, when restricted
scope:
allOf:
- $ref: '#/components/schemas/wlan_bonjour_service_properties_scope2'
- description: 'Discovery scope for this Bonjour service on the WLAN. enum: `same_ap`, `same_map`, `same_site`.'
description: Bonjour service discovery settings for one advertised service
wlan_bonjour_service_properties_scope:
title: wlan_bonjour_service_properties_scope
enum:
- same_ap
- same_map
- same_site
type: string
description: 'how bonjour services should be discovered for the same WLAN. enum: `same_ap`, `same_map`, `same_site`'
wlan_cisco_cwa:
title: wlan_cisco_cwa
type: object
properties:
allowed_hostnames:
type: array
items:
type: string
description: Hostnames allowed for Cisco CWA client access before authorization
allowed_subnets:
type: array
items:
type: string
description: CIDR subnets allowed for Cisco CWA client access before authorization
blocked_subnets:
type: array
items:
type: string
description: CIDR subnets blocked for Cisco CWA client access
enabled:
type: boolean
description: Whether Cisco CWA is enabled for this WLAN
default: false
description: 'Cisco CWA (central web authentication) required RADIUS with COA in order to work. See CWA: https://www.cisco.com/c/en/us/support/docs/security/identity-services-engine/115732-central-web-auth-00.html'
wlan_datarates:
title: wlan_datarates
type: object
properties:
eht:
type:
- string
- 'null'
description: If `template`==`custom`. EHT MCS bitmasks for 4 streams (16-bit for each stream, MCS0 is least significant bit)
examples:
- 3fff0fff0fff03ff
he:
type:
- string
- 'null'
description: If `template`==`custom`. HE MCS bitmasks for 4 streams (16-bit for each stream, MCS0 is least significant bit
examples:
- 0fff0fff0fff0fff
ht:
type:
- string
- 'null'
description: If `template`==`custom`. MCS bitmasks for 4 streams (16-bit for each stream, MCS0 is least significant bit), e.g. 00ff 00f0 001f limits HT rates to MCS 0-7 for 1 stream, MCS 4-7 for 2 stream (i.e. MCS 12-15), MCS 1-5 for 3 stream (i.e. MCS 16-20)
examples:
- 00ff00ff00ff
legacy:
type: array
items:
$ref: '#/components/schemas/wlan_datarates_legacy_item'
description: If `template`==`custom`, legacy 802.11 data rates allowed on this WLAN
examples:
- - '6'
- '9'
- '12'
- '18'
- 24b
- '36'
- '48'
- '54'
min_rssi:
type: integer
description: Minimum RSSI for client to connect, 0 means not enforcing
contentEncoding: int32
default: 0
examples:
- -70
template:
allOf:
- oneOf:
- {}
- $ref: '#/components/schemas/wlan_datarates_template2'
- description: 'Data rate template used to derive WLAN rate settings. enum: `compatible`, `legacy-only`, `custom`, `no-legacy`, `high-density`.'
vht:
type:
- string
- 'null'
description: If `template`==`custom`. MCS bitmasks for 4 streams (16-bit for each stream, MCS0 is least significant bit), e.g. 03ff 01ff 00ff limits VHT rates to MCS 0-9 for 1 stream, MCS 0-8 for 2 streams, and MCS 0-7 for 3 streams.
examples:
- 03ff03ff03ff01ff
description: Data rates wlan settings
wlan_datarates_legacy_item:
title: wlan_datarates_legacy_item
enum:
- '1'
- '11'
- 11b
- '12'
- 12b
- '18'
- 18b
- 1b
- '2'
- '24'
- 24b
- 2b
- '36'
- 36b
- '48'
- 48b
- '5.5'
- 5.5b
- '54'
- 54b
- '6'
- 6b
- '9'
- 9b
type: string
description: 'enum: `1`, `11`, `11b`, `12`, `12b`, `18`, `18b`, `1b`, `2`, `24`, `24b`, `2b`, `36`, `36b`, `48`, `48b`, `5.5`, `5.5b`, `54`, `54b`, `6`, `6b`, `9`, `9b`'
wlan_datarates_template:
title: wlan_datarates_template
enum:
- compatible
- legacy-only
- custom
- no-legacy
- high-density
type: string
description: "Data Rates template to apply. enum: \n * `no-legacy`: no 11b\n * `compatible`: all, like before, default setting that Broadcom/Atheros used\n * `legacy-only`: disable 802.11n and 802.11ac\n * `high-density`: no 11b, no low rates\n * `custom`: user defined"
wlan_dns_server_rewrite:
title: wlan_dns_server_rewrite
type: object
properties:
enabled:
type: boolean
description: Whether DNS server rewrite by RADIUS group is enabled for this WLAN
default: false
radius_groups:
type: object
additionalProperties:
type: string
description: Map between radius_group and the desired DNS server (IPv4 only). Property key is the RADIUS group, property value is the desired DNS Server
examples:
- contractor: 172.1.1.1
guest: 8.8.8.8
description: For radius_group-based DNS server (rewrite DNS request depending on the Group RADIUS server returns)
wlan_dynamic_psk:
title: wlan_dynamic_psk
type: object
properties:
default_psk:
maxLength: 63
minLength: 8
type: string
description: Default PSK to use if cloud WLC is not available, 8-63 characters
examples:
- foryoureyesonly
default_vlan_id:
oneOf:
- type: string
- maximum: 4094
minimum: 1
type: integer
contentEncoding: int32
description: Default VLAN ID used when dynamic PSK lookup does not return a VLAN
enabled:
type: boolean
description: Whether dynamic PSK is enabled for this WLAN
default: false
force_lookup:
type: boolean
description: When 11r is enabled, we'll try to use the cached PMK, this can be disabled. `false` means auto
default: false
local_vlan_ids:
type: array
items:
$ref: '#/components/schemas/vlan_id_with_variable'
description: VLANs to be bridged locally when forwarding to mxtunnel or site mxedge
source:
allOf:
- $ref: '#/components/schemas/dynamic_psk_source1'
- description: 'Origin used to retrieve per-user PSKs. enum: `cloud_psks`, `radius`.'
examples:
- cloud_psks
description: >-
For dynamic PSK where we get per_user PSK from RADIUS. dynamic_psk allows PSK to be selected at runtime depending on context (wlan/site/user/...) thus following configurations are assumed (currently)
* PSK will come from RADIUS server
* AP sends client MAC as username and password (i.e. `enable_mac_auth` is assumed)
* AP sends BSSID:SSID as Caller-Station-ID
* `auth_servers` is required
* PSK will come from cloud WLC if source is cloud_psks
* default_psk will be used if cloud WLC is not available
* `multi_psk_only` and `psk` is ignored
* `pairwise` can only be wpa2-ccmp (for now, wpa3 support on the roadmap)
wlan_dynamic_vlan:
title: wlan_dynamic_vlan
type: object
properties:
default_vlan_id:
oneOf:
- type: string
- maximum: 4094
minimum: 1
type: integer
contentEncoding: int32
default: 999
description: Deprecated default VLAN ID used when no RADIUS VLAN match is returned. Please use `default_vlan_ids` instead, which can support VLAN pools.
deprecated: true
default_vlan_ids:
type: array
items:
$ref: '#/components/schemas/wlan_dynamic_vlan_default_vlan_id'
description: Fallback VLAN IDs, ranges, or variables used when no RADIUS VLAN match is returned
enabled:
type: boolean
description: Requires `vlan_enabled`==`true` to be set to `true`. Whether to enable dynamic vlan
default: false
local_vlan_ids:
type: array
items:
$ref: '#/components/schemas/vlan_id_with_variable'
description: VLAN IDs that should be locally bridged for dynamic VLAN assignment
type:
allOf:
- $ref: '#/components/schemas/wlan_dynamic_vlan_type2'
- description: 'Dynamic VLAN mapping method used for RADIUS-provided VLAN attributes. enum: `airespace-interface-name`, `standard`.'
examples:
- airespace-interface-name
vlans:
type: object
additionalProperties:
type: string
description: >-
Map between vlan_id (as string) to airespace interface names (comma-separated) or null for standard mapping
* if `dynamic_vlan.type`==`standard`, property key is the VLAN ID and property value is \"\"
* if `dynamic_vlan.type`==`airespace-interface-name`, property key is the VLAN ID and property value is the Airespace Interface Name
examples:
- '131': default
'322': fast,video
description: Dynamic VLAN assignment settings for 802.1X WLAN authentication
wlan_dynamic_vlan_type:
title: wlan_dynamic_vlan_type
enum:
- airespace-interface-name
- standard
type: string
description: 'standard (using Tunnel-Private-Group-ID, widely supported), airespace-interface-name (Airespace/Cisco). enum: `airespace-interface-name`, `standard`'
examples:
- airespace-interface-name
wlan_hotspot20_operators_item:
title: wlan_hotspot20_operators_item
enum:
- ameriband
- att
- boingo
- charter
- eduroam
- global_reach
- google
- hughes_systique
- openroaming_legacy
- openroaming_settled
- openroaming_settlement_free
- single_digits
- tmobile
- verizon
type: string
description: 'enum: `ameriband`, `att`, `boingo`, `charter`, `eduroam`, `global_reach`, `google`, `hughes_systique`, `openroaming_legacy`, `openroaming_settled`, `openroaming_settlement_free`, `single_digits`, `tmobile`, `verizon`'
wlan_hotspot_20:
title: wlan_hotspot_20
type: object
properties:
domain_name:
type: array
items:
type: string
description: Advertised domain names for Hotspot 2.0 clients
examples:
- - mist.com
enabled:
type: boolean
description: Whether to enable hotspot 2.0 config
nai_realms:
uniqueItems: true
type: array
items:
type: string
description: NAI realms advertised for Hotspot 2.0 authentication
operators:
type: array
items:
$ref: '#/components/schemas/wlan_hotspot20_operators_item'
description: Operator profiles supported by this Hotspot 2.0 configuration
examples:
- - google
- att
rcoi:
type: array
items:
type: string
description: Roaming Consortium Organization Identifiers advertised for Hotspot 2.0
examples:
- - 5A03BA0000
venue_name:
type: string
description: Venue name, default is site name
examples:
- some_name
description: Hotspot 2.0 WLAN settings
wlan_inject_dhcp_option_82:
title: wlan_inject_dhcp_option_82
type: object
properties:
circuit_id:
type: string
description: >-
Information to set in the `circuit_id` field of the DHCP Option 82. It is possible to use static string or the following variables (e.g. `{{SSID}}:{{AP_MAC}}`):
* {{AP_MAC}}
* {{AP_MAC_DASHED}}
* {{AP_MODEL}}
* {{AP_NAME}}
* {{SITE_NAME}}
* {{SSID}}
examples:
- '{{SSID}}:{{AP_MAC}}'
enabled:
type: boolean
description: Whether to inject option 82 when forwarding DHCP packets
default: false
description: DHCP Option 82 injection settings for a WLAN
wlan_interface:
title: wlan_interface
enum:
- all
- eth0
- eth1
- eth2
- eth3
- mxtunnel
- site_mxedge
- wxtunnel
type: string
description: 'where this WLAN will be connected to. enum: `all`, `eth0`, `eth1`, `eth2`, `eth3`, `mxtunnel`, `site_mxedge`, `wxtunnel`'
examples:
- all
wlan_mist_nac:
title: wlan_mist_nac
type: object
properties:
acct_interim_interval:
maximum: 65535
minimum: 0
type: integer
description: How frequently should interim accounting be reported, 60-65535. default is 0 (use one specified in Access-Accept request from Server). Very frequent messages can affect the performance of the RADIUS server, 600 and up is recommended when enabled.
contentEncoding: int32
default: 0
examples:
- 60
auth_servers_retries:
maximum: 10
minimum: 1
type: integer
description: RADIUS auth session retries. Following fast timers are set if `fast_dot1x_timers` knob is enabled. "retries" are set to value of `auth_servers_timeout`. "max-requests" is also set when setting `auth_servers_retries` is set to default value to 3.
contentEncoding: int32
default: 2
examples:
- 3
auth_servers_timeout:
maximum: 30
minimum: 1
type: integer
description: RADIUS auth session timeout. Following fast timers are set if `fast_dot1x_timers` knob is enabled. "quite-period" and "transmit-period" are set to half the value of `auth_servers_timeout`. "supplicant-timeout" is also set when setting `auth_servers_timeout` is set to default value of 10.
contentEncoding: int32
default: 5
examples:
- 5
coa_enabled:
type: boolean
description: Allows a RADIUS server to dynamically modify the authorization status of a user session.
default: false
coa_port:
maximum: 65535
minimum: 1
type: integer
description: the communication port used for “Change of Authorization” (CoA) messages
contentEncoding: int32
examples:
- 3799
enabled:
type: boolean
description: >-
When enabled:
* `auth_servers` is ignored
* `acct_servers` is ignored
* `auth_servers_*` are ignored
* `coa_servers` is ignored
* `radsec` is ignored
* `coa_enabled` is assumed
default: false
fast_dot1x_timers:
type: boolean
description: If set to true, sets default fast-timers with values calculated from `auth_servers_timeout` and `auth_server_retries`.
default: false
network:
type:
- string
- 'null'
description: Which network the mist nac server resides in
examples:
- default
source_ip:
type:
- string
- 'null'
description: In case there is a static IP for this network, we can specify it using source ip
examples:
- 1.2.3.4
description: Mist NAC RADIUS settings for a WLAN
wlan_portal:
title: wlan_portal
type: object
properties:
allow_wlan_id_roam:
type: boolean
description: Optional if `amazon_enabled`==`true`. Whether to allow guest to connect to other Guest WLANs (with different `WLAN.ssid`) of same org without reauthentication (disable random_mac for seamless roaming)
default: false
amazon_client_id:
type:
- string
- 'null'
description: Optional if `amazon_enabled`==`true`. Amazon OAuth2 client id. This is optional. If not provided, it will use a default one.
amazon_client_secret:
type:
- string
- 'null'
description: Optional if `amazon_enabled`==`true`. Amazon OAuth2 client secret. If amazon_client_id was provided, provide a corresponding value. Else leave blank.
contentEncoding: password
amazon_email_domains:
type: array
items:
type: string
description: Optional if `amazon_enabled`==`true`. Email domains allowed for Amazon-authenticated guest users. If null or empty, any authenticated Amazon email domain is allowed.
default: []
amazon_enabled:
type: boolean
description: Whether amazon is enabled as a login method
default: false
amazon_expire:
type:
- integer
- 'null'
description: Optional if `amazon_enabled`==`true`. Interval for which guest remains authorized using amazon auth (in minutes), if not provided, uses expire`
contentEncoding: int32
auth:
allOf:
- $ref: '#/components/schemas/wlan_portal_auth2'
- description: 'Guest portal login scheme used by the WLAN. enum: `amazon`, `azure`, `email`, `external`, `facebook`, `google`, `microsoft`, `multi`, `none`, `password`, `sms`, `sponsor`, `sso`.'
examples:
- none
azure_client_id:
type:
- string
- 'null'
description: Required if `azure_enabled`==`true`. Azure active directory app client id
azure_client_secret:
type:
- string
- 'null'
description: Required if `azure_enabled`==`true`. Azure active directory app client secret
contentEncoding: password
azure_enabled:
type: boolean
description: Whether Azure Active Directory is enabled as a login method
default: false
azure_expire:
type:
- integer
- 'null'
description: Interval for which guest remains authorized using azure auth (in minutes), if not provided, uses expire`
contentEncoding: int32
azure_tenant_id:
type:
- string
- 'null'
description: Required if `azure_enabled`==`true`. Azure active directory tenant id.
broadnet_password:
type: string
description: Required if `sms_provider`==`broadnet`. Password for the Broadnet SMS provider account
contentEncoding: password
examples:
- password
broadnet_sid:
type: string
description: Required if `sms_provider`==`broadnet`. SID for the Broadnet SMS provider account
examples:
- MIST
broadnet_user_id:
type: string
description: Required if `sms_provider`==`broadnet`. User ID for the Broadnet SMS provider account
examples:
- juniper
bypass_when_cloud_down:
type: boolean
description: Whether to bypass the guest portal when cloud not reachable (and apply the default policies)
default: false
clickatell_api_key:
type: string
description: Required if `sms_provider`==`clickatell`. API key for the Clickatell SMS provider account
cross_site:
type: boolean
description: Whether to allow guest to roam between WLANs (with same `WLAN.ssid`, regardless of variables) of different sites of same org without reauthentication (disable random_mac for seamless roaming)
default: false
email_enabled:
type: boolean
description: Whether email (access code verification) is enabled as a login method
default: false
enabled:
type: boolean
description: Whether guest portal is enabled
default: false
expire:
type: integer
description: How long to remain authorized, in minutes
contentEncoding: int32
default: 1440
examples:
- 1440
external_portal_url:
type: string
description: Required if `wlan_portal_auth`==`external`. External portal URL (e.g. https://host/url) where we can append our query parameters to
facebook_client_id:
type:
- string
- 'null'
description: Required if `facebook_enabled`==`true`. Facebook OAuth2 app id. This is optional. If not provided, it will use a default one.
facebook_client_secret:
type:
- string
- 'null'
description: Required if `facebook_enabled`==`true`. Facebook OAuth2 app secret. If facebook_client_id was provided, provide a corresponding value. Else leave blank.
contentEncoding: password
facebook_email_domains:
type: array
items:
type: string
description: Optional if `facebook_enabled`==`true`. Email domains allowed for Facebook-authenticated guest users. If null or empty, any authenticated Facebook email domain is allowed.
default: []
facebook_enabled:
type: boolean
description: Whether facebook is enabled as a login method
default: false
facebook_expire:
type:
- integer
- 'null'
description: Optional if `facebook_enabled`==`true`. Interval for which guest remains authorized using facebook auth (in minutes), if not provided, uses expire`
contentEncoding: int32
forward:
type: boolean
description: Whether to forward the user to another URL after authorized
default: false
forward_url:
type:
- string
- 'null'
description: URL to forward the user to
examples:
- https://abc.com/promotions
google_client_id:
type:
- string
- 'null'
description: Google OAuth2 app id. This is optional. If not provided, it will use a default one.
google_client_secret:
type:
- string
- 'null'
description: Optional if `google_enabled`==`true`. Google OAuth2 app secret. If google_client_id was provided, provide a corresponding value. Else leave blank.
contentEncoding: password
google_email_domains:
type: array
items:
type: string
description: Optional if `google_enabled`==`true`. Email domains allowed for Google-authenticated guest users. If null or empty, any authenticated Google email domain is allowed.
default: []
examples:
- - mydomain.edu
- mydomain.org
google_enabled:
type: boolean
description: Whether Google is enabled as login method
default: false
google_expire:
type:
- integer
- 'null'
description: Optional if `google_enabled`==`true`. Interval for which guest remains authorized using Google Auth (in minutes), if not provided, uses expire`
contentEncoding: int32
gupshup_password:
type: string
description: Required if `sms_provider`==`gupshup`. Password for the Gupshup SMS provider account
contentEncoding: password
gupshup_userid:
type: string
description: Required if `sms_provider`==`gupshup`. User ID for the Gupshup SMS provider account
microsoft_client_id:
type:
- string
- 'null'
description: Optional if `microsoft_enabled`==`true`. Microsoft 365 OAuth2 client id. This is optional. If not provided, it will use a default one.
microsoft_client_secret:
type:
- string
- 'null'
description: Optional if `microsoft_enabled`==`true`. Microsoft 365 OAuth2 client secret. If microsoft_client_id was provided, provide a corresponding value. Else leave blank.
contentEncoding: password
microsoft_email_domains:
type: array
items:
type: string
description: Optional if `microsoft_enabled`==`true`. Email domains allowed for Microsoft 365-authenticated guest users. If null or empty, any authenticated Microsoft 365 email domain is allowed.
default: []
microsoft_enabled:
type: boolean
description: Whether microsoft 365 is enabled as a login method
default: false
microsoft_expire:
type:
- integer
- 'null'
description: Optional if `microsoft_enabled`==`true`. Interval for which guest remains authorized using microsoft auth (in minutes), if not provided, uses expire`
contentEncoding: int32
passphrase_enabled:
type: boolean
description: Whether password is enabled
default: false
passphrase_expire:
type:
- integer
- 'null'
description: Optional if `passphrase_enabled`==`true`. Interval for which guest remains authorized using passphrase auth (in minutes), if not provided, uses `expire`
contentEncoding: int32
password:
type:
- string
- 'null'
description: Required if `passphrase_enabled`==`true`. Passphrase guests must enter when passphrase authentication is enabled
examples:
- let me in
predefined_sponsors_enabled:
type: boolean
description: Whether to show list of sponsor emails mentioned in `sponsors` object as a dropdown. If both `sponsor_notify_all` and `predefined_sponsors_enabled` are false, behavior is acc to `sponsor_email_domains`
default: true
predefined_sponsors_hide_email:
type: boolean
description: Whether to hide sponsor’s email from list of sponsors
default: false
privacy:
type: boolean
description: Whether to show the privacy policy in the WLAN guest portal
default: false
puzzel_password:
type: string
description: Required if `sms_provider`==`puzzel`. Password for the Puzzel SMS provider account
contentEncoding: password
puzzel_service_id:
type: string
description: Required if `sms_provider`==`puzzel`. Service ID for the Puzzel SMS provider account
puzzel_username:
type: string
description: Required if `sms_provider`==`puzzel`. Username for the Puzzel SMS provider account
smsMessageFormat:
type: string
description: Optional if `sms_enabled`==`true`. SMS Message format
default: Code {{code}} expires in {{duration}} minutes.
sms_enabled:
type: boolean
description: Whether sms is enabled as a login method
default: false
sms_expire:
type:
- integer
- 'null'
description: Optional if `sms_enabled`==`true`. Interval for which guest remains authorized using sms auth (in minutes), if not provided, uses expire`
contentEncoding: int32
sms_provider:
allOf:
- $ref: '#/components/schemas/wlan_portal_sms_provider2'
- description: 'Optional if `sms_enabled`==`true`. SMS provider used to deliver guest portal access codes. enum: `broadnet`, `clickatell`, `gupshup`, `manual`, `puzzel`, `telstra`, `twilio`, `smsglobal`.'
examples:
- twilio
smsglobal_api_key:
type: string
description: Required if `sms_provider`==`smsglobal`, Client API Key
smsglobal_api_secret:
type: string
description: Required if `sms_provider`==`smsglobal`, Client secret
contentEncoding: password
smsglobal_sender:
type: string
description: Optional sender's number or sender ID for SMSGlobal. If not provided, uses the default number associated with the account
sponsor_auto_approve:
type: boolean
description: Optional if `sponsor_enabled`==`true`. Whether to automatically approve guest and allow sponsor to revoke guest access, needs predefined_sponsors_enabled enabled and sponsor_notify_all disabled
default: false
sponsor_email_domains:
type: array
items:
type: string
description: Email domains allowed for sponsor email addresses. Required if `sponsor_enabled` is `true` and `sponsors` is empty.
examples:
- - reserved.net
- reserved.org
sponsor_enabled:
type: boolean
description: Whether sponsor is enabled
default: false
sponsor_expire:
type:
- integer
- 'null'
description: Optional if `sponsor_enabled`==`true`. Interval for which guest remains authorized using sponsor auth (in minutes), if not provided, uses expire`
contentEncoding: int32
sponsor_link_validity_duration:
anyOf:
- maximum: 60
minimum: 5
type: integer
contentEncoding: int32
default: 60
- type: string
description: Optional if `sponsor_enabled`==`true`. Validity duration, in minutes, for approve or deny links in sponsor emails. Valid values are 5 to 60.
sponsor_notify_all:
type: boolean
description: Optional if `sponsor_enabled`==`true`. whether to notify all sponsors that are mentioned in `sponsors` object. Both `sponsor_notify_all` and `predefined_sponsors_enabled` should be true in order to notify sponsors. If true, email sent to 10 sponsors in no particular order.
default: false
sponsor_status_notify:
type: boolean
description: Optional if `sponsor_enabled`==`true`. If enabled, guest will get email about sponsor's action (approve/deny)
default: false
sponsors:
oneOf:
- type: array
items:
type: string
- type: object
additionalProperties:
type: string
examples:
- sponsor1@company.com: FirstName1 LastName1
sponsor2@company.com: FirstName2 LastName2
description: Allowed sponsor email addresses and display names. Required if `sponsor_enabled` is `true` and `sponsor_email_domains` is empty.
sso_default_role:
type: string
description: Optional if `wlan_portal_auth`==`sso`, default role to assign if there’s no match. By default, an assertion is treated as invalid when there’s no role matched
sso_forced_role:
type: string
description: Optional if `wlan_portal_auth`==`sso`. Role assigned to authenticated users when guest SSO is used
sso_idp_cert:
type: string
description: Required if `wlan_portal_auth`==`sso`. IDP Cert (used to verify the signed response)
sso_idp_sign_algo:
allOf:
- $ref: '#/components/schemas/wlan_portal_idp_sign_algo2'
- description: 'Optional if `wlan_portal_auth`==`sso`. Signing algorithm used for SAML assertions from the identity provider. enum: `sha1`, `sha256`, `sha384`, `sha512`.'
sso_idp_sso_url:
type: string
description: Required if `wlan_portal_auth`==`sso`, IDP Single-Sign-On URL
sso_issuer:
type: string
description: Required if `wlan_portal_auth`==`sso`, IDP issuer URL
sso_nameid_format:
allOf:
- $ref: '#/components/schemas/wlan_portal_sso_nameid_format2'
- description: 'Optional if `wlan_portal_auth`==`sso`. SAML NameID format expected from the identity provider. enum: `email`, `unspecified`.'
telstra_client_id:
type: string
description: Required if `sms_provider`==`telstra`, Client ID provided by Telstra
telstra_client_secret:
type: string
description: Required if `sms_provider`==`telstra`, Client secret provided by Telstra
contentEncoding: password
twilio_auth_token:
type:
- string
- 'null'
description: Required if `sms_provider`==`twilio`, Auth token account with twilio account
contentEncoding: password
examples:
- af9dac44c344a875ab5d31cb7abcdefg
twilio_phone_number:
type:
- string
- 'null'
description: Required if `sms_provider`==`twilio`, Twilio phone number associated with the account. See example for accepted format.
examples:
- '+18548888888'
twilio_sid:
type:
- string
- 'null'
description: Required if `sms_provider`==`twilio`, Account SID provided by Twilio
examples:
- af9dac44c344a875ab5d31cb7abcdefg
description: Guest portal settings for the WLAN
wlan_portal_auth:
title: wlan_portal_auth
enum:
- amazon
- azure
- email
- external
- facebook
- google
- microsoft
- multi
- none
- password
- sms
- sponsor
- sso
type: string
description: 'authentication scheme. enum: `amazon`, `azure`, `email`, `external`, `facebook`, `google`, `microsoft`, `multi`, `none`, `password`, `sms`, `sponsor`, `sso`'
examples:
- none
wlan_portal_idp_sign_algo:
title: wlan_portal_idp_sign_algo
enum:
- sha1
- sha256
- sha384
- sha512
type: string
description: 'Optional if `wlan_portal_auth`==`sso`, Signing algorithm for SAML Assertion. enum: `sha1`, `sha256`, `sha384`, `sha512`'
wlan_portal_sms_provider:
title: wlan_portal_sms_provider
enum:
- broadnet
- clickatell
- gupshup
- manual
- puzzel
- telstra
- twilio
- smsglobal
type: string
description: 'Optional if `sms_enabled`==`true`. enum: `broadnet`, `clickatell`, `gupshup`, `manual`, `puzzel`, `smsglobal`, `telstra`, `twilio`'
examples:
- twilio
wlan_portal_sso_nameid_format:
title: wlan_portal_sso_nameid_format
enum:
- email
- unspecified
type: string
description: 'Optional if `wlan_portal_auth`==`sso`. enum: `email`, `unspecified`'
wlan_portal_template:
title: wlan_portal_template
type: object
properties:
portal_template:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting2'
- description: Template settings that define guest portal text, layout, and localization
description: Guest portal template payload for a WLAN
wlan_portal_template_setting:
title: wlan_portal_template_setting
required:
- pageTitle
type: object
properties:
accessCodeAlternateEmail:
type: string
description: Link text for using an alternate email address during access-code login
default: Use alternate email address
alignment:
allOf:
- $ref: '#/components/schemas/portal_template_alignment3'
- description: 'Text and content alignment used by the guest portal template. enum: `center`, `left`, `right`.'
ar:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale36'
- description: Localized portal template strings for Arabic
authButtonAmazon:
type: string
description: Label for Amazon auth button
default: Sign in with Amazon
authButtonAzure:
type: string
description: Label for Azure auth button
default: Sign in with Azure
authButtonEmail:
type: string
description: Label for Email auth button
default: Sign in with Email
authButtonFacebook:
type: string
description: Label for Facebook auth button
default: Sign in with Facebook
authButtonGoogle:
type: string
description: Label for Google auth button
default: Sign in with Google
authButtonMicrosoft:
type: string
description: Label for Microsoft auth button
default: Sign in with Microsoft
authButtonPassphrase:
type: string
description: Label for passphrase auth button
default: Sign in with Passphrase
authButtonSms:
type: string
description: Label for SMS auth button
default: Sign in with Text Message
authButtonSponsor:
type: string
description: Label for Sponsor auth button
default: Sign in as Guest
authLabel:
type: string
description: Heading text displayed above portal authentication options
default: Connect to Wi-Fi with
backLink:
type: string
description: Label of the link to go back to /logon
ca-ES:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale1'
- description: Localized portal template strings for Catalan in Spain
color:
type: string
description: Primary color used by the portal template
default: '#1074bc'
colorDark:
type: string
description: Darker accent color used by the portal template
default: '#0b5183'
colorLight:
type: string
description: Lighter accent color used by the portal template
default: '#3589c6'
company:
type: boolean
description: Whether company field is required
default: false
companyError:
type: string
description: Error message when company not provided
default: Please provide your company name
companyLabel:
type: string
description: Label displayed for the company input field
default: Company
cs-CZ:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale2'
- description: Localized portal template strings for Czech in Czechia
da-DK:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale3'
- description: Localized portal template strings for Danish in Denmark
de-DE:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale4'
- description: Localized portal template strings for German in Germany
el-GR:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale5'
- description: Localized portal template strings for Greek in Greece
email:
type: boolean
description: Whether email field is required
default: false
emailAccessDomainError:
type: string
description: Error message when a user has valid social login but doesn't match specified email domains.
default: Email Access Domain Error
emailCancel:
type: string
description: Label for cancel confirmation code submission using email auth
default: Cancel
emailCodeCancel:
type: string
description: Link text for requesting help when the email access code was not received
default: I did not receive the code
emailCodeError:
type: string
description: Error message shown when the alternate email address for access-code delivery is invalid
default: Please provide valid alternate email
emailCodeFieldLabel:
type: string
description: Label for the email access-code input field
default: Access Code
emailCodeMessage:
type: string
description: Instructional text shown before entering the email access code
default: Enter the access number that was sent to your email address.
emailCodeSubmit:
type: string
description: Button label for submitting the email access code
default: Sign In
emailCodeTitle:
type: string
description: Title shown on the email access-code entry page
default: Access Code
emailError:
type: string
description: Error message when email not provided
default: Please provide valid email
emailFieldLabel:
type: string
description: Label for the email address input field
default: Enter your email address
emailLabel:
type: string
description: Label displayed for the email input field
default: Email
emailMessage:
type: string
description: Instructional text explaining email access-code delivery
default: We will email you an authentication code which you can use to connect to the Wi-Fi network.
emailSubmit:
type: string
description: Label for confirmation code submit button using email auth
default: Send Access Code
emailTitle:
type: string
description: Title for the Email registration
default: Sign in with Email
en-GB:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale6'
- description: Localized portal template strings for English in the United Kingdom
en-US:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale7'
- description: Localized portal template strings for English in the United States
es-ES:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale8'
- description: Localized portal template strings for Spanish in Spain
fi-FI:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale9'
- description: Localized portal template strings for Finnish in Finland
field1:
type: boolean
description: Whether to ask field1
default: false
field1Error:
type: string
description: Error message when field1 not provided
default: Please provide Custom Field 1
field1Label:
type: string
description: Label for custom field 1 input
default: Custom Field 1
field1Required:
type: boolean
description: Whether custom field 1 must be provided when the field is shown
field2:
type: boolean
description: Whether to ask field2
default: false
field2Error:
type: string
description: Error message when field2 not provided
default: Please provide Custom Field 2
field2Label:
type: string
description: Label for custom field 2 input
default: Custom Field 2
field2Required:
type: boolean
description: Whether custom field 2 must be provided when the field is shown
field3:
type: boolean
description: Whether to ask field3
default: false
field3Error:
type: string
description: Error message when field3 not provided
default: Please provide Custom Field 3
field3Label:
type: string
description: Label for custom field 3 input
default: Custom Field 3
field3Required:
type: boolean
description: Whether custom field 3 must be provided when the field is shown
field4:
type: boolean
description: Whether to ask field4
default: false
field4Error:
type: string
description: Error message when field4 not provided
default: Please provide Custom Field 4
field4Label:
type: string
description: Label for custom field 4 input
default: Custom Field 4
field4Required:
type: boolean
description: Whether custom field 4 must be provided when the field is shown
fr-FR:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale10'
- description: Localized portal template strings for French in France
he-IL:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale11'
- description: Localized portal template strings for Hebrew in Israel
hi-IN:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale12'
- description: Localized portal template strings for Hindi in India
hr-HR:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale13'
- description: Localized portal template strings for Croatian in Croatia
hu-HU:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale14'
- description: Localized portal template strings for Hungarian in Hungary
id-ID:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale15'
- description: Localized portal template strings for Indonesian in Indonesia
it-IT:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale16'
- description: Localized portal template strings for Italian in Italy
ja-JP:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale17'
- description: Localized portal template strings for Japanese in Japan
ko-KR:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale18'
- description: Localized portal template strings for Korean in Korea
logo:
type:
- string
- 'null'
description: Custom logo with `data:image/png;base64,` format, default null, uses Juniper Mist Logo. File size must be less than 100kB and image dimensions must be less than 500px x 200px (width x height).
examples:
- data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAZg…
logoHeight:
maximum: 200
minimum: 0
type: integer
description: Height of the logo, in px
contentEncoding: int32
examples:
- 123
logoWidth:
maximum: 500
minimum: 0
type: integer
description: Width of the logo, in px
contentEncoding: int32
examples:
- 408
marketingPolicyLink:
type: string
description: label of the link to go to /marketing_policy
default: Marketing Policy
marketingPolicyOptIn:
type: boolean
description: Whether marketing policy optin is enabled
default: false
marketingPolicyOptInLabel:
type: string
description: label for marketing optin
default: I wish to receive Marketing notifications
marketingPolicyOptInText:
type: string
description: Text of the marketing policy opt-in content
default: Marketing policy content
message:
type: string
description: Main message displayed on the guest portal sign-in page
default: Sign in to get online
ms-MY:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale19'
- description: Localized portal template strings for Malay in Malaysia
multiAuth:
type: boolean
description: Whether the portal presents multiple authentication methods
default: false
name:
type: boolean
description: Whether name field is required
default: false
nameError:
type: string
description: Error message when name not provided
default: Please provide your name
nameLabel:
type: string
description: Label displayed for the name input field
default: Name
nb-NO:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale20'
- description: Localized portal template strings for Norwegian Bokmal in Norway
nl-NL:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale21'
- description: Localized portal template strings for Dutch in the Netherlands
optOutDefault:
type: boolean
description: Default value for the `Do not store` checkbox
default: true
optout:
type: boolean
description: Whether to display Do Not Store My Personal Information
default: false
optoutLabel:
type: string
description: Label for Do Not Store My Personal Information
default: Do not store
pageTitle:
type: string
description: Browser or page title shown for the guest portal
passphraseCancel:
type: string
description: Label for the Passphrase cancel button
default: Cancel
passphraseError:
type: string
description: Error message when invalid passphrase is provided
default: Invalid Passphrase
passphraseLabel:
type: string
description: Label for the passphrase input field
default: Passphrase
passphraseMessage:
type: string
description: Instructional text shown on the passphrase sign-in page
default: Enter the secret passphrase to access the Wi-Fi network.
passphraseSubmit:
type: string
description: Label for the Passphrase submit button
default: Sign in
passphraseTitle:
type: string
description: Title for passphrase details page
default: Sign in with Passphrase
pl-PL:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale22'
- description: Localized portal template strings for Polish in Poland
poweredBy:
type: boolean
description: Whether to show \"Powered by Mist\"
default: true
privacy:
type: boolean
description: Whether to require the Privacy Term acceptance
default: false
privacyPolicyAcceptLabel:
type: string
description: Prefix of the label of the link to go to Privacy Policy
default: I accept the Privacy Terms
privacyPolicyError:
type: string
description: Error message when Privacy Policy not accepted
default: Please review and accept the Privacy Terms
privacyPolicyLink:
type: string
description: Label of the link to go to Privacy Policy
default: Privacy Terms
privacyPolicyText:
type: string
description: Text of the Privacy Policy
default: << provide your Privacy Terms here >>
pt-BR:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale23'
- description: Localized portal template strings for Portuguese in Brazil
pt-PT:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale24'
- description: Localized portal template strings for Portuguese in Portugal
requiredFieldLabel:
type: string
description: Text used to mark a form field as required
default: required
responsiveLayout:
type: boolean
description: Whether the portal template uses a responsive layout
default: true
ro-RO:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale25'
- description: Localized portal template strings for Romanian in Romania
ru-RU:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale26'
- description: Localized portal template strings for Russian in Russia
signInLabel:
type: string
description: Label of the button to signin
default: Sign In
sk-SK:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale27'
- description: Localized portal template strings for Slovak in Slovakia
smsCarrierDefault:
type: string
description: Default option text shown in the SMS carrier selector
default: Please Select
smsCarrierError:
type: string
description: Error message shown when no mobile carrier is selected
default: Please select a mobile carrier
smsCarrierFieldLabel:
type: string
description: Label for mobile carrier drop-down list
default: Mobile Carrier
smsCodeCancel:
type: string
description: Label for cancel confirmation code submission
default: I did not receive the code
smsCodeError:
type: string
description: Error message when confirmation code is invalid
default: Invalid Access Code
smsCodeFieldLabel:
type: string
description: Label for the SMS confirmation-code input field
default: Confirmation Code
smsCodeMessage:
type: string
description: Instructional text shown before entering the SMS access code
default: Enter the access number that was sent to your mobile number.
smsCodeSubmit:
type: string
description: Label for confirmation code submit button
default: Sign In
smsCodeTitle:
type: string
description: Title shown on the SMS access-code entry page
default: Access Code
smsCountryFieldLabel:
type: string
description: Label for the SMS country-code input field
default: Country Code
smsCountryFormat:
type: string
description: Example country code format shown for SMS authentication
default: '+1'
smsHaveAccessCode:
type: string
description: Label for checkbox to specify that the user has access code
default: I have an access code
smsIsTwilio:
type: boolean
description: Whether the SMS portal flow uses Twilio-specific behavior
default: false
smsMessageFormat:
type: string
description: Format of access code sms message. {{code}} and {{duration}} are placeholders and should be retained as is.
smsNumberCancel:
type: string
description: Label for canceling mobile details for SMS auth
default: Cancel
smsNumberError:
type: string
description: Error message shown when the mobile number is invalid
default: Invalid Mobile Number
smsNumberFieldLabel:
type: string
description: Label for field to provide mobile number
default: Mobile Number
smsNumberFormat:
type: string
description: Example mobile number format shown for SMS authentication
default: 2125551212 (digits only)
smsNumberMessage:
type: string
description: Instructional text explaining SMS access-code delivery
default: We will send an access code to your mobile number which you can use to connect to the Wi-Fi network. Message and data rates may apply.
smsNumberSubmit:
type: string
description: Label for submit button for code generation
default: Send Access Code
smsNumberTitle:
type: string
description: Title for phone number details
default: Sign in with Text Message
smsUsernameFormat:
type: string
description: Example username format shown for SMS authentication
default: username
smsValidityDuration:
maximum: 30
minimum: 1
type: integer
description: How long confirmation code should be considered valid (in minutes)
contentEncoding: int32
sponsorBackLink:
type: string
description: Link text for returning to edit the sponsor request form
default: Go back and edit request form
sponsorCancel:
type: string
description: Button label for canceling sponsor authentication
default: Cancel
sponsorEmail:
type: string
description: Label for Sponsor Email
default: Sponsor Email
sponsorEmailError:
type: string
description: Error message shown when the sponsor email address is invalid
default: Please provide valid sponsor email
sponsorEmailTemplate:
type: string
description: "HTML template to replace/override default sponsor email template \nSponsor Email Template supports following template variables:\n * `approve_url`: Renders URL to approve the request; optionally &minutes=N query param can be appended to change the Authorization period of the guest, where N is a valid integer denoting number of minutes a guest remains authorized\n * `deny_url`: Renders URL to reject the request\n * `guest_email`: Renders Email ID of the guest\n * `guest_name`: Renders Name of the guest\n * `field1`: Renders value of the Custom Field 1\n * `field2`: Renders value of the Custom Field 2\n * `sponsor_link_validity_duration`: Renders validity time of the request (i.e. Approve/Deny URL)\n * `auth_expire_minutes`: Renders Wlan-level configured Guest Authorization Expiration time period (in minutes), If not configured then default (1 day in minutes)"
sponsorInfoApproved:
type: string
description: Status message prefix shown when a sponsor approves the request
default: Your request was approved by
sponsorInfoDenied:
type: string
description: Status message prefix shown when a sponsor denies the request
default: Your request was denied by
sponsorInfoPending:
type: string
description: Status message prefix shown after a sponsor notification is sent
default: Your notification has been sent to
sponsorName:
type: string
description: Label for Sponsor Name
default: Sponsor Name
sponsorNameError:
type: string
description: Error message shown when the sponsor name is missing
default: Please provide sponsor name
sponsorNotePending:
type: string
description: Additional status text shown while sponsor approval is pending
default: Please wait for them to acknowledge.
sponsorRequestAccess:
type: string
description: Submit button label request Wifi Access and notify sponsor about guest request
default: Request Wi-Fi Access
sponsorStatusApproved:
type: string
description: Text to display if sponsor approves request
default: Your request was approved
sponsorStatusDenied:
type: string
description: Text to display when sponsor denies request
default: Your request was denied
sponsorStatusPending:
type: string
description: Text to display if request is still pending
default: Notification Sent
sponsorSubmit:
type: string
description: Submit button label to notify sponsor about guest request
default: Request Wi-Fi Access
sponsorsError:
type: string
description: Error message shown when no sponsor is selected
default: Please select a sponsor
sponsorsFieldLabel:
type: string
description: Label for the sponsor selection field
default: Sponsors
sv-SE:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale28'
- description: Localized portal template strings for Swedish in Sweden
th-TH:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale29'
- description: Localized portal template strings for Thai in Thailand
tos:
type: boolean
description: Whether the portal requires Terms of Service acceptance
default: true
tosAcceptLabel:
type: string
description: Prefix of the label of the link to go to tos
default: I accept the Terms of Service
tosError:
type: string
description: Error message when tos not accepted
default: Please review and accept the Terms of Service
tosLink:
type: string
description: Label of the link to go to tos
default: Terms of Service
tosText:
type: string
description: Text of the Terms of Service
default: << provide your Terms of Service here >>
tr-TR:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale30'
- description: Localized portal template strings for Turkish in Turkey
uk-UA:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale31'
- description: Localized portal template strings for Ukrainian in Ukraine
vi-VN:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale32'
- description: Localized portal template strings for Vietnamese in Vietnam
zh-Hans:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale33'
- description: Localized portal template strings for Simplified Chinese
zh-Hant:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale34'
- description: Localized portal template strings for Traditional Chinese
description: Portal template settings for the WLAN guest portal
wlan_portal_template_setting_locale:
title: wlan_portal_template_setting_locale
type: object
properties:
authButtonAmazon:
type: string
description: Label for Amazon auth button
authButtonAzure:
type: string
description: Label for Azure auth button
authButtonEmail:
type: string
description: Label for Email auth button
authButtonFacebook:
type: string
description: Label for Facebook auth button
authButtonGoogle:
type: string
description: Label for Google auth button
authButtonMicrosoft:
type: string
description: Label for Microsoft auth button
authButtonPassphrase:
type: string
description: Label for passphrase auth button
authButtonSms:
type: string
description: Label for SMS auth button
authButtonSponsor:
type: string
description: Label for Sponsor auth button
authLabel:
type: string
description: Localized heading text displayed above portal authentication options
backLink:
type: string
description: Label of the link to go back to /logon
companyError:
type: string
description: Error message when company not provided
companyLabel:
type: string
description: Localized label displayed for the company input field
emailAccessDomainError:
type: string
description: Error message when a user has valid social login but doesn't match specified email domains.
emailCancel:
type: string
description: Label for cancel confirmation code submission using email auth
emailCodeCancel:
type: string
description: Localized link text for requesting help when the email access code was not received
emailCodeError:
type: string
description: Localized error message shown when the alternate email address for access-code delivery is invalid
emailCodeFieldLabel:
type: string
description: Localized label for the email access-code input field
emailCodeMessage:
type: string
description: Localized instructional text shown before entering the email access code
emailCodeSubmit:
type: string
description: Localized button label for submitting the email access code
emailCodeTitle:
type: string
description: Localized title shown on the email access-code entry page
emailError:
type: string
description: Error message when email not provided
emailFieldLabel:
type: string
description: Localized label for the email address input field
emailLabel:
type: string
description: Localized label displayed for the email input field
emailMessage:
type: string
description: Localized instructional text explaining email access-code delivery
emailSubmit:
type: string
description: Label for confirmation code submit button using email auth
emailTitle:
type: string
description: Title for the Email registration
field1Error:
type: string
description: Error message when field1 not provided
field1Label:
type: string
description: Localized label for custom field 1 input
field2Error:
type: string
description: Error message when field2 not provided
field2Label:
type: string
description: Localized label for custom field 2 input
field3Error:
type: string
description: Error message when field3 not provided
field3Label:
type: string
description: Localized label for custom field 3 input
field4Error:
type: string
description: Error message when field4 not provided
field4Label:
type: string
description: Localized label for custom field 4 input
marketingPolicyLink:
type: string
description: label of the link to go to /marketing_policy
marketingPolicyOptIn:
type: boolean
description: Whether marketing policy optin is enabled
marketingPolicyOptInLabel:
type: string
description: label for marketing optin
marketingPolicyOptInText:
type: string
description: Localized text of the marketing policy opt-in content
message:
type: string
description: Localized main message displayed on the guest portal sign-in page
nameError:
type: string
description: Error message when name not provided
nameLabel:
type: string
description: Localized label displayed for the name input field
optoutLabel:
type: string
description: Label for Do Not Store My Personal Information
pageTitle:
type: string
description: Localized browser or page title shown for the guest portal
passphraseCancel:
type: string
description: Label for the Passphrase cancel button
passphraseError:
type: string
description: Error message when invalid passphrase is provided
passphraseLabel:
type: string
description: Localized label for the passphrase input field
passphraseMessage:
type: string
description: Localized instructional text shown on the passphrase sign-in page
passphraseSubmit:
type: string
description: Label for the Passphrase submit button
passphraseTitle:
type: string
description: Title for passphrase details page
privacyPolicyAcceptLabel:
type: string
description: Prefix of the label of the link to go to Privacy Policy
privacyPolicyError:
type: string
description: Error message when Privacy Policy not accepted
privacyPolicyLink:
type: string
description: Label of the link to go to Privacy Policy
privacyPolicyText:
type: string
description: Text of the Privacy Policy
requiredFieldLabel:
type: string
description: Localized text used to mark a form field as required
signInLabel:
type: string
description: Label of the button to signin
smsCarrierDefault:
type: string
description: Localized default option text shown in the SMS carrier selector
smsCarrierError:
type: string
description: Localized error message shown when no mobile carrier is selected
smsCarrierFieldLabel:
type: string
description: Label for mobile carrier drop-down list
smsCodeCancel:
type: string
description: Label for cancel confirmation code submission
smsCodeError:
type: string
description: Error message when confirmation code is invalid
smsCodeFieldLabel:
type: string
description: Localized label for the SMS confirmation-code input field
smsCodeMessage:
type: string
description: Localized instructional text shown before entering the SMS access code
smsCodeSubmit:
type: string
description: Label for confirmation code submit button
smsCodeTitle:
type: string
description: Localized title shown on the SMS access-code entry page
smsCountryFieldLabel:
type: string
description: Localized label for the SMS country-code input field
smsCountryFormat:
type: string
description: Localized example country code format shown for SMS authentication
smsHaveAccessCode:
type: string
description: Label for checkbox to specify that the user has access code
smsMessageFormat:
type: string
description: Format of access code sms message. {{code}} and {{duration}} are placeholders and should be retained as is.
smsNumberCancel:
type: string
description: Label for canceling mobile details for SMS auth
smsNumberError:
type: string
description: Localized error message shown when the mobile number is invalid
smsNumberFieldLabel:
type: string
description: Label for field to provide mobile number
smsNumberFormat:
type: string
description: Localized example mobile number format shown for SMS authentication
smsNumberMessage:
type: string
description: Localized instructional text explaining SMS access-code delivery
smsNumberSubmit:
type: string
description: Label for submit button for code generation
smsNumberTitle:
type: string
description: Title for phone number details
smsUsernameFormat:
type: string
description: Localized example username format shown for SMS authentication
sponsorBackLink:
type: string
description: Localized link text for returning to edit the sponsor request form
sponsorCancel:
type: string
description: Localized button label for canceling sponsor authentication
sponsorEmail:
type: string
description: Label for Sponsor Email
sponsorEmailError:
type: string
description: Localized error message shown when the sponsor email address is invalid
sponsorInfoApproved:
type: string
description: Localized status message prefix shown when a sponsor approves the request
sponsorInfoDenied:
type: string
description: Localized status message prefix shown when a sponsor denies the request
sponsorInfoPending:
type: string
description: Localized status message prefix shown after a sponsor notification is sent
sponsorName:
type: string
description: Label for Sponsor Name
sponsorNameError:
type: string
description: Localized error message shown when the sponsor name is missing
sponsorNotePending:
type: string
description: Localized additional status text shown while sponsor approval is pending
sponsorRequestAccess:
type: string
description: Submit button label request Wifi Access and notify sponsor about guest request
sponsorStatusApproved:
type: string
description: Text to display if sponsor approves request
sponsorStatusDenied:
type: string
description: Text to display when sponsor denies request
sponsorStatusPending:
type: string
description: Text to display if request is still pending
sponsorSubmit:
type: string
description: Submit button label to notify sponsor about guest request
sponsorsError:
type: string
description: Localized error message shown when no sponsor is selected
sponsorsFieldLabel:
type: string
description: Localized label for the sponsor selection field
tosAcceptLabel:
type: string
description: Prefix of the label of the link to go to tos
tosError:
type: string
description: Error message when tos not accepted
tosLink:
type: string
description: Label of the link to go to tos
tosText:
type: string
description: Text of the Terms of Service
description: Localized portal template strings for a specific language
wlan_qos:
title: wlan_qos
type: object
properties:
class:
allOf:
- $ref: '#/components/schemas/wlan_qos_class2'
- description: 'QoS traffic class applied when WLAN QoS override is enabled. enum: `background`, `best_effort`, `video`, `voice`.'
examples:
- best_effort
overwrite:
type: boolean
description: Whether to overwrite QoS
default: false
description: QoS override settings for WLAN client traffic
wlan_qos_class:
title: wlan_qos_class
enum:
- background
- best_effort
- video
- voice
type: string
description: 'enum: `background`, `best_effort`, `video`, `voice`'
examples:
- best_effort
wlan_roam_mode:
title: wlan_roam_mode
enum:
- 11r
- NONE
- OKC
type: string
description: 'enum: `11r`, `OKC`, `NONE`'
examples:
- NONE
wlan_schedule:
title: wlan_schedule
type: object
properties:
enabled:
type: boolean
description: Whether the WLAN operating schedule is enabled
default: false
hours:
allOf:
- $ref: '#/components/schemas/hours2'
- description: Time ranges when the WLAN is scheduled to operate
description: WLAN operating schedule, default is disabled
wxlan_rule:
title: wxlan_rule
required:
- order
- src_wxtags
type: object
properties:
action:
allOf:
- $ref: '#/components/schemas/wxlan_rule_action2'
- description: Allow or block behavior applied by this WxLAN rule
examples:
- allow
apply_tags:
type: array
items:
type: string
description: WxLAN tag identifiers applied when this rule matches
blocked_apps:
type: array
items:
type: string
description: Application keys always blocked by this rule, regardless of the rule action
examples:
- - mist
- all-videos
created_time:
type: number
description: Time when this WxLAN rule was created, in epoch seconds
readOnly: true
dst_allow_wxtags:
type: array
items:
type: string
description: Destination WxLAN tag identifiers explicitly allowed by this rule
examples:
- - fff34466-eec0-3756-6765-381c728a6037
- eee2c7b0-d1d0-5a30-f349-e35fa43dc3b3
dst_deny_wxtags:
type: array
items:
type: string
description: Destination WxLAN tag identifiers explicitly denied by this rule
examples:
- - aaa34466-eec0-3756-6765-381c728a6037
- bbb2c7b0-d1d0-5a30-f349-e35fa43dc3b3
dst_wxtags:
type: array
items:
type: string
description: Destination WxLAN tag identifiers matched by this rule
examples:
- - aaa34466-eec0-3756-6765-381c728a6037
- bbb2c7b0-d1d0-5a30-f349-e35fa43dc3b3
enabled:
type: boolean
description: Whether this WxLAN rule is enabled
default: true
for_site:
type: boolean
description: Whether this WxLAN rule is scoped to a site
readOnly: true
id:
type: string
description: Unique identifier for this WxLAN rule
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
modified_time:
type: number
description: Time when this WxLAN rule was last modified, in epoch seconds
readOnly: true
order:
minimum: -1
type: integer
description: Lookup priority for WxLAN rules; larger positive values match first, and -1 means LAST. Uniqueness is not checked
contentEncoding: int32
examples:
- 1
org_id:
type: string
description: Owning organization associated with this WxLAN rule
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
site_id:
type: string
description: Mist site associated with this WxLAN rule, when site-scoped
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
src_wxtags:
type: array
items:
type: string
description: Source WxLAN tag identifiers that must match for this rule to apply
examples:
- - 8bfc2490-d726-3587-038d-cb2e71bd2330
- 3aa8e73f-9f46-d827-8d6a-567bb7e67fc9
template_id:
type: string
description: Only for Org Level WxRule
contentEncoding: uuid
examples:
- 6aa54cbd-e039-4878-846a-04f270de8a5c
description: WxLAN policy rule controlling traffic between WxLAN tags
wxlan_rule_action:
title: wxlan_rule_action
enum:
- allow
- block
type: string
description: 'type of action, allow / block. enum: `allow`, `block`'
examples:
- allow
wxlan_tag:
title: wxlan_tag
required:
- name
- type
type: object
properties:
created_time:
type: number
description: Time when this WxLAN tag was created, in epoch seconds
readOnly: true
for_site:
type: boolean
description: Whether this WxLAN tag is scoped to a site
readOnly: true
id:
type: string
description: Unique identifier for this WxLAN tag
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
last_ips:
type: array
items:
type: string
description: Most recent IP addresses observed for this WxLAN tag
readOnly: true
mac:
type:
- string
- 'null'
description: If `type`==`client`, Client MAC address
match:
allOf:
- $ref: '#/components/schemas/wxlan_tag_match2'
- description: 'Required if `type`==`match`; attribute compared against `values`. enum: `ap_id`, `app`, `asset_mac`, `client_mac`, `hostname`, `ip_range_subnet`, `port`, `psk_name`, `psk_role`, `radius_attr`, `radius_class`, `radius_group`, `radius_username`, `sdkclient_uuid`, `wlan_id`.'
modified_time:
type: number
description: Time when this WxLAN tag was last modified, in epoch seconds
readOnly: true
name:
type: string
description: Display name of the WxLAN tag
op:
allOf:
- $ref: '#/components/schemas/wxlan_tag_operation2'
- description: 'Required if `type`==`match`; whether `values` are inclusive or exclusive matches. enum: `in`, `not_in`.'
org_id:
type: string
description: Owning organization associated with this WxLAN tag
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
resource_mac:
type:
- string
- 'null'
description: MAC address of the discovered resource associated with this tag, when applicable
services:
uniqueItems: true
type: array
items:
type: string
description: Names of services associated with this WxLAN tag
site_id:
type: string
description: Mist site associated with this WxLAN tag, when site-scoped
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
specs:
type: array
items:
$ref: '#/components/schemas/wxlan_tag_spec'
description: Traffic match specifications used when `type`==`spec`
subnet:
type: string
description: CIDR subnet associated with this WxLAN tag when `type`==`subnet`
type:
allOf:
- $ref: '#/components/schemas/wxlan_tag_type2'
- description: 'Kind of WxLAN tag and how it is populated. enum: `client`, `match`, `resource`, `spec`, `subnet`, `vlan`.'
values:
type: array
items:
type: string
description: Comparison values for the selected `match` attribute when `type`==`match`
vlan_id:
oneOf:
- type: string
- maximum: 4094
minimum: 1
type: integer
contentEncoding: int32
description: Identifier of the VLAN associated with this WxLAN tag when `type`==`vlan`
examples:
- '1055'
description: >-
WxLAN Tag
* type:
* client: created manually (e.g. on wireless client table, when they spot a device of interest, they can create a wxlan tag for it
* resource: created automatically when we discover a network resource
* subnet: create automatically when a subnet is discovered
* match:
* wlan_id, ap_id: values are a list of Wlan / Device ids
* client_mac: values are a list of MAC addresses
* radius_group: this is a smart tag that matches RADIUS-Filter-ID, Airespace-ACL-Name (VendorID=14179, VendorType=6) / Aruba-User-Role (VendorID=14823, VendorType=1)
* radius_username: this matches the ATTR-User-Name(1)
* radius_class: the matches the ATTR-Class(25)
* radius_attr: the values are [ "6=1" , "26=10.2.3.4" ], this support other RADIUS attributes where we know the type
* radius_vendor: the values are [ "14179.10=1" , "14178.16=1.2.3.4" ], this matches vendor attributes and will be dynamically evaluated
wxlan_tag_match:
title: wxlan_tag_match
enum:
- ap_id
- app
- asset_mac
- client_mac
- hostname
- ip_range_subnet
- port
- psk_name
- psk_role
- radius_attr
- radius_class
- radius_group
- radius_username
- sdkclient_uuid
- wlan_id
type: string
description: 'required if `type`==`match`. enum: `ap_id`, `app`, `asset_mac`, `client_mac`, `hostname`, `ip_range_subnet`, `port`, `psk_name`, `psk_role`, `radius_attr`, `radius_class`, `radius_group`, `radius_username`, `sdkclient_uuid`, `wlan_id`'
wxlan_tag_operation:
title: wxlan_tag_operation
enum:
- in
- not_in
type: string
description: 'required if `type`==`match`, type of tag (inclusive/exclusive). enum: `in`, `not_in`'
wxlan_tag_spec:
title: wxlan_tag_spec
type: object
properties:
port_range:
type: string
description: Matched destination port, "0" means any
default: '0'
protocol:
type: string
description: tcp / udp / icmp / gre / any / ":protocol_number", `protocol_number` is between 1-254
default: any
subnets:
type: array
items:
type: string
description: Destination subnets or IP addresses matched by this WxLAN tag spec
default: []
examples:
- - 0.0.0.0/0
description: Traffic match specification used by a WxLAN tag
wxlan_tag_type:
title: wxlan_tag_type
enum:
- client
- match
- resource
- spec
- subnet
- vlan
type: string
description: 'enum: `client`, `match`, `resource`, `spec`, `subnet`, `vlan`'
wxlan_tunnel:
title: wxlan_tunnel
required:
- name
type: object
properties:
created_time:
type: number
description: Time when this WxLAN tunnel was created, in epoch seconds
readOnly: true
dmvpn:
allOf:
- $ref: '#/components/schemas/wxlan_tunnel_dmvpn2'
- description: Settings for Dynamic Multipoint VPN on this WxLAN tunnel
for_mgmt:
type: boolean
description: Determined during creation time and cannot be toggled. A management tunnel cannot be used by wxlan rule or by wlan
default: false
for_site:
type: boolean
description: Whether this WxLAN tunnel is scoped to a site
readOnly: true
hello_interval:
maximum: 300
minimum: 1
type: integer
description: In seconds, used as heartbeat to detect if a tunnel is alive. AP will try another peer after missing N hellos specified by hello_retries.
contentEncoding: int32
default: 60
hello_retries:
maximum: 30
minimum: 2
type: integer
description: Number of missed hello messages before the AP tries another tunnel peer
contentEncoding: int32
default: 7
hostname:
type: string
description: >-
Optional, overwrite the hostname in SCCRQ control message, default is or null, %H and %M can be used, which will be replace with corresponding values:
* %H: name of the ap if provided (and will be stripped so it can be used for hostname) and fallbacks to MAC
* %M: MAC (e.g. 5c5b350e0060)
id:
type: string
description: Unique identifier for this WxLAN tunnel
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
ipsec:
allOf:
- $ref: '#/components/schemas/wxlan_tunnel_ipsec2'
- description: Security settings for IPsec on this WxLAN tunnel; requires DMVPN to be enabled
is_static:
type: boolean
description: Whether it’s static/unmanaged (i.e. no control session). As the session configurations are not compatible, cannot be toggled.
default: false
modified_time:
type: number
description: Time when this WxLAN tunnel was last modified, in epoch seconds
readOnly: true
mtu:
maximum: 1500
minimum: 0
type: integer
description: 0 to enable PMTU, 552-1500 to start PMTU with a lower MTU
contentEncoding: int32
default: 0
name:
type: string
description: The name of the tunnel
org_id:
type: string
description: Owning organization associated with this WxLAN tunnel
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
peers:
type: array
items:
type: string
description: Remote peer IP addresses or hostnames for this tunnel
router_id:
type: string
description: Optional, overwrite the router-id in SCCRQ control message, default is "" or null, can also be an IPv4 address
secret:
type: string
description: Shared secret used for tunnel authentication, ‘’ if no auth is used
sessions:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/wxlan_tunnel_session'
description: L2TPv3 sessions established for this tunnel
site_id:
type: string
description: Mist site associated with this WxLAN tunnel, when site-scoped
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
udp_port:
type: integer
description: UDP port if `use_udp`==`true`
contentEncoding: int32
use_udp:
type: boolean
description: Whether to use UDP instead of IP (proto=115, which is default of L2TPv3)
default: false
description: WxLAN tunnel configuration for L2TPv3 or DMVPN connectivity
wxlan_tunnel_dmvpn:
title: wxlan_tunnel_dmvpn
type: object
properties:
enabled:
type: boolean
description: Whether DMVPN is enabled
default: false
holding_time:
type: integer
description: Optional; the holding time for NHRP ‘registration requests’ and ‘resolution replies’ sent from the Mist AP (in seconds); default 600
contentEncoding: int32
host_routes:
type: array
items:
type: string
description: IPv4 DMVPN peer host routes to which traffic is forwarded
description: Dynamic Multipoint VPN configurations
wxlan_tunnel_ipsec:
title: wxlan_tunnel_ipsec
required:
- psk
type: object
properties:
enabled:
type: boolean
description: Whether ipsec is enabled, requires DMVPN be enabled
default: false
psk:
type: string
description: Pre-shared key used for IPsec on this WxLAN tunnel
description: IPSec-related configurations; requires DMVPN be enabled
wxlan_tunnel_session:
title: wxlan_tunnel_session
type: object
properties:
ap_as_session_id:
type: string
description: If `use_ap_as_session_ids`==`true`, only apmac is supported right now. This is the name WLAN should use for wxtunnel_remote_id
comment:
type: string
description: Optional, user-specified string for display purpose
enable_cookie:
type: boolean
description: Whether L2TPv3 cookie support is enabled for this session
ethertype:
allOf:
- $ref: '#/components/schemas/wxlan_tunnel_session_ethertype2'
- description: 'Frame type carried by this tunnel session. enum: `ethernet`, `vlan`.'
local_session_id:
maximum: 2147483647
minimum: 1
type: integer
description: Identifier for the local L2TPv3 session, from 1 to 2147483647
contentEncoding: int32
pseudo_802.1ad_enabled:
type: boolean
description: Optional. Enables the pseudo 802.1ad QinQ mode where the AP device drops the outer vlan tag (QinQ). This mode is useful when tunneling Mist AP’s to some aggregation routers.
default: false
remote_id:
type: string
description: Remote-id of the session, has to be unique in the same tunnel
remote_session_id:
maximum: 2147483647
minimum: 1
type: integer
description: Identifier for the remote L2TPv3 session, from 1 to 2147483647
contentEncoding: int32
use_ap_as_session_ids:
type: boolean
description: Whether to use AP (last 4 bytes of MAC currently) as session ids
default: false
description: L2TPv3 session established inside a WxLAN tunnel
wxlan_tunnel_session_ethertype:
title: wxlan_tunnel_session_ethertype
enum:
- ethernet
- vlan
type: string
description: 'Frame type carried by this tunnel session. enum: `ethernet`, `vlan`'
wxtag_client:
title: wxtag_client
required:
- mac
- since
type: object
properties:
mac:
type: string
description: Client MAC address associated with the WxLAN tag entry
examples:
- 5684dae9ac8b
since:
type: number
description: Time when the client became associated with the WxLAN tag, in epoch seconds
examples:
- 1428939600
description: Client associated with a WxLAN tag
zigbee_join_response:
title: zigbee_join_response
type: object
properties:
session_id:
type: string
description: Session ID for the Zigbee join operation
contentEncoding: uuid
examples:
- 19e73828-937f-05e6-f709-e29efdb0a82b
description: Response containing the session identifier for a Zigbee join operation
zigbee_trail_response:
title: zigbee_trail_response
type: object
properties:
session:
type: string
description: Session ID the UI can use to stream trail results
contentEncoding: uuid
examples:
- 7a5f7796-83ee-11e5-95c6-1258369c38a9
description: Response containing the session identifier for a Zigbee event or packet trail operation
zone:
title: zone
type: object
properties:
created_time:
type: number
description: Time when this zone was created, in epoch seconds
readOnly: true
for_site:
type: boolean
description: Whether this zone is scoped to a site
readOnly: true
id:
type: string
description: Unique identifier for this zone
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
map_id:
type: string
description: Map where this zone is defined
contentEncoding: uuid
readOnly: true
modified_time:
type: number
description: Time when this zone was last modified, in epoch seconds
readOnly: true
name:
type: string
description: Display name of the zone
org_id:
type: string
description: Owning organization associated with this zone
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
site_id:
type: string
description: Mist site associated with this zone
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
vertices:
type: array
items:
$ref: '#/components/schemas/zone_vertex'
description: Polygon vertices that define the zone boundary
examples:
- - x: 732
y: 1821
- x: 732.5
y: 1731
- x: 837.5
y: 1731.5
- x: 839
y: 1821
description: Zone defined on a site map
zone_scope:
title: zone_scope
enum:
- map
- rssizone
- site
- zone
type: string
description: 'enum: `map`, `rssizone`, `site`, `zone`'
zone_type:
title: zone_type
enum:
- rssizones
- zones
type: string
description: 'Zone collection type, either regular zones or RSSI zones. enum: `rssizones`, `zones`'
zone_vertex:
title: zone_vertex
required:
- x
- y
type: object
properties:
x:
type: number
description: Horizontal pixel coordinate of the zone vertex
y:
type: number
description: Vertical pixel coordinate of the zone vertex
description: Zone polygon vertex expressed in map pixels
zone_vertex_m:
title: zone_vertex_m
required:
- x
- y
type: object
properties:
x:
type: number
description: Horizontal coordinate of the zone vertex, in meters
y:
type: number
description: Vertical coordinate of the zone vertex, in meters
description: Zone polygon vertex expressed in meters
aamw_profile_action1:
title: aamw_profile_action1
enum:
- block
- permit
type: string
description: 'Action to take for files that meet or exceed the malware verdict threshold. enum: `block`, `permit`.'
aamw_profile_action3:
title: aamw_profile_action3
enum:
- block
- permit
type: string
description: 'Action to take when Sky ATP cannot obtain a malware verdict. enum: `block`, `permit`.'
aamw_profile_category_category2:
title: aamw_profile_category_category2
enum:
- archive
- document
- pdf
- executable
- rich_application
- library
- os_package
- mobile
- java
- configuration
- script
type: string
description: 'File category covered by this Advanced Anti Malware profile. enum: `archive`, `document`, `pdf`, `executable`, `rich_application`, `library`, `os_package`, `mobile`, `java`, `configuration`, `script`.'
account_juniper_info1:
title: account_juniper_info1
type: object
properties:
accounts:
type: array
items:
$ref: '#/components/schemas/juniper_account'
description: List of linked Juniper account records
description: Linked Juniper account information for this organization
account_skyatp_cloud_name1:
title: account_skyatp_cloud_name1
enum:
- www.amerskyatp.com
- www.apacskyatp.com
- www.euroskyatp.com
- www.canadaskyatp.com
type: string
description: 'Sky ATP cloud endpoint used for the integration. enum: `www.amerskyatp.com`, `www.apacskyatp.com`, `www.euroskyatp.com`, `www.canadaskyatp.com`.'
examples:
- www.amerskyatp.com
account_skyatp_cloud_name2:
title: account_skyatp_cloud_name2
enum:
- www.amerskyatp.com
- www.apacskyatp.com
- www.euroskyatp.com
- www.canadaskyatp.com
type: string
description: 'Sky ATP cloud endpoint configured for the integration. enum: `www.amerskyatp.com`, `www.apacskyatp.com`, `www.euroskyatp.com`, `www.canadaskyatp.com`.'
examples:
- www.amerskyatp.com
account_skyatp_data_secintel2:
title: account_skyatp_data_secintel2
type: object
properties:
third_party_threat_feeds:
uniqueItems: true
type: array
items:
type: string
description: Third-party threat feed names enabled for SecIntel
description: Juniper SecIntel threat feed configuration provided by Sky ATP
acl_tag_type2:
title: acl_tag_type2
enum:
- any
- aruba_user_role
- dynamic_gbp
- gbp_resource
- mac
- network
- port_usage
- radius_group
- resource
- static_gbp
- subnet
type: string
description: 'Classifier type that determines which ACL tag fields are evaluated. enum: `any`, `aruba_user_role`, `dynamic_gbp`, `gbp_resource`, `mac`, `network`, `port_usage`, `radius_group`, `resource`, `static_gbp`, `subnet`.'
admin_compliance_status2:
title: admin_compliance_status2
enum:
- blocked
- restricted
type: string
description: 'Trade compliance status for this administrator. enum: `blocked`, `restricted`.'
admin_privilege_role2:
title: admin_privilege_role2
enum:
- admin
- helpdesk
- installer
- read
- write
type: string
description: 'Access role granted by this privilege. enum: `admin`, `helpdesk`, `installer`, `read`, `write`.'
admin_privilege_scope2:
title: admin_privilege_scope2
enum:
- msp
- org
- orggroup
- site
- sitegroup
type: string
description: 'Object scope where this privilege applies. enum: `msp`, `org`, `orggroup`, `site`, `sitegroup`.'
alarm_status2:
title: alarm_status2
enum:
- open
- resolved
type: string
description: 'Current lifecycle status of this alarm. enum: `open`, `resolved`.'
allow_deny2:
title: allow_deny2
enum:
- allow
- deny
type: string
description: Allow or deny action for traffic matched by this service policy
allow_deny4:
title: allow_deny4
enum:
- allow
- deny
type: string
description: Allow or deny decision applied to traffic matching the destination tag
antenna_select1:
title: antenna_select1
enum:
- external
- internal
type: string
description: 'Internal or external antenna selection for AP models with selectable antennas. enum: ``, `external`, `internal`.'
examples:
- external
antenna_select2:
title: antenna_select2
enum:
- external
- internal
type: string
description: 'Selectable antenna mode reported for the AP. enum: ``, `external`, `internal`.'
examples:
- external
ap_aeroscout1:
title: ap_aeroscout1
type: object
properties:
enabled:
type: boolean
description: Whether to enable aeroscout config
default: false
host:
type:
- string
- 'null'
description: Required if enabled, aeroscout server host
examples:
- aero.pvt.net
locate_connected:
type: boolean
description: Whether to enable the feature to allow wireless clients data received and sent to AES server for location calculation
default: false
port:
type:
- integer
- 'null'
description: Optional if enabled, Aeroscout server port. Defaults to 1144
contentEncoding: int32
default: 1144
description: Location integration settings for AeroScout on this access point
ap_aeroscout2:
title: ap_aeroscout2
type: object
properties:
enabled:
type: boolean
description: Whether to enable aeroscout config
default: false
host:
type:
- string
- 'null'
description: Required if enabled, aeroscout server host
examples:
- aero.pvt.net
locate_connected:
type: boolean
description: Whether to enable the feature to allow wireless clients data received and sent to AES server for location calculation
default: false
port:
type:
- integer
- 'null'
description: Optional if enabled, Aeroscout server port. Defaults to 1144
contentEncoding: int32
default: 1144
description: Location integration defaults for AeroScout in this AP profile
ap_airista1:
title: ap_airista1
type: object
properties:
enabled:
type: boolean
description: Whether to enable Airista config
default: false
host:
type:
- string
- 'null'
description: Required if enabled, Airista server host
examples:
- airista.pvt.net
port:
type:
- integer
- 'null'
description: Optional if enabled, Airista server port. Defaults to 1144
contentEncoding: int32
default: 1144
description: Location integration settings for Airista on this access point
ap_airista2:
title: ap_airista2
type: object
properties:
enabled:
type: boolean
description: Whether to enable Airista config
default: false
host:
type:
- string
- 'null'
description: Required if enabled, Airista server host
examples:
- airista.pvt.net
port:
type:
- integer
- 'null'
description: Optional if enabled, Airista server port. Defaults to 1144
contentEncoding: int32
default: 1144
description: Location integration defaults for Airista in this AP profile
ap_centrak1:
title: ap_centrak1
type: object
properties:
enabled:
type: boolean
description: Whether to enable Centrak config
default: false
description: Location integration settings for Centrak on this access point
ap_client_bridge_auth_type2:
title: ap_client_bridge_auth_type2
enum:
- open
- psk
type: string
description: 'Authentication mode for the client bridge connection. enum: `open`, `psk`.'
examples:
- psk
ap_client_bridge_auth2:
title: ap_client_bridge_auth2
type: object
properties:
psk:
maxLength: 63
minLength: 8
type: string
description: Pre-shared key used when `type`==`psk` for client bridge authentication
examples:
- foryoureyesonly
type:
allOf:
- $ref: '#/components/schemas/ap_client_bridge_auth_type2'
- minLength: 1
description: 'Authentication mode for the client bridge connection. enum: `open`, `psk`.'
examples:
- psk
description: Credentials and security mode used when the AP connects as a wireless client bridge
ap_client_bridge1:
title: ap_client_bridge1
type: object
properties:
auth:
allOf:
- $ref: '#/components/schemas/ap_client_bridge_auth2'
- description: Credentials and security mode used when the AP connects as a wireless client bridge
enabled:
type: boolean
description: >-
When acted as client bridge:
* only 5G radio can be used
* will not serve as AP on any radios
default: false
ssid:
minLength: 1
type: string
description: Uplink SSID used by the AP when client bridge mode is enabled
examples:
- Uplink-SSID
description: Wireless client bridge settings for this access point
ap_esl_config1:
title: ap_esl_config1
type: object
properties:
cacert:
type: string
description: Only if `type`==`imagotag` or `type`==`native`
examples:
- >
--BEGIN CERTIFICATE--
MIIDXTCCAkWgAwIBAgIJAL5b1z4f3k2TMA0GCSqGSIb3DQEBCwUAMIGVMQsw
channel:
type: integer
description: Only if `type`==`imagotag` or `type`==`native`
contentEncoding: int32
examples:
- 3
enabled:
type: boolean
description: usb_config is ignored if esl_config enabled
default: false
host:
type: string
description: Only if `type`==`imagotag` or `type`==`native`
examples:
- 1.1.1.1
port:
type: integer
description: Only if `type`==`imagotag` or `type`==`native`
contentEncoding: int32
examples:
- 0
type:
allOf:
- $ref: '#/components/schemas/ap_esl_type2'
- description: 'ESL integration type to enable on the AP. enum: `hanshow`, `imagotag`, `native`, `solum`.'
examples:
- imagotag
verify_cert:
type: boolean
description: Only if `type`==`imagotag` or `type`==`native`
examples:
- true
vlan_id:
type: integer
description: Only if `type`==`solum` or `type`==`hanshow`
contentEncoding: int32
default: 1
description: Electronic shelf label integration settings for this access point
ap_esl_config2:
title: ap_esl_config2
type: object
properties:
cacert:
type: string
description: Only if `type`==`imagotag` or `type`==`native`
examples:
- >
--BEGIN CERTIFICATE--
MIIDXTCCAkWgAwIBAgIJAL5b1z4f3k2TMA0GCSqGSIb3DQEBCwUAMIGVMQsw
channel:
type: integer
description: Only if `type`==`imagotag` or `type`==`native`
contentEncoding: int32
examples:
- 3
enabled:
type: boolean
description: usb_config is ignored if esl_config enabled
default: false
host:
type: string
description: Only if `type`==`imagotag` or `type`==`native`
examples:
- 1.1.1.1
port:
type: integer
description: Only if `type`==`imagotag` or `type`==`native`
contentEncoding: int32
examples:
- 0
type:
allOf:
- $ref: '#/components/schemas/ap_esl_type2'
- description: 'ESL integration type to enable on the AP. enum: `hanshow`, `imagotag`, `native`, `solum`.'
examples:
- imagotag
verify_cert:
type: boolean
description: Only if `type`==`imagotag` or `type`==`native`
examples:
- true
vlan_id:
type: integer
description: Only if `type`==`solum` or `type`==`hanshow`
contentEncoding: int32
default: 1
description: Electronic shelf label integration defaults in this AP profile
ap_esl_type2:
title: ap_esl_type2
enum:
- hanshow
- imagotag
- native
- solum
type: string
description: 'ESL integration type to enable on the AP. enum: `hanshow`, `imagotag`, `native`, `solum`.'
examples:
- imagotag
ap_iot_input1:
title: ap_iot_input1
type: object
properties:
enabled:
type: boolean
description: Whether to enable a pin
default: false
name:
type: string
description: Optional; descriptive pin name
examples:
- motion
pullup:
allOf:
- $ref: '#/components/schemas/ap_iot_pullup1'
- description: 'Selects the pull-up resistor mode applied to the input pin. enum: `external`, `internal`, `none`.'
description: Digital input pin DI2 settings
ap_iot_input3:
title: ap_iot_input3
type: object
properties:
enabled:
type: boolean
description: Whether to enable a pin
default: false
name:
type: string
description: Optional; descriptive pin name
examples:
- motion
pullup:
allOf:
- $ref: '#/components/schemas/ap_iot_pullup1'
- description: 'Selects the pull-up resistor mode applied to the input pin. enum: `external`, `internal`, `none`.'
description: Digital input pin DI1 settings
ap_iot_output1:
title: ap_iot_output1
type: object
properties:
enabled:
type: boolean
description: Whether to enable a pin
default: false
name:
type: string
description: Optional; descriptive pin name
examples:
- motion
output:
type: boolean
description: Whether the pin is configured as an output. DO and A1-A4 can be repurposed by changing
examples:
- true
pullup:
allOf:
- $ref: '#/components/schemas/ap_iot_pullup3'
- description: 'Selects the pull-up resistor mode applied to the output pin. enum: `external`, `internal`, `none`.'
value:
type: integer
description: Output pin signal level, default 0
contentEncoding: int32
examples:
- 0
description: Analog-capable IoT pin A2 output settings
ap_iot_output2:
title: ap_iot_output2
type: object
properties:
enabled:
type: boolean
description: Whether to enable a pin
default: false
name:
type: string
description: Optional; descriptive pin name
examples:
- motion
output:
type: boolean
description: Whether the pin is configured as an output. DO and A1-A4 can be repurposed by changing
examples:
- true
pullup:
allOf:
- $ref: '#/components/schemas/ap_iot_pullup3'
- description: 'Selects the pull-up resistor mode applied to the output pin. enum: `external`, `internal`, `none`.'
value:
type: integer
description: Output pin signal level, default 0
contentEncoding: int32
examples:
- 0
description: Analog-capable IoT pin A3 output settings
ap_iot_output3:
title: ap_iot_output3
type: object
properties:
enabled:
type: boolean
description: Whether to enable a pin
default: false
name:
type: string
description: Optional; descriptive pin name
examples:
- motion
output:
type: boolean
description: Whether the pin is configured as an output. DO and A1-A4 can be repurposed by changing
examples:
- true
pullup:
allOf:
- $ref: '#/components/schemas/ap_iot_pullup3'
- description: 'Selects the pull-up resistor mode applied to the output pin. enum: `external`, `internal`, `none`.'
value:
type: integer
description: Output pin signal level, default 0
contentEncoding: int32
examples:
- 0
description: Analog-capable IoT pin A4 output settings
ap_iot_output4:
title: ap_iot_output4
type: object
properties:
enabled:
type: boolean
description: Whether to enable a pin
default: false
name:
type: string
description: Optional; descriptive pin name
examples:
- motion
output:
type: boolean
description: Whether the pin is configured as an output. DO and A1-A4 can be repurposed by changing
examples:
- true
pullup:
allOf:
- $ref: '#/components/schemas/ap_iot_pullup3'
- description: 'Selects the pull-up resistor mode applied to the output pin. enum: `external`, `internal`, `none`.'
value:
type: integer
description: Output pin signal level, default 0
contentEncoding: int32
examples:
- 0
description: Digital output pin DO settings
ap_iot_output6:
title: ap_iot_output6
type: object
properties:
enabled:
type: boolean
description: Whether to enable a pin
default: false
name:
type: string
description: Optional; descriptive pin name
examples:
- motion
output:
type: boolean
description: Whether the pin is configured as an output. DO and A1-A4 can be repurposed by changing
examples:
- true
pullup:
allOf:
- $ref: '#/components/schemas/ap_iot_pullup3'
- description: 'Selects the pull-up resistor mode applied to the output pin. enum: `external`, `internal`, `none`.'
value:
type: integer
description: Output pin signal level, default 0
contentEncoding: int32
examples:
- 0
description: Analog-capable IoT pin A1 output settings
ap_iot_pullup1:
title: ap_iot_pullup1
enum:
- external
- internal
- none
type: string
description: 'Selects the pull-up resistor mode applied to the input pin. enum: `external`, `internal`, `none`.'
ap_iot_pullup3:
title: ap_iot_pullup3
enum:
- external
- internal
- none
type: string
description: 'Selects the pull-up resistor mode applied to the output pin. enum: `external`, `internal`, `none`.'
ap_iot2:
title: ap_iot2
type: object
properties:
A1:
allOf:
- $ref: '#/components/schemas/ap_iot_output6'
- description: Analog-capable IoT pin A1 output settings
A2:
allOf:
- $ref: '#/components/schemas/ap_iot_output1'
- description: Analog-capable IoT pin A2 output settings
A3:
allOf:
- $ref: '#/components/schemas/ap_iot_output2'
- description: Analog-capable IoT pin A3 output settings
A4:
allOf:
- $ref: '#/components/schemas/ap_iot_output3'
- description: Analog-capable IoT pin A4 output settings
DI1:
allOf:
- $ref: '#/components/schemas/ap_iot_input3'
- description: Digital input pin DI1 settings
DI2:
allOf:
- $ref: '#/components/schemas/ap_iot_input1'
- description: Digital input pin DI2 settings
DO:
allOf:
- $ref: '#/components/schemas/ap_iot_output4'
- description: Digital output pin DO settings
description: Digital and analog IoT pin defaults in this AP profile
ap_iot3:
title: ap_iot3
type: object
properties:
A1:
allOf:
- $ref: '#/components/schemas/ap_iot_output6'
- description: Analog-capable IoT pin A1 output settings
A2:
allOf:
- $ref: '#/components/schemas/ap_iot_output1'
- description: Analog-capable IoT pin A2 output settings
A3:
allOf:
- $ref: '#/components/schemas/ap_iot_output2'
- description: Analog-capable IoT pin A3 output settings
A4:
allOf:
- $ref: '#/components/schemas/ap_iot_output3'
- description: Analog-capable IoT pin A4 output settings
DI1:
allOf:
- $ref: '#/components/schemas/ap_iot_input3'
- description: Digital input pin DI1 settings
DI2:
allOf:
- $ref: '#/components/schemas/ap_iot_input1'
- description: Digital input pin DI2 settings
DO:
allOf:
- $ref: '#/components/schemas/ap_iot_output4'
- description: Digital output pin DO settings
description: Digital and analog IoT pin settings for this access point
ap_ip_config2:
title: ap_ip_config2
type: object
properties:
dns:
type: array
items:
type: string
description: If `type`==`static`. DNS server IP addresses for AP management traffic
examples:
- - 8.8.8.8
- 4.4.4.4
dns_suffix:
type: array
items:
type: string
description: If `type`==`static`. DNS search suffixes applied to AP management lookups
examples:
- - .mist.local
- .mist.com
gateway:
type: string
description: Required if `type`==`static`. IPv4 default gateway for AP management traffic
contentEncoding: ipv4
examples:
- 10.2.1.254
gateway6:
type: string
description: Required if `type6`==`static`. IPv6 default gateway for AP management traffic when static IPv6 addressing is used
contentEncoding: ipv6
examples:
- 2607:f8b0:4005:808::1
ip:
type: string
description: Required if `type`==`static`. Static IPv4 address for the AP management interface
contentEncoding: ipv4
examples:
- 10.2.1.1
ip6:
type: string
description: Required if `type6`==`static`. Static IPv6 address for the AP management interface
contentEncoding: ipv6
examples:
- 2607:f8b0:4005:808::2004
mtu:
type: integer
description: Maximum transmission unit for AP management traffic
contentEncoding: int32
examples:
- 0
netmask:
type: string
description: Required if `type`==`static`. IPv4 netmask for the AP management interface
examples:
- 255.255.255.0
netmask6:
type: string
description: Required if `type6`==`static`. IPv6 prefix length for the AP management interface
examples:
- /32
type:
allOf:
- $ref: '#/components/schemas/ip_type13'
- description: 'IPv4 address assignment mode for AP management traffic. enum: `dhcp`, `static`.'
examples:
- static
type6:
allOf:
- $ref: '#/components/schemas/ip_type64'
- description: 'IPv6 address assignment mode for AP management traffic. enum: `autoconf`, `dhcp`, `disabled`, `static`.'
examples:
- static
vlan_id:
type: integer
description: Management VLAN ID, default is 1 (untagged)
contentEncoding: int32
default: 1
examples:
- 1
description: Management IP addressing defaults in this AP profile
ap_ip_config3:
title: ap_ip_config3
type: object
properties:
dns:
type: array
items:
type: string
description: If `type`==`static`. DNS server IP addresses for AP management traffic
examples:
- - 8.8.8.8
- 4.4.4.4
dns_suffix:
type: array
items:
type: string
description: If `type`==`static`. DNS search suffixes applied to AP management lookups
examples:
- - .mist.local
- .mist.com
gateway:
type: string
description: Required if `type`==`static`. IPv4 default gateway for AP management traffic
contentEncoding: ipv4
examples:
- 10.2.1.254
gateway6:
type: string
description: Required if `type6`==`static`. IPv6 default gateway for AP management traffic when static IPv6 addressing is used
contentEncoding: ipv6
examples:
- 2607:f8b0:4005:808::1
ip:
type: string
description: Required if `type`==`static`. Static IPv4 address for the AP management interface
contentEncoding: ipv4
examples:
- 10.2.1.1
ip6:
type: string
description: Required if `type6`==`static`. Static IPv6 address for the AP management interface
contentEncoding: ipv6
examples:
- 2607:f8b0:4005:808::2004
mtu:
type: integer
description: Maximum transmission unit for AP management traffic
contentEncoding: int32
examples:
- 0
netmask:
type: string
description: Required if `type`==`static`. IPv4 netmask for the AP management interface
examples:
- 255.255.255.0
netmask6:
type: string
description: Required if `type6`==`static`. IPv6 prefix length for the AP management interface
examples:
- /32
type:
allOf:
- $ref: '#/components/schemas/ip_type13'
- description: 'IPv4 address assignment mode for AP management traffic. enum: `dhcp`, `static`.'
examples:
- static
type6:
allOf:
- $ref: '#/components/schemas/ip_type64'
- description: 'IPv6 address assignment mode for AP management traffic. enum: `autoconf`, `dhcp`, `disabled`, `static`.'
examples:
- static
vlan_id:
type: integer
description: Management VLAN ID, default is 1 (untagged)
contentEncoding: int32
default: 1
examples:
- 1
description: IP configuration applied to the AP management interface
ap_ip_config4:
title: ap_ip_config4
type: object
properties:
dns:
type: array
items:
type: string
description: If `type`==`static`. DNS server IP addresses for AP management traffic
examples:
- - 8.8.8.8
- 4.4.4.4
dns_suffix:
type: array
items:
type: string
description: If `type`==`static`. DNS search suffixes applied to AP management lookups
examples:
- - .mist.local
- .mist.com
gateway:
type: string
description: Required if `type`==`static`. IPv4 default gateway for AP management traffic
contentEncoding: ipv4
examples:
- 10.2.1.254
gateway6:
type: string
description: Required if `type6`==`static`. IPv6 default gateway for AP management traffic when static IPv6 addressing is used
contentEncoding: ipv6
examples:
- 2607:f8b0:4005:808::1
ip:
type: string
description: Required if `type`==`static`. Static IPv4 address for the AP management interface
contentEncoding: ipv4
examples:
- 10.2.1.1
ip6:
type: string
description: Required if `type6`==`static`. Static IPv6 address for the AP management interface
contentEncoding: ipv6
examples:
- 2607:f8b0:4005:808::2004
mtu:
type: integer
description: Maximum transmission unit for AP management traffic
contentEncoding: int32
examples:
- 0
netmask:
type: string
description: Required if `type`==`static`. IPv4 netmask for the AP management interface
examples:
- 255.255.255.0
netmask6:
type: string
description: Required if `type6`==`static`. IPv6 prefix length for the AP management interface
examples:
- /32
type:
allOf:
- $ref: '#/components/schemas/ip_type13'
- description: 'IPv4 address assignment mode for AP management traffic. enum: `dhcp`, `static`.'
examples:
- static
type6:
allOf:
- $ref: '#/components/schemas/ip_type64'
- description: 'IPv6 address assignment mode for AP management traffic. enum: `autoconf`, `dhcp`, `disabled`, `static`.'
examples:
- static
vlan_id:
type: integer
description: Management VLAN ID, default is 1 (untagged)
contentEncoding: int32
default: 1
examples:
- 1
description: Management IP addressing settings for this access point
ap_led2:
title: ap_led2
type: object
properties:
brightness:
maximum: 255
minimum: 0
type: integer
description: Indicator LED brightness level from 0 to 255
contentEncoding: int32
default: 255
examples:
- 255
enabled:
type: boolean
description: Whether the AP indicator LED is enabled
default: true
description: Indicator light behavior defaults in this AP profile
ap_led3:
title: ap_led3
type: object
properties:
brightness:
maximum: 255
minimum: 0
type: integer
description: Indicator LED brightness level from 0 to 255
contentEncoding: int32
default: 255
examples:
- 255
enabled:
type: boolean
description: Whether the AP indicator LED is enabled
default: true
description: AP LED behavior configured for the site
ap_led4:
title: ap_led4
type: object
properties:
brightness:
maximum: 255
minimum: 0
type: integer
description: Indicator LED brightness level from 0 to 255
contentEncoding: int32
default: 255
examples:
- 255
enabled:
type: boolean
description: Whether the AP indicator LED is enabled
default: true
description: Light indicator state for the AP
ap_led5:
title: ap_led5
type: object
properties:
brightness:
maximum: 255
minimum: 0
type: integer
description: Indicator LED brightness level from 0 to 255
contentEncoding: int32
default: 255
examples:
- 255
enabled:
type: boolean
description: Whether the AP indicator LED is enabled
default: true
description: Indicator light behavior settings for this access point
ap_mesh_role2:
title: ap_mesh_role2
enum:
- base
- remote
type: string
description: Mesh role for this AP, either base or remote
examples:
- base
ap_mesh2:
title: ap_mesh2
type: object
properties:
bands:
type: array
items:
$ref: '#/components/schemas/dot11_band'
description: Radio bands allowed for AP mesh links
enabled:
type: boolean
description: Whether mesh is enabled on this AP
default: false
group:
maximum: 9
minimum: 1
type:
- integer
- 'null'
description: Mesh group, base AP(s) will only allow remote AP(s) in the same mesh group to join, 1-9, optional
contentEncoding: int32
examples:
- 1
role:
allOf:
- $ref: '#/components/schemas/ap_mesh_role2'
- description: Mesh role for this AP, either base or remote
examples:
- base
use_wpa3_on_5:
type: boolean
description: Whether to use WPA3 on the 5 GHz band for mesh links
default: false
description: Wireless mesh role and band defaults in this AP profile
ap_mesh3:
title: ap_mesh3
type: object
properties:
bands:
type: array
items:
$ref: '#/components/schemas/dot11_band'
description: Radio bands allowed for AP mesh links
enabled:
type: boolean
description: Whether mesh is enabled on this AP
default: false
group:
maximum: 9
minimum: 1
type:
- integer
- 'null'
description: Mesh group, base AP(s) will only allow remote AP(s) in the same mesh group to join, 1-9, optional
contentEncoding: int32
examples:
- 1
role:
allOf:
- $ref: '#/components/schemas/ap_mesh_role2'
- description: Mesh role for this AP, either base or remote
examples:
- base
use_wpa3_on_5:
type: boolean
description: Whether to use WPA3 on the 5 GHz band for mesh links
default: false
description: Wireless mesh role and band settings for this access point
ap_mqtt_broker_proto2:
title: ap_mqtt_broker_proto2
enum:
- ssl
- tcp
type: string
description: 'MQTT broker transport protocol. enum: `ssl`, `tcp`.'
ap_mqtt_format2:
title: ap_mqtt_format2
enum:
- json
- raw
type: string
description: 'Payload format for published messages. enum: `json`, `raw`.'
ap_mqtt2:
title: ap_mqtt2
type: object
properties:
broker_host:
type: string
description: MQTT broker hostname or IP address; required when `enabled` is `true`
broker_port:
type: integer
description: MQTT broker port; defaults to `1883` for `tcp` and `8883` for `ssl`
contentEncoding: int32
broker_proto:
allOf:
- $ref: '#/components/schemas/ap_mqtt_broker_proto2'
- description: 'MQTT broker transport protocol. enum: `ssl`, `tcp`.'
default_topic:
type: string
description: Optional catch-all MQTT topic; BLE advertisements matching no AssetFilter are published here
examples:
- mist/asset/raw
enabled:
type: boolean
description: Whether to enable MQTT publishing
default: false
format:
allOf:
- $ref: '#/components/schemas/ap_mqtt_format2'
- description: 'Payload format for published messages. enum: `json`, `raw`.'
password:
type: string
description: Optional MQTT password; masked in GET responses
contentEncoding: password
username:
type: string
description: Optional MQTT username
description: MQTT broker publishing settings for this AP profile
ap_mqtt3:
title: ap_mqtt3
type: object
properties:
broker_host:
type: string
description: MQTT broker hostname or IP address; required when `enabled` is `true`
broker_port:
type: integer
description: MQTT broker port; defaults to `1883` for `tcp` and `8883` for `ssl`
contentEncoding: int32
broker_proto:
allOf:
- $ref: '#/components/schemas/ap_mqtt_broker_proto2'
- description: 'MQTT broker transport protocol. enum: `ssl`, `tcp`.'
default_topic:
type: string
description: Optional catch-all MQTT topic; BLE advertisements matching no AssetFilter are published here
examples:
- mist/asset/raw
enabled:
type: boolean
description: Whether to enable MQTT publishing
default: false
format:
allOf:
- $ref: '#/components/schemas/ap_mqtt_format2'
- description: 'Payload format for published messages. enum: `json`, `raw`.'
password:
type: string
description: Optional MQTT password; masked in GET responses
contentEncoding: password
username:
type: string
description: Optional MQTT username
description: MQTT broker publishing settings for this access point
ap_port_config_dynamic_vlan_type2:
title: ap_port_config_dynamic_vlan_type2
enum:
- airespace-interface-name
- standard
type: string
description: 'Mapping mode for interpreting dynamic VLAN attributes returned by RADIUS. enum: `airespace-interface-name`, `standard`.'
ap_port_config_dynamic_vlan2:
title: ap_port_config_dynamic_vlan2
type: object
properties:
default_vlan_id:
maximum: 4094
minimum: 1
type: integer
description: Fallback VLAN ID used when RADIUS does not return a dynamic VLAN match
contentEncoding: int32
examples:
- 999
enabled:
type: boolean
description: Whether dynamic VLAN assignment is enabled for this AP port
type:
allOf:
- $ref: '#/components/schemas/ap_port_config_dynamic_vlan_type2'
- description: 'Mapping mode for interpreting dynamic VLAN attributes returned by RADIUS. enum: `airespace-interface-name`, `standard`.'
vlans:
type: object
additionalProperties:
type: string
nullable: true
description: Mapping entries for RADIUS-assigned VLAN values on this AP port. For `type`==`airespace-interface-name`, the property key is the Airespace interface name returned by RADIUS (e.g. "guest"), and the value is the corresponding VLAN ID (e.g. 100). For `type`==`standard`, the property key is the VLAN ID number returned by RADIUS, and the value is ignored.
examples:
- 1-10: null
user: 10
description: RADIUS-assigned VLAN settings for AP port authentication
ap_port_config_forwarding2:
title: ap_port_config_forwarding2
enum:
- all
- limited
- mxtunnel
- site_mxedge
- wxtunnel
type: string
description: 'Traffic forwarding mode for this AP Ethernet port. enum: `all`, `limited`, `mxtunnel`, `site_mxedge`, `wxtunnel`.'
examples:
- all
ap_port_config_mac_auth_protocol2:
title: ap_port_config_mac_auth_protocol2
enum:
- eap-md5
- eap-peap
- pap
type: string
description: 'Protocol used for MAC authentication when `enable_mac_auth` is `true`. enum: `eap-md5`, `eap-peap`, `pap`.'
ap_port_config_port_auth2:
title: ap_port_config_port_auth2
enum:
- dot1x
- none
type: string
description: 'Authentication mode for this AP Ethernet port. enum: `dot1x`, `none`.'
examples:
- none
ap_pwr_config2:
title: ap_pwr_config2
type: object
properties:
base:
type: integer
description: Additional power to request during negotiating with PSE over PoE, in mW
contentEncoding: int32
default: 0
examples:
- 2000
prefer_usb_over_wifi:
type: boolean
description: Whether to enable power out to peripheral, meanwhile will reduce power to Wi-Fi (only for AP45 at power mode)
default: false
description: Power negotiation and peripheral power defaults in this AP profile
ap_pwr_config3:
title: ap_pwr_config3
type: object
properties:
base:
type: integer
description: Additional power to request during negotiating with PSE over PoE, in mW
contentEncoding: int32
default: 0
examples:
- 2000
prefer_usb_over_wifi:
type: boolean
description: Whether to enable power out to peripheral, meanwhile will reduce power to Wi-Fi (only for AP45 at power mode)
default: false
description: Power negotiation and peripheral power settings for this access point
ap_radio_antenna_mode2:
title: ap_radio_antenna_mode2
enum:
- 1x1
- 2x2
- 3x3
- 4x4
- default
type: string
description: 'Selected radio chain mode for AP models that support antenna mode control. enum: `1x1`, `2x2`, `3x3`, `4x4`, `default`.'
ap_radio_band51:
title: ap_radio_band51
type: object
properties:
allow_rrm_disable:
type: boolean
description: Whether RRM may disable the 5 GHz radio when optimizing RF settings
default: false
ant_gain:
maximum: 10
minimum: 0
type:
- integer
- 'null'
description: External antenna gain for the 5 GHz radio
contentEncoding: int32
default: 0
antenna_beam_pattern:
allOf:
- $ref: '#/components/schemas/radio_band_antenna_beam_pattern3'
- description: 'Beam pattern used by the 5 GHz radio antenna. enum: `narrow`, `medium`, `wide`.'
antenna_mode:
allOf:
- $ref: '#/components/schemas/radio_band_antenna_mode1'
- description: 'Radio chain mode for the 5 GHz radio. enum: `1x1`, `2x2`, `3x3`, `4x4`, `default`.'
examples:
- default
bandwidth:
allOf:
- $ref: '#/components/schemas/dot11_bandwidth52'
- description: 'Channel width configured for the 5 GHz radio. enum: `0`, `20`, `40`, `80`.'
examples:
- 40
channel:
type:
- integer
- 'null'
description: For Device. (primary) channel for the band, 0 means using the Site Setting
contentEncoding: int32
examples:
- 100
channels:
type:
- array
- 'null'
items:
type: integer
contentEncoding: int32
description: Allowed channel list for the 5 GHz radio; null or an empty array uses automatic selection
default: []
disabled:
type: boolean
description: Whether to disable the radio
default: false
power:
maximum: 25
minimum: 0
type:
- integer
- 'null'
description: Radio Tx power, in dBm. Can be an integer 0-25 for static power configuration, or `null` or unset for auto power mode
contentEncoding: int32
examples:
- 6
power_max:
maximum: 17
minimum: 5
type:
- integer
- 'null'
description: When power=null/unset, max tx power to use, HW-specific values will be used if not set
contentEncoding: int32
power_min:
maximum: 17
minimum: 5
type:
- integer
- 'null'
description: When power=null/unset, min tx power to use, HW-specific values will be used if not set
contentEncoding: int32
preamble:
allOf:
- $ref: '#/components/schemas/radio_band_preamble1'
- description: '802.11 preamble mode used by the 5 GHz radio. enum: `auto`, `long`, `short`.'
description: 5 GHz settings used when the 2.4 GHz radio operates in 5 GHz mode
ap_radio_band53:
title: ap_radio_band53
type: object
properties:
allow_rrm_disable:
type: boolean
description: Whether RRM may disable the 5 GHz radio when optimizing RF settings
default: false
ant_gain:
maximum: 10
minimum: 0
type:
- integer
- 'null'
description: External antenna gain for the 5 GHz radio
contentEncoding: int32
default: 0
antenna_beam_pattern:
allOf:
- $ref: '#/components/schemas/radio_band_antenna_beam_pattern3'
- description: 'Beam pattern used by the 5 GHz radio antenna. enum: `narrow`, `medium`, `wide`.'
antenna_mode:
allOf:
- $ref: '#/components/schemas/radio_band_antenna_mode1'
- description: 'Radio chain mode for the 5 GHz radio. enum: `1x1`, `2x2`, `3x3`, `4x4`, `default`.'
examples:
- default
bandwidth:
allOf:
- $ref: '#/components/schemas/dot11_bandwidth52'
- description: 'Channel width configured for the 5 GHz radio. enum: `0`, `20`, `40`, `80`.'
examples:
- 40
channel:
type:
- integer
- 'null'
description: For Device. (primary) channel for the band, 0 means using the Site Setting
contentEncoding: int32
examples:
- 100
channels:
type:
- array
- 'null'
items:
type: integer
contentEncoding: int32
description: Allowed channel list for the 5 GHz radio; null or an empty array uses automatic selection
default: []
disabled:
type: boolean
description: Whether to disable the radio
default: false
power:
maximum: 25
minimum: 0
type:
- integer
- 'null'
description: Radio Tx power, in dBm. Can be an integer 0-25 for static power configuration, or `null` or unset for auto power mode
contentEncoding: int32
examples:
- 6
power_max:
maximum: 17
minimum: 5
type:
- integer
- 'null'
description: When power=null/unset, max tx power to use, HW-specific values will be used if not set
contentEncoding: int32
power_min:
maximum: 17
minimum: 5
type:
- integer
- 'null'
description: When power=null/unset, min tx power to use, HW-specific values will be used if not set
contentEncoding: int32
preamble:
allOf:
- $ref: '#/components/schemas/radio_band_preamble1'
- description: '802.11 preamble mode used by the 5 GHz radio. enum: `auto`, `long`, `short`.'
description: 5 GHz radio settings for this access point
ap_radio_band62:
title: ap_radio_band62
type: object
properties:
allow_rrm_disable:
type: boolean
description: Whether RRM may disable the 6 GHz radio when optimizing RF settings
default: false
ant_gain:
maximum: 10
minimum: 0
type:
- integer
- 'null'
description: External antenna gain for the 6 GHz radio
contentEncoding: int32
default: 0
antenna_beam_pattern:
allOf:
- $ref: '#/components/schemas/radio_band_antenna_beam_pattern1'
- description: 'Beam pattern used by the 6 GHz radio antenna. enum: `narrow`, `medium`, `wide`.'
antenna_mode:
allOf:
- $ref: '#/components/schemas/radio_band_antenna_mode2'
- description: 'Radio chain mode for the 6 GHz radio. enum: `1x1`, `2x2`, `3x3`, `4x4`, `default`.'
examples:
- default
bandwidth:
allOf:
- $ref: '#/components/schemas/dot11_bandwidth62'
- description: 'Channel width configured for the 6 GHz radio. enum: `0`, `20`, `40`, `80`, `160`.'
examples:
- 80
channel:
type:
- integer
- 'null'
description: For Device. (primary) channel for the band, 0 means using the Site Setting
contentEncoding: int32
examples:
- 0
channels:
type:
- array
- 'null'
items:
type: integer
contentEncoding: int32
description: Allowed channel list for the 6 GHz radio; null or an empty array uses automatic selection
default: []
disabled:
type: boolean
description: Whether to disable the radio
default: false
power:
maximum: 25
minimum: 0
type:
- integer
- 'null'
description: Radio Tx power, in dBm. Can be an integer 0-25 for static power configuration, or `null` or unset for auto power mode
contentEncoding: int32
examples:
- 7
power_max:
maximum: 18
minimum: 5
type:
- integer
- 'null'
description: When power=null/unset, max tx power to use, HW-specific values will be used if not set
contentEncoding: int32
power_min:
maximum: 18
minimum: 5
type:
- integer
- 'null'
description: When power=null/unset, min tx power to use, HW-specific values will be used if not set
contentEncoding: int32
preamble:
allOf:
- $ref: '#/components/schemas/radio_band_preamble2'
- description: '802.11 preamble mode used by the 6 GHz radio. enum: `auto`, `long`, `short`.'
standard_power:
type: boolean
description: For 6GHz Only, standard-power operation, AFC (Automatic Frequency Coordination) will be performed, and we'll fall back to Low Power Indoor if AFC failed
default: false
description: 6 GHz radio settings for this access point
ap_radio_band242:
title: ap_radio_band242
type: object
properties:
allow_rrm_disable:
type: boolean
description: Whether RRM may disable the 2.4 GHz radio when optimizing RF settings
default: false
ant_gain:
maximum: 10
minimum: 0
type:
- integer
- 'null'
description: External antenna gain for the 2.4 GHz radio
contentEncoding: int32
default: 0
antenna_mode:
allOf:
- $ref: '#/components/schemas/radio_band_antenna_mode4'
- description: 'Radio chain mode for the 2.4 GHz radio. enum: `1x1`, `2x2`, `3x3`, `4x4`, `default`.'
examples:
- default
bandwidth:
allOf:
- $ref: '#/components/schemas/dot11_bandwidth242'
- description: 'Channel width configured for the 2.4 GHz radio. enum: `0`, `20`, `40`.'
examples:
- 20
channel:
maximum: 13
minimum: 1
type:
- integer
- 'null'
description: For Device. (primary) channel for the band, 0 means using the Site Setting
contentEncoding: int32
examples:
- 6
channels:
type:
- array
- 'null'
items:
type: integer
contentEncoding: int32
description: Allowed channel list for the 2.4 GHz radio; null or an empty array uses automatic selection
default: []
disabled:
type: boolean
description: Whether to disable the radio
default: false
power:
maximum: 25
minimum: 0
type:
- integer
- 'null'
description: Radio Tx power, in dBm. Can be an integer 0-25 for static power configuration, or `null` or unset for auto power mode
contentEncoding: int32
examples:
- 3
power_max:
maximum: 18
minimum: 3
type:
- integer
- 'null'
description: When power=null/unset, max tx power to use, HW-specific values will be used if not set
contentEncoding: int32
power_min:
maximum: 18
minimum: 3
type:
- integer
- 'null'
description: When power=null/unset, min tx power to use, HW-specific values will be used if not set
contentEncoding: int32
preamble:
allOf:
- $ref: '#/components/schemas/radio_band_preamble4'
- description: '802.11 preamble mode used by the 2.4 GHz radio. enum: `auto`, `long`, `short`.'
description: 2.4 GHz radio settings for this access point
ap_radio_stat1:
title: ap_radio_stat1
type: object
properties:
bandwidth:
allOf:
- $ref: '#/components/schemas/dot11_bandwidth8'
- description: 'Current channel width reported for this radio. enum: `0`, `20`, `40`, `80`, `160`.'
examples:
- 20
channel:
type:
- integer
- 'null'
description: Current channel the radio is running on
contentEncoding: int32
readOnly: true
dynamic_chaining_enabled:
type:
- boolean
- 'null'
description: Use dynamic chaining for downlink
readOnly: true
mac:
type:
- string
- 'null'
description: Radio base MAC address; a base radio MAC can represent up to 16 BSSIDs (e.g. 5c5b350001a0-5c5b350001af)
readOnly: true
noise_floor:
type:
- integer
- 'null'
description: Measured noise floor for this radio, in dBm
contentEncoding: int32
readOnly: true
examples:
- -90
num_clients:
type:
- integer
- 'null'
description: Number of clients currently connected on this radio
contentEncoding: int32
readOnly: true
num_wlans:
type: integer
description: How many WLANs are applied to the radio
contentEncoding: int32
power:
type:
- integer
- 'null'
description: Transmit power (in dBm)
contentEncoding: int32
readOnly: true
rx_bytes:
type:
- integer
- 'null'
description: Received byte count reported for this radio
contentEncoding: int64
readOnly: true
examples:
- 8515104416
rx_pkts:
type:
- integer
- 'null'
description: Received packet count reported for this radio
contentEncoding: int64
readOnly: true
examples:
- 57770567
tx_bytes:
type:
- integer
- 'null'
description: Transmitted byte count reported for this radio
contentEncoding: int64
readOnly: true
examples:
- 211217389682
tx_pkts:
type:
- integer
- 'null'
description: Transmitted packet count reported for this radio
contentEncoding: int64
readOnly: true
examples:
- 812204062
usage:
type:
- string
- 'null'
description: Operating band reported for this radio, such as 24, 5, or 6
readOnly: true
examples:
- '24'
util_all:
type:
- integer
- 'null'
description: All utilization in percentage
contentEncoding: int32
readOnly: true
util_non_wifi:
type:
- integer
- 'null'
description: Reception of "No Packets" utilization in percentage, received frames with invalid PLCPs and CRS glitches as noise
contentEncoding: int32
readOnly: true
util_rx_in_bss:
type:
- integer
- 'null'
description: Reception of "In BSS" utilization in percentage, only frames that are received from AP/STAs within the BSS
contentEncoding: int32
readOnly: true
util_rx_other_bss:
type:
- integer
- 'null'
description: Reception of "Other BSS" utilization in percentage, all frames received from AP/STAs that are outside the BSS
contentEncoding: int32
readOnly: true
util_tx:
type:
- integer
- 'null'
description: Transmission utilization in percentage
contentEncoding: int32
readOnly: true
util_undecodable_wifi:
type:
- integer
- 'null'
description: Reception of "UnDecodable Wifi" utilization in percentage, only Preamble, PLCP header is decoded, Rest is undecodable in this radio
contentEncoding: int32
readOnly: true
util_unknown_wifi:
type:
- integer
- 'null'
description: Reception of "No Category" utilization in percentage, all 802.11 frames that are corrupted at the receiver
contentEncoding: int32
readOnly: true
description: 2.4 GHz radio statistics reported by the AP
ap_radio_stat2:
title: ap_radio_stat2
type: object
properties:
bandwidth:
allOf:
- $ref: '#/components/schemas/dot11_bandwidth8'
- description: 'Current channel width reported for this radio. enum: `0`, `20`, `40`, `80`, `160`.'
examples:
- 20
channel:
type:
- integer
- 'null'
description: Current channel the radio is running on
contentEncoding: int32
readOnly: true
dynamic_chaining_enabled:
type:
- boolean
- 'null'
description: Use dynamic chaining for downlink
readOnly: true
mac:
type:
- string
- 'null'
description: Radio base MAC address; a base radio MAC can represent up to 16 BSSIDs (e.g. 5c5b350001a0-5c5b350001af)
readOnly: true
noise_floor:
type:
- integer
- 'null'
description: Measured noise floor for this radio, in dBm
contentEncoding: int32
readOnly: true
examples:
- -90
num_clients:
type:
- integer
- 'null'
description: Number of clients currently connected on this radio
contentEncoding: int32
readOnly: true
num_wlans:
type: integer
description: How many WLANs are applied to the radio
contentEncoding: int32
power:
type:
- integer
- 'null'
description: Transmit power (in dBm)
contentEncoding: int32
readOnly: true
rx_bytes:
type:
- integer
- 'null'
description: Received byte count reported for this radio
contentEncoding: int64
readOnly: true
examples:
- 8515104416
rx_pkts:
type:
- integer
- 'null'
description: Received packet count reported for this radio
contentEncoding: int64
readOnly: true
examples:
- 57770567
tx_bytes:
type:
- integer
- 'null'
description: Transmitted byte count reported for this radio
contentEncoding: int64
readOnly: true
examples:
- 211217389682
tx_pkts:
type:
- integer
- 'null'
description: Transmitted packet count reported for this radio
contentEncoding: int64
readOnly: true
examples:
- 812204062
usage:
type:
- string
- 'null'
description: Operating band reported for this radio, such as 24, 5, or 6
readOnly: true
examples:
- '24'
util_all:
type:
- integer
- 'null'
description: All utilization in percentage
contentEncoding: int32
readOnly: true
util_non_wifi:
type:
- integer
- 'null'
description: Reception of "No Packets" utilization in percentage, received frames with invalid PLCPs and CRS glitches as noise
contentEncoding: int32
readOnly: true
util_rx_in_bss:
type:
- integer
- 'null'
description: Reception of "In BSS" utilization in percentage, only frames that are received from AP/STAs within the BSS
contentEncoding: int32
readOnly: true
util_rx_other_bss:
type:
- integer
- 'null'
description: Reception of "Other BSS" utilization in percentage, all frames received from AP/STAs that are outside the BSS
contentEncoding: int32
readOnly: true
util_tx:
type:
- integer
- 'null'
description: Transmission utilization in percentage
contentEncoding: int32
readOnly: true
util_undecodable_wifi:
type:
- integer
- 'null'
description: Reception of "UnDecodable Wifi" utilization in percentage, only Preamble, PLCP header is decoded, Rest is undecodable in this radio
contentEncoding: int32
readOnly: true
util_unknown_wifi:
type:
- integer
- 'null'
description: Reception of "No Category" utilization in percentage, all 802.11 frames that are corrupted at the receiver
contentEncoding: int32
readOnly: true
description: 5 GHz radio statistics reported by the AP
ap_radio_stat3:
title: ap_radio_stat3
type: object
properties:
bandwidth:
allOf:
- $ref: '#/components/schemas/dot11_bandwidth8'
- description: 'Current channel width reported for this radio. enum: `0`, `20`, `40`, `80`, `160`.'
examples:
- 20
channel:
type:
- integer
- 'null'
description: Current channel the radio is running on
contentEncoding: int32
readOnly: true
dynamic_chaining_enabled:
type:
- boolean
- 'null'
description: Use dynamic chaining for downlink
readOnly: true
mac:
type:
- string
- 'null'
description: Radio base MAC address; a base radio MAC can represent up to 16 BSSIDs (e.g. 5c5b350001a0-5c5b350001af)
readOnly: true
noise_floor:
type:
- integer
- 'null'
description: Measured noise floor for this radio, in dBm
contentEncoding: int32
readOnly: true
examples:
- -90
num_clients:
type:
- integer
- 'null'
description: Number of clients currently connected on this radio
contentEncoding: int32
readOnly: true
num_wlans:
type: integer
description: How many WLANs are applied to the radio
contentEncoding: int32
power:
type:
- integer
- 'null'
description: Transmit power (in dBm)
contentEncoding: int32
readOnly: true
rx_bytes:
type:
- integer
- 'null'
description: Received byte count reported for this radio
contentEncoding: int64
readOnly: true
examples:
- 8515104416
rx_pkts:
type:
- integer
- 'null'
description: Received packet count reported for this radio
contentEncoding: int64
readOnly: true
examples:
- 57770567
tx_bytes:
type:
- integer
- 'null'
description: Transmitted byte count reported for this radio
contentEncoding: int64
readOnly: true
examples:
- 211217389682
tx_pkts:
type:
- integer
- 'null'
description: Transmitted packet count reported for this radio
contentEncoding: int64
readOnly: true
examples:
- 812204062
usage:
type:
- string
- 'null'
description: Operating band reported for this radio, such as 24, 5, or 6
readOnly: true
examples:
- '24'
util_all:
type:
- integer
- 'null'
description: All utilization in percentage
contentEncoding: int32
readOnly: true
util_non_wifi:
type:
- integer
- 'null'
description: Reception of "No Packets" utilization in percentage, received frames with invalid PLCPs and CRS glitches as noise
contentEncoding: int32
readOnly: true
util_rx_in_bss:
type:
- integer
- 'null'
description: Reception of "In BSS" utilization in percentage, only frames that are received from AP/STAs within the BSS
contentEncoding: int32
readOnly: true
util_rx_other_bss:
type:
- integer
- 'null'
description: Reception of "Other BSS" utilization in percentage, all frames received from AP/STAs that are outside the BSS
contentEncoding: int32
readOnly: true
util_tx:
type:
- integer
- 'null'
description: Transmission utilization in percentage
contentEncoding: int32
readOnly: true
util_undecodable_wifi:
type:
- integer
- 'null'
description: Reception of "UnDecodable Wifi" utilization in percentage, only Preamble, PLCP header is decoded, Rest is undecodable in this radio
contentEncoding: int32
readOnly: true
util_unknown_wifi:
type:
- integer
- 'null'
description: Reception of "No Category" utilization in percentage, all 802.11 frames that are corrupted at the receiver
contentEncoding: int32
readOnly: true
description: 6 GHz radio statistics reported by the AP
ap_radio2:
title: ap_radio2
type: object
properties:
allow_rrm_disable:
type: boolean
description: Whether RRM can be disabled for individual radio-band settings
default: false
ant_gain_24:
minimum: 0
type: integer
description: Antenna gain for 2.4G - for models with external antenna only
contentEncoding: int32
examples:
- 4
ant_gain_5:
minimum: 0
type: integer
description: Antenna gain for 5G - for models with external antenna only
contentEncoding: int32
examples:
- 5
ant_gain_6:
minimum: 0
type: integer
description: Antenna gain for 6G - for models with external antenna only
contentEncoding: int32
examples:
- 5
antenna_mode:
allOf:
- $ref: '#/components/schemas/ap_radio_antenna_mode2'
- description: 'Selected radio chain mode for AP models that support antenna mode control. enum: `1x1`, `2x2`, `3x3`, `4x4`, `default`.'
antenna_select:
allOf:
- $ref: '#/components/schemas/antenna_select1'
- description: 'Internal or external antenna selection for AP models with selectable antennas. enum: ``, `external`, `internal`.'
examples:
- external
band_24:
allOf:
- $ref: '#/components/schemas/ap_radio_band242'
- description: 2.4 GHz radio settings for this access point
band_24_usage:
allOf:
- $ref: '#/components/schemas/radio_band_24_usage4'
- description: 'Radio usage mode for the 2.4 GHz-capable radio. enum: `24`, `5`, `6`, `auto`.'
band_5:
allOf:
- $ref: '#/components/schemas/ap_radio_band53'
- description: 5 GHz radio settings for this access point
band_5_on_24_radio:
allOf:
- $ref: '#/components/schemas/ap_radio_band51'
- description: 5 GHz settings used when the 2.4 GHz radio operates in 5 GHz mode
band_6:
allOf:
- $ref: '#/components/schemas/ap_radio_band62'
- description: 6 GHz radio settings for this access point
full_automatic_rrm:
type: boolean
description: Let RRM control everything, only the `channels` and `ant_gain` will be honored (i.e. disabled/bandwidth/power/band_24_usage are all controlled by RRM)
default: false
indoor_use:
type: boolean
description: To make an outdoor operate indoor. For an outdoor-ap, some channels are disallowed by default, this allows the user to use it as an indoor-ap
default: false
rrm_managed:
type: boolean
description: Enable RRM to manage all radio settings (ignores all band_xxx configs)
scanning_enabled:
type: boolean
description: Whether scanning radio is enabled
examples:
- true
description: Radio configuration defaults in this AP profile
ap_radio3:
title: ap_radio3
type: object
properties:
allow_rrm_disable:
type: boolean
description: Whether RRM can be disabled for individual radio-band settings
default: false
ant_gain_24:
minimum: 0
type: integer
description: Antenna gain for 2.4G - for models with external antenna only
contentEncoding: int32
examples:
- 4
ant_gain_5:
minimum: 0
type: integer
description: Antenna gain for 5G - for models with external antenna only
contentEncoding: int32
examples:
- 5
ant_gain_6:
minimum: 0
type: integer
description: Antenna gain for 6G - for models with external antenna only
contentEncoding: int32
examples:
- 5
antenna_mode:
allOf:
- $ref: '#/components/schemas/ap_radio_antenna_mode2'
- description: 'Selected radio chain mode for AP models that support antenna mode control. enum: `1x1`, `2x2`, `3x3`, `4x4`, `default`.'
antenna_select:
allOf:
- $ref: '#/components/schemas/antenna_select1'
- description: 'Internal or external antenna selection for AP models with selectable antennas. enum: ``, `external`, `internal`.'
examples:
- external
band_24:
allOf:
- $ref: '#/components/schemas/ap_radio_band242'
- description: 2.4 GHz radio settings for this access point
band_24_usage:
allOf:
- $ref: '#/components/schemas/radio_band_24_usage4'
- description: 'Radio usage mode for the 2.4 GHz-capable radio. enum: `24`, `5`, `6`, `auto`.'
band_5:
allOf:
- $ref: '#/components/schemas/ap_radio_band53'
- description: 5 GHz radio settings for this access point
band_5_on_24_radio:
allOf:
- $ref: '#/components/schemas/ap_radio_band51'
- description: 5 GHz settings used when the 2.4 GHz radio operates in 5 GHz mode
band_6:
allOf:
- $ref: '#/components/schemas/ap_radio_band62'
- description: 6 GHz radio settings for this access point
full_automatic_rrm:
type: boolean
description: Let RRM control everything, only the `channels` and `ant_gain` will be honored (i.e. disabled/bandwidth/power/band_24_usage are all controlled by RRM)
default: false
indoor_use:
type: boolean
description: To make an outdoor operate indoor. For an outdoor-ap, some channels are disallowed by default, this allows the user to use it as an indoor-ap
default: false
rrm_managed:
type: boolean
description: Enable RRM to manage all radio settings (ignores all band_xxx configs)
scanning_enabled:
type: boolean
description: Whether scanning radio is enabled
examples:
- true
description: AP radio configuration for the site
ap_radio4:
title: ap_radio4
type: object
properties:
allow_rrm_disable:
type: boolean
description: Whether RRM can be disabled for individual radio-band settings
default: false
ant_gain_24:
minimum: 0
type: integer
description: Antenna gain for 2.4G - for models with external antenna only
contentEncoding: int32
examples:
- 4
ant_gain_5:
minimum: 0
type: integer
description: Antenna gain for 5G - for models with external antenna only
contentEncoding: int32
examples:
- 5
ant_gain_6:
minimum: 0
type: integer
description: Antenna gain for 6G - for models with external antenna only
contentEncoding: int32
examples:
- 5
antenna_mode:
allOf:
- $ref: '#/components/schemas/ap_radio_antenna_mode2'
- description: 'Selected radio chain mode for AP models that support antenna mode control. enum: `1x1`, `2x2`, `3x3`, `4x4`, `default`.'
antenna_select:
allOf:
- $ref: '#/components/schemas/antenna_select1'
- description: 'Internal or external antenna selection for AP models with selectable antennas. enum: ``, `external`, `internal`.'
examples:
- external
band_24:
allOf:
- $ref: '#/components/schemas/ap_radio_band242'
- description: 2.4 GHz radio settings for this access point
band_24_usage:
allOf:
- $ref: '#/components/schemas/radio_band_24_usage4'
- description: 'Radio usage mode for the 2.4 GHz-capable radio. enum: `24`, `5`, `6`, `auto`.'
band_5:
allOf:
- $ref: '#/components/schemas/ap_radio_band53'
- description: 5 GHz radio settings for this access point
band_5_on_24_radio:
allOf:
- $ref: '#/components/schemas/ap_radio_band51'
- description: 5 GHz settings used when the 2.4 GHz radio operates in 5 GHz mode
band_6:
allOf:
- $ref: '#/components/schemas/ap_radio_band62'
- description: 6 GHz radio settings for this access point
full_automatic_rrm:
type: boolean
description: Let RRM control everything, only the `channels` and `ant_gain` will be honored (i.e. disabled/bandwidth/power/band_24_usage are all controlled by RRM)
default: false
indoor_use:
type: boolean
description: To make an outdoor operate indoor. For an outdoor-ap, some channels are disallowed by default, this allows the user to use it as an indoor-ap
default: false
rrm_managed:
type: boolean
description: Enable RRM to manage all radio settings (ignores all band_xxx configs)
scanning_enabled:
type: boolean
description: Whether scanning radio is enabled
examples:
- true
description: Radio configuration overrides for this access point
ap_redundancy1:
title: ap_redundancy1
type: object
properties:
modules:
type: object
additionalProperties:
$ref: '#/components/schemas/ap_redundancy_module'
description: Per-module AP redundancy counts keyed by switch node ID
num_aps:
type: integer
description: Total number of APs considered for switch redundancy
contentEncoding: int32
examples:
- 15
num_aps_with_switch_redundancy:
type: integer
description: Number of APs that have switch redundancy coverage
contentEncoding: int32
examples:
- 8
description: AP switch redundancy summary for APs connected through the discovered switch
ap_redundancy2:
title: ap_redundancy2
type: object
properties:
modules:
type: object
additionalProperties:
$ref: '#/components/schemas/ap_redundancy_module'
description: Per-module AP redundancy counts keyed by switch node ID
num_aps:
type: integer
description: Total number of APs considered for switch redundancy
contentEncoding: int32
examples:
- 15
num_aps_with_switch_redundancy:
type: integer
description: Number of APs that have switch redundancy coverage
contentEncoding: int32
examples:
- 8
description: AP redundancy statistics associated with the gateway
ap_stat_mesh_uplink1:
title: ap_stat_mesh_uplink1
type: object
properties:
band:
type: string
description: Radio band used by this mesh uplink
examples:
- '5'
channel:
type: integer
description: Radio channel used by this mesh uplink
contentEncoding: int32
examples:
- 36
idle_time:
type: integer
description: Seconds since traffic was last observed on this mesh uplink
contentEncoding: int32
examples:
- 3
last_seen:
type:
- number
- 'null'
description: Timestamp when this mesh uplink was last observed
readOnly: true
examples:
- 1470417522
proto:
type: string
description: 802.11 protocol reported for this mesh uplink
examples:
- n
rssi:
type: integer
description: Received signal strength for this mesh uplink, in dBm
contentEncoding: int32
examples:
- -65
rx_bps:
type:
- integer
- 'null'
description: Inbound throughput on this mesh uplink, in bits per second
contentEncoding: int64
readOnly: true
examples:
- 60003
rx_bytes:
type:
- integer
- 'null'
description: Inbound byte count for this mesh uplink
contentEncoding: int64
readOnly: true
examples:
- 8515104416
rx_packets:
type:
- integer
- 'null'
description: Inbound packet count for this mesh uplink
contentEncoding: int64
readOnly: true
examples:
- 57770567
rx_rate:
type:
- number
- 'null'
description: Inbound data rate reported for this mesh uplink
readOnly: true
rx_retries:
type:
- integer
- 'null'
description: Inbound retry count reported for this mesh uplink
contentEncoding: int32
readOnly: true
site_id:
type: string
description: Site associated with this mesh uplink statistic
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
snr:
type: integer
description: Signal-to-noise ratio for this mesh uplink, in dB
contentEncoding: int32
examples:
- 31
tx_bps:
type:
- integer
- 'null'
description: Outbound throughput on this mesh uplink, in bits per second
contentEncoding: int64
readOnly: true
examples:
- 634301
tx_bytes:
type:
- integer
- 'null'
description: Outbound byte count for this mesh uplink
contentEncoding: int64
readOnly: true
examples:
- 211217389682
tx_packets:
type:
- integer
- 'null'
description: Outbound packet count for this mesh uplink
contentEncoding: int64
readOnly: true
examples:
- 812204062
tx_rate:
type:
- number
- 'null'
description: Outbound data rate reported for this mesh uplink
readOnly: true
tx_retries:
type:
- integer
- 'null'
description: Outbound retry count reported for this mesh uplink
contentEncoding: int32
readOnly: true
uplink_ap_id:
type: string
description: Identifier of the upstream AP for this mesh uplink
contentEncoding: uuid
examples:
- 00000000-0000-0000-1000-5c5b35000010
description: Mesh uplink status for the AP
ap_switch_setting1:
title: ap_switch_setting1
type: object
properties:
enable_vlan:
type: boolean
description: Whether VLAN tagging is enabled for this AP switch-config port
port_vlan_id:
anyOf:
- maximum: 4094
minimum: 1
type: integer
contentEncoding: int32
- type: string
description: Native VLAN ID for this AP switch-config port
vlan_ids:
type: array
items:
maximum: 4094
minimum: 1
type: integer
contentEncoding: int32
description: Allowed VLAN IDs for this AP switch-config port
description: VLAN settings for AP eth1
ap_switch_setting2:
title: ap_switch_setting2
type: object
properties:
enable_vlan:
type: boolean
description: Whether VLAN tagging is enabled for this AP switch-config port
port_vlan_id:
anyOf:
- maximum: 4094
minimum: 1
type: integer
contentEncoding: int32
- type: string
description: Native VLAN ID for this AP switch-config port
vlan_ids:
type: array
items:
maximum: 4094
minimum: 1
type: integer
contentEncoding: int32
description: Allowed VLAN IDs for this AP switch-config port
description: VLAN settings for AP eth2
ap_switch_setting3:
title: ap_switch_setting3
type: object
properties:
enable_vlan:
type: boolean
description: Whether VLAN tagging is enabled for this AP switch-config port
port_vlan_id:
anyOf:
- maximum: 4094
minimum: 1
type: integer
contentEncoding: int32
- type: string
description: Native VLAN ID for this AP switch-config port
vlan_ids:
type: array
items:
maximum: 4094
minimum: 1
type: integer
contentEncoding: int32
description: Allowed VLAN IDs for this AP switch-config port
description: VLAN settings for AP eth3
ap_switch_setting4:
title: ap_switch_setting4
type: object
properties:
enable_vlan:
type: boolean
description: Whether VLAN tagging is enabled for this AP switch-config port
port_vlan_id:
anyOf:
- maximum: 4094
minimum: 1
type: integer
contentEncoding: int32
- type: string
description: Native VLAN ID for this AP switch-config port
vlan_ids:
type: array
items:
maximum: 4094
minimum: 1
type: integer
contentEncoding: int32
description: Allowed VLAN IDs for this AP switch-config port
description: VLAN settings for the AP module port
ap_switch_setting5:
title: ap_switch_setting5
type: object
properties:
enable_vlan:
type: boolean
description: Whether VLAN tagging is enabled for this AP switch-config port
port_vlan_id:
anyOf:
- maximum: 4094
minimum: 1
type: integer
contentEncoding: int32
- type: string
description: Native VLAN ID for this AP switch-config port
vlan_ids:
type: array
items:
maximum: 4094
minimum: 1
type: integer
contentEncoding: int32
description: Allowed VLAN IDs for this AP switch-config port
description: VLAN settings for WDS traffic on the AP
ap_switch_setting7:
title: ap_switch_setting7
type: object
properties:
enable_vlan:
type: boolean
description: Whether VLAN tagging is enabled for this AP switch-config port
port_vlan_id:
anyOf:
- maximum: 4094
minimum: 1
type: integer
contentEncoding: int32
- type: string
description: Native VLAN ID for this AP switch-config port
vlan_ids:
type: array
items:
maximum: 4094
minimum: 1
type: integer
contentEncoding: int32
description: Allowed VLAN IDs for this AP switch-config port
description: VLAN settings for AP eth0
ap_switch1:
title: ap_switch1
type: object
properties:
enabled:
type: boolean
description: Whether deprecated AP switch VLAN control is enabled
default: false
eth0:
allOf:
- $ref: '#/components/schemas/ap_switch_setting7'
- description: VLAN settings for AP eth0
eth1:
allOf:
- $ref: '#/components/schemas/ap_switch_setting1'
- description: VLAN settings for AP eth1
eth2:
allOf:
- $ref: '#/components/schemas/ap_switch_setting2'
- description: VLAN settings for AP eth2
eth3:
allOf:
- $ref: '#/components/schemas/ap_switch_setting3'
- description: VLAN settings for AP eth3
module:
allOf:
- $ref: '#/components/schemas/ap_switch_setting4'
- description: VLAN settings for the AP module port
wds:
allOf:
- $ref: '#/components/schemas/ap_switch_setting5'
- description: VLAN settings for WDS traffic on the AP
description: Deprecated AP switch configuration defaults in this profile
deprecated: true
ap_template_matching2:
title: ap_template_matching2
type: object
properties:
enabled:
type: boolean
description: Whether AP matching is enabled for this AP template
rules:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/ap_template_matching_rule'
description: AP matching entries that select access points and apply AP port configuration
description: Rules used to select access points for this AP template
ap_template_wifi2:
title: ap_template_wifi2
type: object
properties:
cisco_enabled:
type: boolean
description: Whether Cisco-specific Wi-Fi compatibility behavior is enabled
disable_11k:
type: boolean
description: Whether 802.11k neighbor reports are disabled
default: false
disable_radios_when_power_constrained:
type: boolean
description: Whether AP radios are disabled when power is constrained
enable_arp_spoof:
type: boolean
description: Whether ARP spoofing checks are enabled when proxy ARP is used
enable_shared_radio_scanning:
type: boolean
description: Whether shared radio scanning is enabled for AP radio scanning
default: false
enabled:
type: boolean
description: Whether Wi-Fi settings in this AP template are enabled
default: true
locate_connected:
type: boolean
description: Whether location tracking is enabled for connected clients
default: false
locate_unconnected:
type: boolean
description: Whether location tracking is enabled for unconnected clients
default: false
mesh_allow_dfs:
type: boolean
description: Whether mesh links may use DFS channels, which can add CAC delays during scanning
default: false
mesh_enable_crm:
type: boolean
description: Whether CRM is enabled for mesh networking in this AP template
mesh_enabled:
type: boolean
description: Whether mesh networking is enabled by this AP template
proxy_arp:
type: boolean
description: Whether proxy ARP is enabled for Wi-Fi clients
default: false
description: Wi-Fi and mesh settings applied by this AP template
ap_uplink_port_config2:
title: ap_uplink_port_config2
type: object
properties:
dot1x:
type: boolean
description: Whether to do 802.1x against uplink switch. When enabled, AP cert will be used to do EAP-TLS and the Org's CA Cert has to be provisioned at the switch
default: false
keep_wlans_up_if_down:
type: boolean
description: By default, WLANs are disabled when uplink is down. In some scenario, like SiteSurvey, one would want the AP to keep sending beacons.
default: false
description: Authentication and failover defaults for AP uplink ports
ap_uplink_port_config3:
title: ap_uplink_port_config3
type: object
properties:
dot1x:
type: boolean
description: Whether to do 802.1x against uplink switch. When enabled, AP cert will be used to do EAP-TLS and the Org's CA Cert has to be provisioned at the switch
default: false
keep_wlans_up_if_down:
type: boolean
description: By default, WLANs are disabled when uplink is down. In some scenario, like SiteSurvey, one would want the AP to keep sending beacons.
default: false
description: AP uplink port configuration for the site
ap_uplink_port_config4:
title: ap_uplink_port_config4
type: object
properties:
dot1x:
type: boolean
description: Whether to do 802.1x against uplink switch. When enabled, AP cert will be used to do EAP-TLS and the Org's CA Cert has to be provisioned at the switch
default: false
keep_wlans_up_if_down:
type: boolean
description: By default, WLANs are disabled when uplink is down. In some scenario, like SiteSurvey, one would want the AP to keep sending beacons.
default: false
description: Authentication and failover behavior for AP uplink ports
ap_usb_type2:
title: ap_usb_type2
enum:
- hanshow
- imagotag
- solum
type: string
description: 'USB integration type for this legacy AP USB configuration. enum: `hanshow`, `imagotag`, `solum`.'
examples:
- imagotag
ap_usb2:
title: ap_usb2
type: object
properties:
cacert:
type:
- string
- 'null'
description: Only if `type`==`imagotag`. CA certificate used to validate the Imagotag service certificate
channel:
type: integer
description: Only if `type`==`imagotag`, channel selection, not needed by default, required for manual channel override only
contentEncoding: int32
examples:
- 3
enabled:
type: boolean
description: Whether to enable any usb config
host:
type: string
description: Only if `type`==`imagotag`. Imagotag service host or IP address contacted by the AP
examples:
- 1.1.1.1
port:
type: integer
description: Only if `type`==`imagotag`. TCP port used to reach the Imagotag service
contentEncoding: int32
default: 0
examples:
- 0
type:
allOf:
- $ref: '#/components/schemas/ap_usb_type2'
- description: 'USB integration type for this legacy AP USB configuration. enum: `hanshow`, `imagotag`, `solum`.'
examples:
- imagotag
verify_cert:
type: boolean
description: Only if `type`==`imagotag`, whether to turn on SSL verification
vlan_id:
type: integer
description: Only if `type`==`solum` or `type`==`hanshow`
contentEncoding: int32
default: 1
description: Legacy USB integration defaults in this AP profile
ap_usb3:
title: ap_usb3
type: object
properties:
cacert:
type:
- string
- 'null'
description: Only if `type`==`imagotag`. CA certificate used to validate the Imagotag service certificate
channel:
type: integer
description: Only if `type`==`imagotag`, channel selection, not needed by default, required for manual channel override only
contentEncoding: int32
examples:
- 3
enabled:
type: boolean
description: Whether to enable any usb config
host:
type: string
description: Only if `type`==`imagotag`. Imagotag service host or IP address contacted by the AP
examples:
- 1.1.1.1
port:
type: integer
description: Only if `type`==`imagotag`. TCP port used to reach the Imagotag service
contentEncoding: int32
default: 0
examples:
- 0
type:
allOf:
- $ref: '#/components/schemas/ap_usb_type2'
- description: 'USB integration type for this legacy AP USB configuration. enum: `hanshow`, `imagotag`, `solum`.'
examples:
- imagotag
verify_cert:
type: boolean
description: Only if `type`==`imagotag`, whether to turn on SSL verification
vlan_id:
type: integer
description: Only if `type`==`solum` or `type`==`hanshow`
contentEncoding: int32
default: 1
description: Legacy USB integration settings for this access point
ap_uwb_config2:
title: ap_uwb_config2
type: object
properties:
enabled:
type: boolean
description: Whether UWB RTLS integration is enabled
default: false
host:
type: string
description: RTLS server hostname or IP address
examples:
- coriva.example.com
port:
maximum: 65535
minimum: 1
type: integer
description: RTLS server port number
contentEncoding: int32
examples:
- 9000
slot:
maximum: 15
minimum: 0
type: integer
description: UWB time slot assigned to this AP, 0–15
contentEncoding: int32
default: 0
examples:
- 0
type:
allOf:
- $ref: '#/components/schemas/ap_uwb_config_type'
- description: 'UWB integration type. enum: `zigpos`'
description: UWB RTLS / OMLOX asset-visibility settings; overrides the site-level `uwb_config` and is overridden by device-level `uwb_config`
ap_uwb_config3:
title: ap_uwb_config3
type: object
properties:
enabled:
type: boolean
description: Whether UWB RTLS integration is enabled
default: false
host:
type: string
description: RTLS server hostname or IP address
examples:
- coriva.example.com
port:
maximum: 65535
minimum: 1
type: integer
description: RTLS server port number
contentEncoding: int32
examples:
- 9000
slot:
maximum: 15
minimum: 0
type: integer
description: UWB time slot assigned to this AP, 0–15
contentEncoding: int32
default: 0
examples:
- 0
type:
allOf:
- $ref: '#/components/schemas/ap_uwb_config_type'
- description: 'UWB integration type. enum: `zigpos`'
description: UWB RTLS (OMLOX asset visibility) settings for the site, only effective on AP models with a UWB radio and in countries where the UWB radio is permitted. Overridden by the device profile and device-level settings
ap_uwb_config4:
title: ap_uwb_config4
type: object
properties:
enabled:
type: boolean
description: Whether UWB RTLS integration is enabled
default: false
host:
type: string
description: RTLS server hostname or IP address
examples:
- coriva.example.com
port:
maximum: 65535
minimum: 1
type: integer
description: RTLS server port number
contentEncoding: int32
examples:
- 9000
slot:
maximum: 15
minimum: 0
type: integer
description: UWB time slot assigned to this AP, 0–15
contentEncoding: int32
default: 0
examples:
- 0
type:
allOf:
- $ref: '#/components/schemas/ap_uwb_config_type'
- description: 'UWB integration type. enum: `zigpos`'
description: UWB RTLS / OMLOX asset-visibility settings; overrides the device profile and site-level `uwb_config`
ap_zigbee_allow_join2:
title: ap_zigbee_allow_join2
enum:
- always
- manual
type: string
description: 'Join policy for new Zigbee devices on this AP. enum: `always`, `manual`.'
examples:
- manual
ap_zigbee2:
title: ap_zigbee2
type: object
properties:
allow_join:
allOf:
- $ref: '#/components/schemas/ap_zigbee_allow_join2'
- description: 'Join policy for new Zigbee devices on this AP. enum: `always`, `manual`.'
examples:
- manual
channel:
maximum: 26
minimum: 0
type: integer
description: Zigbee channel (2.4 GHz). `0` means auto; valid fixed values are 11–26
contentEncoding: int32
default: 0
examples:
- 0
enabled:
type: boolean
description: Whether to enable Zigbee on this AP
default: false
extended_pan_id:
type:
- string
- 'null'
description: Extended PAN ID in hex string format; only applicable when `pan_id` is also specified
examples:
- '1311768467294899695'
pan_id:
type:
- string
- 'null'
description: PAN ID in hex string format; if not specified, assigned automatically
examples:
- 0x1234
description: Zigbee radio and network defaults in this AP profile
ap_zigbee3:
title: ap_zigbee3
type: object
properties:
allow_join:
allOf:
- $ref: '#/components/schemas/ap_zigbee_allow_join2'
- description: 'Join policy for new Zigbee devices on this AP. enum: `always`, `manual`.'
examples:
- manual
channel:
maximum: 26
minimum: 0
type: integer
description: Zigbee channel (2.4 GHz). `0` means auto; valid fixed values are 11–26
contentEncoding: int32
default: 0
examples:
- 0
enabled:
type: boolean
description: Whether to enable Zigbee on this AP
default: false
extended_pan_id:
type:
- string
- 'null'
description: Extended PAN ID in hex string format; only applicable when `pan_id` is also specified
examples:
- '1311768467294899695'
pan_id:
type:
- string
- 'null'
description: PAN ID in hex string format; if not specified, assigned automatically
examples:
- 0x1234
description: Zigbee radio and network settings for this access point
app_probing_custom_app_protocol2:
title: app_probing_custom_app_protocol2
enum:
- http
- icmp
type: string
description: 'Probe protocol used by this custom application definition. enum: `http`, `icmp`.'
app_probing1:
title: app_probing1
type: object
properties:
apps:
type: array
items:
type: string
description: Predefined application keys to probe
examples:
- - facebook
custom_apps:
type: array
items:
$ref: '#/components/schemas/app_probing_custom_app'
description: User-defined application probe definitions
enabled:
type: boolean
description: Whether gateway application probing is enabled
description: Application probing configuration for gateway monitoring
arp_table_stats1:
title: arp_table_stats1
type: object
properties:
arp_table_count:
type: integer
description: Number of ARP table entries currently present on the device
contentEncoding: int32
max_entries_supported:
type: integer
description: Supported ARP table capacity for the device
contentEncoding: int32
description: ARP table utilization statistics for the switch
arp_table_stats2:
title: arp_table_stats2
type: object
properties:
arp_table_count:
type: integer
description: Number of ARP table entries currently present on the device
contentEncoding: int32
max_entries_supported:
type: integer
description: Supported ARP table capacity for the device
contentEncoding: int32
description: ARP table utilization statistics for the gateway
auto_placement_info_status1:
title: auto_placement_info_status1
enum:
- done
- error
- inprogress
- pending
type: string
description: 'Current autoplacement processing state. enum: `done`, `error`, `inprogress`, `pending`.'
auto_preemption1:
title: auto_preemption1
type: object
properties:
day_of_week:
allOf:
- $ref: '#/components/schemas/day_of_week7'
- description: 'Scheduled weekday for auto preemption. enum: `any`, `fri`, `mon`, `sat`, `sun`, `thu`, `tue`, `wed`.'
enabled:
type: boolean
description: Whether auto preemption is enabled
default: false
time_of_day:
type: string
description: Scheduled time of day for auto preemption
default: any
examples:
- 12:00
description: Preemption behavior for restoring preferred tunnel peers after failover
avprofile_fallback_action2:
title: avprofile_fallback_action2
enum:
- block
- log-and-permit
- permit
type: string
description: 'Action to take when antivirus scanning cannot complete. enum: `block`, `log-and-permit`, `permit`.'
beacon_type2:
title: beacon_type2
enum:
- eddystone-uid
- eddystone-url
- ibeacon
type: string
description: 'Beacon advertisement format used by this beacon. enum: `eddystone-uid`, `eddystone-url`, `ibeacon`.'
bgp_config_type2:
title: bgp_config_type2
enum:
- external
- internal
type: string
description: Required if `via`==`lan`, `via`==`tunnel` or `via`==`wan`; BGP session type, internal or external
bgp_config_via2:
title: bgp_config_via2
enum:
- lan
- tunnel
- vpn
- wan
type: string
description: Transport used for this BGP session, such as LAN, tunnel, VPN, or WAN
bgp_stats_state1:
title: bgp_stats_state1
enum:
- active
- connect
- established
- idle
- open_config
- open_sent
type: string
description: 'Current state of the BGP session. enum: `active`, `connect`, `established`, `idle`, `open_config`, `open_sent`.'
examples:
- established
ble_config_beacon_rate_mode2:
title: ble_config_beacon_rate_mode2
enum:
- custom
- default
type: string
description: 'Beacon rate mode for Mist BLE beacons; use custom to set beacon_rate. enum: `custom`, `default`.'
examples:
- custom
ble_config_power_mode2:
title: ble_config_power_mode2
enum:
- custom
- default
type: string
description: 'Transmit power mode for the virtual beacon. enum: `custom`, `default`.'
examples:
- custom
ble_config_power_mode3:
title: ble_config_power_mode3
enum:
- custom
- default
type: string
description: 'Transmit power mode for BLE beacons; use custom to set `power`. enum: `custom`, `default`.'
examples:
- custom
ble_config2:
title: ble_config2
type: object
properties:
beacon_enabled:
type: boolean
description: Whether Mist beacons is enabled
default: true
beacon_rate:
type: integer
description: Required if `beacon_rate_mode`==`custom`, 1-10, in number-beacons-per-second
contentEncoding: int32
examples:
- 3
beacon_rate_mode:
allOf:
- $ref: '#/components/schemas/ble_config_beacon_rate_mode2'
- description: 'Beacon rate mode for Mist BLE beacons; use custom to set beacon_rate. enum: `custom`, `default`.'
examples:
- custom
beam_disabled:
type: array
items:
type: integer
contentEncoding: int32
description: AP BLE beam numbers disabled for location advertisements
examples:
- - 1
- 3
- 6
custom_ble_packet_enabled:
type: boolean
description: Can be enabled if `beacon_enabled`==`true`, whether to send custom packet
default: false
custom_ble_packet_frame:
type: string
description: The custom frame to be sent out in this beacon. The frame must be a hexstring
examples:
- 0x........
custom_ble_packet_freq_msec:
minimum: 0
type: integer
description: Frequency (msec) of data emitted by custom ble beacon
contentEncoding: int32
default: 0
examples:
- 300
eddystone_uid_adv_power:
maximum: 20
minimum: -100
type: integer
description: Advertised TX Power, -100 to 20 (dBm), omit this attribute to use default
contentEncoding: int32
default: 0
examples:
- -65
eddystone_uid_beams:
type: string
description: BLE beams used to transmit Eddystone-UID advertisements, expressed as ranges such as `2-4,7`
examples:
- 2-4,7
eddystone_uid_enabled:
type: boolean
description: Only if `beacon_enabled`==`false`, Whether Eddystone-UID beacon is enabled
default: false
eddystone_uid_freq_msec:
type: integer
description: Frequency (msec) of data emit by Eddystone-UID beacon
contentEncoding: int32
default: 0
examples:
- 200
eddystone_uid_instance:
type: string
description: Eddystone-UID instance for the device
examples:
- 5c5b35000001
eddystone_uid_namespace:
type: string
description: Eddystone-UID namespace broadcast by the AP, as a 10-byte hex string
examples:
- 2818e3868dec25629ede
eddystone_url_adv_power:
maximum: 20
minimum: -100
type: integer
description: Advertised TX Power, -100 to 20 (dBm), omit this attribute to use default
contentEncoding: int32
default: 0
examples:
- -65
eddystone_url_beams:
type: string
description: BLE beams used to transmit Eddystone-URL advertisements, expressed as ranges such as `2-4,7`
examples:
- 2-4,7
eddystone_url_enabled:
type: boolean
description: Only if `beacon_enabled`==`false`, Whether Eddystone-URL beacon is enabled
default: false
eddystone_url_freq_msec:
type: integer
description: Frequency (msec) of data emitted by Eddystone-URL beacon
contentEncoding: int32
default: 0
examples:
- 1000
eddystone_url_url:
type: string
description: URL pointed by Eddystone-URL beacon
examples:
- https://www.abc.com
ibeacon_adv_power:
maximum: 20
minimum: -100
type: integer
description: Advertised TX Power, -100 to 20 (dBm), omit this attribute to use default
contentEncoding: int32
default: 0
examples:
- -65
ibeacon_beams:
type: string
description: BLE beams used to transmit iBeacon advertisements, expressed as ranges such as `2-4,7`
examples:
- 2-4,7
ibeacon_enabled:
type: boolean
description: Can be enabled if `beacon_enabled`==`true`, whether to send iBeacon
default: false
ibeacon_freq_msec:
type: integer
description: Frequency (msec) of data emit for iBeacon
contentEncoding: int32
default: 0
ibeacon_major:
maximum: 65535
minimum: 1
type:
- integer
- 'null'
description: iBeacon major value broadcast by the AP
contentEncoding: int32
examples:
- 1234
ibeacon_minor:
maximum: 65535
minimum: 1
type:
- integer
- 'null'
description: iBeacon minor value broadcast by the AP
contentEncoding: int32
examples:
- 1234
ibeacon_uuid:
type: string
description: Optional, if not specified, the same UUID as the beacon will be used
contentEncoding: uuid
examples:
- f3f17139-704a-f03a-2786-0400279e37c3
power:
maximum: 10
minimum: 1
type: integer
description: Required if `power_mode`==`custom`; else use `power_mode` as default
contentEncoding: int32
default: 9
examples:
- 6
power_mode:
allOf:
- $ref: '#/components/schemas/ble_config_power_mode3'
- description: 'Transmit power mode for BLE beacons; use custom to set `power`. enum: `custom`, `default`.'
examples:
- custom
description: Bluetooth Low Energy beacon and asset defaults in this AP profile
ble_config3:
title: ble_config3
type: object
properties:
beacon_enabled:
type: boolean
description: Whether Mist beacons is enabled
default: true
beacon_rate:
type: integer
description: Required if `beacon_rate_mode`==`custom`, 1-10, in number-beacons-per-second
contentEncoding: int32
examples:
- 3
beacon_rate_mode:
allOf:
- $ref: '#/components/schemas/ble_config_beacon_rate_mode2'
- description: 'Beacon rate mode for Mist BLE beacons; use custom to set beacon_rate. enum: `custom`, `default`.'
examples:
- custom
beam_disabled:
type: array
items:
type: integer
contentEncoding: int32
description: AP BLE beam numbers disabled for location advertisements
examples:
- - 1
- 3
- 6
custom_ble_packet_enabled:
type: boolean
description: Can be enabled if `beacon_enabled`==`true`, whether to send custom packet
default: false
custom_ble_packet_frame:
type: string
description: The custom frame to be sent out in this beacon. The frame must be a hexstring
examples:
- 0x........
custom_ble_packet_freq_msec:
minimum: 0
type: integer
description: Frequency (msec) of data emitted by custom ble beacon
contentEncoding: int32
default: 0
examples:
- 300
eddystone_uid_adv_power:
maximum: 20
minimum: -100
type: integer
description: Advertised TX Power, -100 to 20 (dBm), omit this attribute to use default
contentEncoding: int32
default: 0
examples:
- -65
eddystone_uid_beams:
type: string
description: BLE beams used to transmit Eddystone-UID advertisements, expressed as ranges such as `2-4,7`
examples:
- 2-4,7
eddystone_uid_enabled:
type: boolean
description: Only if `beacon_enabled`==`false`, Whether Eddystone-UID beacon is enabled
default: false
eddystone_uid_freq_msec:
type: integer
description: Frequency (msec) of data emit by Eddystone-UID beacon
contentEncoding: int32
default: 0
examples:
- 200
eddystone_uid_instance:
type: string
description: Eddystone-UID instance for the device
examples:
- 5c5b35000001
eddystone_uid_namespace:
type: string
description: Eddystone-UID namespace broadcast by the AP, as a 10-byte hex string
examples:
- 2818e3868dec25629ede
eddystone_url_adv_power:
maximum: 20
minimum: -100
type: integer
description: Advertised TX Power, -100 to 20 (dBm), omit this attribute to use default
contentEncoding: int32
default: 0
examples:
- -65
eddystone_url_beams:
type: string
description: BLE beams used to transmit Eddystone-URL advertisements, expressed as ranges such as `2-4,7`
examples:
- 2-4,7
eddystone_url_enabled:
type: boolean
description: Only if `beacon_enabled`==`false`, Whether Eddystone-URL beacon is enabled
default: false
eddystone_url_freq_msec:
type: integer
description: Frequency (msec) of data emitted by Eddystone-URL beacon
contentEncoding: int32
default: 0
examples:
- 1000
eddystone_url_url:
type: string
description: URL pointed by Eddystone-URL beacon
examples:
- https://www.abc.com
ibeacon_adv_power:
maximum: 20
minimum: -100
type: integer
description: Advertised TX Power, -100 to 20 (dBm), omit this attribute to use default
contentEncoding: int32
default: 0
examples:
- -65
ibeacon_beams:
type: string
description: BLE beams used to transmit iBeacon advertisements, expressed as ranges such as `2-4,7`
examples:
- 2-4,7
ibeacon_enabled:
type: boolean
description: Can be enabled if `beacon_enabled`==`true`, whether to send iBeacon
default: false
ibeacon_freq_msec:
type: integer
description: Frequency (msec) of data emit for iBeacon
contentEncoding: int32
default: 0
ibeacon_major:
maximum: 65535
minimum: 1
type:
- integer
- 'null'
description: iBeacon major value broadcast by the AP
contentEncoding: int32
examples:
- 1234
ibeacon_minor:
maximum: 65535
minimum: 1
type:
- integer
- 'null'
description: iBeacon minor value broadcast by the AP
contentEncoding: int32
examples:
- 1234
ibeacon_uuid:
type: string
description: Optional, if not specified, the same UUID as the beacon will be used
contentEncoding: uuid
examples:
- f3f17139-704a-f03a-2786-0400279e37c3
power:
maximum: 10
minimum: 1
type: integer
description: Required if `power_mode`==`custom`; else use `power_mode` as default
contentEncoding: int32
default: 9
examples:
- 6
power_mode:
allOf:
- $ref: '#/components/schemas/ble_config_power_mode3'
- description: 'Transmit power mode for BLE beacons; use custom to set `power`. enum: `custom`, `default`.'
examples:
- custom
description: Bluetooth Low Energy configuration applied to APs at the site
ble_config4:
title: ble_config4
type: object
properties:
beacon_enabled:
type: boolean
description: Whether Mist beacons is enabled
default: true
beacon_rate:
type: integer
description: Required if `beacon_rate_mode`==`custom`, 1-10, in number-beacons-per-second
contentEncoding: int32
examples:
- 3
beacon_rate_mode:
allOf:
- $ref: '#/components/schemas/ble_config_beacon_rate_mode2'
- description: 'Beacon rate mode for Mist BLE beacons; use custom to set beacon_rate. enum: `custom`, `default`.'
examples:
- custom
beam_disabled:
type: array
items:
type: integer
contentEncoding: int32
description: AP BLE beam numbers disabled for location advertisements
examples:
- - 1
- 3
- 6
custom_ble_packet_enabled:
type: boolean
description: Can be enabled if `beacon_enabled`==`true`, whether to send custom packet
default: false
custom_ble_packet_frame:
type: string
description: The custom frame to be sent out in this beacon. The frame must be a hexstring
examples:
- 0x........
custom_ble_packet_freq_msec:
minimum: 0
type: integer
description: Frequency (msec) of data emitted by custom ble beacon
contentEncoding: int32
default: 0
examples:
- 300
eddystone_uid_adv_power:
maximum: 20
minimum: -100
type: integer
description: Advertised TX Power, -100 to 20 (dBm), omit this attribute to use default
contentEncoding: int32
default: 0
examples:
- -65
eddystone_uid_beams:
type: string
description: BLE beams used to transmit Eddystone-UID advertisements, expressed as ranges such as `2-4,7`
examples:
- 2-4,7
eddystone_uid_enabled:
type: boolean
description: Only if `beacon_enabled`==`false`, Whether Eddystone-UID beacon is enabled
default: false
eddystone_uid_freq_msec:
type: integer
description: Frequency (msec) of data emit by Eddystone-UID beacon
contentEncoding: int32
default: 0
examples:
- 200
eddystone_uid_instance:
type: string
description: Eddystone-UID instance for the device
examples:
- 5c5b35000001
eddystone_uid_namespace:
type: string
description: Eddystone-UID namespace broadcast by the AP, as a 10-byte hex string
examples:
- 2818e3868dec25629ede
eddystone_url_adv_power:
maximum: 20
minimum: -100
type: integer
description: Advertised TX Power, -100 to 20 (dBm), omit this attribute to use default
contentEncoding: int32
default: 0
examples:
- -65
eddystone_url_beams:
type: string
description: BLE beams used to transmit Eddystone-URL advertisements, expressed as ranges such as `2-4,7`
examples:
- 2-4,7
eddystone_url_enabled:
type: boolean
description: Only if `beacon_enabled`==`false`, Whether Eddystone-URL beacon is enabled
default: false
eddystone_url_freq_msec:
type: integer
description: Frequency (msec) of data emitted by Eddystone-URL beacon
contentEncoding: int32
default: 0
examples:
- 1000
eddystone_url_url:
type: string
description: URL pointed by Eddystone-URL beacon
examples:
- https://www.abc.com
ibeacon_adv_power:
maximum: 20
minimum: -100
type: integer
description: Advertised TX Power, -100 to 20 (dBm), omit this attribute to use default
contentEncoding: int32
default: 0
examples:
- -65
ibeacon_beams:
type: string
description: BLE beams used to transmit iBeacon advertisements, expressed as ranges such as `2-4,7`
examples:
- 2-4,7
ibeacon_enabled:
type: boolean
description: Can be enabled if `beacon_enabled`==`true`, whether to send iBeacon
default: false
ibeacon_freq_msec:
type: integer
description: Frequency (msec) of data emit for iBeacon
contentEncoding: int32
default: 0
ibeacon_major:
maximum: 65535
minimum: 1
type:
- integer
- 'null'
description: iBeacon major value broadcast by the AP
contentEncoding: int32
examples:
- 1234
ibeacon_minor:
maximum: 65535
minimum: 1
type:
- integer
- 'null'
description: iBeacon minor value broadcast by the AP
contentEncoding: int32
examples:
- 1234
ibeacon_uuid:
type: string
description: Optional, if not specified, the same UUID as the beacon will be used
contentEncoding: uuid
examples:
- f3f17139-704a-f03a-2786-0400279e37c3
power:
maximum: 10
minimum: 1
type: integer
description: Required if `power_mode`==`custom`; else use `power_mode` as default
contentEncoding: int32
default: 9
examples:
- 6
power_mode:
allOf:
- $ref: '#/components/schemas/ble_config_power_mode3'
- description: 'Transmit power mode for BLE beacons; use custom to set `power`. enum: `custom`, `default`.'
examples:
- custom
description: Bluetooth Low Energy beacon and asset settings for this access point
call_troubleshoot_data1:
title: call_troubleshoot_data1
type: object
properties:
ap_num_clients:
type: number
description: Troubleshooting metric value for AP client count
examples:
- -0.6565111
ap_rtt:
type: number
description: Troubleshooting metric value for AP round-trip time
examples:
- 0.16559607
client_cpu:
type: number
description: Troubleshooting metric value for client CPU load
examples:
- 3.7028809
client_n_streams:
type: number
description: Troubleshooting metric value for the number of client spatial streams
examples:
- 0.15803306
client_radio_band:
type: number
description: Troubleshooting metric value for the client radio band
examples:
- 0.5576923
client_rssi:
type: number
description: Troubleshooting metric value for client RSSI
examples:
- -1.0839354
client_rx_bytes:
type: number
description: Troubleshooting metric value for bytes received by the client
examples:
- 2.2622051
client_rx_rates:
type: number
description: Troubleshooting metric value for client receive data rates
examples:
- 0.62357205
client_rx_retries:
type: number
description: Troubleshooting metric value for client receive retries
examples:
- 0.26726437
client_tx_bytes:
type: number
description: Troubleshooting metric value for bytes transmitted by the client
examples:
- 0.15803306
client_tx_rates:
type: number
description: Troubleshooting metric value for client transmit data rates
examples:
- 0.62357205
client_tx_retries:
type: number
description: Troubleshooting metric value for client transmit retries
examples:
- 0.77553505
client_vpn_distance:
type: number
description: Troubleshooting metric value for client VPN distance
examples:
- 1.6474955
client_wifi_version:
type: number
description: Troubleshooting metric value for the client Wi-Fi version
examples:
- 0.18267937
expected:
type: number
description: Model baseline value expected for this media direction
examples:
- 30.941595
radio_bandwidth:
type: number
description: Troubleshooting metric value for radio channel bandwidth
examples:
- -0.06538621
radio_channel:
type: number
description: Troubleshooting metric value for the radio channel
examples:
- -0.73391086
radio_tx_power:
type: number
description: Troubleshooting metric value for radio transmit power
examples:
- 0.10027129
radio_util:
type: number
description: Troubleshooting metric value for radio utilization
examples:
- 12.770318
radio_util_interference:
type: number
description: Troubleshooting metric value for radio interference utilization
examples:
- -3.079999
site_num_clients:
type: number
description: Troubleshooting metric value for the number of clients at the site
examples:
- 0.017364305
wan_avg_download_mbps:
type: number
description: Troubleshooting metric value for average WAN download throughput
examples:
- 1.4803165
wan_avg_upload_mbps:
type: number
description: Troubleshooting metric value for average WAN upload throughput
examples:
- -0.038184267
wan_jitter:
type: number
description: Troubleshooting metric value for WAN jitter
examples:
- 5.9680853
wan_max_download_mbps:
type: number
description: Troubleshooting metric value for maximum WAN download throughput
examples:
- 1.4803165
wan_max_upload_mbps:
type: number
description: Troubleshooting metric value for maximum WAN upload throughput
examples:
- -0.038184267
wan_rtt:
type: number
description: Troubleshooting metric value for WAN round-trip time
examples:
- 46.77899
description: Troubleshooting metrics for the outbound audio stream
call_troubleshoot_data2:
title: call_troubleshoot_data2
type: object
properties:
ap_num_clients:
type: number
description: Troubleshooting metric value for AP client count
examples:
- -0.6565111
ap_rtt:
type: number
description: Troubleshooting metric value for AP round-trip time
examples:
- 0.16559607
client_cpu:
type: number
description: Troubleshooting metric value for client CPU load
examples:
- 3.7028809
client_n_streams:
type: number
description: Troubleshooting metric value for the number of client spatial streams
examples:
- 0.15803306
client_radio_band:
type: number
description: Troubleshooting metric value for the client radio band
examples:
- 0.5576923
client_rssi:
type: number
description: Troubleshooting metric value for client RSSI
examples:
- -1.0839354
client_rx_bytes:
type: number
description: Troubleshooting metric value for bytes received by the client
examples:
- 2.2622051
client_rx_rates:
type: number
description: Troubleshooting metric value for client receive data rates
examples:
- 0.62357205
client_rx_retries:
type: number
description: Troubleshooting metric value for client receive retries
examples:
- 0.26726437
client_tx_bytes:
type: number
description: Troubleshooting metric value for bytes transmitted by the client
examples:
- 0.15803306
client_tx_rates:
type: number
description: Troubleshooting metric value for client transmit data rates
examples:
- 0.62357205
client_tx_retries:
type: number
description: Troubleshooting metric value for client transmit retries
examples:
- 0.77553505
client_vpn_distance:
type: number
description: Troubleshooting metric value for client VPN distance
examples:
- 1.6474955
client_wifi_version:
type: number
description: Troubleshooting metric value for the client Wi-Fi version
examples:
- 0.18267937
expected:
type: number
description: Model baseline value expected for this media direction
examples:
- 30.941595
radio_bandwidth:
type: number
description: Troubleshooting metric value for radio channel bandwidth
examples:
- -0.06538621
radio_channel:
type: number
description: Troubleshooting metric value for the radio channel
examples:
- -0.73391086
radio_tx_power:
type: number
description: Troubleshooting metric value for radio transmit power
examples:
- 0.10027129
radio_util:
type: number
description: Troubleshooting metric value for radio utilization
examples:
- 12.770318
radio_util_interference:
type: number
description: Troubleshooting metric value for radio interference utilization
examples:
- -3.079999
site_num_clients:
type: number
description: Troubleshooting metric value for the number of clients at the site
examples:
- 0.017364305
wan_avg_download_mbps:
type: number
description: Troubleshooting metric value for average WAN download throughput
examples:
- 1.4803165
wan_avg_upload_mbps:
type: number
description: Troubleshooting metric value for average WAN upload throughput
examples:
- -0.038184267
wan_jitter:
type: number
description: Troubleshooting metric value for WAN jitter
examples:
- 5.9680853
wan_max_download_mbps:
type: number
description: Troubleshooting metric value for maximum WAN download throughput
examples:
- 1.4803165
wan_max_upload_mbps:
type: number
description: Troubleshooting metric value for maximum WAN upload throughput
examples:
- -0.038184267
wan_rtt:
type: number
description: Troubleshooting metric value for WAN round-trip time
examples:
- 46.77899
description: Troubleshooting metrics for the inbound video stream
call_troubleshoot_data3:
title: call_troubleshoot_data3
type: object
properties:
ap_num_clients:
type: number
description: Troubleshooting metric value for AP client count
examples:
- -0.6565111
ap_rtt:
type: number
description: Troubleshooting metric value for AP round-trip time
examples:
- 0.16559607
client_cpu:
type: number
description: Troubleshooting metric value for client CPU load
examples:
- 3.7028809
client_n_streams:
type: number
description: Troubleshooting metric value for the number of client spatial streams
examples:
- 0.15803306
client_radio_band:
type: number
description: Troubleshooting metric value for the client radio band
examples:
- 0.5576923
client_rssi:
type: number
description: Troubleshooting metric value for client RSSI
examples:
- -1.0839354
client_rx_bytes:
type: number
description: Troubleshooting metric value for bytes received by the client
examples:
- 2.2622051
client_rx_rates:
type: number
description: Troubleshooting metric value for client receive data rates
examples:
- 0.62357205
client_rx_retries:
type: number
description: Troubleshooting metric value for client receive retries
examples:
- 0.26726437
client_tx_bytes:
type: number
description: Troubleshooting metric value for bytes transmitted by the client
examples:
- 0.15803306
client_tx_rates:
type: number
description: Troubleshooting metric value for client transmit data rates
examples:
- 0.62357205
client_tx_retries:
type: number
description: Troubleshooting metric value for client transmit retries
examples:
- 0.77553505
client_vpn_distance:
type: number
description: Troubleshooting metric value for client VPN distance
examples:
- 1.6474955
client_wifi_version:
type: number
description: Troubleshooting metric value for the client Wi-Fi version
examples:
- 0.18267937
expected:
type: number
description: Model baseline value expected for this media direction
examples:
- 30.941595
radio_bandwidth:
type: number
description: Troubleshooting metric value for radio channel bandwidth
examples:
- -0.06538621
radio_channel:
type: number
description: Troubleshooting metric value for the radio channel
examples:
- -0.73391086
radio_tx_power:
type: number
description: Troubleshooting metric value for radio transmit power
examples:
- 0.10027129
radio_util:
type: number
description: Troubleshooting metric value for radio utilization
examples:
- 12.770318
radio_util_interference:
type: number
description: Troubleshooting metric value for radio interference utilization
examples:
- -3.079999
site_num_clients:
type: number
description: Troubleshooting metric value for the number of clients at the site
examples:
- 0.017364305
wan_avg_download_mbps:
type: number
description: Troubleshooting metric value for average WAN download throughput
examples:
- 1.4803165
wan_avg_upload_mbps:
type: number
description: Troubleshooting metric value for average WAN upload throughput
examples:
- -0.038184267
wan_jitter:
type: number
description: Troubleshooting metric value for WAN jitter
examples:
- 5.9680853
wan_max_download_mbps:
type: number
description: Troubleshooting metric value for maximum WAN download throughput
examples:
- 1.4803165
wan_max_upload_mbps:
type: number
description: Troubleshooting metric value for maximum WAN upload throughput
examples:
- -0.038184267
wan_rtt:
type: number
description: Troubleshooting metric value for WAN round-trip time
examples:
- 46.77899
description: Troubleshooting metrics for the outbound video stream
call_troubleshoot_data5:
title: call_troubleshoot_data5
type: object
properties:
ap_num_clients:
type: number
description: Troubleshooting metric value for AP client count
examples:
- -0.6565111
ap_rtt:
type: number
description: Troubleshooting metric value for AP round-trip time
examples:
- 0.16559607
client_cpu:
type: number
description: Troubleshooting metric value for client CPU load
examples:
- 3.7028809
client_n_streams:
type: number
description: Troubleshooting metric value for the number of client spatial streams
examples:
- 0.15803306
client_radio_band:
type: number
description: Troubleshooting metric value for the client radio band
examples:
- 0.5576923
client_rssi:
type: number
description: Troubleshooting metric value for client RSSI
examples:
- -1.0839354
client_rx_bytes:
type: number
description: Troubleshooting metric value for bytes received by the client
examples:
- 2.2622051
client_rx_rates:
type: number
description: Troubleshooting metric value for client receive data rates
examples:
- 0.62357205
client_rx_retries:
type: number
description: Troubleshooting metric value for client receive retries
examples:
- 0.26726437
client_tx_bytes:
type: number
description: Troubleshooting metric value for bytes transmitted by the client
examples:
- 0.15803306
client_tx_rates:
type: number
description: Troubleshooting metric value for client transmit data rates
examples:
- 0.62357205
client_tx_retries:
type: number
description: Troubleshooting metric value for client transmit retries
examples:
- 0.77553505
client_vpn_distance:
type: number
description: Troubleshooting metric value for client VPN distance
examples:
- 1.6474955
client_wifi_version:
type: number
description: Troubleshooting metric value for the client Wi-Fi version
examples:
- 0.18267937
expected:
type: number
description: Model baseline value expected for this media direction
examples:
- 30.941595
radio_bandwidth:
type: number
description: Troubleshooting metric value for radio channel bandwidth
examples:
- -0.06538621
radio_channel:
type: number
description: Troubleshooting metric value for the radio channel
examples:
- -0.73391086
radio_tx_power:
type: number
description: Troubleshooting metric value for radio transmit power
examples:
- 0.10027129
radio_util:
type: number
description: Troubleshooting metric value for radio utilization
examples:
- 12.770318
radio_util_interference:
type: number
description: Troubleshooting metric value for radio interference utilization
examples:
- -3.079999
site_num_clients:
type: number
description: Troubleshooting metric value for the number of clients at the site
examples:
- 0.017364305
wan_avg_download_mbps:
type: number
description: Troubleshooting metric value for average WAN download throughput
examples:
- 1.4803165
wan_avg_upload_mbps:
type: number
description: Troubleshooting metric value for average WAN upload throughput
examples:
- -0.038184267
wan_jitter:
type: number
description: Troubleshooting metric value for WAN jitter
examples:
- 5.9680853
wan_max_download_mbps:
type: number
description: Troubleshooting metric value for maximum WAN download throughput
examples:
- 1.4803165
wan_max_upload_mbps:
type: number
description: Troubleshooting metric value for maximum WAN upload throughput
examples:
- -0.038184267
wan_rtt:
type: number
description: Troubleshooting metric value for WAN round-trip time
examples:
- 46.77899
description: Troubleshooting metrics for the inbound audio stream
call_troubleshoot_summary_data1:
title: call_troubleshoot_summary_data1
type: object
properties:
ap_num_clients:
type: number
description: Media-direction metric value for AP client count
examples:
- -0.6565111
ap_rtt:
type: number
description: Media-direction metric value for AP round-trip time
examples:
- 0.16559607
client_cpu:
type: number
description: Media-direction metric value for client CPU load
examples:
- 3.7028809
client_n_streams:
type: number
description: Media-direction metric value for the number of client spatial streams
examples:
- 0.15803306
client_radio_band:
type: number
description: Media-direction metric value for the client radio band
examples:
- 0.5576923
client_rssi:
type: number
description: Media-direction metric value for client RSSI
examples:
- -1.0839354
client_rx_bytes:
type: number
description: Media-direction metric value for bytes received by the client
examples:
- 2.2622051
client_rx_rates:
type: number
description: Media-direction metric value for client receive data rates
examples:
- 0.26726437
client_tx_bytes:
type: number
description: Media-direction metric value for bytes transmitted by the client
examples:
- 6.6164713
client_tx_rates:
type: number
description: Media-direction metric value for client transmit data rates
examples:
- 0.62357205
client_tx_retries:
type: number
description: Media-direction metric value for client transmit retries
examples:
- 1.702031
client_vpn_distance:
type: number
description: Media-direction metric value for client VPN distance
examples:
- 1.6474955
client_wifi_version:
type: number
description: Media-direction metric value for the client Wi-Fi version
examples:
- 0.18267937
expected:
type: number
description: Model baseline value expected for this media direction
examples:
- 30.941595
radio_bandwidth:
type: number
description: Media-direction metric value for radio channel bandwidth
examples:
- -0.06538621
radio_channel:
type: number
description: Media-direction metric value for the radio channel
examples:
- -0.73391086
radio_tx_power:
type: number
description: Media-direction metric value for radio transmit power
examples:
- 0.10027129
radio_util:
type: number
description: Media-direction metric value for radio utilization
examples:
- 12.770318
radio_util_interference:
type: number
description: Media-direction metric value for radio interference utilization
examples:
- -3.079999
site_num_clients:
type: number
description: Media-direction metric value for the number of clients at the site
examples:
- 0.017364305
site_wan_avg_download_mbps:
type: number
description: Media-direction metric value for site WAN average download throughput
examples:
- 3.0566701889E-07
site_wan_avg_upload_mbps:
type: number
description: Media-direction metric value for site WAN average upload throughput
examples:
- 5.566701889E-08
site_wan_download_mbps:
type: number
description: Media-direction metric value for site WAN download throughput
examples:
- 8.0566701889E-07
site_wan_jitter:
type: number
description: Media-direction metric value for site WAN jitter
examples:
- 0.7875519659784105
site_wan_rtt:
type: number
description: Media-direction metric value for site WAN round-trip time
examples:
- 15.094849904378256
site_wan_upload_mbps:
type: number
description: Media-direction metric value for site WAN upload throughput
examples:
- 2.0566701889E-07
wan_avg_download_mbps:
type: number
description: Media-direction metric value for average WAN download throughput
examples:
- 1.4803165
wan_avg_upload_mbps:
type: number
description: Media-direction metric value for average WAN upload throughput
examples:
- -0.038184267
wan_jitter:
type: number
description: Media-direction metric value for WAN jitter
examples:
- 5.9680853
wan_max_download_mbps:
type: number
description: Media-direction metric value for maximum WAN download throughput
examples:
- 1.4803165
wan_max_upload_mbps:
type: number
description: Media-direction metric value for maximum WAN upload throughput
examples:
- -0.038184267
wan_rtt:
type: number
description: Media-direction metric value for WAN round-trip time
examples:
- 46.77899
description: Troubleshooting metrics for the outbound audio stream
call_troubleshoot_summary_data2:
title: call_troubleshoot_summary_data2
type: object
properties:
ap_num_clients:
type: number
description: Media-direction metric value for AP client count
examples:
- -0.6565111
ap_rtt:
type: number
description: Media-direction metric value for AP round-trip time
examples:
- 0.16559607
client_cpu:
type: number
description: Media-direction metric value for client CPU load
examples:
- 3.7028809
client_n_streams:
type: number
description: Media-direction metric value for the number of client spatial streams
examples:
- 0.15803306
client_radio_band:
type: number
description: Media-direction metric value for the client radio band
examples:
- 0.5576923
client_rssi:
type: number
description: Media-direction metric value for client RSSI
examples:
- -1.0839354
client_rx_bytes:
type: number
description: Media-direction metric value for bytes received by the client
examples:
- 2.2622051
client_rx_rates:
type: number
description: Media-direction metric value for client receive data rates
examples:
- 0.26726437
client_tx_bytes:
type: number
description: Media-direction metric value for bytes transmitted by the client
examples:
- 6.6164713
client_tx_rates:
type: number
description: Media-direction metric value for client transmit data rates
examples:
- 0.62357205
client_tx_retries:
type: number
description: Media-direction metric value for client transmit retries
examples:
- 1.702031
client_vpn_distance:
type: number
description: Media-direction metric value for client VPN distance
examples:
- 1.6474955
client_wifi_version:
type: number
description: Media-direction metric value for the client Wi-Fi version
examples:
- 0.18267937
expected:
type: number
description: Model baseline value expected for this media direction
examples:
- 30.941595
radio_bandwidth:
type: number
description: Media-direction metric value for radio channel bandwidth
examples:
- -0.06538621
radio_channel:
type: number
description: Media-direction metric value for the radio channel
examples:
- -0.73391086
radio_tx_power:
type: number
description: Media-direction metric value for radio transmit power
examples:
- 0.10027129
radio_util:
type: number
description: Media-direction metric value for radio utilization
examples:
- 12.770318
radio_util_interference:
type: number
description: Media-direction metric value for radio interference utilization
examples:
- -3.079999
site_num_clients:
type: number
description: Media-direction metric value for the number of clients at the site
examples:
- 0.017364305
site_wan_avg_download_mbps:
type: number
description: Media-direction metric value for site WAN average download throughput
examples:
- 3.0566701889E-07
site_wan_avg_upload_mbps:
type: number
description: Media-direction metric value for site WAN average upload throughput
examples:
- 5.566701889E-08
site_wan_download_mbps:
type: number
description: Media-direction metric value for site WAN download throughput
examples:
- 8.0566701889E-07
site_wan_jitter:
type: number
description: Media-direction metric value for site WAN jitter
examples:
- 0.7875519659784105
site_wan_rtt:
type: number
description: Media-direction metric value for site WAN round-trip time
examples:
- 15.094849904378256
site_wan_upload_mbps:
type: number
description: Media-direction metric value for site WAN upload throughput
examples:
- 2.0566701889E-07
wan_avg_download_mbps:
type: number
description: Media-direction metric value for average WAN download throughput
examples:
- 1.4803165
wan_avg_upload_mbps:
type: number
description: Media-direction metric value for average WAN upload throughput
examples:
- -0.038184267
wan_jitter:
type: number
description: Media-direction metric value for WAN jitter
examples:
- 5.9680853
wan_max_download_mbps:
type: number
description: Media-direction metric value for maximum WAN download throughput
examples:
- 1.4803165
wan_max_upload_mbps:
type: number
description: Media-direction metric value for maximum WAN upload throughput
examples:
- -0.038184267
wan_rtt:
type: number
description: Media-direction metric value for WAN round-trip time
examples:
- 46.77899
description: Troubleshooting metrics for the inbound video stream
call_troubleshoot_summary_data3:
title: call_troubleshoot_summary_data3
type: object
properties:
ap_num_clients:
type: number
description: Media-direction metric value for AP client count
examples:
- -0.6565111
ap_rtt:
type: number
description: Media-direction metric value for AP round-trip time
examples:
- 0.16559607
client_cpu:
type: number
description: Media-direction metric value for client CPU load
examples:
- 3.7028809
client_n_streams:
type: number
description: Media-direction metric value for the number of client spatial streams
examples:
- 0.15803306
client_radio_band:
type: number
description: Media-direction metric value for the client radio band
examples:
- 0.5576923
client_rssi:
type: number
description: Media-direction metric value for client RSSI
examples:
- -1.0839354
client_rx_bytes:
type: number
description: Media-direction metric value for bytes received by the client
examples:
- 2.2622051
client_rx_rates:
type: number
description: Media-direction metric value for client receive data rates
examples:
- 0.26726437
client_tx_bytes:
type: number
description: Media-direction metric value for bytes transmitted by the client
examples:
- 6.6164713
client_tx_rates:
type: number
description: Media-direction metric value for client transmit data rates
examples:
- 0.62357205
client_tx_retries:
type: number
description: Media-direction metric value for client transmit retries
examples:
- 1.702031
client_vpn_distance:
type: number
description: Media-direction metric value for client VPN distance
examples:
- 1.6474955
client_wifi_version:
type: number
description: Media-direction metric value for the client Wi-Fi version
examples:
- 0.18267937
expected:
type: number
description: Model baseline value expected for this media direction
examples:
- 30.941595
radio_bandwidth:
type: number
description: Media-direction metric value for radio channel bandwidth
examples:
- -0.06538621
radio_channel:
type: number
description: Media-direction metric value for the radio channel
examples:
- -0.73391086
radio_tx_power:
type: number
description: Media-direction metric value for radio transmit power
examples:
- 0.10027129
radio_util:
type: number
description: Media-direction metric value for radio utilization
examples:
- 12.770318
radio_util_interference:
type: number
description: Media-direction metric value for radio interference utilization
examples:
- -3.079999
site_num_clients:
type: number
description: Media-direction metric value for the number of clients at the site
examples:
- 0.017364305
site_wan_avg_download_mbps:
type: number
description: Media-direction metric value for site WAN average download throughput
examples:
- 3.0566701889E-07
site_wan_avg_upload_mbps:
type: number
description: Media-direction metric value for site WAN average upload throughput
examples:
- 5.566701889E-08
site_wan_download_mbps:
type: number
description: Media-direction metric value for site WAN download throughput
examples:
- 8.0566701889E-07
site_wan_jitter:
type: number
description: Media-direction metric value for site WAN jitter
examples:
- 0.7875519659784105
site_wan_rtt:
type: number
description: Media-direction metric value for site WAN round-trip time
examples:
- 15.094849904378256
site_wan_upload_mbps:
type: number
description: Media-direction metric value for site WAN upload throughput
examples:
- 2.0566701889E-07
wan_avg_download_mbps:
type: number
description: Media-direction metric value for average WAN download throughput
examples:
- 1.4803165
wan_avg_upload_mbps:
type: number
description: Media-direction metric value for average WAN upload throughput
examples:
- -0.038184267
wan_jitter:
type: number
description: Media-direction metric value for WAN jitter
examples:
- 5.9680853
wan_max_download_mbps:
type: number
description: Media-direction metric value for maximum WAN download throughput
examples:
- 1.4803165
wan_max_upload_mbps:
type: number
description: Media-direction metric value for maximum WAN upload throughput
examples:
- -0.038184267
wan_rtt:
type: number
description: Media-direction metric value for WAN round-trip time
examples:
- 46.77899
description: Troubleshooting metrics for the outbound video stream
call_troubleshoot_summary_data5:
title: call_troubleshoot_summary_data5
type: object
properties:
ap_num_clients:
type: number
description: Media-direction metric value for AP client count
examples:
- -0.6565111
ap_rtt:
type: number
description: Media-direction metric value for AP round-trip time
examples:
- 0.16559607
client_cpu:
type: number
description: Media-direction metric value for client CPU load
examples:
- 3.7028809
client_n_streams:
type: number
description: Media-direction metric value for the number of client spatial streams
examples:
- 0.15803306
client_radio_band:
type: number
description: Media-direction metric value for the client radio band
examples:
- 0.5576923
client_rssi:
type: number
description: Media-direction metric value for client RSSI
examples:
- -1.0839354
client_rx_bytes:
type: number
description: Media-direction metric value for bytes received by the client
examples:
- 2.2622051
client_rx_rates:
type: number
description: Media-direction metric value for client receive data rates
examples:
- 0.26726437
client_tx_bytes:
type: number
description: Media-direction metric value for bytes transmitted by the client
examples:
- 6.6164713
client_tx_rates:
type: number
description: Media-direction metric value for client transmit data rates
examples:
- 0.62357205
client_tx_retries:
type: number
description: Media-direction metric value for client transmit retries
examples:
- 1.702031
client_vpn_distance:
type: number
description: Media-direction metric value for client VPN distance
examples:
- 1.6474955
client_wifi_version:
type: number
description: Media-direction metric value for the client Wi-Fi version
examples:
- 0.18267937
expected:
type: number
description: Model baseline value expected for this media direction
examples:
- 30.941595
radio_bandwidth:
type: number
description: Media-direction metric value for radio channel bandwidth
examples:
- -0.06538621
radio_channel:
type: number
description: Media-direction metric value for the radio channel
examples:
- -0.73391086
radio_tx_power:
type: number
description: Media-direction metric value for radio transmit power
examples:
- 0.10027129
radio_util:
type: number
description: Media-direction metric value for radio utilization
examples:
- 12.770318
radio_util_interference:
type: number
description: Media-direction metric value for radio interference utilization
examples:
- -3.079999
site_num_clients:
type: number
description: Media-direction metric value for the number of clients at the site
examples:
- 0.017364305
site_wan_avg_download_mbps:
type: number
description: Media-direction metric value for site WAN average download throughput
examples:
- 3.0566701889E-07
site_wan_avg_upload_mbps:
type: number
description: Media-direction metric value for site WAN average upload throughput
examples:
- 5.566701889E-08
site_wan_download_mbps:
type: number
description: Media-direction metric value for site WAN download throughput
examples:
- 8.0566701889E-07
site_wan_jitter:
type: number
description: Media-direction metric value for site WAN jitter
examples:
- 0.7875519659784105
site_wan_rtt:
type: number
description: Media-direction metric value for site WAN round-trip time
examples:
- 15.094849904378256
site_wan_upload_mbps:
type: number
description: Media-direction metric value for site WAN upload throughput
examples:
- 2.0566701889E-07
wan_avg_download_mbps:
type: number
description: Media-direction metric value for average WAN download throughput
examples:
- 1.4803165
wan_avg_upload_mbps:
type: number
description: Media-direction metric value for average WAN upload throughput
examples:
- -0.038184267
wan_jitter:
type: number
description: Media-direction metric value for WAN jitter
examples:
- 5.9680853
wan_max_download_mbps:
type: number
description: Media-direction metric value for maximum WAN download throughput
examples:
- 1.4803165
wan_max_upload_mbps:
type: number
description: Media-direction metric value for maximum WAN upload throughput
examples:
- -0.038184267
wan_rtt:
type: number
description: Media-direction metric value for WAN round-trip time
examples:
- 46.77899
description: Troubleshooting metrics for the inbound audio stream
capture_gateway_format2:
title: capture_gateway_format2
const: stream
type: string
description: 'Output format for the gateway packet capture. enum: `stream`.'
examples:
- stream
capture_mxedge_format2:
title: capture_mxedge_format2
enum:
- stream
- tzsp
type: string
description: 'Output format for packet capture data. enum: `stream`, `tzsp`.'
capture_mxedge_format3:
title: capture_mxedge_format3
enum:
- stream
- tzsp
type: string
description: 'Output format for the Mist Edge packet capture. enum: `stream`, `tzsp`.'
capture_radiotap_band2:
title: capture_radiotap_band2
enum:
- '24'
- 24,5,6
- '5'
- '6'
type: string
description: 'Radio band to capture for radiotap packets. enum: `24`, `24,5,6`, `5`, `6`.'
examples:
- '24'
capture_radiotap_format2:
title: capture_radiotap_format2
enum:
- pcap
- stream
type: string
description: 'Output format for the radiotap packet capture. enum: `pcap`, `stream`.'
examples:
- stream
capture_radiotapwired_band2:
title: capture_radiotapwired_band2
enum:
- '24'
- 24,5,6
- '5'
- '6'
type: string
description: 'Radio band to capture for the radiotap portion. enum: `24`, `24,5,6`, `5`, `6`.'
examples:
- '24'
capture_radiotapwired_format2:
title: capture_radiotapwired_format2
enum:
- pcap
- stream
type: string
description: 'Output format for the combined packet capture. enum: `pcap`, `stream`.'
examples:
- stream
capture_scan_aps_band2:
title: capture_scan_aps_band2
enum:
- '24'
- '5'
- '6'
type: string
description: 'Radio band on which to start the scan capture. enum: `24`, `5`, `6`.'
capture_scan_band2:
title: capture_scan_band2
enum:
- '24'
- '5'
- '6'
type: string
description: 'Radio band to capture for scan radio packets. enum: `24`, `5`, `6`.'
examples:
- '24'
capture_scan_format2:
title: capture_scan_format2
enum:
- pcap
- stream
type: string
description: 'Output format for the scan radio packet capture. enum: `pcap`, `stream`.'
examples:
- stream
capture_switch_format2:
title: capture_switch_format2
const: stream
type: string
description: 'Output format for the switch packet capture. enum: `stream`.'
capture_wired_format2:
title: capture_wired_format2
enum:
- pcap
- stream
type: string
description: 'Output format for the wired packet capture. enum: `pcap`, `stream`.'
capture_wireless_band2:
title: capture_wireless_band2
enum:
- '24'
- '5'
- '6'
type: string
description: 'Radio band to capture for wireless packets. enum: `24`, `5`, `6`.'
capture_wireless_format2:
title: capture_wireless_format2
enum:
- pcap
- stream
type: string
description: 'Output format for the wireless packet capture. enum: `pcap`, `stream`.'
claim_type_async2:
title: claim_type_async2
enum:
- all
- inventory
type: string
description: Claim scope; `all` claims licenses synchronously and queues inventory, `inventory` queues inventory only
claim_type2:
title: claim_type2
enum:
- all
- inventory
- license
type: string
description: Claim scope, such as all, inventory, or license
client_key_mgmt1:
title: client_key_mgmt1
enum:
- WPA2-PSK
- WPA2-PSK/CCMP
- WPA2-PSK-FT
- WPA2-PSK-SHA256
- WPA3-EAP-SHA256
- WPA3-EAP-SHA256/CCMP
- WPA3-EAP-FT/GCMP256
- WPA3-SAE-FT
- WPA3-SAE-PSK
type: string
description: 'Key management protocol used by the client session. enum: `WPA2-PSK`, `WPA2-PSK/CCMP`, `WPA2-PSK-FT`, `WPA2-PSK-SHA256`, `WPA3-EAP-SHA256`, `WPA3-EAP-SHA256/CCMP`, `WPA3-EAP-FT/GCMP256`, `WPA3-SAE-FT`, `WPA3-SAE-PSK`.'
examples:
- WPA2-PSK
config_switch_local_accounts_user_role2:
title: config_switch_local_accounts_user_role2
enum:
- admin
- helpdesk
- none
- read
type: string
description: 'Access role granted to the local switch user account. enum: `admin`, `helpdesk`, `none`, `read`.'
const_app_category_definition_filters2:
title: const_app_category_definition_filters2
type: object
properties:
srx:
uniqueItems: true
type: array
items:
type: string
description: Application signature names for SRX platforms included in this category
ssr:
uniqueItems: true
type: array
items:
type: string
description: Application identifiers for SSR platforms included in this category
description: Platform-specific application signatures included in this category
examples:
- srx:
- Enhanced_Images_Media
- Enhanced_Web_Images
- Enhanced_Image_Servers
const_device_ap_band52:
title: const_device_ap_band52
type: object
properties:
max_clients:
type: integer
description: Maximum client count supported on the 5 GHz radio
contentEncoding: int32
examples:
- 128
max_power:
type: integer
description: Maximum transmit power for the 5 GHz radio, in dBm
contentEncoding: int32
examples:
- 17
min_power:
type: integer
description: Minimum transmit power for the 5 GHz radio, in dBm
contentEncoding: int32
examples:
- 8
description: 5 GHz radio capability limits for this AP model
const_device_ap_band62:
title: const_device_ap_band62
type: object
properties:
max_clients:
type: integer
description: Maximum client count supported on the 6 GHz radio
contentEncoding: int32
examples:
- 128
max_power:
type: integer
description: Maximum transmit power for the 6 GHz radio, in dBm
contentEncoding: int32
examples:
- 17
min_power:
type: integer
description: Minimum transmit power for the 6 GHz radio, in dBm
contentEncoding: int32
examples:
- 8
description: 6 GHz radio capability limits for this AP model
const_device_ap_band242:
title: const_device_ap_band242
type: object
properties:
band5_channels_op:
type: string
description: 5 GHz channel set used when this radio operates on 5 GHz
examples:
- low
max_clients:
type: integer
description: Maximum client count supported on the 2.4 GHz radio
contentEncoding: int32
examples:
- 128
max_power:
type: integer
description: Maximum transmit power for the 2.4 GHz radio, in dBm
contentEncoding: int32
examples:
- 19
min_power:
type: integer
description: Minimum transmit power for the 2.4 GHz radio, in dBm
contentEncoding: int32
examples:
- 8
description: 2.4 GHz radio capability limits for this AP model
const_device_ap_extios_default_dir2:
title: const_device_ap_extios_default_dir2
enum:
- IN
- OUT
type: string
description: 'Default direction for this external I/O port. enum: `IN`, `OUT`.'
const_device_ap_vble2:
title: const_device_ap_vble2
type: object
properties:
beacon_rate:
type: integer
description: Advertisement rate for the virtual BLE beacon
contentEncoding: int32
examples:
- 4
beams:
type: integer
description: Number of virtual BLE beams supported by the AP model
contentEncoding: int32
examples:
- 9
power:
type: integer
description: Transmit power for virtual BLE beacons, in dBm
contentEncoding: int32
examples:
- 8
description: Virtual BLE (vBLE) capability settings for this AP model
const_device_gateway_ports2:
title: const_device_gateway_ports2
type: object
properties:
display:
type: string
description: User-facing interface name for the gateway port
pci_address:
type: string
description: PCI address for the gateway port
speed:
type: integer
description: Port speed for the gateway interface, in Mbps
contentEncoding: int32
description: Per-interface metadata for this gateway model
const_device_switch_default2:
title: const_device_switch_default2
type: object
properties:
_ports:
type: string
description: Default switch port range list for this model
examples:
- ge-0/0/0-47, et-0/1/0-3, xe-0/2/0-3, ge-0/2/0-3
description: Default port mappings for this switch model
const_insight_metrics_property_example_any_of2:
title: const_insight_metrics_property_example_any_of2
type: object
description: Sample values returned for this insight metric
cpu_stat1:
title: cpu_stat1
type: object
properties:
idle:
type:
- number
- 'null'
description: Percentage of CPU time that is idle
readOnly: true
interrupt:
type:
- number
- 'null'
description: Percentage of CPU time being used by interrupts
readOnly: true
load_avg:
type: array
items:
type: number
description: Load averages for the last 1, 5, and 15 minutes
system:
type:
- number
- 'null'
description: Percentage of CPU time being used by system processes
readOnly: true
usage:
type:
- number
- 'null'
description: Overall CPU usage percentage
readOnly: true
user:
type:
- number
- 'null'
description: Percentage of CPU time being used by user processes
readOnly: true
description: Processor utilization statistics for the switch module
cpu_stat2:
title: cpu_stat2
type: object
properties:
idle:
type:
- number
- 'null'
description: Percentage of CPU time that is idle
readOnly: true
interrupt:
type:
- number
- 'null'
description: Percentage of CPU time being used by interrupts
readOnly: true
load_avg:
type: array
items:
type: number
description: Load averages for the last 1, 5, and 15 minutes
system:
type:
- number
- 'null'
description: Percentage of CPU time being used by system processes
readOnly: true
usage:
type:
- number
- 'null'
description: Overall CPU usage percentage
readOnly: true
user:
type:
- number
- 'null'
description: Percentage of CPU time being used by user processes
readOnly: true
description: Processor utilization statistics for the switch
cpu_stat3:
title: cpu_stat3
type: object
properties:
idle:
type:
- number
- 'null'
description: Percentage of CPU time that is idle
readOnly: true
interrupt:
type:
- number
- 'null'
description: Percentage of CPU time being used by interrupts
readOnly: true
load_avg:
type: array
items:
type: number
description: Load averages for the last 1, 5, and 15 minutes
system:
type:
- number
- 'null'
description: Percentage of CPU time being used by system processes
readOnly: true
usage:
type:
- number
- 'null'
description: Overall CPU usage percentage
readOnly: true
user:
type:
- number
- 'null'
description: Percentage of CPU time being used by user processes
readOnly: true
description: Processor utilization statistics for the secondary HA node
cpu_stat4:
title: cpu_stat4
type: object
properties:
idle:
type:
- number
- 'null'
description: Percentage of CPU time that is idle
readOnly: true
interrupt:
type:
- number
- 'null'
description: Percentage of CPU time being used by interrupts
readOnly: true
load_avg:
type: array
items:
type: number
description: Load averages for the last 1, 5, and 15 minutes
system:
type:
- number
- 'null'
description: Percentage of CPU time being used by system processes
readOnly: true
usage:
type:
- number
- 'null'
description: Overall CPU usage percentage
readOnly: true
user:
type:
- number
- 'null'
description: Percentage of CPU time being used by user processes
readOnly: true
description: Processor utilization statistics for the gateway or primary HA node
day_of_week1:
title: day_of_week1
enum:
- any
- fri
- mon
- sat
- sun
- thu
- tue
- wed
type: string
description: 'Scheduled weekday for automatic signature updates. enum: `any`, `fri`, `mon`, `sat`, `sun`, `thu`, `tue`, `wed`.'
day_of_week3:
title: day_of_week3
enum:
- any
- fri
- mon
- sat
- sun
- thu
- tue
- wed
type: string
description: 'Day of the week for the AP auto-upgrade maintenance window. enum: `any`, `fri`, `mon`, `sat`, `sun`, `thu`, `tue`, `wed`.'
day_of_week4:
title: day_of_week4
enum:
- any
- fri
- mon
- sat
- sun
- thu
- tue
- wed
type: string
description: 'Weekly AP auto-upgrade day for the maintenance window. enum: `any`, `fri`, `mon`, `sat`, `sun`, `thu`, `tue`, `wed`.'
day_of_week5:
title: day_of_week5
enum:
- any
- fri
- mon
- sat
- sun
- thu
- tue
- wed
type: string
description: 'Weekly ESL auto-upgrade day for the maintenance window. enum: `any`, `fri`, `mon`, `sat`, `sun`, `thu`, `tue`, `wed`.'
day_of_week6:
title: day_of_week6
enum:
- any
- fri
- mon
- sat
- sun
- thu
- tue
- wed
type: string
description: 'Day of week when the automatic upgrade window runs. enum: `any`, `fri`, `mon`, `sat`, `sun`, `thu`, `tue`, `wed`.'
day_of_week7:
title: day_of_week7
enum:
- any
- fri
- mon
- sat
- sun
- thu
- tue
- wed
type: string
description: 'Scheduled weekday for auto preemption. enum: `any`, `fri`, `mon`, `sat`, `sun`, `thu`, `tue`, `wed`.'
delivery1:
title: delivery1
required:
- enabled
type: object
properties:
additional_emails:
type: array
items:
type: string
description: Additional email recipients for alarm delivery
enabled:
type: boolean
description: Whether to enable the alarm delivery via emails or not
examples:
- true
to_org_admins:
type: boolean
description: Whether to deliver the alarms via emails to Org admins or not
examples:
- true
to_site_admins:
type: boolean
description: Whether to deliver the alarms via emails to Site admins or not
examples:
- false
description: Overrides for the alarm template delivery defaults for this alarm rule
delivery3:
title: delivery3
required:
- enabled
type: object
properties:
additional_emails:
type: array
items:
type: string
description: Additional email recipients for alarm delivery
enabled:
type: boolean
description: Whether to enable the alarm delivery via emails or not
examples:
- true
to_org_admins:
type: boolean
description: Whether to deliver the alarms via emails to Org admins or not
examples:
- true
to_site_admins:
type: boolean
description: Whether to deliver the alarms via emails to Site admins or not
examples:
- false
description: Default alarm delivery settings for rules in this template
device_ap_lacp_config2:
title: device_ap_lacp_config2
type: object
properties:
enabled:
type: boolean
description: Whether to enable LACP on supported AP Ethernet uplinks
default: false
description: Link aggregation defaults for supported AP Ethernet uplinks
device_ap_lacp_config3:
title: device_ap_lacp_config3
type: object
properties:
enabled:
type: boolean
description: Whether to enable LACP on supported AP Ethernet uplinks
default: false
description: Link aggregation settings for supported AP Ethernet uplinks
device_search_radius_filter_status1:
title: device_search_radius_filter_status1
enum:
- up
- down
- unreachable
type: string
description: 'RADIUS authentication server status for this server in device search results. enum: `up`, `down`, `unreachable`.'
device_type_default_ap1:
title: device_type_default_ap1
enum:
- ap
- gateway
- switch
type: string
description: 'If only intended to claim a certain device type, specify it here. enum: `ap`, `gateway`, `switch`.'
device_type_default_ap3:
title: device_type_default_ap3
enum:
- ap
- gateway
- switch
type: string
description: 'Device type for this inventory record. enum: `ap`, `gateway`, `switch`.'
device_type_default_ap4:
title: device_type_default_ap4
enum:
- ap
- gateway
- switch
type: string
description: 'Device type for this inventory search result. enum: `ap`, `gateway`, `switch`.'
device_type_default_ap5:
title: device_type_default_ap5
enum:
- ap
- gateway
- switch
type: string
description: 'Device type filter for this naming rule. enum: `ap`, `gateway`, `switch`.'
device_type_default_ap6:
title: device_type_default_ap6
enum:
- ap
- gateway
- switch
type: string
description: 'Device type filter that limits which claimed devices this rule applies to. enum: `ap`, `gateway`, `switch`.'
device_type2:
title: device_type2
enum:
- ap
- gateway
- switch
type: string
description: 'Device category for the inventory item. enum: `ap`, `gateway`, `switch`.'
device_type3:
title: device_type3
enum:
- ap
- gateway
- switch
type: string
description: 'Type of network device that received the CoA command. enum: `ap`, `gateway`, `switch`.'
device_type4:
title: device_type4
enum:
- ap
- gateway
- switch
type: string
description: 'Device category that ran the synthetic test. enum: `ap`, `gateway`, `switch`.'
device_type5:
title: device_type5
enum:
- ap
- gateway
- switch
type: string
description: 'Device family selected for the organization upgrade. enum: `ap`, `gateway`, `switch`.'
device_type6:
title: device_type6
enum:
- ap
- gateway
- switch
type: string
description: 'Device type associated with the event. enum: `ap`, `gateway`, `switch`.'
dhcp_snooping1:
title: dhcp_snooping1
type: object
properties:
all_networks:
type: boolean
description: Whether DHCP snooping applies to all configured networks
enable_arp_spoof_check:
type: boolean
description: Enable for dynamic ARP inspection check
enable_ip_source_guard:
type: boolean
description: Enable for check for forging source IP address
enabled:
type: boolean
description: Whether DHCP snooping is enabled
networks:
type: array
items:
type: string
description: Network names with DHCP snooping enabled when `all_networks`==`false`
description: DHCP snooping defaults provided by this switch profile
dhcp_snooping3:
title: dhcp_snooping3
type: object
properties:
all_networks:
type: boolean
description: Whether DHCP snooping applies to all configured networks
enable_arp_spoof_check:
type: boolean
description: Enable for dynamic ARP inspection check
enable_ip_source_guard:
type: boolean
description: Enable for check for forging source IP address
enabled:
type: boolean
description: Whether DHCP snooping is enabled
networks:
type: array
items:
type: string
description: Network names with DHCP snooping enabled when `all_networks`==`false`
description: DHCP snooping defaults provided by this network template
dhcp_snooping4:
title: dhcp_snooping4
type: object
properties:
all_networks:
type: boolean
description: Whether DHCP snooping applies to all configured networks
enable_arp_spoof_check:
type: boolean
description: Enable for dynamic ARP inspection check
enable_ip_source_guard:
type: boolean
description: Enable for check for forging source IP address
enabled:
type: boolean
description: Whether DHCP snooping is enabled
networks:
type: array
items:
type: string
description: Network names with DHCP snooping enabled when `all_networks`==`false`
description: Layer 2 DHCP snooping settings for the site
dhcp_snooping5:
title: dhcp_snooping5
type: object
properties:
all_networks:
type: boolean
description: Whether DHCP snooping applies to all configured networks
enable_arp_spoof_check:
type: boolean
description: Enable for dynamic ARP inspection check
enable_ip_source_guard:
type: boolean
description: Enable for check for forging source IP address
enabled:
type: boolean
description: Whether DHCP snooping is enabled
networks:
type: array
items:
type: string
description: Network names with DHCP snooping enabled when `all_networks`==`false`
description: DHCP snooping configuration for this switch
dhcpd_config_option_type2:
title: dhcpd_config_option_type2
enum:
- boolean
- hex
- int16
- int32
- ip
- string
- uint16
- uint32
type: string
description: 'Data type used to encode this DHCP option value. enum: `boolean`, `hex`, `int16`, `int32`, `ip`, `string`, `uint16`, `uint32`.'
dhcpd_config_type2:
title: dhcpd_config_type2
enum:
- local
- none
- relay
type: string
description: 'IPv4 DHCP mode for this network. enum: `local`, `none`, `relay`.'
dhcpd_config_type62:
title: dhcpd_config_type62
enum:
- local
- none
- relay
type: string
description: 'IPv6 DHCP mode for this network. enum: `local`, `none`, `relay`.'
dhcpd_config_vendor_option_type2:
title: dhcpd_config_vendor_option_type2
enum:
- boolean
- hex
- int16
- int32
- ip
- string
- uint16
- uint32
type: string
description: 'Data type used to encode this vendor option value. enum: `boolean`, `hex`, `int16`, `int32`, `ip`, `string`, `uint16`, `uint32`.'
dhcpd_config1:
title: dhcpd_config1
type: object
properties:
enabled:
type: boolean
description: If set to `false`, disable the DHCP server
default: true
additionalProperties:
allOf:
- $ref: '#/components/schemas/dhcpd_config_property'
- description: DHCP server or relay configuration for one network
description: DHCP server defaults provided by this gateway profile
dhcpd_config3:
title: dhcpd_config3
type: object
properties:
enabled:
type: boolean
description: If set to `false`, disable the DHCP server
default: true
additionalProperties:
allOf:
- $ref: '#/components/schemas/dhcpd_config_property'
- description: DHCP server or relay configuration for one network
description: DHCP server defaults provided by this gateway template
dhcpd_config4:
title: dhcpd_config4
type: object
properties:
enabled:
type: boolean
description: If set to `false`, disable the DHCP server
default: true
additionalProperties:
allOf:
- $ref: '#/components/schemas/dhcpd_config_property'
- description: DHCP server or relay configuration for one network
description: DHCP server configuration served by this gateway
dot11_bandwidth1:
title: dot11_bandwidth1
enum:
- 0
- 20
- 40
- 80
- 160
type: integer
description: 'Channel bandwidth to use for the scan radio packet capture. enum: `0`, `20`, `40`, `80`, `160`.'
examples:
- 20
dot11_band1:
title: dot11_band1
enum:
- '24'
- '5'
- 5-dedicated
- 5-selectable
- '6'
- 6-dedicated
- 6-selectable
type: string
description: 'Radio band used for the wireless client event. enum: `24`, `5`, `5-dedicated`, `5-selectable`, `6`, `6-dedicated`, `6-selectable`.'
dot11_proto1:
title: dot11_proto1
enum:
- a
- ac
- ax
- b
- be
- g
- n
type: string
description: '802.11 protocol used by the client session. enum: `a`, `ac`, `ax`, `b`, `be`, `g`, `n`.'
dot11_band2:
title: dot11_band2
enum:
- '24'
- '5'
- 5-dedicated
- 5-selectable
- '6'
- 6-dedicated
- 6-selectable
type: string
description: 'Radio band affected by the RRM event. enum: `24`, `5`, `5-dedicated`, `5-selectable`, `6`, `6-dedicated`, `6-selectable`.'
dot11_proto2:
title: dot11_proto2
enum:
- a
- ac
- ax
- b
- be
- g
- n
type: string
description: '802.11 protocol amendment used by the wireless client. enum: `a`, `ac`, `ax`, `b`, `be`, `g`, `n`.'
dot11_bandwidth3:
title: dot11_bandwidth3
enum:
- 0
- 20
- 40
- 80
- 160
type: integer
description: 'Channel width after the RRM event, in MHz. enum: `0`, `20`, `40`, `80`, `160`.'
examples:
- 20
dot11_band3:
title: dot11_band3
enum:
- '24'
- '5'
- 5-dedicated
- 5-selectable
- '6'
- 6-dedicated
- 6-selectable
type: string
description: 'Wi-Fi radio band used by the wireless client connection. enum: `24`, `5`, `5-dedicated`, `5-selectable`, `6`, `6-dedicated`, `6-selectable`.'
dot11_bandwidth4:
title: dot11_bandwidth4
enum:
- 0
- 20
- 40
- 80
- 160
type: integer
description: 'Proposed channel width for the radio band, in MHz. enum: `0`, `20`, `40`, `80`, `160`.'
examples:
- 20
dot11_bandwidth7:
title: dot11_bandwidth7
enum:
- 0
- 20
- 40
- 80
- 160
type: integer
description: 'Current channel width for the radio band, in MHz. enum: `0`, `20`, `40`, `80`, `160`.'
examples:
- 20
dot11_bandwidth8:
title: dot11_bandwidth8
enum:
- 0
- 20
- 40
- 80
- 160
type: integer
description: 'Current channel width reported for this radio. enum: `0`, `20`, `40`, `80`, `160`.'
examples:
- 20
dot11_bandwidth52:
title: dot11_bandwidth52
enum:
- 0
- 20
- 40
- 80
type: integer
description: 'Channel width configured for the 5 GHz radio. enum: `0`, `20`, `40`, `80`.'
examples:
- 40
dot11_bandwidth62:
title: dot11_bandwidth62
enum:
- 0
- 20
- 40
- 80
- 160
type: integer
description: 'Channel width configured for the 6 GHz radio. enum: `0`, `20`, `40`, `80`, `160`.'
examples:
- 80
dot11_bandwidth242:
title: dot11_bandwidth242
enum:
- 0
- 20
- 40
type: integer
description: 'Channel width configured for the 2.4 GHz radio. enum: `0`, `20`, `40`.'
examples:
- 20
dswitches_metrics_inactive_wired_vlans1:
title: dswitches_metrics_inactive_wired_vlans1
required:
- details
- score
type: object
properties:
details:
type: object
description: Metric-specific details for inactive wired VLAN findings
score:
type: number
description: Compliance score for the inactive wired VLAN metric
description: Metric for inactive wired VLANs on discovered switches
dswitches_metrics_poe_compliance_details2:
title: dswitches_metrics_poe_compliance_details2
required:
- total_aps
- total_power
type: object
properties:
total_aps:
type: integer
description: Number of APs evaluated for PoE compliance
contentEncoding: int32
total_power:
type: number
description: Aggregate AP PoE power demand across evaluated APs, in mW
description: Counts and power totals used to calculate the PoE compliance score
dswitches_metrics_poe_compliance1:
title: dswitches_metrics_poe_compliance1
required:
- details
- score
type: object
properties:
details:
allOf:
- $ref: '#/components/schemas/dswitches_metrics_poe_compliance_details2'
- description: Counts and power totals used to calculate the PoE compliance score
score:
type: number
description: Compliance score for the PoE compliance metric
description: Metric for PoE compliance across APs connected to discovered switches
dswitches_metrics_switch_ap_affinity_details2:
title: dswitches_metrics_switch_ap_affinity_details2
required:
- system_name
- threshold
type: object
properties:
system_name:
uniqueItems: true
type: array
items:
type: string
description: Discovered switch system names reported for the affinity metric
threshold:
type: number
description: APs-per-switch threshold used for the affinity metric
description: Switch names and threshold used to calculate the affinity score
dswitches_metrics_switch_ap_affinity1:
title: dswitches_metrics_switch_ap_affinity1
required:
- details
- score
type: object
properties:
details:
allOf:
- $ref: '#/components/schemas/dswitches_metrics_switch_ap_affinity_details2'
- description: Switch names and threshold used to calculate the affinity score
score:
type: number
description: Compliance score for the switch/AP affinity metric
description: Metric comparing AP counts against the switch affinity threshold
dswitches_metrics_version_compliance_details2:
title: dswitches_metrics_version_compliance_details2
required:
- major_versions
- total_switch_count
type: object
properties:
major_versions:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/dswitches_compliance_major_version'
description: Per-model major version groupings used for version compliance
total_switch_count:
type: integer
description: Number of discovered switches evaluated for version compliance
contentEncoding: int32
description: Version grouping details used to calculate the compliance score
dswitches_metrics_version_compliance1:
title: dswitches_metrics_version_compliance1
required:
- details
- score
type: object
properties:
details:
allOf:
- $ref: '#/components/schemas/dswitches_metrics_version_compliance_details2'
- description: Version grouping details used to calculate the compliance score
score:
type: number
description: Compliance score for the discovered-switch version metric
description: Metric for discovered switch software version compliance
dynamic_psk_source1:
title: dynamic_psk_source1
enum:
- cloud_psks
- radius
type: string
description: 'Origin used to retrieve per-user PSKs. enum: `cloud_psks`, `radius`.'
examples:
- cloud_psks
event_fastroam_type2:
title: event_fastroam_type2
enum:
- fail
- none
- pingpong
- poor
- slow
- success
type: string
description: 'Fast-roam result category for the event. enum: `fail`, `none`, `pingpong`, `poor`, `slow`, `success`.'
event_severity1:
title: event_severity1
enum:
- normal
- critical
- high
- warning
type: string
description: 'Event severity level reported for this Mist Edge event. enum: `normal`, `critical`, `high`, `warning`.'
event_severity2:
title: event_severity2
enum:
- normal
- critical
- high
- warning
type: string
description: 'Event severity for the system resource condition. enum: `normal`, `critical`, `high`, `warning`.'
evpn_config_role2:
title: evpn_config_role2
enum:
- access
- border
- collapsed-core
- core
- distribution
- esilag-access
- none
type: string
description: 'EVPN topology role for the switch. enum: `access`, `border`, `collapsed-core`, `core`, `distribution`, `esilag-access`, `none`.'
evpn_config1:
title: evpn_config1
type: object
properties:
enabled:
type: boolean
description: Whether EVPN configuration is enabled on the switch
readOnly: true
role:
allOf:
- $ref: '#/components/schemas/evpn_config_role2'
- description: 'EVPN topology role for the switch. enum: `access`, `border`, `collapsed-core`, `core`, `distribution`, `esilag-access`, `none`.'
readOnly: true
description: EVPN defaults applied by this switch profile
evpn_config3:
title: evpn_config3
type: object
properties:
enabled:
type: boolean
description: Whether EVPN configuration is enabled on the switch
readOnly: true
role:
allOf:
- $ref: '#/components/schemas/evpn_config_role2'
- description: 'EVPN topology role for the switch. enum: `access`, `border`, `collapsed-core`, `core`, `distribution`, `esilag-access`, `none`.'
readOnly: true
description: EVPN configuration applied to this switch
evpn_options_overlay2:
title: evpn_options_overlay2
type: object
properties:
as:
maximum: 65535
minimum: 1
type: integer
description: Overlay BGP Local AS Number
contentEncoding: int32
default: 65000
examples:
- 65000
description: EVPN overlay BGP settings for the topology
evpn_options_routed_at2:
title: evpn_options_routed_at2
enum:
- core
- distribution
- edge
type: string
description: 'Topology tier where EVPN virtual gateway routing is placed. enum: `core`, `distribution`, `edge`.'
evpn_options_underlay2:
title: evpn_options_underlay2
type: object
properties:
as_base:
maximum: 65535
minimum: 1
type: integer
description: Underlay BGP Base AS Number
contentEncoding: int32
default: 65001
examples:
- 65001
routed_id_prefix:
type: string
description: Prefix length used for automatically derived underlay router identifiers
examples:
- /24
subnet:
type: string
description: Underlay subnet, by default, `10.255.240.0/20`, or `fd31:5700::/64` for ipv6
examples:
- 10.255.240.0/20
use_ipv6:
type: boolean
description: If v6 is desired for underlay
default: false
description: EVPN underlay BGP and subnet settings for the topology
evpn_options1:
title: evpn_options1
type: object
properties:
auto_loopback_subnet:
type: string
description: Optional, for dhcp_relay, unique loopback IPs are required for ERB or IPClos where we can set option-82 server_id-overrides
default: 172.16.192.0/24
auto_loopback_subnet6:
type: string
description: Optional, for dhcp_relay, unique loopback IPs are required for ERB or IPClos where we can set option-82 server_id-overrides
default: fd33:ab00:2::/64
auto_router_id_subnet:
type: string
description: Optional, this generates router_id automatically, if specified, `router_id_prefix` is ignored
default: 172.16.254.0/23
auto_router_id_subnet6:
type: string
description: Optional, this generates router_id automatically, if specified, `router_id_prefix` is ignored
examples:
- fd31:5700:1::/64
core_as_border:
type: boolean
description: Optional, for ERB or CLOS, you can either use esilag to upstream routers or to also be the virtual-gateway. When `routed_at` != `core`, whether to do virtual-gateway at core as well
default: false
enable_inband_mgmt:
type: boolean
description: Whether to route management traffic inband; routes will be propagated to downstream switches
default: false
enable_inband_ztp:
type: boolean
description: if the mangement traffic goes inbnd, during installation, only the border/core switches are connected to the Internet to allow initial configuration to be pushed down and leave the downstream access switches stay in the Factory Default state enabling inband-ztp allows upstream switches to use LLDP to assign IP and gives Internet to downstream switches in that state
default: false
overlay:
allOf:
- $ref: '#/components/schemas/evpn_options_overlay2'
- description: EVPN overlay BGP settings for the topology
per_vlan_vga_v4_mac:
type: boolean
description: Only for by Core-Distribution architecture when `evpn_options.routed_at`==`core`. By default, JUNOS uses 00-00-5e-00-01-01 as the virtual-gateway-address's v4_mac. If enabled, 00-00-5e-00-0X-YY will be used (where XX=vlan_id/256, YY=vlan_id%256)
default: false
per_vlan_vga_v6_mac:
type: boolean
description: Only for by Core-Distribution architecture when `evpn_options.routed_at`==`core`. By default, JUNOS uses 00-00-5e-00-02-01 as the virtual-gateway-address's v6_mac. If enabled, 00-00-5e-00-1X-YY will be used (where XX=vlan_id/256, YY=vlan_id%256)
default: false
routed_at:
allOf:
- $ref: '#/components/schemas/evpn_options_routed_at2'
- description: 'Topology tier where EVPN virtual gateway routing is placed. enum: `core`, `distribution`, `edge`.'
underlay:
allOf:
- $ref: '#/components/schemas/evpn_options_underlay2'
- description: EVPN underlay BGP and subnet settings for the topology
vs_instances:
type: object
additionalProperties:
$ref: '#/components/schemas/evpn_options_vs_instance'
description: Virtual-switch instance mappings used to segregate EVPN networks
examples:
- guest:
networks:
- guest
iot:
networks:
- iot-wifi
- iot-lan
description: Generation options applied to the EVPN topology
evpn_options3:
title: evpn_options3
type: object
properties:
auto_loopback_subnet:
type: string
description: Optional, for dhcp_relay, unique loopback IPs are required for ERB or IPClos where we can set option-82 server_id-overrides
default: 172.16.192.0/24
auto_loopback_subnet6:
type: string
description: Optional, for dhcp_relay, unique loopback IPs are required for ERB or IPClos where we can set option-82 server_id-overrides
default: fd33:ab00:2::/64
auto_router_id_subnet:
type: string
description: Optional, this generates router_id automatically, if specified, `router_id_prefix` is ignored
default: 172.16.254.0/23
auto_router_id_subnet6:
type: string
description: Optional, this generates router_id automatically, if specified, `router_id_prefix` is ignored
examples:
- fd31:5700:1::/64
core_as_border:
type: boolean
description: Optional, for ERB or CLOS, you can either use esilag to upstream routers or to also be the virtual-gateway. When `routed_at` != `core`, whether to do virtual-gateway at core as well
default: false
enable_inband_mgmt:
type: boolean
description: Whether to route management traffic inband; routes will be propagated to downstream switches
default: false
enable_inband_ztp:
type: boolean
description: if the mangement traffic goes inbnd, during installation, only the border/core switches are connected to the Internet to allow initial configuration to be pushed down and leave the downstream access switches stay in the Factory Default state enabling inband-ztp allows upstream switches to use LLDP to assign IP and gives Internet to downstream switches in that state
default: false
overlay:
allOf:
- $ref: '#/components/schemas/evpn_options_overlay2'
- description: EVPN overlay BGP settings for the topology
per_vlan_vga_v4_mac:
type: boolean
description: Only for by Core-Distribution architecture when `evpn_options.routed_at`==`core`. By default, JUNOS uses 00-00-5e-00-01-01 as the virtual-gateway-address's v4_mac. If enabled, 00-00-5e-00-0X-YY will be used (where XX=vlan_id/256, YY=vlan_id%256)
default: false
per_vlan_vga_v6_mac:
type: boolean
description: Only for by Core-Distribution architecture when `evpn_options.routed_at`==`core`. By default, JUNOS uses 00-00-5e-00-02-01 as the virtual-gateway-address's v6_mac. If enabled, 00-00-5e-00-1X-YY will be used (where XX=vlan_id/256, YY=vlan_id%256)
default: false
routed_at:
allOf:
- $ref: '#/components/schemas/evpn_options_routed_at2'
- description: 'Topology tier where EVPN virtual gateway routing is placed. enum: `core`, `distribution`, `edge`.'
underlay:
allOf:
- $ref: '#/components/schemas/evpn_options_underlay2'
- description: EVPN underlay BGP and subnet settings for the topology
vs_instances:
type: object
additionalProperties:
$ref: '#/components/schemas/evpn_options_vs_instance'
description: Virtual-switch instance mappings used to segregate EVPN networks
examples:
- guest:
networks:
- guest
iot:
networks:
- iot-wifi
- iot-lan
description: Fabric EVPN options for the site
evpn_topology_switch_config_dhcpd_config2:
title: evpn_topology_switch_config_dhcpd_config2
type: object
properties:
enabled:
type: boolean
description: If DHCPD is enabled on the switch
description: Switch DHCP server configuration for the topology member
evpn_topology_switch_config_vrf_config2:
title: evpn_topology_switch_config_vrf_config2
type: object
properties:
enabled:
type: boolean
description: Whether to enable VRF (when supported on the device)
description: Routing instance and VRF settings for the topology member
evpn_topology_switch_config1:
title: evpn_topology_switch_config1
type: object
properties:
dhcpd_config:
allOf:
- $ref: '#/components/schemas/evpn_topology_switch_config_dhcpd_config2'
- description: Switch DHCP server configuration for the topology member
networks:
type: object
additionalProperties:
$ref: '#/components/schemas/switch_network'
description: EVPN network definitions for the topology member
other_ip_configs:
type: object
additionalProperties:
$ref: '#/components/schemas/junos_other_ip_config'
description: Additional interface IP configurations for the topology member
port_config:
type: object
additionalProperties:
$ref: '#/components/schemas/junos_port_config'
description: Switch port configuration for the topology member
port_usages:
type: object
additionalProperties:
$ref: '#/components/schemas/switch_port_usage'
description: Switch port usage definitions for the topology member
router_id:
type: string
description: Used for OSPF / BGP / EVPN
examples:
- 10.2.1.10
vrf_config:
allOf:
- $ref: '#/components/schemas/evpn_topology_switch_config_vrf_config2'
- description: Routing instance and VRF settings for the topology member
description: Per-switch configuration supplied for this topology member. Use the [Update Site Device]($e/Sites%20Devices/updateSiteDevice) endpoint to update the switch configuration.
evpn_topology_switch_role2:
title: evpn_topology_switch_role2
enum:
- access
- border
- collapsed-core
- core
- distribution
- esilag-access
- none
type: string
description: 'EVPN topology role for this switch. enum: `access`, `border`, `collapsed-core`, `core`, `distribution`, `esilag-access`, `none`.'
fwupdate_stat_status2:
title: fwupdate_stat_status2
enum:
- inprogress
- failed
- upgraded
- success
- scheduled
- error
type: string
description: 'Current firmware update status. enum: `inprogress`, `failed`, `upgraded`, `success`, `scheduled`, `error`.'
fwupdate_stat1:
title: fwupdate_stat1
type: object
properties:
progress:
maximum: 100
minimum: 0
type:
- integer
- 'null'
description: Firmware update progress percentage, or null when unavailable
contentEncoding: int32
readOnly: true
examples:
- 10
status:
allOf:
- oneOf:
- {}
- $ref: '#/components/schemas/fwupdate_stat_status2'
- description: 'Current firmware update status. enum: `inprogress`, `failed`, `upgraded`, `success`, `scheduled`, `error`.'
readOnly: true
status_id:
type:
- integer
- 'null'
description: Numeric firmware update status identifier
contentEncoding: int32
readOnly: true
examples:
- 5
timestamp:
type: number
description: Time when the firmware update status was last updated
readOnly: true
will_retry:
type:
- boolean
- 'null'
description: Whether the firmware update process will retry after the current status
readOnly: true
examples:
- false
description: Firmware update status included with the tunnel statistics, when available
fwupdate_stat2:
title: fwupdate_stat2
type: object
properties:
progress:
maximum: 100
minimum: 0
type:
- integer
- 'null'
description: Firmware update progress percentage, or null when unavailable
contentEncoding: int32
readOnly: true
examples:
- 10
status:
allOf:
- oneOf:
- {}
- $ref: '#/components/schemas/fwupdate_stat_status2'
- description: 'Current firmware update status. enum: `inprogress`, `failed`, `upgraded`, `success`, `scheduled`, `error`.'
readOnly: true
status_id:
type:
- integer
- 'null'
description: Numeric firmware update status identifier
contentEncoding: int32
readOnly: true
examples:
- 5
timestamp:
type: number
description: Time when the firmware update status was last updated
readOnly: true
will_retry:
type:
- boolean
- 'null'
description: Whether the firmware update process will retry after the current status
readOnly: true
examples:
- false
description: Firmware update status for the AP
fwupdate_stat3:
title: fwupdate_stat3
type: object
properties:
progress:
maximum: 100
minimum: 0
type:
- integer
- 'null'
description: Firmware update progress percentage, or null when unavailable
contentEncoding: int32
readOnly: true
examples:
- 10
status:
allOf:
- oneOf:
- {}
- $ref: '#/components/schemas/fwupdate_stat_status2'
- description: 'Current firmware update status. enum: `inprogress`, `failed`, `upgraded`, `success`, `scheduled`, `error`.'
readOnly: true
status_id:
type:
- integer
- 'null'
description: Numeric firmware update status identifier
contentEncoding: int32
readOnly: true
examples:
- 5
timestamp:
type: number
description: Time when the firmware update status was last updated
readOnly: true
will_retry:
type:
- boolean
- 'null'
description: Whether the firmware update process will retry after the current status
readOnly: true
examples:
- false
description: Firmware update status for the switch
fwupdate_stat4:
title: fwupdate_stat4
type: object
properties:
progress:
maximum: 100
minimum: 0
type:
- integer
- 'null'
description: Firmware update progress percentage, or null when unavailable
contentEncoding: int32
readOnly: true
examples:
- 10
status:
allOf:
- oneOf:
- {}
- $ref: '#/components/schemas/fwupdate_stat_status2'
- description: 'Current firmware update status. enum: `inprogress`, `failed`, `upgraded`, `success`, `scheduled`, `error`.'
readOnly: true
status_id:
type:
- integer
- 'null'
description: Numeric firmware update status identifier
contentEncoding: int32
readOnly: true
examples:
- 5
timestamp:
type: number
description: Time when the firmware update status was last updated
readOnly: true
will_retry:
type:
- boolean
- 'null'
description: Whether the firmware update process will retry after the current status
readOnly: true
examples:
- false
description: Firmware update status for the gateway
fwupdate_stat5:
title: fwupdate_stat5
type: object
properties:
progress:
maximum: 100
minimum: 0
type:
- integer
- 'null'
description: Firmware update progress percentage, or null when unavailable
contentEncoding: int32
readOnly: true
examples:
- 10
status:
allOf:
- oneOf:
- {}
- $ref: '#/components/schemas/fwupdate_stat_status2'
- description: 'Current firmware update status. enum: `inprogress`, `failed`, `upgraded`, `success`, `scheduled`, `error`.'
readOnly: true
status_id:
type:
- integer
- 'null'
description: Numeric firmware update status identifier
contentEncoding: int32
readOnly: true
examples:
- 5
timestamp:
type: number
description: Time when the firmware update status was last updated
readOnly: true
will_retry:
type:
- boolean
- 'null'
description: Whether the firmware update process will retry after the current status
readOnly: true
examples:
- false
description: Firmware or package update status for the Mist Edge
gateway_compliance_version1:
title: gateway_compliance_version1
type: object
properties:
major_version:
type: object
additionalProperties:
$ref: '#/components/schemas/gateway_compliance_major_version_properties'
description: Per-model gateway major-version compliance details
score:
type: number
description: Gateway software version compliance score
examples:
- 99.9
type:
type: string
description: Device type represented by the gateway compliance metric
examples:
- gateway
description: Gateway software version compliance metric
gateway_matching2:
title: gateway_matching2
type: object
properties:
enable:
type: boolean
description: Whether gateway matching is enabled
rules:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/gateway_matching_rule'
description: Gateway matching rules evaluated for this configuration
description: Matching rules that select gateways for this template
gateway_matching3:
title: gateway_matching3
type: object
properties:
enable:
type: boolean
description: Whether gateway matching is enabled
rules:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/gateway_matching_rule'
description: Gateway matching rules evaluated for this configuration
description: Matching rules that select gateways for this profile
gateway_mgmt_auto_signature_update2:
title: gateway_mgmt_auto_signature_update2
type: object
properties:
day_of_week:
allOf:
- $ref: '#/components/schemas/day_of_week1'
- description: 'Scheduled weekday for automatic signature updates. enum: `any`, `fri`, `mon`, `sat`, `sun`, `thu`, `tue`, `wed`.'
enable:
type: boolean
description: Whether automatic security signature updates are enabled
default: true
time_of_day:
type: string
description: Optional, Mist will decide the timing
description: Schedule for automatic security signature updates
gateway_mgmt_host_out_policy_syslog1:
title: gateway_mgmt_host_out_policy_syslog1
type: object
properties:
path_preference:
type: string
description: Preferred path name used by default for gateway syslog traffic
examples:
- broadband_wans
servers:
type: array
items:
$ref: '#/components/schemas/gateway_mgmt_host_out_policy_syslog_server'
description: Per-server host-out path policies for gateway syslog traffic
description: Path preference policy for gateway-originated syslog traffic
gateway_mgmt_host_out_policy1:
title: gateway_mgmt_host_out_policy1
type: object
properties:
path_preference:
type: string
description: Preferred path name for this gateway-originated service traffic
description: Path preference policy for gateway-originated DNS traffic
gateway_mgmt_host_out_policy2:
title: gateway_mgmt_host_out_policy2
type: object
properties:
path_preference:
type: string
description: Preferred path name for this gateway-originated service traffic
description: Path preference policy for gateway-originated NTP traffic
gateway_mgmt2:
title: gateway_mgmt2
type: object
properties:
admin_sshkeys:
type: array
items:
type: string
description: SSR-only SSH public keys for administrative access
examples:
- - ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAA...Wxa6p6UW0ZbcP john@host
app_probing:
allOf:
- $ref: '#/components/schemas/app_probing1'
- description: Application probing configuration for gateway monitoring
app_usage:
type: boolean
description: Consumes uplink bandwidth, requires WA license
auto_signature_update:
allOf:
- $ref: '#/components/schemas/gateway_mgmt_auto_signature_update2'
- description: Schedule for automatic security signature updates
config_revert_timer:
maximum: 30
minimum: 1
type: integer
description: Rollback timer for commit confirmed
contentEncoding: int32
default: 10
disable_console:
type: boolean
description: For SSR and SRX, disable console port
default: false
disable_idp_pcap:
type: boolean
description: For SRX only, disable IDP packet capture
default: false
disable_oob:
type: boolean
description: For SSR and SRX, disable management interface
default: false
disable_usb:
type: boolean
description: For SSR and SRX, disable usb interface
default: false
fips_enabled:
type: boolean
description: Whether FIPS mode is enabled on the gateway
default: false
probe_hosts:
type: array
items:
type: string
description: IPv4 probe targets used for gateway connectivity checks
examples:
- - 8.8.8.8
probe_hostsv6:
type: array
items:
type: string
description: IPv6 probe targets used for gateway connectivity checks
examples:
- - 2001:4860:4860::8888
protect_re:
allOf:
- $ref: '#/components/schemas/protect_re1'
- description: Control-plane protection settings for the gateway
root_password:
type: string
description: SRX only. Root password for local gateway access
contentEncoding: password
security_log_source_address:
type: string
description: IPv4 source address used for gateway security log traffic
contentEncoding: ipv4
examples:
- 192.168.1.1
security_log_source_interface:
type: string
description: Source interface used for gateway security log traffic
examples:
- ge-0/0/1.0
description: Management-plane defaults provided by this gateway template
gateway_mgmt3:
title: gateway_mgmt3
type: object
properties:
admin_sshkeys:
type: array
items:
type: string
description: SSR-only SSH public keys for administrative access
examples:
- - ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAA...Wxa6p6UW0ZbcP john@host
app_probing:
allOf:
- $ref: '#/components/schemas/app_probing1'
- description: Application probing configuration for gateway monitoring
app_usage:
type: boolean
description: Consumes uplink bandwidth, requires WA license
auto_signature_update:
allOf:
- $ref: '#/components/schemas/gateway_mgmt_auto_signature_update2'
- description: Schedule for automatic security signature updates
config_revert_timer:
maximum: 30
minimum: 1
type: integer
description: Rollback timer for commit confirmed
contentEncoding: int32
default: 10
disable_console:
type: boolean
description: For SSR and SRX, disable console port
default: false
disable_idp_pcap:
type: boolean
description: For SRX only, disable IDP packet capture
default: false
disable_oob:
type: boolean
description: For SSR and SRX, disable management interface
default: false
disable_usb:
type: boolean
description: For SSR and SRX, disable usb interface
default: false
fips_enabled:
type: boolean
description: Whether FIPS mode is enabled on the gateway
default: false
probe_hosts:
type: array
items:
type: string
description: IPv4 probe targets used for gateway connectivity checks
examples:
- - 8.8.8.8
probe_hostsv6:
type: array
items:
type: string
description: IPv6 probe targets used for gateway connectivity checks
examples:
- - 2001:4860:4860::8888
protect_re:
allOf:
- $ref: '#/components/schemas/protect_re1'
- description: Control-plane protection settings for the gateway
root_password:
type: string
description: SRX only. Root password for local gateway access
contentEncoding: password
security_log_source_address:
type: string
description: IPv4 source address used for gateway security log traffic
contentEncoding: ipv4
examples:
- 192.168.1.1
security_log_source_interface:
type: string
description: Source interface used for gateway security log traffic
examples:
- ge-0/0/1.0
description: Management access settings for gateways at the site
gateway_mgmt4:
title: gateway_mgmt4
type: object
properties:
admin_sshkeys:
type: array
items:
type: string
description: SSR-only SSH public keys for administrative access
examples:
- - ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAA...Wxa6p6UW0ZbcP john@host
app_probing:
allOf:
- $ref: '#/components/schemas/app_probing1'
- description: Application probing configuration for gateway monitoring
app_usage:
type: boolean
description: Consumes uplink bandwidth, requires WA license
auto_signature_update:
allOf:
- $ref: '#/components/schemas/gateway_mgmt_auto_signature_update2'
- description: Schedule for automatic security signature updates
config_revert_timer:
maximum: 30
minimum: 1
type: integer
description: Rollback timer for commit confirmed
contentEncoding: int32
default: 10
disable_console:
type: boolean
description: For SSR and SRX, disable console port
default: false
disable_idp_pcap:
type: boolean
description: For SRX only, disable IDP packet capture
default: false
disable_oob:
type: boolean
description: For SSR and SRX, disable management interface
default: false
disable_usb:
type: boolean
description: For SSR and SRX, disable usb interface
default: false
fips_enabled:
type: boolean
description: Whether FIPS mode is enabled on the gateway
default: false
probe_hosts:
type: array
items:
type: string
description: IPv4 probe targets used for gateway connectivity checks
examples:
- - 8.8.8.8
probe_hostsv6:
type: array
items:
type: string
description: IPv6 probe targets used for gateway connectivity checks
examples:
- - 2001:4860:4860::8888
protect_re:
allOf:
- $ref: '#/components/schemas/protect_re1'
- description: Control-plane protection settings for the gateway
root_password:
type: string
description: SRX only. Root password for local gateway access
contentEncoding: password
security_log_source_address:
type: string
description: IPv4 source address used for gateway security log traffic
contentEncoding: ipv4
examples:
- 192.168.1.1
security_log_source_interface:
type: string
description: Source interface used for gateway security log traffic
examples:
- ge-0/0/1.0
description: Management-plane settings for this gateway
gateway_oob_ip_config_node12:
title: gateway_oob_ip_config_node12
type: object
properties:
gateway:
type: string
description: Default gateway for the node1 out-of-band management interface when `type`==`static`
ip:
type: string
description: Static IPv4 address for the node1 out-of-band management interface when `type`==`static`
netmask:
type: string
description: IPv4 netmask or prefix length for the node1 out-of-band management interface when `type`==`static`; used only if `subnet` is not specified in `networks`
type:
allOf:
- $ref: '#/components/schemas/ip_type5'
- description: 'IP assignment mode for the node1 out-of-band management interface. enum: `dhcp`, `static`.'
examples:
- static
use_mgmt_vrf:
type: boolean
description: If supported on the platform. If enabled, DNS will be using this routing-instance, too
default: false
use_mgmt_vrf_for_host_out:
type: boolean
description: Whether to use `mgmt_junos` for host-out traffic (NTP/TACPLUS/RADIUS/SYSLOG/SNMP), if alternative source network/ip is desired
default: false
vlan_id:
oneOf:
- type: string
- maximum: 4094
minimum: 1
type: integer
contentEncoding: int32
description: VLAN ID used for node1 out-of-band management traffic
description: Out-of-band management IP configuration override for node1 in an HA cluster
gateway_oob_ip_config1:
title: gateway_oob_ip_config1
type: object
properties:
gateway:
type: string
description: Default gateway for the out-of-band management interface when `type`==`static`
ip:
type: string
description: Static IPv4 address for the out-of-band management interface when `type`==`static`
netmask:
type: string
description: IPv4 netmask or prefix length for the out-of-band management interface when `type`==`static`
node1:
allOf:
- $ref: '#/components/schemas/gateway_oob_ip_config_node12'
- description: Out-of-band management IP configuration override for node1 in an HA cluster
type:
allOf:
- $ref: '#/components/schemas/ip_type2'
- description: 'IP assignment mode for the out-of-band management interface. enum: `dhcp`, `static`.'
examples:
- static
use_mgmt_vrf:
type: boolean
description: If supported on the platform. If enabled, DNS will be using this routing-instance, too
default: false
use_mgmt_vrf_for_host_out:
type: boolean
description: For host-out traffic (NTP/TACPLUS/RADIUS/SYSLOG/SNMP), if alternative source network/ip is desired
default: false
vlan_id:
oneOf:
- type: string
- maximum: 4094
minimum: 1
type: integer
contentEncoding: int32
description: VLAN ID used for out-of-band management traffic
description: Out-of-band management IP defaults in this gateway profile
gateway_oob_ip_config3:
title: gateway_oob_ip_config3
type: object
properties:
gateway:
type: string
description: Default gateway for the out-of-band management interface when `type`==`static`
ip:
type: string
description: Static IPv4 address for the out-of-band management interface when `type`==`static`
netmask:
type: string
description: IPv4 netmask or prefix length for the out-of-band management interface when `type`==`static`
node1:
allOf:
- $ref: '#/components/schemas/gateway_oob_ip_config_node12'
- description: Out-of-band management IP configuration override for node1 in an HA cluster
type:
allOf:
- $ref: '#/components/schemas/ip_type2'
- description: 'IP assignment mode for the out-of-band management interface. enum: `dhcp`, `static`.'
examples:
- static
use_mgmt_vrf:
type: boolean
description: If supported on the platform. If enabled, DNS will be using this routing-instance, too
default: false
use_mgmt_vrf_for_host_out:
type: boolean
description: For host-out traffic (NTP/TACPLUS/RADIUS/SYSLOG/SNMP), if alternative source network/ip is desired
default: false
vlan_id:
oneOf:
- type: string
- maximum: 4094
minimum: 1
type: integer
contentEncoding: int32
description: VLAN ID used for out-of-band management traffic
description: Out-of-band management IP defaults in this gateway template
gateway_oob_ip_config4:
title: gateway_oob_ip_config4
type: object
properties:
gateway:
type: string
description: Default gateway for the out-of-band management interface when `type`==`static`
ip:
type: string
description: Static IPv4 address for the out-of-band management interface when `type`==`static`
netmask:
type: string
description: IPv4 netmask or prefix length for the out-of-band management interface when `type`==`static`
node1:
allOf:
- $ref: '#/components/schemas/gateway_oob_ip_config_node12'
- description: Out-of-band management IP configuration override for node1 in an HA cluster
type:
allOf:
- $ref: '#/components/schemas/ip_type2'
- description: 'IP assignment mode for the out-of-band management interface. enum: `dhcp`, `static`.'
examples:
- static
use_mgmt_vrf:
type: boolean
description: If supported on the platform. If enabled, DNS will be using this routing-instance, too
default: false
use_mgmt_vrf_for_host_out:
type: boolean
description: For host-out traffic (NTP/TACPLUS/RADIUS/SYSLOG/SNMP), if alternative source network/ip is desired
default: false
vlan_id:
oneOf:
- type: string
- maximum: 4094
minimum: 1
type: integer
contentEncoding: int32
description: VLAN ID used for out-of-band management traffic
description: Out-of-band management IP configuration for this gateway
gateway_path_strategy2:
title: gateway_path_strategy2
enum:
- ecmp
- ordered
- weighted
type: string
description: 'Selection strategy used to evaluate the candidate paths. enum: `ecmp`, `ordered`, `weighted`.'
gateway_path_type2:
title: gateway_path_type2
enum:
- local
- tunnel
- vpn
- wan
type: string
description: Gateway path source type, such as local network, WAN interface, VPN path, or tunnel
gateway_port_config_ip_config2:
title: gateway_port_config_ip_config2
type: object
properties:
dns:
type: array
items:
type: string
description: Resolver server IP addresses used by this interface, except on out-of-band interfaces such as vme, em0, or fxp0
dns_suffix:
type: array
items:
type: string
description: DNS search suffixes used by this interface, except on out-of-band interfaces such as vme, em0, or fxp0
gateway:
type: string
description: Except for out-of_band interface (vme/em0/fxp0). Interface Default Gateway IP address (i.e. "192.168.1.1") or a Variable (i.e. "{{myvar}}")
examples:
- 192.168.1.1
gateway6:
type: string
description: Except for out-of_band interface (vme/em0/fxp0). Interface Default Gateway IPv6 Address (i.e. "2001:db8::1") or a Variable (i.e. "{{myvar}}")
examples:
- 2001:db8::1
ip:
type: string
description: Interface IP address (i.e. "192.168.1.8") or a Variable (i.e. "{{myvar}}")
contentEncoding: ipv4
examples:
- 192.168.1.8
ip6:
type: string
description: Interface IPv6 Address (i.e. "2001:db8::123") or a Variable (i.e. "{{myvar}}")
contentEncoding: ipv6
examples:
- 2001:db8::123
netmask:
type: string
description: Used only if `subnet` is not specified in `networks`. Interface Netmask (i.e. "/24") or a Variable (i.e. "{{myvar}}")
examples:
- /24
netmask6:
type: string
description: Used only if `subnet` is not specified in `networks`. Interface IPv6 Netmask (i.e. "/64") or a Variable (i.e. "{{myvar}}")
examples:
- /64
network:
type: string
description: Optional, the network to be used for mgmt
poser_password:
type: string
description: Password used for PPPoE when `type`==`pppoe`
contentEncoding: password
pppoe_auth:
allOf:
- $ref: '#/components/schemas/gateway_wan_ppoe_auth2'
- description: 'Authentication protocol used for PPPoE when `type`==`pppoe`. enum: `chap`, `none`, `pap`.'
pppoe_username:
type: string
description: Username used for PPPoE when `type`==`pppoe`
type:
allOf:
- $ref: '#/components/schemas/gateway_wan_type2'
- description: 'IPv4 assignment mode for this gateway port interface. enum: `dhcp`, `pppoe`, `static`.'
type6:
allOf:
- $ref: '#/components/schemas/gateway_wan_type62'
- description: 'IPv6 assignment mode for this gateway port interface. enum: `autoconf`, `dhcp`, `static`.'
description: Layer 3 IP configuration for the port
gateway_port_config_wan_speedtest_mode2:
title: gateway_port_config_wan_speedtest_mode2
enum:
- auto
- enabled
- disabled
type: string
description: 'Controls whether Marvis or the scheduler can run speed tests on this WAN port. enum: `auto`, `enabled`, `disabled`.'
examples:
- auto
gateway_port_dsl_type2:
title: gateway_port_dsl_type2
enum:
- adsl
- vdsl
type: string
description: 'If `wan_type`==`dsl`. DSL technology used by the WAN port. enum: `adsl`, `vdsl`.'
gateway_port_duplex2:
title: gateway_port_duplex2
enum:
- auto
- full
- half
type: string
description: 'Ethernet duplex mode configured on the port. enum: `auto`, `full`, `half`.'
examples:
- full
gateway_port_lte_auth2:
title: gateway_port_lte_auth2
enum:
- chap
- none
- pap
type: string
description: 'If `wan_type`==`lte`. Authentication method used by the LTE uplink. enum: `chap`, `none`, `pap`.'
gateway_port_mirroring_port_mirror2:
title: gateway_port_mirroring_port_mirror2
type: object
properties:
family_type:
type: string
description: Packet family used for this port mirroring rule
ingress_port_ids:
type: array
items:
type: string
description: Source gateway port IDs whose ingress traffic is mirrored
output_port_id:
type: string
description: Destination gateway port ID that receives mirrored traffic
examples:
- ge-0/0/5
rate:
type: integer
description: Sampling rate applied to mirrored traffic
contentEncoding: int32
run_length:
minimum: 0
type: integer
description: Number of bytes copied from each mirrored packet
contentEncoding: int32
description: Mirroring rule that copies ingress traffic from source ports to an output port
gateway_port_mirroring2:
title: gateway_port_mirroring2
type: object
properties:
port_mirror:
allOf:
- $ref: '#/components/schemas/gateway_port_mirroring_port_mirror2'
- description: Mirroring rule that copies ingress traffic from source ports to an output port
description: Port mirroring configuration for this gateway
gateway_port_usage2:
title: gateway_port_usage2
enum:
- ha_control
- ha_data
- lan
- wan
type: string
description: 'Logical usage assigned to the port. enum: `ha_control`, `ha_data`, `lan`, `wan`.'
gateway_port_vpn_path_bfd_profile2:
title: gateway_port_vpn_path_bfd_profile2
enum:
- broadband
- lte
type: string
description: 'BFD profile used for this VPN path when the VPN `type`==`hub_spoke`. enum: `broadband`, `lte`.'
gateway_port_vpn_path_role2:
title: gateway_port_vpn_path_role2
enum:
- hub
- mesh
- spoke
type: string
description: 'Gateway role for this VPN path; valid values depend on the VPN `type`. enum: `hub`, `mesh`, `spoke`.'
gateway_port_wan_arp_policer2:
title: gateway_port_wan_arp_policer2
enum:
- default
- max
- recommended
type: string
description: 'Only when `wan_type`==`broadband`. ARP policer profile applied to the WAN port. enum: `default`, `max`, `recommended`.'
gateway_port_wan_source_nat2:
title: gateway_port_wan_source_nat2
type: object
properties:
disabled:
type: boolean
description: Or to disable the source-nat
default: false
nat6_pool:
type: string
description: If alternative nat_pool is desired
examples:
- 2601:1700:43c0:dc0:20c:29ff:fea7:93bc/126
nat_pool:
type: string
description: If alternative nat_pool is desired
examples:
- 64.2.4.0/30
description: Source NAT settings applied to traffic leaving this WAN port
gateway_port_wan_type2:
title: gateway_port_wan_type2
enum:
- broadband
- dsl
- lte
type: string
description: 'Only if `usage`==`wan`. WAN uplink type configured on the port. enum: `broadband`, `dsl`, `lte`.'
gateway_template_type2:
title: gateway_template_type2
enum:
- spoke
- standalone
type: string
description: 'Gateway template deployment type. enum: `spoke`, `standalone`.'
examples:
- standalone
gateway_template1:
title: gateway_template1
required:
- name
type: object
properties:
additional_config_cmds:
type: array
items:
type: string
description: Additional CLI configuration commands provided by this gateway template
bgp_config:
type: object
additionalProperties:
$ref: '#/components/schemas/bgp_config'
description: BGP routing defaults for this gateway template. Property key is the BGP session name
created_time:
type: number
description: Timestamp when the gateway template was created
readOnly: true
dhcpd_config:
allOf:
- $ref: '#/components/schemas/dhcpd_config3'
- description: DHCP server defaults provided by this gateway template
dnsOverride:
type: boolean
description: Whether DNS server and suffix settings in this template override inherited values
default: false
dns_servers:
type: array
items:
type: string
description: DNS servers provided by this gateway template
dns_suffix:
type: array
items:
type: string
description: DNS search suffixes provided by this gateway template
extra_routes:
type: object
additionalProperties:
$ref: '#/components/schemas/gateway_extra_route'
description: Additional IPv4 route defaults in this gateway template
extra_routes6:
type: object
additionalProperties:
$ref: '#/components/schemas/gateway_extra_route6'
description: Additional IPv6 route defaults in this gateway template
examples:
- 2a02:1234:420a:10c9::/64:
via: 2a02:1234:200a::100
gateway_matching:
allOf:
- $ref: '#/components/schemas/gateway_matching2'
- description: Matching rules that select gateways for this template
gateway_mgmt:
allOf:
- $ref: '#/components/schemas/gateway_mgmt2'
- description: Management-plane defaults provided by this gateway template
id:
type: string
description: Unique identifier of the gateway template
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
idp_profiles:
type: object
additionalProperties:
$ref: '#/components/schemas/idp_profile'
description: Intrusion detection and prevention profile defaults in this gateway template
ip_configs:
type: object
additionalProperties:
$ref: '#/components/schemas/gateway_ip_config_property'
description: Gateway interface IP configuration defaults by network name
modified_time:
type: number
description: Timestamp when the gateway template was last modified
readOnly: true
name:
type: string
description: Display name of the gateway template
examples:
- gw_template
networks:
type: array
items:
$ref: '#/components/schemas/network'
description: Layer 3 networks configured by this gateway template
ntpOverride:
type: boolean
description: Whether NTP servers in this template override inherited values
default: false
ntp_servers:
type: array
items:
type: string
description: NTP servers provided by this gateway template
oob_ip_config:
allOf:
- $ref: '#/components/schemas/gateway_oob_ip_config3'
- description: Out-of-band management IP defaults in this gateway template
org_id:
type: string
description: Organization that owns this gateway template
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
path_preferences:
type: object
additionalProperties:
$ref: '#/components/schemas/gateway_path_preferences'
description: Property key is the path name
port_config:
type: object
additionalProperties:
$ref: '#/components/schemas/gateway_port_config'
description: Property key is the Port Name (i.e. "ge-0/0/0"), the Ports Range (i.e. "ge-0/0/0-10"), the List of Ports (i.e. "ge-0/0/0,ge-1/0/0", only allowed for Aggregated or Redundant interfaces) or a Variable (i.e. "{{myvar}}").
router_id:
type: string
description: Auto assigned if not set
examples:
- 10.2.1.10
routing_policies:
type: object
additionalProperties:
$ref: '#/components/schemas/gw_routing_policy'
description: Routing policy defaults applied by this gateway template
service_policies:
type: array
items:
$ref: '#/components/schemas/service_policy'
description: Traffic service policy defaults enforced by this gateway template
tunnel_configs:
type: object
additionalProperties:
$ref: '#/components/schemas/tunnel_config'
description: Property key is the tunnel name
tunnel_provider_options:
allOf:
- $ref: '#/components/schemas/tunnel_provider_options2'
- description: Provider-specific tunnel options defined by this gateway template
type:
allOf:
- $ref: '#/components/schemas/gateway_template_type2'
- description: 'Gateway template deployment type. enum: `spoke`, `standalone`.'
examples:
- standalone
url_filtering_deny_msg:
type: string
description: When a service policy denies a app_category, what message to show in user's browser
default: Access to this URL Category has been blocked
examples:
- Access to this URL Category has been blocked
vrf_config:
allOf:
- $ref: '#/components/schemas/vrf_config4'
- description: VRF defaults applied by this gateway template
vrf_instances:
type: object
additionalProperties:
$ref: '#/components/schemas/gateway_vrf_instance'
description: VRF instances configured by this gateway template
examples:
- CORP_VRF:
networks:
- CORP_NET
- MGMT_NET
description: Template settings applied to site gateways
gateway_traffic_shaping1:
title: gateway_traffic_shaping1
type: object
properties:
class_percentages:
type: array
items:
type: integer
contentEncoding: int32
description: Traffic class bandwidth percentages for high, medium, low, and best-effort queues
enabled:
type: boolean
description: Whether traffic shaping is enabled
default: false
max_tx_kbps:
type: integer
description: Maximum transmit bandwidth for the interface, in Kbps
contentEncoding: int32
description: Traffic shaping settings applied to this VPN path
gateway_traffic_shaping3:
title: gateway_traffic_shaping3
type: object
properties:
class_percentages:
type: array
items:
type: integer
contentEncoding: int32
description: Traffic class bandwidth percentages for high, medium, low, and best-effort queues
enabled:
type: boolean
description: Whether traffic shaping is enabled
default: false
max_tx_kbps:
type: integer
description: Maximum transmit bandwidth for the interface, in Kbps
contentEncoding: int32
description: Traffic shaping settings applied to the port
gateway_wan_ppoe_auth2:
title: gateway_wan_ppoe_auth2
enum:
- chap
- none
- pap
type: string
description: 'Authentication protocol used for PPPoE when `type`==`pppoe`. enum: `chap`, `none`, `pap`.'
gateway_wan_probe_override_http2:
title: gateway_wan_probe_override_http2
type: object
properties:
accepted_status_codes:
type: array
items:
type: integer
contentEncoding: int32
description: HTTP response status codes that indicate a successful probe. Defaults to 200 if not specified.
examples:
- - 204
urls:
type: array
items:
type: string
description: HTTP or HTTPS URLs to probe
examples:
- - http://www.google.com/generate_204
- https://www.google.com/generate_204
description: HTTP probe settings; success from any ICMP or HTTP probe indicates the WAN is up
gateway_wan_probe_override_probe_profile2:
title: gateway_wan_probe_override_probe_profile2
enum:
- broadband
- lte
type: string
description: 'WAN probe profile used for health checks on this port. enum: `broadband`, `lte`.'
gateway_wan_probe_override2:
title: gateway_wan_probe_override2
type: object
properties:
hostnames:
uniqueItems: true
type: array
items:
type: string
description: List of hostnames used as probe destinations; applicable for both IPv4 and IPv6
http:
allOf:
- $ref: '#/components/schemas/gateway_wan_probe_override_http2'
- description: HTTP probe settings; success from any ICMP or HTTP probe indicates the WAN is up
ip6s:
uniqueItems: true
type: array
items:
type: string
description: List of IPv6 probe host addresses used by this WAN override
ips:
uniqueItems: true
type: array
items:
type: string
description: List of IPv4 probe host addresses used by this WAN override
probe_profile:
allOf:
- $ref: '#/components/schemas/gateway_wan_probe_override_probe_profile2'
- description: 'WAN probe profile used for health checks on this port. enum: `broadband`, `lte`.'
description: Optional WAN health probe override settings for this port
gateway_wan_type2:
title: gateway_wan_type2
enum:
- dhcp
- pppoe
- static
type: string
description: 'IPv4 assignment mode for this gateway port interface. enum: `dhcp`, `pppoe`, `static`.'
gateway_wan_type62:
title: gateway_wan_type62
enum:
- autoconf
- dhcp
- static
type: string
description: 'IPv6 assignment mode for this gateway port interface. enum: `autoconf`, `dhcp`, `static`.'
guest1:
title: guest1
type: object
properties:
access_code_email:
type: string
description: If `auth_method`==`email`, the email address where the authorization code has been sent to
readOnly: true
ap_mac:
type: string
description: MAC address of the AP used during guest registration
readOnly: true
auth_method:
type: string
description: Guest authentication method used for the authorization
readOnly: true
authorized:
type: boolean
description: Whether the guest is currently authorized
default: true
authorized_expiring_time:
type: number
description: Unix timestamp when the guest authorization expires
readOnly: true
examples:
- 1480704955
authorized_time:
type: number
description: Unix timestamp when the guest was authorized
readOnly: true
examples:
- 1480704355
company:
type: string
description: Optional company name provided by the guest during registration
examples:
- abc
email:
type: string
description: Optional email address provided by the guest during registration
contentEncoding: email
examples:
- john@abc.com
field1:
type: string
description: Optional custom field 1 value provided by the guest during registration
field2:
type: string
description: Optional custom field 2 value provided by the guest during registration
field3:
type: string
description: Optional custom field 3 value provided by the guest during registration
field4:
type: string
description: Optional custom field 4 value provided by the guest during registration
mac:
type: string
description: Device MAC address captured during guest registration
readOnly: true
minutes:
maximum: 259200
minimum: 0
type: integer
description: Authorization duration, in minutes. Default is 1440 minutes (1 day), maximum is 259200 (180 days)
contentEncoding: int32
default: 1440
name:
type: string
description: Optional name provided by the guest during registration
readOnly: true
examples:
- John Smith
random_mac:
type: boolean
description: Whether the guest device used a randomized MAC address to connect to the SSID
readOnly: true
ssid:
type: string
description: Name of the SSID
readOnly: true
examples:
- Guest-SSID
wlan_id:
type: string
description: Identifier of the WLAN used for the guest authorization
contentEncoding: uuid
readOnly: true
examples:
- 6748cfa6-4e12-11e6-9188-0242ac110007
description: Portal guest details for the wireless client
gw_routing_policy_term_action2:
title: gw_routing_policy_term_action2
type: object
properties:
accept:
type: boolean
description: Whether to accept routes that match this term. Precedence is `accept` > `next_term` > `next_policy`; routes are rejected if all three are false
add_community:
type: array
items:
type: string
description: BGP communities to add to routes that match this term
add_target_vrfs:
type: array
items:
type: string
description: SSR target VRFs to add when leaking routes from hub to spoke
community:
type: array
items:
type: string
description: BGP communities to set when this term is used as an export policy
exclude_as_path:
type: array
items:
type: string
description: AS path values to exclude when this term is used as an export policy
exclude_community:
type: array
items:
type: string
description: BGP communities to exclude from routes that match this term
export_communities:
type: array
items:
type: string
description: BGP communities allowed for export when this term is used as an export policy
local_preference:
anyOf:
- type: string
- maximum: 4294967295
minimum: 1
type: integer
contentEncoding: int32
description: Preference value to set when this term is used as an import policy
next_policy:
type: boolean
description: When true, continue evaluating the next routing policy in the chain after this term matches; default is false
default: false
next_term:
type: boolean
description: When true, continue evaluating the next term in the same routing policy after this term matches; default is false
default: false
prepend_as_path:
type: array
items:
type: string
description: AS path values to prepend when this term is used as an export policy
description: Policy actions applied when this routing policy term matches
gw_routing_policy_term_matching_route_exists2:
title: gw_routing_policy_term_matching_route_exists2
type: object
properties:
route:
type: string
description: Prefix that must exist for this condition to match
examples:
- 192.168.0.0/24
vrf_name:
type: string
description: Name of the VRF instance where the route is checked; can also be a VPN or WAN name when applicable
default: default
description: Existing route condition that must be satisfied before this term matches
gw_routing_policy_term_matching_vpn_path_sla2:
title: gw_routing_policy_term_matching_vpn_path_sla2
type: object
properties:
max_jitter:
type:
- integer
- 'null'
description: Maximum jitter threshold allowed for the VPN path
contentEncoding: int32
max_latency:
type:
- integer
- 'null'
description: Maximum latency threshold allowed for the VPN path
contentEncoding: int32
examples:
- 1500
max_loss:
type:
- integer
- 'null'
description: Maximum packet-loss threshold allowed for the VPN path
contentEncoding: int32
examples:
- 30
description: SLA thresholds used when matching a VPN path
gw_routing_policy_term_matching2:
title: gw_routing_policy_term_matching2
type: object
properties:
as_path:
type: array
items:
$ref: '#/components/schemas/bgp_as'
description: AS path values that routes must match
community:
type: array
items:
type: string
description: BGP communities that routes must match
network:
uniqueItems: true
type: array
items:
type: string
description: Configured network names that routes must match
prefix:
type: array
items:
type: string
description: Route prefixes that routes must match
protocol:
type: array
items:
$ref: '#/components/schemas/gw_routing_policy_term_matching_protocol_enum'
description: Routing protocols that routes must match
route_exists:
allOf:
- $ref: '#/components/schemas/gw_routing_policy_term_matching_route_exists2'
- description: Existing route condition that must be satisfied before this term matches
vpn_neighbor_mac:
type: array
items:
type: string
description: Overlay neighbor MAC addresses used as match criteria for BGP sessions with `via`==`vpn`
vpn_path:
type: array
items:
type: string
description: Overlay path names used as match criteria for BGP sessions with `via`==`vpn`
vpn_path_sla:
allOf:
- $ref: '#/components/schemas/gw_routing_policy_term_matching_vpn_path_sla2'
- description: SLA thresholds used when matching a VPN path
description: Route match criteria that must be satisfied before actions are applied
ha_cluster_node_enum2:
title: ha_cluster_node_enum2
enum:
- node0
- node1
type: string
description: 'HA cluster node on which to create the shell session. enum: `node0`, `node1`.'
ha_cluster_node_enum3:
title: ha_cluster_node_enum3
enum:
- node0
- node1
type: string
description: 'HA cluster node on which to clear ARP entries. enum: `node0`, `node1`.'
ha_cluster_node_enum4:
title: ha_cluster_node_enum4
enum:
- node0
- node1
type: string
description: 'HA cluster node on which to clear BGP sessions. enum: `node0`, `node1`.'
ha_cluster_node_enum5:
title: ha_cluster_node_enum5
enum:
- node0
- node1
type: string
description: 'HA cluster node on which to clear sessions. enum: `node0`, `node1`.'
ha_cluster_node_enum6:
title: ha_cluster_node_enum6
enum:
- node0
- node1
type: string
description: 'HA cluster node from which to send ping packets. enum: `node0`, `node1`.'
ha_cluster_node_enum7:
title: ha_cluster_node_enum7
enum:
- node0
- node1
type: string
description: 'HA cluster node on which to release the DHCP lease. enum: `node0`, `node1`.'
ha_cluster_node_enum8:
title: ha_cluster_node_enum8
enum:
- node0
- node1
type: string
description: 'HA cluster node on which to release DHCP leases. enum: `node0`, `node1`.'
ha_cluster_node_enum9:
title: ha_cluster_node_enum9
enum:
- node0
- node1
type: string
description: 'HA cluster node from which to send the service ping. enum: `node0`, `node1`.'
ha_cluster_node_enum10:
title: ha_cluster_node_enum10
enum:
- node0
- node1
type: string
description: 'HA cluster node to run the command on, required for Gateways. enum: `node0`, `node1`.'
ha_cluster_node_enum11:
title: ha_cluster_node_enum11
enum:
- node0
- node1
type: string
description: 'HA cluster node on which to show the BGP summary. enum: `node0`, `node1`.'
ha_cluster_node_enum12:
title: ha_cluster_node_enum12
enum:
- node0
- node1
type: string
description: 'HA cluster node on which to show DHCP leases. enum: `node0`, `node1`.'
ha_cluster_node_enum13:
title: ha_cluster_node_enum13
enum:
- node0
- node1
type: string
description: 'HA cluster node on which to show the forwarding table. enum: `node0`, `node1`.'
ha_cluster_node_enum14:
title: ha_cluster_node_enum14
enum:
- node0
- node1
type: string
description: 'HA cluster node on which to show the OSPF database. enum: `node0`, `node1`.'
ha_cluster_node_enum15:
title: ha_cluster_node_enum15
enum:
- node0
- node1
type: string
description: 'HA cluster node on which to show OSPF interfaces. enum: `node0`, `node1`.'
ha_cluster_node_enum16:
title: ha_cluster_node_enum16
enum:
- node0
- node1
type: string
description: 'HA cluster node on which to show OSPF neighbors. enum: `node0`, `node1`.'
ha_cluster_node_enum17:
title: ha_cluster_node_enum17
enum:
- node0
- node1
type: string
description: 'HA cluster node on which to show the OSPF summary. enum: `node0`, `node1`.'
ha_cluster_node_enum18:
title: ha_cluster_node_enum18
enum:
- node0
- node1
type: string
description: 'HA cluster node on which to show the service path. enum: `node0`, `node1`.'
ha_cluster_node_enum19:
title: ha_cluster_node_enum19
enum:
- node0
- node1
type: string
description: 'HA cluster node on which to show active sessions. enum: `node0`, `node1`.'
ha_cluster_node_enum20:
title: ha_cluster_node_enum20
enum:
- node0
- node1
type: string
description: 'HA cluster node from which to run traceroute. enum: `node0`, `node1`.'
ha_cluster_node_enum21:
title: ha_cluster_node_enum21
enum:
- node0
- node1
type: string
description: 'HA cluster node associated with this alarm event when applicable. enum: `node0`, `node1`.'
ha_cluster_node_enum22:
title: ha_cluster_node_enum22
enum:
- node0
- node1
type: string
description: 'HA cluster node on which to run the device operation. enum: `node0`, `node1`.'
ha_cluster_node1:
title: ha_cluster_node1
type: object
properties:
node:
allOf:
- $ref: '#/components/schemas/ha_cluster_node_enum22'
- description: 'HA cluster node on which to run the device operation. enum: `node0`, `node1`.'
description: HA cluster node on which to show routes
hours1:
title: hours1
type: object
properties:
fri:
type: string
description: Operating hour range for Friday
examples:
- 09:00-17:00
mon:
type: string
description: Operating hour range for Monday
examples:
- 09:00-17:00
sat:
type: string
description: Operating hour range for Saturday
examples:
- 09:00-17:00
sun:
type: string
description: Operating hour range for Sunday
examples:
- 09:00-17:00
thu:
type: string
description: Operating hour range for Thursday
examples:
- 09:00-17:00
tue:
type: string
description: Operating hour range for Tuesday
examples:
- 09:00-17:00
wed:
type: string
description: Operating hour range for Wednesday
examples:
- 09:00-17:00
description: Day-of-week hour ranges when configuration pushes are allowed
hours2:
title: hours2
type: object
properties:
fri:
type: string
description: Operating hour range for Friday
examples:
- 09:00-17:00
mon:
type: string
description: Operating hour range for Monday
examples:
- 09:00-17:00
sat:
type: string
description: Operating hour range for Saturday
examples:
- 09:00-17:00
sun:
type: string
description: Operating hour range for Sunday
examples:
- 09:00-17:00
thu:
type: string
description: Operating hour range for Thursday
examples:
- 09:00-17:00
tue:
type: string
description: Operating hour range for Tuesday
examples:
- 09:00-17:00
wed:
type: string
description: Operating hour range for Wednesday
examples:
- 09:00-17:00
description: Time ranges when the WLAN is scheduled to operate
hours3:
title: hours3
type: object
properties:
fri:
type: string
description: Operating hour range for Friday
examples:
- 09:00-17:00
mon:
type: string
description: Operating hour range for Monday
examples:
- 09:00-17:00
sat:
type: string
description: Operating hour range for Saturday
examples:
- 09:00-17:00
sun:
type: string
description: Operating hour range for Sunday
examples:
- 09:00-17:00
thu:
type: string
description: Operating hour range for Thursday
examples:
- 09:00-17:00
tue:
type: string
description: Operating hour range for Tuesday
examples:
- 09:00-17:00
wed:
type: string
description: Operating hour range for Wednesday
examples:
- 09:00-17:00
description: Schedule during which engagement analytics rules apply
idp_config2:
title: idp_config2
type: object
properties:
alert_only:
type: boolean
description: Whether to alert without enforcing IDP prevention actions
enabled:
type: boolean
description: Whether IDP inspection is enabled for the policy
default: false
idpprofile_id:
type: string
description: org_level IDP Profile can be used, this takes precedence over `profile`
contentEncoding: uuid
examples:
- 89b9d208-84a4-fa8f-af57-78f92c639cf2
profile:
type: string
description: 'enum: `Custom`, `strict` (default), `standard` or keys from idp_profiles'
default: strict
description: Intrusion detection and prevention settings applied by this service policy
idp_machine_cert_lookup_field1:
title: idp_machine_cert_lookup_field1
enum:
- automatic
- cn
- dns
type: string
description: 'Client certificate field used to look up machine groups in identity providers. enum: `automatic`, `cn`, `dns`.'
idp_profile_action2:
title: idp_profile_action2
enum:
- alert
- close
- drop
type: string
description: 'Enforcement action applied when this overwrite rule matches. enum: `alert`, `close`, `drop`.'
examples:
- alert
idp_profile_base_profile2:
title: idp_profile_base_profile2
enum:
- critical
- standard
- strict
type: string
description: 'Built-in IDP baseline profile inherited before applying overwrites. enum: `critical`, `standard`, `strict`.'
examples:
- strict
idp_profile_matching2:
title: idp_profile_matching2
type: object
properties:
attack_name:
type: array
items:
type: string
description: Signature names matched by the IDP profile overwrite
dst_subnet:
type: array
items:
type: string
description: Destination subnets matched by the IDP profile overwrite
severity:
type: array
items:
$ref: '#/components/schemas/idp_profile_matching_severity_value'
description: Threat levels matched by the IDP profile overwrite
description: Criteria that select signatures for this overwrite rule
idp_user_cert_lookup_field1:
title: idp_user_cert_lookup_field1
enum:
- automatic
- cn
- email
- upn
type: string
description: 'Client certificate field used to look up user groups in identity providers. enum: `automatic`, `cn`, `email`, `upn`.'
if_stat_property_servp_info2:
title: if_stat_property_servp_info2
type: object
properties:
asn:
type: string
description: Autonomous System Number associated with the service provider
city:
type: string
description: Detected city for the service provider address
country_code:
type: string
description: ISO country code for the service provider address
latitude:
type: number
description: Geographic latitude for the service provider address
longitude:
type: number
description: Geographic longitude for the service provider address
org:
type: string
description: Service provider organization name
region_code:
type: string
description: Administrative region code for the service provider address
description: Service-provider and geolocation details for this interface
installer_device_ble_stat2:
title: installer_device_ble_stat2
type: object
properties:
major:
type: integer
description: iBeacon major value reported by the device
contentEncoding: int32
examples:
- 12345
minors:
type: array
items:
type: integer
contentEncoding: int32
description: iBeacon minor values reported by the device
uuid:
type: string
description: iBeacon UUID advertised by the device
contentEncoding: uuid
examples:
- ada72f8f-1643-e5c6-94db-f2a5636f1a64
description: BLE beacon statistics reported by the device
inventory_update_operation2:
title: inventory_update_operation2
enum:
- assign
- delete
- downgrade_to_jsi
- unassign
- upgrade_to_mist
type: string
description: 'Inventory operation to apply to the listed devices. enum: `assign`, `delete`, `downgrade_to_jsi`, `unassign`, `upgrade_to_mist`.'
iotproxy_visionline2:
title: iotproxy_visionline2
type: object
properties:
access_id:
type: string
description: Access ID for the Visionline service
examples:
- 790e6c1790e6c18541d
cacerts:
type: array
items:
type: string
description: PEM-encoded CA certificates used to verify the Visionline collector's TLS certificate. Required when the collector uses a self-signed certificate
enabled:
type: boolean
description: Whether the Visionline integration is enabled
default: false
host:
type: string
description: Collector hostname or IP address for Visionline
examples:
- visionline_collector1.local
password:
type: string
description: Visionline service password used by the IoT proxy
contentEncoding: password
port:
type: integer
description: TCP port of the Visionline collector
contentEncoding: int32
default: 443
username:
type: string
description: Visionline service username used by the IoT proxy
examples:
- card_administrator
description: Site access-control integration settings for Visionline
iotproxy1:
title: iotproxy1
type: object
properties:
enabled:
type: boolean
description: Whether the site IoT proxy is enabled
default: false
visionline:
allOf:
- $ref: '#/components/schemas/iotproxy_visionline2'
- description: Site access-control integration settings for Visionline
description: Proxy settings for IoT traffic at the site
ip_stat1:
title: ip_stat1
type: object
properties:
dhcp_server:
type:
- string
- 'null'
description: Reported DHCP server IPv4 address for the interface, when available
readOnly: true
examples:
- 192.168.95.1
dns:
uniqueItems: true
type: array
items:
type: string
description: Reported DNS server addresses for the interface
dns_suffix:
uniqueItems: true
type: array
items:
type: string
description: Reported DNS search suffixes for the interface
gateway:
type:
- string
- 'null'
description: Current IPv4 default gateway for the interface, when available
readOnly: true
gateway6:
type:
- string
- 'null'
description: Current IPv6 default gateway for the interface, when available
readOnly: true
examples:
- fdad:b0bc:f29e::1
ip:
type:
- string
- 'null'
description: Current IPv4 address for the interface, when available
readOnly: true
examples:
- 10.3.3.1
ip6:
type:
- string
- 'null'
description: Current IPv6 address for the interface, when available
readOnly: true
examples:
- fdad:b0bc:f29e::3d16
ips:
type: object
additionalProperties:
type: string
nullable: true
description: Per-VLAN IP address summaries keyed by VLAN name
netmask:
type:
- string
- 'null'
description: Current IPv4 subnet mask for the interface, when available
readOnly: true
examples:
- 255.255.255.0
netmask6:
type:
- string
- 'null'
description: Current IPv6 prefix length for the interface, when available
readOnly: true
examples:
- /64
description: Read-only IP addressing status reported by the AP
ip_stat2:
title: ip_stat2
type: object
properties:
dhcp_server:
type:
- string
- 'null'
description: Reported DHCP server IPv4 address for the interface, when available
readOnly: true
examples:
- 192.168.95.1
dns:
uniqueItems: true
type: array
items:
type: string
description: Reported DNS server addresses for the interface
dns_suffix:
uniqueItems: true
type: array
items:
type: string
description: Reported DNS search suffixes for the interface
gateway:
type:
- string
- 'null'
description: Current IPv4 default gateway for the interface, when available
readOnly: true
gateway6:
type:
- string
- 'null'
description: Current IPv6 default gateway for the interface, when available
readOnly: true
examples:
- fdad:b0bc:f29e::1
ip:
type:
- string
- 'null'
description: Current IPv4 address for the interface, when available
readOnly: true
examples:
- 10.3.3.1
ip6:
type:
- string
- 'null'
description: Current IPv6 address for the interface, when available
readOnly: true
examples:
- fdad:b0bc:f29e::3d16
ips:
type: object
additionalProperties:
type: string
nullable: true
description: Per-VLAN IP address summaries keyed by VLAN name
netmask:
type:
- string
- 'null'
description: Current IPv4 subnet mask for the interface, when available
readOnly: true
examples:
- 255.255.255.0
netmask6:
type:
- string
- 'null'
description: Current IPv6 prefix length for the interface, when available
readOnly: true
examples:
- /64
description: Layer 3 address statistics for the switch
ip_stat3:
title: ip_stat3
type: object
properties:
dhcp_server:
type:
- string
- 'null'
description: Reported DHCP server IPv4 address for the interface, when available
readOnly: true
examples:
- 192.168.95.1
dns:
uniqueItems: true
type: array
items:
type: string
description: Reported DNS server addresses for the interface
dns_suffix:
uniqueItems: true
type: array
items:
type: string
description: Reported DNS search suffixes for the interface
gateway:
type:
- string
- 'null'
description: Current IPv4 default gateway for the interface, when available
readOnly: true
gateway6:
type:
- string
- 'null'
description: Current IPv6 default gateway for the interface, when available
readOnly: true
examples:
- fdad:b0bc:f29e::1
ip:
type:
- string
- 'null'
description: Current IPv4 address for the interface, when available
readOnly: true
examples:
- 10.3.3.1
ip6:
type:
- string
- 'null'
description: Current IPv6 address for the interface, when available
readOnly: true
examples:
- fdad:b0bc:f29e::3d16
ips:
type: object
additionalProperties:
type: string
nullable: true
description: Per-VLAN IP address summaries keyed by VLAN name
netmask:
type:
- string
- 'null'
description: Current IPv4 subnet mask for the interface, when available
readOnly: true
examples:
- 255.255.255.0
netmask6:
type:
- string
- 'null'
description: Current IPv6 prefix length for the interface, when available
readOnly: true
examples:
- /64
description: Layer 3 address statistics for the secondary HA node
ip_stat4:
title: ip_stat4
type: object
properties:
dhcp_server:
type:
- string
- 'null'
description: Reported DHCP server IPv4 address for the interface, when available
readOnly: true
examples:
- 192.168.95.1
dns:
uniqueItems: true
type: array
items:
type: string
description: Reported DNS server addresses for the interface
dns_suffix:
uniqueItems: true
type: array
items:
type: string
description: Reported DNS search suffixes for the interface
gateway:
type:
- string
- 'null'
description: Current IPv4 default gateway for the interface, when available
readOnly: true
gateway6:
type:
- string
- 'null'
description: Current IPv6 default gateway for the interface, when available
readOnly: true
examples:
- fdad:b0bc:f29e::1
ip:
type:
- string
- 'null'
description: Current IPv4 address for the interface, when available
readOnly: true
examples:
- 10.3.3.1
ip6:
type:
- string
- 'null'
description: Current IPv6 address for the interface, when available
readOnly: true
examples:
- fdad:b0bc:f29e::3d16
ips:
type: object
additionalProperties:
type: string
nullable: true
description: Per-VLAN IP address summaries keyed by VLAN name
netmask:
type:
- string
- 'null'
description: Current IPv4 subnet mask for the interface, when available
readOnly: true
examples:
- 255.255.255.0
netmask6:
type:
- string
- 'null'
description: Current IPv6 prefix length for the interface, when available
readOnly: true
examples:
- /64
description: Layer 3 address statistics for the gateway or primary HA node
ip_type1:
title: ip_type1
enum:
- dhcp
- static
type: string
description: 'IP assignment mode for this Junos IP configuration. enum: `dhcp`, `static`.'
examples:
- static
ip_type2:
title: ip_type2
enum:
- dhcp
- static
type: string
description: 'IP assignment mode for the out-of-band management interface. enum: `dhcp`, `static`.'
examples:
- static
ip_type3:
title: ip_type3
enum:
- dhcp
- static
type: string
description: 'IPv4 assignment mode for the additional Junos L3 presence. enum: `dhcp`, `static`.'
examples:
- static
ip_type4:
title: ip_type4
enum:
- dhcp
- static
type: string
description: 'IPv4 address assignment mode for this gateway network interface. enum: `dhcp`, `static`.'
examples:
- static
ip_type5:
title: ip_type5
enum:
- dhcp
- static
type: string
description: 'IP assignment mode for the node1 out-of-band management interface. enum: `dhcp`, `static`.'
examples:
- static
ip_type9:
title: ip_type9
enum:
- dhcp
- static
type: string
description: 'IPv4 address assignment mode for out-of-band management. enum: `dhcp`, `static`.'
examples:
- static
ip_type10:
title: ip_type10
enum:
- dhcp
- static
type: string
description: 'IPv6 address assignment mode for out-of-band management. enum: `dhcp`, `static`.'
examples:
- static
ip_type11:
title: ip_type11
enum:
- dhcp
- static
type: string
description: 'IP assignment mode for in-band switch management. enum: `dhcp`, `static`.'
examples:
- static
ip_type12:
title: ip_type12
enum:
- dhcp
- static
type: string
description: 'IP assignment mode for out-of-band switch management. enum: `dhcp`, `static`.'
examples:
- static
ip_type13:
title: ip_type13
enum:
- dhcp
- static
type: string
description: 'IPv4 address assignment mode for AP management traffic. enum: `dhcp`, `static`.'
examples:
- static
ip_type61:
title: ip_type61
enum:
- autoconf
- dhcp
- disabled
- static
type: string
description: 'IPv6 assignment mode for the additional Junos L3 presence. enum: `autoconf`, `dhcp`, `disabled`, `static`.'
examples:
- static
ip_type62:
title: ip_type62
enum:
- autoconf
- dhcp
- disabled
- static
type: string
description: 'IPv6 address assignment mode for this gateway network interface. enum: `autoconf`, `dhcp`, `disabled`, `static`.'
examples:
- static
ip_type64:
title: ip_type64
enum:
- autoconf
- dhcp
- disabled
- static
type: string
description: 'IPv6 address assignment mode for AP management traffic. enum: `autoconf`, `dhcp`, `disabled`, `static`.'
examples:
- static
juniper_srx_auto_upgrade1:
title: juniper_srx_auto_upgrade1
type: object
properties:
custom_versions:
type: object
additionalProperties:
type: string
description: Per-SRX-model firmware versions to deploy instead of the default version
enabled:
type: boolean
description: Whether SRX auto-upgrade is enabled for newly onboarded devices
default: false
snapshot:
type: boolean
description: Whether to take a snapshot during the SRX upgrade process
default: false
version:
type: string
description: Firmware version to deploy (e.g. 23.4R2-S5.5). Optional, used when custom_versions not specified
examples:
- 23.4R2-S5.5
description: SRX auto-upgrade settings applied when Juniper SRX devices are first onboarded
juniper_srx_auto_upgrade2:
title: juniper_srx_auto_upgrade2
type: object
properties:
custom_versions:
type: object
additionalProperties:
type: string
description: Per-SRX-model firmware versions to deploy instead of the default version
enabled:
type: boolean
description: Whether SRX auto-upgrade is enabled for newly onboarded devices
default: false
snapshot:
type: boolean
description: Whether to take a snapshot during the SRX upgrade process
default: false
version:
type: string
description: Firmware version to deploy (e.g. 23.4R2-S5.5). Optional, used when custom_versions not specified
examples:
- 23.4R2-S5.5
description: SRX auto-upgrade settings applied when SRX devices are onboarded
junos_ip_config1:
title: junos_ip_config1
type: object
properties:
dns:
uniqueItems: true
type: array
items:
type: string
description: Configured DNS server addresses for Junos management traffic
dns_suffix:
uniqueItems: true
type: array
items:
type: string
description: DNS search suffixes configured for Junos management traffic
gateway:
type: string
description: Default gateway IPv4 address for this Junos IP configuration
ip:
type: string
description: Configured IPv4 address for this Junos IP configuration
netmask:
type: string
description: Used only if `subnet` is not specified in `networks`
network:
type: string
description: Management network for this IP configuration; used as the default source network for outbound SSH, DNS, NTP, TACACS+, RADIUS, syslog, and SNMP
type:
allOf:
- $ref: '#/components/schemas/ip_type1'
- description: 'IP assignment mode for this Junos IP configuration. enum: `dhcp`, `static`.'
examples:
- static
description: Management IP addressing defaults in this switch profile
junos_ip_config3:
title: junos_ip_config3
type: object
properties:
dns:
uniqueItems: true
type: array
items:
type: string
description: Configured DNS server addresses for Junos management traffic
dns_suffix:
uniqueItems: true
type: array
items:
type: string
description: DNS search suffixes configured for Junos management traffic
gateway:
type: string
description: Default gateway IPv4 address for this Junos IP configuration
ip:
type: string
description: Configured IPv4 address for this Junos IP configuration
netmask:
type: string
description: Used only if `subnet` is not specified in `networks`
network:
type: string
description: Management network for this IP configuration; used as the default source network for outbound SSH, DNS, NTP, TACACS+, RADIUS, syslog, and SNMP
type:
allOf:
- $ref: '#/components/schemas/ip_type1'
- description: 'IP assignment mode for this Junos IP configuration. enum: `dhcp`, `static`.'
examples:
- static
description: Management IP addressing settings for this switch
junos_port_config_duplex2:
title: junos_port_config_duplex2
enum:
- auto
- full
- half
type: string
description: 'Link duplex mode for this Junos port. enum: `auto`, `full`, `half`.'
junos_port_config_speed1:
title: junos_port_config_speed1
enum:
- 10m
- 100m
- 1g
- 2.5g
- 5g
- 10g
- 25g
- 40g
- 100g
- auto
type: string
description: 'Link speed for this Junos port. enum: `10m`, `100m`, `1g`, `2.5g`, `5g`, `10g`, `25g`, `40g`, `100g`, `auto`.'
junos_port_config_speed3:
title: junos_port_config_speed3
enum:
- 10m
- 100m
- 1g
- 2.5g
- 5g
- 10g
- 25g
- 40g
- 100g
- auto
type: string
description: 'Link speed for this local port configuration. enum: `10m`, `100m`, `1g`, `2.5g`, `5g`, `10g`, `25g`, `40g`, `100g`, `auto`.'
l2tp_state1:
title: l2tp_state1
enum:
- established
- established_with_session
- idle
- wait-ctrl-conn
- wait-ctrl-reply
type: string
description: 'L2TP session state reported by the AP. enum: `established`, `established_with_session`, `idle`, `wait-ctrl-conn`, `wait-ctrl-reply`.'
examples:
- established
l2tp_state2:
title: l2tp_state2
enum:
- established
- established_with_session
- idle
- wait-ctrl-conn
- wait-ctrl-reply
type: string
description: 'L2TP tunnel state reported by the AP. enum: `established`, `established_with_session`, `idle`, `wait-ctrl-conn`, `wait-ctrl-reply`.'
examples:
- established
last_trouble1:
title: last_trouble1
type: object
properties:
code:
type: string
description: Trouble code; definitions are listed at [List Ap Led Definition]($e/Constants%20Definitions/listApLedDefinition)
examples:
- '03'
timestamp:
type: number
description: Time when the last trouble code was reported
readOnly: true
description: Most recent AP trouble indicator and timestamp
last_trouble2:
title: last_trouble2
type: object
properties:
code:
type: string
description: Trouble code; definitions are listed at [List Ap Led Definition]($e/Constants%20Definitions/listApLedDefinition)
examples:
- '03'
timestamp:
type: number
description: Time when the last trouble code was reported
readOnly: true
description: Most recent trouble-code summary reported for the switch
lat_lng2:
title: lat_lng2
required:
- lat
- lng
type: object
properties:
lat:
type: number
description: Geographic latitude in decimal degrees
examples:
- 37.295833
lng:
type: number
description: Geographic longitude in decimal degrees
examples:
- -122.032946
description: Latitude and longitude for the site location
lat_lng4:
title: lat_lng4
required:
- lat
- lng
type: object
properties:
lat:
type: number
description: Geographic latitude in decimal degrees
examples:
- 37.295833
lng:
type: number
description: Geographic longitude in decimal degrees
examples:
- -122.032946
description: Geographic coordinates of the installer site
latlng_br1:
title: latlng_br1
type: object
properties:
lat:
type: string
description: Bottom-right latitude for the Google map bounds
lng:
type: string
description: Bottom-right longitude for the Google map bounds
description: When `type`==`google`, bottom-right map bounds coordinate
latlng_tl1:
title: latlng_tl1
type: object
properties:
lat:
type: string
description: Top-left latitude for the Google map bounds
lng:
type: string
description: Top-left longitude for the Google map bounds
description: When `type`==`google`, top-left map bounds coordinate
mac_table_stats1:
title: mac_table_stats1
type: object
properties:
mac_table_count:
type: integer
description: Number of learned MAC table entries currently present
contentEncoding: int32
max_mac_entries_supported:
type: integer
description: Maximum number of MAC table entries supported
contentEncoding: int32
description: Layer 2 MAC table utilization statistics for the switch
map_import_json_vendor_name2:
title: map_import_json_vendor_name2
enum:
- ekahau
- ibwave
type: string
description: 'Map import vendor for the uploaded JSON. enum: `ekahau`, `ibwave`.'
examples:
- ekahau
map_import_json1:
title: map_import_json1
required:
- vendor_name
type: object
properties:
import_all_floorplans:
type: boolean
description: Whether to import all floorplans from the uploaded map JSON
default: false
import_height:
type: boolean
description: Whether to import height metadata from the uploaded map JSON
default: true
import_orientation:
type: boolean
description: Whether to import orientation metadata from the uploaded map JSON
default: true
vendor_name:
allOf:
- $ref: '#/components/schemas/map_import_json_vendor_name2'
- description: 'Map import vendor for the uploaded JSON. enum: `ekahau`, `ibwave`.'
examples:
- ekahau
description: Import options for the site map file
map_node_position2:
title: map_node_position2
required:
- x
- y
type: object
properties:
x:
type: number
description: Horizontal coordinate of the map node
examples:
- 746
y:
type: number
description: Vertical coordinate of the map node
examples:
- 104
description: Coordinates of this map node
map_org_import_file_json_vendor_name2:
title: map_org_import_file_json_vendor_name2
enum:
- ekahau
- ibwave
type: string
description: 'Map import vendor for the uploaded file. enum: `ekahau`, `ibwave`.'
examples:
- ekahau
map_org_import_file_json2:
title: map_org_import_file_json2
required:
- vendor_name
type: object
properties:
import_all_floorplans:
type: boolean
description: Whether to import all floorplans from the uploaded map file
default: false
import_height:
type: boolean
description: Whether to import height metadata from the uploaded map file
default: true
import_orientation:
type: boolean
description: Whether to import orientation metadata from the uploaded map file
default: true
site_id:
type: string
description: Target site for imported floorplans, when specified
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
vendor_name:
allOf:
- $ref: '#/components/schemas/map_org_import_file_json_vendor_name2'
- description: 'Map import vendor for the uploaded file. enum: `ekahau`, `ibwave`.'
examples:
- ekahau
description: Import options for the organization map file
map_site_replace_file_json_transform2:
title: map_site_replace_file_json_transform2
type: object
properties:
rotation:
type: number
description: Whether to rotate the replacing image, in degrees
default: 0
scale:
type: number
description: Whether to scale the replacing image
default: 1
examples:
- 0.98
x:
type: number
description: Where the (0, 0) of the new image is relative to the original map
default: 0
examples:
- 3.16
y:
type: number
description: Where the (0, 0) of the new image is relative to the original map
default: 0
examples:
- 12
description: Coordinate transform to apply when replacing the map image
map_site_replace_file_json2:
title: map_site_replace_file_json2
type: object
properties:
transform:
allOf:
- $ref: '#/components/schemas/map_site_replace_file_json_transform2'
- description: Coordinate transform to apply when replacing the map image
description: Replacement transform options for the map image
map_type2:
title: map_type2
enum:
- google
- image
type: string
description: Map type, such as `image` or `google`
examples:
- image
map_view2:
title: map_view2
enum:
- hybrid
- roadmap
- satellite
- terrain
type: string
description: 'If `type`==`google`, map tile view to display. enum: `hybrid`, `roadmap`, `satellite`, `terrain`.'
map_wall_path2:
title: map_wall_path2
type: object
properties:
coordinate:
type: string
description: Wall path coordinate space
examples:
- actual
nodes:
minItems: 0
type: array
items:
$ref: '#/components/schemas/map_node'
description: Path nodes that define the wall geometry
description: Wall path geometry for this map
map_wayfinding_micello2:
title: map_wayfinding_micello2
type: object
properties:
account_key:
type: string
description: Micello account key used for wayfinding
examples:
- adasdf
default_level_id:
type: integer
description: Default Micello floor or level identifier for wayfinding
contentEncoding: int32
examples:
- 5
map_id:
type: string
description: Micello map identifier used for wayfinding
examples:
- c660f81dd250c
description: External Micello wayfinding integration settings for this map
map_wayfinding_path2:
title: map_wayfinding_path2
type: object
properties:
coordinate:
type: string
description: Wayfinding path coordinate space
examples:
- actual
nodes:
minItems: 0
type: array
items:
$ref: '#/components/schemas/map_node'
description: Path nodes used for wayfinding routes
description: Wayfinding path geometry for this map
map_wayfinding2:
title: map_wayfinding2
type: object
properties:
micello:
allOf:
- $ref: '#/components/schemas/map_wayfinding_micello2'
- description: External Micello wayfinding integration settings for this map
snap_to_path:
type: boolean
description: Whether wayfinding should snap routes to configured paths
description: Navigation pathfinding settings for this map
marvis_auto_operations2:
title: marvis_auto_operations2
type: object
properties:
ap_insufficient_capacity:
type: boolean
description: Whether Marvis may remediate AP insufficient-capacity issues automatically
default: false
ap_loop:
type: boolean
description: Whether Marvis may remediate AP loop issues automatically
default: false
ap_non_compliant:
type: boolean
description: Whether Marvis may remediate AP non-compliance automatically
default: false
bounce_port_for_abnormal_poe_client:
type: boolean
description: Whether Marvis may bounce switch ports for abnormal PoE clients
default: false
disable_port_when_ddos_protocol_violation:
type: boolean
description: Whether Marvis may disable a port when DDOS protocol violations are detected
default: false
disable_port_when_rogue_dhcp_server_detected:
type: boolean
description: Whether Marvis may disable a port when a rogue DHCP server is detected
default: false
gateway_non_compliant:
type: boolean
description: Whether Marvis may remediate non-compliant gateways automatically
default: false
switch_misconfigured_port:
type: boolean
description: Whether Marvis may remediate misconfigured switch ports automatically
default: false
switch_port_stuck:
type: boolean
description: Whether Marvis may remediate stuck switch ports automatically
default: false
description: Automatic remediation operations controlled by Marvis
marvis_client_location2:
title: marvis_client_location2
type: object
properties:
enabled:
type: boolean
description: Whether location collection is enabled for Marvis Client
description: Client location collection settings for Marvis Client
marvis_client_telemetry2:
title: marvis_client_telemetry2
type: object
properties:
enabled:
type: boolean
description: Whether telemetry collection is enabled for Marvis Client
description: Client telemetry collection settings for Marvis Client
marvis_self_driving_domain1:
title: marvis_self_driving_domain1
type: object
properties:
enabled:
type: boolean
description: Whether self-driving automation is enabled for this domain
default: false
description: Self-driving automation settings for the wired domain
marvis_self_driving_domain2:
title: marvis_self_driving_domain2
type: object
properties:
enabled:
type: boolean
description: Whether self-driving automation is enabled for this domain
default: false
description: Self-driving automation settings for the wireless domain
marvis_self_driving_domain4:
title: marvis_self_driving_domain4
type: object
properties:
enabled:
type: boolean
description: Whether self-driving automation is enabled for this domain
default: false
description: Self-driving automation settings for the WAN domain
marvis_self_driving1:
title: marvis_self_driving1
type: object
properties:
wan:
allOf:
- $ref: '#/components/schemas/marvis_self_driving_domain4'
- description: Self-driving automation settings for the WAN domain
wired:
allOf:
- $ref: '#/components/schemas/marvis_self_driving_domain1'
- description: Self-driving automation settings for the wired domain
wireless:
allOf:
- $ref: '#/components/schemas/marvis_self_driving_domain2'
- description: Self-driving automation settings for the wireless domain
description: Self-driving network automation settings by domain
marvis1:
title: marvis1
type: object
properties:
auto_operations:
allOf:
- $ref: '#/components/schemas/marvis_auto_operations2'
- description: Automatic remediation operations controlled by Marvis
description: AI assistant settings for Marvis at the site
memory_stat1:
title: memory_stat1
required:
- usage
type: object
properties:
usage:
type: number
description: Current memory utilization percentage for the device or master Routing Engine
description: Utilization statistics for switch module memory
memory_stat2:
title: memory_stat2
required:
- usage
type: object
properties:
usage:
type: number
description: Current memory utilization percentage for the device or master Routing Engine
description: Utilization statistics for switch memory
memory_stat3:
title: memory_stat3
required:
- usage
type: object
properties:
usage:
type: number
description: Current memory utilization percentage for the device or master Routing Engine
description: Secondary-node memory utilization statistics for the gateway
memory_stat4:
title: memory_stat4
required:
- usage
type: object
properties:
usage:
type: number
description: Current memory utilization percentage for the device or master Routing Engine
description: Utilization statistics for gateway memory
memory_stat5:
title: memory_stat5
required:
- usage
type: object
properties:
usage:
type: number
description: Current memory utilization percentage for the device or master Routing Engine
description: Utilization statistics for gateway module memory
mist_nacedge1:
title: mist_nacedge1
type: object
properties:
auth_ttl:
maximum: 2592000
minimum: 60
type: integer
description: Cache of last auth result; in seconds
contentEncoding: int32
default: 604800
caching_site_ids:
type: array
items:
type: string
contentEncoding: uuid
description: List of site UUIDs whose auth requests should be cached by NAC Edges assigned to this site
examples:
- - 4ac1dcf4-9d8b-7910-ac87-6ad873648a5c
- 7dc1acf4-9d8b-7910-ac87-6ad873648a5c
default_dot1x_vlan:
type: string
description: Default vlan for all dot1x devices, if different from default_vlan
examples:
- '20'
default_vlan:
type: string
description: Default vlan to assign for devices not in the cache
examples:
- test_vlan
enabled:
type: boolean
description: Whether Mist Site Survivability is enabled for the site
mxedge_hosts:
type: array
items:
type: string
description: NAC Edge hostnames used for the Site Survivability feature
examples:
- - mxedge1.local
description: NAC Edge service settings for the site Mist Edge cluster
module_stat_item_poe1:
title: module_stat_item_poe1
type: object
properties:
max_power:
type: number
description: Total PoE power budget available to the module, in watts
examples:
- 250
power_draw:
type: number
description: Current PoE power draw on the module, in watts
examples:
- 120.3
status:
type: string
description: Operational status of PoE on the module
description: Power over Ethernet telemetry for the switch module
module_stat_item_poe2:
title: module_stat_item_poe2
type: object
properties:
max_power:
type: number
description: Total PoE power budget available to the module, in watts
examples:
- 250
power_draw:
type: number
description: Current PoE power draw on the module, in watts
examples:
- 120.3
status:
type: string
description: Operational status of PoE on the module
description: Power over Ethernet telemetry for the gateway module
msp_license_action_operation2:
title: msp_license_action_operation2
enum:
- amend
- annotate
- delete
- unamend
type: string
description: 'License operation to perform for this MSP request. enum: `amend`, `annotate`, `delete`, `unamend`.'
msp_org_change_operation2:
title: msp_org_change_operation2
enum:
- assign
- unassign
type: string
description: 'Assignment operation to apply to the listed org IDs. enum: `assign`, `unassign`.'
msp_tier2:
title: msp_tier2
enum:
- advanced
- base
type: string
description: 'Service tier for the MSP account. enum: `advanced`, `base`.'
mxcluster_nac_client_vendor2:
title: mxcluster_nac_client_vendor2
enum:
- aruba
- cisco-aironet
- cisco-dnac
- cisco-ios
- cisco-meraki
- brocade
- generic
- juniper
- paloalto
type: string
description: 'RADIUS client vendor profile for this IP or subnet. enum: `aruba`, `cisco-aironet`, `cisco-dnac`, `cisco-ios`, `cisco-meraki`, `brocade`, `generic`, `juniper`, `paloalto`.'
examples:
- cisco-ios
mxcluster_nac2:
title: mxcluster_nac2
type: object
properties:
acct_server_port:
type: integer
description: RADIUS accounting port used by Mist NAC on the cluster
contentEncoding: int32
default: 1813
auth_server_port:
type: integer
description: RADIUS authentication port used by Mist NAC on the cluster
contentEncoding: int32
default: 1812
client_ips:
type: object
additionalProperties:
$ref: '#/components/schemas/mxcluster_nac_client_ip'
description: Property key is the RADIUS Client IP/Subnet.
enabled:
type: boolean
description: Whether Mist NAC is enabled on the cluster
default: false
secret:
type: string
description: Shared RADIUS secret used by Mist NAC clients
examples:
- testing123
description: RADIUS settings for Mist NAC on the site Mist Edge cluster
mxcluster_nac3:
title: mxcluster_nac3
type: object
properties:
acct_server_port:
type: integer
description: RADIUS accounting port used by Mist NAC on the cluster
contentEncoding: int32
default: 1813
auth_server_port:
type: integer
description: RADIUS authentication port used by Mist NAC on the cluster
contentEncoding: int32
default: 1812
client_ips:
type: object
additionalProperties:
$ref: '#/components/schemas/mxcluster_nac_client_ip'
description: Property key is the RADIUS Client IP/Subnet.
enabled:
type: boolean
description: Whether Mist NAC is enabled on the cluster
default: false
secret:
type: string
description: Shared RADIUS secret used by Mist NAC clients
examples:
- testing123
description: NAC settings for the Mist Edge cluster
mxcluster_nacedge2:
title: mxcluster_nacedge2
type: object
properties:
auth_ttl:
maximum: 2592000
minimum: 60
type: integer
description: Cache TTL for last auth result in seconds
contentEncoding: int32
default: 604800
caching_site_ids:
type: array
items:
type: string
contentEncoding: uuid
description: List of site UUIDs whose auth requests should be cached by NAC Edges in this cluster
examples:
- - 4ac1dcf4-9d8b-7910-ac87-6ad873648a5c
- 7dc1acf4-9d8b-7910-ac87-6ad873648a5c
default_dot1x_vlan:
type: string
description: Default VLAN for all dot1x devices, if different from default_vlan
examples:
- '20'
default_vlan:
type: string
description: Default VLAN to assign for devices not in the cache
examples:
- testVlan
enabled:
type: boolean
description: Whether NAC Edge survivability is enabled for this cluster
default: false
nac_edge_hosts:
type: array
items:
type: string
description: NAC Edge hostnames used by APs for survivability authentication
examples:
- - nac-west-1.corp.com
- nac-west-2.corp.com
description: NAC Edge survivability settings for the cluster; requires `mist_nac` to be enabled
mxcluster_rad_auth_server_keywrap_format2:
title: mxcluster_rad_auth_server_keywrap_format2
enum:
- ascii
- hex
type: string
description: 'Encoding format for Mist AP RADIUS keywrap keys. enum: `ascii`, `hex`.'
mxcluster_radsec_nas_ip_source2:
title: mxcluster_radsec_nas_ip_source2
enum:
- any
- oob
- oob6
- tunnel
- tunnel6
type: string
description: 'Source used to populate NAS-IP-Address and NAS-IPv6-Address attributes. enum: `any`, `oob`, `oob6`, `tunnel`, `tunnel6`.'
mxcluster_radsec_server_selection2:
title: mxcluster_radsec_server_selection2
enum:
- ordered
- unordered
type: string
description: 'RADIUS server selection strategy for RadSec failover. enum: `ordered`, `unordered`.'
mxcluster_radsec_src_ip_source2:
title: mxcluster_radsec_src_ip_source2
enum:
- any
- oob
- oob6
- tunnel
- tunnel6
type: string
description: 'Connection source interface or address used when reaching RADIUS servers. enum: `any`, `oob`, `oob6`, `tunnel`, `tunnel6`.'
mxcluster_radsec_tls2:
title: mxcluster_radsec_tls2
type: object
properties:
keypair:
type: string
description: Name or identifier of the TLS keypair used by RadSec
description: TLS keypair settings for RadSec on the Mist Edge cluster
mxcluster_radsec2:
title: mxcluster_radsec2
type: object
properties:
acct_servers:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/mxcluster_radsec_acct_server'
description: RADIUS accounting servers used by the RadSec proxy
auth_servers:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/mxcluster_radsec_auth_server'
description: RADIUS authentication servers used by the RadSec proxy
enabled:
type: boolean
description: Whether to enable service on Mist Edge i.e. RADIUS proxy over TLS
match_ssid:
type: boolean
description: Whether to match ssid in request message to select from a subset of RADIUS servers
nas_ip_source:
allOf:
- $ref: '#/components/schemas/mxcluster_radsec_nas_ip_source2'
- description: 'Source used to populate NAS-IP-Address and NAS-IPv6-Address attributes. enum: `any`, `oob`, `oob6`, `tunnel`, `tunnel6`.'
proxy_hosts:
type: array
items:
type: string
description: AP-reachable hostnames or IP addresses advertised as RadSec TLS servers
server_selection:
allOf:
- $ref: '#/components/schemas/mxcluster_radsec_server_selection2'
- description: 'RADIUS server selection strategy for RadSec failover. enum: `ordered`, `unordered`.'
src_ip_source:
allOf:
- $ref: '#/components/schemas/mxcluster_radsec_src_ip_source2'
- description: 'Connection source interface or address used when reaching RADIUS servers. enum: `any`, `oob`, `oob6`, `tunnel`, `tunnel6`.'
description: TLS-secured RADIUS proxy settings for the site Mist Edge cluster
mxcluster_radsec3:
title: mxcluster_radsec3
type: object
properties:
acct_servers:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/mxcluster_radsec_acct_server'
description: RADIUS accounting servers used by the RadSec proxy
auth_servers:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/mxcluster_radsec_auth_server'
description: RADIUS authentication servers used by the RadSec proxy
enabled:
type: boolean
description: Whether to enable service on Mist Edge i.e. RADIUS proxy over TLS
match_ssid:
type: boolean
description: Whether to match ssid in request message to select from a subset of RADIUS servers
nas_ip_source:
allOf:
- $ref: '#/components/schemas/mxcluster_radsec_nas_ip_source2'
- description: 'Source used to populate NAS-IP-Address and NAS-IPv6-Address attributes. enum: `any`, `oob`, `oob6`, `tunnel`, `tunnel6`.'
proxy_hosts:
type: array
items:
type: string
description: AP-reachable hostnames or IP addresses advertised as RadSec TLS servers
server_selection:
allOf:
- $ref: '#/components/schemas/mxcluster_radsec_server_selection2'
- description: 'RADIUS server selection strategy for RadSec failover. enum: `ordered`, `unordered`.'
src_ip_source:
allOf:
- $ref: '#/components/schemas/mxcluster_radsec_src_ip_source2'
- description: 'Connection source interface or address used when reaching RADIUS servers. enum: `any`, `oob`, `oob6`, `tunnel`, `tunnel6`.'
description: TLS RADIUS proxy settings for the Mist Edge cluster
mxcluster_tunterm_hosts_selection2:
title: mxcluster_tunterm_hosts_selection2
enum:
- ordered
- shuffle
- shuffle-by-site
type: string
description: 'Selection strategy for ordering tunnel termination hosts. enum: `ordered`, `shuffle`, `shuffle-by-site`.'
mxedge_das2:
title: mxedge_das2
type: object
properties:
coa_servers:
type: array
items:
$ref: '#/components/schemas/mxedge_das_coa_server'
description: Dynamic authorization clients allowed to send CoA or Disconnect-Message requests
enabled:
type: boolean
description: Whether cloud-assisted DAS is enabled for the Mist Edge cluster
default: false
description: DAS service settings for the site Mist Edge cluster
mxedge_das3:
title: mxedge_das3
type: object
properties:
coa_servers:
type: array
items:
$ref: '#/components/schemas/mxedge_das_coa_server'
description: Dynamic authorization clients allowed to send CoA or Disconnect-Message requests
enabled:
type: boolean
description: Whether cloud-assisted DAS is enabled for the Mist Edge cluster
default: false
description: Dynamic authorization service settings for the cluster
mxedge_event_sys_info2:
title: mxedge_event_sys_info2
type: object
properties:
resource:
type: string
description: System resource referenced by the event
severity:
allOf:
- $ref: '#/components/schemas/event_severity2'
- description: 'Event severity for the system resource condition. enum: `normal`, `critical`, `high`, `warning`.'
description: System resource usage details associated with the event
mxedge_mgmt_oob_ip_type2:
title: mxedge_mgmt_oob_ip_type2
enum:
- dhcp
- disabled
- static
type: string
description: 'IPv4 address assignment mode for out-of-band management. enum: `dhcp`, `disabled`, `static`.'
mxedge_mgmt_oob_ip_type62:
title: mxedge_mgmt_oob_ip_type62
enum:
- autoconf
- dhcp
- disabled
- static
type: string
description: 'IPv6 address assignment mode for out-of-band management. enum: `autoconf`, `dhcp`, `disabled`, `static`.'
mxedge_mgmt1:
title: mxedge_mgmt1
type: object
properties:
config_auto_revert:
type: boolean
description: Whether the Mist Edge automatically reverts configuration changes if connectivity is lost
default: false
fips_enabled:
type: boolean
description: Whether FIPS mode is enabled on the Mist Edge
default: false
mist_password:
type: string
description: Password for the Mist service account on the Mist Edge
examples:
- MIST_PASSWORD
oob_ip_type:
allOf:
- $ref: '#/components/schemas/mxedge_mgmt_oob_ip_type2'
- description: 'IPv4 address assignment mode for out-of-band management. enum: `dhcp`, `disabled`, `static`.'
oob_ip_type6:
allOf:
- $ref: '#/components/schemas/mxedge_mgmt_oob_ip_type62'
- description: 'IPv6 address assignment mode for out-of-band management. enum: `autoconf`, `dhcp`, `disabled`, `static`.'
root_password:
type: string
description: Root account password for the Mist Edge
contentEncoding: password
examples:
- ROOT_PASSWORD
description: Management credentials and settings for the Mist Edge
mxedge_mgmt3:
title: mxedge_mgmt3
type: object
properties:
config_auto_revert:
type: boolean
description: Whether the Mist Edge automatically reverts configuration changes if connectivity is lost
default: false
fips_enabled:
type: boolean
description: Whether FIPS mode is enabled on the Mist Edge
default: false
mist_password:
type: string
description: Password for the Mist service account on the Mist Edge
examples:
- MIST_PASSWORD
oob_ip_type:
allOf:
- $ref: '#/components/schemas/mxedge_mgmt_oob_ip_type2'
- description: 'IPv4 address assignment mode for out-of-band management. enum: `dhcp`, `disabled`, `static`.'
oob_ip_type6:
allOf:
- $ref: '#/components/schemas/mxedge_mgmt_oob_ip_type62'
- description: 'IPv6 address assignment mode for out-of-band management. enum: `autoconf`, `dhcp`, `disabled`, `static`.'
root_password:
type: string
description: Root account password for the Mist Edge
contentEncoding: password
examples:
- ROOT_PASSWORD
description: Management settings for Mist Edge devices
mxedge_mgmt4:
title: mxedge_mgmt4
type: object
properties:
config_auto_revert:
type: boolean
description: Whether the Mist Edge automatically reverts configuration changes if connectivity is lost
default: false
fips_enabled:
type: boolean
description: Whether FIPS mode is enabled on the Mist Edge
default: false
mist_password:
type: string
description: Password for the Mist service account on the Mist Edge
examples:
- MIST_PASSWORD
oob_ip_type:
allOf:
- $ref: '#/components/schemas/mxedge_mgmt_oob_ip_type2'
- description: 'IPv4 address assignment mode for out-of-band management. enum: `dhcp`, `disabled`, `static`.'
oob_ip_type6:
allOf:
- $ref: '#/components/schemas/mxedge_mgmt_oob_ip_type62'
- description: 'IPv6 address assignment mode for out-of-band management. enum: `autoconf`, `dhcp`, `disabled`, `static`.'
root_password:
type: string
description: Root account password for the Mist Edge
contentEncoding: password
examples:
- ROOT_PASSWORD
description: Mist Edge management access settings for the site
mxedge_mgmt5:
title: mxedge_mgmt5
type: object
properties:
config_auto_revert:
type: boolean
description: Whether the Mist Edge automatically reverts configuration changes if connectivity is lost
default: false
fips_enabled:
type: boolean
description: Whether FIPS mode is enabled on the Mist Edge
default: false
mist_password:
type: string
description: Password for the Mist service account on the Mist Edge
examples:
- MIST_PASSWORD
oob_ip_type:
allOf:
- $ref: '#/components/schemas/mxedge_mgmt_oob_ip_type2'
- description: 'IPv4 address assignment mode for out-of-band management. enum: `dhcp`, `disabled`, `static`.'
oob_ip_type6:
allOf:
- $ref: '#/components/schemas/mxedge_mgmt_oob_ip_type62'
- description: 'IPv6 address assignment mode for out-of-band management. enum: `autoconf`, `dhcp`, `disabled`, `static`.'
root_password:
type: string
description: Root account password for the Mist Edge
contentEncoding: password
examples:
- ROOT_PASSWORD
description: Out-of-band management settings for Mist Edges in the cluster
mxedge_oob_ip_config2:
title: mxedge_oob_ip_config2
type: object
properties:
autoconf6:
type: boolean
description: Whether IPv6 autoconfiguration is enabled on the out-of-band management interface
default: true
dhcp6:
type: boolean
description: Whether DHCPv6 is enabled on the out-of-band management interface
default: true
dns:
type: array
items:
type: string
description: Name server addresses for out-of-band management
default:
- 8.8.8.8
- 8.8.4.4
- 2001:4860:4860::8888
- 2001:4860:4860::8844
examples:
- - 8.8.8.8
- 4.4.4.4
- 2001:4860:4860::8888
- 2001:4860:4860::8844
gateway:
type: string
description: If `type`=`static`, IPv4 default gateway for the out-of-band management interface
examples:
- 10.2.1.254
gateway6:
type: string
description: If `type6`=`static`, IPv6 default gateway for the out-of-band management interface
examples:
- 2601:1700:43c0:dc0::1
ip:
type: string
description: If `type`=`static`, IPv4 address for the out-of-band management interface
examples:
- 10.2.1.2
ip6:
type: string
description: If `type6`=`static`, IPv6 address for the out-of-band management interface
examples:
- 2601:1700:43c0:dc0:20c:29ff:fea7:93bc
netmask:
type: string
description: If `type`=`static`, IPv4 netmask for the out-of-band management interface
examples:
- 255.255.255.0
netmask6:
type: string
description: If `type6`=`static`, IPv6 prefix length for the out-of-band management interface
examples:
- /64
type:
allOf:
- $ref: '#/components/schemas/ip_type9'
- description: 'IPv4 address assignment mode for out-of-band management. enum: `dhcp`, `static`.'
examples:
- static
type6:
allOf:
- $ref: '#/components/schemas/ip_type10'
- description: 'IPv6 address assignment mode for out-of-band management. enum: `dhcp`, `static`.'
examples:
- static
description: Configured out-of-band management IP settings for the Mist Edge
mxedge_oob_ip_config3:
title: mxedge_oob_ip_config3
type: object
properties:
autoconf6:
type: boolean
description: Whether IPv6 autoconfiguration is enabled on the out-of-band management interface
default: true
dhcp6:
type: boolean
description: Whether DHCPv6 is enabled on the out-of-band management interface
default: true
dns:
type: array
items:
type: string
description: Name server addresses for out-of-band management
default:
- 8.8.8.8
- 8.8.4.4
- 2001:4860:4860::8888
- 2001:4860:4860::8844
examples:
- - 8.8.8.8
- 4.4.4.4
- 2001:4860:4860::8888
- 2001:4860:4860::8844
gateway:
type: string
description: If `type`=`static`, IPv4 default gateway for the out-of-band management interface
examples:
- 10.2.1.254
gateway6:
type: string
description: If `type6`=`static`, IPv6 default gateway for the out-of-band management interface
examples:
- 2601:1700:43c0:dc0::1
ip:
type: string
description: If `type`=`static`, IPv4 address for the out-of-band management interface
examples:
- 10.2.1.2
ip6:
type: string
description: If `type6`=`static`, IPv6 address for the out-of-band management interface
examples:
- 2601:1700:43c0:dc0:20c:29ff:fea7:93bc
netmask:
type: string
description: If `type`=`static`, IPv4 netmask for the out-of-band management interface
examples:
- 255.255.255.0
netmask6:
type: string
description: If `type6`=`static`, IPv6 prefix length for the out-of-band management interface
examples:
- /64
type:
allOf:
- $ref: '#/components/schemas/ip_type9'
- description: 'IPv4 address assignment mode for out-of-band management. enum: `dhcp`, `static`.'
examples:
- static
type6:
allOf:
- $ref: '#/components/schemas/ip_type10'
- description: 'IPv6 address assignment mode for out-of-band management. enum: `dhcp`, `static`.'
examples:
- static
description: Out-of-band management IP configuration for the Mist Edge
mxedge_tunterm_dhcpd_config_type2:
title: mxedge_tunterm_dhcpd_config_type2
const: relay
type: string
description: 'DHCP handling mode for this tunneled VLAN. enum: `relay`.'
mxedge_tunterm_dhcpd_config2:
title: mxedge_tunterm_dhcpd_config2
type: object
properties:
enabled:
type: boolean
description: Whether DHCP relay is enabled for Mist Tunneled VLANs
default: false
servers:
type: array
items:
type: string
description: DHCP relay server addresses used when `type`==`relay`
type:
allOf:
- $ref: '#/components/schemas/mxedge_tunterm_dhcpd_type2'
- description: 'DHCP handling mode for the global tunnel termination config. enum: `relay`.'
additionalProperties:
allOf:
- $ref: '#/components/schemas/mxedge_tunterm_dhcpd_config_property'
- description: Per-VLAN DHCP relay settings for a Mist Tunneled VLAN
description: DHCP relay or server settings for Mist Tunneled VLANs
mxedge_tunterm_dhcpd_type2:
title: mxedge_tunterm_dhcpd_type2
const: relay
type: string
description: 'DHCP handling mode for the global tunnel termination config. enum: `relay`.'
mxedge_tunterm_igmp_snooping_config2:
title: mxedge_tunterm_igmp_snooping_config2
type: object
properties:
enabled:
oneOf:
- type: boolean
default: false
- type: string
default: 'False'
description: Whether IGMP snooping is enabled for the configured VLANs
querier:
allOf:
- $ref: '#/components/schemas/mxedge_tunterm_igmp_snooping_querier2'
- description: IGMP querier settings used with tunnel termination snooping
vlan_ids:
anyOf:
- type: array
items:
maximum: 4096
minimum: 0
type: integer
contentEncoding: int32
- type: string
description: List of VLAN IDs where tunnel termination performs IGMP snooping
description: IGMP snooping settings for Mist Tunneled VLANs
mxedge_tunterm_igmp_snooping_querier2:
title: mxedge_tunterm_igmp_snooping_querier2
type: object
properties:
max_response_time:
type: integer
description: Querier's query response interval, in tenths-of-seconds
contentEncoding: int32
examples:
- 10
mtu:
type: integer
description: The MTU we use (needed when forming large IGMPv3 Reports)
contentEncoding: int32
examples:
- 1500
query_interval:
type: integer
description: Querier's query interval, in seconds
contentEncoding: int32
examples:
- 125
robustness:
maximum: 7
minimum: 1
type: integer
description: IGMP querier robustness variable
contentEncoding: int32
version:
type: integer
description: Querier's maximum protocol version
contentEncoding: int32
examples:
- 3
description: IGMP querier settings used with tunnel termination snooping
mxedge_tunterm_ip_config2:
title: mxedge_tunterm_ip_config2
required:
- gateway
- ip
- netmask
type: object
properties:
gateway:
type: string
description: IPv4 gateway for the Mist Tunnel interface
examples:
- 10.2.1.254
gateway6:
type: string
description: IPv6 gateway for the Mist Tunnel interface
examples:
- 2001:1010:1010:1010::1
ip:
type: string
description: Address on the untagged Mist Tunnel interface, in IPv4 format
examples:
- 10.2.1.1
ip6:
type: string
description: Address on the Mist Tunnel interface, in IPv6 format
examples:
- 2001:1010:1010:1010::2
netmask:
type: string
description: Subnet mask for the Mist Tunnel IPv4 address
examples:
- 255.255.255.0
netmask6:
type: string
description: Prefix length for the Mist Tunnel IPv6 address
examples:
- /64
description: Tunnel termination IP configuration for the Mist Edge
mxedge_tunterm_multicast_mdns2:
title: mxedge_tunterm_multicast_mdns2
type: object
properties:
enabled:
type: boolean
description: Whether mDNS forwarding is enabled for the configured VLANs
vlan_ids:
uniqueItems: true
type: array
items:
type: string
description: List of VLAN IDs where mDNS forwarding is enabled
description: Settings for mDNS forwarding on tunnel termination VLANs
mxedge_tunterm_multicast_ssdp2:
title: mxedge_tunterm_multicast_ssdp2
type: object
properties:
enabled:
type: boolean
description: Whether SSDP forwarding is enabled for the configured VLANs
vlan_ids:
uniqueItems: true
type: array
items:
type: string
description: List of VLAN IDs where SSDP forwarding is enabled
description: Settings for SSDP forwarding on tunnel termination VLANs
mxedge_tunterm_switch_configs2:
title: mxedge_tunterm_switch_configs2
type: object
properties:
enabled:
type: boolean
description: Whether custom tunnel termination switch VLAN settings are enabled
additionalProperties:
allOf:
- $ref: '#/components/schemas/mxedge_tunterm_switch_config'
- description: Switch VLAN settings for one tunnel termination port
description: Switch VLAN settings for tunnel termination
mxedge_upgrade_channel1:
title: mxedge_upgrade_channel1
enum:
- alpha
- beta
- stable
type: string
description: 'Upgrade channel to use for qualified versions. enum: `alpha`, `beta`, `stable`.'
mxedge_upgrade_multi_allow_downgrades2:
title: mxedge_upgrade_multi_allow_downgrades2
type: object
properties:
mxagent:
type: boolean
description: Whether downgrades are allowed for the mxagent service
default: false
mxdas:
type: boolean
description: Whether downgrades are allowed for the mxdas service
default: false
mxocproxy:
type: boolean
description: Whether downgrades are allowed for the mxocproxy service
default: false
radsecproxy:
type: boolean
description: Whether downgrades are allowed for the radsecproxy service
default: false
tunterm:
type: boolean
description: Whether downgrades are allowed for the tunterm service
default: false
description: Per-service downgrade permission settings for this upgrade
mxedge_upgrade_response_counts1:
title: mxedge_upgrade_response_counts1
required:
- failed
- queued
- success
- upgrading
type: object
properties:
failed:
type: integer
description: Number of Mist Edge upgrades that failed
contentEncoding: int32
queued:
type: integer
description: Number of Mist Edge upgrades waiting to run
contentEncoding: int32
success:
type: integer
description: Number of Mist Edge upgrades completed successfully
contentEncoding: int32
upgrading:
type: integer
description: Number of Mist Edge upgrades currently in progress
contentEncoding: int32
description: Per-status counts of Mist Edge targets in this upgrade
mxedge_upgrade_strategy2:
title: mxedge_upgrade_strategy2
enum:
- canary
- big_bang
- serial
type: string
description: 'Upgrade rollout strategy for the selected Mist Edges. enum: `canary`, `big_bang`, `serial`.'
mxedge_upgrade_version2:
title: mxedge_upgrade_version2
required:
- mxagent
- tunterm
type: object
properties:
mxagent:
type: string
description: Target version for the mxagent service
mxdas:
type: string
description: Target version for the mxdas service
default: current
mxocproxy:
type: string
description: Target version for the mxocproxy service
default: current
radsecproxy:
type: string
description: Target version for the radsecproxy service
default: current
tunterm:
type: string
description: Target version for the tunterm service
description: Per-service target versions for the upgrade request
mxedge_versions2:
title: mxedge_versions2
type: object
properties:
mxagent:
type: string
description: Reported version of the mxagent service
readOnly: true
tunterm:
type: string
description: Reported version of the tunnel termination service
readOnly: true
description: Service version information reported by the Mist Edge
mxtunnel_ipsec2:
title: mxtunnel_ipsec2
type: object
properties:
dns_servers:
type:
- array
- 'null'
items:
type: string
description: Name server addresses advertised for IPsec tunnel clients
dns_suffix:
uniqueItems: true
type: array
items:
type: string
description: Search suffixes advertised for IPsec tunnel clients
enabled:
type: boolean
description: Whether IPsec support is enabled for this Mist Tunnel
extra_routes:
type: array
items:
$ref: '#/components/schemas/mxtunnel_ipsec_extra_route'
description: Additional routes advertised for the IPsec tunnel
split_tunnel:
type: boolean
description: Whether split tunneling is enabled for IPsec clients
use_mxedge:
type: boolean
description: Whether IPsec termination uses Mist Edge
description: Security settings for IPsec support on this Mist Tunnel
mxtunnel_protocol2:
title: mxtunnel_protocol2
enum:
- ip
- udp
type: string
description: 'Encapsulation protocol used for the site Mist Tunnel. enum: `ip`, `udp`.'
mxtunnel_protocol3:
title: mxtunnel_protocol3
enum:
- ip
- udp
type: string
description: 'Encapsulation protocol used for the Mist Tunnel. enum: `ip`, `udp`.'
nac_access_type2:
title: nac_access_type2
enum:
- wireless
- wired
- vty
type: string
description: 'Access type for the NAC client event. enum: `wireless`, `wired`, `vty`.'
examples:
- wireless
nac_access_type3:
title: nac_access_type3
enum:
- wireless
- wired
- vty
type: string
description: 'Access type of the port where the NAC event occurred. enum: `wireless`, `wired`, `vty`.'
examples:
- wireless
nac_access_type4:
title: nac_access_type4
enum:
- wireless
- wired
- vty
type: string
description: 'Network access type for the NAC client. enum: `wireless`, `wired`, `vty`.'
examples:
- wireless
nac_auth_type2:
title: nac_auth_type2
enum:
- cert
- device-auth
- eap-teap
- eap-tls
- eap-ttls
- idp
- mab
- eap-peap
type: string
description: 'Authentication method used for the NAC event. enum: `cert`, `device-auth`, `eap-teap`, `eap-tls`, `eap-ttls`, `idp`, `mab`, `eap-peap`.'
examples:
- eap-tls
nac_auth_type3:
title: nac_auth_type3
enum:
- cert
- device-auth
- eap-teap
- eap-tls
- eap-ttls
- idp
- mab
- eap-peap
type: string
description: 'NAC authentication method that must match the request. enum: `cert`, `device-auth`, `eap-teap`, `eap-tls`, `eap-ttls`, `idp`, `mab`, `eap-peap`.'
examples:
- eap-tls
nac_auth_type4:
title: nac_auth_type4
enum:
- cert
- device-auth
- eap-teap
- eap-tls
- eap-ttls
- idp
- mab
- eap-peap
type: string
description: 'Authentication method used for the NAC accounting session. enum: `cert`, `device-auth`, `eap-teap`, `eap-tls`, `eap-ttls`, `idp`, `mab`, `eap-peap`.'
examples:
- eap-tls
nac_auth_type5:
title: nac_auth_type5
enum:
- cert
- device-auth
- eap-teap
- eap-tls
- eap-ttls
- idp
- mab
- eap-peap
type: string
description: 'Authentication method used by the NAC client. enum: `cert`, `device-auth`, `eap-teap`, `eap-tls`, `eap-ttls`, `idp`, `mab`, `eap-peap`.'
examples:
- eap-tls
nac_client_last_status2:
title: nac_client_last_status2
enum:
- permitted
- session_started
- session_stopped
- denied
type: string
description: 'Most recent NAC authentication status for the client. enum: `permitted`, `session_started`, `session_stopped`, `denied`.'
examples:
- permitted
nac_coa_type2:
title: nac_coa_type2
enum:
- reauth
- disconnect
type: string
description: 'Change of Authorization action sent for MDM posture changes. enum: `reauth`, `disconnect`.'
nac_coa_type3:
title: nac_coa_type3
enum:
- reauth
- disconnect
type: string
description: 'Change of Authorization command to send to the NAC client. enum: `reauth`, `disconnect`.'
nac_portal_access_type2:
title: nac_portal_access_type2
enum:
- wireless
- wireless+wired
type: string
description: 'If `type`==`marvis_client`, whether onboarding applies to wireless clients or both wireless and wired clients. enum: `wireless`, `wireless+wired`.'
nac_portal_eap_type2:
title: nac_portal_eap_type2
enum:
- wpa2
- wpa3
type: string
description: 'EAP mode used when onboarding wireless clients through the NAC portal. enum: `wpa2`, `wpa3`.'
nac_portal_guest_portal_auth2:
title: nac_portal_guest_portal_auth2
enum:
- external
- multi
- none
type: string
description: 'Mode presented by the NAC guest portal for user authentication. enum: `external`, `multi`, `none`.'
nac_portal_guest_portal2:
title: nac_portal_guest_portal2
type: object
properties:
auth:
allOf:
- $ref: '#/components/schemas/nac_portal_guest_portal_auth2'
- description: 'Mode presented by the NAC guest portal for user authentication. enum: `external`, `multi`, `none`.'
expire:
type: integer
description: If `auth`==`none` or `auth`==`multi`, whether to expire the guest after a certain time
contentEncoding: int32
examples:
- 1440
external_portal_url:
type: string
description: If `auth`==`external`, the URL to redirect the user to for authentication
examples:
- https://yourorg.com/external-guest-portal
force_reconnect:
type: boolean
description: Disconnect client (workaround for reauth issues)
forward:
type: boolean
description: If `auth`==`none` or `auth`==`multi`, whether to forward the user to the guest portal after authentication
examples:
- true
forward_url:
type: string
description: If `auth`==`none` or `auth`==`multi`, URL to forward the user to after authentication
examples:
- https://yourorg.com/guest-portal-redirect
max_num_devices:
maximum: 100
minimum: 0
type: integer
description: Maximum number of clients allowed per guest. 0 (default, unlimited), 1-100 range
contentEncoding: int32
default: 0
examples:
- 10
privacy:
type: boolean
description: If `auth`==`none` or `auth`==`multi`, whether to show the privacy policy
examples:
- true
description: Guest portal settings used when `type`==`guest_portal`
nac_portal_sso_idp_sign_algo2:
title: nac_portal_sso_idp_sign_algo2
enum:
- sha1
- sha256
- sha384
- sha512
type: string
description: 'Signing algorithm expected for SAML assertions from the identity provider. enum: `sha1`, `sha256`, `sha384`, `sha512`.'
nac_portal_sso2:
title: nac_portal_sso2
type: object
properties:
idp_cert:
type: string
description: Identity provider certificate used to verify signed SAML responses
examples:
- '-----BEGIN CERTIFICATE-----\n\n-----END CERTIFICATE-----'
idp_sign_algo:
allOf:
- $ref: '#/components/schemas/nac_portal_sso_idp_sign_algo2'
- description: 'Signing algorithm expected for SAML assertions from the identity provider. enum: `sha1`, `sha256`, `sha384`, `sha512`.'
idp_sso_url:
type: string
description: Identity provider Single Sign-On URL for SAML authentication
examples:
- https://yourorg.onelogin.com/trust/saml2/http-post/sso/138130
issuer:
type: string
description: Identity provider issuer URL for SAML authentication
examples:
- https://app.onelogin.com/saml/metadata/138130
nameid_format:
type: string
description: SAML NameID format expected from the identity provider
examples:
- email
sso_role_matching:
type: array
items:
$ref: '#/components/schemas/nac_portal_sso_role_matching'
description: Rules that map SSO role values from the identity provider to NAC portal roles
use_sso_role_for_cert:
type: boolean
description: Whether to include the matched SSO role in the issued certificate subject for later policy matching
description: SAML SSO settings for NAC portal authentication and role mapping
nac_portal_type2:
title: nac_portal_type2
enum:
- guest_admin
- guest_portal
- marvis_client
type: string
description: 'NAC portal mode, such as guest admin, guest portal, or Marvis client onboarding. enum: `guest_admin`, `guest_portal`, `marvis_client`.'
nac_rule_action2:
title: nac_rule_action2
enum:
- allow
- block
type: string
description: Allow or block decision applied when the NAC rule matches
examples:
- allow
nac_rule_guest_auth_state2:
title: nac_rule_guest_auth_state2
enum:
- authorized
- unknown
type: string
description: 'Guest portal authorization state condition for the rule. enum: `authorized`, `unknown`.'
examples:
- authorized
nac_rule_matching1:
title: nac_rule_matching1
type: object
properties:
auth_type:
allOf:
- $ref: '#/components/schemas/nac_auth_type3'
- description: 'NAC authentication method that must match the request. enum: `cert`, `device-auth`, `eap-teap`, `eap-tls`, `eap-ttls`, `idp`, `mab`, `eap-peap`.'
examples:
- eap-tls
family:
type: array
items:
type: string
description: Client device family values that must match the request
mfg:
type: array
items:
type: string
description: Client device manufacturer values that must match the request
model:
type: array
items:
type: string
description: Client device model values that must match the request
nactags:
type: array
items:
type: string
description: NAC tag IDs whose match criteria must be satisfied by the request
examples:
- - 041d5d36-716c-4cfb-4988-3857c6aa14a2
- a809a97f-d599-f812-eb8c-c3f84aabf6ba
os_type:
type: array
items:
type: string
description: Client OS type values that must match the request
port_types:
type: array
items:
$ref: '#/components/schemas/nac_rule_matching_port_type'
description: Wired or wireless access types that must match the request
examples:
- - wired
site_ids:
type: array
items:
type: string
contentEncoding: uuid
description: Site IDs where the rule criteria apply
examples:
- - bb19fc3e-4124-4b57-80d9-c3f6edce47c4
- bb19fc3e-6564-4b57-80d9-c3f6edce47c1
sitegroup_ids:
type: array
items:
type: string
contentEncoding: uuid
description: Site group IDs where the rule criteria apply
examples:
- - bb19fc3e-4124-4b57-80d9-c3f6edce47c4
- bb19fc3e-6564-4b57-80d9-c3f6edce47c1
vendor:
type: array
items:
type: string
description: Client device vendor values that must match the request
description: Criteria that must not match for the NAC rule to apply
nac_rule_matching3:
title: nac_rule_matching3
type: object
properties:
auth_type:
allOf:
- $ref: '#/components/schemas/nac_auth_type3'
- description: 'NAC authentication method that must match the request. enum: `cert`, `device-auth`, `eap-teap`, `eap-tls`, `eap-ttls`, `idp`, `mab`, `eap-peap`.'
examples:
- eap-tls
family:
type: array
items:
type: string
description: Client device family values that must match the request
mfg:
type: array
items:
type: string
description: Client device manufacturer values that must match the request
model:
type: array
items:
type: string
description: Client device model values that must match the request
nactags:
type: array
items:
type: string
description: NAC tag IDs whose match criteria must be satisfied by the request
examples:
- - 041d5d36-716c-4cfb-4988-3857c6aa14a2
- a809a97f-d599-f812-eb8c-c3f84aabf6ba
os_type:
type: array
items:
type: string
description: Client OS type values that must match the request
port_types:
type: array
items:
$ref: '#/components/schemas/nac_rule_matching_port_type'
description: Wired or wireless access types that must match the request
examples:
- - wired
site_ids:
type: array
items:
type: string
contentEncoding: uuid
description: Site IDs where the rule criteria apply
examples:
- - bb19fc3e-4124-4b57-80d9-c3f6edce47c4
- bb19fc3e-6564-4b57-80d9-c3f6edce47c1
sitegroup_ids:
type: array
items:
type: string
contentEncoding: uuid
description: Site group IDs where the rule criteria apply
examples:
- - bb19fc3e-4124-4b57-80d9-c3f6edce47c4
- bb19fc3e-6564-4b57-80d9-c3f6edce47c1
vendor:
type: array
items:
type: string
description: Client device vendor values that must match the request
description: Criteria that must match for the NAC rule to apply
nac_tag_match2:
title: nac_tag_match2
enum:
- cert_cn
- cert_eku
- cert_issuer
- cert_san
- cert_serial
- cert_sub
- cert_template
- client_mac
- edr_status
- gbp_tag
- hostname
- idp_role
- ingress_vlan
- mdm_status
- nas_ip
- radius_group
- realm
- ssid
- user_name
- usermac_label
type: string
description: 'If `type`==`match`, client or authentication attribute used for rule matching. enum: `cert_cn`, `cert_eku`, `cert_issuer`, `cert_san`, `cert_serial`, `cert_sub`, `cert_template`, `client_mac`, `edr_status`, `gbp_tag`, `hostname`, `idp_role`, `ingress_vlan`, `mdm_status`, `nas_ip`, `radius_group`, `realm`, `ssid`, `user_name`, `usermac_label`.'
nac_tag_type2:
title: nac_tag_type2
enum:
- egress_vlan_names
- gbp_tag
- match
- radius_attrs
- radius_group
- radius_vendor_attrs
- redirect_nacportal_id
- session_timeout
- username_attr
- vlan
type: string
description: 'NAC tag type that determines whether the tag is a matcher or a result attribute. enum: `egress_vlan_names`, `gbp_tag`, `match`, `radius_attrs`, `radius_group`, `radius_vendor_attrs`, `redirect_nacportal_id`, `session_timeout`, `username_attr`, `vlan`.'
nac_tag_username_attr2:
title: nac_tag_username_attr2
enum:
- automatic
- cn
- dns
- email
- upn
type: string
description: 'If `type`==`username_attr`, attribute used to derive the username returned by the NAC rule. enum: `automatic`, `cn`, `dns`, `email`, `upn`.'
network_internal_access2:
title: network_internal_access2
type: object
properties:
enabled:
type: boolean
description: Whether internal access is enabled for this network
description: Internal access settings for this network
network_internet_access2:
title: network_internet_access2
type: object
properties:
create_simple_service_policy:
type: boolean
description: Whether Mist should create simple service policies for restricted internet access
default: false
destination_nat:
type: object
additionalProperties:
$ref: '#/components/schemas/network_internet_access_destination_nat_property'
description: Destination NAT rules for direct internet access
enabled:
type: boolean
description: Whether direct internet access is enabled for this network
restricted:
type: boolean
description: By default, all access is allowed, to only allow certain traffic, make `restricted`=`true` and define service_policies
default: false
static_nat:
type: object
additionalProperties:
$ref: '#/components/schemas/network_internet_access_static_nat_property'
description: Static NAT rules for direct internet access
description: Direct internet access and NAT settings for this network
network_multicast2:
title: network_multicast2
type: object
properties:
disable_igmp:
type: boolean
description: If the network will only be the source of the multicast traffic, IGMP can be disabled
default: false
enabled:
type: boolean
description: Whether multicast support is enabled for this network
default: false
groups:
type: object
additionalProperties:
$ref: '#/components/schemas/network_multicast_group'
description: Multicast group-to-RP mappings for this network
description: Settings for multicast routing on this network
network_source_nat2:
title: network_source_nat2
type: object
properties:
external_ip:
type: string
description: External source NAT IP or subnet used when spoke hosts must be reachable from the hub
examples:
- 172.16.0.8/30
description: Source NAT settings used when non-routed spoke hosts must be reachable from the hub
oauth_ping_identity_region1:
title: oauth_ping_identity_region1
enum:
- asia
- au
- ca
- eu
- us
type: string
description: 'Ping Identity region for OAuth SSO when `oauth_type`==`ping_identity`. enum: `asia`, `au`, `ca`, `eu`, `us`.'
oauth_provider_domain1:
title: oauth_provider_domain1
enum:
- okta.com
- oktapreview.com
- okta-emea.com
- okta-gov.com
- okta.mil
- mtls.okta.com
type: string
description: 'Provider domain for Okta OAuth SSO when `oauth_type`==`okta`. enum: `okta.com`, `oktapreview.com`, `okta-emea.com`, `okta-gov.com`, `okta.mil`, `mtls.okta.com`.'
examples:
- okta.com
org_e911_report_status2:
title: org_e911_report_status2
enum:
- disabled
- scheduled
- available
type: string
description: 'Current generation state of the E911 AP BSSID report. enum: `disabled`, `scheduled`, `available`.'
org_license_action_operation2:
title: org_license_action_operation2
enum:
- amend
- annotate
- delete
- unamend
type: string
description: 'License action operation to perform. enum: `amend`, `annotate`, `delete`, `unamend`.'
org_setting_api_policy2:
title: org_setting_api_policy2
type: object
properties:
enforce_src_ips_for_tokens:
type: boolean
description: Optional. When `true`, Org API tokens without their own `src_ips` also respect the org policy `src_ips`. Default is `false`.
default: false
no_reveal:
type: boolean
description: >-
By default, API hides password/secrets when the user doesn't have write access
* `true`: API will hide passwords/secrets for all users
* `false`: API will hide passwords/secrets for read-only users
default: false
src_ips:
maxItems: 10
type: array
items:
type: string
description: Optional list of IP addresses or CIDR subnets from which org API access is allowed. At most 10 entries. The source IP of the request making this update must be within one of the specified subnets.
examples:
- - 63.3.56.0/24
- 63.3.55.4
description: Policy for hiding API secrets and passwords in responses
org_setting_auto_device_naming_rule_src2:
title: org_setting_auto_device_naming_rule_src2
enum:
- lldp_port_desc
- mac
type: string
description: 'Device attribute used to generate the name. enum: `lldp_port_desc`, `mac`.'
org_setting_auto_device_naming2:
title: org_setting_auto_device_naming2
type: object
properties:
enable:
type: boolean
description: Whether automatic device naming is enabled
rules:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/org_setting_auto_device_naming_rule'
description: List of rules used to derive device names automatically
description: Automatic device naming rules for claimed devices
org_setting_auto_deviceprofile_assignment2:
title: org_setting_auto_deviceprofile_assignment2
type: object
properties:
enable:
type: boolean
description: Whether automatic device profile assignment is enabled
rules:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/org_setting_auto_assignment_rule'
description: Assignment rules evaluated for automatic device profile selection
description: Automatic device profile assignment rules for claimed devices
org_setting_auto_site_assignment_src2:
title: org_setting_auto_site_assignment_src2
enum:
- ext_ip
- dns_suffix
- geoip
- lldp_port_desc
- lldp_system_name
- model
- name
- subnet
type: string
description: 'Source attribute used to evaluate the automatic assignment rule. enum: `ext_ip`, `dns_suffix`, `geoip`, `lldp_port_desc`, `lldp_system_name`, `model`, `name`, `subnet`.'
org_setting_auto_site_assignment2:
title: org_setting_auto_site_assignment2
type: object
properties:
enable:
type: boolean
description: Whether automatic site assignment is enabled
rules:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/org_setting_auto_assignment_rule'
description: Assignment rules evaluated for automatic site selection
description: Automatic site assignment rules for claimed devices
org_setting_auto_upgrade2:
title: org_setting_auto_upgrade2
type: object
properties:
custom_versions:
type: object
additionalProperties:
type: string
description: Per-AP-model firmware versions or channels used for auto-upgrade
examples:
- AP21: alpha
AP41: 0.1.5135
AP61: 0.1.7215
day_of_week:
allOf:
- $ref: '#/components/schemas/day_of_week3'
- description: 'Day of the week for the AP auto-upgrade maintenance window. enum: `any`, `fri`, `mon`, `sat`, `sun`, `thu`, `tue`, `wed`.'
enabled:
type: boolean
description: Whether AP auto-upgrade is enabled. Note that Mist may auto-upgrade APs if the running version is no longer supported.
default: false
time_of_day:
type: string
description: '`any` or HH:MM (24-hour format). Upgrade will happen within up to 1 hour from this time.'
examples:
- 12:00
version:
allOf:
- $ref: '#/components/schemas/site_auto_upgrade_version3'
- description: 'Firmware release channel or specific version used for AP auto-upgrade. enum: `beta`, `custom`, `stable`.'
examples:
- beta
description: AP automatic firmware upgrade policy for the organization
org_setting_device_cert2:
title: org_setting_device_cert2
type: object
properties:
cert:
type: string
description: PEM-encoded common device certificate used by organization settings
examples:
- '-----BEGIN CERTIFICATE-----\nMIIFZjCCA06gAwIBAgIIP61/1qm/uDowDQYJKoZIhvcNAQELBQE\n-----END CERTIFICATE-----'
key:
type: string
description: Private key paired with the common device certificate
examples:
- '-----BEGIN PRI...'
description: Common device certificate used by organization settings
org_setting_gateway_mgmt_app_probing2:
title: org_setting_gateway_mgmt_app_probing2
type: object
properties:
apps:
type: array
items:
type: string
description: Predefined application keys to probe from managed gateways
examples:
- - facebook
description: Application probing configuration applied to managed gateways
org_setting_gateway_mgmt_host_in_policies2:
title: org_setting_gateway_mgmt_host_in_policies2
type: object
properties:
icmp:
allOf:
- $ref: '#/components/schemas/org_setting_gateway_mgmt_host_in_policy3'
- description: Host-in access policy for ICMP traffic to managed gateways
snmp:
allOf:
- $ref: '#/components/schemas/org_setting_gateway_mgmt_host_in_policy1'
- description: Host-in access policy for SNMP traffic to managed gateways
description: Host-in access policies for gateway management services such as ICMP and SNMP
org_setting_gateway_mgmt_host_in_policy1:
title: org_setting_gateway_mgmt_host_in_policy1
type: object
properties:
tenants:
uniqueItems: true
type: array
items:
type: string
description: Tenant names this host-in policy applies to
description: Host-in access policy for SNMP traffic to managed gateways
org_setting_gateway_mgmt_host_in_policy3:
title: org_setting_gateway_mgmt_host_in_policy3
type: object
properties:
tenants:
uniqueItems: true
type: array
items:
type: string
description: Tenant names this host-in policy applies to
description: Host-in access policy for ICMP traffic to managed gateways
org_setting_gateway_mgmt_host_out_policies2:
title: org_setting_gateway_mgmt_host_out_policies2
type: object
properties:
dns:
allOf:
- $ref: '#/components/schemas/gateway_mgmt_host_out_policy1'
- description: Path preference policy for gateway-originated DNS traffic
ntp:
allOf:
- $ref: '#/components/schemas/gateway_mgmt_host_out_policy2'
- description: Path preference policy for gateway-originated NTP traffic
syslog:
allOf:
- $ref: '#/components/schemas/gateway_mgmt_host_out_policy_syslog1'
- description: Path preference policy for gateway-originated syslog traffic
description: Path preference policies for gateway-originated management traffic
org_setting_gateway_mgmt_overlay_ip2:
title: org_setting_gateway_mgmt_overlay_ip2
type: object
properties:
ip:
type: string
description: When it's going overlay, a routable IP to overlay will be required
node1_ip:
type: string
description: For SSR HA cluster, another IP for node1 will be required, too
description: Overlay IP addresses used when gateway management traffic uses the overlay
org_setting_gateway_mgmt2:
title: org_setting_gateway_mgmt2
type: object
properties:
app_probing:
allOf:
- $ref: '#/components/schemas/org_setting_gateway_mgmt_app_probing2'
- description: Application probing configuration applied to managed gateways
app_usage:
type: boolean
description: For SRX only, whether gateway application usage collection is enabled; requires App Track license
fips_enabled:
type: boolean
description: Whether FIPS mode is enabled for managed gateways
default: false
host_in_policies:
allOf:
- $ref: '#/components/schemas/org_setting_gateway_mgmt_host_in_policies2'
- description: Host-in access policies for gateway management services such as ICMP and SNMP
host_out_policies:
allOf:
- $ref: '#/components/schemas/org_setting_gateway_mgmt_host_out_policies2'
- description: Path preference policies for gateway-originated management traffic
overlay_ip:
allOf:
- $ref: '#/components/schemas/org_setting_gateway_mgmt_overlay_ip2'
- description: Overlay IP addresses used when gateway management traffic uses the overlay
description: Gateway management defaults for the organization
org_setting_installer2:
title: org_setting_installer2
type: object
properties:
allow_all_devices:
type: boolean
description: Whether installers may work with all eligible devices
allow_all_sites:
type: boolean
description: Whether installers may work with all sites
extra_site_ids:
type: array
items:
type: string
contentEncoding: uuid
description: Additional site IDs that installers may access
grace_period:
type: integer
description: Grace period, in days, during which installers can modify recent sites or devices
contentEncoding: int32
description: Access settings for organization installer workflows
org_setting_jcloud_ra2:
title: org_setting_jcloud_ra2
type: object
properties:
org_apitoken:
type: string
description: JCloud Routing Assurance Org Token
org_apitoken_name:
type: string
description: JCloud Routing Assurance Org Token Name
org_id:
type: string
description: JCloud Routing Assurance Org ID
description: Routing Assurance integration settings for JCloud
org_setting_jcloud2:
title: org_setting_jcloud2
type: object
properties:
org_apitoken:
type: string
description: JCloud organization API token used by this Mist organization
org_apitoken_name:
type: string
description: Display name for the JCloud organization API token
org_id:
type: string
description: JCloud organization identifier linked to this Mist organization
description: Integration settings for JCloud
org_setting_juniper_srx2:
title: org_setting_juniper_srx2
type: object
properties:
auto_upgrade:
allOf:
- $ref: '#/components/schemas/juniper_srx_auto_upgrade1'
- description: SRX auto-upgrade settings applied when Juniper SRX devices are first onboarded
description: SRX integration settings for Juniper devices
org_setting_junos_shell_access_admin2:
title: org_setting_junos_shell_access_admin2
enum:
- admin
- none
- viewer
type: string
description: 'Shell access level used for administrator web-shell sessions. enum: `admin`, `none`, `viewer`.'
org_setting_junos_shell_access_helpdesk2:
title: org_setting_junos_shell_access_helpdesk2
enum:
- admin
- none
- viewer
type: string
description: 'Shell access level used for helpdesk web-shell sessions. enum: `admin`, `none`, `viewer`.'
org_setting_junos_shell_access_read2:
title: org_setting_junos_shell_access_read2
enum:
- admin
- none
- viewer
type: string
description: 'Shell access level used for read-only web-shell sessions. enum: `admin`, `none`, `viewer`.'
org_setting_junos_shell_access_write2:
title: org_setting_junos_shell_access_write2
enum:
- admin
- none
- viewer
type: string
description: 'Shell access level used for write-role web-shell sessions. enum: `admin`, `none`, `viewer`.'
org_setting_junos_shell_access2:
title: org_setting_junos_shell_access2
type: object
properties:
admin:
allOf:
- $ref: '#/components/schemas/org_setting_junos_shell_access_admin2'
- description: 'Shell access level used for administrator web-shell sessions. enum: `admin`, `none`, `viewer`.'
helpdesk:
allOf:
- $ref: '#/components/schemas/org_setting_junos_shell_access_helpdesk2'
- description: 'Shell access level used for helpdesk web-shell sessions. enum: `admin`, `none`, `viewer`.'
read:
allOf:
- $ref: '#/components/schemas/org_setting_junos_shell_access_read2'
- description: 'Shell access level used for read-only web-shell sessions. enum: `admin`, `none`, `viewer`.'
write:
allOf:
- $ref: '#/components/schemas/org_setting_junos_shell_access_write2'
- description: 'Shell access level used for write-role web-shell sessions. enum: `admin`, `none`, `viewer`.'
description: Role-based Junos web-shell access settings
org_setting_marvis2:
title: org_setting_marvis2
type: object
properties:
disable_proactive_monitoring:
type: boolean
description: 'Disable proactive monitoring in Marvis. NOTE: support access must be enabled for the org (`allow_mist`=`true`) for proactive monitoring to function.'
default: false
self_driving:
allOf:
- $ref: '#/components/schemas/marvis_self_driving1'
- description: Self-driving network automation settings by domain
description: AI assistant and self-driving feature settings for Marvis
org_setting_mgmt2:
title: org_setting_mgmt2
type: object
properties:
mxtunnel_ids:
type: array
items:
type: string
contentEncoding: uuid
description: Mist Tunnel IDs selected for management connectivity
use_mxtunnel:
type: boolean
description: Whether to use Mist Tunnel for mgmt connectivity, this takes precedence over use_wxtunnel
default: false
use_wxtunnel:
type: boolean
description: Whether to use wxtunnel for mgmt connectivity
default: false
description: Tunnel settings for organization management connectivity
org_setting_mist_nac_fingerprinting_wireless_coa2:
title: org_setting_mist_nac_fingerprinting_wireless_coa2
enum:
- reauth
- disconnect
type: string
description: 'Change of Authorization action sent to wireless clients when fingerprints change. enum: `reauth`, `disconnect`.'
org_setting_mist_nac_fingerprinting2:
title: org_setting_mist_nac_fingerprinting2
type: object
properties:
enabled:
type: boolean
description: enable/disable writes to NAC DDB fingerprint table
default: false
generate_coa:
type: boolean
description: enable/disable CoA triggers on fingerprint change for wired clients, always port-bounce
default: false
generate_wireless_coa:
type: boolean
description: enable/disable CoA triggers on fingerprint change for wireless clients
default: false
wireless_coa_type:
allOf:
- $ref: '#/components/schemas/org_setting_mist_nac_fingerprinting_wireless_coa2'
- description: 'Change of Authorization action sent to wireless clients when fingerprints change. enum: `reauth`, `disconnect`.'
description: Client fingerprinting settings used by Mist NAC
org_setting_mist_nac_ip_version2:
title: org_setting_mist_nac_ip_version2
enum:
- v4
- v6
type: string
description: 'IP version used by NAS devices and Mist Edge proxies to reach Mist NAC. enum: `v4`, `v6`.'
org_setting_mist_nac_mdm2:
title: org_setting_mist_nac_mdm2
type: object
properties:
coa_type:
allOf:
- $ref: '#/components/schemas/nac_coa_type2'
- description: 'Change of Authorization action sent for MDM posture changes. enum: `reauth`, `disconnect`.'
description: Mobile Device Management CoA settings for Mist NAC
org_setting_mist_nac2:
title: org_setting_mist_nac2
type: object
properties:
allow_teap_machine_auth_only:
type: boolean
description: allow clients to connect even when the user cert failed. TEAP authenticates both Machine Cert and User Cert. When enabled, clients who only succeed Machine Cert authentication will be accepted.
default: false
cacerts:
type: array
items:
type: string
description: CA certificates trusted by Mist NAC for certificate-based authentication
default_idp_id:
type: string
description: use this IDP when no explicit realm present in the incoming username/CN OR when no IDP is explicitly mapped to the incoming realm.
disable_rsae_algorithms:
type: boolean
description: to disable RSAE_PSS_SHA256, RSAE_PSS_SHA384, RSAE_PSS_SHA512 from server side. see https://www.openssl.org/docs/man3.0/man1/openssl-ciphers.html
default: false
eap_ssl_security_level:
maximum: 4
minimum: 1
type: integer
description: eap ssl security level, see https://www.openssl.org/docs/man1.1.1/man3/SSL_CTX_set_security_level.html#DEFAULT-CALLBACK-BEHAVIOUR
contentEncoding: int32
default: 2
enable_eap_md5_for_mab:
type: boolean
description: 'Enable EAP-MD5 for MAB. WARNING: Not FIPS compliant, use only if required for legacy device support.'
default: false
eu_only:
type: boolean
description: By default, NAC POD failover considers all NAC pods available around the globe, i.e. EU, US, or APAC based, failover happens based on geo IP of the originating site. For strict GDPR compliance NAC POD failover would only happen between the PODs located within the EU environment, and no authentication would take place outside of EU. This is an org setting that is applicable to WLANs, switch templates, Mist Edge clusters that have mist_nac enabled
default: false
fingerprinting:
allOf:
- $ref: '#/components/schemas/org_setting_mist_nac_fingerprinting2'
- description: Client fingerprinting settings used by Mist NAC
idp_machine_cert_lookup_field:
allOf:
- $ref: '#/components/schemas/idp_machine_cert_lookup_field1'
- description: 'Client certificate field used to look up machine groups in identity providers. enum: `automatic`, `cn`, `dns`.'
idp_user_cert_lookup_field:
allOf:
- $ref: '#/components/schemas/idp_user_cert_lookup_field1'
- description: 'Client certificate field used to look up user groups in identity providers. enum: `automatic`, `cn`, `email`, `upn`.'
idps:
type: array
items:
$ref: '#/components/schemas/org_setting_mist_nac_idp'
description: Identity provider mappings used by Mist NAC realm matching
mdm:
allOf:
- $ref: '#/components/schemas/org_setting_mist_nac_mdm2'
- description: Mobile Device Management CoA settings for Mist NAC
server_cert:
allOf:
- $ref: '#/components/schemas/org_setting_mist_nac_server_cert'
- description: RADIUS server certificate presented by Mist NAC during EAP-TLS
use_ip_version:
allOf:
- $ref: '#/components/schemas/org_setting_mist_nac_ip_version2'
- description: 'IP version used by NAS devices and Mist Edge proxies to reach Mist NAC. enum: `v4`, `v6`.'
use_ssl_port:
type: boolean
description: By default, NAS devices (switches/aps) and proxies(mxedge) are configured to use port TCP2083(RadSec) to reach mist-nac. Set `use_ssl_port`==`true` to override that port with TCP43 (ssl), This is an org level setting that is applicable to wlans, switch_templates, and mxedge_clusters that have mist-nac enabled
default: false
usermac_expiry:
maximum: 1095
minimum: 0
type: integer
description: Allow customer to configure an expiry time for usermacs by attaching an `inactive_endpoint` label to those which have been inactive for the configured period of time (in days). 0 means no expiry
contentEncoding: int32
default: 0
examples:
- 30
description: NAC settings for Mist Access Assurance
org_setting_pcap2:
title: org_setting_pcap2
type: object
properties:
bucket:
type: string
description: Storage bucket name used for organization packet capture files
examples:
- myorg_pcap
max_pkt_len:
maximum: 128
type: integer
description: Maximum length of non-management packets to capture, in bytes
contentEncoding: int32
default: 128
examples:
- 128
description: Packet capture settings for the organization
org_setting_security2:
title: org_setting_security2
type: object
properties:
disable_local_ssh:
type: boolean
description: Whether to disable local SSH (by default, local SSH is enabled with allow_mist in Org is enabled
fips_zeroize_password:
type: string
description: password required to zeroize devices (FIPS) on site level
examples:
- NUKETHESITE
limit_ssh_access:
type: boolean
description: Whether to allow certain SSH keys to SSH into the AP (see Site:Setting)
default: false
description: Organization security controls such as local SSH restrictions
org_setting_switch_mgmt2:
title: org_setting_switch_mgmt2
type: object
properties:
ap_affinity_threshold:
type: integer
description: If the field is set in both site/setting and org/setting, the value from site/setting will be used.
contentEncoding: int32
default: 12
examples:
- 10
description: Management settings for switches in this organization
org_setting_vpn_options2:
title: org_setting_vpn_options2
type: object
properties:
as_base:
maximum: 2147483647
minimum: 1
type: integer
description: Base BGP autonomous system number used for generated VPN configurations
contentEncoding: int32
enable_ipv6:
type: boolean
description: Whether IPv6 is enabled for organization VPN configuration
default: false
st_subnet:
type: string
description: requiring /12 or bigger to support 16 private IPs for 65535 gateways
default: 10.224.0.0/12
description: Options for organization VPN behavior
org_ui_settings_purpose2:
title: org_ui_settings_purpose2
const: marvisdashboard
type: string
description: 'UI surface or purpose for this databoard. enum: `marvisdashboard`.'
org_ui_settings_tile_position2:
title: org_ui_settings_tile_position2
type: object
properties:
col:
type: integer
description: Grid column index for the tile
contentEncoding: int32
examples:
- 1
colSpan:
type: integer
description: Grid column span for the tile
contentEncoding: int32
examples:
- 5
row:
type: integer
description: Grid row index for the tile
contentEncoding: int32
examples:
- 1
rowSpan:
type: integer
description: Grid row span for the tile
contentEncoding: int32
examples:
- 2
description: Grid position and span for the databoard tile
ospf_area_network_auth_type2:
title: ospf_area_network_auth_type2
enum:
- md5
- none
- password
type: string
description: 'Authentication method used by this OSPF network. enum: `md5`, `none`, `password`.'
examples:
- md5
ospf_area_network_interface_type2:
title: ospf_area_network_interface_type2
enum:
- broadcast
- nbma
- p2mp
- p2p
type: string
description: 'OSPF interface type used for this network. enum: `broadcast`, `nbma`, `p2mp`, `p2p`.'
ospf_area_type2:
title: ospf_area_type2
enum:
- default
- nssa
- stub
type: string
description: 'Area type for this OSPF area. enum: `default`, `nssa`, `stub`.'
examples:
- default
other_device_update_operation2:
title: other_device_update_operation2
enum:
- assign
- unassign
type: string
description: 'Action to perform on the other devices. enum: `assign`, `unassign`.'
pcap_type1:
title: pcap_type1
enum:
- client
- gateway
- new_assoc
- radiotap
- radiotap,wired
- wired
- wireless
type: string
description: 'Packet capture type for the current session. enum: `client`, `gateway`, `new_assoc`, `radiotap`, `radiotap,wired`, `wired`, `wireless`.'
examples:
- client
poe_priority2:
title: poe_priority2
enum:
- low
- high
type: string
description: 'PoE priority configured for the port. enum: `low`, `high`.'
poe_priority3:
title: poe_priority3
enum:
- low
- high
type: string
description: 'Only if `mode`!=`dynamic`. PoE priority for ports using this port usage. enum: `low`, `high`.'
port_auth_state1:
title: port_auth_state1
enum:
- authenticated
- authenticating
- held
- init
type: string
description: 'Authentication state of the port. enum: ``, `authenticated`, `authenticating`, `held`, `init`.'
port_stp_role1:
title: port_stp_role1
enum:
- alternate
- backup
- designated
- disabled
- root
- root-prevented
type: string
description: 'Current spanning tree role of the port. enum: ``, `alternate`, `backup`, `designated`, `disabled`, `root`, `root-prevented`.'
port_stp_state1:
title: port_stp_state1
enum:
- blocking
- disabled
- forwarding
- learning
- listening
type: string
description: 'Current spanning tree state of the port. enum: ``, `blocking`, `disabled`, `forwarding`, `learning`, `listening`.'
portal_template_alignment2:
title: portal_template_alignment2
enum:
- center
- left
- right
type: string
description: 'Logo and text alignment for the PSK portal template. enum: `center`, `left`, `right`.'
portal_template_alignment3:
title: portal_template_alignment3
enum:
- center
- left
- right
type: string
description: 'Text and content alignment used by the guest portal template. enum: `center`, `left`, `right`.'
portal_template_alignment4:
title: portal_template_alignment4
enum:
- center
- left
- right
type: string
description: 'Text and content alignment for the NAC portal page. enum: `center`, `left`, `right`.'
privilege_msp_role2:
title: privilege_msp_role2
enum:
- admin
- helpdesk
- installer
- read
- write
type: string
description: 'Access role granted by this MSP privilege. enum: `admin`, `helpdesk`, `installer`, `read`, `write`.'
privilege_msp_scope2:
title: privilege_msp_scope2
enum:
- msp
- org
- orggroup
type: string
description: 'MSP hierarchy level where this privilege applies. enum: `msp`, `org`, `orggroup`.'
privilege_org_role2:
title: privilege_org_role2
enum:
- admin
- helpdesk
- installer
- read
- write
type: string
description: 'Access role granted by this organization privilege. enum: `admin`, `helpdesk`, `installer`, `read`, `write`.'
privilege_org_scope2:
title: privilege_org_scope2
enum:
- org
- site
- sitegroup
- orgsites
type: string
description: 'Organization hierarchy level where this privilege applies. enum: `org`, `site`, `sitegroup`, `orgsites`.'
protect_re_custom_protocol2:
title: protect_re_custom_protocol2
enum:
- any
- icmp
- tcp
- udp
type: string
description: 'Transport protocol matched by this custom Protect RE ACL. enum: `any`, `icmp`, `tcp`, `udp`.'
protect_re1:
title: protect_re1
type: object
properties:
allowed_services:
type: array
items:
$ref: '#/components/schemas/protect_re_allowed_service'
description: Built-in services explicitly allowed by the Protect RE policy
examples:
- - icmp
- ssh
custom:
type: array
items:
$ref: '#/components/schemas/protect_re_custom'
description: Additional ACL entries allowed by the Protect RE policy
enabled:
type: boolean
description: >-
When enabled, all traffic that is not essential to our operation will be dropped
e.g. ntp / dns / traffic to mist will be allowed by default
if dhcpd is enabled, we'll make sure it works
default: false
hit_count:
type: boolean
description: Whether to enable hit count for Protect_RE policy
default: false
trusted_hosts:
type: array
items:
type: string
description: Trusted host or subnet entries allowed by the Protect RE policy
description: Control-plane protection settings for the gateway
protect_re3:
title: protect_re3
type: object
properties:
allowed_services:
type: array
items:
$ref: '#/components/schemas/protect_re_allowed_service'
description: Built-in services explicitly allowed by the Protect RE policy
examples:
- - icmp
- ssh
custom:
type: array
items:
$ref: '#/components/schemas/protect_re_custom'
description: Additional ACL entries allowed by the Protect RE policy
enabled:
type: boolean
description: >-
When enabled, all traffic that is not essential to our operation will be dropped
e.g. ntp / dns / traffic to mist will be allowed by default
if dhcpd is enabled, we'll make sure it works
default: false
hit_count:
type: boolean
description: Whether to enable hit count for Protect_RE policy
default: false
trusted_hosts:
type: array
items:
type: string
description: Trusted host or subnet entries allowed by the Protect RE policy
description: Control-plane protection settings for the switch
proxy1:
title: proxy1
type: object
properties:
disabled:
type: boolean
description: Whether this proxy configuration is disabled
default: false
examples:
- true
url:
type: string
description: Proxy URL used to reach Mist
examples:
- https://proxy.corp.com:8080/
description: Network proxy settings used by the Mist Edge
proxy3:
title: proxy3
type: object
properties:
disabled:
type: boolean
description: Whether this proxy configuration is disabled
default: false
examples:
- true
url:
type: string
description: Proxy URL used to reach Mist
examples:
- https://proxy.corp.com:8080/
description: Network proxy settings for devices at the site
proxy4:
title: proxy4
type: object
properties:
disabled:
type: boolean
description: Whether this proxy configuration is disabled
default: false
examples:
- true
url:
type: string
description: Proxy URL used to reach Mist
examples:
- https://proxy.corp.com:8080/
description: Network proxy settings used by Mist Edges in the cluster to communicate with the Mist Cloud
psk_portal_auth2:
title: psk_portal_auth2
enum:
- sponsor
- sso
type: string
description: 'Portal access method, enum: `sponsor`, `sso`'
psk_portal_passphrase_rules2:
title: psk_portal_passphrase_rules2
type: object
properties:
alphabets_enabled:
type: boolean
description: Whether generated passphrases may include alphabetic characters
default: true
length:
maximum: 63
minimum: 8
type: integer
description: Fixed generated passphrase length used when min and max length are not both valid
contentEncoding: int32
max_length:
maximum: 63
minimum: 8
type: integer
description: Maximum generated passphrase length when paired with a valid `min_length`. If `max_length` or `min_length` is invalid, the portal uses `length`; if `length` is unset or invalid, it uses 8. Valid values are integers from 8 through 63, and `max_length` must be greater than `min_length`
contentEncoding: int32
min_length:
maximum: 63
minimum: 8
type: integer
description: Minimum generated passphrase length when paired with a valid `max_length`. If `max_length` or `min_length` is invalid, the portal uses `length`; if `length` is unset or invalid, it uses 8. Valid values are integers from 8 through 63, and `max_length` must be greater than `min_length`
contentEncoding: int32
numerics_enabled:
type: boolean
description: Whether generated passphrases may include numeric characters
default: true
symbols:
type: string
description: Allowed symbol characters for generated passphrases
examples:
- ()[]{}_%@#&$
symbols_enabled:
type: boolean
description: Whether generated passphrases may include symbols
default: true
description: Generation rules for PSK passphrases created through this portal
psk_portal_sso_idp_sign_algo2:
title: psk_portal_sso_idp_sign_algo2
enum:
- sha1
- sha256
- sha384
- sha512
type: string
description: 'SAML assertion signing algorithm expected from the identity provider. enum: `sha1`, `sha256`, `sha384`, `sha512`.'
psk_portal_sso2:
title: psk_portal_sso2
type: object
properties:
allowed_roles:
type: array
items:
type: string
description: SSO roles allowed to access the PSK portal; if empty, any role is permitted
idp_cert:
type: string
description: Identity provider signing certificate in PEM format
idp_sign_algo:
allOf:
- $ref: '#/components/schemas/psk_portal_sso_idp_sign_algo2'
- description: 'SAML assertion signing algorithm expected from the identity provider. enum: `sha1`, `sha256`, `sha384`, `sha512`.'
idp_sso_url:
type: string
description: Identity provider SSO URL for SAML login
issuer:
type: string
description: SAML issuer value for the identity provider
nameid_format:
type: string
description: SAML NameID format used for the portal login
role_mapping:
type: object
additionalProperties:
type: string
description: Maps PSK portal role names to SSO attribute values
use_sso_role_for_psk_role:
type: boolean
description: Whether to use SSO role mapping for the PSK role and ignore the portal-level `role` field
description: Single sign-on configuration used when `auth`==`sso`
psk_portal_template_setting2:
title: psk_portal_template_setting2
type: object
properties:
alignment:
allOf:
- $ref: '#/components/schemas/portal_template_alignment2'
- description: 'Logo and text alignment for the PSK portal template. enum: `center`, `left`, `right`.'
color:
type: string
description: Primary hex color used by the portal template
default: '#1074bc'
logo:
type:
- string
- 'null'
description: Custom logo with "data:image/png;base64," format. default null, uses Juniper Mist Logo
poweredBy:
type: boolean
description: Whether to hide "Powered by Juniper Mist" and email footers
default: false
tos:
type: boolean
description: Whether to show Terms of Service
tosAcceptLabel:
type: string
description: Terms of Service accept button label
default: I accept the Terms of Service
tosError:
type: string
description: Error message shown when the user has not accepted the Terms of Service
default: Please review and accept the Terms of Service
tosLink:
type: string
description: Terms of Service link label displayed in the portal footer
default: Terms of Service
tosText:
type: string
description: Terms of Service text displayed in the footer when Terms are enabled
default: << provide your Terms of Service here >>
tosUrl:
type: string
description: Custom URL for the Terms of Service policy
examples:
- https://company.com/wifi-policy
description: Template settings for customizing the PSK portal UI
psk_portal_type2:
title: psk_portal_type2
enum:
- admin
- byod
type: string
description: Portal mode for personal PSK onboarding, either admin or BYOD
psk_usage2:
title: psk_usage2
enum:
- macs
- multi
- single
- usermac_labels
type: string
description: 'Binding mode for this PSK, enum: `macs`, `multi`, `single`, `usermac_labels`'
push_policy_push_window1:
title: push_policy_push_window1
type: object
properties:
enabled:
type: boolean
description: Whether configuration pushes are limited to the configured push window
default: false
hours:
allOf:
- $ref: '#/components/schemas/hours1'
- description: Day-of-week hour ranges when configuration pushes are allowed
description: Allowed time window during which configuration pushes may run
radio_band_24_usage2:
title: radio_band_24_usage2
enum:
- '24'
- '5'
- '6'
- auto
type: string
description: 'Radio usage mode for the 2.4 GHz-capable radio in this RF template. enum: `24`, `5`, `6`, `auto`.'
radio_band_24_usage3:
title: radio_band_24_usage3
enum:
- '24'
- '5'
- '6'
- auto
type: string
description: 'Model-specific radio usage mode for the 2.4 GHz-capable radio. enum: `24`, `5`, `6`, `auto`.'
radio_band_24_usage4:
title: radio_band_24_usage4
enum:
- '24'
- '5'
- '6'
- auto
type: string
description: 'Radio usage mode for the 2.4 GHz-capable radio. enum: `24`, `5`, `6`, `auto`.'
radio_band_antenna_beam_pattern1:
title: radio_band_antenna_beam_pattern1
enum:
- narrow
- medium
- wide
type: string
description: 'Beam pattern used by the 6 GHz radio antenna. enum: `narrow`, `medium`, `wide`.'
radio_band_antenna_beam_pattern3:
title: radio_band_antenna_beam_pattern3
enum:
- narrow
- medium
- wide
type: string
description: 'Beam pattern used by the 5 GHz radio antenna. enum: `narrow`, `medium`, `wide`.'
radio_band_antenna_mode1:
title: radio_band_antenna_mode1
enum:
- 1x1
- 2x2
- 3x3
- 4x4
- default
type: string
description: 'Radio chain mode for the 5 GHz radio. enum: `1x1`, `2x2`, `3x3`, `4x4`, `default`.'
examples:
- default
radio_band_antenna_mode2:
title: radio_band_antenna_mode2
enum:
- 1x1
- 2x2
- 3x3
- 4x4
- default
type: string
description: 'Radio chain mode for the 6 GHz radio. enum: `1x1`, `2x2`, `3x3`, `4x4`, `default`.'
examples:
- default
radio_band_antenna_mode4:
title: radio_band_antenna_mode4
enum:
- 1x1
- 2x2
- 3x3
- 4x4
- default
type: string
description: 'Radio chain mode for the 2.4 GHz radio. enum: `1x1`, `2x2`, `3x3`, `4x4`, `default`.'
examples:
- default
radio_band_preamble1:
title: radio_band_preamble1
enum:
- auto
- long
- short
type: string
description: '802.11 preamble mode used by the 5 GHz radio. enum: `auto`, `long`, `short`.'
radio_band_preamble2:
title: radio_band_preamble2
enum:
- auto
- long
- short
type: string
description: '802.11 preamble mode used by the 6 GHz radio. enum: `auto`, `long`, `short`.'
radio_band_preamble4:
title: radio_band_preamble4
enum:
- auto
- long
- short
type: string
description: '802.11 preamble mode used by the 2.4 GHz radio. enum: `auto`, `long`, `short`.'
radius_config2:
title: radius_config2
type: object
properties:
acct_interim_interval:
maximum: 65535
minimum: 0
type: integer
description: How frequently should interim accounting be reported, 60-65535. default is 0 (use one specified in Access-Accept request from RADIUS Server). Very frequent messages can affect the performance of the RADIUS server, 600 and up is recommended when enabled
contentEncoding: int32
default: 0
acct_servers:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/radius_acct_server'
description: RADIUS accounting servers used by this Junos configuration
auth_servers:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/radius_auth_server'
description: RADIUS authentication servers used by this Junos configuration
auth_servers_retries:
type: integer
description: Number of RADIUS authentication request retries before failover
contentEncoding: int32
default: 3
auth_servers_timeout:
type: integer
description: RADIUS authentication server timeout, in seconds
contentEncoding: int32
default: 5
coa_enabled:
type: boolean
description: Whether RADIUS Change of Authorization (CoA) is enabled
default: false
coa_port:
maximum: 65535
minimum: 1
type: integer
description: UDP port used for RADIUS Change of Authorization (CoA)
contentEncoding: int32
default: 3799
network:
type: string
description: Use `network` or `source_ip`. Network where the RADIUS server resides; if the network has a static IP, Mist uses it as the source IP
source_ip:
type: string
description: Use `network` or `source_ip`. Explicit source IP address for RADIUS traffic
description: RADIUS authentication and accounting settings for this AP port
radius_keywrap_format1:
title: radius_keywrap_format1
enum:
- ascii
- hex
type: string
description: 'Encoding format for RADIUS keywrap KEK and MACK values. enum: `ascii`, `hex`.'
radsec2:
title: radsec2
type: object
properties:
coa_enabled:
type: boolean
description: Whether RADIUS Change of Authorization (CoA) is enabled for RadSec traffic
default: false
enabled:
type: boolean
description: Whether RadSec is enabled
idle_timeout:
anyOf:
- type: integer
contentEncoding: int32
default: 60
- type: string
description: Idle timeout, in seconds, for RadSec connections
mxcluster_ids:
type: array
items:
type: string
contentEncoding: uuid
description: Mist Edge cluster IDs used as RadSec proxies when the WLAN does not use mxtunnel
proxy_hosts:
type: array
items:
type: string
description: RadSec proxy hostnames advertised to APs
server_name:
type: string
description: TLS server name to verify against the CA certificates in Org Setting. Only if not Mist Edge.
examples:
- radsec.abc.com
servers:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/radsec_server'
description: External RadSec servers. Only if not Mist Edge.
use_mxedge:
type: boolean
description: Whether to use organization Mist Edge instances as RadSec proxies
use_site_mxedge:
type: boolean
description: Whether to use site Mist Edge instances when this WLAN does not use mxtunnel
default: false
description: TLS-secured RADIUS transport settings for this WLAN
radsec3:
title: radsec3
type: object
properties:
coa_enabled:
type: boolean
description: Whether RADIUS Change of Authorization (CoA) is enabled for RadSec traffic
default: false
enabled:
type: boolean
description: Whether RadSec is enabled
idle_timeout:
anyOf:
- type: integer
contentEncoding: int32
default: 60
- type: string
description: Idle timeout, in seconds, for RadSec connections
mxcluster_ids:
type: array
items:
type: string
contentEncoding: uuid
description: Mist Edge cluster IDs used as RadSec proxies when the WLAN does not use mxtunnel
proxy_hosts:
type: array
items:
type: string
description: RadSec proxy hostnames advertised to APs
server_name:
type: string
description: TLS server name to verify against the CA certificates in Org Setting. Only if not Mist Edge.
examples:
- radsec.abc.com
servers:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/radsec_server'
description: External RadSec servers. Only if not Mist Edge.
use_mxedge:
type: boolean
description: Whether to use organization Mist Edge instances as RadSec proxies
use_site_mxedge:
type: boolean
description: Whether to use site Mist Edge instances when this WLAN does not use mxtunnel
default: false
description: TLS-secured RADIUS settings for this AP port
random_mac1:
title: random_mac1
enum:
- 'true'
- 'false'
type: string
description: 'Whether the client used a randomized MAC address. enum: `true`, `false`.'
random_mac3:
title: random_mac3
enum:
- 'true'
- 'false'
type: string
description: 'Whether the NAC client used a randomized MAC address. enum: `true`, `false`.'
recaptcha_flavor1:
title: recaptcha_flavor1
enum:
- google
- hcaptcha
type: string
description: CAPTCHA provider used for registration, such as Google reCAPTCHA or hCaptcha
examples:
- hcaptcha
recaptcha_flavor3:
title: recaptcha_flavor3
enum:
- google
- hcaptcha
type: string
description: 'CAPTCHA provider flavor used for recovery verification. enum: `google`, `hcaptcha`.'
examples:
- hcaptcha
recaptcha_flavor4:
title: recaptcha_flavor4
enum:
- google
- hcaptcha
type: string
description: 'CAPTCHA provider flavor used for registration verification. enum: `google`, `hcaptcha`.'
examples:
- hcaptcha
remote_syslog_archive1:
title: remote_syslog_archive1
type: object
properties:
files:
anyOf:
- type: string
- type: integer
contentEncoding: int32
description: Number of archived syslog files to retain
examples:
- '20'
size:
type: string
description: Maximum size of each archived syslog file, such as 5m
examples:
- 5m
description: Retention settings for this generated syslog file
remote_syslog_archive3:
title: remote_syslog_archive3
type: object
properties:
files:
anyOf:
- type: string
- type: integer
contentEncoding: int32
description: Number of archived syslog files to retain
examples:
- '20'
size:
type: string
description: Maximum size of each archived syslog file, such as 5m
examples:
- 5m
description: Retention settings for generated syslog archive files
remote_syslog_console2:
title: remote_syslog_console2
type: object
properties:
contents:
type: array
items:
$ref: '#/components/schemas/remote_syslog_content'
description: Syslog facilities and severities forwarded from console logs
description: Log forwarding filters for console messages sent to remote syslog
remote_syslog_facility1:
title: remote_syslog_facility1
enum:
- any
- authorization
- change-log
- config
- conflict-log
- daemon
- dfc
- external
- firewall
- ftp
- interactive-commands
- kernel
- ntp
- pfe
- security
- user
type: string
description: 'Default syslog facility for messages sent to this server. enum: `any`, `authorization`, `change-log`, `config`, `conflict-log`, `daemon`, `dfc`, `external`, `firewall`, `ftp`, `interactive-commands`, `kernel`, `ntp`, `pfe`, `security`, `user`.'
examples:
- config
remote_syslog_facility3:
title: remote_syslog_facility3
enum:
- any
- authorization
- change-log
- config
- conflict-log
- daemon
- dfc
- external
- firewall
- ftp
- interactive-commands
- kernel
- ntp
- pfe
- security
- user
type: string
description: 'Syslog facility to match for this selector. enum: `any`, `authorization`, `change-log`, `config`, `conflict-log`, `daemon`, `dfc`, `external`, `firewall`, `ftp`, `interactive-commands`, `kernel`, `ntp`, `pfe`, `security`, `user`.'
examples:
- config
remote_syslog_server_protocol2:
title: remote_syslog_server_protocol2
enum:
- tcp
- udp
type: string
description: 'Transport protocol used for this remote syslog server. enum: `tcp`, `udp`.'
remote_syslog_severity1:
title: remote_syslog_severity1
enum:
- alert
- any
- critical
- emergency
- error
- info
- notice
- warning
type: string
description: 'Default syslog severity for messages sent to this server. enum: `alert`, `any`, `critical`, `emergency`, `error`, `info`, `notice`, `warning`.'
remote_syslog_severity3:
title: remote_syslog_severity3
enum:
- alert
- any
- critical
- emergency
- error
- info
- notice
- warning
type: string
description: 'Syslog severity to match for this selector. enum: `alert`, `any`, `critical`, `emergency`, `error`, `info`, `notice`, `warning`.'
remote_syslog_time_format2:
title: remote_syslog_time_format2
enum:
- millisecond
- year
- year millisecond
type: string
description: 'Timestamp format used in forwarded syslog messages. enum: `millisecond`, `year`, `year millisecond`.'
examples:
- millisecond
remote_syslog1:
title: remote_syslog1
type: object
properties:
archive:
allOf:
- $ref: '#/components/schemas/remote_syslog_archive3'
- description: Retention settings for generated syslog archive files
cacerts:
type: array
items:
type: string
description: CA certificates used to verify TLS syslog servers
examples:
- - '-----BEGIN CERTIFICATE-----\nMIIFZjCCA06gAwIBAgIIP61/1qm/uDowDQYJKoZIhvcNAQELBQE\n-----END CERTIFICATE-----'
- '-----BEGIN CERTIFICATE-----\nBhMCRVMxFDASBgNVBAoMC1N0YXJ0Q29tIENBMSwwKgYDVn-----END CERTIFICATE-----'
console:
allOf:
- $ref: '#/components/schemas/remote_syslog_console2'
- description: Log forwarding filters for console messages sent to remote syslog
enabled:
type: boolean
description: Whether remote syslog forwarding is enabled
default: false
files:
type: array
items:
$ref: '#/components/schemas/remote_syslog_file_config'
description: Local syslog file definitions to generate and forward
network:
type: string
description: Source network used for syslog traffic. If `source_address` is configured, Mist uses the VLAN first; otherwise it uses `source_ip`
examples:
- default
send_to_all_servers:
type: boolean
description: Whether each log entry is sent to all configured remote syslog servers
default: false
servers:
type: array
items:
$ref: '#/components/schemas/remote_syslog_server'
description: Remote syslog server destinations
examples:
- - facility: config
host: syslogd.internal
port: 514
protocol: udp
severity: info
tag: ''
time_format:
allOf:
- $ref: '#/components/schemas/remote_syslog_time_format2'
- description: 'Timestamp format used in forwarded syslog messages. enum: `millisecond`, `year`, `year millisecond`.'
examples:
- millisecond
users:
type: array
items:
$ref: '#/components/schemas/remote_syslog_user'
description: User-specific syslog logging rules
description: Remote syslog defaults provided by this switch profile
remote_syslog2:
title: remote_syslog2
type: object
properties:
archive:
allOf:
- $ref: '#/components/schemas/remote_syslog_archive3'
- description: Retention settings for generated syslog archive files
cacerts:
type: array
items:
type: string
description: CA certificates used to verify TLS syslog servers
examples:
- - '-----BEGIN CERTIFICATE-----\nMIIFZjCCA06gAwIBAgIIP61/1qm/uDowDQYJKoZIhvcNAQELBQE\n-----END CERTIFICATE-----'
- '-----BEGIN CERTIFICATE-----\nBhMCRVMxFDASBgNVBAoMC1N0YXJ0Q29tIENBMSwwKgYDVn-----END CERTIFICATE-----'
console:
allOf:
- $ref: '#/components/schemas/remote_syslog_console2'
- description: Log forwarding filters for console messages sent to remote syslog
enabled:
type: boolean
description: Whether remote syslog forwarding is enabled
default: false
files:
type: array
items:
$ref: '#/components/schemas/remote_syslog_file_config'
description: Local syslog file definitions to generate and forward
network:
type: string
description: Source network used for syslog traffic. If `source_address` is configured, Mist uses the VLAN first; otherwise it uses `source_ip`
examples:
- default
send_to_all_servers:
type: boolean
description: Whether each log entry is sent to all configured remote syslog servers
default: false
servers:
type: array
items:
$ref: '#/components/schemas/remote_syslog_server'
description: Remote syslog server destinations
examples:
- - facility: config
host: syslogd.internal
port: 514
protocol: udp
severity: info
tag: ''
time_format:
allOf:
- $ref: '#/components/schemas/remote_syslog_time_format2'
- description: 'Timestamp format used in forwarded syslog messages. enum: `millisecond`, `year`, `year millisecond`.'
examples:
- millisecond
users:
type: array
items:
$ref: '#/components/schemas/remote_syslog_user'
description: User-specific syslog logging rules
description: Remote syslog defaults provided by this network template
remote_syslog4:
title: remote_syslog4
type: object
properties:
archive:
allOf:
- $ref: '#/components/schemas/remote_syslog_archive3'
- description: Retention settings for generated syslog archive files
cacerts:
type: array
items:
type: string
description: CA certificates used to verify TLS syslog servers
examples:
- - '-----BEGIN CERTIFICATE-----\nMIIFZjCCA06gAwIBAgIIP61/1qm/uDowDQYJKoZIhvcNAQELBQE\n-----END CERTIFICATE-----'
- '-----BEGIN CERTIFICATE-----\nBhMCRVMxFDASBgNVBAoMC1N0YXJ0Q29tIENBMSwwKgYDVn-----END CERTIFICATE-----'
console:
allOf:
- $ref: '#/components/schemas/remote_syslog_console2'
- description: Log forwarding filters for console messages sent to remote syslog
enabled:
type: boolean
description: Whether remote syslog forwarding is enabled
default: false
files:
type: array
items:
$ref: '#/components/schemas/remote_syslog_file_config'
description: Local syslog file definitions to generate and forward
network:
type: string
description: Source network used for syslog traffic. If `source_address` is configured, Mist uses the VLAN first; otherwise it uses `source_ip`
examples:
- default
send_to_all_servers:
type: boolean
description: Whether each log entry is sent to all configured remote syslog servers
default: false
servers:
type: array
items:
$ref: '#/components/schemas/remote_syslog_server'
description: Remote syslog server destinations
examples:
- - facility: config
host: syslogd.internal
port: 514
protocol: udp
severity: info
tag: ''
time_format:
allOf:
- $ref: '#/components/schemas/remote_syslog_time_format2'
- description: 'Timestamp format used in forwarded syslog messages. enum: `millisecond`, `year`, `year millisecond`.'
examples:
- millisecond
users:
type: array
items:
$ref: '#/components/schemas/remote_syslog_user'
description: User-specific syslog logging rules
description: Syslog forwarding settings for devices at the site
remote_syslog5:
title: remote_syslog5
type: object
properties:
archive:
allOf:
- $ref: '#/components/schemas/remote_syslog_archive3'
- description: Retention settings for generated syslog archive files
cacerts:
type: array
items:
type: string
description: CA certificates used to verify TLS syslog servers
examples:
- - '-----BEGIN CERTIFICATE-----\nMIIFZjCCA06gAwIBAgIIP61/1qm/uDowDQYJKoZIhvcNAQELBQE\n-----END CERTIFICATE-----'
- '-----BEGIN CERTIFICATE-----\nBhMCRVMxFDASBgNVBAoMC1N0YXJ0Q29tIENBMSwwKgYDVn-----END CERTIFICATE-----'
console:
allOf:
- $ref: '#/components/schemas/remote_syslog_console2'
- description: Log forwarding filters for console messages sent to remote syslog
enabled:
type: boolean
description: Whether remote syslog forwarding is enabled
default: false
files:
type: array
items:
$ref: '#/components/schemas/remote_syslog_file_config'
description: Local syslog file definitions to generate and forward
network:
type: string
description: Source network used for syslog traffic. If `source_address` is configured, Mist uses the VLAN first; otherwise it uses `source_ip`
examples:
- default
send_to_all_servers:
type: boolean
description: Whether each log entry is sent to all configured remote syslog servers
default: false
servers:
type: array
items:
$ref: '#/components/schemas/remote_syslog_server'
description: Remote syslog server destinations
examples:
- - facility: config
host: syslogd.internal
port: 514
protocol: udp
severity: info
tag: ''
time_format:
allOf:
- $ref: '#/components/schemas/remote_syslog_time_format2'
- description: 'Timestamp format used in forwarded syslog messages. enum: `millisecond`, `year`, `year millisecond`.'
examples:
- millisecond
users:
type: array
items:
$ref: '#/components/schemas/remote_syslog_user'
description: User-specific syslog logging rules
description: Remote syslog settings for this switch
response_async_license_status1:
title: response_async_license_status1
enum:
- prepared
- ongoing
- done
type: string
description: 'Current asynchronous license claim processing state. enum: `prepared`, `ongoing`, `done`.'
response_async_license_status3:
title: response_async_license_status3
enum:
- prepared
- ongoing
- done
type: string
description: 'Current async claim processing state. enum: `prepared`, `ongoing`, `done`.'
response_auto_map_assignment_info_status2:
title: response_auto_map_assignment_info_status2
enum:
- not_started
- in_progress
- completed
- error
type: string
description: 'Current auto map assignment processing state. enum: `not_started`, `in_progress`, `completed`, `error`.'
response_auto_orientation_info_status2:
title: response_auto_orientation_info_status2
enum:
- pending
- inprogress
- done
- error
type: string
description: 'Current auto orientation processing state. enum: `pending`, `inprogress`, `done`, `error`.'
response_auto_zone_status2:
title: response_auto_zone_status2
enum:
- in_progress
- awaiting_review
- not_started
- error
type: string
description: 'Current auto zones service state for the map. enum: `in_progress`, `awaiting_review`, `not_started`, `error`.'
response_map_import_ap_action2:
title: response_map_import_ap_action2
enum:
- assigned-named-placed
- assigned-placed
- ignored
- named-placed
- placed
type: string
description: 'Import action applied to this AP. enum: `assigned-named-placed`, `assigned-placed`, `ignored`, `named-placed`, `placed`.'
response_org_inventory_change_op2:
title: response_org_inventory_change_op2
enum:
- assign
- delete
- downgrade_to_jsi
- unassign
- upgrade_to_mist
type: string
description: 'Inventory operation applied to the requested device identifiers. enum: `assign`, `delete`, `downgrade_to_jsi`, `unassign`, `upgrade_to_mist`.'
response_switch_metrics_active_ports_summary2:
title: response_switch_metrics_active_ports_summary2
type: object
properties:
details:
allOf:
- $ref: '#/components/schemas/switch_metrics_active_ports_summary_details2'
- description: Port counts used to calculate the active-port summary metric
score:
type: integer
description: Reported metric score for active switch ports
contentEncoding: int32
total_switch_count:
type: integer
description: Number of switches included in the active-port summary metric
contentEncoding: int32
description: Summary metric for active switch ports
response_switch_metrics_config_success_details2:
title: response_switch_metrics_config_success_details2
type: object
properties:
config_success_count:
type: integer
description: Number of switches with successful configuration status
contentEncoding: int32
description: Configuration success counts used to calculate the metric
response_switch_metrics_version_compliance_details2:
title: response_switch_metrics_version_compliance_details2
type: object
properties:
major_versions:
type: array
items:
$ref: '#/components/schemas/switch_metrics_compliance_major_version'
description: Software version groupings found among the evaluated switches
description: Version groupings used to calculate the compliance metric
response_switch_metrics_version_compliance2:
title: response_switch_metrics_version_compliance2
type: object
properties:
details:
allOf:
- $ref: '#/components/schemas/response_switch_metrics_version_compliance_details2'
- description: Version groupings used to calculate the compliance metric
score:
type: integer
description: Reported metric score for switch software version compliance
contentEncoding: int32
total_switch_count:
type: integer
description: Number of switches included in the version compliance metric
contentEncoding: int32
description: Software version compliance metric for switches in the requested scope
rf_client_type1:
title: rf_client_type1
enum:
- asset
- client
- sdkclient
type: string
description: 'Target device category for the RF diagnostic recording. enum: `asset`, `client`, `sdkclient`.'
rf_client_type2:
title: rf_client_type2
enum:
- asset
- client
- sdkclient
type: string
description: 'Target device category for the recording. enum: `asset`, `client`, `sdkclient`.'
rftemplate_radio_band51:
title: rftemplate_radio_band51
type: object
properties:
allow_rrm_disable:
type: boolean
description: Whether RRM may disable the 5 GHz radio when optimizing RF settings
default: false
ant_gain:
maximum: 10
minimum: 0
type:
- integer
- 'null'
description: External antenna gain for the 5 GHz radio
contentEncoding: int32
default: 0
antenna_mode:
allOf:
- $ref: '#/components/schemas/radio_band_antenna_mode1'
- description: 'Radio chain mode for the 5 GHz radio. enum: `1x1`, `2x2`, `3x3`, `4x4`, `default`.'
examples:
- default
bandwidth:
allOf:
- $ref: '#/components/schemas/dot11_bandwidth52'
- description: 'Channel width configured for the 5 GHz radio. enum: `0`, `20`, `40`, `80`.'
examples:
- 40
channels:
type:
- array
- 'null'
items:
type: integer
contentEncoding: int32
description: Allowed channel list for the 5 GHz radio; null or an empty array uses automatic selection
default: []
disabled:
type: boolean
description: Whether to disable the radio
default: false
power:
maximum: 25
minimum: 0
type:
- integer
- 'null'
description: Radio Tx power, in dBm. Can be an integer 0-25 for static power configuration, or `null` or unset for auto power mode
contentEncoding: int32
examples:
- 6
power_max:
maximum: 17
minimum: 5
type:
- integer
- 'null'
description: When power=null/unset, max tx power to use, HW-specific values will be used if not set
contentEncoding: int32
power_min:
maximum: 17
minimum: 5
type:
- integer
- 'null'
description: When power=null/unset, min tx power to use, HW-specific values will be used if not set
contentEncoding: int32
preamble:
allOf:
- $ref: '#/components/schemas/radio_band_preamble1'
- description: '802.11 preamble mode used by the 5 GHz radio. enum: `auto`, `long`, `short`.'
description: 5 GHz settings used when the 2.4 GHz radio operates in 5 GHz mode
rftemplate_radio_band52:
title: rftemplate_radio_band52
type: object
properties:
allow_rrm_disable:
type: boolean
description: Whether RRM may disable the 5 GHz radio when optimizing RF settings
default: false
ant_gain:
maximum: 10
minimum: 0
type:
- integer
- 'null'
description: External antenna gain for the 5 GHz radio
contentEncoding: int32
default: 0
antenna_mode:
allOf:
- $ref: '#/components/schemas/radio_band_antenna_mode1'
- description: 'Radio chain mode for the 5 GHz radio. enum: `1x1`, `2x2`, `3x3`, `4x4`, `default`.'
examples:
- default
bandwidth:
allOf:
- $ref: '#/components/schemas/dot11_bandwidth52'
- description: 'Channel width configured for the 5 GHz radio. enum: `0`, `20`, `40`, `80`.'
examples:
- 40
channels:
type:
- array
- 'null'
items:
type: integer
contentEncoding: int32
description: Allowed channel list for the 5 GHz radio; null or an empty array uses automatic selection
default: []
disabled:
type: boolean
description: Whether to disable the radio
default: false
power:
maximum: 25
minimum: 0
type:
- integer
- 'null'
description: Radio Tx power, in dBm. Can be an integer 0-25 for static power configuration, or `null` or unset for auto power mode
contentEncoding: int32
examples:
- 6
power_max:
maximum: 17
minimum: 5
type:
- integer
- 'null'
description: When power=null/unset, max tx power to use, HW-specific values will be used if not set
contentEncoding: int32
power_min:
maximum: 17
minimum: 5
type:
- integer
- 'null'
description: When power=null/unset, min tx power to use, HW-specific values will be used if not set
contentEncoding: int32
preamble:
allOf:
- $ref: '#/components/schemas/radio_band_preamble1'
- description: '802.11 preamble mode used by the 5 GHz radio. enum: `auto`, `long`, `short`.'
description: Model-specific 5 GHz radio settings that override RF template defaults
rftemplate_radio_band53:
title: rftemplate_radio_band53
type: object
properties:
allow_rrm_disable:
type: boolean
description: Whether RRM may disable the 5 GHz radio when optimizing RF settings
default: false
ant_gain:
maximum: 10
minimum: 0
type:
- integer
- 'null'
description: External antenna gain for the 5 GHz radio
contentEncoding: int32
default: 0
antenna_mode:
allOf:
- $ref: '#/components/schemas/radio_band_antenna_mode1'
- description: 'Radio chain mode for the 5 GHz radio. enum: `1x1`, `2x2`, `3x3`, `4x4`, `default`.'
examples:
- default
bandwidth:
allOf:
- $ref: '#/components/schemas/dot11_bandwidth52'
- description: 'Channel width configured for the 5 GHz radio. enum: `0`, `20`, `40`, `80`.'
examples:
- 40
channels:
type:
- array
- 'null'
items:
type: integer
contentEncoding: int32
description: Allowed channel list for the 5 GHz radio; null or an empty array uses automatic selection
default: []
disabled:
type: boolean
description: Whether to disable the radio
default: false
power:
maximum: 25
minimum: 0
type:
- integer
- 'null'
description: Radio Tx power, in dBm. Can be an integer 0-25 for static power configuration, or `null` or unset for auto power mode
contentEncoding: int32
examples:
- 6
power_max:
maximum: 17
minimum: 5
type:
- integer
- 'null'
description: When power=null/unset, max tx power to use, HW-specific values will be used if not set
contentEncoding: int32
power_min:
maximum: 17
minimum: 5
type:
- integer
- 'null'
description: When power=null/unset, min tx power to use, HW-specific values will be used if not set
contentEncoding: int32
preamble:
allOf:
- $ref: '#/components/schemas/radio_band_preamble1'
- description: '802.11 preamble mode used by the 5 GHz radio. enum: `auto`, `long`, `short`.'
description: Model-specific 5 GHz settings used when the 2.4 GHz radio operates in 5 GHz mode
rftemplate_radio_band55:
title: rftemplate_radio_band55
type: object
properties:
allow_rrm_disable:
type: boolean
description: Whether RRM may disable the 5 GHz radio when optimizing RF settings
default: false
ant_gain:
maximum: 10
minimum: 0
type:
- integer
- 'null'
description: External antenna gain for the 5 GHz radio
contentEncoding: int32
default: 0
antenna_mode:
allOf:
- $ref: '#/components/schemas/radio_band_antenna_mode1'
- description: 'Radio chain mode for the 5 GHz radio. enum: `1x1`, `2x2`, `3x3`, `4x4`, `default`.'
examples:
- default
bandwidth:
allOf:
- $ref: '#/components/schemas/dot11_bandwidth52'
- description: 'Channel width configured for the 5 GHz radio. enum: `0`, `20`, `40`, `80`.'
examples:
- 40
channels:
type:
- array
- 'null'
items:
type: integer
contentEncoding: int32
description: Allowed channel list for the 5 GHz radio; null or an empty array uses automatic selection
default: []
disabled:
type: boolean
description: Whether to disable the radio
default: false
power:
maximum: 25
minimum: 0
type:
- integer
- 'null'
description: Radio Tx power, in dBm. Can be an integer 0-25 for static power configuration, or `null` or unset for auto power mode
contentEncoding: int32
examples:
- 6
power_max:
maximum: 17
minimum: 5
type:
- integer
- 'null'
description: When power=null/unset, max tx power to use, HW-specific values will be used if not set
contentEncoding: int32
power_min:
maximum: 17
minimum: 5
type:
- integer
- 'null'
description: When power=null/unset, min tx power to use, HW-specific values will be used if not set
contentEncoding: int32
preamble:
allOf:
- $ref: '#/components/schemas/radio_band_preamble1'
- description: '802.11 preamble mode used by the 5 GHz radio. enum: `auto`, `long`, `short`.'
description: 5 GHz radio settings in this RF template
rftemplate_radio_band61:
title: rftemplate_radio_band61
type: object
properties:
allow_rrm_disable:
type: boolean
description: Whether RRM may disable the 6 GHz radio when optimizing RF settings
default: false
ant_gain:
maximum: 10
minimum: 0
type:
- integer
- 'null'
description: External antenna gain for the 6 GHz radio
contentEncoding: int32
default: 0
antenna_mode:
allOf:
- $ref: '#/components/schemas/radio_band_antenna_mode2'
- description: 'Radio chain mode for the 6 GHz radio. enum: `1x1`, `2x2`, `3x3`, `4x4`, `default`.'
examples:
- default
bandwidth:
allOf:
- $ref: '#/components/schemas/dot11_bandwidth62'
- description: 'Channel width configured for the 6 GHz radio. enum: `0`, `20`, `40`, `80`, `160`.'
examples:
- 80
channels:
type:
- array
- 'null'
items:
type: integer
contentEncoding: int32
description: Allowed channel list for the 6 GHz radio; null or an empty array uses automatic selection
default: []
disabled:
type: boolean
description: Whether to disable the radio
default: false
power:
maximum: 25
minimum: 0
type:
- integer
- 'null'
description: Radio Tx power, in dBm. Can be an integer 0-25 for static power configuration, or `null` or unset for auto power mode
contentEncoding: int32
examples:
- 7
power_max:
maximum: 17
minimum: 5
type:
- integer
- 'null'
description: When power=null/unset, max tx power to use, HW-specific values will be used if not set
contentEncoding: int32
power_min:
maximum: 18
minimum: 5
type:
- integer
- 'null'
description: When power=null/unset, min tx power to use, HW-specific values will be used if not set
contentEncoding: int32
preamble:
allOf:
- $ref: '#/components/schemas/radio_band_preamble2'
- description: '802.11 preamble mode used by the 6 GHz radio. enum: `auto`, `long`, `short`.'
standard_power:
type: boolean
description: For 6GHz Only, standard-power operation, AFC (Automatic Frequency Coordination) will be performed, and we'll fall back to Low Power Indoor if AFC failed
default: false
description: Model-specific 6 GHz radio settings that override RF template defaults
rftemplate_radio_band63:
title: rftemplate_radio_band63
type: object
properties:
allow_rrm_disable:
type: boolean
description: Whether RRM may disable the 6 GHz radio when optimizing RF settings
default: false
ant_gain:
maximum: 10
minimum: 0
type:
- integer
- 'null'
description: External antenna gain for the 6 GHz radio
contentEncoding: int32
default: 0
antenna_mode:
allOf:
- $ref: '#/components/schemas/radio_band_antenna_mode2'
- description: 'Radio chain mode for the 6 GHz radio. enum: `1x1`, `2x2`, `3x3`, `4x4`, `default`.'
examples:
- default
bandwidth:
allOf:
- $ref: '#/components/schemas/dot11_bandwidth62'
- description: 'Channel width configured for the 6 GHz radio. enum: `0`, `20`, `40`, `80`, `160`.'
examples:
- 80
channels:
type:
- array
- 'null'
items:
type: integer
contentEncoding: int32
description: Allowed channel list for the 6 GHz radio; null or an empty array uses automatic selection
default: []
disabled:
type: boolean
description: Whether to disable the radio
default: false
power:
maximum: 25
minimum: 0
type:
- integer
- 'null'
description: Radio Tx power, in dBm. Can be an integer 0-25 for static power configuration, or `null` or unset for auto power mode
contentEncoding: int32
examples:
- 7
power_max:
maximum: 17
minimum: 5
type:
- integer
- 'null'
description: When power=null/unset, max tx power to use, HW-specific values will be used if not set
contentEncoding: int32
power_min:
maximum: 18
minimum: 5
type:
- integer
- 'null'
description: When power=null/unset, min tx power to use, HW-specific values will be used if not set
contentEncoding: int32
preamble:
allOf:
- $ref: '#/components/schemas/radio_band_preamble2'
- description: '802.11 preamble mode used by the 6 GHz radio. enum: `auto`, `long`, `short`.'
standard_power:
type: boolean
description: For 6GHz Only, standard-power operation, AFC (Automatic Frequency Coordination) will be performed, and we'll fall back to Low Power Indoor if AFC failed
default: false
description: 6 GHz radio settings in this RF template
rftemplate_radio_band241:
title: rftemplate_radio_band241
type: object
properties:
allow_rrm_disable:
type: boolean
description: Whether RRM may disable the 2.4 GHz radio when optimizing RF settings
default: false
ant_gain:
maximum: 10
minimum: 0
type:
- integer
- 'null'
description: External antenna gain for the 2.4 GHz radio
contentEncoding: int32
default: 0
antenna_mode:
allOf:
- $ref: '#/components/schemas/radio_band_antenna_mode4'
- description: 'Radio chain mode for the 2.4 GHz radio. enum: `1x1`, `2x2`, `3x3`, `4x4`, `default`.'
examples:
- default
bandwidth:
allOf:
- $ref: '#/components/schemas/dot11_bandwidth242'
- description: 'Channel width configured for the 2.4 GHz radio. enum: `0`, `20`, `40`.'
examples:
- 20
channels:
type:
- array
- 'null'
items:
type: integer
contentEncoding: int32
description: Allowed channel list for the 2.4 GHz radio; null or an empty array uses automatic selection
default: []
disabled:
type: boolean
description: Whether to disable the radio
default: false
power:
maximum: 25
minimum: 0
type:
- integer
- 'null'
description: Radio Tx power, in dBm. Can be an integer 0-25 for static power configuration, or `null` or unset for auto power mode
contentEncoding: int32
examples:
- 3
power_max:
maximum: 18
minimum: 3
type:
- integer
- 'null'
description: When power=null/unset, max tx power to use, HW-specific values will be used if not set
contentEncoding: int32
power_min:
maximum: 18
minimum: 3
type:
- integer
- 'null'
description: When power=null/unset, min tx power to use, HW-specific values will be used if not set
contentEncoding: int32
preamble:
allOf:
- $ref: '#/components/schemas/radio_band_preamble4'
- description: '802.11 preamble mode used by the 2.4 GHz radio. enum: `auto`, `long`, `short`.'
description: Model-specific 2.4 GHz radio settings that override RF template defaults
rftemplate_radio_band243:
title: rftemplate_radio_band243
type: object
properties:
allow_rrm_disable:
type: boolean
description: Whether RRM may disable the 2.4 GHz radio when optimizing RF settings
default: false
ant_gain:
maximum: 10
minimum: 0
type:
- integer
- 'null'
description: External antenna gain for the 2.4 GHz radio
contentEncoding: int32
default: 0
antenna_mode:
allOf:
- $ref: '#/components/schemas/radio_band_antenna_mode4'
- description: 'Radio chain mode for the 2.4 GHz radio. enum: `1x1`, `2x2`, `3x3`, `4x4`, `default`.'
examples:
- default
bandwidth:
allOf:
- $ref: '#/components/schemas/dot11_bandwidth242'
- description: 'Channel width configured for the 2.4 GHz radio. enum: `0`, `20`, `40`.'
examples:
- 20
channels:
type:
- array
- 'null'
items:
type: integer
contentEncoding: int32
description: Allowed channel list for the 2.4 GHz radio; null or an empty array uses automatic selection
default: []
disabled:
type: boolean
description: Whether to disable the radio
default: false
power:
maximum: 25
minimum: 0
type:
- integer
- 'null'
description: Radio Tx power, in dBm. Can be an integer 0-25 for static power configuration, or `null` or unset for auto power mode
contentEncoding: int32
examples:
- 3
power_max:
maximum: 18
minimum: 3
type:
- integer
- 'null'
description: When power=null/unset, max tx power to use, HW-specific values will be used if not set
contentEncoding: int32
power_min:
maximum: 18
minimum: 3
type:
- integer
- 'null'
description: When power=null/unset, min tx power to use, HW-specific values will be used if not set
contentEncoding: int32
preamble:
allOf:
- $ref: '#/components/schemas/radio_band_preamble4'
- description: '802.11 preamble mode used by the 2.4 GHz radio. enum: `auto`, `long`, `short`.'
description: 2.4 GHz radio settings in this RF template
route_summary_stats1:
title: route_summary_stats1
type: object
properties:
fib_routes:
type: integer
description: Number of routes installed in the forwarding information base
contentEncoding: int32
max_unicast_routes_supported:
type: integer
description: Supported maximum number of unicast routes
contentEncoding: int32
rib_routes:
type: integer
description: Number of routes present in the routing information base
contentEncoding: int32
total_routes:
type: integer
description: Aggregate number of routes reported by the device
contentEncoding: int32
description: Route table summary statistics for the switch
route_summary_stats2:
title: route_summary_stats2
type: object
properties:
fib_routes:
type: integer
description: Number of routes installed in the forwarding information base
contentEncoding: int32
max_unicast_routes_supported:
type: integer
description: Supported maximum number of unicast routes
contentEncoding: int32
rib_routes:
type: integer
description: Number of routes present in the routing information base
contentEncoding: int32
total_routes:
type: integer
description: Aggregate number of routes reported by the device
contentEncoding: int32
description: Route table summary statistics for the gateway
rrm_band_metric1:
title: rrm_band_metric1
required:
- cochannel_neighbors
- density
- neighbors
- noise
type: object
properties:
avg_aps_per_channel:
type: number
description: Average number of APs per channel
channel_distribution_uniformity:
type: number
description: Distribution of channel across the Access Points
cochannel_neighbors:
type: number
description: Average number of co-channel neighbors
density:
maximum: 1
minimum: 0
type: number
description: defined by how APs can hear from one and another, 0 - 1 (everyone can hear everyone)
interferences:
type: object
additionalProperties:
$ref: '#/components/schemas/rrm_band_metric_interference'
description: Property key is the channel number
examples:
- '149':
radar: 0.3
'153':
radar: 0.2
naps_by_channel:
type: object
additionalProperties:
type: number
description: Number of APs grouped by channel for this band
naps_by_power:
type: object
additionalProperties:
type: number
description: Number of APs grouped by transmit power for this band
neighbors:
type: number
description: Average number of neighbors
noise:
type: number
description: Average noise in dBm
description: Aggregate RRM metrics for the 5 GHz band
rrm_band_metric2:
title: rrm_band_metric2
required:
- cochannel_neighbors
- density
- neighbors
- noise
type: object
properties:
avg_aps_per_channel:
type: number
description: Average number of APs per channel
channel_distribution_uniformity:
type: number
description: Distribution of channel across the Access Points
cochannel_neighbors:
type: number
description: Average number of co-channel neighbors
density:
maximum: 1
minimum: 0
type: number
description: defined by how APs can hear from one and another, 0 - 1 (everyone can hear everyone)
interferences:
type: object
additionalProperties:
$ref: '#/components/schemas/rrm_band_metric_interference'
description: Property key is the channel number
examples:
- '149':
radar: 0.3
'153':
radar: 0.2
naps_by_channel:
type: object
additionalProperties:
type: number
description: Number of APs grouped by channel for this band
naps_by_power:
type: object
additionalProperties:
type: number
description: Number of APs grouped by transmit power for this band
neighbors:
type: number
description: Average number of neighbors
noise:
type: number
description: Average noise in dBm
description: Aggregate RRM metrics for the 6 GHz band
rrm_band_metric4:
title: rrm_band_metric4
required:
- cochannel_neighbors
- density
- neighbors
- noise
type: object
properties:
avg_aps_per_channel:
type: number
description: Average number of APs per channel
channel_distribution_uniformity:
type: number
description: Distribution of channel across the Access Points
cochannel_neighbors:
type: number
description: Average number of co-channel neighbors
density:
maximum: 1
minimum: 0
type: number
description: defined by how APs can hear from one and another, 0 - 1 (everyone can hear everyone)
interferences:
type: object
additionalProperties:
$ref: '#/components/schemas/rrm_band_metric_interference'
description: Property key is the channel number
examples:
- '149':
radar: 0.3
'153':
radar: 0.2
naps_by_channel:
type: object
additionalProperties:
type: number
description: Number of APs grouped by channel for this band
naps_by_power:
type: object
additionalProperties:
type: number
description: Number of APs grouped by transmit power for this band
neighbors:
type: number
description: Average number of neighbors
noise:
type: number
description: Average noise in dBm
description: Aggregate RRM metrics for the 2.4 GHz band
rrm_event_pre_bandwidth2:
title: rrm_event_pre_bandwidth2
enum:
- 0
- 20
- 40
- 80
- 160
type: integer
description: 'Channel width before the RRM event, in MHz. enum: `0`, `20`, `40`, `80`, `160`.'
rrm_event_type2:
title: rrm_event_type2
enum:
- interference-ap-co-channel
- interference-ap-non-wifi
- neighbor-ap-down
- neighbor-ap-recovered
- radar-detected
- rrm-radar
- scheduled-site_rrm
- triggered-site_rrm
type: string
description: 'RRM event type that caused or records the change. enum: `interference-ap-co-channel`, `interference-ap-non-wifi`, `neighbor-ap-down`, `neighbor-ap-recovered`, `radar-detected`, `rrm-radar`, `scheduled-site_rrm`, `triggered-site_rrm`.'
rrm_status2:
title: rrm_status2
enum:
- ready
- unknown
- updating
type: string
description: 'Current RRM calculation status. enum: `ready`, `unknown`, `updating`.'
scan_data_item_band1:
title: scan_data_item_band1
enum:
- '2.4'
- '5'
type: string
description: 'Radio band on which the SDK client scanned the BSSID. enum: `2.4`, `5`.'
secintel_profile_profile_action2:
title: secintel_profile_profile_action2
enum:
- default
- standard
- strict
type: string
description: 'Protection level applied to the SecIntel category. enum: `default`, `standard`, `strict`.'
secintel_profile_profile_category2:
title: secintel_profile_profile_category2
enum:
- CC
- DNS
- IH
type: string
description: 'SecIntel feed category configured by this profile entry. enum: `CC`, `DNS`, `IH`.'
service_failover_policy2:
title: service_failover_policy2
enum:
- non_revertible
- none
- revertible
type: string
description: 'Failover behavior for traffic matched by this service. enum: `non_revertible`, `none`, `revertible`.'
service_policy_aamw_profile2:
title: service_policy_aamw_profile2
enum:
- docsonly
- executables
- standard
type: string
description: 'Built-in advanced anti-malware inspection profile to apply. enum: `docsonly`, `executables`, `standard`.'
service_policy_aamw2:
title: service_policy_aamw2
type: object
properties:
aamwprofile_id:
type: string
description: Organization-level advanced anti-malware profile ID; takes precedence over inline `profile` settings
contentEncoding: uuid
enabled:
type: boolean
description: Whether advanced anti-malware inspection is enabled for the service policy
default: false
profile:
allOf:
- $ref: '#/components/schemas/service_policy_aamw_profile2'
- description: 'Built-in advanced anti-malware inspection profile to apply. enum: `docsonly`, `executables`, `standard`.'
description: Advanced anti-malware settings applied by this service policy
service_policy_antivirus1:
title: service_policy_antivirus1
type: object
properties:
avprofile_id:
type: string
description: Organization-level antivirus profile ID; takes precedence over inline `profile` settings
contentEncoding: uuid
enabled:
type: boolean
description: Whether antivirus inspection is enabled for the service policy
default: false
profile:
type: string
description: Antivirus profile name to apply, such as `default`, `noftp`, `httponly`, or an AV profile key
description: Malware and virus inspection settings applied by this service policy
service_policy_appqoe1:
title: service_policy_appqoe1
type: object
properties:
enabled:
type: boolean
description: Whether application QoE is enabled for the service policy
default: false
description: Application QoE settings applied by this service policy
service_policy_ewf_rule_profile2:
title: service_policy_ewf_rule_profile2
enum:
- critical
- standard
- strict
type: string
description: 'Enhanced web filtering profile applied by this rule. enum: `critical`, `standard`, `strict`.'
service_policy_secintel_profile2:
title: service_policy_secintel_profile2
enum:
- default
- standard
- strict
type: string
description: 'Protection level applied by SecIntel inspection. enum: `default`, `standard`, `strict`.'
service_policy_secintel1:
title: service_policy_secintel1
type: object
properties:
enabled:
type: boolean
description: Whether SecIntel inspection is enabled for the service policy
default: false
profile:
allOf:
- $ref: '#/components/schemas/service_policy_secintel_profile2'
- description: 'Protection level applied by SecIntel inspection. enum: `default`, `standard`, `strict`.'
secintelprofile_id:
type: string
description: Organization-level SecIntel profile ID; takes precedence over inline `profile` settings
description: Juniper SecIntel threat intelligence settings applied by this service policy
service_policy_secintel3:
title: service_policy_secintel3
type: object
properties:
enabled:
type: boolean
description: Whether SecIntel inspection is enabled for the service policy
default: false
profile:
allOf:
- $ref: '#/components/schemas/service_policy_secintel_profile2'
- description: 'Protection level applied by SecIntel inspection. enum: `default`, `standard`, `strict`.'
secintelprofile_id:
type: string
description: Organization-level SecIntel profile ID; takes precedence over inline `profile` settings
description: Threat intelligence settings applied by this service policy
service_policy_skyatp_dns_dga_detection_profile2:
title: service_policy_skyatp_dns_dga_detection_profile2
enum:
- default
- standard
- strict
type: string
description: 'Sky ATP DNS DGA detection profile to apply. enum: `default`, `standard`, `strict`.'
service_policy_skyatp_dns_dga_detection2:
title: service_policy_skyatp_dns_dga_detection2
type: object
properties:
enabled:
type: boolean
description: Whether Sky ATP DNS DGA detection is enabled
profile:
allOf:
- $ref: '#/components/schemas/service_policy_skyatp_dns_dga_detection_profile2'
- description: 'Sky ATP DNS DGA detection profile to apply. enum: `default`, `standard`, `strict`.'
description: Detection settings for DNS DGA threats provided by Sky ATP
service_policy_skyatp_dns_tunnel_detection_profile2:
title: service_policy_skyatp_dns_tunnel_detection_profile2
enum:
- default
- standard
- strict
type: string
description: 'Sky ATP DNS tunneling detection profile to apply. enum: `default`, `standard`, `strict`.'
service_policy_skyatp_dns_tunnel_detection2:
title: service_policy_skyatp_dns_tunnel_detection2
type: object
properties:
enabled:
type: boolean
description: Whether Sky ATP DNS tunneling detection is enabled
profile:
allOf:
- $ref: '#/components/schemas/service_policy_skyatp_dns_tunnel_detection_profile2'
- description: 'Sky ATP DNS tunneling detection profile to apply. enum: `default`, `standard`, `strict`.'
description: Detection settings for DNS tunneling threats provided by Sky ATP
service_policy_skyatp_http_inspection_profile2:
title: service_policy_skyatp_http_inspection_profile2
enum:
- standard
- strict
type: string
description: 'Sky ATP HTTP inspection profile to apply. enum: `standard`, `strict`.'
service_policy_skyatp_http_inspection2:
title: service_policy_skyatp_http_inspection2
type: object
properties:
enabled:
type: boolean
description: Whether Sky ATP HTTP inspection is enabled
profile:
allOf:
- $ref: '#/components/schemas/service_policy_skyatp_http_inspection_profile2'
- description: 'Sky ATP HTTP inspection profile to apply. enum: `standard`, `strict`.'
description: Web traffic inspection settings provided by Sky ATP
service_policy_skyatp_iot_device_policy2:
title: service_policy_skyatp_iot_device_policy2
type: object
properties:
enabled:
type: boolean
description: Whether Sky ATP IoT device policy inspection is enabled
description: Device threat policy settings provided by Sky ATP for IoT clients
service_policy_skyatp2:
title: service_policy_skyatp2
type: object
properties:
dns_dga_detection:
allOf:
- $ref: '#/components/schemas/service_policy_skyatp_dns_dga_detection2'
- description: Detection settings for DNS DGA threats provided by Sky ATP
dns_tunnel_detection:
allOf:
- $ref: '#/components/schemas/service_policy_skyatp_dns_tunnel_detection2'
- description: Detection settings for DNS tunneling threats provided by Sky ATP
http_inspection:
allOf:
- $ref: '#/components/schemas/service_policy_skyatp_http_inspection2'
- description: Web traffic inspection settings provided by Sky ATP
iot_device_policy:
allOf:
- $ref: '#/components/schemas/service_policy_skyatp_iot_device_policy2'
- description: Device threat policy settings provided by Sky ATP for IoT clients
description: Threat inspection settings provided by Sky ATP for this service policy
service_policy_ssl_proxy1:
title: service_policy_ssl_proxy1
type: object
properties:
ciphers_category:
allOf:
- $ref: '#/components/schemas/ssl_proxy_ciphers_category2'
- description: 'Allowed cipher strength category for SSL proxy inspection. enum: `medium`, `strong`, `weak`.'
enabled:
type: boolean
description: Whether SSL proxy inspection is enabled for the service policy
default: false
description: SSL proxy inspection settings applied by this service policy
service_policy_ssl_proxy3:
title: service_policy_ssl_proxy3
type: object
properties:
ciphers_category:
allOf:
- $ref: '#/components/schemas/ssl_proxy_ciphers_category2'
- description: 'Allowed cipher strength category for SSL proxy inspection. enum: `medium`, `strong`, `weak`.'
enabled:
type: boolean
description: Whether SSL proxy inspection is enabled for the service policy
default: false
description: TLS inspection settings applied by this service policy
service_policy_syslog2:
title: service_policy_syslog2
type: object
properties:
enabled:
type: boolean
description: Whether syslog logging is enabled for the service policy
default: false
server_names:
type: array
items:
type: string
description: Names of syslog servers that receive logs for this service policy
examples:
- - dc_syslog_server
description: Remote logging settings applied by this service policy
service_traffic_class2:
title: service_traffic_class2
enum:
- best_effort
- high
- low
- medium
type: string
description: 'Traffic class applied when `traffic_type`==`custom`. enum: `best_effort`, `high`, `low`, `medium`.'
service_type2:
title: service_type2
enum:
- app_categories
- apps
- custom
- urls
type: string
description: 'Matching mode that determines which app, URL, or custom fields are used. enum: `app_categories`, `apps`, `custom`, `urls`.'
setting_ssr_auto_upgrade2:
title: setting_ssr_auto_upgrade2
type: object
properties:
channel:
allOf:
- $ref: '#/components/schemas/ssr_upgrade_channel4'
- description: 'Firmware release channel used for SSR auto-upgrade. enum: `alpha`, `beta`, `stable`.'
custom_versions:
type: object
additionalProperties:
type: string
description: Per-model SSR firmware versions used for auto-upgrade
enabled:
type: boolean
description: Whether SSR auto-upgrade is enabled for newly onboarded devices
default: false
version:
type: string
description: Firmware version to deploy (e.g. 6.3.0-107.r1). Optional, used when custom_versions not specified
examples:
- 6.3.0-107.r1
description: Automatic SSR firmware upgrade settings for newly onboarded devices
setting_ssr2:
title: setting_ssr2
type: object
properties:
auto_upgrade:
allOf:
- $ref: '#/components/schemas/setting_ssr_auto_upgrade2'
- description: Automatic SSR firmware upgrade settings for newly onboarded devices
conductor_hosts:
type: array
items:
type: string
description: IP addresses or hostnames of conductors used by SSR devices
conductor_token:
type: string
description: Registration token used by SSR devices to connect to the conductor
disable_stats:
type: boolean
description: Whether stats collection is disabled on SSR devices
proxy:
allOf:
- $ref: '#/components/schemas/ssr_proxy2'
- description: Network proxy settings used by SSR devices to reach Mist
description: Session Smart Router settings for the site
setting_ssr3:
title: setting_ssr3
type: object
properties:
auto_upgrade:
allOf:
- $ref: '#/components/schemas/setting_ssr_auto_upgrade2'
- description: Automatic SSR firmware upgrade settings for newly onboarded devices
conductor_hosts:
type: array
items:
type: string
description: IP addresses or hostnames of conductors used by SSR devices
conductor_token:
type: string
description: Registration token used by SSR devices to connect to the conductor
disable_stats:
type: boolean
description: Whether stats collection is disabled on SSR devices
proxy:
allOf:
- $ref: '#/components/schemas/ssr_proxy2'
- description: Network proxy settings used by SSR devices to reach Mist
description: Session Smart Router settings for the organization
simple_alert2:
title: simple_alert2
type: object
properties:
arp_failure:
allOf:
- $ref: '#/components/schemas/simple_alert_arp_failure'
- description: Thresholds for ARP failure heuristic alerts
dhcp_failure:
allOf:
- $ref: '#/components/schemas/simple_alert_dhcp_failure'
- description: Thresholds for DHCP failure heuristic alerts
dns_failure:
allOf:
- $ref: '#/components/schemas/simple_alert_dns_failure'
- description: Thresholds for DNS failure heuristic alerts
description: Threshold alert settings for the site
simple_alert3:
title: simple_alert3
type: object
properties:
arp_failure:
allOf:
- $ref: '#/components/schemas/simple_alert_arp_failure'
- description: Thresholds for ARP failure heuristic alerts
dhcp_failure:
allOf:
- $ref: '#/components/schemas/simple_alert_dhcp_failure'
- description: Thresholds for DHCP failure heuristic alerts
dns_failure:
allOf:
- $ref: '#/components/schemas/simple_alert_dns_failure'
- description: Thresholds for DNS failure heuristic alerts
description: Basic alert delivery settings for the organization
site_auto_upgrade_version2:
title: site_auto_upgrade_version2
enum:
- beta
- custom
- stable
type: string
description: 'Firmware release channel or custom version used for AP auto-upgrade. enum: `beta`, `custom`, `stable`.'
examples:
- beta
site_auto_upgrade_version3:
title: site_auto_upgrade_version3
enum:
- beta
- custom
- stable
type: string
description: 'Firmware release channel or specific version used for AP auto-upgrade. enum: `beta`, `custom`, `stable`.'
examples:
- beta
site_engagement_dwell_tag_names2:
title: site_engagement_dwell_tag_names2
type: object
properties:
bounce:
type: string
description: Display label for bounce visits
default: Visitor
examples:
- Bounce
engaged:
type: string
description: Display label for engaged visits
default: Associates
examples:
- Engaged
passerby:
type: string
description: Display label for passerby visits
default: Passerby
examples:
- Passer By
stationed:
type: string
description: Display label for stationed visits
default: Assets
examples:
- Stationed
description: Display labels for dwell-time visit categories
site_engagement_dwell_tags2:
title: site_engagement_dwell_tags2
type: object
properties:
bounce:
type:
- string
- 'null'
description: Visit duration range for bounce visits, in seconds
default: 301-14400
engaged:
type:
- string
- 'null'
description: Visit duration range for engaged visits, in seconds
default: 14401-28800
passerby:
type:
- string
- 'null'
description: Visit duration range for passerby visits, in seconds
default: 1-300
stationed:
type:
- string
- 'null'
description: Visit duration range for stationed visits, in seconds
default: 28801-42000
description: Visit duration ranges used to assign engagement categories
site_engagement1:
title: site_engagement1
type: object
properties:
dwell_tag_names:
allOf:
- $ref: '#/components/schemas/site_engagement_dwell_tag_names2'
- description: Display labels for dwell-time visit categories
dwell_tags:
allOf:
- $ref: '#/components/schemas/site_engagement_dwell_tags2'
- description: Visit duration ranges used to assign engagement categories
hours:
allOf:
- $ref: '#/components/schemas/hours3'
- description: Schedule during which engagement analytics rules apply
max_dwell:
maximum: 68400
minimum: 1
type: integer
description: Maximum dwell time in seconds considered by engagement analytics
contentEncoding: int32
default: 43200
examples:
- 43200
min_dwell:
minimum: 0
type: integer
description: Minimum dwell time in seconds for engagement analytics
contentEncoding: int32
description: Dwell-time analytics rules for the site
site_mxtunnel_protocol2:
title: site_mxtunnel_protocol2
enum:
- ip
- udp
type: string
description: 'Encapsulation protocol used for this additional Mist Tunnel. enum: `ip`, `udp`.'
examples:
- udp
site_mxtunnel_radsec2:
title: site_mxtunnel_radsec2
type: object
properties:
acct_servers:
type: array
items:
$ref: '#/components/schemas/radius_acct_server'
description: RADIUS accounting servers used by the site Mist Tunnel RadSec proxy
auth_servers:
type: array
items:
$ref: '#/components/schemas/radius_auth_server'
description: RADIUS authentication servers used by the site Mist Tunnel RadSec proxy
enabled:
type: boolean
description: Whether RadSec proxying is enabled for this site Mist Tunnel
default: false
use_mxedge:
type: boolean
description: Whether RadSec proxying uses Mist Edge
description: TLS-secured RADIUS proxy settings for the site Mist Tunnel
site_mxtunnel1:
title: site_mxtunnel1
type: object
properties:
additional_mxtunnels:
type: object
additionalProperties:
$ref: '#/components/schemas/site_mxtunnel_additional_mxtunnel'
description: Additional named Mist Tunnel definitions configured for the site
ap_subnets:
type: array
items:
type: string
description: AP source subnets allowed to establish Mist Tunnels
auto_preemption:
allOf:
- $ref: '#/components/schemas/auto_preemption1'
- description: Preemption behavior for restoring preferred tunnel peers after failover
clusters:
type: array
items:
$ref: '#/components/schemas/site_mxtunnel_cluster'
description: Tunnel peer clusters used by APs for this site Mist Tunnel
created_time:
type: number
description: Timestamp when the site Mist Tunnel configuration was created
readOnly: true
enabled:
type: boolean
description: Whether site Mist Tunnel tunneling is enabled
for_site:
type: boolean
description: Whether this Mist Tunnel configuration is scoped to a site
readOnly: true
hello_interval:
maximum: 300
minimum: 1
type: integer
description: In seconds, used as heartbeat to detect if a tunnel is alive. AP will try another peer after missing N hellos specified by hello_retries
contentEncoding: int32
default: 60
examples:
- 60
hello_retries:
maximum: 30
minimum: 2
type: integer
description: Number of missed hello heartbeats before an AP tries another tunnel peer
contentEncoding: int32
default: 7
examples:
- 3
hosts:
type: array
items:
type: string
description: Tunnel peer hostnames or IP addresses reachable from APs
id:
type: string
description: Unique value identifying the site Mist Tunnel configuration
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
modified_time:
type: number
description: Timestamp when the site Mist Tunnel configuration was last modified
readOnly: true
mtu:
maximum: 1500
minimum: 0
type: integer
description: 0 to enable MTU, 552-1500 to start MTU with a lower MTU
contentEncoding: int32
default: 0
examples:
- 1100
org_id:
type: string
description: Identifier of the org that owns the site Mist Tunnel configuration
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
protocol:
allOf:
- $ref: '#/components/schemas/mxtunnel_protocol2'
- description: 'Encapsulation protocol used for the site Mist Tunnel. enum: `ip`, `udp`.'
radsec:
allOf:
- $ref: '#/components/schemas/site_mxtunnel_radsec2'
- description: TLS-secured RADIUS proxy settings for the site Mist Tunnel
site_id:
type: string
description: Identifier of the site that owns this Mist Tunnel configuration
contentEncoding: uuid
readOnly: true
examples:
- 441a1214-6928-442a-8e92-e1d34b8ec6a6
vlan_ids:
type: array
items:
type: integer
contentEncoding: int32
description: List of VLAN IDs carried by this site Mist Tunnel
description: Site Mist Tunnel configuration
site_rogue1:
title: site_rogue1
type: object
properties:
allowed_vlan_ids:
type: array
items:
maximum: 4096
minimum: 0
type: integer
contentEncoding: int32
description: VLAN IDs allowed by the rogue detection policy
enabled:
type: boolean
description: Whether rogue detection is enabled
default: false
honeypot_enabled:
type: boolean
description: Whether honeypot detection is enabled
default: false
min_duration:
maximum: 59
type: integer
description: Minimum duration for a bssid to be considered neighbor
contentEncoding: int32
default: 10
examples:
- 10
min_rogue_duration:
maximum: 59
type: integer
description: Minimum duration for a bssid to be considered rogue
contentEncoding: int32
default: 10
examples:
- 10
min_rogue_rssi:
minimum: -85
type: integer
description: Minimum RSSI for an AP to be considered rogue
contentEncoding: int32
default: -80
examples:
- -80
min_rssi:
minimum: -85
type: integer
description: Minimum RSSI for an AP to be considered neighbor (ignoring APs that’s far away)
contentEncoding: int32
default: -80
examples:
- -80
whitelisted_bssids:
type: array
items:
type: string
description: BSSID values or wildcard patterns excluded from rogue detection
examples:
- - NeighborSSID
whitelisted_ssids:
type: array
items:
type: string
description: SSID names excluded from rogue detection
examples:
- - cc:8e:6f:d4:bf:16
- cc-8e-6f-d4-bf-16
- cc-73-*
- cc:82:*
description: AP threat detection settings for the site
site_setting_analytic2:
title: site_setting_analytic2
type: object
properties:
enabled:
type: boolean
description: Enable Advanced Analytic feature (using SUB-ANA license)
default: false
description: Advanced analytics configuration for the site
site_setting_ap_matching2:
title: site_setting_ap_matching2
type: object
properties:
enabled:
type: boolean
description: Whether AP matching rules are enabled
rules:
type: array
items:
$ref: '#/components/schemas/site_setting_ap_matching_rule'
description: Ordered AP matching rules for applying port configuration
description: Rules that apply model-specific AP port configuration
site_setting_ap_port_config2:
title: site_setting_ap_port_config2
type: object
properties:
model_specific:
type: object
additionalProperties:
$ref: '#/components/schemas/ap_port_config'
description: Property key is the AP model (e.g. "AP32")
description: Ethernet port configuration overrides for APs at the site
site_setting_ap_synthetic_test2:
title: site_setting_ap_synthetic_test2
type: object
properties:
additional_vlan_ids:
anyOf:
- type: string
- type: array
items:
$ref: '#/components/schemas/vlan_id_with_variable'
description: VLAN IDs included in addition to the default VLAN set for AP synthetic tests
description: Synthetic test configuration for APs at the site
site_setting_auto_placement2:
title: site_setting_auto_placement2
type: object
properties:
orientation:
type: integer
description: AP orientation angle in degrees on the map
contentEncoding: int32
examples:
- 45
x:
type: number
description: Map x-coordinate determined by auto placement
examples:
- 30
y:
type: number
description: Map y-coordinate determined by auto placement
examples:
- 60
description: Automatic AP placement settings for the site
site_setting_auto_upgrade_esl2:
title: site_setting_auto_upgrade_esl2
type: object
properties:
allow_downgrade:
type: boolean
description: If true, it will allow downgrade to a lower version
default: false
custom_versions:
type: object
additionalProperties:
type: string
description: Custom versions for different models. Property key is the model name (e.g. "AP41")
examples:
- AP41: 2.4.6
AP61: 2.5.0
day_of_week:
allOf:
- $ref: '#/components/schemas/day_of_week5'
- description: 'Weekly ESL auto-upgrade day for the maintenance window. enum: `any`, `fri`, `mon`, `sat`, `sun`, `thu`, `tue`, `wed`.'
enabled:
type: boolean
description: Whether auto upgrade should happen (Note that Mist may auto-upgrade if the version is not supported)
default: false
time_of_day:
type: string
description: '`any` / HH:MM (24-hour format), upgrade will happen within up to 1-hour from this time'
examples:
- 12:00
version:
type: string
description: ESL firmware version used for auto-upgrade
examples:
- 2.5.0
description: Automatic ESL firmware upgrade settings for the site
site_setting_auto_upgrade2:
title: site_setting_auto_upgrade2
type: object
properties:
custom_versions:
type: object
additionalProperties:
type: string
description: Per-AP-model firmware versions or channels used for auto-upgrade
examples:
- AP21: alpha
AP41: 0.1.5135
AP61: 0.1.7215
day_of_week:
allOf:
- $ref: '#/components/schemas/day_of_week4'
- description: 'Weekly AP auto-upgrade day for the maintenance window. enum: `any`, `fri`, `mon`, `sat`, `sun`, `thu`, `tue`, `wed`.'
enabled:
type: boolean
description: Whether auto upgrade should happen (Note that Mist may auto-upgrade if the version is not supported)
default: false
time_of_day:
type: string
description: '`any` / HH:MM (24-hour format), upgrade will happen within up to 1-hour from this time'
examples:
- 12:00
version:
allOf:
- $ref: '#/components/schemas/site_auto_upgrade_version2'
- description: 'Firmware release channel or custom version used for AP auto-upgrade. enum: `beta`, `custom`, `stable`.'
examples:
- beta
description: Automatic AP firmware upgrade settings for the site. Overrides org setting when provided.
site_setting_config_push_policy2:
title: site_setting_config_push_policy2
type: object
properties:
no_push:
type: boolean
description: Stop any new config from being pushed to the device
default: false
push_window:
allOf:
- $ref: '#/components/schemas/push_policy_push_window1'
- description: Allowed time window during which configuration pushes may run
description: Policy controlling how site configuration pushes are applied
site_setting_critical_url_monitoring2:
title: site_setting_critical_url_monitoring2
type: object
properties:
enabled:
type: boolean
description: Whether critical URL monitoring is enabled
default: true
monitors:
type: array
items:
$ref: '#/components/schemas/site_setting_critical_url_monitoring_monitor'
description: Critical URLs monitored for site health latency
description: Monitoring configuration for critical URLs at the site
site_setting_juniper_srx2:
title: site_setting_juniper_srx2
type: object
properties:
auto_upgrade:
allOf:
- $ref: '#/components/schemas/juniper_srx_auto_upgrade2'
- description: SRX auto-upgrade settings applied when SRX devices are onboarded
gateways:
type: array
items:
$ref: '#/components/schemas/site_setting_juniper_srx_gateway'
description: SRX gateways integrated with this site
send_mist_nac_user_info:
type: boolean
description: Whether Mist NAC user information is sent to Juniper SRX gateways
description: SRX integration settings for the site
site_setting_mxedge2:
title: site_setting_mxedge2
type: object
properties:
mist_das:
allOf:
- $ref: '#/components/schemas/mxedge_das2'
- description: DAS service settings for the site Mist Edge cluster
mist_nac:
allOf:
- $ref: '#/components/schemas/mxcluster_nac2'
- description: RADIUS settings for Mist NAC on the site Mist Edge cluster
mist_nacedge:
allOf:
- $ref: '#/components/schemas/mist_nacedge1'
- description: NAC Edge service settings for the site Mist Edge cluster
radsec:
allOf:
- $ref: '#/components/schemas/mxcluster_radsec2'
- description: TLS-secured RADIUS proxy settings for the site Mist Edge cluster
description: Site Mist Edge service settings
site_setting_paloalto_networks2:
title: site_setting_paloalto_networks2
type: object
properties:
gateways:
type: array
items:
$ref: '#/components/schemas/site_setting_paloalto_network_gateway'
description: Palo Alto Networks gateways integrated with this site
send_mist_nac_user_info:
type: boolean
description: Whether Mist NAC user information is sent to Palo Alto Networks gateways
default: false
description: Firewall integration settings for Palo Alto Networks at the site
site_setting_rtsa2:
title: site_setting_rtsa2
type: object
properties:
app_waking:
type: boolean
description: Whether app wake-up support is enabled for managed mobility
default: false
disable_dead_reckoning:
type: boolean
description: Whether dead reckoning is disabled for managed mobility
disable_pressure_sensor:
type: boolean
description: Whether pressure sensor use is disabled for managed mobility
default: false
enabled:
type: boolean
description: Whether managed mobility features are enabled
track_asset:
type: boolean
description: Whether BLE asset tracking is enabled for managed mobility
default: false
description: Managed mobility and asset tracking settings for the site
site_setting_skyatp2:
title: site_setting_skyatp2
type: object
properties:
enabled:
type: boolean
description: Whether Sky ATP is enabled for the site
send_ip_mac_mapping:
type: boolean
description: Whether IP-to-MAC mappings are sent to Sky ATP
default: false
description: Threat intelligence settings from Sky ATP for the site
site_setting_switch2:
title: site_setting_switch2
type: object
properties:
acl_policies:
type: array
items:
$ref: '#/components/schemas/acl_policy'
description: ACL policy defaults provided by this network template
acl_tags:
type: object
additionalProperties:
$ref: '#/components/schemas/acl_tag'
description: ACL tags available to access policies in this network template
additional_config_cmds:
type: array
items:
type: string
description: Additional CLI configuration commands provided by this network template
bgp_config:
type: object
additionalProperties:
$ref: '#/components/schemas/switch_bgp_config'
description: BGP routing defaults for this network template. Property key is the BGP session name
created_time:
type: number
description: Timestamp when the network template was created
readOnly: true
dhcp_snooping:
allOf:
- $ref: '#/components/schemas/dhcp_snooping3'
- description: DHCP snooping defaults provided by this network template
dns_servers:
type: array
items:
type: string
description: DNS servers provided by this network template
dns_suffix:
type: array
items:
type: string
description: DNS search suffixes provided by this network template
extra_routes:
type: object
additionalProperties:
$ref: '#/components/schemas/extra_route'
description: Additional IPv4 route defaults in this network template
examples:
- 0.0.0.0/0:
via: 192.168.1.10
extra_routes6:
type: object
additionalProperties:
$ref: '#/components/schemas/extra_route6'
description: Additional IPv6 route defaults in this network template
examples:
- 2a02:1234:420a:10c9::/64:
via: 2a02:1234:200a::100
id:
type: string
description: Unique identifier of the network template
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
import_org_networks:
type: array
items:
type: string
description: Organization network names imported into this network template
mist_nac:
allOf:
- $ref: '#/components/schemas/switch_mist_nac2'
- description: Mist NAC defaults applied by this network template
modified_time:
type: number
description: Timestamp when the network template was last modified
readOnly: true
multicast_config:
allOf:
- $ref: '#/components/schemas/switch_multicast_config1'
- description: Multicast settings for networks in the master VRF (not assigned to any vrf_instances); PIM is automatically enabled when any master-VRF network has `multicast.enabled`==`true`
name:
type: string
description: Display name of the network template
networks:
type: object
additionalProperties:
$ref: '#/components/schemas/switch_network'
description: Layer 3 networks configured by this network template
ntp_servers:
type: array
items:
type: string
description: NTP servers provided by this network template
org_id:
type: string
description: Organization that owns this network template
contentEncoding: uuid
readOnly: true
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
ospf_areas:
type: object
additionalProperties:
$ref: '#/components/schemas/ospf_area'
description: OSPF area defaults provided by this network template
port_mirroring:
type: object
additionalProperties:
$ref: '#/components/schemas/switch_port_mirroring_property'
description: Port mirroring defaults provided by this network template
port_usages:
type: object
additionalProperties:
$ref: '#/components/schemas/switch_port_usage'
description: Reusable switch port usage profiles provided by this network template
radius_config:
allOf:
- $ref: '#/components/schemas/switch_radius_config3'
- description: RADIUS authentication and accounting defaults in this network template
remote_syslog:
allOf:
- $ref: '#/components/schemas/remote_syslog2'
- description: Remote syslog defaults provided by this network template
remove_existing_configs:
type: boolean
description: By default, only the configuration generated by Mist is cleaned up during the configuration process. If `true`, all the existing configuration will be removed.
default: false
routing_policies:
type: object
additionalProperties:
$ref: '#/components/schemas/sw_routing_policy'
description: Routing policy defaults applied by this network template
snmp_config:
allOf:
- $ref: '#/components/schemas/snmp_config2'
- description: SNMP defaults provided by this network template
switch_matching:
allOf:
- $ref: '#/components/schemas/switch_matching3'
- description: Matching rules that select switches for this network template
switch_mgmt:
allOf:
- $ref: '#/components/schemas/switch_mgmt3'
- description: Management-plane defaults provided by this network template
vrf_config:
allOf:
- $ref: '#/components/schemas/vrf_config5'
- description: VRF defaults applied by this network template
vrf_instances:
type: object
additionalProperties:
$ref: '#/components/schemas/switch_vrf_instance'
description: VRF instances configured by this network template
examples:
- guest:
extra_routes:
0.0.0.0/0:
via: 192.168.31.1
networks:
- guest
auto_upgrade:
allOf:
- $ref: '#/components/schemas/switch_auto_upgrade1'
- description: Switch firmware auto-upgrade configuration
description: Site-level switch feature configuration
site_setting_tunterm_multicast_config_mdns2:
title: site_setting_tunterm_multicast_config_mdns2
type: object
properties:
enabled:
type: boolean
description: Whether mDNS multicast forwarding is enabled
default: false
vlan_ids:
type: array
items:
type: integer
contentEncoding: int32
description: VLAN IDs where mDNS multicast forwarding is enabled
examples:
- - 2
- 3
- 5
description: Multicast DNS forwarding settings for tunneled VLANs
site_setting_tunterm_multicast_config_ssdp2:
title: site_setting_tunterm_multicast_config_ssdp2
type: object
properties:
enabled:
type: boolean
description: Whether SSDP multicast forwarding is enabled
default: false
vlan_ids:
type: array
items:
type: integer
contentEncoding: int32
description: VLAN IDs where SSDP multicast forwarding is enabled
examples:
- - 2
- 3
- 5
description: Simple Service Discovery Protocol forwarding settings for tunneled VLANs
site_setting_tunterm_multicast_config2:
title: site_setting_tunterm_multicast_config2
type: object
properties:
mdns:
allOf:
- $ref: '#/components/schemas/site_setting_tunterm_multicast_config_mdns2'
- description: Multicast DNS forwarding settings for tunneled VLANs
multicast_all:
type: boolean
description: Whether all multicast traffic is forwarded through tunnel termination
default: false
ssdp:
allOf:
- $ref: '#/components/schemas/site_setting_tunterm_multicast_config_ssdp2'
- description: Simple Service Discovery Protocol forwarding settings for tunneled VLANs
description: Multicast settings for tunnel termination at the site
site_setting_vna2:
title: site_setting_vna2
type: object
properties:
enabled:
type: boolean
description: Enable Virtual Network Assistant (using SUB-VNA license). This applied to AP / Switch / Gateway
default: false
description: Virtual Network Assistant settings for the site
site_setting_wan_vna2:
title: site_setting_wan_vna2
type: object
properties:
enabled:
type: boolean
description: Whether WAN VNA is enabled for the site
default: false
description: Virtual Network Assistant settings for WAN experiences at the site
site_setting_wired_vna2:
title: site_setting_wired_vna2
type: object
properties:
enabled:
type: boolean
description: Whether Wired VNA is enabled for the site
default: false
description: Virtual Network Assistant settings for wired experiences at the site
site_template_auto_upgrade2:
title: site_template_auto_upgrade2
type: object
properties:
day_of_week:
allOf:
- $ref: '#/components/schemas/day_of_week6'
- description: 'Day of week when the automatic upgrade window runs. enum: `any`, `fri`, `mon`, `sat`, `sun`, `thu`, `tue`, `wed`.'
enabled:
type: boolean
description: Whether automatic upgrades are enabled for sites using this site template
time_of_day:
type: string
description: Local time of day when the automatic upgrade window starts
version:
type: string
description: Target firmware version installed during automatic upgrades
description: Automatic upgrade settings applied by this site template
site_wids2:
title: site_wids2
type: object
properties:
repeated_auth_failures:
allOf:
- $ref: '#/components/schemas/site_wids_repeated_auth_failures'
- description: Detection settings for repeated authentication failures
description: Wireless intrusion detection settings for the site
site_wifi_proxy_arp2:
title: site_wifi_proxy_arp2
enum:
- default
- disabled
- enabled
type: string
description: 'ARP proxy mode for site Wi-Fi. enum: `default`, `disabled`, `enabled`.'
site_wifi2:
title: site_wifi2
type: object
properties:
cisco_enabled:
type: boolean
description: Whether Cisco compatibility features are enabled for site Wi-Fi
default: true
disable_11k:
type: boolean
description: Whether to disable 11k
default: false
disable_radios_when_power_constrained:
type: boolean
description: Whether AP radios are disabled when AP power is constrained
default: false
enable_arp_spoof_check:
type: boolean
description: When proxy_arp is enabled, check for arp spoofing.
default: false
enable_shared_radio_scanning:
type: boolean
description: Whether shared radio scanning is enabled for site Wi-Fi
default: true
enabled:
type: boolean
description: Enable Wi-Fi feature (using SUB-MAN license)
default: true
locate_connected:
type: boolean
description: Whether to locate connected clients
default: true
locate_unconnected:
type: boolean
description: Whether to locate unconnected clients
default: false
mesh_allow_dfs:
type: boolean
description: Whether to allow Mesh to use DFS channels. For DFS channels, Remote Mesh AP would have to do CAC when scanning for new Base AP, which is slow and will disrupt the connection. If roaming is desired, keep it disabled.
default: false
mesh_enable_crm:
type: boolean
description: Used to enable/disable CRM
default: false
mesh_enabled:
type: boolean
description: Whether to enable Mesh feature for the site
default: false
mesh_psk:
type:
- string
- 'null'
description: Optional passphrase of mesh networking, default is generated randomly
mesh_ssid:
type:
- string
- 'null'
description: Optional ssid of mesh networking, default is based on site_id
proxy_arp:
allOf:
- oneOf:
- {}
- $ref: '#/components/schemas/site_wifi_proxy_arp2'
- description: 'ARP proxy mode for site Wi-Fi. enum: `default`, `disabled`, `enabled`.'
description: Wireless LAN configuration settings for the site
site_zone_occupancy_alert2:
title: site_zone_occupancy_alert2
type: object
properties:
email_notifiers:
type: array
items:
type: string
description: Notification email recipients for zone occupancy alerts
examples:
- - foo@juniper.net
- bar@juniper.net
enabled:
type: boolean
description: Indicate whether zone occupancy alert is enabled for the site
default: false
threshold:
maximum: 30
minimum: 0
type: integer
description: Sending zone-occupancy-alert webhook message only if a zone stays non-compliant (i.e. actual occupancy > occupancy_limit) for a minimum duration specified in the threshold, in minutes
contentEncoding: int32
default: 5
examples:
- 5
description: Occupancy alert settings for site zones
sle_classifier_impact2:
title: sle_classifier_impact2
required:
- num_aps
- num_users
- total_aps
- total_users
type: object
properties:
num_aps:
type: number
description: Number of APs affected by degraded SLE experience
num_users:
type: number
description: Number of users affected by degraded SLE experience
total_aps:
type: number
description: Total number of APs considered for the classifier
total_users:
type: number
description: Total number of users considered for the classifier
description: Counts of affected APs and users for this classifier
sle_classifier_samples2:
title: sle_classifier_samples2
required:
- degraded
- duration
- total
type: object
properties:
degraded:
type: array
items:
$ref: '#/components/schemas/number_or_null'
description: Per-interval degraded SLE values for the classifier
duration:
type: array
items:
type: number
description: Per-interval observation durations for the classifier
total:
type: array
items:
$ref: '#/components/schemas/number_or_null'
description: Per-interval total SLE values for the classifier
description: Time-series sample arrays for the classifier trend
sle_classifier_samples3:
title: sle_classifier_samples3
required:
- degraded
- duration
- total
type: object
properties:
degraded:
type: array
items:
$ref: '#/components/schemas/number_or_null'
description: Per-interval degraded SLE values for the classifier
duration:
type: array
items:
type: number
description: Per-interval observation durations for the classifier
total:
type: array
items:
$ref: '#/components/schemas/number_or_null'
description: Per-interval total SLE values for the classifier
description: Time-series sample arrays for the classifier
sle_classifier_summary_impact2:
title: sle_classifier_summary_impact2
required:
- num_aps
- num_users
- total_aps
- total_users
type: object
properties:
num_aps:
type: number
description: Number of APs affected by degraded SLE experience
num_users:
type: number
description: Number of users affected by degraded SLE experience
total_aps:
type: number
description: Total number of APs considered in the summary window
total_users:
type: number
description: Total number of users considered in the summary window
description: AP and user impact counts for the classifier summary window
sle_classifier1:
title: sle_classifier1
required:
- impact
- interval
- name
- x_label
- y_label
type: object
properties:
impact:
allOf:
- $ref: '#/components/schemas/sle_classifier_impact2'
- description: Counts of affected APs and users for this classifier
interval:
type: number
description: Sample interval in seconds for classifier time-series data
name:
minLength: 1
type: string
description: Classifier name for the SLE metric
samples:
allOf:
- $ref: '#/components/schemas/sle_classifier_samples3'
- description: Time-series sample arrays for the classifier
x_label:
minLength: 1
type: string
description: Label for the classifier sample x-axis
y_label:
minLength: 1
type: string
description: Label for the classifier sample y-axis
description: Requested SLE classifier detail for the metric
sle_summary_impact2:
title: sle_summary_impact2
required:
- num_aps
- num_users
- total_aps
- total_users
type: object
properties:
num_aps:
type: number
description: Number of APs affected by degraded SLE experience
num_users:
type: number
description: Number of users affected by degraded SLE experience
total_aps:
type: number
description: Total number of APs considered in the summary window
total_users:
type: number
description: Total number of users considered in the summary window
description: AP and user impact counts for the summary window
sle_summary_sle_samples2:
title: sle_summary_sle_samples2
required:
- degraded
- total
- value
type: object
properties:
degraded:
type: array
items:
$ref: '#/components/schemas/number_or_null'
description: Per-interval degraded SLE values for the summary
total:
type: array
items:
$ref: '#/components/schemas/number_or_null'
description: Per-interval total SLE values for the summary
value:
type: array
items:
$ref: '#/components/schemas/number_or_null'
description: Per-interval SLE score values for the summary
description: Per-interval sample arrays for the SLE metric
sle_summary_sle2:
title: sle_summary_sle2
required:
- interval
- name
- samples
- x_label
- y_label
type: object
properties:
interval:
type: number
description: Sample interval in seconds for SLE summary data
name:
minLength: 1
type: string
description: SLE metric name represented by the summary samples
samples:
allOf:
- $ref: '#/components/schemas/sle_summary_sle_samples2'
- description: Per-interval sample arrays for the SLE metric
x_label:
minLength: 1
type: string
description: Label for the SLE summary x-axis
y_label:
minLength: 1
type: string
description: Label for the SLE summary y-axis
description: Time-series SLE samples for the trend window
sle_summary_sle3:
title: sle_summary_sle3
required:
- interval
- name
- samples
- x_label
- y_label
type: object
properties:
interval:
type: number
description: Sample interval in seconds for SLE summary data
name:
minLength: 1
type: string
description: SLE metric name represented by the summary samples
samples:
allOf:
- $ref: '#/components/schemas/sle_summary_sle_samples2'
- description: Per-interval sample arrays for the SLE metric
x_label:
minLength: 1
type: string
description: Label for the SLE summary x-axis
y_label:
minLength: 1
type: string
description: Label for the SLE summary y-axis
description: Time-series SLE samples for the summary window
sle_thresholds2:
title: sle_thresholds2
type: object
properties:
capacity:
maximum: 50
minimum: 5
type: integer
description: Threshold percentage for capacity SLE scoring
contentEncoding: int32
default: 20
coverage:
maximum: -60
minimum: -90
type: integer
description: RSSI threshold for coverage SLE scoring, in dBm
contentEncoding: int32
default: -72
throughput:
maximum: 100
minimum: 1
type: integer
description: Minimum throughput threshold for SLE scoring, in Mbps
contentEncoding: int32
default: 10
time-to-connect:
maximum: 10
minimum: 2
type: integer
description: Time to connect, in seconds
contentEncoding: int32
default: 4
description: Service level expectation threshold settings for the site
sle_trend_classifier2:
title: sle_trend_classifier2
required:
- interval
- name
- x_label
- y_label
type: object
properties:
interval:
type: number
description: Sample interval in seconds for classifier trend data
name:
minLength: 1
type: string
description: Classifier name for the SLE metric trend
samples:
allOf:
- $ref: '#/components/schemas/sle_classifier_samples2'
- description: Time-series sample arrays for the classifier trend
x_label:
minLength: 1
type: string
description: Label for the classifier trend x-axis
y_label:
minLength: 1
type: string
description: Label for the classifier trend y-axis
description: Requested SLE classifier trend detail for the metric
snmp_config_engine_id_type2:
title: snmp_config_engine_id_type2
enum:
- local
- use_mac_address
type: string
description: 'Method used to derive the SNMP engine ID. enum: `local`, `use_mac_address`.'
snmp_config_trap_version2:
title: snmp_config_trap_version2
enum:
- all
- v1
- v2
type: string
description: 'SNMP trap protocol version used by this group. enum: `all`, `v1`, `v2`.'
snmp_config1:
title: snmp_config1
type: object
properties:
client_list:
type: array
items:
$ref: '#/components/schemas/snmp_config_client_list'
description: SNMP client allowlists that can be referenced by communities
contact:
type: string
description: Administrative contact string advertised through SNMP
examples:
- cns@juniper.net
description:
type: string
description: Device description string advertised through SNMP
examples:
- Juniper QFX Series Switch - 1K_5LA
enabled:
type: boolean
description: Whether SNMP is enabled
default: true
engine_id:
maxLength: 27
type: string
description: SNMP engine ID used for SNMPv3
engine_id_type:
allOf:
- $ref: '#/components/schemas/snmp_config_engine_id_type2'
- description: 'Method used to derive the SNMP engine ID. enum: `local`, `use_mac_address`.'
location:
type: string
description: Physical location string advertised through SNMP
examples:
- Las Vegas, NV
name:
type: string
description: System name advertised through SNMP
examples:
- TGH-1K-QFX10K
network:
type: string
description: Management network used for SNMP traffic
default: default
trap_groups:
type: array
items:
$ref: '#/components/schemas/snmp_config_trap_group'
description: SNMP trap group definitions
v2c_config:
type: array
items:
$ref: '#/components/schemas/snmp_config_v2c_config'
description: SNMPv2c community configuration entries for this SNMP profile
v3_config:
allOf:
- $ref: '#/components/schemas/snmpv3_config2'
- description: SNMPv3 user, VACM, notify, and target configuration
views:
type: array
items:
$ref: '#/components/schemas/snmp_config_view'
description: SNMP MIB view definitions
description: SNMP defaults provided by this switch profile
snmp_config2:
title: snmp_config2
type: object
properties:
client_list:
type: array
items:
$ref: '#/components/schemas/snmp_config_client_list'
description: SNMP client allowlists that can be referenced by communities
contact:
type: string
description: Administrative contact string advertised through SNMP
examples:
- cns@juniper.net
description:
type: string
description: Device description string advertised through SNMP
examples:
- Juniper QFX Series Switch - 1K_5LA
enabled:
type: boolean
description: Whether SNMP is enabled
default: true
engine_id:
maxLength: 27
type: string
description: SNMP engine ID used for SNMPv3
engine_id_type:
allOf:
- $ref: '#/components/schemas/snmp_config_engine_id_type2'
- description: 'Method used to derive the SNMP engine ID. enum: `local`, `use_mac_address`.'
location:
type: string
description: Physical location string advertised through SNMP
examples:
- Las Vegas, NV
name:
type: string
description: System name advertised through SNMP
examples:
- TGH-1K-QFX10K
network:
type: string
description: Management network used for SNMP traffic
default: default
trap_groups:
type: array
items:
$ref: '#/components/schemas/snmp_config_trap_group'
description: SNMP trap group definitions
v2c_config:
type: array
items:
$ref: '#/components/schemas/snmp_config_v2c_config'
description: SNMPv2c community configuration entries for this SNMP profile
v3_config:
allOf:
- $ref: '#/components/schemas/snmpv3_config2'
- description: SNMPv3 user, VACM, notify, and target configuration
views:
type: array
items:
$ref: '#/components/schemas/snmp_config_view'
description: SNMP MIB view definitions
description: SNMP defaults provided by this network template
snmp_config3:
title: snmp_config3
type: object
properties:
client_list:
type: array
items:
$ref: '#/components/schemas/snmp_config_client_list'
description: SNMP client allowlists that can be referenced by communities
contact:
type: string
description: Administrative contact string advertised through SNMP
examples:
- cns@juniper.net
description:
type: string
description: Device description string advertised through SNMP
examples:
- Juniper QFX Series Switch - 1K_5LA
enabled:
type: boolean
description: Whether SNMP is enabled
default: true
engine_id:
maxLength: 27
type: string
description: SNMP engine ID used for SNMPv3
engine_id_type:
allOf:
- $ref: '#/components/schemas/snmp_config_engine_id_type2'
- description: 'Method used to derive the SNMP engine ID. enum: `local`, `use_mac_address`.'
location:
type: string
description: Physical location string advertised through SNMP
examples:
- Las Vegas, NV
name:
type: string
description: System name advertised through SNMP
examples:
- TGH-1K-QFX10K
network:
type: string
description: Management network used for SNMP traffic
default: default
trap_groups:
type: array
items:
$ref: '#/components/schemas/snmp_config_trap_group'
description: SNMP trap group definitions
v2c_config:
type: array
items:
$ref: '#/components/schemas/snmp_config_v2c_config'
description: SNMPv2c community configuration entries for this SNMP profile
v3_config:
allOf:
- $ref: '#/components/schemas/snmpv3_config2'
- description: SNMPv3 user, VACM, notify, and target configuration
views:
type: array
items:
$ref: '#/components/schemas/snmp_config_view'
description: SNMP MIB view definitions
description: Management polling settings for SNMP on site devices
snmp_config5:
title: snmp_config5
type: object
properties:
client_list:
type: array
items:
$ref: '#/components/schemas/snmp_config_client_list'
description: SNMP client allowlists that can be referenced by communities
contact:
type: string
description: Administrative contact string advertised through SNMP
examples:
- cns@juniper.net
description:
type: string
description: Device description string advertised through SNMP
examples:
- Juniper QFX Series Switch - 1K_5LA
enabled:
type: boolean
description: Whether SNMP is enabled
default: true
engine_id:
maxLength: 27
type: string
description: SNMP engine ID used for SNMPv3
engine_id_type:
allOf:
- $ref: '#/components/schemas/snmp_config_engine_id_type2'
- description: 'Method used to derive the SNMP engine ID. enum: `local`, `use_mac_address`.'
location:
type: string
description: Physical location string advertised through SNMP
examples:
- Las Vegas, NV
name:
type: string
description: System name advertised through SNMP
examples:
- TGH-1K-QFX10K
network:
type: string
description: Management network used for SNMP traffic
default: default
trap_groups:
type: array
items:
$ref: '#/components/schemas/snmp_config_trap_group'
description: SNMP trap group definitions
v2c_config:
type: array
items:
$ref: '#/components/schemas/snmp_config_v2c_config'
description: SNMPv2c community configuration entries for this SNMP profile
v3_config:
allOf:
- $ref: '#/components/schemas/snmpv3_config2'
- description: SNMPv3 user, VACM, notify, and target configuration
views:
type: array
items:
$ref: '#/components/schemas/snmp_config_view'
description: SNMP MIB view definitions
description: SNMP configuration for this switch
snmp_usm_engine_type2:
title: snmp_usm_engine_type2
enum:
- local_engine
- remote_engine
type: string
description: 'SNMP engine type used for this USM configuration. enum: `local_engine`, `remote_engine`.'
snmp_usm_user_authentication_type2:
title: snmp_usm_user_authentication_type2
enum:
- authentication-md5
- authentication-none
- authentication-sha
- authentication-sha224
- authentication-sha256
- authentication-sha384
- authentication-sha512
type: string
description: 'Authentication protocol used by this SNMPv3 USM user. enum: `authentication-md5`, `authentication-none`, `authentication-sha`, `authentication-sha224`, `authentication-sha256`, `authentication-sha384`, `authentication-sha512`.'
snmp_usm_user_encryption_type2:
title: snmp_usm_user_encryption_type2
enum:
- privacy-3des
- privacy-aes128
- privacy-des
- privacy-none
type: string
description: 'Privacy protocol used by this SNMPv3 USM user. enum: `privacy-3des`, `privacy-aes128`, `privacy-des`, `privacy-none`.'
snmp_vacm_access_item_prefix_list_item_level2:
title: snmp_vacm_access_item_prefix_list_item_level2
enum:
- authentication
- none
- privacy
type: string
description: 'Required security level for this VACM access rule. enum: `authentication`, `none`, `privacy`.'
snmp_vacm_access_item_prefix_list_item_model2:
title: snmp_vacm_access_item_prefix_list_item_model2
enum:
- any
- usm
- v1
- v2c
type: string
description: 'Required security model for this VACM access rule. enum: `any`, `usm`, `v1`, `v2c`.'
snmp_vacm_access_item_type2:
title: snmp_vacm_access_item_type2
enum:
- context_prefix
- default_context_prefix
type: string
description: 'VACM context matching type for this access rule. enum: `context_prefix`, `default_context_prefix`.'
snmp_vacm_security_model2:
title: snmp_vacm_security_model2
enum:
- usm
- v1
- v2c
type: string
description: 'Required security model for these VACM group mappings. enum: `usm`, `v1`, `v2c`.'
snmp_vacm_security_to_group2:
title: snmp_vacm_security_to_group2
type: object
properties:
content:
type: array
items:
$ref: '#/components/schemas/snmp_vacm_security_to_group_content_item'
description: VACM security-name to group mapping entries
security_model:
allOf:
- $ref: '#/components/schemas/snmp_vacm_security_model2'
- description: 'Required security model for these VACM group mappings. enum: `usm`, `v1`, `v2c`.'
description: VACM security-name to group mappings
snmp_vacm2:
title: snmp_vacm2
type: object
properties:
access:
type: array
items:
$ref: '#/components/schemas/snmp_vacm_access_item'
description: VACM access rules for SNMPv3
security_to_group:
allOf:
- $ref: '#/components/schemas/snmp_vacm_security_to_group2'
- description: VACM security-name to group mappings
description: SNMPv3 VACM access control configuration
snmpv3_config2:
title: snmpv3_config2
type: object
properties:
notify:
type: array
items:
$ref: '#/components/schemas/snmpv3_config_notify_items'
description: SNMPv3 notification definitions used for traps and informs
notify_filter:
type: array
items:
$ref: '#/components/schemas/snmpv3_config_notify_filter_item'
description: SNMPv3 notification filter profiles
target_address:
type: array
items:
$ref: '#/components/schemas/snmpv3_config_target_address_item'
description: SNMPv3 notification target addresses
target_parameters:
type: array
items:
$ref: '#/components/schemas/snmpv3_config_target_param'
description: SNMPv3 target parameter profiles
usm:
type: array
items:
$ref: '#/components/schemas/snmp_usm'
description: SNMPv3 USM engine configurations
vacm:
allOf:
- $ref: '#/components/schemas/snmp_vacm2'
- description: SNMPv3 VACM access control configuration
description: SNMPv3 user, VACM, notify, and target configuration
snmpv3_config_notify_type2:
title: snmpv3_config_notify_type2
enum:
- inform
- trap
type: string
description: Delivery mode for this SNMPv3 notification, such as trap or inform
snmpv3_config_target_param_mess_process_model2:
title: snmpv3_config_target_param_mess_process_model2
enum:
- v1
- v2c
- v3
type: string
description: 'SNMP message processing model used by this target parameter profile. enum: `v1`, `v2c`, `v3`.'
snmpv3_config_target_param_security_level2:
title: snmpv3_config_target_param_security_level2
enum:
- authentication
- none
- privacy
type: string
description: 'Required security level for this target parameter profile. enum: `authentication`, `none`, `privacy`.'
snmpv3_config_target_param_security_model2:
title: snmpv3_config_target_param_security_model2
enum:
- usm
- v1
- v2c
type: string
description: 'Required security model for this target parameter profile. enum: `usm`, `v1`, `v2c`.'
spectrum_analysis_band2:
title: spectrum_analysis_band2
enum:
- '24'
- '5'
- '6'
type: string
description: 'Radio band to scan during spectrum analysis. enum: `24`, `5`, `6`.'
spectrum_analysis_format2:
title: spectrum_analysis_format2
enum:
- json
- stream
type: string
description: 'Output format for the spectrum analysis results. enum: `json`, `stream`.'
ssl_proxy_ciphers_category2:
title: ssl_proxy_ciphers_category2
enum:
- medium
- strong
- weak
type: string
description: 'Allowed cipher strength category for SSL proxy inspection. enum: `medium`, `strong`, `weak`.'
sso_idp_sign_algo2:
title: sso_idp_sign_algo2
enum:
- sha1
- sha256
- sha384
- sha512
type: string
description: 'SAML assertion signing algorithm. Required if `idp_type`==`saml`. enum: `sha1`, `sha256`, `sha384`, `sha512`.'
sso_idp_type2:
title: sso_idp_type2
enum:
- ldap
- mxedge_proxy
- oauth
- saml
- openroaming
type: string
description: 'Identity provider type for this SSO configuration. enum: `ldap`, `mxedge_proxy`, `oauth`, `saml`, `openroaming`.'
sso_ldap_type2:
title: sso_ldap_type2
enum:
- azure
- custom
- google
- okta
type: string
description: 'Provider template for LDAP SSO when `idp_type`==`ldap`. enum: `azure`, `custom`, `google`, `okta`.'
sso_mxedge_proxy2:
title: sso_mxedge_proxy2
type: object
properties:
acct_servers:
type: array
items:
$ref: '#/components/schemas/sso_mxedge_proxy_acct_server'
description: RADIUS accounting servers used by the Mist Edge SSO proxy
auth_servers:
type: array
items:
$ref: '#/components/schemas/sso_mxedge_proxy_auth_server'
description: RADIUS authentication servers used by the Mist Edge SSO proxy
mxcluster_id:
type: string
description: Mist Edge cluster identifier that provides the SSO proxy
contentEncoding: uuid
examples:
- 572586b7-f97b-a22b-526c-8b97a3f609c4
operator_name:
type: string
description: Operator name as RADIUS attribute while proxying
proxy_hosts:
type: array
items:
type: string
description: Public hostnames or IP addresses that clients use to reach the Mist Edge SSO proxy
examples:
- - mxedge1.corp.com
- 63.1.3.5
ssids:
type: array
items:
type: string
description: Eduroam SSIDs handled by the Mist Edge SSO proxy
examples:
- - eduroam_test, eduroam_main
description: Mist Edge proxy settings used when `idp_type`==`mxedge_proxy`
sso_nameid_format2:
title: sso_nameid_format2
enum:
- email
- unspecified
type: string
description: 'SAML NameID format used when `idp_type`==`saml`. enum: `email`, `unspecified`.'
sso_oauth_type2:
title: sso_oauth_type2
enum:
- azure
- azure-gov
- okta
- ping_identity
type: string
description: 'Provider type for OAuth SSO when `idp_type`==`oauth`. enum: `azure`, `azure-gov`, `okta`, `ping_identity`.'
ssr_proxy2:
title: ssr_proxy2
type: object
properties:
disabled:
type: boolean
description: Whether the SSR proxy configuration is disabled
default: false
examples:
- true
url:
type: string
description: Proxy URL that SSR devices use to reach Mist
examples:
- https://proxy.corp.com:8080/
description: Network proxy settings used by SSR devices to reach Mist
ssr_upgrade_channel1:
title: ssr_upgrade_channel1
enum:
- alpha
- beta
- stable
type: string
description: 'Firmware release channel to use for the SSR upgrade. enum: `alpha`, `beta`, `stable`.'
ssr_upgrade_channel4:
title: ssr_upgrade_channel4
enum:
- alpha
- beta
- stable
type: string
description: 'Firmware release channel used for SSR auto-upgrade. enum: `alpha`, `beta`, `stable`.'
ssr_upgrade_strategy2:
title: ssr_upgrade_strategy2
enum:
- big_bang
- serial
type: string
description: 'Upgrade rollout strategy for the targeted SSR devices. enum: `big_bang`, `serial`.'
stats_ap_auto_placement_info_probability_surface2:
title: stats_ap_auto_placement_info_probability_surface2
type: object
properties:
radius:
type: number
description: The RADIUS representing placement uncertainty, measured in pixels
examples:
- 2.1
radius_m:
type: number
description: The RADIUS representing placement uncertainty, measured in meters
x:
type: number
description: Potential placement center X coordinate, in pixels
examples:
- 17
description: Uncertainty area for the AP auto placement result
stats_ap_auto_placement_info2:
title: stats_ap_auto_placement_info2
type: object
properties:
cluster_number:
type: integer
description: All APs sharing a given cluster number can be placed relative to each other
contentEncoding: int32
examples:
- 0
orientation_stats:
type: integer
description: The orientation of an AP
contentEncoding: int32
examples:
- 0
probability_surface:
allOf:
- $ref: '#/components/schemas/stats_ap_auto_placement_info_probability_surface2'
- description: Uncertainty area for the AP auto placement result
description: Additional diagnostics for the AP auto placement result
stats_ap_auto_placement2:
title: stats_ap_auto_placement2
type: object
properties:
info:
allOf:
- $ref: '#/components/schemas/stats_ap_auto_placement_info2'
- description: Additional diagnostics for the AP auto placement result
recommended_anchor:
type: boolean
description: Flag to represent if AP is recommended as an anchor by auto placement service
status:
type: string
description: Current auto placement status for the AP
examples:
- localized
status_detail:
type: string
description: Additional info about placement status
examples:
- localized
x:
type: number
description: Auto-placed X coordinate, in pixels
examples:
- 53.5
x_m:
type: number
description: Auto-placed X coordinate, in meters
examples:
- 5.35
y:
type: number
description: Auto-placed Y coordinate, in pixels
examples:
- 173.1
y_m:
type: number
description: Auto-placed Y coordinate, in meters
examples:
- 17.31
description: Auto placement result and status for the AP
stats_ap_auto_upgrade2:
title: stats_ap_auto_upgrade2
type: object
properties:
lastcheck:
type:
- integer
- 'null'
description: Time when the AP last checked for auto-upgrade, in epoch seconds
contentEncoding: int64
readOnly: true
examples:
- 1720594762
description: Automatic firmware upgrade status for the switch
stats_ap_auto_upgrade3:
title: stats_ap_auto_upgrade3
type: object
properties:
lastcheck:
type:
- integer
- 'null'
description: Time when the AP last checked for auto-upgrade, in epoch seconds
contentEncoding: int64
readOnly: true
examples:
- 1720594762
description: Automatic firmware upgrade status for the gateway
stats_ap_auto_upgrade4:
title: stats_ap_auto_upgrade4
type: object
properties:
lastcheck:
type:
- integer
- 'null'
description: Time when the AP last checked for auto-upgrade, in epoch seconds
contentEncoding: int64
readOnly: true
examples:
- 1720594762
description: Automatic firmware upgrade status for the AP
stats_ap_ble2:
title: stats_ap_ble2
type: object
properties:
beacon_enabled:
type:
- boolean
- 'null'
description: Whether Mist BLE beacon transmission is enabled
readOnly: true
beacon_rate:
type:
- integer
- 'null'
description: Mist BLE beacon transmit rate, in beacons per second
contentEncoding: int32
readOnly: true
examples:
- 3
eddystone_uid_enabled:
type:
- boolean
- 'null'
description: Whether Eddystone-UID beacon transmission is enabled
readOnly: true
examples:
- false
eddystone_uid_freq_msec:
type:
- integer
- 'null'
description: Interval for Eddystone-UID advertisements, in milliseconds
contentEncoding: int32
readOnly: true
examples:
- 2000
eddystone_uid_instance:
type:
- string
- 'null'
description: Eddystone-UID instance value broadcast by the AP
readOnly: true
examples:
- 5c5b35000001
eddystone_uid_namespace:
type:
- string
- 'null'
description: Eddystone-UID namespace value broadcast by the AP
readOnly: true
examples:
- 2818e3868dec25629ede
eddystone_url_enabled:
type:
- boolean
- 'null'
description: Whether Eddystone-URL beacon transmission is enabled
readOnly: true
examples:
- true
eddystone_url_freq_msec:
type:
- integer
- 'null'
description: Interval for Eddystone-URL advertisements, in milliseconds
contentEncoding: int32
readOnly: true
examples:
- 100
eddystone_url_url:
type:
- string
- 'null'
description: URL broadcast by the Eddystone-URL beacon
readOnly: true
examples:
- https://www.abc.com
ibeacon_enabled:
type:
- boolean
- 'null'
description: Whether iBeacon transmission is enabled
readOnly: true
examples:
- true
ibeacon_freq_msec:
type:
- integer
- 'null'
description: Interval for iBeacon advertisements, in milliseconds
contentEncoding: int32
readOnly: true
examples:
- 2000
ibeacon_major:
maximum: 65535
minimum: 1
type:
- integer
- 'null'
description: Major value broadcast in iBeacon advertisements
contentEncoding: int32
examples:
- 1234
ibeacon_minor:
maximum: 65535
minimum: 1
type:
- integer
- 'null'
description: Minor value broadcast in iBeacon advertisements
contentEncoding: int32
examples:
- 1234
ibeacon_uuid:
type:
- string
- 'null'
description: UUID value broadcast in iBeacon advertisements
contentEncoding: uuid
examples:
- f3f17139-704a-f03a-2786-0400279e37c3
major:
type:
- integer
- 'null'
description: Reported iBeacon major value for BLE statistics
contentEncoding: int32
readOnly: true
examples:
- 12345
minors:
type: array
items:
type: integer
contentEncoding: int32
description: Reported iBeacon minor values for BLE statistics
power:
type:
- integer
- 'null'
description: BLE transmit power setting reported by the AP
contentEncoding: int32
readOnly: true
examples:
- 10
rx_bytes:
type:
- integer
- 'null'
description: BLE bytes received by the AP
contentEncoding: int64
readOnly: true
examples:
- 8515104416
rx_pkts:
type:
- integer
- 'null'
description: BLE packets received by the AP
contentEncoding: int64
readOnly: true
examples:
- 57770567
tx_bytes:
type:
- integer
- 'null'
description: BLE bytes transmitted by the AP
contentEncoding: int64
readOnly: true
examples:
- 211217389682
tx_pkts:
type:
- integer
- 'null'
description: BLE packets transmitted by the AP
contentEncoding: int64
readOnly: true
examples:
- 812204062
tx_resets:
type:
- integer
- 'null'
description: Resets due to tx hung
contentEncoding: int32
readOnly: true
examples:
- 0
uuid:
type:
- string
- 'null'
description: Beacon UUID reported by BLE statistics
contentEncoding: uuid
readOnly: true
examples:
- ada72f8f-1643-e5c6-94db-f2a5636f1a64
description: BLE radio and beacon statistics reported by the AP
stats_ap_env_stat2:
title: stats_ap_env_stat2
type: object
properties:
accel_x:
type:
- number
- 'null'
description: X-axis accelerometer reading reported by the AP
readOnly: true
examples:
- 0
accel_y:
type:
- number
- 'null'
description: Y-axis accelerometer reading reported by the AP
readOnly: true
examples:
- 0.032
accel_z:
type:
- number
- 'null'
description: Z-axis accelerometer reading reported by the AP
readOnly: true
examples:
- -1.088
ambient_temp:
type:
- integer
- 'null'
description: Temperature reading from the AP ambient sensor
contentEncoding: int32
readOnly: true
examples:
- 43
attitude:
type:
- integer
- 'null'
description: Device attitude or orientation reading reported by the AP
contentEncoding: int32
readOnly: true
examples:
- 0
cpu_temp:
type:
- integer
- 'null'
description: Temperature reading from the AP CPU sensor
contentEncoding: int32
readOnly: true
examples:
- 61
humidity:
type:
- integer
- 'null'
description: Relative humidity sensor reading reported by the AP
contentEncoding: int32
readOnly: true
examples:
- 9
magne_x:
type:
- number
- 'null'
description: X-axis magnetometer reading reported by the AP
readOnly: true
examples:
- 0
magne_y:
type:
- number
- 'null'
description: Y-axis magnetometer reading reported by the AP
readOnly: true
examples:
- 0
magne_z:
type:
- number
- 'null'
description: Z-axis magnetometer reading reported by the AP
readOnly: true
examples:
- 0
pressure:
type:
- number
- 'null'
description: Barometric pressure sensor reading reported by the AP
readOnly: true
examples:
- 968
vcore_voltage:
type:
- integer
- 'null'
description: Core voltage sensor reading reported by the AP
contentEncoding: int32
readOnly: true
examples:
- 0
description: Environmental sensor readings reported by the AP
stats_ap_esl_stat2:
title: stats_ap_esl_stat2
type: object
properties:
channel:
type:
- integer
- 'null'
description: Radio channel used by the ESL dongle
contentEncoding: int32
readOnly: true
connected:
type:
- boolean
- 'null'
description: Whether the ESL dongle is connected
readOnly: true
ip:
type:
- string
- 'null'
description: Network IP address of Hanshow and SoluM dongles
readOnly: true
examples:
- 172.16.2.249
mac:
type:
- string
- 'null'
description: Dongle MAC address for Hanshow and SoluM dongles
readOnly: true
examples:
- 98-6d-35-79-76-3b
product_id:
type:
- string
- 'null'
description: Product ID of Hanshow and SoluM dongles
readOnly: true
examples:
- A4A2
type:
type:
- string
- 'null'
description: ESL dongle type reported by the AP
readOnly: true
examples:
- imagotag
up:
type:
- boolean
- 'null'
description: Whether the ESL dongle is operational
readOnly: true
vendor_id:
type:
- string
- 'null'
description: Vendor ID of Hanshow and SoluM dongles
readOnly: true
examples:
- '0525'
description: Electronic shelf label dongle status reported by the AP
stats_ap_gps_stat_src2:
title: stats_ap_gps_stat_src2
enum:
- gps
- other_ap
- other_aps
type: string
description: 'Source of the GPS location data. enum: `gps`, `other_ap`, `other_aps`.'
stats_ap_gps_stat2:
title: stats_ap_gps_stat2
type: object
properties:
accuracy:
type: number
description: The estimated accuracy or accuracy of the GPS coordinates, measured in meters.
examples:
- 12.5
altitude:
type: number
description: The elevation of the AP above sea level, measured in meters.
examples:
- 99.939
latitude:
type: number
description: The geographic latitude of the AP, measured in degrees.
examples:
- 37.29548
longitude:
type: number
description: The geographic longitude of the AP, measured in degrees.
examples:
- -122.03304
src:
allOf:
- $ref: '#/components/schemas/stats_ap_gps_stat_src2'
- description: 'Source of the GPS location data. enum: `gps`, `other_ap`, `other_aps`.'
timestamp:
type: number
description: Time when the GPS location data was observed, in epoch seconds
readOnly: true
description: GPS location data reported for the AP
stats_ap_lldp_stat2:
title: stats_ap_lldp_stat2
type: object
properties:
chassis_id:
type:
- string
- 'null'
description: LLDP neighbor chassis identifier
readOnly: true
lldp_med_supported:
type:
- boolean
- 'null'
description: Whether it support LLDP-MED
readOnly: true
mgmt_addr:
type:
- string
- 'null'
description: Management IP address of the switch
readOnly: true
mgmt_addrs:
type: array
items:
type: string
description: Management IP addresses advertised by the LLDP neighbor
port_desc:
type:
- string
- 'null'
description: Port description, e.g. “2/20”, “Port 2 on Switch0”
readOnly: true
examples:
- 2/20
port_id:
type:
- string
- 'null'
description: LLDP neighbor port identifier
readOnly: true
examples:
- ge-0/0/4
power_allocated:
type:
- number
- 'null'
description: In mW, power allocated by PSE
readOnly: true
power_avail:
type: integer
description: In mW, total Power Avail at AP from pwr source
contentEncoding: int32
power_budget:
type: integer
description: In mW, surplus if positive or deficit if negative
contentEncoding: int32
power_constrained:
type: boolean
description: Whether power is insufficient
power_draw:
type:
- number
- 'null'
description: In mW, total power needed by PD
readOnly: true
power_needed:
type: integer
description: In mW, total Power needed incl Peripherals
contentEncoding: int32
power_opmode:
type: string
description: Power operating mode negotiated through LLDP
power_request_count:
type:
- integer
- 'null'
description: Number of negotiations, if it keeps increasing, we don’ t have a stable power
contentEncoding: int32
readOnly: true
power_requested:
type:
- number
- 'null'
description: In mW, power requested by PD
readOnly: true
power_src:
type: string
description: Primary AP power source reported through LLDP
power_srcs:
type: array
items:
type: string
description: AP power sources reported through LLDP
system_desc:
type:
- string
- 'null'
description: Description provided by switch
readOnly: true
examples:
- 'uniper Networks, Inc. ex4300-48t internet router, kernel JUNOS 20.4R3-S7.2, Build date: 2023-04-21 19:47:18 UTC Copyright (c) 1996-2023 Juniper Networks, Inc.'
system_name:
type:
- string
- 'null'
description: Name of the switch
readOnly: true
examples:
- Core-AE23
description: Primary LLDP neighbor and power negotiation details for the AP
stats_ap_radio_config_band1:
title: stats_ap_radio_config_band1
type: object
properties:
allow_rrm_disable:
type:
- boolean
- 'null'
description: Whether RRM disablement is allowed for this radio band
readOnly: true
bandwidth:
type:
- number
- 'null'
description: Channel bandwidth configured for this radio band
readOnly: true
examples:
- 20
channel:
type: integer
description: Operating channel configured for this radio band
contentEncoding: int32
examples:
- 1
disabled:
type:
- boolean
- 'null'
description: Whether this radio band is disabled
readOnly: true
dynamic_chaining_enabled:
type:
- boolean
- 'null'
description: Whether dynamic chaining is enabled for this radio band
readOnly: true
examples:
- false
power:
type:
- number
- 'null'
description: Transmit power configured for this radio band
readOnly: true
examples:
- 10
power_max:
type:
- number
- 'null'
description: Maximum transmit power allowed for this radio band
readOnly: true
examples:
- 10
power_min:
type:
- number
- 'null'
description: Minimum transmit power allowed for this radio band
readOnly: true
examples:
- 10
rx_chain:
type:
- integer
- 'null'
description: Number of receive chains enabled for this radio band
contentEncoding: int32
readOnly: true
examples:
- 4
tx_chain:
type:
- integer
- 'null'
description: Number of transmit chains enabled for this radio band
contentEncoding: int32
readOnly: true
examples:
- 4
description: 5 GHz radio configuration reported by the AP
stats_ap_radio_config_band2:
title: stats_ap_radio_config_band2
type: object
properties:
allow_rrm_disable:
type:
- boolean
- 'null'
description: Whether RRM disablement is allowed for this radio band
readOnly: true
bandwidth:
type:
- number
- 'null'
description: Channel bandwidth configured for this radio band
readOnly: true
examples:
- 20
channel:
type: integer
description: Operating channel configured for this radio band
contentEncoding: int32
examples:
- 1
disabled:
type:
- boolean
- 'null'
description: Whether this radio band is disabled
readOnly: true
dynamic_chaining_enabled:
type:
- boolean
- 'null'
description: Whether dynamic chaining is enabled for this radio band
readOnly: true
examples:
- false
power:
type:
- number
- 'null'
description: Transmit power configured for this radio band
readOnly: true
examples:
- 10
power_max:
type:
- number
- 'null'
description: Maximum transmit power allowed for this radio band
readOnly: true
examples:
- 10
power_min:
type:
- number
- 'null'
description: Minimum transmit power allowed for this radio band
readOnly: true
examples:
- 10
rx_chain:
type:
- integer
- 'null'
description: Number of receive chains enabled for this radio band
contentEncoding: int32
readOnly: true
examples:
- 4
tx_chain:
type:
- integer
- 'null'
description: Number of transmit chains enabled for this radio band
contentEncoding: int32
readOnly: true
examples:
- 4
description: 6 GHz radio configuration reported by the AP
stats_ap_radio_config_band4:
title: stats_ap_radio_config_band4
type: object
properties:
allow_rrm_disable:
type:
- boolean
- 'null'
description: Whether RRM disablement is allowed for this radio band
readOnly: true
bandwidth:
type:
- number
- 'null'
description: Channel bandwidth configured for this radio band
readOnly: true
examples:
- 20
channel:
type: integer
description: Operating channel configured for this radio band
contentEncoding: int32
examples:
- 1
disabled:
type:
- boolean
- 'null'
description: Whether this radio band is disabled
readOnly: true
dynamic_chaining_enabled:
type:
- boolean
- 'null'
description: Whether dynamic chaining is enabled for this radio band
readOnly: true
examples:
- false
power:
type:
- number
- 'null'
description: Transmit power configured for this radio band
readOnly: true
examples:
- 10
power_max:
type:
- number
- 'null'
description: Maximum transmit power allowed for this radio band
readOnly: true
examples:
- 10
power_min:
type:
- number
- 'null'
description: Minimum transmit power allowed for this radio band
readOnly: true
examples:
- 10
rx_chain:
type:
- integer
- 'null'
description: Number of receive chains enabled for this radio band
contentEncoding: int32
readOnly: true
examples:
- 4
tx_chain:
type:
- integer
- 'null'
description: Number of transmit chains enabled for this radio band
contentEncoding: int32
readOnly: true
examples:
- 4
description: 2.4 GHz radio configuration reported by the AP
stats_ap_radio_config2:
title: stats_ap_radio_config2
type: object
properties:
band_24:
allOf:
- $ref: '#/components/schemas/stats_ap_radio_config_band4'
- description: 2.4 GHz radio configuration reported by the AP
band_24_usage:
type:
- string
- 'null'
description: Current operating use for the 2.4 GHz radio
readOnly: true
examples:
- '5'
band_5:
allOf:
- $ref: '#/components/schemas/stats_ap_radio_config_band1'
- description: 5 GHz radio configuration reported by the AP
band_6:
allOf:
- $ref: '#/components/schemas/stats_ap_radio_config_band2'
- description: 6 GHz radio configuration reported by the AP
scanning_enabled:
type: boolean
description: Whether radio scanning is enabled on the AP
description: Radio configuration currently applied to the AP
stats_ap_radio_stat2:
title: stats_ap_radio_stat2
type: object
properties:
band_24:
allOf:
- $ref: '#/components/schemas/ap_radio_stat1'
- description: 2.4 GHz radio statistics reported by the AP
band_5:
allOf:
- $ref: '#/components/schemas/ap_radio_stat2'
- description: 5 GHz radio statistics reported by the AP
band_6:
allOf:
- $ref: '#/components/schemas/ap_radio_stat3'
- description: 6 GHz radio statistics reported by the AP
description: Radio statistics reported by AP bands
stats_ap_switch_redundancy2:
title: stats_ap_switch_redundancy2
type: object
properties:
num_redundant_aps:
type:
- integer
- 'null'
description: Number of redundant APs available for switch redundancy
contentEncoding: int32
readOnly: true
examples:
- 1
description: Switch redundancy status reported for the AP
stats_ap_usb_stat2:
title: stats_ap_usb_stat2
type: object
properties:
channel:
type:
- integer
- 'null'
description: Radio channel used by the USB peripheral
contentEncoding: int32
readOnly: true
examples:
- 3
connected:
type:
- boolean
- 'null'
description: Whether the USB peripheral is connected
readOnly: true
examples:
- true
last_activity:
type:
- integer
- 'null'
description: Time of the last USB peripheral activity, in epoch seconds
contentEncoding: int32
readOnly: true
examples:
- 1586873254
type:
type:
- string
- 'null'
description: USB peripheral type reported by the AP
readOnly: true
examples:
- imagotag
up:
type:
- boolean
- 'null'
description: Whether the USB peripheral is operational
readOnly: true
examples:
- true
description: USB peripheral status reported by the AP
stats_ap_zigbee_stat2:
title: stats_ap_zigbee_stat2
type: object
properties:
iotproxy_status:
type:
- string
- 'null'
description: Connection status of the IoT proxy
readOnly: true
examples:
- connected
num_iotendpoints:
type:
- integer
- 'null'
description: Number of IoT endpoints connected through the AP
contentEncoding: int32
readOnly: true
examples:
- 3
description: ZigBee statistics reported by the AP, present only when ZigBee is enabled on the AP
stats_cluster_config_control_link_info2:
title: stats_cluster_config_control_link_info2
type: object
properties:
name:
type: string
description: Control link interface name reported by the gateway cluster
status:
type: string
description: Operational state reported for the control link
description: Control link interface and operational state for the gateway cluster
stats_cluster_config_fabric_link_info2:
title: stats_cluster_config_fabric_link_info2
type: object
properties:
DataPlaneNotifiedStatus:
type: string
description: Fabric link data-plane notification status reported by the gateway
Interface:
uniqueItems: true
type: array
items:
type: string
description: Fabric link interfaces reported for the gateway cluster
InternalStatus:
type: string
description: Gateway-reported internal status for the fabric link
State:
type: string
description: Administrative state of the fabric link
Status:
type: string
description: Operational status of the fabric link
description: Fabric link state and data-plane notification details for the gateway cluster
stats_cluster_config1:
title: stats_cluster_config1
type: object
properties:
configuration:
type: string
description: Configured high-availability mode for the gateway cluster, such as active-active
control_link_info:
allOf:
- $ref: '#/components/schemas/stats_cluster_config_control_link_info2'
- description: Control link interface and operational state for the gateway cluster
ethernet_connection:
type: array
items:
$ref: '#/components/schemas/stats_cluster_config_ethernet_connection_item'
description: Ethernet interface connection states used by the gateway cluster
fabric_link_info:
allOf:
- $ref: '#/components/schemas/stats_cluster_config_fabric_link_info2'
- description: Fabric link state and data-plane notification details for the gateway cluster
last_status_change_reason:
type: string
description: Reason reported for the most recent gateway cluster status change
operational:
type: string
description: Current operational high-availability mode of the gateway cluster
primary_node_health:
type: string
description: Health state reported for the primary gateway cluster node
redundancy_group_information:
type: array
items:
$ref: '#/components/schemas/stats_cluster_config_redundancy_group_info_item'
description: Redundancy group monitoring state reported by the gateway cluster
secondary_node_health:
type: string
description: Health state reported for the secondary gateway cluster node
status:
type: string
description: Overall health status reported for the gateway cluster
description: High-availability cluster configuration and health for the gateway
stats_device_other_vendor_specific2:
title: stats_device_other_vendor_specific2
type: object
properties:
interfaces:
type: object
additionalProperties:
$ref: '#/components/schemas/stats_device_other_vendor_specific_port'
description: Cradlepoint interface statistics keyed by vendor interface identifier
examples:
- mdm-4d0e073b:
bytes_in: 5623096929
bytes_out: 12372750366
carrier: Orange
imei: '866401234567893'
imsi: '2080101234567893'
ip: 10.134.237.57
link: true
mode: wan
rsrp: -108
rsrq: -14
rssi: -74
service_mode: 5G NSA
sinr: -1.2
state: READY
type: mdm
uptime: 2095779
target_version:
type: string
description: Cradlepoint software version targeted for the device
examples:
- 7.23.40
description: Additional statistics returned by the device vendor
stats_gateway_cluster2:
title: stats_gateway_cluster2
type: object
properties:
state:
type:
- string
- 'null'
description: Current HA cluster state for the gateway
readOnly: true
description: High-availability cluster state summary for the gateway
stats_gateway_mac_table_stats2:
title: stats_gateway_mac_table_stats2
type: object
properties:
mac_table_count:
type: integer
description: Number of MAC table entries currently learned by the gateway
contentEncoding: int32
max_mac_entries_supported:
type: integer
description: Maximum MAC table entries supported by the gateway
contentEncoding: int32
description: Layer 2 MAC table utilization statistics for the gateway
stats_gateway_service_status2:
title: stats_gateway_service_status2
type: object
properties:
appid_install_result:
type: string
description: Installation result reported for the AppID package
appid_install_timestamp:
type: string
description: Installation time reported for the AppID package
appid_status:
type: string
description: Operational status of the AppID service on the gateway
appid_version:
type: integer
description: Installed AppID package version number
contentEncoding: int32
ewf_status:
type: string
description: Enhanced Web Filtering service status reported by the gateway
idp_install_result:
type: string
description: Installation result reported for the intrusion detection and prevention package
idp_install_timestamp:
type: string
description: Installation time reported for the intrusion detection and prevention package
idp_policy:
type: string
description: Intrusion detection and prevention policy applied to the gateway
idp_status:
type: string
description: Intrusion detection and prevention service status reported by the gateway
idp_update_timestamp:
type: string
description: Last update time reported for the intrusion detection and prevention package
description: Security service status reported by the gateway
stats_marvis_client_location1:
title: stats_marvis_client_location1
type: object
properties:
map_id:
type: string
description: UUID of the floor-plan map
contentEncoding: uuid
site_id:
type: string
description: UUID of the site the device was located in
contentEncoding: uuid
timestamp:
type: integer
description: Timestamp of the location fix, in epoch seconds
contentEncoding: int32
x:
type: number
description: X coordinate on the floor-plan map, in pixels
y:
type: number
description: Y coordinate on the floor-plan map, in pixels
description: Last known device location
stats_mxedge_cpu_stat2:
title: stats_mxedge_cpu_stat2
type: object
properties:
cpus:
type: object
additionalProperties:
$ref: '#/components/schemas/cpu_stat'
description: Per-core CPU utilization statistics keyed by CPU name
examples:
- cpu0:
idle: 89
interrupt: 0
system: 8
usage: 10
user: 1
cpu1:
idle: 81
interrupt: 0
system: 4
usage: 18
user: 13
cpu2:
idle: 81
interrupt: 0
system: 4
usage: 18
user: 13
cpu3:
idle: 2
interrupt: 0
system: 50
usage: 97
user: 46
idle:
type: integer
description: Percentage of Idle, Idle/(Idle + Busy) since last sampling
contentEncoding: int32
examples:
- 62
interrupt:
type: integer
description: Percentage of Interrupt, (Irq + SoftIrq)/(Idle + Busy) since last sampling
contentEncoding: int32
examples:
- 0
system:
type: integer
description: Percentage of System, System/(Idle + Busy) since last sampling
contentEncoding: int32
examples:
- 17
usage:
type: integer
description: Percentage of load, Busy/(Idle + Busy) since last sampling
contentEncoding: int32
examples:
- 37
user:
type: integer
description: Percentage of User, User/(Idle + Busy) since last sampling
contentEncoding: int32
examples:
- 19
description: CPU utilization statistics reported by the Mist Edge
stats_mxedge_inactive_vlan_strs2:
title: stats_mxedge_inactive_vlan_strs2
type: object
properties:
l2tp:
type: array
items:
type: string
description: Inactive L2TP VLANs. Entries can be individual VLANs or ranges.
wired:
type: array
items:
type: string
description: Inactive wired VLANs. Entries can be individual VLANs or ranges.
examples:
- - '100'
- 102-106
description: Inactive VLAN identifiers reported by the Mist Edge
stats_mxedge_ip_stat2:
title: stats_mxedge_ip_stat2
type: object
properties:
ip:
type: string
description: Primary IPv4 address reported for the Mist Edge
examples:
- 192.168.1.244
ip6:
type: string
description: Primary IPv6 address reported for the Mist Edge
examples:
- fd4e:c615:b27d:5555::45
ips:
type: object
additionalProperties:
type: string
description: Interface IP addresses keyed by interface name
examples:
- ens18: 92.168.1.244/24,fd4e:c615:b27d:5555::45/128,fd4e:c615:b27d:5555:20c:29ff:fe44:af25/64,fe80::104c:ffff:fee0:caf8/64
macs:
type: object
additionalProperties:
type: string
description: Interface MAC addresses keyed by interface name
examples:
- ens18: e4434b217044
netmask:
type: string
description: IPv4 netmask reported for the primary Mist Edge address
examples:
- 255.255.255.0
netmask6:
type: string
description: IPv6 prefix length reported for the primary Mist Edge address
examples:
- /128
description: IP address statistics reported by the Mist Edge
stats_mxedge_memory_stat2:
title: stats_mxedge_memory_stat2
type: object
properties:
active:
type: integer
description: The amount of memory, in kilobytes, that has been used more recently and is usually not reclaimed unless absolutely necessary.
contentEncoding: int32
examples:
- 394936320
available:
type: integer
description: An estimate of how much memory is available for starting new applications, without swapping.
contentEncoding: int64
examples:
- 4699291648
buffers:
type: integer
description: The amount, in kilobytes, of temporary storage for raw disk blocks.
contentEncoding: int32
examples:
- 107646976
cached:
type: integer
description: The amount of physical RAM, in kilobytes, used as cache memory.
contentEncoding: int32
examples:
- 478060544
free:
type: integer
description: The amount of physical RAM, in kilobytes, left unused by the system
contentEncoding: int64
examples:
- 4330659840
inactive:
type: integer
description: The amount of memory, in kilobytes, that has been used less recently and is more eligible to be reclaimed for other purposes.
contentEncoding: int32
examples:
- 211980288
swap_cached:
type: integer
description: The amount of memory, in kilobytes, that has once been moved into swap, then back into the main memory, but still also remains in the swapfile.
contentEncoding: int32
examples:
- 0
swap_free:
type: integer
description: The total amount of swap free, in kilobytes.
contentEncoding: int32
examples:
- 1022357504
swap_total:
type: integer
description: The total amount of swap available, in kilobytes.
contentEncoding: int32
examples:
- 1022357504
total:
type: integer
description: Usable RAM total, in kilobytes, which is physical RAM minus a number of reserved bits and the kernel binary code
contentEncoding: int64
examples:
- 8365957120
usage:
type: integer
description: Memory utilization percentage reported by the Mist Edge
contentEncoding: int32
examples:
- 48
description: Memory utilization statistics reported by the Mist Edge
stats_mxedge_oob_ip_stat2:
title: stats_mxedge_oob_ip_stat2
type: object
properties:
dns:
uniqueItems: true
type: array
items:
type: string
description: Out-of-band management DNS servers
gateway:
type: string
description: IPv4 default gateway for out-of-band management
gateway6:
type: string
description: IPv6 default gateway for out-of-band management
ip:
type: string
description: Out-of-band management IPv4 address
ip6:
type: string
description: Out-of-band management IPv6 address
netmask:
type: string
description: IPv4 netmask for the out-of-band management interface
netmask6:
type: string
description: IPv6 prefix length for the out-of-band management interface
type:
allOf:
- $ref: '#/components/schemas/mxedge_mgmt_oob_ip_type2'
- description: 'IPv4 address assignment mode for out-of-band management. enum: `dhcp`, `disabled`, `static`.'
type8:
allOf:
- $ref: '#/components/schemas/mxedge_mgmt_oob_ip_type62'
- description: 'IPv6 address assignment mode for out-of-band management. enum: `autoconf`, `dhcp`, `disabled`, `static`.'
description: Observed out-of-band management IP status for the Mist Edge
stats_mxedge_port_stat_lacp2:
title: stats_mxedge_port_stat_lacp2
type: object
properties:
mux_state:
type: string
description: LACP multiplexer state reported for the port
rx_lacpdu:
type: integer
description: Number of LACPDUs received on the port
contentEncoding: int32
rx_state:
type: string
description: LACP receive state reported for the port
tx_lacpdu:
type: integer
description: Number of LACPDUs transmitted from the port
contentEncoding: int32
description: Link aggregation control protocol state and packet counters for the port
stats_mxedge_port_stat_lldp_stats2:
title: stats_mxedge_port_stat_lldp_stats2
type: object
properties:
chassis_id:
type: string
description: LLDP chassis identifier advertised by the neighbor
mgmt_addr:
type: string
description: Management address advertised by the LLDP neighbor
port_desc:
type: string
description: Port description advertised by the LLDP neighbor
port_id:
type: string
description: Port identifier advertised by the LLDP neighbor
system_desc:
type: string
description: System description advertised by the LLDP neighbor
system_name:
type: string
description: System name advertised by the LLDP neighbor
description: LLDP neighbor information learned on the port
stats_mxedge_port_stat_sfp2:
title: stats_mxedge_port_stat_sfp2
type: object
properties:
codes:
type: string
description: Transceiver capability codes reported by the SFP module
mbps:
type: integer
description: Nominal transceiver speed, in Mbps
contentEncoding: int32
part_no:
type: string
description: Manufacturer part number reported by the SFP module
serial_no:
type: string
description: Manufacturer serial number reported by the SFP module
type:
type: integer
description: Transceiver type code reported by the SFP module
contentEncoding: int32
vendor:
type: string
description: Manufacturer name reported by the SFP module
description: Transceiver details reported for the SFP module on the port
stats_mxedge_tunterm_ip_config2:
title: stats_mxedge_tunterm_ip_config2
type: object
properties:
gateway:
type: string
description: IPv4 default gateway for tunnel termination traffic
examples:
- 192.168.11.1
ip:
type: string
description: Tunnel termination IPv4 address used by the Mist Edge
examples:
- 192.168.11.91
netmask:
type: string
description: IPv4 netmask for the tunnel termination address
examples:
- 255.255.255.0
description: Configured tunnel termination IP settings for the Mist Edge
stats_mxedge_tunterm_port_config2:
title: stats_mxedge_tunterm_port_config2
type: object
properties:
downstream_ports:
type: array
items:
type: string
description: Ports configured for downstream tunnel termination traffic
examples:
- - '0'
- '1'
separate_upstream_downstream:
type: boolean
description: Whether separate port sets are used for upstream and downstream tunnel termination traffic
examples:
- false
upstream_ports:
type: array
items:
type: string
description: Ports configured for upstream tunnel termination traffic
examples:
- - '0'
- '1'
description: Tunnel termination port configuration reported for the Mist Edge
stats_mxedge_tunterm_stat2:
title: stats_mxedge_tunterm_stat2
type: object
properties:
monitoring_failed:
type: boolean
description: Whether tunnel termination monitoring is currently failing
examples:
- false
description: Tunnel termination monitoring status reported by the Mist Edge
stats_mxtunnel_state2:
title: stats_mxtunnel_state2
enum:
- established
- established_with_sessions
- idle
- wait-ctrl-conn
- wait-ctrl-reply
type: string
description: 'Current state of the WxLAN or Mist tunnel. enum: `established`, `established_with_sessions`, `idle`, `wait-ctrl-conn`, `wait-ctrl-reply`.'
stats_org_sle_user_minutes2:
title: stats_org_sle_user_minutes2
required:
- ok
- total
type: object
properties:
ok:
type: number
description: User minutes that met the SLE target
total:
type: number
description: Observed total user minutes for the SLE path
description: User-minute totals for this SLE path
stats_sdkclient_network_connection1:
title: stats_sdkclient_network_connection1
required:
- mac
- rssi
- signal_level
- type
type: object
properties:
mac:
type: string
description: Current network connection MAC address reported for the SDK client
rssi:
type: number
description: Received signal strength indicator for the SDK client's current network connection, in dBm
signal_level:
type: number
description: Numeric signal quality level reported with the SDK client's current network connection
type:
type: string
description: Network connection type reported for the SDK client, such as WiFi
description: Current network connection details for the SDK client
stats_switch_ap_redundancy2:
title: stats_switch_ap_redundancy2
type: object
properties:
modules:
type: object
additionalProperties:
$ref: '#/components/schemas/stats_switch_ap_redundancy_module'
description: Per-module AP redundancy counts for VC or stacked switches
num_aps:
type: integer
description: Total number of APs considered for switch redundancy
contentEncoding: int32
examples:
- 15
num_aps_with_switch_redundancy:
type: integer
description: Number of APs that have switch redundancy coverage
contentEncoding: int32
examples:
- 8
description: AP redundancy statistics associated with the switch
stats_switch_clients_stats_total2:
title: stats_switch_clients_stats_total2
type: object
properties:
num_aps:
type: array
items:
type: integer
contentEncoding: int32
description: AP counts included in the aggregate switch client statistics
num_wired_clients:
type: integer
description: Number of wired clients included in the aggregate switch client statistics
contentEncoding: int32
description: Aggregate client counts across the switch
stats_switch_clients_stats2:
title: stats_switch_clients_stats2
type: object
properties:
total:
allOf:
- $ref: '#/components/schemas/stats_switch_clients_stats_total2'
- description: Aggregate client counts across the switch
description: Aggregate client counts reported for the switch
stats_switch_port_poe_mode1:
title: stats_switch_port_poe_mode1
enum:
- 802.3af
- 802.3at
- 802.3bt
type: string
description: 'PoE mode reported for the port. enum: `802.3af`, `802.3at`, `802.3bt`.'
stats_switch_port_type1:
title: stats_switch_port_type1
enum:
- ap
- ble
- gateway
- mxedge
- nac
- switch
type: string
description: 'Detected device category connected to the port, when available. enum: `ap`, `ble`, `gateway`, `mxedge`, `nac`, `switch`.'
examples:
- gateway
stats_switch_vc_setup_info2:
title: stats_switch_vc_setup_info2
type: object
properties:
config_type:
type: string
description: Provisioning mode used for the Virtual Chassis setup
readOnly: true
examples:
- nonprovisioned
current_stats:
type: string
description: Status currently reported for the Virtual Chassis setup workflow
readOnly: true
examples:
- VCSETUP_WAITING
err_missing_dev_id_fpc:
type: boolean
description: Whether the Virtual Chassis setup is missing a device ID for an FPC member
readOnly: true
last_update:
type: number
description: Most recent update time for the Virtual Chassis setup status
readOnly: true
request_time:
type: number
description: Time when the Virtual Chassis setup request was submitted
readOnly: true
request_type:
type: string
description: Virtual Chassis setup request type
readOnly: true
examples:
- vc_create
description: Virtual Chassis setup request and status details for the switch
stats_wireless_client_airwatch2:
title: stats_wireless_client_airwatch2
required:
- authorized
type: object
properties:
authorized:
type: boolean
description: Whether the wireless client is authorized by AirWatch
description: Mobile device management authorization information from AirWatch for the wireless client
stats_wxrule_action2:
title: stats_wxrule_action2
enum:
- allow
- block
type: string
description: Allow or block behavior enforced by this WxLAN rule
examples:
- allow
stats_zone_assets_waits1:
title: stats_zone_assets_waits1
type: object
properties:
avg:
type: number
description: Average wait time in seconds
examples:
- 0
max:
type: number
description: Longest wait time in seconds
examples:
- 0
min:
type: number
description: Shortest wait time in seconds
examples:
- 0
p95:
type: number
description: 95th percentile of all the wait time(s)
examples:
- 0
description: BLE asset wait-time summary for the zone
stats_zone_assets_waits3:
title: stats_zone_assets_waits3
type: object
properties:
avg:
type: number
description: Average wait time in seconds
examples:
- 0
max:
type: number
description: Longest wait time in seconds
examples:
- 0
min:
type: number
description: Shortest wait time in seconds
examples:
- 0
p95:
type: number
description: 95th percentile of all the wait time(s)
examples:
- 0
description: BLE asset wait-time summary for the RSSI zone
stats_zone_clients_waits1:
title: stats_zone_clients_waits1
type: object
properties:
avg:
type: number
description: Average wait time in seconds
examples:
- 1200
max:
type: number
description: Longest wait time in seconds
examples:
- 3610
min:
type: number
description: Shortest wait time in seconds
examples:
- 600
p95:
type: number
description: 95th percentile of all the wait time(s)
examples:
- 2800
description: Wi-Fi client wait-time summary for the zone
stats_zone_clients_waits3:
title: stats_zone_clients_waits3
type: object
properties:
avg:
type: number
description: Average wait time in seconds
examples:
- 1200
max:
type: number
description: Longest wait time in seconds
examples:
- 3610
min:
type: number
description: Shortest wait time in seconds
examples:
- 600
p95:
type: number
description: 95th percentile of all the wait time(s)
examples:
- 2800
description: Wi-Fi client wait-time summary for the RSSI zone
stats_zone_details_client_waits2:
title: stats_zone_details_client_waits2
required:
- avg
- max
- min
- p95
type: object
properties:
avg:
type: integer
description: Average wait time in seconds
contentEncoding: int32
examples:
- 1200
max:
type: integer
description: Longest wait time in seconds
contentEncoding: int32
examples:
- 3610
min:
type: integer
description: Shortest wait time in seconds
contentEncoding: int32
examples:
- 600
p95:
type: integer
description: 95th percentile of all the wait time(s)
contentEncoding: int32
examples:
- 2800
description: Wi-Fi client wait-time summary for the zone
stats_zone_discovered_assets_waits1:
title: stats_zone_discovered_assets_waits1
type: object
properties:
avg:
type: number
description: Average wait time in seconds
examples:
- 0
max:
type: number
description: Longest wait time in seconds
examples:
- 0
min:
type: number
description: Shortest wait time in seconds
examples:
- 0
p95:
type: number
description: 95th percentile of all the wait time(s)
examples:
- 0
description: Discovered BLE asset wait-time summary for the zone
stats_zone_discovered_assets_waits3:
title: stats_zone_discovered_assets_waits3
type: object
properties:
avg:
type: number
description: Average wait time in seconds
examples:
- 0
max:
type: number
description: Longest wait time in seconds
examples:
- 0
min:
type: number
description: Shortest wait time in seconds
examples:
- 0
p95:
type: number
description: 95th percentile of all the wait time(s)
examples:
- 0
description: Discovered BLE asset wait-time summary for the RSSI zone
stats_zone_sdkclients_waits1:
title: stats_zone_sdkclients_waits1
type: object
properties:
avg:
type: number
description: Average wait time in seconds
examples:
- 0
max:
type: number
description: Longest wait time in seconds
examples:
- 0
min:
type: number
description: Shortest wait time in seconds
examples:
- 0
p95:
type: number
description: 95th percentile of all the wait time(s)
examples:
- 0
description: SDK client wait-time summary for the zone
stats_zone_sdkclients_waits3:
title: stats_zone_sdkclients_waits3
type: object
properties:
avg:
type: number
description: Average wait time in seconds
examples:
- 0
max:
type: number
description: Longest wait time in seconds
examples:
- 0
min:
type: number
description: Shortest wait time in seconds
examples:
- 0
p95:
type: number
description: 95th percentile of all the wait time(s)
examples:
- 0
description: SDK client wait-time summary for the RSSI zone
stats_zone_unconnected_clients_waits1:
title: stats_zone_unconnected_clients_waits1
type: object
properties:
avg:
type: number
description: Average wait time in seconds
examples:
- 0
max:
type: number
description: Longest wait time in seconds
examples:
- 0
min:
type: number
description: Shortest wait time in seconds
examples:
- 0
p95:
type: number
description: 95th percentile of all the wait time(s)
examples:
- 0
description: Unconnected Wi-Fi client wait-time summary for the zone
stats_zone_unconnected_clients_waits3:
title: stats_zone_unconnected_clients_waits3
type: object
properties:
avg:
type: number
description: Average wait time in seconds
examples:
- 0
max:
type: number
description: Longest wait time in seconds
examples:
- 0
min:
type: number
description: Shortest wait time in seconds
examples:
- 0
p95:
type: number
description: 95th percentile of all the wait time(s)
examples:
- 0
description: Unconnected Wi-Fi client wait-time summary for the RSSI zone
support_contract_status2:
title: support_contract_status2
enum:
- Active
- Declined
- EOL
- Service Available
type: string
description: 'Service contract status; only returned for onboarded (claimed) devices. enum: `Active`, `Declined`, `EOL`, `Service Available`.'
suppressed_alarm_applies2:
title: suppressed_alarm_applies2
type: object
properties:
org_id:
type: string
description: UUID of the current org (if provided, the alarms will be suppressed at org level)
contentEncoding: uuid
site_ids:
type: array
items:
type: string
contentEncoding: uuid
description: Site identifiers included in the suppression scope. If provided, alarms are suppressed for the listed sites.
sitegroup_ids:
type: array
items:
type: string
contentEncoding: uuid
description: Site group identifiers included in the suppression scope. If provided, alarms are suppressed for all sites in the listed site groups.
description: If `scope`==`site`. Site and site-group targets where alarms are suppressed
suppressed_alarm_scope1:
title: suppressed_alarm_scope1
enum:
- org
- site
type: string
description: 'Alarm suppression target level. enum: `org`, `site`.'
suppressed_alarm_scope3:
title: suppressed_alarm_scope3
enum:
- org
- site
type: string
description: 'Alarm suppression scope, either organization-wide or site-specific. enum: `org`, `site`.'
sw_routing_policy_term_action2:
title: sw_routing_policy_term_action2
type: object
properties:
accept:
type: boolean
description: Whether to accept routes that match this term
community:
type: array
items:
type: string
description: BGP communities to set when this term is used as an export policy
local_preference:
anyOf:
- type: string
- maximum: 4294967295
minimum: 1
type: integer
contentEncoding: int32
description: Preference value to set when this term is used as an import policy
prepend_as_path:
type: array
items:
type: string
description: AS path values to prepend when this term is used as an export policy
description: Policy actions applied when this routing policy term matches
sw_routing_policy_term_matching2:
title: sw_routing_policy_term_matching2
type: object
properties:
as_path:
type: array
items:
$ref: '#/components/schemas/bgp_as'
description: AS path values that routes must match
community:
type: array
items:
type: string
description: BGP communities that routes must match
prefix:
type: array
items:
type: string
description: Route prefixes that routes must match
protocol:
type: array
items:
$ref: '#/components/schemas/sw_routing_policy_term_matching_protocol_enum'
description: Routing protocols that routes must match
description: Route match criteria that must be satisfied before actions are applied
switch_auto_upgrade1:
title: switch_auto_upgrade1
type: object
properties:
custom_versions:
type: object
additionalProperties:
type: string
description: Per-model switch firmware versions to use for auto-upgrade
examples:
- QFX5120-32C: 23.4R2-S2.1
QFX5130-32CD: 23.4R2-S2.3
enabled:
type: boolean
description: Whether switch auto-upgrade is enabled
snapshot:
type: boolean
description: Whether to create a recovery snapshot during the upgrade process
default: false
description: Switch firmware auto-upgrade configuration
switch_auto_upgrade3:
title: switch_auto_upgrade3
type: object
properties:
custom_versions:
type: object
additionalProperties:
type: string
description: Per-model switch firmware versions to use for auto-upgrade
examples:
- QFX5120-32C: 23.4R2-S2.1
QFX5130-32CD: 23.4R2-S2.3
enabled:
type: boolean
description: Whether switch auto-upgrade is enabled
snapshot:
type: boolean
description: Whether to create a recovery snapshot during the upgrade process
default: false
description: Auto-upgrade defaults for switches in this organization
switch_bgp_config_type2:
title: switch_bgp_config_type2
enum:
- external
- internal
type: string
description: 'BGP session type for this switch BGP configuration. enum: `external`, `internal`.'
switch_dhcpd_config_type2:
title: switch_dhcpd_config_type2
enum:
- none
- relay
- server
type: string
description: 'IPv4 DHCP mode for this switch network. enum: `none`, `relay`, `server`.'
switch_dhcpd_config_type62:
title: switch_dhcpd_config_type62
enum:
- none
- relay
- server
type: string
description: 'IPv6 DHCP mode for this switch network. enum: `none`, `relay`, `server`.'
switch_dhcpd_config1:
title: switch_dhcpd_config1
type: object
properties:
enabled:
type: boolean
description: Whether switch DHCP server or relay configuration is enabled
default: false
additionalProperties:
allOf:
- $ref: '#/components/schemas/switch_dhcpd_config_property'
- description: DHCP server or relay configuration for one switch network. 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 used here (e.g. "net1,net2")
description: DHCP server defaults provided by this switch profile
switch_dhcpd_config3:
title: switch_dhcpd_config3
type: object
properties:
enabled:
type: boolean
description: Whether switch DHCP server or relay configuration is enabled
default: false
additionalProperties:
allOf:
- $ref: '#/components/schemas/switch_dhcpd_config_property'
- description: DHCP server or relay configuration for one switch network. 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 used here (e.g. "net1,net2")
description: DHCP server configuration served by this switch
switch_iot_port_alarm_class2:
title: switch_iot_port_alarm_class2
enum:
- minor
- major
type: string
description: 'Alarm severity class raised for input-triggered switch IOT port events. enum: `minor`, `major`.'
switch_iot_port_input_src2:
title: switch_iot_port_input_src2
enum:
- IN0
- IN1
type: string
description: 'Only for `OUT` ports. Input port that triggers this output port. enum: `IN0`, `IN1`.'
switch_matching_rule_ip_config2:
title: switch_matching_rule_ip_config2
type: object
properties:
network:
type: string
description: VLAN Name for the management interface
type:
allOf:
- $ref: '#/components/schemas/ip_type11'
- description: 'IP assignment mode for in-band switch management. enum: `dhcp`, `static`.'
examples:
- static
description: In-band management IP configuration applied when this matching rule matches
switch_matching_rule_oob_ip_config2:
title: switch_matching_rule_oob_ip_config2
type: object
properties:
type:
allOf:
- $ref: '#/components/schemas/ip_type12'
- description: 'IP assignment mode for out-of-band switch management. enum: `dhcp`, `static`.'
examples:
- static
use_mgmt_vrf:
type: boolean
description: If supported on the platform. If enabled, DNS will be using this routing-instance, too
default: false
use_mgmt_vrf_for_host_out:
type: boolean
description: For host-out traffic (NTP/TACPLUS/RADIUS/SYSLOG/SNMP), if alternative source network/ip is desired
default: false
description: Out-of-band management IP configuration applied when this matching rule matches
switch_matching1:
title: switch_matching1
type: object
properties:
enable:
type: boolean
description: Whether custom switch matching rules are enabled
rules:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/switch_matching_rule'
description: Switch matching rules evaluated to apply custom configuration
description: Rules for matching switches to model-specific settings
switch_matching3:
title: switch_matching3
type: object
properties:
enable:
type: boolean
description: Whether custom switch matching rules are enabled
rules:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/switch_matching_rule'
description: Switch matching rules evaluated to apply custom configuration
description: Matching rules that select switches for this network template
switch_metrics_active_ports_summary_details2:
title: switch_metrics_active_ports_summary_details2
type: object
properties:
active_port_count:
type: integer
description: Number of active ports observed across evaluated switches
contentEncoding: int32
total_port_count:
type: integer
description: Total number of ports evaluated for the active-port metric
contentEncoding: int32
description: Port counts used to calculate the active-port summary metric
switch_mgmt1:
title: switch_mgmt1
type: object
properties:
ap_affinity_threshold:
type: integer
description: AP affinity threshold for switch management. If set in both site settings and organization settings, the site setting value is used.
contentEncoding: int32
default: 10
cli_banner:
type: string
description: Set Banners for switches. Allows markup formatting
examples:
- '\t\tWELCOME!'
cli_idle_timeout:
maximum: 60
minimum: 1
type: integer
description: Sets timeout for switches
contentEncoding: int32
config_revert_timer:
maximum: 30
minimum: 1
type: integer
description: Rollback timer for commit confirmed
contentEncoding: int32
default: 10
dhcp_option_fqdn:
type: boolean
description: Enable to provide the FQDN with DHCP option 81
default: false
disable_oob_down_alarm:
type: boolean
description: Whether to suppress alarms when the switch out-of-band management interface is down
fips_enabled:
type: boolean
description: Whether FIPS mode is enabled on the switch
default: false
local_accounts:
type: object
additionalProperties:
$ref: '#/components/schemas/config_switch_local_accounts_user'
description: Local switch user accounts keyed by username
mxedge_proxy_host:
type: string
description: IP address or FQDN of the Mist Edge used to proxy the switch management traffic to the Mist Cloud
mxedge_proxy_port:
anyOf:
- maximum: 65535
minimum: 1
type: integer
contentEncoding: int32
default: 2222
- type: string
description: Mist Edge proxy port used for switch management traffic
protect_re:
allOf:
- $ref: '#/components/schemas/protect_re3'
- description: Control-plane protection settings for the switch
radius:
allOf:
- $ref: '#/components/schemas/switch_radius2'
- description: Management authentication settings using RADIUS
remove_existing_configs:
type: boolean
description: By default, only the configuration generated by Mist is cleaned up during the configuration process. If `true`, all the existing configuration will be removed.
default: false
root_password:
type: string
description: Root password for local switch access
contentEncoding: password
tacacs:
allOf:
- $ref: '#/components/schemas/tacacs2'
- description: Management authentication settings using TACACS+
use_mxedge_proxy:
type: boolean
description: Whether to use Mist Edge as a proxy for switch management traffic
description: Management-plane defaults provided by this switch profile
switch_mgmt2:
title: switch_mgmt2
type: object
properties:
ap_affinity_threshold:
type: integer
description: AP affinity threshold for switch management. If set in both site settings and organization settings, the site setting value is used.
contentEncoding: int32
default: 10
cli_banner:
type: string
description: Set Banners for switches. Allows markup formatting
examples:
- '\t\tWELCOME!'
cli_idle_timeout:
maximum: 60
minimum: 1
type: integer
description: Sets timeout for switches
contentEncoding: int32
config_revert_timer:
maximum: 30
minimum: 1
type: integer
description: Rollback timer for commit confirmed
contentEncoding: int32
default: 10
dhcp_option_fqdn:
type: boolean
description: Enable to provide the FQDN with DHCP option 81
default: false
disable_oob_down_alarm:
type: boolean
description: Whether to suppress alarms when the switch out-of-band management interface is down
fips_enabled:
type: boolean
description: Whether FIPS mode is enabled on the switch
default: false
local_accounts:
type: object
additionalProperties:
$ref: '#/components/schemas/config_switch_local_accounts_user'
description: Local switch user accounts keyed by username
mxedge_proxy_host:
type: string
description: IP address or FQDN of the Mist Edge used to proxy the switch management traffic to the Mist Cloud
mxedge_proxy_port:
anyOf:
- maximum: 65535
minimum: 1
type: integer
contentEncoding: int32
default: 2222
- type: string
description: Mist Edge proxy port used for switch management traffic
protect_re:
allOf:
- $ref: '#/components/schemas/protect_re3'
- description: Control-plane protection settings for the switch
radius:
allOf:
- $ref: '#/components/schemas/switch_radius2'
- description: Management authentication settings using RADIUS
remove_existing_configs:
type: boolean
description: By default, only the configuration generated by Mist is cleaned up during the configuration process. If `true`, all the existing configuration will be removed.
default: false
root_password:
type: string
description: Root password for local switch access
contentEncoding: password
tacacs:
allOf:
- $ref: '#/components/schemas/tacacs2'
- description: Management authentication settings using TACACS+
use_mxedge_proxy:
type: boolean
description: Whether to use Mist Edge as a proxy for switch management traffic
description: Management-plane settings applied when this matching rule matches
switch_mgmt3:
title: switch_mgmt3
type: object
properties:
ap_affinity_threshold:
type: integer
description: AP affinity threshold for switch management. If set in both site settings and organization settings, the site setting value is used.
contentEncoding: int32
default: 10
cli_banner:
type: string
description: Set Banners for switches. Allows markup formatting
examples:
- '\t\tWELCOME!'
cli_idle_timeout:
maximum: 60
minimum: 1
type: integer
description: Sets timeout for switches
contentEncoding: int32
config_revert_timer:
maximum: 30
minimum: 1
type: integer
description: Rollback timer for commit confirmed
contentEncoding: int32
default: 10
dhcp_option_fqdn:
type: boolean
description: Enable to provide the FQDN with DHCP option 81
default: false
disable_oob_down_alarm:
type: boolean
description: Whether to suppress alarms when the switch out-of-band management interface is down
fips_enabled:
type: boolean
description: Whether FIPS mode is enabled on the switch
default: false
local_accounts:
type: object
additionalProperties:
$ref: '#/components/schemas/config_switch_local_accounts_user'
description: Local switch user accounts keyed by username
mxedge_proxy_host:
type: string
description: IP address or FQDN of the Mist Edge used to proxy the switch management traffic to the Mist Cloud
mxedge_proxy_port:
anyOf:
- maximum: 65535
minimum: 1
type: integer
contentEncoding: int32
default: 2222
- type: string
description: Mist Edge proxy port used for switch management traffic
protect_re:
allOf:
- $ref: '#/components/schemas/protect_re3'
- description: Control-plane protection settings for the switch
radius:
allOf:
- $ref: '#/components/schemas/switch_radius2'
- description: Management authentication settings using RADIUS
remove_existing_configs:
type: boolean
description: By default, only the configuration generated by Mist is cleaned up during the configuration process. If `true`, all the existing configuration will be removed.
default: false
root_password:
type: string
description: Root password for local switch access
contentEncoding: password
tacacs:
allOf:
- $ref: '#/components/schemas/tacacs2'
- description: Management authentication settings using TACACS+
use_mxedge_proxy:
type: boolean
description: Whether to use Mist Edge as a proxy for switch management traffic
description: Management-plane defaults provided by this network template
switch_mgmt4:
title: switch_mgmt4
type: object
properties:
ap_affinity_threshold:
type: integer
description: AP affinity threshold for switch management. If set in both site settings and organization settings, the site setting value is used.
contentEncoding: int32
default: 10
cli_banner:
type: string
description: Set Banners for switches. Allows markup formatting
examples:
- '\t\tWELCOME!'
cli_idle_timeout:
maximum: 60
minimum: 1
type: integer
description: Sets timeout for switches
contentEncoding: int32
config_revert_timer:
maximum: 30
minimum: 1
type: integer
description: Rollback timer for commit confirmed
contentEncoding: int32
default: 10
dhcp_option_fqdn:
type: boolean
description: Enable to provide the FQDN with DHCP option 81
default: false
disable_oob_down_alarm:
type: boolean
description: Whether to suppress alarms when the switch out-of-band management interface is down
fips_enabled:
type: boolean
description: Whether FIPS mode is enabled on the switch
default: false
local_accounts:
type: object
additionalProperties:
$ref: '#/components/schemas/config_switch_local_accounts_user'
description: Local switch user accounts keyed by username
mxedge_proxy_host:
type: string
description: IP address or FQDN of the Mist Edge used to proxy the switch management traffic to the Mist Cloud
mxedge_proxy_port:
anyOf:
- maximum: 65535
minimum: 1
type: integer
contentEncoding: int32
default: 2222
- type: string
description: Mist Edge proxy port used for switch management traffic
protect_re:
allOf:
- $ref: '#/components/schemas/protect_re3'
- description: Control-plane protection settings for the switch
radius:
allOf:
- $ref: '#/components/schemas/switch_radius2'
- description: Management authentication settings using RADIUS
remove_existing_configs:
type: boolean
description: By default, only the configuration generated by Mist is cleaned up during the configuration process. If `true`, all the existing configuration will be removed.
default: false
root_password:
type: string
description: Root password for local switch access
contentEncoding: password
tacacs:
allOf:
- $ref: '#/components/schemas/tacacs2'
- description: Management authentication settings using TACACS+
use_mxedge_proxy:
type: boolean
description: Whether to use Mist Edge as a proxy for switch management traffic
description: Management access settings for switches at the site
switch_mgmt6:
title: switch_mgmt6
type: object
properties:
ap_affinity_threshold:
type: integer
description: AP affinity threshold for switch management. If set in both site settings and organization settings, the site setting value is used.
contentEncoding: int32
default: 10
cli_banner:
type: string
description: Set Banners for switches. Allows markup formatting
examples:
- '\t\tWELCOME!'
cli_idle_timeout:
maximum: 60
minimum: 1
type: integer
description: Sets timeout for switches
contentEncoding: int32
config_revert_timer:
maximum: 30
minimum: 1
type: integer
description: Rollback timer for commit confirmed
contentEncoding: int32
default: 10
dhcp_option_fqdn:
type: boolean
description: Enable to provide the FQDN with DHCP option 81
default: false
disable_oob_down_alarm:
type: boolean
description: Whether to suppress alarms when the switch out-of-band management interface is down
fips_enabled:
type: boolean
description: Whether FIPS mode is enabled on the switch
default: false
local_accounts:
type: object
additionalProperties:
$ref: '#/components/schemas/config_switch_local_accounts_user'
description: Local switch user accounts keyed by username
mxedge_proxy_host:
type: string
description: IP address or FQDN of the Mist Edge used to proxy the switch management traffic to the Mist Cloud
mxedge_proxy_port:
anyOf:
- maximum: 65535
minimum: 1
type: integer
contentEncoding: int32
default: 2222
- type: string
description: Mist Edge proxy port used for switch management traffic
protect_re:
allOf:
- $ref: '#/components/schemas/protect_re3'
- description: Control-plane protection settings for the switch
radius:
allOf:
- $ref: '#/components/schemas/switch_radius2'
- description: Management authentication settings using RADIUS
remove_existing_configs:
type: boolean
description: By default, only the configuration generated by Mist is cleaned up during the configuration process. If `true`, all the existing configuration will be removed.
default: false
root_password:
type: string
description: Root password for local switch access
contentEncoding: password
tacacs:
allOf:
- $ref: '#/components/schemas/tacacs2'
- description: Management authentication settings using TACACS+
use_mxedge_proxy:
type: boolean
description: Whether to use Mist Edge as a proxy for switch management traffic
description: Management-plane settings for this switch
switch_mist_nac1:
title: switch_mist_nac1
type: object
properties:
enabled:
type: boolean
description: Whether Mist NAC RadSec is enabled for the switch
network:
type: string
description: Switch network used for Mist NAC RadSec connectivity
description: Mist NAC defaults applied by this switch profile
switch_mist_nac2:
title: switch_mist_nac2
type: object
properties:
enabled:
type: boolean
description: Whether Mist NAC RadSec is enabled for the switch
network:
type: string
description: Switch network used for Mist NAC RadSec connectivity
description: Mist NAC defaults applied by this network template
switch_mist_nac3:
title: switch_mist_nac3
type: object
properties:
enabled:
type: boolean
description: Whether Mist NAC RadSec is enabled for the switch
network:
type: string
description: Switch network used for Mist NAC RadSec connectivity
description: Network access control settings for switches at the site
switch_mist_nac5:
title: switch_mist_nac5
type: object
properties:
enabled:
type: boolean
description: Whether Mist NAC RadSec is enabled for the switch
network:
type: string
description: Switch network used for Mist NAC RadSec connectivity
description: Mist NAC settings applied to this switch
switch_multicast_config1:
title: switch_multicast_config1
type: object
properties:
anycast_rp:
type: boolean
description: When `true`, auto-generates a shared RP on `is_l3_border` devices (ERB/IPClos topologies only)
default: false
rp_ip:
type: string
description: RP address used when `anycast_rp`==`false`. If the address matches a device SVI, it is configured as a local RP; otherwise a static RP is configured
examples:
- 10.2.1.10
sbd_subnet:
type: string
description: SBD IRB subnet; Mist auto-assigns per-device IPs from this range (EVPN eOISM only)
examples:
- 10.99.0.0/24
sbd_vlan_id:
type: integer
description: Supplemental Bridge Domain VLAN ID (EVPN topology / eOISM only)
contentEncoding: int32
examples:
- 3900
description: Multicast settings for networks in the master VRF (not assigned to any vrf_instances); PIM is automatically enabled when any master-VRF network has `multicast.enabled`==`true`
switch_multicast_config3:
title: switch_multicast_config3
type: object
properties:
anycast_rp:
type: boolean
description: When `true`, auto-generates a shared RP on `is_l3_border` devices (ERB/IPClos topologies only)
default: false
rp_ip:
type: string
description: RP address used when `anycast_rp`==`false`. If the address matches a device SVI, it is configured as a local RP; otherwise a static RP is configured
examples:
- 10.2.1.10
sbd_subnet:
type: string
description: SBD IRB subnet; Mist auto-assigns per-device IPs from this range (EVPN eOISM only)
examples:
- 10.99.0.0/24
sbd_vlan_id:
type: integer
description: Supplemental Bridge Domain VLAN ID (EVPN topology / eOISM only)
contentEncoding: int32
examples:
- 3900
description: Multicast configuration for this VRF instance. PIM is automatically enabled when any network in this VRF has `multicast.enabled`==`true`
switch_network_multicast2:
title: switch_network_multicast2
type: object
properties:
enabled:
type: boolean
description: Whether to enable IGMP snooping on this VLAN
default: false
igmp_version:
allOf:
- $ref: '#/components/schemas/switch_network_multicast_igmp_version'
- description: IGMP version. '2' (default, ASM/IGMPv2) / '3' (SSM/IGMPv3)
description: Multicast (IGMP snooping) settings for this VLAN
switch_oob_ip_config1:
title: switch_oob_ip_config1
type: object
properties:
gateway:
type: string
description: Default gateway for the out-of-band management interface when `type`==`static`
ip:
type: string
description: Static IPv4 address for the out-of-band management interface when `type`==`static`
netmask:
type: string
description: Used only if `subnet` is not specified in `networks`
network:
type: string
description: Optional, the network to be used for mgmt
type:
allOf:
- $ref: '#/components/schemas/ip_type2'
- description: 'IP assignment mode for the out-of-band management interface. enum: `dhcp`, `static`.'
examples:
- static
use_mgmt_vrf:
type: boolean
description: If supported on the platform. If enabled, DNS will be using this routing-instance, too
default: false
use_mgmt_vrf_for_host_out:
type: boolean
description: For host-out traffic (NTP/TACPLUS/RADIUS/SYSLOG/SNMP), if alternative source network/ip is desired
default: false
description: Out-of-band management IP defaults in this switch profile
switch_oob_ip_config3:
title: switch_oob_ip_config3
type: object
properties:
gateway:
type: string
description: Default gateway for the out-of-band management interface when `type`==`static`
ip:
type: string
description: Static IPv4 address for the out-of-band management interface when `type`==`static`
netmask:
type: string
description: Used only if `subnet` is not specified in `networks`
network:
type: string
description: Optional, the network to be used for mgmt
type:
allOf:
- $ref: '#/components/schemas/ip_type2'
- description: 'IP assignment mode for the out-of-band management interface. enum: `dhcp`, `static`.'
examples:
- static
use_mgmt_vrf:
type: boolean
description: If supported on the platform. If enabled, DNS will be using this routing-instance, too
default: false
use_mgmt_vrf_for_host_out:
type: boolean
description: For host-out traffic (NTP/TACPLUS/RADIUS/SYSLOG/SNMP), if alternative source network/ip is desired
default: false
description: Out-of-band management IP configuration for this switch
switch_ospf_config2:
title: switch_ospf_config2
type: object
properties:
areas:
type: object
additionalProperties:
$ref: '#/components/schemas/switch_ospf_config_area'
description: OSPF areas configured on the switch
enabled:
type: boolean
description: Enable OSPF on the switch
default: false
export_policy:
type: string
description: optional, for basic scenario, `import_policy` can be specified and can be applied to all networks in all areas if not explicitly specified
import_policy:
type: string
description: optional, for basic scenario, `import_policy` can be specified and can be applied to all networks in all areas if not explicitly specified
reference_bandwidth:
anyOf:
- type: integer
contentEncoding: int32
- type: string
description: Reference bandwidth used for OSPF cost calculation
examples:
- '100000'
description: OSPF routing configuration for this switch
switch_port_local_usage_dot1x2:
title: switch_port_local_usage_dot1x2
const: dot1x
type: string
description: '802.1X authentication mode for this local port configuration. enum: `dot1x`.'
switch_port_local_usage_duplex2:
title: switch_port_local_usage_duplex2
enum:
- auto
- full
- half
type: string
description: 'Link duplex mode for this local port configuration. enum: `auto`, `full`, `half`.'
switch_port_local_usage_mac_auth_protocol2:
title: switch_port_local_usage_mac_auth_protocol2
enum:
- eap-md5
- eap-peap
- pap
type: string
description: 'Only if `enable_mac_auth`==`true`, MAC authentication protocol to use. enum: `eap-md5`, `eap-peap`, `pap`.'
switch_port_local_usage_mode2:
title: switch_port_local_usage_mode2
enum:
- access
- inet
- trunk
type: string
description: 'Switching mode for this local port configuration. enum: `access`, `inet`, `trunk`.'
switch_port_usage_dot1x2:
title: switch_port_usage_dot1x2
const: dot1x
type: string
description: 'Only if `mode`!=`dynamic`. 802.1X authentication mode for this port usage. enum: `dot1x`.'
switch_port_usage_duplex_overwrite2:
title: switch_port_usage_duplex_overwrite2
enum:
- auto
- full
- half
type: string
description: 'Link duplex mode override for the switch port. enum: `auto`, `full`, `half`.'
switch_port_usage_duplex2:
title: switch_port_usage_duplex2
enum:
- auto
- full
- half
type: string
description: 'Only if `mode`!=`dynamic`. Link duplex mode for this port usage. enum: `auto`, `full`, `half`.'
switch_port_usage_dynamic_reset_default_when2:
title: switch_port_usage_dynamic_reset_default_when2
enum:
- link_down
- none
type: string
description: 'Only if `mode`==`dynamic`. Condition that resets a dynamic port to the default port usage. enum: `link_down`, `none`.'
examples:
- link_down
switch_port_usage_dynamic_rule_src2:
title: switch_port_usage_dynamic_rule_src2
enum:
- link_peermac
- lldp_chassis_id
- lldp_hardware_revision
- lldp_manufacturer_name
- lldp_oui
- lldp_serial_number
- lldp_system_description
- lldp_system_name
- radius_dynamicfilter
- radius_usermac
- radius_username
type: string
description: 'Source attribute evaluated by this dynamic rule. enum: `link_peermac`, `lldp_chassis_id`, `lldp_hardware_revision`, `lldp_manufacturer_name`, `lldp_oui`, `lldp_serial_number`, `lldp_system_description`, `lldp_system_name`, `radius_dynamicfilter`, `radius_usermac`, `radius_username`.'
switch_port_usage_mac_auth_protocol2:
title: switch_port_usage_mac_auth_protocol2
enum:
- eap-md5
- eap-peap
- pap
type: string
description: 'Only if `mode`!=`dynamic` and `enable_mac_auth`==`true`. MAC authentication protocol to use; ignored if Mist NAC is enabled. enum: `eap-md5`, `eap-peap`, `pap`.'
switch_port_usage_mode2:
title: switch_port_usage_mode2
enum:
- access
- dynamic
- inet
- trunk
type: string
description: 'Switching mode for this port usage. enum: `access`, `dynamic`, `inet`, `trunk`.'
switch_port_usage_speed_overwrite2:
title: switch_port_usage_speed_overwrite2
enum:
- 10m
- 100m
- 1g
- 2.5g
- 5g
- 10g
- 25g
- 40g
- 100g
- auto
type: string
description: 'Link speed override for the switch port. enum: `10m`, `100m`, `1g`, `2.5g`, `5g`, `10g`, `25g`, `40g`, `100g`, `auto`.'
switch_port_usage_speed2:
title: switch_port_usage_speed2
enum:
- 10m
- 100m
- 1g
- 2.5g
- 5g
- 10g
- 25g
- 40g
- 100g
- auto
type: string
description: 'Only if `mode`!=`dynamic`. Link speed for this port usage. enum: `10m`, `100m`, `1g`, `2.5g`, `5g`, `10g`, `25g`, `40g`, `100g`, `auto`.'
switch_port_usage_storm_control2:
title: switch_port_usage_storm_control2
type: object
properties:
disable_port:
type: boolean
description: Whether to disable the port when storm control is triggered
default: false
no_broadcast:
type: boolean
description: Whether to disable storm control on broadcast traffic
default: false
no_multicast:
type: boolean
description: Whether to disable storm control on multicast traffic
default: false
no_registered_multicast:
type: boolean
description: Whether to disable storm control on registered multicast traffic
default: false
no_unknown_unicast:
type: boolean
description: Whether to disable storm control on unknown unicast traffic
default: false
percentage:
maximum: 100
minimum: 0
type: integer
description: Bandwidth-percentage, configures the storm control level as a percentage of the available bandwidth
contentEncoding: int32
default: 80
description: Only if `mode`!=`dynamic`. Storm-control settings for this port usage
switch_radius_config_auth_server_selection2:
title: switch_radius_config_auth_server_selection2
enum:
- ordered
- unordered
type: string
description: 'Selection strategy for RADIUS authentication servers. enum: `ordered`, `unordered`.'
switch_radius_config1:
title: switch_radius_config1
type: object
properties:
acct_immediate_update:
type: boolean
description: Whether immediate RADIUS accounting updates are sent
acct_interim_interval:
maximum: 65535
minimum: 0
type: integer
description: How frequently should interim accounting be reported, 60-65535. default is 0 (use one specified in Access-Accept request from RADIUS Server). Very frequent messages can affect the performance of the RADIUS server, 600 and up is recommended when enabled
contentEncoding: int32
default: 0
acct_servers:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/radius_acct_server'
description: RADIUS accounting servers used by this switch configuration
auth_server_selection:
allOf:
- $ref: '#/components/schemas/switch_radius_config_auth_server_selection2'
- description: 'Selection strategy for RADIUS authentication servers. enum: `ordered`, `unordered`.'
auth_servers:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/radius_auth_server'
description: RADIUS authentication servers used by this switch configuration
auth_servers_retries:
type: integer
description: RADIUS auth session retries
contentEncoding: int32
default: 3
auth_servers_timeout:
type: integer
description: RADIUS auth session timeout
contentEncoding: int32
default: 5
coa_enabled:
type: boolean
description: Whether RADIUS Change of Authorization (CoA) is enabled
default: false
coa_port:
anyOf:
- maximum: 65545
minimum: 1
type: integer
contentEncoding: int32
- type: string
description: UDP port used for RADIUS Change of Authorization (CoA)
fast_dot1x_timers:
type: boolean
description: Whether fast 802.1X timers are enabled for RADIUS authentication
default: false
network:
type: string
description: Use `network`or `source_ip`. Which network the RADIUS server resides, if there's static IP for this network, we'd use it as source-ip
source_ip:
type: string
description: Use `network` or `source_ip`. Explicit source IP address for RADIUS traffic
description: RADIUS configuration used when alternate RADIUS settings are required
switch_radius_config2:
title: switch_radius_config2
type: object
properties:
acct_immediate_update:
type: boolean
description: Whether immediate RADIUS accounting updates are sent
acct_interim_interval:
maximum: 65535
minimum: 0
type: integer
description: How frequently should interim accounting be reported, 60-65535. default is 0 (use one specified in Access-Accept request from RADIUS Server). Very frequent messages can affect the performance of the RADIUS server, 600 and up is recommended when enabled
contentEncoding: int32
default: 0
acct_servers:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/radius_acct_server'
description: RADIUS accounting servers used by this switch configuration
auth_server_selection:
allOf:
- $ref: '#/components/schemas/switch_radius_config_auth_server_selection2'
- description: 'Selection strategy for RADIUS authentication servers. enum: `ordered`, `unordered`.'
auth_servers:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/radius_auth_server'
description: RADIUS authentication servers used by this switch configuration
auth_servers_retries:
type: integer
description: RADIUS auth session retries
contentEncoding: int32
default: 3
auth_servers_timeout:
type: integer
description: RADIUS auth session timeout
contentEncoding: int32
default: 5
coa_enabled:
type: boolean
description: Whether RADIUS Change of Authorization (CoA) is enabled
default: false
coa_port:
anyOf:
- maximum: 65545
minimum: 1
type: integer
contentEncoding: int32
- type: string
description: UDP port used for RADIUS Change of Authorization (CoA)
fast_dot1x_timers:
type: boolean
description: Whether fast 802.1X timers are enabled for RADIUS authentication
default: false
network:
type: string
description: Use `network`or `source_ip`. Which network the RADIUS server resides, if there's static IP for this network, we'd use it as source-ip
source_ip:
type: string
description: Use `network` or `source_ip`. Explicit source IP address for RADIUS traffic
description: RADIUS authentication and accounting defaults in this switch profile
switch_radius_config3:
title: switch_radius_config3
type: object
properties:
acct_immediate_update:
type: boolean
description: Whether immediate RADIUS accounting updates are sent
acct_interim_interval:
maximum: 65535
minimum: 0
type: integer
description: How frequently should interim accounting be reported, 60-65535. default is 0 (use one specified in Access-Accept request from RADIUS Server). Very frequent messages can affect the performance of the RADIUS server, 600 and up is recommended when enabled
contentEncoding: int32
default: 0
acct_servers:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/radius_acct_server'
description: RADIUS accounting servers used by this switch configuration
auth_server_selection:
allOf:
- $ref: '#/components/schemas/switch_radius_config_auth_server_selection2'
- description: 'Selection strategy for RADIUS authentication servers. enum: `ordered`, `unordered`.'
auth_servers:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/radius_auth_server'
description: RADIUS authentication servers used by this switch configuration
auth_servers_retries:
type: integer
description: RADIUS auth session retries
contentEncoding: int32
default: 3
auth_servers_timeout:
type: integer
description: RADIUS auth session timeout
contentEncoding: int32
default: 5
coa_enabled:
type: boolean
description: Whether RADIUS Change of Authorization (CoA) is enabled
default: false
coa_port:
anyOf:
- maximum: 65545
minimum: 1
type: integer
contentEncoding: int32
- type: string
description: UDP port used for RADIUS Change of Authorization (CoA)
fast_dot1x_timers:
type: boolean
description: Whether fast 802.1X timers are enabled for RADIUS authentication
default: false
network:
type: string
description: Use `network`or `source_ip`. Which network the RADIUS server resides, if there's static IP for this network, we'd use it as source-ip
source_ip:
type: string
description: Use `network` or `source_ip`. Explicit source IP address for RADIUS traffic
description: RADIUS authentication and accounting defaults in this network template
switch_radius_config4:
title: switch_radius_config4
type: object
properties:
acct_immediate_update:
type: boolean
description: Whether immediate RADIUS accounting updates are sent
acct_interim_interval:
maximum: 65535
minimum: 0
type: integer
description: How frequently should interim accounting be reported, 60-65535. default is 0 (use one specified in Access-Accept request from RADIUS Server). Very frequent messages can affect the performance of the RADIUS server, 600 and up is recommended when enabled
contentEncoding: int32
default: 0
acct_servers:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/radius_acct_server'
description: RADIUS accounting servers used by this switch configuration
auth_server_selection:
allOf:
- $ref: '#/components/schemas/switch_radius_config_auth_server_selection2'
- description: 'Selection strategy for RADIUS authentication servers. enum: `ordered`, `unordered`.'
auth_servers:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/radius_auth_server'
description: RADIUS authentication servers used by this switch configuration
auth_servers_retries:
type: integer
description: RADIUS auth session retries
contentEncoding: int32
default: 3
auth_servers_timeout:
type: integer
description: RADIUS auth session timeout
contentEncoding: int32
default: 5
coa_enabled:
type: boolean
description: Whether RADIUS Change of Authorization (CoA) is enabled
default: false
coa_port:
anyOf:
- maximum: 65545
minimum: 1
type: integer
contentEncoding: int32
- type: string
description: UDP port used for RADIUS Change of Authorization (CoA)
fast_dot1x_timers:
type: boolean
description: Whether fast 802.1X timers are enabled for RADIUS authentication
default: false
network:
type: string
description: Use `network`or `source_ip`. Which network the RADIUS server resides, if there's static IP for this network, we'd use it as source-ip
source_ip:
type: string
description: Use `network` or `source_ip`. Explicit source IP address for RADIUS traffic
description: Switch RADIUS configuration for the site
switch_radius_config6:
title: switch_radius_config6
type: object
properties:
acct_immediate_update:
type: boolean
description: Whether immediate RADIUS accounting updates are sent
acct_interim_interval:
maximum: 65535
minimum: 0
type: integer
description: How frequently should interim accounting be reported, 60-65535. default is 0 (use one specified in Access-Accept request from RADIUS Server). Very frequent messages can affect the performance of the RADIUS server, 600 and up is recommended when enabled
contentEncoding: int32
default: 0
acct_servers:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/radius_acct_server'
description: RADIUS accounting servers used by this switch configuration
auth_server_selection:
allOf:
- $ref: '#/components/schemas/switch_radius_config_auth_server_selection2'
- description: 'Selection strategy for RADIUS authentication servers. enum: `ordered`, `unordered`.'
auth_servers:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/radius_auth_server'
description: RADIUS authentication servers used by this switch configuration
auth_servers_retries:
type: integer
description: RADIUS auth session retries
contentEncoding: int32
default: 3
auth_servers_timeout:
type: integer
description: RADIUS auth session timeout
contentEncoding: int32
default: 5
coa_enabled:
type: boolean
description: Whether RADIUS Change of Authorization (CoA) is enabled
default: false
coa_port:
anyOf:
- maximum: 65545
minimum: 1
type: integer
contentEncoding: int32
- type: string
description: UDP port used for RADIUS Change of Authorization (CoA)
fast_dot1x_timers:
type: boolean
description: Whether fast 802.1X timers are enabled for RADIUS authentication
default: false
network:
type: string
description: Use `network`or `source_ip`. Which network the RADIUS server resides, if there's static IP for this network, we'd use it as source-ip
source_ip:
type: string
description: Use `network` or `source_ip`. Explicit source IP address for RADIUS traffic
description: RADIUS authentication and accounting settings for this switch
switch_radius2:
title: switch_radius2
type: object
properties:
enabled:
type: boolean
description: Whether RADIUS is enabled for switch management authentication
radius_config:
allOf:
- $ref: '#/components/schemas/switch_radius_config1'
- description: RADIUS configuration used when alternate RADIUS settings are required
use_different_radius:
type: string
description: Selector for alternate RADIUS settings instead of the default switch `radius_config`
description: Management authentication settings using RADIUS
switch_stp_config1:
title: switch_stp_config1
type: object
properties:
bridge_priority:
type: string
description: Switch STP priority. Range [0, 4k, 8k.. 60k] in steps of 4k. Bridge priority applies to both VSTP and RSTP.
default: 32k
examples:
- 40k
description: Spanning Tree Protocol defaults provided by this switch profile
switch_stp_config2:
title: switch_stp_config2
type: object
properties:
bridge_priority:
type: string
description: Switch STP priority. Range [0, 4k, 8k.. 60k] in steps of 4k. Bridge priority applies to both VSTP and RSTP.
default: 32k
examples:
- 40k
description: Spanning Tree Protocol configuration applied when this matching rule matches
switch_stp_config4:
title: switch_stp_config4
type: object
properties:
bridge_priority:
type: string
description: Switch STP priority. Range [0, 4k, 8k.. 60k] in steps of 4k. Bridge priority applies to both VSTP and RSTP.
default: 32k
examples:
- 40k
description: Spanning Tree Protocol configuration for this switch
switch_virtual_chassis_member_vc_role2:
title: switch_virtual_chassis_member_vc_role2
enum:
- backup
- linecard
- master
type: string
description: 'Role of this member in the Virtual Chassis. enum: `backup`, `linecard`, `master`.'
switch_virtual_chassis2:
title: switch_virtual_chassis2
type: object
properties:
members:
type: array
items:
$ref: '#/components/schemas/switch_virtual_chassis_member'
description: Virtual Chassis members and their expected roles
preprovisioned:
type: boolean
description: To configure whether the VC is preprovisioned or nonprovisioned
default: false
description: Virtual Chassis membership and provisioning settings for this switch
synthetictest_config_aggressiveness1:
title: synthetictest_config_aggressiveness1
enum:
- auto
- high
- med
- low
type: string
description: 'Probe aggressiveness level for this custom synthetic probe. enum: `auto`, `high`, `med`, `low`.'
synthetictest_config_aggressiveness3:
title: synthetictest_config_aggressiveness3
enum:
- auto
- high
- med
- low
type: string
description: 'Overall aggressiveness level for synthetic test probes. enum: `auto`, `high`, `med`, `low`.'
synthetictest_config_custom_probe_type2:
title: synthetictest_config_custom_probe_type2
enum:
- application
- curl
- icmp
- reachability
- tcp
type: string
description: 'Synthetic test type used for the Minis application result. enum: `application`, `curl`, `icmp`, `reachability`, `tcp`.'
synthetictest_config_custom_probe_type3:
title: synthetictest_config_custom_probe_type3
enum:
- application
- curl
- icmp
- reachability
- tcp
type: string
description: 'Probe type used by this custom synthetic probe. enum: `application`, `curl`, `icmp`, `reachability`, `tcp`.'
synthetictest_config_wan_speedtest2:
title: synthetictest_config_wan_speedtest2
type: object
properties:
enabled:
type: boolean
description: Whether scheduled WAN speedtests are enabled
time_of_day:
type: string
description: Scheduled time of day for WAN speedtests
default: any
examples:
- 12:00
description: WAN speedtest settings for synthetic tests
synthetictest_config1:
title: synthetictest_config1
type: object
properties:
aggressiveness:
allOf:
- $ref: '#/components/schemas/synthetictest_config_aggressiveness3'
- description: 'Overall aggressiveness level for synthetic test probes. enum: `auto`, `high`, `med`, `low`.'
custom_probes:
type: object
additionalProperties:
$ref: '#/components/schemas/synthetictest_config_custom_probe'
description: Custom synthetic probe definitions keyed by probe name
disabled:
type: boolean
description: Whether synthetic tests are disabled
default: false
lan_networks:
type: array
items:
$ref: '#/components/schemas/synthetictest_config_lan_network'
description: LAN network probe groups used by synthetic tests
vlans:
type: array
items:
$ref: '#/components/schemas/synthetictest_config_vlan'
description: Deprecated VLAN-based synthetic test settings
deprecated: true
wan_speedtest:
allOf:
- $ref: '#/components/schemas/synthetictest_config_wan_speedtest2'
- description: WAN speedtest settings for synthetic tests
description: Active monitoring test configuration for the site
synthetictest_config3:
title: synthetictest_config3
type: object
properties:
aggressiveness:
allOf:
- $ref: '#/components/schemas/synthetictest_config_aggressiveness3'
- description: 'Overall aggressiveness level for synthetic test probes. enum: `auto`, `high`, `med`, `low`.'
custom_probes:
type: object
additionalProperties:
$ref: '#/components/schemas/synthetictest_config_custom_probe'
description: Custom synthetic probe definitions keyed by probe name
disabled:
type: boolean
description: Whether synthetic tests are disabled
default: false
lan_networks:
type: array
items:
$ref: '#/components/schemas/synthetictest_config_lan_network'
description: LAN network probe groups used by synthetic tests
vlans:
type: array
items:
$ref: '#/components/schemas/synthetictest_config_vlan'
description: Deprecated VLAN-based synthetic test settings
deprecated: true
wan_speedtest:
allOf:
- $ref: '#/components/schemas/synthetictest_config_wan_speedtest2'
- description: WAN speedtest settings for synthetic tests
description: Configuration for organization synthetic tests
synthetictest_device_protocol2:
title: synthetictest_device_protocol2
enum:
- ping
- ping+traceroute
- traceroute
type: string
description: 'If `type`==`lan_connectivity`. Protocol or protocol combination used for the connectivity test. enum: `ping`, `ping+traceroute`, `traceroute`.'
synthetictest_type1:
title: synthetictest_type1
enum:
- arp
- curl
- dhcp
- dhcp6
- dns
- lan_connectivity
- radius
- speedtest
type: string
description: 'Synthetic test type to run against the target. enum: `arp`, `curl`, `dhcp`, `dhcp6`, `dns`, `lan_connectivity`, `radius`, `speedtest`.'
synthetictest_type3:
title: synthetictest_type3
enum:
- arp
- curl
- dhcp
- dhcp6
- dns
- lan_connectivity
- radius
- speedtest
type: string
description: 'Synthetic test type for this result. enum: `arp`, `curl`, `dhcp`, `dhcp6`, `dns`, `lan_connectivity`, `radius`, `speedtest`.'
tacacs_default_role2:
title: tacacs_default_role2
enum:
- admin
- helpdesk
- none
- read
type: string
description: 'Default switch-management role to use for TACACS+ logins. enum: `admin`, `helpdesk`, `none`, `read`.'
tacacs2:
title: tacacs2
type: object
properties:
acct_servers:
type: array
items:
$ref: '#/components/schemas/tacacs_acct_server'
description: TACACS+ accounting servers used for switch management sessions
default_role:
allOf:
- $ref: '#/components/schemas/tacacs_default_role2'
- description: 'Default switch-management role to use for TACACS+ logins. enum: `admin`, `helpdesk`, `none`, `read`.'
enabled:
type: boolean
description: Whether TACACS+ is enabled for switch management authentication
network:
type: string
description: Source network used for connectivity to the TACACS+ servers
tacplus_servers:
type: array
items:
$ref: '#/components/schemas/tacacs_auth_server'
description: TACACS+ authentication servers used for switch management logins
description: Management authentication settings using TACACS+
template_applies2:
title: template_applies2
type: object
properties:
org_id:
type: string
description: Organization included in the WLAN template application scope
contentEncoding: uuid
site_ids:
type: array
items:
type: string
contentEncoding: uuid
description: Sites included in the WLAN template application scope
sitegroup_ids:
type: array
items:
type: string
contentEncoding: uuid
description: Site groups included in the WLAN template application scope
description: Organizations, sites, or site groups targeted by this WLAN template
template_exceptions2:
title: template_exceptions2
type: object
properties:
site_ids:
type: array
items:
type: string
contentEncoding: uuid
description: Sites excluded from the WLAN template application scope
sitegroup_ids:
type: array
items:
type: string
contentEncoding: uuid
description: Site groups excluded from the WLAN template application scope
description: Sites or site groups excluded from this WLAN template even when included by the application scope
test_cradlepoint_last_status2:
title: test_cradlepoint_last_status2
enum:
- active
- inactive
type: string
description: 'Integration status detected during the most recent Cradlepoint sync. enum: `active`, `inactive`.'
examples:
- inactive
ticket_status2:
title: ticket_status2
enum:
- closed
- open
- pending
- solved
type: string
description: 'Current lifecycle status of this support ticket. enum: `closed`, `open`, `pending`, `solved`.'
tunnel_config_auth_algo1:
title: tunnel_config_auth_algo1
enum:
- md5
- sha1
- sha2
type: string
description: 'Integrity algorithm used by this IPsec proposal. enum: `md5`, `sha1`, `sha2`.'
tunnel_config_auth_algo3:
title: tunnel_config_auth_algo3
enum:
- md5
- sha1
- sha2
type: string
description: 'Integrity algorithm used by this IKE proposal. enum: `md5`, `sha1`, `sha2`.'
tunnel_config_auto_provision_lat_lng2:
title: tunnel_config_auto_provision_lat_lng2
required:
- lat
- lng
type: object
properties:
lat:
type: number
description: Geographic latitude used for POP selection override
examples:
- 37.295833
lng:
type: number
description: Geographic longitude used for POP selection override
examples:
- -122.032946
description: Geographic coordinate override used for tunnel POP selection
tunnel_config_auto_provision_node1:
title: tunnel_config_auto_provision_node1
type: object
properties:
probe_ips:
uniqueItems: true
type: array
items:
type: string
description: Probe IP addresses used to monitor auto-provisioned tunnel reachability
wan_names:
type: array
items:
type: string
description: WAN interface names used by the auto-provisioned tunnel endpoint
description: Backup auto-provisioned tunnel endpoint settings
tunnel_config_auto_provision_node3:
title: tunnel_config_auto_provision_node3
type: object
properties:
probe_ips:
uniqueItems: true
type: array
items:
type: string
description: Probe IP addresses used to monitor auto-provisioned tunnel reachability
wan_names:
type: array
items:
type: string
description: WAN interface names used by the auto-provisioned tunnel endpoint
description: Main auto-provisioned tunnel endpoint settings
tunnel_config_auto_provision_provider2:
title: tunnel_config_auto_provision_provider2
enum:
- jse-ipsec
- zscaler-ipsec
type: string
description: 'Tunnel provider used for automatic endpoint provisioning. enum: `jse-ipsec`, `zscaler-ipsec`.'
tunnel_config_auto_provision2:
title: tunnel_config_auto_provision2
required:
- provider
type: object
properties:
enabled:
type: boolean
description: Enable auto provisioning for the tunnel. If enabled, the `primary` and `secondary` nodes will be ignored.
latlng:
allOf:
- $ref: '#/components/schemas/tunnel_config_auto_provision_lat_lng2'
- description: Geographic coordinate override used for tunnel POP selection
primary:
allOf:
- $ref: '#/components/schemas/tunnel_config_auto_provision_node3'
- description: Main auto-provisioned tunnel endpoint settings
provider:
allOf:
- $ref: '#/components/schemas/tunnel_config_auto_provision_provider2'
- description: 'Tunnel provider used for automatic endpoint provisioning. enum: `jse-ipsec`, `zscaler-ipsec`.'
region:
type: string
description: API override for POP selection in the case user wants to override the auto discovery of remote network location and force the tunnel to use the specified peer location.
secondary:
allOf:
- $ref: '#/components/schemas/tunnel_config_auto_provision_node1'
- description: Backup auto-provisioned tunnel endpoint settings
service_connection:
type: string
description: if `provider`==`prisma-ipsec`. By default, we'll use the location of the site to determine the optimal Remote Network location, optionally, service_connection can be considered, then we'll also consider this along with the site location. Define service_connection if the traffic is to be routed to a specific service connection. This field takes a service connection name that is configured in the Prisma cloud, Prisma Access Setup -> Service Connections.
examples:
- Juniper-Lab-SC-1
description: Provider auto-provisioning settings for tunnel endpoints
tunnel_config_dh_group2:
title: tunnel_config_dh_group2
enum:
- '1'
- '14'
- '15'
- '16'
- '19'
- '2'
- '20'
- '21'
- '24'
- '5'
type: string
description: 'Diffie-Hellman group used by this IPsec proposal. enum: `1`, `14`, `15`, `16`, `19`, `2`, `20`, `21`, `24`, `5`.'
tunnel_config_enc_algo1:
title: tunnel_config_enc_algo1
enum:
- 3des
- aes128
- aes256
- aes_gcm128
- aes_gcm256
type: string
description: 'Cipher algorithm used by this IPsec proposal. enum: `3des`, `aes128`, `aes256`, `aes_gcm128`, `aes_gcm256`.'
tunnel_config_enc_algo3:
title: tunnel_config_enc_algo3
enum:
- 3des
- aes128
- aes256
- aes_gcm128
- aes_gcm256
type: string
description: 'Cipher algorithm used by this IKE proposal. enum: `3des`, `aes128`, `aes256`, `aes_gcm128`, `aes_gcm256`.'
tunnel_config_ike_dh_group2:
title: tunnel_config_ike_dh_group2
enum:
- '1'
- '14'
- '15'
- '16'
- '19'
- '2'
- '20'
- '21'
- '24'
- '5'
type: string
description: 'Diffie-Hellman group used by this IKE proposal. enum: `1`, `14`, `15`, `16`, `19`, `2`, `20`, `21`, `24`, `5`.'
tunnel_config_ike_mode2:
title: tunnel_config_ike_mode2
enum:
- aggressive
- main
type: string
description: 'Only if `provider`==`custom-ipsec`. IKE negotiation mode for the tunnel. enum: `aggressive`, `main`.'
tunnel_config_node_probe_http2:
title: tunnel_config_node_probe_http2
type: object
properties:
accepted_status_codes:
type: array
items:
type: integer
contentEncoding: int32
description: HTTP response status codes that indicate a successful probe. Defaults to 200 if not specified.
examples:
- - 204
urls:
type: array
items:
type: string
description: HTTP or HTTPS URLs to probe
examples:
- - http://www.google.com/generate_204
- https://www.google.com/generate_204
description: HTTP probe settings for this tunnel node; success from any ICMP or HTTP probe indicates the tunnel is up
tunnel_config_node1:
title: tunnel_config_node1
required:
- hosts
- wan_names
type: object
properties:
hosts:
type: array
items:
type: string
description: Remote gateway host addresses for this tunnel node
internal_ip6s:
uniqueItems: true
type: array
items:
type: string
description: IPv6 addresses configured on this tunnel node
internal_ips:
type: array
items:
type: string
description: Internal IP addresses configured on this tunnel node
probe_hostnames:
uniqueItems: true
type: array
items:
type: string
description: Hostnames used as ICMP probe destinations for this tunnel node; applicable for both IPv4 and IPv6
probe_http:
allOf:
- $ref: '#/components/schemas/tunnel_config_node_probe_http2'
- description: HTTP probe settings for this tunnel node; success from any ICMP or HTTP probe indicates the tunnel is up
probe_ip6s:
uniqueItems: true
type: array
items:
type: string
description: IPv6 ICMP probe addresses used to monitor this tunnel node
probe_ips:
uniqueItems: true
type: array
items:
type: string
description: Health-check IP addresses used to monitor this tunnel node
remote_ids:
type: array
items:
type: string
description: IKE identities expected from this tunnel node
wan_names:
type: array
items:
type: string
description: Interface names that source tunnel traffic for this node
description: Backup remote tunnel endpoint settings
tunnel_config_node3:
title: tunnel_config_node3
required:
- hosts
- wan_names
type: object
properties:
hosts:
type: array
items:
type: string
description: Remote gateway host addresses for this tunnel node
internal_ip6s:
uniqueItems: true
type: array
items:
type: string
description: IPv6 addresses configured on this tunnel node
internal_ips:
type: array
items:
type: string
description: Internal IP addresses configured on this tunnel node
probe_hostnames:
uniqueItems: true
type: array
items:
type: string
description: Hostnames used as ICMP probe destinations for this tunnel node; applicable for both IPv4 and IPv6
probe_http:
allOf:
- $ref: '#/components/schemas/tunnel_config_node_probe_http2'
- description: HTTP probe settings for this tunnel node; success from any ICMP or HTTP probe indicates the tunnel is up
probe_ip6s:
uniqueItems: true
type: array
items:
type: string
description: IPv6 ICMP probe addresses used to monitor this tunnel node
probe_ips:
uniqueItems: true
type: array
items:
type: string
description: Health-check IP addresses used to monitor this tunnel node
remote_ids:
type: array
items:
type: string
description: IKE identities expected from this tunnel node
wan_names:
type: array
items:
type: string
description: Interface names that source tunnel traffic for this node
description: Main remote tunnel endpoint settings
tunnel_config_probe_type2:
title: tunnel_config_probe_type2
enum:
- http
- icmp
type: string
description: 'Protocol used by the custom IPsec tunnel health probe. enum: `http`, `icmp`.'
tunnel_config_protocol2:
title: tunnel_config_protocol2
enum:
- gre
- ipsec
type: string
description: 'Only if `provider`==`custom-ipsec`. Tunnel protocol for custom tunnel negotiation. enum: `gre`, `ipsec`.'
tunnel_config_provider2:
title: tunnel_config_provider2
enum:
- custom-ipsec
- custom-gre
- jse-ipsec
- prisma-ipsec
- zscaler-gre
- zscaler-ipsec
type: string
description: 'Tunnel provider used when auto provisioning is disabled. enum: `custom-ipsec`, `custom-gre`, `jse-ipsec`, `prisma-ipsec`, `zscaler-gre`, `zscaler-ipsec`.'
tunnel_config_tunnel_mode2:
title: tunnel_config_tunnel_mode2
enum:
- active-active
- active-standby
type: string
description: 'Tunnel failover mode used for primary and secondary endpoints. enum: `active-active`, `active-standby`.'
tunnel_config_version2:
title: tunnel_config_version2
enum:
- '1'
- '2'
type: string
description: 'Only if `provider`==`custom-gre` or `provider`==`custom-ipsec`. Tunnel version value for custom tunnel configuration. enum: `1`, `2`.'
tunnel_priority1:
title: tunnel_priority1
enum:
- primary
- secondary
type: string
description: 'Relative preference assigned to the tunnel. enum: `primary`, `secondary`.'
tunnel_provider_options_jse2:
title: tunnel_provider_options_jse2
type: object
properties:
num_users:
type: integer
description: User capacity to provision on Juniper Secure Edge
contentEncoding: int32
examples:
- 5
org_name:
type: string
description: JSE Organization name. The list of available organizations can be retrieved with the [Get Org JSE Info]($e/Orgs%20Integration%20JSE/getOrgJseInfo) API Call
examples:
- JSE_ORG1
description: Juniper Secure Edge provisioning options for tunnel endpoints
tunnel_provider_options_prisma2:
title: tunnel_provider_options_prisma2
type: object
properties:
service_account_name:
type: string
description: For prisma-ipsec, service account name to used for tunnel auto provisioning
examples:
- sa1@1823425211
description: Palo Alto Prisma Access provisioning options for tunnel endpoints
tunnel_provider_options_zscaler2:
title: tunnel_provider_options_zscaler2
type: object
properties:
aup_block_internet_until_accepted:
type: boolean
description: Whether Zscaler blocks internet access until the Acceptable Use Policy is accepted
default: false
aup_enabled:
type: boolean
description: Can only be `true` when `auth_required`==`false`, display Acceptable Use Policy (AUP)
default: false
aup_force_ssl_inspection:
type: boolean
description: Proxy HTTPs traffic, requiring Zscaler cert to be installed in browser
default: false
aup_timeout_in_days:
maximum: 180
minimum: 1
type: integer
description: Required if `aup_enabled`==`true`. Days before AUP is requested again
contentEncoding: int32
auth_required:
type: boolean
description: Enable this option to enforce user authentication
default: false
caution_enabled:
type: boolean
description: Can only be `true` when `auth_required`==`false`, display caution notification for non-authenticated users
default: false
dn_bandwidth:
maximum: 99999
minimum: 0.1
type:
- number
- 'null'
description: Download bandwidth cap of the link, in Mbps. Disabled if not set
examples:
- 200
idle_time_in_minutes:
maximum: 43200
minimum: 0
type: integer
description: Required if `surrogate_IP`==`true`, idle Time to Disassociation
contentEncoding: int32
ofw_enabled:
type: boolean
description: If `true`, enable the firewall control option
default: false
sub_locations:
type: array
items:
$ref: '#/components/schemas/tunnel_provider_options_zscaler_sub_location'
description: Per-network Zscaler sub-location settings
surrogate_IP:
type: boolean
description: Can only be `true` when `auth_required`==`true`. Map a user to a private IP address so it applies the user's policies, instead of the location's policies
default: false
surrogate_IP_enforced_for_known_browsers:
type: boolean
description: Can only be `true` when `surrogate_IP`==`true`, enforce surrogate IP for known browsers
surrogate_refresh_time_in_minutes:
maximum: 43200
minimum: 1
type: integer
description: Required if `surrogate_IP_enforced_for_known_browsers`==`true`, must be lower or equal than `idle_time_in_minutes`, refresh Time for re-validation of Surrogacy
contentEncoding: int32
up_bandwidth:
maximum: 99999
minimum: 0.1
type:
- number
- 'null'
description: Download bandwidth cap of the link, in Mbps. Disabled if not set
examples:
- 200
xff_forward_enabled:
type: boolean
description: Location uses proxy chaining to forward traffic
default: false
description: Provider settings for Zscaler tunnel endpoints
tunnel_provider_options1:
title: tunnel_provider_options1
type: object
properties:
jse:
allOf:
- $ref: '#/components/schemas/tunnel_provider_options_jse2'
- description: Juniper Secure Edge provisioning options for tunnel endpoints
prisma:
allOf:
- $ref: '#/components/schemas/tunnel_provider_options_prisma2'
- description: Palo Alto Prisma Access provisioning options for tunnel endpoints
zscaler:
allOf:
- $ref: '#/components/schemas/tunnel_provider_options_zscaler2'
- description: Provider settings for Zscaler tunnel endpoints
description: Provider-specific tunnel options defined by this gateway profile
tunnel_provider_options2:
title: tunnel_provider_options2
type: object
properties:
jse:
allOf:
- $ref: '#/components/schemas/tunnel_provider_options_jse2'
- description: Juniper Secure Edge provisioning options for tunnel endpoints
prisma:
allOf:
- $ref: '#/components/schemas/tunnel_provider_options_prisma2'
- description: Palo Alto Prisma Access provisioning options for tunnel endpoints
zscaler:
allOf:
- $ref: '#/components/schemas/tunnel_provider_options_zscaler2'
- description: Provider settings for Zscaler tunnel endpoints
description: Provider-specific tunnel options defined by this gateway template
tunnel_provider_options4:
title: tunnel_provider_options4
type: object
properties:
jse:
allOf:
- $ref: '#/components/schemas/tunnel_provider_options_jse2'
- description: Juniper Secure Edge provisioning options for tunnel endpoints
prisma:
allOf:
- $ref: '#/components/schemas/tunnel_provider_options_prisma2'
- description: Palo Alto Prisma Access provisioning options for tunnel endpoints
zscaler:
allOf:
- $ref: '#/components/schemas/tunnel_provider_options_zscaler2'
- description: Provider settings for Zscaler tunnel endpoints
description: Provider-specific options for tunnels terminated by this gateway
tunnel_via2:
title: tunnel_via2
enum:
- primary
- secondary
type: string
description: If `via`==`tunnel`, primary or secondary tunnel associated with this BGP neighbor
tunterm_dhcpd_config2:
title: tunterm_dhcpd_config2
type: object
properties:
enabled:
type: boolean
description: Whether DHCP relay is enabled for tunnel termination VLANs
default: false
servers:
uniqueItems: true
type: array
items:
type: string
description: DHCP server IP addresses used as relay targets
type:
allOf:
- $ref: '#/components/schemas/tunterm_dhcpd_type3'
- description: 'DHCP forwarding mode for tunnel termination VLANs. enum: `relay`.'
additionalProperties:
allOf:
- $ref: '#/components/schemas/tunterm_dhcpd_config_property'
- description: Per-VLAN DHCP relay configuration for tunnel termination
description: DHCP relay or server settings for tunneled VLANs
tunterm_dhcpd_type1:
title: tunterm_dhcpd_type1
const: relay
type: string
description: 'DHCP forwarding mode for this tunneled VLAN. enum: `relay`.'
tunterm_dhcpd_type3:
title: tunterm_dhcpd_type3
const: relay
type: string
description: 'DHCP forwarding mode for tunnel termination VLANs. enum: `relay`.'
tunterm_monitoring_protocol2:
title: tunterm_monitoring_protocol2
enum:
- arp
- ping
- tcp
type: string
description: 'Monitoring method used for this tunnel termination check. enum: `arp`, `ping`, `tcp`.'
examples:
- tcp
tunterm_port_config1:
title: tunterm_port_config1
type: object
properties:
downstream_ports:
type: array
items:
type: string
description: Ports connected downstream toward APs for tunnel termination
examples:
- - '2'
- '3'
separate_upstream_downstream:
type: boolean
description: Whether to separate upstream / downstream ports. default is false where all ports will be used.
default: false
upstream_port_vlan_id:
oneOf:
- type: string
- maximum: 4094
minimum: 1
type: integer
contentEncoding: int32
description: Native VLAN ID applied to upstream tunnel termination ports
upstream_ports:
type: array
items:
type: string
description: Ports connected upstream toward the LAN for tunnel termination
examples:
- - '0'
- '1'
description: Tunnel termination Ethernet port configuration for a Mist Edge replacement
tunterm_port_config3:
title: tunterm_port_config3
type: object
properties:
downstream_ports:
type: array
items:
type: string
description: Ports connected downstream toward APs for tunnel termination
examples:
- - '2'
- '3'
separate_upstream_downstream:
type: boolean
description: Whether to separate upstream / downstream ports. default is false where all ports will be used.
default: false
upstream_port_vlan_id:
oneOf:
- type: string
- maximum: 4094
minimum: 1
type: integer
contentEncoding: int32
description: Native VLAN ID applied to upstream tunnel termination ports
upstream_ports:
type: array
items:
type: string
description: Ports connected upstream toward the LAN for tunnel termination
examples:
- - '0'
- '1'
description: Port configuration for tunnel termination traffic
ui_settings_default_time_range2:
title: ui_settings_default_time_range2
type: object
properties:
end:
type: integer
description: Upper bound of the default databoard time range, in epoch seconds
contentEncoding: int32
examples:
- 1508828400
endDate:
type: string
description: Display date for the end of the default databoard time range
examples:
- 10/23/2017
interval:
type: string
description: Bucket interval used for the default databoard time range
examples:
- 1d
name:
type: string
description: Display name for the default databoard time range
examples:
- This Week
shortName:
type: string
description: Compact display label for the default databoard time range
examples:
- thisWeek
start:
type: integer
description: Lower bound of the default databoard time range, in epoch seconds
contentEncoding: int32
examples:
- 1508655600
usePreset:
type: boolean
description: Whether the default databoard time range uses a named preset
examples:
- true
description: Time range used by default for this databoard
ui_settings_tile_metric2:
title: ui_settings_tile_metric2
type: object
properties:
apiName:
type: string
description: Metric API name requested by this tile
examples:
- client_dhcp_latency
description: Selected measurement configuration displayed by this tile
ui_settings_tile_time_range2:
title: ui_settings_tile_time_range2
type: object
properties:
end:
type: number
description: Upper bound of the tile time range, in epoch seconds
examples:
- 1508823743
endDate:
type: string
description: Display date for the end of the tile time range
examples:
- 10/23/2017
interval:
type: string
description: Bucket interval used for the tile time range
examples:
- 1d
name:
type: string
description: Display name for the tile time range
examples:
- Past 7 Days
shortName:
type: string
description: Compact display label for the tile time range
examples:
- 7d
start:
type: integer
description: Lower bound of the tile time range, in epoch seconds
contentEncoding: int32
examples:
- 1508223600
usePreset:
type: boolean
description: Whether the tile time range uses a named preset
examples:
- true
description: Time range override for this tile
upgrade_device_rrm_mesh_upgrade1:
title: upgrade_device_rrm_mesh_upgrade1
enum:
- parallel
- sequential
type: string
description: 'For APs only and if `strategy`==`rrm`. Mesh AP upgrade order for the organization upgrade. enum: `parallel`, `sequential`.'
upgrade_device_rrm_mesh_upgrade2:
title: upgrade_device_rrm_mesh_upgrade2
enum:
- parallel
- sequential
type: string
description: 'For APs only and if `strategy`==`rrm`. Mesh AP upgrade order for the site upgrade. enum: `parallel`, `sequential`.'
upgrade_device_rrm_node_order1:
title: upgrade_device_rrm_node_order1
enum:
- center_to_fringe
- fringe_to_center
type: string
description: 'For APs only and if `strategy`==`rrm`. AP ordering direction for RRM upgrade batches. enum: `center_to_fringe`, `fringe_to_center`.'
upgrade_device_status1:
title: upgrade_device_status1
enum:
- cancelled
- completed
- created
- downloaded
- downloading
- failed
- queued
- upgrading
type: string
description: 'Current status of the site device upgrade job. enum: `cancelled`, `completed`, `created`, `downloaded`, `downloading`, `failed`, `queued`, `upgrading`.'
upgrade_device_status2:
title: upgrade_device_status2
enum:
- cancelled
- completed
- created
- downloaded
- downloading
- failed
- queued
- upgrading
type: string
description: 'Current status of the site-level upgrade job. enum: `cancelled`, `completed`, `created`, `downloaded`, `downloading`, `failed`, `queued`, `upgrading`.'
upgrade_device_strategy1:
title: upgrade_device_strategy1
enum:
- big_bang
- canary
- rrm
- serial
type: string
description: 'Device upgrade strategy used by this job. enum: `big_bang`, `canary`, `rrm`, `serial`.'
upgrade_device_strategy2:
title: upgrade_device_strategy2
enum:
- big_bang
- canary
- rrm
- serial
type: string
description: 'Execution strategy used for the organization upgrade job. enum: `big_bang`, `canary`, `rrm`, `serial`.'
upgrade_device_strategy4:
title: upgrade_device_strategy4
enum:
- big_bang
- canary
- rrm
- serial
type: string
description: 'Device reboot orchestration strategy for selected devices. enum: `big_bang`, `canary`, `rrm`, `serial`.'
upgrade_device_strategy5:
title: upgrade_device_strategy5
enum:
- big_bang
- canary
- rrm
- serial
type: string
description: 'Upgrade orchestration strategy for selected devices. enum: `big_bang`, `canary`, `rrm`, `serial`.'
upgrade_devices_targets1:
title: upgrade_devices_targets1
type: object
properties:
download_requested:
type: array
items:
type: string
description: Device MAC addresses for devices requested to download firmware
downloaded:
type: array
items:
type: string
description: Device MAC addresses for devices that have downloaded firmware
downloading:
type: array
items:
type: string
description: Device MAC addresses for devices currently downloading firmware
failed:
type: array
items:
type: string
description: Device MAC addresses for devices that failed to upgrade
reboot_in_progress:
type: array
items:
type: string
description: Device MAC addresses for devices currently rebooting
rebooted:
type: array
items:
type: string
description: Device MAC addresses for devices that rebooted successfully
scheduled:
type: array
items:
type: string
description: Device MAC addresses for devices scheduled for upgrade by the cloud
skipped:
type: array
items:
type: string
description: Device MAC addresses for devices skipped because the requested version matched the running version
total:
type: integer
description: Count of devices part of this upgrade
contentEncoding: int32
upgraded:
type: array
items:
type: string
description: Device MAC addresses for devices that upgraded successfully
description: Device targets grouped by upgrade state
upgrade_devices_targets3:
title: upgrade_devices_targets3
type: object
properties:
download_requested:
type: array
items:
type: string
description: Device MAC addresses for devices requested to download firmware
downloaded:
type: array
items:
type: string
description: Device MAC addresses for devices that have downloaded firmware
downloading:
type: array
items:
type: string
description: Device MAC addresses for devices currently downloading firmware
failed:
type: array
items:
type: string
description: Device MAC addresses for devices that failed to upgrade
reboot_in_progress:
type: array
items:
type: string
description: Device MAC addresses for devices currently rebooting
rebooted:
type: array
items:
type: string
description: Device MAC addresses for devices that rebooted successfully
scheduled:
type: array
items:
type: string
description: Device MAC addresses for devices scheduled for upgrade by the cloud
skipped:
type: array
items:
type: string
description: Device MAC addresses for devices skipped because the requested version matched the running version
total:
type: integer
description: Count of devices part of this upgrade
contentEncoding: int32
upgraded:
type: array
items:
type: string
description: Device MAC addresses for devices that upgraded successfully
description: Device targets grouped by upgrade and download status
upgrade_info_status2:
title: upgrade_info_status2
enum:
- error
- inprogress
- scheduled
- starting
- success
type: string
description: 'Current status of the requested device upgrade. enum: `error`, `inprogress`, `scheduled`, `starting`, `success`.'
upgrade_org_devices_download_strategy2:
title: upgrade_org_devices_download_strategy2
enum:
- canary
- big_bang
- serial
type: string
description: 'Firmware download orchestration strategy for the organization upgrade. enum: `canary`, `big_bang`, `serial`.'
upgrade_org_devices_upgrade_info2:
title: upgrade_org_devices_upgrade_info2
type: object
properties:
id:
type: string
description: Unique value identifying the site-level upgrade job
contentEncoding: uuid
readOnly: true
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
start_time:
type: integer
description: Epoch timestamp, in seconds, when the site-level upgrade starts
contentEncoding: int32
examples:
- 1717658765
status:
allOf:
- $ref: '#/components/schemas/upgrade_device_status2'
- description: 'Current status of the site-level upgrade job. enum: `cancelled`, `completed`, `created`, `downloaded`, `downloading`, `failed`, `queued`, `upgrading`.'
targets:
allOf:
- $ref: '#/components/schemas/upgrade_devices_targets1'
- description: Device targets grouped by upgrade state
readOnly: true
description: Site-level job details for this upgrade entry
upgrade_org_devices_version_firmware_type2:
title: upgrade_org_devices_version_firmware_type2
enum:
- ap
- junos
- ssr
type: string
description: 'Firmware family this version entry applies to. enum: `ap`, `junos`, `ssr`.'
upgrade_site_devices_counts2:
title: upgrade_site_devices_counts2
type: object
properties:
download_requested:
type: integer
description: Count of devices which cloud has requested to download firmware
contentEncoding: int32
downloaded:
type: integer
description: Count of ap's which have the firmware downloaded
contentEncoding: int32
failed:
type: integer
description: Count of devices which have failed to upgrade
contentEncoding: int32
reboot_in_progress:
type: integer
description: Count of devices which are rebooting
contentEncoding: int32
rebooted:
type: integer
description: Count of devices which have rebooted successfully
contentEncoding: int32
scheduled:
type: integer
description: Count of devices which cloud has scheduled an upgrade for
contentEncoding: int32
skipped:
type: integer
description: Count of devices which skipped upgrade since requested version was same as running version. Use force to always upgrade
contentEncoding: int32
total:
type: integer
description: Count of devices part of this upgrade
contentEncoding: int32
upgraded:
type: integer
description: Count of devices which have upgraded successfully
contentEncoding: int32
description: Device counts grouped by upgrade status for this job
use_auto_ap_values_for2:
title: use_auto_ap_values_for2
enum:
- orientation
- placement
type: string
description: 'Localization value type to accept or reject. enum: `orientation`, `placement`.'
utils_clear_bgp_type2:
title: utils_clear_bgp_type2
enum:
- hard
- in
- out
- soft
type: string
description: 'BGP clear operation type to run. enum: `hard`, `in`, `out`, `soft`.'
utils_devices_restart_node2:
title: utils_devices_restart_node2
enum:
- node0
- node1
type: string
description: 'SRX or SSR node to restart. enum: `node0`, `node1`.'
utils_send_support_logs_info2:
title: utils_send_support_logs_info2
enum:
- code-dumps
- full
- messages
- outbound-ssh
- process
- var-logs
type: string
description: 'Support file bundle type to upload. enum: `code-dumps`, `full`, `messages`, `outbound-ssh`, `process`, `var-logs`.'
utils_show_route_protocol2:
title: utils_show_route_protocol2
enum:
- any
- bgp
- direct
- evpn
- ospf
- static
type: string
description: 'Routing protocol filter for route entries. enum: `any`, `bgp`, `direct`, `evpn`, `ospf`, `static`.'
utils_traceroute_protocol2:
title: utils_traceroute_protocol2
enum:
- icmp
- udp
type: string
description: 'Transport protocol to use for traceroute. enum: `icmp`, `udp`.'
vc_port_mode2:
title: vc_port_mode2
enum:
- network
- vcp-higig
- vcp-hgoe
type: string
description: 'Virtual Chassis port mode to apply. enum: `network`, `vcp-higig`, `vcp-hgoe`.'
virtual_chassis_config_member_vc_role2:
title: virtual_chassis_config_member_vc_role2
enum:
- backup
- linecard
- master
type: string
description: 'Role of this member in the Virtual Chassis. enum: `backup`, `linecard`, `master`.'
virtual_chassis_member_update_vc_role2:
title: virtual_chassis_member_update_vc_role2
enum:
- backup
- linecard
- master
type: string
description: 'Required if `op`==`add` or `op`==`preprovision`; role of the member in the Virtual Chassis. enum: `backup`, `linecard`, `master`.'
virtual_chassis_port_operation2:
title: virtual_chassis_port_operation2
enum:
- delete
- set
type: string
description: 'Action to perform on the specified Virtual Chassis ports. enum: `delete`, `set`.'
virtual_chassis_update_op2:
title: virtual_chassis_update_op2
enum:
- add
- preprovision
- remove
- renumber
type: string
description: 'Action to perform on the Virtual Chassis. enum: `add`, `preprovision`, `remove`, `renumber`.'
vpn_mode2:
title: vpn_mode2
enum:
- hub_spoke
- mesh
type: string
description: 'VPN topology mode for this configuration. enum: `hub_spoke`, `mesh`.'
vpn_path_bfd_profile2:
title: vpn_path_bfd_profile2
enum:
- broadband
- lte
type: string
description: 'BFD profile used for this VPN path. enum: `broadband`, `lte`.'
vpn_path_selection_strategy2:
title: vpn_path_selection_strategy2
enum:
- disabled
- simple
- manual
type: string
description: 'Path selection strategy for a hub-and-spoke VPN. enum: `disabled`, `simple`, `manual`.'
vpn_path_selection2:
title: vpn_path_selection2
type: object
properties:
strategy:
allOf:
- $ref: '#/components/schemas/vpn_path_selection_strategy2'
- description: 'Path selection strategy for a hub-and-spoke VPN. enum: `disabled`, `simple`, `manual`.'
description: Path selection settings used when `type`==`hub_spoke`
vpn_path_traffic_shaping2:
title: vpn_path_traffic_shaping2
type: object
properties:
class_percentage:
maxItems: 4
minItems: 4
type: array
items:
type: integer
contentEncoding: int32
description: Bandwidth percentages for high, medium, low, and best-effort traffic classes
default:
- 80
- 10
- 9
- 1
enabled:
type: boolean
description: Whether traffic shaping is enabled for this VPN path
max_tx_kbps:
type:
- integer
- 'null'
description: Maximum transmit rate for this VPN path, in Kbps; `null` means no explicit limit
contentEncoding: int32
description: Traffic shaping settings applied to this VPN path
vrf_config1:
title: vrf_config1
type: object
properties:
enabled:
type: boolean
description: Whether to enable VRF (when supported on the device)
description: VRF configuration applied to this gateway
vrf_config2:
title: vrf_config2
type: object
properties:
enabled:
type: boolean
description: Whether to enable VRF (when supported on the device)
description: VRF defaults applied by this gateway profile
vrf_config3:
title: vrf_config3
type: object
properties:
enabled:
type: boolean
description: Whether to enable VRF (when supported on the device)
description: VRF defaults applied by this switch profile
vrf_config4:
title: vrf_config4
type: object
properties:
enabled:
type: boolean
description: Whether to enable VRF (when supported on the device)
description: VRF defaults applied by this gateway template
vrf_config5:
title: vrf_config5
type: object
properties:
enabled:
type: boolean
description: Whether to enable VRF (when supported on the device)
description: VRF defaults applied by this network template
vrf_config6:
title: vrf_config6
type: object
properties:
enabled:
type: boolean
description: Whether to enable VRF (when supported on the device)
description: Routing instance configuration for the site
vrf_config8:
title: vrf_config8
type: object
properties:
enabled:
type: boolean
description: Whether to enable VRF (when supported on the device)
description: VRF configuration applied to this switch
vrrp_config1:
title: vrrp_config1
type: object
properties:
enabled:
type: boolean
description: Whether VRRP configuration is enabled
groups:
type: object
additionalProperties:
$ref: '#/components/schemas/vrrp_config_group'
description: VRRP groups keyed by group name
description: VRRP defaults applied by this switch profile
vrrp_config3:
title: vrrp_config3
type: object
properties:
enabled:
type: boolean
description: Whether VRRP configuration is enabled
groups:
type: object
additionalProperties:
$ref: '#/components/schemas/vrrp_config_group'
description: VRRP groups keyed by group name
description: VRRP configuration applied to this switch
vrrp_group_auth_type2:
title: vrrp_group_auth_type2
enum:
- md5
- simple
type: string
description: 'Authentication method used by the VRRP group. enum: `md5`, `simple`.'
examples:
- md5
wan_tunnel_protocol1:
title: wan_tunnel_protocol1
enum:
- gre
- ipsec
type: string
description: 'Tunnel protocol used for the connection. enum: `gre`, `ipsec`.'
webhook_action1:
title: webhook_action1
enum:
- permit
- block
type: string
description: 'Action applied when the rule matches the incoming event. enum: `permit`, `block`.'
webhook_action3:
title: webhook_action3
enum:
- permit
- block
type: string
description: 'Default action applied when none of the `rules` match the incoming event. enum: `permit`, `block`.'
webhook_client_info_topic2:
title: webhook_client_info_topic2
const: client-info
type: string
description: 'Webhook topic name for client information deliveries. enum: `client-info`.'
webhook_client_latency_topic2:
title: webhook_client_latency_topic2
const: client-latency
type: string
description: 'Webhook topic name for client latency deliveries. enum: `client-latency`.'
webhook_delivery_status2:
title: webhook_delivery_status2
enum:
- failure
- success
type: string
description: 'Delivery result for the webhook request. enum: `failure`, `success`.'
examples:
- failure
webhook_delivery_topic2:
title: webhook_delivery_topic2
enum:
- alarms
- audits
- device-updowns
- occupancy-alerts
- ping
type: string
description: 'Webhook topic delivered in this request. enum: `alarms`, `audits`, `device-updowns`, `occupancy-alerts`, `ping`.'
examples:
- audits
webhook_device_events_event_ev_type2:
title: webhook_device_events_event_ev_type2
enum:
- notice
- warn
type: string
description: 'Advisory severity for the device event. enum: `notice`, `warn`.'
webhook_guest_authorizations_topic2:
title: webhook_guest_authorizations_topic2
const: guest-authorizations
type: string
description: 'Webhook topic name for guest authorization deliveries. enum: `guest-authorizations`.'
webhook_location_centrak_event_type2:
title: webhook_location_centrak_event_type2
const: wifi
type: string
description: 'Location object type for the CenTrak event. enum: `wifi`.'
webhook_nac_accounting_topic2:
title: webhook_nac_accounting_topic2
const: nac-accounting
type: string
description: 'Webhook topic name for NAC accounting deliveries. enum: `nac-accounting`.'
webhook_nac_events_topic2:
title: webhook_nac_events_topic2
const: nac-events
type: string
description: 'Webhook topic name for NAC event deliveries. enum: `nac-events`.'
webhook_oauth2_grant_type2:
title: webhook_oauth2_grant_type2
enum:
- client_credentials
- password
type: string
description: 'OAuth2 grant type used when `type`==`oauth2`. enum: `client_credentials`, `password`.'
webhook_occupancy_alert_type1:
title: webhook_occupancy_alert_type1
enum:
- COMPLIANCE-OK
- COMPLIANCE-VIOLATION
type: string
description: 'Occupancy compliance state reported for the zone. enum: `COMPLIANCE-OK`, `COMPLIANCE-VIOLATION`.'
webhook_site_sle_event_sle2:
title: webhook_site_sle_event_sle2
type: object
properties:
ap-availability:
type: number
description: Wireless AP availability SLE score for the site
examples:
- 0.6
successful-connect:
type: number
description: Connection success SLE score for the site
examples:
- 0.7
time-to-connect:
type: number
description: Client connection-time SLE score for the site
examples:
- 0.9
description: Service-level experience scores reported for the site
webhook_type2:
title: webhook_type2
enum:
- aws-sns
- google-pubsub
- http-post
- oauth2
- splunk
type: string
description: 'Delivery mechanism used by this webhook. enum: `aws-sns`, `google-pubsub`, `http-post`, `oauth2`, `splunk`.'
webhook_zone_event_trigger1:
title: webhook_zone_event_trigger1
enum:
- enter
- exit
type: string
description: 'Whether the client or asset entered or exited the zone. enum: `enter`, `exit`.'
webhook_zone_event_trigger3:
title: webhook_zone_event_trigger3
enum:
- enter
- exit
type: string
description: 'Whether the client entered or exited the RSSI zone. enum: `enter`, `exit`.'
webhook_zone_event_type1:
title: webhook_zone_event_type1
enum:
- asset
- sdk
- wifi
type: string
description: 'Client or asset type reported for the zone event. enum: `asset`, `sdk`, `wifi`.'
webhook_zone_event_type3:
title: webhook_zone_event_type3
enum:
- asset
- sdk
- wifi
type: string
description: 'Client type reported for the RSSI zone event. enum: `asset`, `sdk`, `wifi`.'
wlan_airwatch2:
title: wlan_airwatch2
type: object
properties:
api_key:
type: string
description: API key used to authenticate to the AirWatch service
examples:
- aHhlbGxvYXNkZmFzZGZhc2Rmc2RmCg=="
console_url:
type: string
description: Base console URL of the AirWatch deployment
examples:
- https://hs1.airwatchportals.com
enabled:
type: boolean
description: Whether AirWatch integration is enabled for the WLAN
default: false
password:
type: string
description: AirWatch integration account password for this WLAN
contentEncoding: password
examples:
- user1
username:
type: string
description: AirWatch integration account username for this WLAN
examples:
- test123
description: Integration settings for AirWatch device compliance on this WLAN
wlan_app_limit2:
title: wlan_app_limit2
type: object
properties:
apps:
type: object
additionalProperties:
type: integer
format: int32
description: "Map from app key to bandwidth in kbps. \nProperty key is the app key, defined in Get Application List"
default: {}
examples:
- dropbox: 300
netflix: 60
enabled:
type: boolean
description: Whether application bandwidth limits are enabled for this WLAN
default: false
wxtag_ids:
type: object
additionalProperties:
type: integer
format: int32
description: Map from wxtag_id of Hostname Wxlan Tags to bandwidth in kbps. Property key is the `wxtag_id`
default: {}
examples:
- f99862d9-2726-931f-7559-3dfdf5d070d3: 30
description: Bandwidth limits for applications on this WLAN
wlan_app_qos2:
title: wlan_app_qos2
type: object
properties:
apps:
type: object
additionalProperties:
$ref: '#/components/schemas/wlan_app_qos_apps_properties'
description: Map of application keys to QoS rewrite settings
examples:
- skype-business-video:
dscp: 32
dst_subnet: 10.2.0.0/16
src_subnet: 10.2.0.0/16
enabled:
type: boolean
description: Whether application QoS rewrite rules are enabled for this WLAN
default: false
others:
uniqueItems: true
type: array
items:
$ref: '#/components/schemas/wlan_app_qos_others_item'
description: Custom traffic QoS rules that are not tied to named applications
description: QoS rules for application traffic on this WLAN
wlan_apply_to2:
title: wlan_apply_to2
enum:
- aps
- site
- wxtags
type: string
description: 'Scope that determines where this WLAN is applied. enum: `aps`, `site`, `wxtags`.'
wlan_auth_owe2:
title: wlan_auth_owe2
enum:
- disabled
- enabled
- required
type: string
description: 'When `type`==`open`, Opportunistic Wireless Encryption mode for this WLAN. enum: `disabled`, `enabled`, `required`.'
wlan_auth_server_selection2:
title: wlan_auth_server_selection2
enum:
- ordered
- unordered
type: string
description: 'RADIUS authentication server selection behavior for this WLAN. enum: `ordered`, `unordered`.'
examples:
- ordered
wlan_auth_type2:
title: wlan_auth_type2
enum:
- eap
- eap192
- open
- psk
- psk-tkip
- psk-wpa2-tkip
- wep
type: string
description: 'Authentication mode used by this WLAN. enum: `eap`, `eap192`, `open`, `psk`, `psk-tkip`, `psk-wpa2-tkip`, `wep`.'
examples:
- psk
wlan_auth2:
title: wlan_auth2
required:
- type
type: object
properties:
anticlog_threshold:
maximum: 32
minimum: 16
type: integer
description: SAE anti-clogging token threshold
contentEncoding: int32
default: 16
examples:
- 16
eap_reauth:
type: boolean
description: Whether to trigger EAP reauth when the session ends
default: false
enable_beacon_protection:
type: boolean
description: Enable Beacon Protection; default is false for better compatibility
default: false
enable_gcmp256:
type: boolean
description: Enable GCMP-256 encryption suite; default is false for better compatibility
default: false
enable_mac_auth:
type: boolean
description: Whether to enable MAC Auth, uses the same auth_servers
default: false
key_idx:
maximum: 4
minimum: 1
type: integer
description: When `type`==`wep`, index of the WEP key used as the default transmit key
contentEncoding: int32
default: 1
keys:
type: array
items:
type:
- string
- 'null'
description: When `type`==`wep`, WEP keys configured for this WLAN
default: []
multi_psk_only:
type: boolean
description: When `type`==`psk`, whether to only use multi_psk
default: false
owe:
allOf:
- $ref: '#/components/schemas/wlan_auth_owe2'
- description: 'When `type`==`open`, Opportunistic Wireless Encryption mode for this WLAN. enum: `disabled`, `enabled`, `required`.'
pairwise:
type: array
items:
oneOf:
- {}
- $ref: '#/components/schemas/wlan_auth_pairwise_item'
description: When `type`==`psk` or `type`==`eap`, pairwise cipher suites allowed for this WLAN
private_wlan:
type: boolean
description: When `multi_psk_only`==`true`, whether private wlan is enabled
default: false
psk:
maxLength: 64
minLength: 8
type:
- string
- 'null'
description: When `type`==`psk`, 8-64 characters, or 64 hex characters
examples:
- foryoureyesonly
type:
allOf:
- $ref: '#/components/schemas/wlan_auth_type2'
- description: 'Authentication mode used by this WLAN. enum: `eap`, `eap192`, `open`, `psk`, `psk-tkip`, `psk-wpa2-tkip`, `wep`.'
examples:
- psk
wep_as_secondary_auth:
type: boolean
description: Enable WEP as secondary auth
default: false
description: Settings that control client authentication for this WLAN
wlan_bonjour_service_properties_scope2:
title: wlan_bonjour_service_properties_scope2
enum:
- same_ap
- same_map
- same_site
type: string
description: 'Discovery scope for this Bonjour service on the WLAN. enum: `same_ap`, `same_map`, `same_site`.'
wlan_bonjour2:
title: wlan_bonjour2
type: object
properties:
additional_vlan_ids:
anyOf:
- type: string
- type: array
items:
$ref: '#/components/schemas/vlan_id_with_variable'
description: VLAN IDs, beyond the client VLAN, where Bonjour queries and responses are forwarded
enabled:
type: boolean
description: Whether to enable bonjour for this WLAN. Once enabled, limit_bcast is assumed true, allow_mdns is assumed false
default: false
services:
type: object
additionalProperties:
$ref: '#/components/schemas/wlan_bonjour_service_properties'
description: "What services are allowed. \nProperty key is the service name"
examples:
- airplay:
radius_groups:
- teachers
scope: same_ap
description: Service discovery gateway settings for Bonjour traffic on this WLAN
wlan_cisco_cwa2:
title: wlan_cisco_cwa2
type: object
properties:
allowed_hostnames:
type: array
items:
type: string
description: Hostnames allowed for Cisco CWA client access before authorization
allowed_subnets:
type: array
items:
type: string
description: CIDR subnets allowed for Cisco CWA client access before authorization
blocked_subnets:
type: array
items:
type: string
description: CIDR subnets blocked for Cisco CWA client access
enabled:
type: boolean
description: Whether Cisco CWA is enabled for this WLAN
default: false
description: Central web authentication settings for Cisco CWA on this WLAN
wlan_datarates_template2:
title: wlan_datarates_template2
enum:
- compatible
- legacy-only
- custom
- no-legacy
- high-density
type: string
description: 'Data rate template used to derive WLAN rate settings. enum: `compatible`, `legacy-only`, `custom`, `no-legacy`, `high-density`.'
wlan_dns_server_rewrite2:
title: wlan_dns_server_rewrite2
type: object
properties:
enabled:
type: boolean
description: Whether DNS server rewrite by RADIUS group is enabled for this WLAN
default: false
radius_groups:
type: object
additionalProperties:
type: string
description: Map between radius_group and the desired DNS server (IPv4 only). Property key is the RADIUS group, property value is the desired DNS Server
examples:
- contractor: 172.1.1.1
guest: 8.8.8.8
description: RADIUS group based DNS server rewrite settings for this WLAN
wlan_dynamic_psk2:
title: wlan_dynamic_psk2
type: object
properties:
default_psk:
maxLength: 63
minLength: 8
type: string
description: Default PSK to use if cloud WLC is not available, 8-63 characters
examples:
- foryoureyesonly
default_vlan_id:
oneOf:
- type: string
- maximum: 4094
minimum: 1
type: integer
contentEncoding: int32
description: Default VLAN ID used when dynamic PSK lookup does not return a VLAN
enabled:
type: boolean
description: Whether dynamic PSK is enabled for this WLAN
default: false
force_lookup:
type: boolean
description: When 11r is enabled, we'll try to use the cached PMK, this can be disabled. `false` means auto
default: false
local_vlan_ids:
type: array
items:
$ref: '#/components/schemas/vlan_id_with_variable'
description: VLANs to be bridged locally when forwarding to mxtunnel or site mxedge
source:
allOf:
- $ref: '#/components/schemas/dynamic_psk_source1'
- description: 'Origin used to retrieve per-user PSKs. enum: `cloud_psks`, `radius`.'
examples:
- cloud_psks
description: Per-user PSK selection settings for this WLAN
wlan_dynamic_vlan_type2:
title: wlan_dynamic_vlan_type2
enum:
- airespace-interface-name
- standard
type: string
description: 'Dynamic VLAN mapping method used for RADIUS-provided VLAN attributes. enum: `airespace-interface-name`, `standard`.'
examples:
- airespace-interface-name
wlan_dynamic_vlan2:
title: wlan_dynamic_vlan2
type: object
properties:
default_vlan_id:
oneOf:
- type: string
- maximum: 4094
minimum: 1
type: integer
contentEncoding: int32
default: 999
description: Deprecated default VLAN ID used when no RADIUS VLAN match is returned. Please use `default_vlan_ids` instead, which can support VLAN pools.
deprecated: true
default_vlan_ids:
type: array
items:
$ref: '#/components/schemas/wlan_dynamic_vlan_default_vlan_id'
description: Fallback VLAN IDs, ranges, or variables used when no RADIUS VLAN match is returned
enabled:
type: boolean
description: Requires `vlan_enabled`==`true` to be set to `true`. Whether to enable dynamic vlan
default: false
local_vlan_ids:
type: array
items:
$ref: '#/components/schemas/vlan_id_with_variable'
description: VLAN IDs that should be locally bridged for dynamic VLAN assignment
type:
allOf:
- $ref: '#/components/schemas/wlan_dynamic_vlan_type2'
- description: 'Dynamic VLAN mapping method used for RADIUS-provided VLAN attributes. enum: `airespace-interface-name`, `standard`.'
examples:
- airespace-interface-name
vlans:
type: object
additionalProperties:
type: string
description: >-
Map between vlan_id (as string) to airespace interface names (comma-separated) or null for standard mapping
* if `dynamic_vlan.type`==`standard`, property key is the VLAN ID and property value is \"\"
* if `dynamic_vlan.type`==`airespace-interface-name`, property key is the VLAN ID and property value is the Airespace Interface Name
examples:
- '131': default
'322': fast,video
description: VLAN assignment settings for 802.1X dynamic VLANs
wlan_hotspot_202:
title: wlan_hotspot_202
type: object
properties:
domain_name:
type: array
items:
type: string
description: Advertised domain names for Hotspot 2.0 clients
examples:
- - mist.com
enabled:
type: boolean
description: Whether to enable hotspot 2.0 config
nai_realms:
uniqueItems: true
type: array
items:
type: string
description: NAI realms advertised for Hotspot 2.0 authentication
operators:
type: array
items:
$ref: '#/components/schemas/wlan_hotspot20_operators_item'
description: Operator profiles supported by this Hotspot 2.0 configuration
examples:
- - google
- att
rcoi:
type: array
items:
type: string
description: Roaming Consortium Organization Identifiers advertised for Hotspot 2.0
examples:
- - 5A03BA0000
venue_name:
type: string
description: Venue name, default is site name
examples:
- some_name
description: Passpoint and Hotspot 2.0 settings for this WLAN
wlan_inject_dhcp_option_822:
title: wlan_inject_dhcp_option_822
type: object
properties:
circuit_id:
type: string
description: >-
Information to set in the `circuit_id` field of the DHCP Option 82. It is possible to use static string or the following variables (e.g. `{{SSID}}:{{AP_MAC}}`):
* {{AP_MAC}}
* {{AP_MAC_DASHED}}
* {{AP_MODEL}}
* {{AP_NAME}}
* {{SITE_NAME}}
* {{SSID}}
examples:
- '{{SSID}}:{{AP_MAC}}'
enabled:
type: boolean
description: Whether to inject option 82 when forwarding DHCP packets
default: false
description: DHCP Option 82 insertion settings for this WLAN
wlan_interface2:
title: wlan_interface2
enum:
- all
- eth0
- eth1
- eth2
- eth3
- mxtunnel
- site_mxedge
- wxtunnel
type: string
description: 'Network interface or tunnel where this WLAN bridges client traffic. enum: `all`, `eth0`, `eth1`, `eth2`, `eth3`, `mxtunnel`, `site_mxedge`, `wxtunnel`.'
examples:
- all
wlan_mist_nac1:
title: wlan_mist_nac1
type: object
properties:
acct_interim_interval:
maximum: 65535
minimum: 0
type: integer
description: How frequently should interim accounting be reported, 60-65535. default is 0 (use one specified in Access-Accept request from Server). Very frequent messages can affect the performance of the RADIUS server, 600 and up is recommended when enabled.
contentEncoding: int32
default: 0
examples:
- 60
auth_servers_retries:
maximum: 10
minimum: 1
type: integer
description: RADIUS auth session retries. Following fast timers are set if `fast_dot1x_timers` knob is enabled. "retries" are set to value of `auth_servers_timeout`. "max-requests" is also set when setting `auth_servers_retries` is set to default value to 3.
contentEncoding: int32
default: 2
examples:
- 3
auth_servers_timeout:
maximum: 30
minimum: 1
type: integer
description: RADIUS auth session timeout. Following fast timers are set if `fast_dot1x_timers` knob is enabled. "quite-period" and "transmit-period" are set to half the value of `auth_servers_timeout`. "supplicant-timeout" is also set when setting `auth_servers_timeout` is set to default value of 10.
contentEncoding: int32
default: 5
examples:
- 5
coa_enabled:
type: boolean
description: Allows a RADIUS server to dynamically modify the authorization status of a user session.
default: false
coa_port:
maximum: 65535
minimum: 1
type: integer
description: the communication port used for “Change of Authorization” (CoA) messages
contentEncoding: int32
examples:
- 3799
enabled:
type: boolean
description: >-
When enabled:
* `auth_servers` is ignored
* `acct_servers` is ignored
* `auth_servers_*` are ignored
* `coa_servers` is ignored
* `radsec` is ignored
* `coa_enabled` is assumed
default: false
fast_dot1x_timers:
type: boolean
description: If set to true, sets default fast-timers with values calculated from `auth_servers_timeout` and `auth_server_retries`.
default: false
network:
type:
- string
- 'null'
description: Which network the mist nac server resides in
examples:
- default
source_ip:
type:
- string
- 'null'
description: In case there is a static IP for this network, we can specify it using source ip
examples:
- 1.2.3.4
description: Juniper Mist NAC settings used by this WLAN
wlan_mist_nac3:
title: wlan_mist_nac3
type: object
properties:
acct_interim_interval:
maximum: 65535
minimum: 0
type: integer
description: How frequently should interim accounting be reported, 60-65535. default is 0 (use one specified in Access-Accept request from Server). Very frequent messages can affect the performance of the RADIUS server, 600 and up is recommended when enabled.
contentEncoding: int32
default: 0
examples:
- 60
auth_servers_retries:
maximum: 10
minimum: 1
type: integer
description: RADIUS auth session retries. Following fast timers are set if `fast_dot1x_timers` knob is enabled. "retries" are set to value of `auth_servers_timeout`. "max-requests" is also set when setting `auth_servers_retries` is set to default value to 3.
contentEncoding: int32
default: 2
examples:
- 3
auth_servers_timeout:
maximum: 30
minimum: 1
type: integer
description: RADIUS auth session timeout. Following fast timers are set if `fast_dot1x_timers` knob is enabled. "quite-period" and "transmit-period" are set to half the value of `auth_servers_timeout`. "supplicant-timeout" is also set when setting `auth_servers_timeout` is set to default value of 10.
contentEncoding: int32
default: 5
examples:
- 5
coa_enabled:
type: boolean
description: Allows a RADIUS server to dynamically modify the authorization status of a user session.
default: false
coa_port:
maximum: 65535
minimum: 1
type: integer
description: the communication port used for “Change of Authorization” (CoA) messages
contentEncoding: int32
examples:
- 3799
enabled:
type: boolean
description: >-
When enabled:
* `auth_servers` is ignored
* `acct_servers` is ignored
* `auth_servers_*` are ignored
* `coa_servers` is ignored
* `radsec` is ignored
* `coa_enabled` is assumed
default: false
fast_dot1x_timers:
type: boolean
description: If set to true, sets default fast-timers with values calculated from `auth_servers_timeout` and `auth_server_retries`.
default: false
network:
type:
- string
- 'null'
description: Which network the mist nac server resides in
examples:
- default
source_ip:
type:
- string
- 'null'
description: In case there is a static IP for this network, we can specify it using source ip
examples:
- 1.2.3.4
description: Juniper Mist NAC settings used by AP port authentication
wlan_portal_auth2:
title: wlan_portal_auth2
enum:
- amazon
- azure
- email
- external
- facebook
- google
- microsoft
- multi
- none
- password
- sms
- sponsor
- sso
type: string
description: 'Guest portal login scheme used by the WLAN. enum: `amazon`, `azure`, `email`, `external`, `facebook`, `google`, `microsoft`, `multi`, `none`, `password`, `sms`, `sponsor`, `sso`.'
examples:
- none
wlan_portal_idp_sign_algo2:
title: wlan_portal_idp_sign_algo2
enum:
- sha1
- sha256
- sha384
- sha512
type: string
description: 'Optional if `wlan_portal_auth`==`sso`. Signing algorithm used for SAML assertions from the identity provider. enum: `sha1`, `sha256`, `sha384`, `sha512`.'
wlan_portal_sms_provider2:
title: wlan_portal_sms_provider2
enum:
- broadnet
- clickatell
- gupshup
- manual
- puzzel
- telstra
- twilio
- smsglobal
type: string
description: 'Optional if `sms_enabled`==`true`. SMS provider used to deliver guest portal access codes. enum: `broadnet`, `clickatell`, `gupshup`, `manual`, `puzzel`, `telstra`, `twilio`, `smsglobal`.'
examples:
- twilio
wlan_portal_sso_nameid_format2:
title: wlan_portal_sso_nameid_format2
enum:
- email
- unspecified
type: string
description: 'Optional if `wlan_portal_auth`==`sso`. SAML NameID format expected from the identity provider. enum: `email`, `unspecified`.'
wlan_portal_template_setting_locale1:
title: wlan_portal_template_setting_locale1
type: object
properties:
authButtonAmazon:
type: string
description: Label for Amazon auth button
authButtonAzure:
type: string
description: Label for Azure auth button
authButtonEmail:
type: string
description: Label for Email auth button
authButtonFacebook:
type: string
description: Label for Facebook auth button
authButtonGoogle:
type: string
description: Label for Google auth button
authButtonMicrosoft:
type: string
description: Label for Microsoft auth button
authButtonPassphrase:
type: string
description: Label for passphrase auth button
authButtonSms:
type: string
description: Label for SMS auth button
authButtonSponsor:
type: string
description: Label for Sponsor auth button
authLabel:
type: string
description: Localized heading text displayed above portal authentication options
backLink:
type: string
description: Label of the link to go back to /logon
companyError:
type: string
description: Error message when company not provided
companyLabel:
type: string
description: Localized label displayed for the company input field
emailAccessDomainError:
type: string
description: Error message when a user has valid social login but doesn't match specified email domains.
emailCancel:
type: string
description: Label for cancel confirmation code submission using email auth
emailCodeCancel:
type: string
description: Localized link text for requesting help when the email access code was not received
emailCodeError:
type: string
description: Localized error message shown when the alternate email address for access-code delivery is invalid
emailCodeFieldLabel:
type: string
description: Localized label for the email access-code input field
emailCodeMessage:
type: string
description: Localized instructional text shown before entering the email access code
emailCodeSubmit:
type: string
description: Localized button label for submitting the email access code
emailCodeTitle:
type: string
description: Localized title shown on the email access-code entry page
emailError:
type: string
description: Error message when email not provided
emailFieldLabel:
type: string
description: Localized label for the email address input field
emailLabel:
type: string
description: Localized label displayed for the email input field
emailMessage:
type: string
description: Localized instructional text explaining email access-code delivery
emailSubmit:
type: string
description: Label for confirmation code submit button using email auth
emailTitle:
type: string
description: Title for the Email registration
field1Error:
type: string
description: Error message when field1 not provided
field1Label:
type: string
description: Localized label for custom field 1 input
field2Error:
type: string
description: Error message when field2 not provided
field2Label:
type: string
description: Localized label for custom field 2 input
field3Error:
type: string
description: Error message when field3 not provided
field3Label:
type: string
description: Localized label for custom field 3 input
field4Error:
type: string
description: Error message when field4 not provided
field4Label:
type: string
description: Localized label for custom field 4 input
marketingPolicyLink:
type: string
description: label of the link to go to /marketing_policy
marketingPolicyOptIn:
type: boolean
description: Whether marketing policy optin is enabled
marketingPolicyOptInLabel:
type: string
description: label for marketing optin
marketingPolicyOptInText:
type: string
description: Localized text of the marketing policy opt-in content
message:
type: string
description: Localized main message displayed on the guest portal sign-in page
nameError:
type: string
description: Error message when name not provided
nameLabel:
type: string
description: Localized label displayed for the name input field
optoutLabel:
type: string
description: Label for Do Not Store My Personal Information
pageTitle:
type: string
description: Localized browser or page title shown for the guest portal
passphraseCancel:
type: string
description: Label for the Passphrase cancel button
passphraseError:
type: string
description: Error message when invalid passphrase is provided
passphraseLabel:
type: string
description: Localized label for the passphrase input field
passphraseMessage:
type: string
description: Localized instructional text shown on the passphrase sign-in page
passphraseSubmit:
type: string
description: Label for the Passphrase submit button
passphraseTitle:
type: string
description: Title for passphrase details page
privacyPolicyAcceptLabel:
type: string
description: Prefix of the label of the link to go to Privacy Policy
privacyPolicyError:
type: string
description: Error message when Privacy Policy not accepted
privacyPolicyLink:
type: string
description: Label of the link to go to Privacy Policy
privacyPolicyText:
type: string
description: Text of the Privacy Policy
requiredFieldLabel:
type: string
description: Localized text used to mark a form field as required
signInLabel:
type: string
description: Label of the button to signin
smsCarrierDefault:
type: string
description: Localized default option text shown in the SMS carrier selector
smsCarrierError:
type: string
description: Localized error message shown when no mobile carrier is selected
smsCarrierFieldLabel:
type: string
description: Label for mobile carrier drop-down list
smsCodeCancel:
type: string
description: Label for cancel confirmation code submission
smsCodeError:
type: string
description: Error message when confirmation code is invalid
smsCodeFieldLabel:
type: string
description: Localized label for the SMS confirmation-code input field
smsCodeMessage:
type: string
description: Localized instructional text shown before entering the SMS access code
smsCodeSubmit:
type: string
description: Label for confirmation code submit button
smsCodeTitle:
type: string
description: Localized title shown on the SMS access-code entry page
smsCountryFieldLabel:
type: string
description: Localized label for the SMS country-code input field
smsCountryFormat:
type: string
description: Localized example country code format shown for SMS authentication
smsHaveAccessCode:
type: string
description: Label for checkbox to specify that the user has access code
smsMessageFormat:
type: string
description: Format of access code sms message. {{code}} and {{duration}} are placeholders and should be retained as is.
smsNumberCancel:
type: string
description: Label for canceling mobile details for SMS auth
smsNumberError:
type: string
description: Localized error message shown when the mobile number is invalid
smsNumberFieldLabel:
type: string
description: Label for field to provide mobile number
smsNumberFormat:
type: string
description: Localized example mobile number format shown for SMS authentication
smsNumberMessage:
type: string
description: Localized instructional text explaining SMS access-code delivery
smsNumberSubmit:
type: string
description: Label for submit button for code generation
smsNumberTitle:
type: string
description: Title for phone number details
smsUsernameFormat:
type: string
description: Localized example username format shown for SMS authentication
sponsorBackLink:
type: string
description: Localized link text for returning to edit the sponsor request form
sponsorCancel:
type: string
description: Localized button label for canceling sponsor authentication
sponsorEmail:
type: string
description: Label for Sponsor Email
sponsorEmailError:
type: string
description: Localized error message shown when the sponsor email address is invalid
sponsorInfoApproved:
type: string
description: Localized status message prefix shown when a sponsor approves the request
sponsorInfoDenied:
type: string
description: Localized status message prefix shown when a sponsor denies the request
sponsorInfoPending:
type: string
description: Localized status message prefix shown after a sponsor notification is sent
sponsorName:
type: string
description: Label for Sponsor Name
sponsorNameError:
type: string
description: Localized error message shown when the sponsor name is missing
sponsorNotePending:
type: string
description: Localized additional status text shown while sponsor approval is pending
sponsorRequestAccess:
type: string
description: Submit button label request Wifi Access and notify sponsor about guest request
sponsorStatusApproved:
type: string
description: Text to display if sponsor approves request
sponsorStatusDenied:
type: string
description: Text to display when sponsor denies request
sponsorStatusPending:
type: string
description: Text to display if request is still pending
sponsorSubmit:
type: string
description: Submit button label to notify sponsor about guest request
sponsorsError:
type: string
description: Localized error message shown when no sponsor is selected
sponsorsFieldLabel:
type: string
description: Localized label for the sponsor selection field
tosAcceptLabel:
type: string
description: Prefix of the label of the link to go to tos
tosError:
type: string
description: Error message when tos not accepted
tosLink:
type: string
description: Label of the link to go to tos
tosText:
type: string
description: Text of the Terms of Service
description: Localized portal template strings for Catalan in Spain
wlan_portal_template_setting_locale2:
title: wlan_portal_template_setting_locale2
type: object
properties:
authButtonAmazon:
type: string
description: Label for Amazon auth button
authButtonAzure:
type: string
description: Label for Azure auth button
authButtonEmail:
type: string
description: Label for Email auth button
authButtonFacebook:
type: string
description: Label for Facebook auth button
authButtonGoogle:
type: string
description: Label for Google auth button
authButtonMicrosoft:
type: string
description: Label for Microsoft auth button
authButtonPassphrase:
type: string
description: Label for passphrase auth button
authButtonSms:
type: string
description: Label for SMS auth button
authButtonSponsor:
type: string
description: Label for Sponsor auth button
authLabel:
type: string
description: Localized heading text displayed above portal authentication options
backLink:
type: string
description: Label of the link to go back to /logon
companyError:
type: string
description: Error message when company not provided
companyLabel:
type: string
description: Localized label displayed for the company input field
emailAccessDomainError:
type: string
description: Error message when a user has valid social login but doesn't match specified email domains.
emailCancel:
type: string
description: Label for cancel confirmation code submission using email auth
emailCodeCancel:
type: string
description: Localized link text for requesting help when the email access code was not received
emailCodeError:
type: string
description: Localized error message shown when the alternate email address for access-code delivery is invalid
emailCodeFieldLabel:
type: string
description: Localized label for the email access-code input field
emailCodeMessage:
type: string
description: Localized instructional text shown before entering the email access code
emailCodeSubmit:
type: string
description: Localized button label for submitting the email access code
emailCodeTitle:
type: string
description: Localized title shown on the email access-code entry page
emailError:
type: string
description: Error message when email not provided
emailFieldLabel:
type: string
description: Localized label for the email address input field
emailLabel:
type: string
description: Localized label displayed for the email input field
emailMessage:
type: string
description: Localized instructional text explaining email access-code delivery
emailSubmit:
type: string
description: Label for confirmation code submit button using email auth
emailTitle:
type: string
description: Title for the Email registration
field1Error:
type: string
description: Error message when field1 not provided
field1Label:
type: string
description: Localized label for custom field 1 input
field2Error:
type: string
description: Error message when field2 not provided
field2Label:
type: string
description: Localized label for custom field 2 input
field3Error:
type: string
description: Error message when field3 not provided
field3Label:
type: string
description: Localized label for custom field 3 input
field4Error:
type: string
description: Error message when field4 not provided
field4Label:
type: string
description: Localized label for custom field 4 input
marketingPolicyLink:
type: string
description: label of the link to go to /marketing_policy
marketingPolicyOptIn:
type: boolean
description: Whether marketing policy optin is enabled
marketingPolicyOptInLabel:
type: string
description: label for marketing optin
marketingPolicyOptInText:
type: string
description: Localized text of the marketing policy opt-in content
message:
type: string
description: Localized main message displayed on the guest portal sign-in page
nameError:
type: string
description: Error message when name not provided
nameLabel:
type: string
description: Localized label displayed for the name input field
optoutLabel:
type: string
description: Label for Do Not Store My Personal Information
pageTitle:
type: string
description: Localized browser or page title shown for the guest portal
passphraseCancel:
type: string
description: Label for the Passphrase cancel button
passphraseError:
type: string
description: Error message when invalid passphrase is provided
passphraseLabel:
type: string
description: Localized label for the passphrase input field
passphraseMessage:
type: string
description: Localized instructional text shown on the passphrase sign-in page
passphraseSubmit:
type: string
description: Label for the Passphrase submit button
passphraseTitle:
type: string
description: Title for passphrase details page
privacyPolicyAcceptLabel:
type: string
description: Prefix of the label of the link to go to Privacy Policy
privacyPolicyError:
type: string
description: Error message when Privacy Policy not accepted
privacyPolicyLink:
type: string
description: Label of the link to go to Privacy Policy
privacyPolicyText:
type: string
description: Text of the Privacy Policy
requiredFieldLabel:
type: string
description: Localized text used to mark a form field as required
signInLabel:
type: string
description: Label of the button to signin
smsCarrierDefault:
type: string
description: Localized default option text shown in the SMS carrier selector
smsCarrierError:
type: string
description: Localized error message shown when no mobile carrier is selected
smsCarrierFieldLabel:
type: string
description: Label for mobile carrier drop-down list
smsCodeCancel:
type: string
description: Label for cancel confirmation code submission
smsCodeError:
type: string
description: Error message when confirmation code is invalid
smsCodeFieldLabel:
type: string
description: Localized label for the SMS confirmation-code input field
smsCodeMessage:
type: string
description: Localized instructional text shown before entering the SMS access code
smsCodeSubmit:
type: string
description: Label for confirmation code submit button
smsCodeTitle:
type: string
description: Localized title shown on the SMS access-code entry page
smsCountryFieldLabel:
type: string
description: Localized label for the SMS country-code input field
smsCountryFormat:
type: string
description: Localized example country code format shown for SMS authentication
smsHaveAccessCode:
type: string
description: Label for checkbox to specify that the user has access code
smsMessageFormat:
type: string
description: Format of access code sms message. {{code}} and {{duration}} are placeholders and should be retained as is.
smsNumberCancel:
type: string
description: Label for canceling mobile details for SMS auth
smsNumberError:
type: string
description: Localized error message shown when the mobile number is invalid
smsNumberFieldLabel:
type: string
description: Label for field to provide mobile number
smsNumberFormat:
type: string
description: Localized example mobile number format shown for SMS authentication
smsNumberMessage:
type: string
description: Localized instructional text explaining SMS access-code delivery
smsNumberSubmit:
type: string
description: Label for submit button for code generation
smsNumberTitle:
type: string
description: Title for phone number details
smsUsernameFormat:
type: string
description: Localized example username format shown for SMS authentication
sponsorBackLink:
type: string
description: Localized link text for returning to edit the sponsor request form
sponsorCancel:
type: string
description: Localized button label for canceling sponsor authentication
sponsorEmail:
type: string
description: Label for Sponsor Email
sponsorEmailError:
type: string
description: Localized error message shown when the sponsor email address is invalid
sponsorInfoApproved:
type: string
description: Localized status message prefix shown when a sponsor approves the request
sponsorInfoDenied:
type: string
description: Localized status message prefix shown when a sponsor denies the request
sponsorInfoPending:
type: string
description: Localized status message prefix shown after a sponsor notification is sent
sponsorName:
type: string
description: Label for Sponsor Name
sponsorNameError:
type: string
description: Localized error message shown when the sponsor name is missing
sponsorNotePending:
type: string
description: Localized additional status text shown while sponsor approval is pending
sponsorRequestAccess:
type: string
description: Submit button label request Wifi Access and notify sponsor about guest request
sponsorStatusApproved:
type: string
description: Text to display if sponsor approves request
sponsorStatusDenied:
type: string
description: Text to display when sponsor denies request
sponsorStatusPending:
type: string
description: Text to display if request is still pending
sponsorSubmit:
type: string
description: Submit button label to notify sponsor about guest request
sponsorsError:
type: string
description: Localized error message shown when no sponsor is selected
sponsorsFieldLabel:
type: string
description: Localized label for the sponsor selection field
tosAcceptLabel:
type: string
description: Prefix of the label of the link to go to tos
tosError:
type: string
description: Error message when tos not accepted
tosLink:
type: string
description: Label of the link to go to tos
tosText:
type: string
description: Text of the Terms of Service
description: Localized portal template strings for Czech in Czechia
wlan_portal_template_setting_locale3:
title: wlan_portal_template_setting_locale3
type: object
properties:
authButtonAmazon:
type: string
description: Label for Amazon auth button
authButtonAzure:
type: string
description: Label for Azure auth button
authButtonEmail:
type: string
description: Label for Email auth button
authButtonFacebook:
type: string
description: Label for Facebook auth button
authButtonGoogle:
type: string
description: Label for Google auth button
authButtonMicrosoft:
type: string
description: Label for Microsoft auth button
authButtonPassphrase:
type: string
description: Label for passphrase auth button
authButtonSms:
type: string
description: Label for SMS auth button
authButtonSponsor:
type: string
description: Label for Sponsor auth button
authLabel:
type: string
description: Localized heading text displayed above portal authentication options
backLink:
type: string
description: Label of the link to go back to /logon
companyError:
type: string
description: Error message when company not provided
companyLabel:
type: string
description: Localized label displayed for the company input field
emailAccessDomainError:
type: string
description: Error message when a user has valid social login but doesn't match specified email domains.
emailCancel:
type: string
description: Label for cancel confirmation code submission using email auth
emailCodeCancel:
type: string
description: Localized link text for requesting help when the email access code was not received
emailCodeError:
type: string
description: Localized error message shown when the alternate email address for access-code delivery is invalid
emailCodeFieldLabel:
type: string
description: Localized label for the email access-code input field
emailCodeMessage:
type: string
description: Localized instructional text shown before entering the email access code
emailCodeSubmit:
type: string
description: Localized button label for submitting the email access code
emailCodeTitle:
type: string
description: Localized title shown on the email access-code entry page
emailError:
type: string
description: Error message when email not provided
emailFieldLabel:
type: string
description: Localized label for the email address input field
emailLabel:
type: string
description: Localized label displayed for the email input field
emailMessage:
type: string
description: Localized instructional text explaining email access-code delivery
emailSubmit:
type: string
description: Label for confirmation code submit button using email auth
emailTitle:
type: string
description: Title for the Email registration
field1Error:
type: string
description: Error message when field1 not provided
field1Label:
type: string
description: Localized label for custom field 1 input
field2Error:
type: string
description: Error message when field2 not provided
field2Label:
type: string
description: Localized label for custom field 2 input
field3Error:
type: string
description: Error message when field3 not provided
field3Label:
type: string
description: Localized label for custom field 3 input
field4Error:
type: string
description: Error message when field4 not provided
field4Label:
type: string
description: Localized label for custom field 4 input
marketingPolicyLink:
type: string
description: label of the link to go to /marketing_policy
marketingPolicyOptIn:
type: boolean
description: Whether marketing policy optin is enabled
marketingPolicyOptInLabel:
type: string
description: label for marketing optin
marketingPolicyOptInText:
type: string
description: Localized text of the marketing policy opt-in content
message:
type: string
description: Localized main message displayed on the guest portal sign-in page
nameError:
type: string
description: Error message when name not provided
nameLabel:
type: string
description: Localized label displayed for the name input field
optoutLabel:
type: string
description: Label for Do Not Store My Personal Information
pageTitle:
type: string
description: Localized browser or page title shown for the guest portal
passphraseCancel:
type: string
description: Label for the Passphrase cancel button
passphraseError:
type: string
description: Error message when invalid passphrase is provided
passphraseLabel:
type: string
description: Localized label for the passphrase input field
passphraseMessage:
type: string
description: Localized instructional text shown on the passphrase sign-in page
passphraseSubmit:
type: string
description: Label for the Passphrase submit button
passphraseTitle:
type: string
description: Title for passphrase details page
privacyPolicyAcceptLabel:
type: string
description: Prefix of the label of the link to go to Privacy Policy
privacyPolicyError:
type: string
description: Error message when Privacy Policy not accepted
privacyPolicyLink:
type: string
description: Label of the link to go to Privacy Policy
privacyPolicyText:
type: string
description: Text of the Privacy Policy
requiredFieldLabel:
type: string
description: Localized text used to mark a form field as required
signInLabel:
type: string
description: Label of the button to signin
smsCarrierDefault:
type: string
description: Localized default option text shown in the SMS carrier selector
smsCarrierError:
type: string
description: Localized error message shown when no mobile carrier is selected
smsCarrierFieldLabel:
type: string
description: Label for mobile carrier drop-down list
smsCodeCancel:
type: string
description: Label for cancel confirmation code submission
smsCodeError:
type: string
description: Error message when confirmation code is invalid
smsCodeFieldLabel:
type: string
description: Localized label for the SMS confirmation-code input field
smsCodeMessage:
type: string
description: Localized instructional text shown before entering the SMS access code
smsCodeSubmit:
type: string
description: Label for confirmation code submit button
smsCodeTitle:
type: string
description: Localized title shown on the SMS access-code entry page
smsCountryFieldLabel:
type: string
description: Localized label for the SMS country-code input field
smsCountryFormat:
type: string
description: Localized example country code format shown for SMS authentication
smsHaveAccessCode:
type: string
description: Label for checkbox to specify that the user has access code
smsMessageFormat:
type: string
description: Format of access code sms message. {{code}} and {{duration}} are placeholders and should be retained as is.
smsNumberCancel:
type: string
description: Label for canceling mobile details for SMS auth
smsNumberError:
type: string
description: Localized error message shown when the mobile number is invalid
smsNumberFieldLabel:
type: string
description: Label for field to provide mobile number
smsNumberFormat:
type: string
description: Localized example mobile number format shown for SMS authentication
smsNumberMessage:
type: string
description: Localized instructional text explaining SMS access-code delivery
smsNumberSubmit:
type: string
description: Label for submit button for code generation
smsNumberTitle:
type: string
description: Title for phone number details
smsUsernameFormat:
type: string
description: Localized example username format shown for SMS authentication
sponsorBackLink:
type: string
description: Localized link text for returning to edit the sponsor request form
sponsorCancel:
type: string
description: Localized button label for canceling sponsor authentication
sponsorEmail:
type: string
description: Label for Sponsor Email
sponsorEmailError:
type: string
description: Localized error message shown when the sponsor email address is invalid
sponsorInfoApproved:
type: string
description: Localized status message prefix shown when a sponsor approves the request
sponsorInfoDenied:
type: string
description: Localized status message prefix shown when a sponsor denies the request
sponsorInfoPending:
type: string
description: Localized status message prefix shown after a sponsor notification is sent
sponsorName:
type: string
description: Label for Sponsor Name
sponsorNameError:
type: string
description: Localized error message shown when the sponsor name is missing
sponsorNotePending:
type: string
description: Localized additional status text shown while sponsor approval is pending
sponsorRequestAccess:
type: string
description: Submit button label request Wifi Access and notify sponsor about guest request
sponsorStatusApproved:
type: string
description: Text to display if sponsor approves request
sponsorStatusDenied:
type: string
description: Text to display when sponsor denies request
sponsorStatusPending:
type: string
description: Text to display if request is still pending
sponsorSubmit:
type: string
description: Submit button label to notify sponsor about guest request
sponsorsError:
type: string
description: Localized error message shown when no sponsor is selected
sponsorsFieldLabel:
type: string
description: Localized label for the sponsor selection field
tosAcceptLabel:
type: string
description: Prefix of the label of the link to go to tos
tosError:
type: string
description: Error message when tos not accepted
tosLink:
type: string
description: Label of the link to go to tos
tosText:
type: string
description: Text of the Terms of Service
description: Localized portal template strings for Danish in Denmark
wlan_portal_template_setting_locale4:
title: wlan_portal_template_setting_locale4
type: object
properties:
authButtonAmazon:
type: string
description: Label for Amazon auth button
authButtonAzure:
type: string
description: Label for Azure auth button
authButtonEmail:
type: string
description: Label for Email auth button
authButtonFacebook:
type: string
description: Label for Facebook auth button
authButtonGoogle:
type: string
description: Label for Google auth button
authButtonMicrosoft:
type: string
description: Label for Microsoft auth button
authButtonPassphrase:
type: string
description: Label for passphrase auth button
authButtonSms:
type: string
description: Label for SMS auth button
authButtonSponsor:
type: string
description: Label for Sponsor auth button
authLabel:
type: string
description: Localized heading text displayed above portal authentication options
backLink:
type: string
description: Label of the link to go back to /logon
companyError:
type: string
description: Error message when company not provided
companyLabel:
type: string
description: Localized label displayed for the company input field
emailAccessDomainError:
type: string
description: Error message when a user has valid social login but doesn't match specified email domains.
emailCancel:
type: string
description: Label for cancel confirmation code submission using email auth
emailCodeCancel:
type: string
description: Localized link text for requesting help when the email access code was not received
emailCodeError:
type: string
description: Localized error message shown when the alternate email address for access-code delivery is invalid
emailCodeFieldLabel:
type: string
description: Localized label for the email access-code input field
emailCodeMessage:
type: string
description: Localized instructional text shown before entering the email access code
emailCodeSubmit:
type: string
description: Localized button label for submitting the email access code
emailCodeTitle:
type: string
description: Localized title shown on the email access-code entry page
emailError:
type: string
description: Error message when email not provided
emailFieldLabel:
type: string
description: Localized label for the email address input field
emailLabel:
type: string
description: Localized label displayed for the email input field
emailMessage:
type: string
description: Localized instructional text explaining email access-code delivery
emailSubmit:
type: string
description: Label for confirmation code submit button using email auth
emailTitle:
type: string
description: Title for the Email registration
field1Error:
type: string
description: Error message when field1 not provided
field1Label:
type: string
description: Localized label for custom field 1 input
field2Error:
type: string
description: Error message when field2 not provided
field2Label:
type: string
description: Localized label for custom field 2 input
field3Error:
type: string
description: Error message when field3 not provided
field3Label:
type: string
description: Localized label for custom field 3 input
field4Error:
type: string
description: Error message when field4 not provided
field4Label:
type: string
description: Localized label for custom field 4 input
marketingPolicyLink:
type: string
description: label of the link to go to /marketing_policy
marketingPolicyOptIn:
type: boolean
description: Whether marketing policy optin is enabled
marketingPolicyOptInLabel:
type: string
description: label for marketing optin
marketingPolicyOptInText:
type: string
description: Localized text of the marketing policy opt-in content
message:
type: string
description: Localized main message displayed on the guest portal sign-in page
nameError:
type: string
description: Error message when name not provided
nameLabel:
type: string
description: Localized label displayed for the name input field
optoutLabel:
type: string
description: Label for Do Not Store My Personal Information
pageTitle:
type: string
description: Localized browser or page title shown for the guest portal
passphraseCancel:
type: string
description: Label for the Passphrase cancel button
passphraseError:
type: string
description: Error message when invalid passphrase is provided
passphraseLabel:
type: string
description: Localized label for the passphrase input field
passphraseMessage:
type: string
description: Localized instructional text shown on the passphrase sign-in page
passphraseSubmit:
type: string
description: Label for the Passphrase submit button
passphraseTitle:
type: string
description: Title for passphrase details page
privacyPolicyAcceptLabel:
type: string
description: Prefix of the label of the link to go to Privacy Policy
privacyPolicyError:
type: string
description: Error message when Privacy Policy not accepted
privacyPolicyLink:
type: string
description: Label of the link to go to Privacy Policy
privacyPolicyText:
type: string
description: Text of the Privacy Policy
requiredFieldLabel:
type: string
description: Localized text used to mark a form field as required
signInLabel:
type: string
description: Label of the button to signin
smsCarrierDefault:
type: string
description: Localized default option text shown in the SMS carrier selector
smsCarrierError:
type: string
description: Localized error message shown when no mobile carrier is selected
smsCarrierFieldLabel:
type: string
description: Label for mobile carrier drop-down list
smsCodeCancel:
type: string
description: Label for cancel confirmation code submission
smsCodeError:
type: string
description: Error message when confirmation code is invalid
smsCodeFieldLabel:
type: string
description: Localized label for the SMS confirmation-code input field
smsCodeMessage:
type: string
description: Localized instructional text shown before entering the SMS access code
smsCodeSubmit:
type: string
description: Label for confirmation code submit button
smsCodeTitle:
type: string
description: Localized title shown on the SMS access-code entry page
smsCountryFieldLabel:
type: string
description: Localized label for the SMS country-code input field
smsCountryFormat:
type: string
description: Localized example country code format shown for SMS authentication
smsHaveAccessCode:
type: string
description: Label for checkbox to specify that the user has access code
smsMessageFormat:
type: string
description: Format of access code sms message. {{code}} and {{duration}} are placeholders and should be retained as is.
smsNumberCancel:
type: string
description: Label for canceling mobile details for SMS auth
smsNumberError:
type: string
description: Localized error message shown when the mobile number is invalid
smsNumberFieldLabel:
type: string
description: Label for field to provide mobile number
smsNumberFormat:
type: string
description: Localized example mobile number format shown for SMS authentication
smsNumberMessage:
type: string
description: Localized instructional text explaining SMS access-code delivery
smsNumberSubmit:
type: string
description: Label for submit button for code generation
smsNumberTitle:
type: string
description: Title for phone number details
smsUsernameFormat:
type: string
description: Localized example username format shown for SMS authentication
sponsorBackLink:
type: string
description: Localized link text for returning to edit the sponsor request form
sponsorCancel:
type: string
description: Localized button label for canceling sponsor authentication
sponsorEmail:
type: string
description: Label for Sponsor Email
sponsorEmailError:
type: string
description: Localized error message shown when the sponsor email address is invalid
sponsorInfoApproved:
type: string
description: Localized status message prefix shown when a sponsor approves the request
sponsorInfoDenied:
type: string
description: Localized status message prefix shown when a sponsor denies the request
sponsorInfoPending:
type: string
description: Localized status message prefix shown after a sponsor notification is sent
sponsorName:
type: string
description: Label for Sponsor Name
sponsorNameError:
type: string
description: Localized error message shown when the sponsor name is missing
sponsorNotePending:
type: string
description: Localized additional status text shown while sponsor approval is pending
sponsorRequestAccess:
type: string
description: Submit button label request Wifi Access and notify sponsor about guest request
sponsorStatusApproved:
type: string
description: Text to display if sponsor approves request
sponsorStatusDenied:
type: string
description: Text to display when sponsor denies request
sponsorStatusPending:
type: string
description: Text to display if request is still pending
sponsorSubmit:
type: string
description: Submit button label to notify sponsor about guest request
sponsorsError:
type: string
description: Localized error message shown when no sponsor is selected
sponsorsFieldLabel:
type: string
description: Localized label for the sponsor selection field
tosAcceptLabel:
type: string
description: Prefix of the label of the link to go to tos
tosError:
type: string
description: Error message when tos not accepted
tosLink:
type: string
description: Label of the link to go to tos
tosText:
type: string
description: Text of the Terms of Service
description: Localized portal template strings for German in Germany
wlan_portal_template_setting_locale5:
title: wlan_portal_template_setting_locale5
type: object
properties:
authButtonAmazon:
type: string
description: Label for Amazon auth button
authButtonAzure:
type: string
description: Label for Azure auth button
authButtonEmail:
type: string
description: Label for Email auth button
authButtonFacebook:
type: string
description: Label for Facebook auth button
authButtonGoogle:
type: string
description: Label for Google auth button
authButtonMicrosoft:
type: string
description: Label for Microsoft auth button
authButtonPassphrase:
type: string
description: Label for passphrase auth button
authButtonSms:
type: string
description: Label for SMS auth button
authButtonSponsor:
type: string
description: Label for Sponsor auth button
authLabel:
type: string
description: Localized heading text displayed above portal authentication options
backLink:
type: string
description: Label of the link to go back to /logon
companyError:
type: string
description: Error message when company not provided
companyLabel:
type: string
description: Localized label displayed for the company input field
emailAccessDomainError:
type: string
description: Error message when a user has valid social login but doesn't match specified email domains.
emailCancel:
type: string
description: Label for cancel confirmation code submission using email auth
emailCodeCancel:
type: string
description: Localized link text for requesting help when the email access code was not received
emailCodeError:
type: string
description: Localized error message shown when the alternate email address for access-code delivery is invalid
emailCodeFieldLabel:
type: string
description: Localized label for the email access-code input field
emailCodeMessage:
type: string
description: Localized instructional text shown before entering the email access code
emailCodeSubmit:
type: string
description: Localized button label for submitting the email access code
emailCodeTitle:
type: string
description: Localized title shown on the email access-code entry page
emailError:
type: string
description: Error message when email not provided
emailFieldLabel:
type: string
description: Localized label for the email address input field
emailLabel:
type: string
description: Localized label displayed for the email input field
emailMessage:
type: string
description: Localized instructional text explaining email access-code delivery
emailSubmit:
type: string
description: Label for confirmation code submit button using email auth
emailTitle:
type: string
description: Title for the Email registration
field1Error:
type: string
description: Error message when field1 not provided
field1Label:
type: string
description: Localized label for custom field 1 input
field2Error:
type: string
description: Error message when field2 not provided
field2Label:
type: string
description: Localized label for custom field 2 input
field3Error:
type: string
description: Error message when field3 not provided
field3Label:
type: string
description: Localized label for custom field 3 input
field4Error:
type: string
description: Error message when field4 not provided
field4Label:
type: string
description: Localized label for custom field 4 input
marketingPolicyLink:
type: string
description: label of the link to go to /marketing_policy
marketingPolicyOptIn:
type: boolean
description: Whether marketing policy optin is enabled
marketingPolicyOptInLabel:
type: string
description: label for marketing optin
marketingPolicyOptInText:
type: string
description: Localized text of the marketing policy opt-in content
message:
type: string
description: Localized main message displayed on the guest portal sign-in page
nameError:
type: string
description: Error message when name not provided
nameLabel:
type: string
description: Localized label displayed for the name input field
optoutLabel:
type: string
description: Label for Do Not Store My Personal Information
pageTitle:
type: string
description: Localized browser or page title shown for the guest portal
passphraseCancel:
type: string
description: Label for the Passphrase cancel button
passphraseError:
type: string
description: Error message when invalid passphrase is provided
passphraseLabel:
type: string
description: Localized label for the passphrase input field
passphraseMessage:
type: string
description: Localized instructional text shown on the passphrase sign-in page
passphraseSubmit:
type: string
description: Label for the Passphrase submit button
passphraseTitle:
type: string
description: Title for passphrase details page
privacyPolicyAcceptLabel:
type: string
description: Prefix of the label of the link to go to Privacy Policy
privacyPolicyError:
type: string
description: Error message when Privacy Policy not accepted
privacyPolicyLink:
type: string
description: Label of the link to go to Privacy Policy
privacyPolicyText:
type: string
description: Text of the Privacy Policy
requiredFieldLabel:
type: string
description: Localized text used to mark a form field as required
signInLabel:
type: string
description: Label of the button to signin
smsCarrierDefault:
type: string
description: Localized default option text shown in the SMS carrier selector
smsCarrierError:
type: string
description: Localized error message shown when no mobile carrier is selected
smsCarrierFieldLabel:
type: string
description: Label for mobile carrier drop-down list
smsCodeCancel:
type: string
description: Label for cancel confirmation code submission
smsCodeError:
type: string
description: Error message when confirmation code is invalid
smsCodeFieldLabel:
type: string
description: Localized label for the SMS confirmation-code input field
smsCodeMessage:
type: string
description: Localized instructional text shown before entering the SMS access code
smsCodeSubmit:
type: string
description: Label for confirmation code submit button
smsCodeTitle:
type: string
description: Localized title shown on the SMS access-code entry page
smsCountryFieldLabel:
type: string
description: Localized label for the SMS country-code input field
smsCountryFormat:
type: string
description: Localized example country code format shown for SMS authentication
smsHaveAccessCode:
type: string
description: Label for checkbox to specify that the user has access code
smsMessageFormat:
type: string
description: Format of access code sms message. {{code}} and {{duration}} are placeholders and should be retained as is.
smsNumberCancel:
type: string
description: Label for canceling mobile details for SMS auth
smsNumberError:
type: string
description: Localized error message shown when the mobile number is invalid
smsNumberFieldLabel:
type: string
description: Label for field to provide mobile number
smsNumberFormat:
type: string
description: Localized example mobile number format shown for SMS authentication
smsNumberMessage:
type: string
description: Localized instructional text explaining SMS access-code delivery
smsNumberSubmit:
type: string
description: Label for submit button for code generation
smsNumberTitle:
type: string
description: Title for phone number details
smsUsernameFormat:
type: string
description: Localized example username format shown for SMS authentication
sponsorBackLink:
type: string
description: Localized link text for returning to edit the sponsor request form
sponsorCancel:
type: string
description: Localized button label for canceling sponsor authentication
sponsorEmail:
type: string
description: Label for Sponsor Email
sponsorEmailError:
type: string
description: Localized error message shown when the sponsor email address is invalid
sponsorInfoApproved:
type: string
description: Localized status message prefix shown when a sponsor approves the request
sponsorInfoDenied:
type: string
description: Localized status message prefix shown when a sponsor denies the request
sponsorInfoPending:
type: string
description: Localized status message prefix shown after a sponsor notification is sent
sponsorName:
type: string
description: Label for Sponsor Name
sponsorNameError:
type: string
description: Localized error message shown when the sponsor name is missing
sponsorNotePending:
type: string
description: Localized additional status text shown while sponsor approval is pending
sponsorRequestAccess:
type: string
description: Submit button label request Wifi Access and notify sponsor about guest request
sponsorStatusApproved:
type: string
description: Text to display if sponsor approves request
sponsorStatusDenied:
type: string
description: Text to display when sponsor denies request
sponsorStatusPending:
type: string
description: Text to display if request is still pending
sponsorSubmit:
type: string
description: Submit button label to notify sponsor about guest request
sponsorsError:
type: string
description: Localized error message shown when no sponsor is selected
sponsorsFieldLabel:
type: string
description: Localized label for the sponsor selection field
tosAcceptLabel:
type: string
description: Prefix of the label of the link to go to tos
tosError:
type: string
description: Error message when tos not accepted
tosLink:
type: string
description: Label of the link to go to tos
tosText:
type: string
description: Text of the Terms of Service
description: Localized portal template strings for Greek in Greece
wlan_portal_template_setting_locale6:
title: wlan_portal_template_setting_locale6
type: object
properties:
authButtonAmazon:
type: string
description: Label for Amazon auth button
authButtonAzure:
type: string
description: Label for Azure auth button
authButtonEmail:
type: string
description: Label for Email auth button
authButtonFacebook:
type: string
description: Label for Facebook auth button
authButtonGoogle:
type: string
description: Label for Google auth button
authButtonMicrosoft:
type: string
description: Label for Microsoft auth button
authButtonPassphrase:
type: string
description: Label for passphrase auth button
authButtonSms:
type: string
description: Label for SMS auth button
authButtonSponsor:
type: string
description: Label for Sponsor auth button
authLabel:
type: string
description: Localized heading text displayed above portal authentication options
backLink:
type: string
description: Label of the link to go back to /logon
companyError:
type: string
description: Error message when company not provided
companyLabel:
type: string
description: Localized label displayed for the company input field
emailAccessDomainError:
type: string
description: Error message when a user has valid social login but doesn't match specified email domains.
emailCancel:
type: string
description: Label for cancel confirmation code submission using email auth
emailCodeCancel:
type: string
description: Localized link text for requesting help when the email access code was not received
emailCodeError:
type: string
description: Localized error message shown when the alternate email address for access-code delivery is invalid
emailCodeFieldLabel:
type: string
description: Localized label for the email access-code input field
emailCodeMessage:
type: string
description: Localized instructional text shown before entering the email access code
emailCodeSubmit:
type: string
description: Localized button label for submitting the email access code
emailCodeTitle:
type: string
description: Localized title shown on the email access-code entry page
emailError:
type: string
description: Error message when email not provided
emailFieldLabel:
type: string
description: Localized label for the email address input field
emailLabel:
type: string
description: Localized label displayed for the email input field
emailMessage:
type: string
description: Localized instructional text explaining email access-code delivery
emailSubmit:
type: string
description: Label for confirmation code submit button using email auth
emailTitle:
type: string
description: Title for the Email registration
field1Error:
type: string
description: Error message when field1 not provided
field1Label:
type: string
description: Localized label for custom field 1 input
field2Error:
type: string
description: Error message when field2 not provided
field2Label:
type: string
description: Localized label for custom field 2 input
field3Error:
type: string
description: Error message when field3 not provided
field3Label:
type: string
description: Localized label for custom field 3 input
field4Error:
type: string
description: Error message when field4 not provided
field4Label:
type: string
description: Localized label for custom field 4 input
marketingPolicyLink:
type: string
description: label of the link to go to /marketing_policy
marketingPolicyOptIn:
type: boolean
description: Whether marketing policy optin is enabled
marketingPolicyOptInLabel:
type: string
description: label for marketing optin
marketingPolicyOptInText:
type: string
description: Localized text of the marketing policy opt-in content
message:
type: string
description: Localized main message displayed on the guest portal sign-in page
nameError:
type: string
description: Error message when name not provided
nameLabel:
type: string
description: Localized label displayed for the name input field
optoutLabel:
type: string
description: Label for Do Not Store My Personal Information
pageTitle:
type: string
description: Localized browser or page title shown for the guest portal
passphraseCancel:
type: string
description: Label for the Passphrase cancel button
passphraseError:
type: string
description: Error message when invalid passphrase is provided
passphraseLabel:
type: string
description: Localized label for the passphrase input field
passphraseMessage:
type: string
description: Localized instructional text shown on the passphrase sign-in page
passphraseSubmit:
type: string
description: Label for the Passphrase submit button
passphraseTitle:
type: string
description: Title for passphrase details page
privacyPolicyAcceptLabel:
type: string
description: Prefix of the label of the link to go to Privacy Policy
privacyPolicyError:
type: string
description: Error message when Privacy Policy not accepted
privacyPolicyLink:
type: string
description: Label of the link to go to Privacy Policy
privacyPolicyText:
type: string
description: Text of the Privacy Policy
requiredFieldLabel:
type: string
description: Localized text used to mark a form field as required
signInLabel:
type: string
description: Label of the button to signin
smsCarrierDefault:
type: string
description: Localized default option text shown in the SMS carrier selector
smsCarrierError:
type: string
description: Localized error message shown when no mobile carrier is selected
smsCarrierFieldLabel:
type: string
description: Label for mobile carrier drop-down list
smsCodeCancel:
type: string
description: Label for cancel confirmation code submission
smsCodeError:
type: string
description: Error message when confirmation code is invalid
smsCodeFieldLabel:
type: string
description: Localized label for the SMS confirmation-code input field
smsCodeMessage:
type: string
description: Localized instructional text shown before entering the SMS access code
smsCodeSubmit:
type: string
description: Label for confirmation code submit button
smsCodeTitle:
type: string
description: Localized title shown on the SMS access-code entry page
smsCountryFieldLabel:
type: string
description: Localized label for the SMS country-code input field
smsCountryFormat:
type: string
description: Localized example country code format shown for SMS authentication
smsHaveAccessCode:
type: string
description: Label for checkbox to specify that the user has access code
smsMessageFormat:
type: string
description: Format of access code sms message. {{code}} and {{duration}} are placeholders and should be retained as is.
smsNumberCancel:
type: string
description: Label for canceling mobile details for SMS auth
smsNumberError:
type: string
description: Localized error message shown when the mobile number is invalid
smsNumberFieldLabel:
type: string
description: Label for field to provide mobile number
smsNumberFormat:
type: string
description: Localized example mobile number format shown for SMS authentication
smsNumberMessage:
type: string
description: Localized instructional text explaining SMS access-code delivery
smsNumberSubmit:
type: string
description: Label for submit button for code generation
smsNumberTitle:
type: string
description: Title for phone number details
smsUsernameFormat:
type: string
description: Localized example username format shown for SMS authentication
sponsorBackLink:
type: string
description: Localized link text for returning to edit the sponsor request form
sponsorCancel:
type: string
description: Localized button label for canceling sponsor authentication
sponsorEmail:
type: string
description: Label for Sponsor Email
sponsorEmailError:
type: string
description: Localized error message shown when the sponsor email address is invalid
sponsorInfoApproved:
type: string
description: Localized status message prefix shown when a sponsor approves the request
sponsorInfoDenied:
type: string
description: Localized status message prefix shown when a sponsor denies the request
sponsorInfoPending:
type: string
description: Localized status message prefix shown after a sponsor notification is sent
sponsorName:
type: string
description: Label for Sponsor Name
sponsorNameError:
type: string
description: Localized error message shown when the sponsor name is missing
sponsorNotePending:
type: string
description: Localized additional status text shown while sponsor approval is pending
sponsorRequestAccess:
type: string
description: Submit button label request Wifi Access and notify sponsor about guest request
sponsorStatusApproved:
type: string
description: Text to display if sponsor approves request
sponsorStatusDenied:
type: string
description: Text to display when sponsor denies request
sponsorStatusPending:
type: string
description: Text to display if request is still pending
sponsorSubmit:
type: string
description: Submit button label to notify sponsor about guest request
sponsorsError:
type: string
description: Localized error message shown when no sponsor is selected
sponsorsFieldLabel:
type: string
description: Localized label for the sponsor selection field
tosAcceptLabel:
type: string
description: Prefix of the label of the link to go to tos
tosError:
type: string
description: Error message when tos not accepted
tosLink:
type: string
description: Label of the link to go to tos
tosText:
type: string
description: Text of the Terms of Service
description: Localized portal template strings for English in the United Kingdom
wlan_portal_template_setting_locale7:
title: wlan_portal_template_setting_locale7
type: object
properties:
authButtonAmazon:
type: string
description: Label for Amazon auth button
authButtonAzure:
type: string
description: Label for Azure auth button
authButtonEmail:
type: string
description: Label for Email auth button
authButtonFacebook:
type: string
description: Label for Facebook auth button
authButtonGoogle:
type: string
description: Label for Google auth button
authButtonMicrosoft:
type: string
description: Label for Microsoft auth button
authButtonPassphrase:
type: string
description: Label for passphrase auth button
authButtonSms:
type: string
description: Label for SMS auth button
authButtonSponsor:
type: string
description: Label for Sponsor auth button
authLabel:
type: string
description: Localized heading text displayed above portal authentication options
backLink:
type: string
description: Label of the link to go back to /logon
companyError:
type: string
description: Error message when company not provided
companyLabel:
type: string
description: Localized label displayed for the company input field
emailAccessDomainError:
type: string
description: Error message when a user has valid social login but doesn't match specified email domains.
emailCancel:
type: string
description: Label for cancel confirmation code submission using email auth
emailCodeCancel:
type: string
description: Localized link text for requesting help when the email access code was not received
emailCodeError:
type: string
description: Localized error message shown when the alternate email address for access-code delivery is invalid
emailCodeFieldLabel:
type: string
description: Localized label for the email access-code input field
emailCodeMessage:
type: string
description: Localized instructional text shown before entering the email access code
emailCodeSubmit:
type: string
description: Localized button label for submitting the email access code
emailCodeTitle:
type: string
description: Localized title shown on the email access-code entry page
emailError:
type: string
description: Error message when email not provided
emailFieldLabel:
type: string
description: Localized label for the email address input field
emailLabel:
type: string
description: Localized label displayed for the email input field
emailMessage:
type: string
description: Localized instructional text explaining email access-code delivery
emailSubmit:
type: string
description: Label for confirmation code submit button using email auth
emailTitle:
type: string
description: Title for the Email registration
field1Error:
type: string
description: Error message when field1 not provided
field1Label:
type: string
description: Localized label for custom field 1 input
field2Error:
type: string
description: Error message when field2 not provided
field2Label:
type: string
description: Localized label for custom field 2 input
field3Error:
type: string
description: Error message when field3 not provided
field3Label:
type: string
description: Localized label for custom field 3 input
field4Error:
type: string
description: Error message when field4 not provided
field4Label:
type: string
description: Localized label for custom field 4 input
marketingPolicyLink:
type: string
description: label of the link to go to /marketing_policy
marketingPolicyOptIn:
type: boolean
description: Whether marketing policy optin is enabled
marketingPolicyOptInLabel:
type: string
description: label for marketing optin
marketingPolicyOptInText:
type: string
description: Localized text of the marketing policy opt-in content
message:
type: string
description: Localized main message displayed on the guest portal sign-in page
nameError:
type: string
description: Error message when name not provided
nameLabel:
type: string
description: Localized label displayed for the name input field
optoutLabel:
type: string
description: Label for Do Not Store My Personal Information
pageTitle:
type: string
description: Localized browser or page title shown for the guest portal
passphraseCancel:
type: string
description: Label for the Passphrase cancel button
passphraseError:
type: string
description: Error message when invalid passphrase is provided
passphraseLabel:
type: string
description: Localized label for the passphrase input field
passphraseMessage:
type: string
description: Localized instructional text shown on the passphrase sign-in page
passphraseSubmit:
type: string
description: Label for the Passphrase submit button
passphraseTitle:
type: string
description: Title for passphrase details page
privacyPolicyAcceptLabel:
type: string
description: Prefix of the label of the link to go to Privacy Policy
privacyPolicyError:
type: string
description: Error message when Privacy Policy not accepted
privacyPolicyLink:
type: string
description: Label of the link to go to Privacy Policy
privacyPolicyText:
type: string
description: Text of the Privacy Policy
requiredFieldLabel:
type: string
description: Localized text used to mark a form field as required
signInLabel:
type: string
description: Label of the button to signin
smsCarrierDefault:
type: string
description: Localized default option text shown in the SMS carrier selector
smsCarrierError:
type: string
description: Localized error message shown when no mobile carrier is selected
smsCarrierFieldLabel:
type: string
description: Label for mobile carrier drop-down list
smsCodeCancel:
type: string
description: Label for cancel confirmation code submission
smsCodeError:
type: string
description: Error message when confirmation code is invalid
smsCodeFieldLabel:
type: string
description: Localized label for the SMS confirmation-code input field
smsCodeMessage:
type: string
description: Localized instructional text shown before entering the SMS access code
smsCodeSubmit:
type: string
description: Label for confirmation code submit button
smsCodeTitle:
type: string
description: Localized title shown on the SMS access-code entry page
smsCountryFieldLabel:
type: string
description: Localized label for the SMS country-code input field
smsCountryFormat:
type: string
description: Localized example country code format shown for SMS authentication
smsHaveAccessCode:
type: string
description: Label for checkbox to specify that the user has access code
smsMessageFormat:
type: string
description: Format of access code sms message. {{code}} and {{duration}} are placeholders and should be retained as is.
smsNumberCancel:
type: string
description: Label for canceling mobile details for SMS auth
smsNumberError:
type: string
description: Localized error message shown when the mobile number is invalid
smsNumberFieldLabel:
type: string
description: Label for field to provide mobile number
smsNumberFormat:
type: string
description: Localized example mobile number format shown for SMS authentication
smsNumberMessage:
type: string
description: Localized instructional text explaining SMS access-code delivery
smsNumberSubmit:
type: string
description: Label for submit button for code generation
smsNumberTitle:
type: string
description: Title for phone number details
smsUsernameFormat:
type: string
description: Localized example username format shown for SMS authentication
sponsorBackLink:
type: string
description: Localized link text for returning to edit the sponsor request form
sponsorCancel:
type: string
description: Localized button label for canceling sponsor authentication
sponsorEmail:
type: string
description: Label for Sponsor Email
sponsorEmailError:
type: string
description: Localized error message shown when the sponsor email address is invalid
sponsorInfoApproved:
type: string
description: Localized status message prefix shown when a sponsor approves the request
sponsorInfoDenied:
type: string
description: Localized status message prefix shown when a sponsor denies the request
sponsorInfoPending:
type: string
description: Localized status message prefix shown after a sponsor notification is sent
sponsorName:
type: string
description: Label for Sponsor Name
sponsorNameError:
type: string
description: Localized error message shown when the sponsor name is missing
sponsorNotePending:
type: string
description: Localized additional status text shown while sponsor approval is pending
sponsorRequestAccess:
type: string
description: Submit button label request Wifi Access and notify sponsor about guest request
sponsorStatusApproved:
type: string
description: Text to display if sponsor approves request
sponsorStatusDenied:
type: string
description: Text to display when sponsor denies request
sponsorStatusPending:
type: string
description: Text to display if request is still pending
sponsorSubmit:
type: string
description: Submit button label to notify sponsor about guest request
sponsorsError:
type: string
description: Localized error message shown when no sponsor is selected
sponsorsFieldLabel:
type: string
description: Localized label for the sponsor selection field
tosAcceptLabel:
type: string
description: Prefix of the label of the link to go to tos
tosError:
type: string
description: Error message when tos not accepted
tosLink:
type: string
description: Label of the link to go to tos
tosText:
type: string
description: Text of the Terms of Service
description: Localized portal template strings for English in the United States
wlan_portal_template_setting_locale8:
title: wlan_portal_template_setting_locale8
type: object
properties:
authButtonAmazon:
type: string
description: Label for Amazon auth button
authButtonAzure:
type: string
description: Label for Azure auth button
authButtonEmail:
type: string
description: Label for Email auth button
authButtonFacebook:
type: string
description: Label for Facebook auth button
authButtonGoogle:
type: string
description: Label for Google auth button
authButtonMicrosoft:
type: string
description: Label for Microsoft auth button
authButtonPassphrase:
type: string
description: Label for passphrase auth button
authButtonSms:
type: string
description: Label for SMS auth button
authButtonSponsor:
type: string
description: Label for Sponsor auth button
authLabel:
type: string
description: Localized heading text displayed above portal authentication options
backLink:
type: string
description: Label of the link to go back to /logon
companyError:
type: string
description: Error message when company not provided
companyLabel:
type: string
description: Localized label displayed for the company input field
emailAccessDomainError:
type: string
description: Error message when a user has valid social login but doesn't match specified email domains.
emailCancel:
type: string
description: Label for cancel confirmation code submission using email auth
emailCodeCancel:
type: string
description: Localized link text for requesting help when the email access code was not received
emailCodeError:
type: string
description: Localized error message shown when the alternate email address for access-code delivery is invalid
emailCodeFieldLabel:
type: string
description: Localized label for the email access-code input field
emailCodeMessage:
type: string
description: Localized instructional text shown before entering the email access code
emailCodeSubmit:
type: string
description: Localized button label for submitting the email access code
emailCodeTitle:
type: string
description: Localized title shown on the email access-code entry page
emailError:
type: string
description: Error message when email not provided
emailFieldLabel:
type: string
description: Localized label for the email address input field
emailLabel:
type: string
description: Localized label displayed for the email input field
emailMessage:
type: string
description: Localized instructional text explaining email access-code delivery
emailSubmit:
type: string
description: Label for confirmation code submit button using email auth
emailTitle:
type: string
description: Title for the Email registration
field1Error:
type: string
description: Error message when field1 not provided
field1Label:
type: string
description: Localized label for custom field 1 input
field2Error:
type: string
description: Error message when field2 not provided
field2Label:
type: string
description: Localized label for custom field 2 input
field3Error:
type: string
description: Error message when field3 not provided
field3Label:
type: string
description: Localized label for custom field 3 input
field4Error:
type: string
description: Error message when field4 not provided
field4Label:
type: string
description: Localized label for custom field 4 input
marketingPolicyLink:
type: string
description: label of the link to go to /marketing_policy
marketingPolicyOptIn:
type: boolean
description: Whether marketing policy optin is enabled
marketingPolicyOptInLabel:
type: string
description: label for marketing optin
marketingPolicyOptInText:
type: string
description: Localized text of the marketing policy opt-in content
message:
type: string
description: Localized main message displayed on the guest portal sign-in page
nameError:
type: string
description: Error message when name not provided
nameLabel:
type: string
description: Localized label displayed for the name input field
optoutLabel:
type: string
description: Label for Do Not Store My Personal Information
pageTitle:
type: string
description: Localized browser or page title shown for the guest portal
passphraseCancel:
type: string
description: Label for the Passphrase cancel button
passphraseError:
type: string
description: Error message when invalid passphrase is provided
passphraseLabel:
type: string
description: Localized label for the passphrase input field
passphraseMessage:
type: string
description: Localized instructional text shown on the passphrase sign-in page
passphraseSubmit:
type: string
description: Label for the Passphrase submit button
passphraseTitle:
type: string
description: Title for passphrase details page
privacyPolicyAcceptLabel:
type: string
description: Prefix of the label of the link to go to Privacy Policy
privacyPolicyError:
type: string
description: Error message when Privacy Policy not accepted
privacyPolicyLink:
type: string
description: Label of the link to go to Privacy Policy
privacyPolicyText:
type: string
description: Text of the Privacy Policy
requiredFieldLabel:
type: string
description: Localized text used to mark a form field as required
signInLabel:
type: string
description: Label of the button to signin
smsCarrierDefault:
type: string
description: Localized default option text shown in the SMS carrier selector
smsCarrierError:
type: string
description: Localized error message shown when no mobile carrier is selected
smsCarrierFieldLabel:
type: string
description: Label for mobile carrier drop-down list
smsCodeCancel:
type: string
description: Label for cancel confirmation code submission
smsCodeError:
type: string
description: Error message when confirmation code is invalid
smsCodeFieldLabel:
type: string
description: Localized label for the SMS confirmation-code input field
smsCodeMessage:
type: string
description: Localized instructional text shown before entering the SMS access code
smsCodeSubmit:
type: string
description: Label for confirmation code submit button
smsCodeTitle:
type: string
description: Localized title shown on the SMS access-code entry page
smsCountryFieldLabel:
type: string
description: Localized label for the SMS country-code input field
smsCountryFormat:
type: string
description: Localized example country code format shown for SMS authentication
smsHaveAccessCode:
type: string
description: Label for checkbox to specify that the user has access code
smsMessageFormat:
type: string
description: Format of access code sms message. {{code}} and {{duration}} are placeholders and should be retained as is.
smsNumberCancel:
type: string
description: Label for canceling mobile details for SMS auth
smsNumberError:
type: string
description: Localized error message shown when the mobile number is invalid
smsNumberFieldLabel:
type: string
description: Label for field to provide mobile number
smsNumberFormat:
type: string
description: Localized example mobile number format shown for SMS authentication
smsNumberMessage:
type: string
description: Localized instructional text explaining SMS access-code delivery
smsNumberSubmit:
type: string
description: Label for submit button for code generation
smsNumberTitle:
type: string
description: Title for phone number details
smsUsernameFormat:
type: string
description: Localized example username format shown for SMS authentication
sponsorBackLink:
type: string
description: Localized link text for returning to edit the sponsor request form
sponsorCancel:
type: string
description: Localized button label for canceling sponsor authentication
sponsorEmail:
type: string
description: Label for Sponsor Email
sponsorEmailError:
type: string
description: Localized error message shown when the sponsor email address is invalid
sponsorInfoApproved:
type: string
description: Localized status message prefix shown when a sponsor approves the request
sponsorInfoDenied:
type: string
description: Localized status message prefix shown when a sponsor denies the request
sponsorInfoPending:
type: string
description: Localized status message prefix shown after a sponsor notification is sent
sponsorName:
type: string
description: Label for Sponsor Name
sponsorNameError:
type: string
description: Localized error message shown when the sponsor name is missing
sponsorNotePending:
type: string
description: Localized additional status text shown while sponsor approval is pending
sponsorRequestAccess:
type: string
description: Submit button label request Wifi Access and notify sponsor about guest request
sponsorStatusApproved:
type: string
description: Text to display if sponsor approves request
sponsorStatusDenied:
type: string
description: Text to display when sponsor denies request
sponsorStatusPending:
type: string
description: Text to display if request is still pending
sponsorSubmit:
type: string
description: Submit button label to notify sponsor about guest request
sponsorsError:
type: string
description: Localized error message shown when no sponsor is selected
sponsorsFieldLabel:
type: string
description: Localized label for the sponsor selection field
tosAcceptLabel:
type: string
description: Prefix of the label of the link to go to tos
tosError:
type: string
description: Error message when tos not accepted
tosLink:
type: string
description: Label of the link to go to tos
tosText:
type: string
description: Text of the Terms of Service
description: Localized portal template strings for Spanish in Spain
wlan_portal_template_setting_locale9:
title: wlan_portal_template_setting_locale9
type: object
properties:
authButtonAmazon:
type: string
description: Label for Amazon auth button
authButtonAzure:
type: string
description: Label for Azure auth button
authButtonEmail:
type: string
description: Label for Email auth button
authButtonFacebook:
type: string
description: Label for Facebook auth button
authButtonGoogle:
type: string
description: Label for Google auth button
authButtonMicrosoft:
type: string
description: Label for Microsoft auth button
authButtonPassphrase:
type: string
description: Label for passphrase auth button
authButtonSms:
type: string
description: Label for SMS auth button
authButtonSponsor:
type: string
description: Label for Sponsor auth button
authLabel:
type: string
description: Localized heading text displayed above portal authentication options
backLink:
type: string
description: Label of the link to go back to /logon
companyError:
type: string
description: Error message when company not provided
companyLabel:
type: string
description: Localized label displayed for the company input field
emailAccessDomainError:
type: string
description: Error message when a user has valid social login but doesn't match specified email domains.
emailCancel:
type: string
description: Label for cancel confirmation code submission using email auth
emailCodeCancel:
type: string
description: Localized link text for requesting help when the email access code was not received
emailCodeError:
type: string
description: Localized error message shown when the alternate email address for access-code delivery is invalid
emailCodeFieldLabel:
type: string
description: Localized label for the email access-code input field
emailCodeMessage:
type: string
description: Localized instructional text shown before entering the email access code
emailCodeSubmit:
type: string
description: Localized button label for submitting the email access code
emailCodeTitle:
type: string
description: Localized title shown on the email access-code entry page
emailError:
type: string
description: Error message when email not provided
emailFieldLabel:
type: string
description: Localized label for the email address input field
emailLabel:
type: string
description: Localized label displayed for the email input field
emailMessage:
type: string
description: Localized instructional text explaining email access-code delivery
emailSubmit:
type: string
description: Label for confirmation code submit button using email auth
emailTitle:
type: string
description: Title for the Email registration
field1Error:
type: string
description: Error message when field1 not provided
field1Label:
type: string
description: Localized label for custom field 1 input
field2Error:
type: string
description: Error message when field2 not provided
field2Label:
type: string
description: Localized label for custom field 2 input
field3Error:
type: string
description: Error message when field3 not provided
field3Label:
type: string
description: Localized label for custom field 3 input
field4Error:
type: string
description: Error message when field4 not provided
field4Label:
type: string
description: Localized label for custom field 4 input
marketingPolicyLink:
type: string
description: label of the link to go to /marketing_policy
marketingPolicyOptIn:
type: boolean
description: Whether marketing policy optin is enabled
marketingPolicyOptInLabel:
type: string
description: label for marketing optin
marketingPolicyOptInText:
type: string
description: Localized text of the marketing policy opt-in content
message:
type: string
description: Localized main message displayed on the guest portal sign-in page
nameError:
type: string
description: Error message when name not provided
nameLabel:
type: string
description: Localized label displayed for the name input field
optoutLabel:
type: string
description: Label for Do Not Store My Personal Information
pageTitle:
type: string
description: Localized browser or page title shown for the guest portal
passphraseCancel:
type: string
description: Label for the Passphrase cancel button
passphraseError:
type: string
description: Error message when invalid passphrase is provided
passphraseLabel:
type: string
description: Localized label for the passphrase input field
passphraseMessage:
type: string
description: Localized instructional text shown on the passphrase sign-in page
passphraseSubmit:
type: string
description: Label for the Passphrase submit button
passphraseTitle:
type: string
description: Title for passphrase details page
privacyPolicyAcceptLabel:
type: string
description: Prefix of the label of the link to go to Privacy Policy
privacyPolicyError:
type: string
description: Error message when Privacy Policy not accepted
privacyPolicyLink:
type: string
description: Label of the link to go to Privacy Policy
privacyPolicyText:
type: string
description: Text of the Privacy Policy
requiredFieldLabel:
type: string
description: Localized text used to mark a form field as required
signInLabel:
type: string
description: Label of the button to signin
smsCarrierDefault:
type: string
description: Localized default option text shown in the SMS carrier selector
smsCarrierError:
type: string
description: Localized error message shown when no mobile carrier is selected
smsCarrierFieldLabel:
type: string
description: Label for mobile carrier drop-down list
smsCodeCancel:
type: string
description: Label for cancel confirmation code submission
smsCodeError:
type: string
description: Error message when confirmation code is invalid
smsCodeFieldLabel:
type: string
description: Localized label for the SMS confirmation-code input field
smsCodeMessage:
type: string
description: Localized instructional text shown before entering the SMS access code
smsCodeSubmit:
type: string
description: Label for confirmation code submit button
smsCodeTitle:
type: string
description: Localized title shown on the SMS access-code entry page
smsCountryFieldLabel:
type: string
description: Localized label for the SMS country-code input field
smsCountryFormat:
type: string
description: Localized example country code format shown for SMS authentication
smsHaveAccessCode:
type: string
description: Label for checkbox to specify that the user has access code
smsMessageFormat:
type: string
description: Format of access code sms message. {{code}} and {{duration}} are placeholders and should be retained as is.
smsNumberCancel:
type: string
description: Label for canceling mobile details for SMS auth
smsNumberError:
type: string
description: Localized error message shown when the mobile number is invalid
smsNumberFieldLabel:
type: string
description: Label for field to provide mobile number
smsNumberFormat:
type: string
description: Localized example mobile number format shown for SMS authentication
smsNumberMessage:
type: string
description: Localized instructional text explaining SMS access-code delivery
smsNumberSubmit:
type: string
description: Label for submit button for code generation
smsNumberTitle:
type: string
description: Title for phone number details
smsUsernameFormat:
type: string
description: Localized example username format shown for SMS authentication
sponsorBackLink:
type: string
description: Localized link text for returning to edit the sponsor request form
sponsorCancel:
type: string
description: Localized button label for canceling sponsor authentication
sponsorEmail:
type: string
description: Label for Sponsor Email
sponsorEmailError:
type: string
description: Localized error message shown when the sponsor email address is invalid
sponsorInfoApproved:
type: string
description: Localized status message prefix shown when a sponsor approves the request
sponsorInfoDenied:
type: string
description: Localized status message prefix shown when a sponsor denies the request
sponsorInfoPending:
type: string
description: Localized status message prefix shown after a sponsor notification is sent
sponsorName:
type: string
description: Label for Sponsor Name
sponsorNameError:
type: string
description: Localized error message shown when the sponsor name is missing
sponsorNotePending:
type: string
description: Localized additional status text shown while sponsor approval is pending
sponsorRequestAccess:
type: string
description: Submit button label request Wifi Access and notify sponsor about guest request
sponsorStatusApproved:
type: string
description: Text to display if sponsor approves request
sponsorStatusDenied:
type: string
description: Text to display when sponsor denies request
sponsorStatusPending:
type: string
description: Text to display if request is still pending
sponsorSubmit:
type: string
description: Submit button label to notify sponsor about guest request
sponsorsError:
type: string
description: Localized error message shown when no sponsor is selected
sponsorsFieldLabel:
type: string
description: Localized label for the sponsor selection field
tosAcceptLabel:
type: string
description: Prefix of the label of the link to go to tos
tosError:
type: string
description: Error message when tos not accepted
tosLink:
type: string
description: Label of the link to go to tos
tosText:
type: string
description: Text of the Terms of Service
description: Localized portal template strings for Finnish in Finland
wlan_portal_template_setting_locale10:
title: wlan_portal_template_setting_locale10
type: object
properties:
authButtonAmazon:
type: string
description: Label for Amazon auth button
authButtonAzure:
type: string
description: Label for Azure auth button
authButtonEmail:
type: string
description: Label for Email auth button
authButtonFacebook:
type: string
description: Label for Facebook auth button
authButtonGoogle:
type: string
description: Label for Google auth button
authButtonMicrosoft:
type: string
description: Label for Microsoft auth button
authButtonPassphrase:
type: string
description: Label for passphrase auth button
authButtonSms:
type: string
description: Label for SMS auth button
authButtonSponsor:
type: string
description: Label for Sponsor auth button
authLabel:
type: string
description: Localized heading text displayed above portal authentication options
backLink:
type: string
description: Label of the link to go back to /logon
companyError:
type: string
description: Error message when company not provided
companyLabel:
type: string
description: Localized label displayed for the company input field
emailAccessDomainError:
type: string
description: Error message when a user has valid social login but doesn't match specified email domains.
emailCancel:
type: string
description: Label for cancel confirmation code submission using email auth
emailCodeCancel:
type: string
description: Localized link text for requesting help when the email access code was not received
emailCodeError:
type: string
description: Localized error message shown when the alternate email address for access-code delivery is invalid
emailCodeFieldLabel:
type: string
description: Localized label for the email access-code input field
emailCodeMessage:
type: string
description: Localized instructional text shown before entering the email access code
emailCodeSubmit:
type: string
description: Localized button label for submitting the email access code
emailCodeTitle:
type: string
description: Localized title shown on the email access-code entry page
emailError:
type: string
description: Error message when email not provided
emailFieldLabel:
type: string
description: Localized label for the email address input field
emailLabel:
type: string
description: Localized label displayed for the email input field
emailMessage:
type: string
description: Localized instructional text explaining email access-code delivery
emailSubmit:
type: string
description: Label for confirmation code submit button using email auth
emailTitle:
type: string
description: Title for the Email registration
field1Error:
type: string
description: Error message when field1 not provided
field1Label:
type: string
description: Localized label for custom field 1 input
field2Error:
type: string
description: Error message when field2 not provided
field2Label:
type: string
description: Localized label for custom field 2 input
field3Error:
type: string
description: Error message when field3 not provided
field3Label:
type: string
description: Localized label for custom field 3 input
field4Error:
type: string
description: Error message when field4 not provided
field4Label:
type: string
description: Localized label for custom field 4 input
marketingPolicyLink:
type: string
description: label of the link to go to /marketing_policy
marketingPolicyOptIn:
type: boolean
description: Whether marketing policy optin is enabled
marketingPolicyOptInLabel:
type: string
description: label for marketing optin
marketingPolicyOptInText:
type: string
description: Localized text of the marketing policy opt-in content
message:
type: string
description: Localized main message displayed on the guest portal sign-in page
nameError:
type: string
description: Error message when name not provided
nameLabel:
type: string
description: Localized label displayed for the name input field
optoutLabel:
type: string
description: Label for Do Not Store My Personal Information
pageTitle:
type: string
description: Localized browser or page title shown for the guest portal
passphraseCancel:
type: string
description: Label for the Passphrase cancel button
passphraseError:
type: string
description: Error message when invalid passphrase is provided
passphraseLabel:
type: string
description: Localized label for the passphrase input field
passphraseMessage:
type: string
description: Localized instructional text shown on the passphrase sign-in page
passphraseSubmit:
type: string
description: Label for the Passphrase submit button
passphraseTitle:
type: string
description: Title for passphrase details page
privacyPolicyAcceptLabel:
type: string
description: Prefix of the label of the link to go to Privacy Policy
privacyPolicyError:
type: string
description: Error message when Privacy Policy not accepted
privacyPolicyLink:
type: string
description: Label of the link to go to Privacy Policy
privacyPolicyText:
type: string
description: Text of the Privacy Policy
requiredFieldLabel:
type: string
description: Localized text used to mark a form field as required
signInLabel:
type: string
description: Label of the button to signin
smsCarrierDefault:
type: string
description: Localized default option text shown in the SMS carrier selector
smsCarrierError:
type: string
description: Localized error message shown when no mobile carrier is selected
smsCarrierFieldLabel:
type: string
description: Label for mobile carrier drop-down list
smsCodeCancel:
type: string
description: Label for cancel confirmation code submission
smsCodeError:
type: string
description: Error message when confirmation code is invalid
smsCodeFieldLabel:
type: string
description: Localized label for the SMS confirmation-code input field
smsCodeMessage:
type: string
description: Localized instructional text shown before entering the SMS access code
smsCodeSubmit:
type: string
description: Label for confirmation code submit button
smsCodeTitle:
type: string
description: Localized title shown on the SMS access-code entry page
smsCountryFieldLabel:
type: string
description: Localized label for the SMS country-code input field
smsCountryFormat:
type: string
description: Localized example country code format shown for SMS authentication
smsHaveAccessCode:
type: string
description: Label for checkbox to specify that the user has access code
smsMessageFormat:
type: string
description: Format of access code sms message. {{code}} and {{duration}} are placeholders and should be retained as is.
smsNumberCancel:
type: string
description: Label for canceling mobile details for SMS auth
smsNumberError:
type: string
description: Localized error message shown when the mobile number is invalid
smsNumberFieldLabel:
type: string
description: Label for field to provide mobile number
smsNumberFormat:
type: string
description: Localized example mobile number format shown for SMS authentication
smsNumberMessage:
type: string
description: Localized instructional text explaining SMS access-code delivery
smsNumberSubmit:
type: string
description: Label for submit button for code generation
smsNumberTitle:
type: string
description: Title for phone number details
smsUsernameFormat:
type: string
description: Localized example username format shown for SMS authentication
sponsorBackLink:
type: string
description: Localized link text for returning to edit the sponsor request form
sponsorCancel:
type: string
description: Localized button label for canceling sponsor authentication
sponsorEmail:
type: string
description: Label for Sponsor Email
sponsorEmailError:
type: string
description: Localized error message shown when the sponsor email address is invalid
sponsorInfoApproved:
type: string
description: Localized status message prefix shown when a sponsor approves the request
sponsorInfoDenied:
type: string
description: Localized status message prefix shown when a sponsor denies the request
sponsorInfoPending:
type: string
description: Localized status message prefix shown after a sponsor notification is sent
sponsorName:
type: string
description: Label for Sponsor Name
sponsorNameError:
type: string
description: Localized error message shown when the sponsor name is missing
sponsorNotePending:
type: string
description: Localized additional status text shown while sponsor approval is pending
sponsorRequestAccess:
type: string
description: Submit button label request Wifi Access and notify sponsor about guest request
sponsorStatusApproved:
type: string
description: Text to display if sponsor approves request
sponsorStatusDenied:
type: string
description: Text to display when sponsor denies request
sponsorStatusPending:
type: string
description: Text to display if request is still pending
sponsorSubmit:
type: string
description: Submit button label to notify sponsor about guest request
sponsorsError:
type: string
description: Localized error message shown when no sponsor is selected
sponsorsFieldLabel:
type: string
description: Localized label for the sponsor selection field
tosAcceptLabel:
type: string
description: Prefix of the label of the link to go to tos
tosError:
type: string
description: Error message when tos not accepted
tosLink:
type: string
description: Label of the link to go to tos
tosText:
type: string
description: Text of the Terms of Service
description: Localized portal template strings for French in France
wlan_portal_template_setting_locale11:
title: wlan_portal_template_setting_locale11
type: object
properties:
authButtonAmazon:
type: string
description: Label for Amazon auth button
authButtonAzure:
type: string
description: Label for Azure auth button
authButtonEmail:
type: string
description: Label for Email auth button
authButtonFacebook:
type: string
description: Label for Facebook auth button
authButtonGoogle:
type: string
description: Label for Google auth button
authButtonMicrosoft:
type: string
description: Label for Microsoft auth button
authButtonPassphrase:
type: string
description: Label for passphrase auth button
authButtonSms:
type: string
description: Label for SMS auth button
authButtonSponsor:
type: string
description: Label for Sponsor auth button
authLabel:
type: string
description: Localized heading text displayed above portal authentication options
backLink:
type: string
description: Label of the link to go back to /logon
companyError:
type: string
description: Error message when company not provided
companyLabel:
type: string
description: Localized label displayed for the company input field
emailAccessDomainError:
type: string
description: Error message when a user has valid social login but doesn't match specified email domains.
emailCancel:
type: string
description: Label for cancel confirmation code submission using email auth
emailCodeCancel:
type: string
description: Localized link text for requesting help when the email access code was not received
emailCodeError:
type: string
description: Localized error message shown when the alternate email address for access-code delivery is invalid
emailCodeFieldLabel:
type: string
description: Localized label for the email access-code input field
emailCodeMessage:
type: string
description: Localized instructional text shown before entering the email access code
emailCodeSubmit:
type: string
description: Localized button label for submitting the email access code
emailCodeTitle:
type: string
description: Localized title shown on the email access-code entry page
emailError:
type: string
description: Error message when email not provided
emailFieldLabel:
type: string
description: Localized label for the email address input field
emailLabel:
type: string
description: Localized label displayed for the email input field
emailMessage:
type: string
description: Localized instructional text explaining email access-code delivery
emailSubmit:
type: string
description: Label for confirmation code submit button using email auth
emailTitle:
type: string
description: Title for the Email registration
field1Error:
type: string
description: Error message when field1 not provided
field1Label:
type: string
description: Localized label for custom field 1 input
field2Error:
type: string
description: Error message when field2 not provided
field2Label:
type: string
description: Localized label for custom field 2 input
field3Error:
type: string
description: Error message when field3 not provided
field3Label:
type: string
description: Localized label for custom field 3 input
field4Error:
type: string
description: Error message when field4 not provided
field4Label:
type: string
description: Localized label for custom field 4 input
marketingPolicyLink:
type: string
description: label of the link to go to /marketing_policy
marketingPolicyOptIn:
type: boolean
description: Whether marketing policy optin is enabled
marketingPolicyOptInLabel:
type: string
description: label for marketing optin
marketingPolicyOptInText:
type: string
description: Localized text of the marketing policy opt-in content
message:
type: string
description: Localized main message displayed on the guest portal sign-in page
nameError:
type: string
description: Error message when name not provided
nameLabel:
type: string
description: Localized label displayed for the name input field
optoutLabel:
type: string
description: Label for Do Not Store My Personal Information
pageTitle:
type: string
description: Localized browser or page title shown for the guest portal
passphraseCancel:
type: string
description: Label for the Passphrase cancel button
passphraseError:
type: string
description: Error message when invalid passphrase is provided
passphraseLabel:
type: string
description: Localized label for the passphrase input field
passphraseMessage:
type: string
description: Localized instructional text shown on the passphrase sign-in page
passphraseSubmit:
type: string
description: Label for the Passphrase submit button
passphraseTitle:
type: string
description: Title for passphrase details page
privacyPolicyAcceptLabel:
type: string
description: Prefix of the label of the link to go to Privacy Policy
privacyPolicyError:
type: string
description: Error message when Privacy Policy not accepted
privacyPolicyLink:
type: string
description: Label of the link to go to Privacy Policy
privacyPolicyText:
type: string
description: Text of the Privacy Policy
requiredFieldLabel:
type: string
description: Localized text used to mark a form field as required
signInLabel:
type: string
description: Label of the button to signin
smsCarrierDefault:
type: string
description: Localized default option text shown in the SMS carrier selector
smsCarrierError:
type: string
description: Localized error message shown when no mobile carrier is selected
smsCarrierFieldLabel:
type: string
description: Label for mobile carrier drop-down list
smsCodeCancel:
type: string
description: Label for cancel confirmation code submission
smsCodeError:
type: string
description: Error message when confirmation code is invalid
smsCodeFieldLabel:
type: string
description: Localized label for the SMS confirmation-code input field
smsCodeMessage:
type: string
description: Localized instructional text shown before entering the SMS access code
smsCodeSubmit:
type: string
description: Label for confirmation code submit button
smsCodeTitle:
type: string
description: Localized title shown on the SMS access-code entry page
smsCountryFieldLabel:
type: string
description: Localized label for the SMS country-code input field
smsCountryFormat:
type: string
description: Localized example country code format shown for SMS authentication
smsHaveAccessCode:
type: string
description: Label for checkbox to specify that the user has access code
smsMessageFormat:
type: string
description: Format of access code sms message. {{code}} and {{duration}} are placeholders and should be retained as is.
smsNumberCancel:
type: string
description: Label for canceling mobile details for SMS auth
smsNumberError:
type: string
description: Localized error message shown when the mobile number is invalid
smsNumberFieldLabel:
type: string
description: Label for field to provide mobile number
smsNumberFormat:
type: string
description: Localized example mobile number format shown for SMS authentication
smsNumberMessage:
type: string
description: Localized instructional text explaining SMS access-code delivery
smsNumberSubmit:
type: string
description: Label for submit button for code generation
smsNumberTitle:
type: string
description: Title for phone number details
smsUsernameFormat:
type: string
description: Localized example username format shown for SMS authentication
sponsorBackLink:
type: string
description: Localized link text for returning to edit the sponsor request form
sponsorCancel:
type: string
description: Localized button label for canceling sponsor authentication
sponsorEmail:
type: string
description: Label for Sponsor Email
sponsorEmailError:
type: string
description: Localized error message shown when the sponsor email address is invalid
sponsorInfoApproved:
type: string
description: Localized status message prefix shown when a sponsor approves the request
sponsorInfoDenied:
type: string
description: Localized status message prefix shown when a sponsor denies the request
sponsorInfoPending:
type: string
description: Localized status message prefix shown after a sponsor notification is sent
sponsorName:
type: string
description: Label for Sponsor Name
sponsorNameError:
type: string
description: Localized error message shown when the sponsor name is missing
sponsorNotePending:
type: string
description: Localized additional status text shown while sponsor approval is pending
sponsorRequestAccess:
type: string
description: Submit button label request Wifi Access and notify sponsor about guest request
sponsorStatusApproved:
type: string
description: Text to display if sponsor approves request
sponsorStatusDenied:
type: string
description: Text to display when sponsor denies request
sponsorStatusPending:
type: string
description: Text to display if request is still pending
sponsorSubmit:
type: string
description: Submit button label to notify sponsor about guest request
sponsorsError:
type: string
description: Localized error message shown when no sponsor is selected
sponsorsFieldLabel:
type: string
description: Localized label for the sponsor selection field
tosAcceptLabel:
type: string
description: Prefix of the label of the link to go to tos
tosError:
type: string
description: Error message when tos not accepted
tosLink:
type: string
description: Label of the link to go to tos
tosText:
type: string
description: Text of the Terms of Service
description: Localized portal template strings for Hebrew in Israel
wlan_portal_template_setting_locale12:
title: wlan_portal_template_setting_locale12
type: object
properties:
authButtonAmazon:
type: string
description: Label for Amazon auth button
authButtonAzure:
type: string
description: Label for Azure auth button
authButtonEmail:
type: string
description: Label for Email auth button
authButtonFacebook:
type: string
description: Label for Facebook auth button
authButtonGoogle:
type: string
description: Label for Google auth button
authButtonMicrosoft:
type: string
description: Label for Microsoft auth button
authButtonPassphrase:
type: string
description: Label for passphrase auth button
authButtonSms:
type: string
description: Label for SMS auth button
authButtonSponsor:
type: string
description: Label for Sponsor auth button
authLabel:
type: string
description: Localized heading text displayed above portal authentication options
backLink:
type: string
description: Label of the link to go back to /logon
companyError:
type: string
description: Error message when company not provided
companyLabel:
type: string
description: Localized label displayed for the company input field
emailAccessDomainError:
type: string
description: Error message when a user has valid social login but doesn't match specified email domains.
emailCancel:
type: string
description: Label for cancel confirmation code submission using email auth
emailCodeCancel:
type: string
description: Localized link text for requesting help when the email access code was not received
emailCodeError:
type: string
description: Localized error message shown when the alternate email address for access-code delivery is invalid
emailCodeFieldLabel:
type: string
description: Localized label for the email access-code input field
emailCodeMessage:
type: string
description: Localized instructional text shown before entering the email access code
emailCodeSubmit:
type: string
description: Localized button label for submitting the email access code
emailCodeTitle:
type: string
description: Localized title shown on the email access-code entry page
emailError:
type: string
description: Error message when email not provided
emailFieldLabel:
type: string
description: Localized label for the email address input field
emailLabel:
type: string
description: Localized label displayed for the email input field
emailMessage:
type: string
description: Localized instructional text explaining email access-code delivery
emailSubmit:
type: string
description: Label for confirmation code submit button using email auth
emailTitle:
type: string
description: Title for the Email registration
field1Error:
type: string
description: Error message when field1 not provided
field1Label:
type: string
description: Localized label for custom field 1 input
field2Error:
type: string
description: Error message when field2 not provided
field2Label:
type: string
description: Localized label for custom field 2 input
field3Error:
type: string
description: Error message when field3 not provided
field3Label:
type: string
description: Localized label for custom field 3 input
field4Error:
type: string
description: Error message when field4 not provided
field4Label:
type: string
description: Localized label for custom field 4 input
marketingPolicyLink:
type: string
description: label of the link to go to /marketing_policy
marketingPolicyOptIn:
type: boolean
description: Whether marketing policy optin is enabled
marketingPolicyOptInLabel:
type: string
description: label for marketing optin
marketingPolicyOptInText:
type: string
description: Localized text of the marketing policy opt-in content
message:
type: string
description: Localized main message displayed on the guest portal sign-in page
nameError:
type: string
description: Error message when name not provided
nameLabel:
type: string
description: Localized label displayed for the name input field
optoutLabel:
type: string
description: Label for Do Not Store My Personal Information
pageTitle:
type: string
description: Localized browser or page title shown for the guest portal
passphraseCancel:
type: string
description: Label for the Passphrase cancel button
passphraseError:
type: string
description: Error message when invalid passphrase is provided
passphraseLabel:
type: string
description: Localized label for the passphrase input field
passphraseMessage:
type: string
description: Localized instructional text shown on the passphrase sign-in page
passphraseSubmit:
type: string
description: Label for the Passphrase submit button
passphraseTitle:
type: string
description: Title for passphrase details page
privacyPolicyAcceptLabel:
type: string
description: Prefix of the label of the link to go to Privacy Policy
privacyPolicyError:
type: string
description: Error message when Privacy Policy not accepted
privacyPolicyLink:
type: string
description: Label of the link to go to Privacy Policy
privacyPolicyText:
type: string
description: Text of the Privacy Policy
requiredFieldLabel:
type: string
description: Localized text used to mark a form field as required
signInLabel:
type: string
description: Label of the button to signin
smsCarrierDefault:
type: string
description: Localized default option text shown in the SMS carrier selector
smsCarrierError:
type: string
description: Localized error message shown when no mobile carrier is selected
smsCarrierFieldLabel:
type: string
description: Label for mobile carrier drop-down list
smsCodeCancel:
type: string
description: Label for cancel confirmation code submission
smsCodeError:
type: string
description: Error message when confirmation code is invalid
smsCodeFieldLabel:
type: string
description: Localized label for the SMS confirmation-code input field
smsCodeMessage:
type: string
description: Localized instructional text shown before entering the SMS access code
smsCodeSubmit:
type: string
description: Label for confirmation code submit button
smsCodeTitle:
type: string
description: Localized title shown on the SMS access-code entry page
smsCountryFieldLabel:
type: string
description: Localized label for the SMS country-code input field
smsCountryFormat:
type: string
description: Localized example country code format shown for SMS authentication
smsHaveAccessCode:
type: string
description: Label for checkbox to specify that the user has access code
smsMessageFormat:
type: string
description: Format of access code sms message. {{code}} and {{duration}} are placeholders and should be retained as is.
smsNumberCancel:
type: string
description: Label for canceling mobile details for SMS auth
smsNumberError:
type: string
description: Localized error message shown when the mobile number is invalid
smsNumberFieldLabel:
type: string
description: Label for field to provide mobile number
smsNumberFormat:
type: string
description: Localized example mobile number format shown for SMS authentication
smsNumberMessage:
type: string
description: Localized instructional text explaining SMS access-code delivery
smsNumberSubmit:
type: string
description: Label for submit button for code generation
smsNumberTitle:
type: string
description: Title for phone number details
smsUsernameFormat:
type: string
description: Localized example username format shown for SMS authentication
sponsorBackLink:
type: string
description: Localized link text for returning to edit the sponsor request form
sponsorCancel:
type: string
description: Localized button label for canceling sponsor authentication
sponsorEmail:
type: string
description: Label for Sponsor Email
sponsorEmailError:
type: string
description: Localized error message shown when the sponsor email address is invalid
sponsorInfoApproved:
type: string
description: Localized status message prefix shown when a sponsor approves the request
sponsorInfoDenied:
type: string
description: Localized status message prefix shown when a sponsor denies the request
sponsorInfoPending:
type: string
description: Localized status message prefix shown after a sponsor notification is sent
sponsorName:
type: string
description: Label for Sponsor Name
sponsorNameError:
type: string
description: Localized error message shown when the sponsor name is missing
sponsorNotePending:
type: string
description: Localized additional status text shown while sponsor approval is pending
sponsorRequestAccess:
type: string
description: Submit button label request Wifi Access and notify sponsor about guest request
sponsorStatusApproved:
type: string
description: Text to display if sponsor approves request
sponsorStatusDenied:
type: string
description: Text to display when sponsor denies request
sponsorStatusPending:
type: string
description: Text to display if request is still pending
sponsorSubmit:
type: string
description: Submit button label to notify sponsor about guest request
sponsorsError:
type: string
description: Localized error message shown when no sponsor is selected
sponsorsFieldLabel:
type: string
description: Localized label for the sponsor selection field
tosAcceptLabel:
type: string
description: Prefix of the label of the link to go to tos
tosError:
type: string
description: Error message when tos not accepted
tosLink:
type: string
description: Label of the link to go to tos
tosText:
type: string
description: Text of the Terms of Service
description: Localized portal template strings for Hindi in India
wlan_portal_template_setting_locale13:
title: wlan_portal_template_setting_locale13
type: object
properties:
authButtonAmazon:
type: string
description: Label for Amazon auth button
authButtonAzure:
type: string
description: Label for Azure auth button
authButtonEmail:
type: string
description: Label for Email auth button
authButtonFacebook:
type: string
description: Label for Facebook auth button
authButtonGoogle:
type: string
description: Label for Google auth button
authButtonMicrosoft:
type: string
description: Label for Microsoft auth button
authButtonPassphrase:
type: string
description: Label for passphrase auth button
authButtonSms:
type: string
description: Label for SMS auth button
authButtonSponsor:
type: string
description: Label for Sponsor auth button
authLabel:
type: string
description: Localized heading text displayed above portal authentication options
backLink:
type: string
description: Label of the link to go back to /logon
companyError:
type: string
description: Error message when company not provided
companyLabel:
type: string
description: Localized label displayed for the company input field
emailAccessDomainError:
type: string
description: Error message when a user has valid social login but doesn't match specified email domains.
emailCancel:
type: string
description: Label for cancel confirmation code submission using email auth
emailCodeCancel:
type: string
description: Localized link text for requesting help when the email access code was not received
emailCodeError:
type: string
description: Localized error message shown when the alternate email address for access-code delivery is invalid
emailCodeFieldLabel:
type: string
description: Localized label for the email access-code input field
emailCodeMessage:
type: string
description: Localized instructional text shown before entering the email access code
emailCodeSubmit:
type: string
description: Localized button label for submitting the email access code
emailCodeTitle:
type: string
description: Localized title shown on the email access-code entry page
emailError:
type: string
description: Error message when email not provided
emailFieldLabel:
type: string
description: Localized label for the email address input field
emailLabel:
type: string
description: Localized label displayed for the email input field
emailMessage:
type: string
description: Localized instructional text explaining email access-code delivery
emailSubmit:
type: string
description: Label for confirmation code submit button using email auth
emailTitle:
type: string
description: Title for the Email registration
field1Error:
type: string
description: Error message when field1 not provided
field1Label:
type: string
description: Localized label for custom field 1 input
field2Error:
type: string
description: Error message when field2 not provided
field2Label:
type: string
description: Localized label for custom field 2 input
field3Error:
type: string
description: Error message when field3 not provided
field3Label:
type: string
description: Localized label for custom field 3 input
field4Error:
type: string
description: Error message when field4 not provided
field4Label:
type: string
description: Localized label for custom field 4 input
marketingPolicyLink:
type: string
description: label of the link to go to /marketing_policy
marketingPolicyOptIn:
type: boolean
description: Whether marketing policy optin is enabled
marketingPolicyOptInLabel:
type: string
description: label for marketing optin
marketingPolicyOptInText:
type: string
description: Localized text of the marketing policy opt-in content
message:
type: string
description: Localized main message displayed on the guest portal sign-in page
nameError:
type: string
description: Error message when name not provided
nameLabel:
type: string
description: Localized label displayed for the name input field
optoutLabel:
type: string
description: Label for Do Not Store My Personal Information
pageTitle:
type: string
description: Localized browser or page title shown for the guest portal
passphraseCancel:
type: string
description: Label for the Passphrase cancel button
passphraseError:
type: string
description: Error message when invalid passphrase is provided
passphraseLabel:
type: string
description: Localized label for the passphrase input field
passphraseMessage:
type: string
description: Localized instructional text shown on the passphrase sign-in page
passphraseSubmit:
type: string
description: Label for the Passphrase submit button
passphraseTitle:
type: string
description: Title for passphrase details page
privacyPolicyAcceptLabel:
type: string
description: Prefix of the label of the link to go to Privacy Policy
privacyPolicyError:
type: string
description: Error message when Privacy Policy not accepted
privacyPolicyLink:
type: string
description: Label of the link to go to Privacy Policy
privacyPolicyText:
type: string
description: Text of the Privacy Policy
requiredFieldLabel:
type: string
description: Localized text used to mark a form field as required
signInLabel:
type: string
description: Label of the button to signin
smsCarrierDefault:
type: string
description: Localized default option text shown in the SMS carrier selector
smsCarrierError:
type: string
description: Localized error message shown when no mobile carrier is selected
smsCarrierFieldLabel:
type: string
description: Label for mobile carrier drop-down list
smsCodeCancel:
type: string
description: Label for cancel confirmation code submission
smsCodeError:
type: string
description: Error message when confirmation code is invalid
smsCodeFieldLabel:
type: string
description: Localized label for the SMS confirmation-code input field
smsCodeMessage:
type: string
description: Localized instructional text shown before entering the SMS access code
smsCodeSubmit:
type: string
description: Label for confirmation code submit button
smsCodeTitle:
type: string
description: Localized title shown on the SMS access-code entry page
smsCountryFieldLabel:
type: string
description: Localized label for the SMS country-code input field
smsCountryFormat:
type: string
description: Localized example country code format shown for SMS authentication
smsHaveAccessCode:
type: string
description: Label for checkbox to specify that the user has access code
smsMessageFormat:
type: string
description: Format of access code sms message. {{code}} and {{duration}} are placeholders and should be retained as is.
smsNumberCancel:
type: string
description: Label for canceling mobile details for SMS auth
smsNumberError:
type: string
description: Localized error message shown when the mobile number is invalid
smsNumberFieldLabel:
type: string
description: Label for field to provide mobile number
smsNumberFormat:
type: string
description: Localized example mobile number format shown for SMS authentication
smsNumberMessage:
type: string
description: Localized instructional text explaining SMS access-code delivery
smsNumberSubmit:
type: string
description: Label for submit button for code generation
smsNumberTitle:
type: string
description: Title for phone number details
smsUsernameFormat:
type: string
description: Localized example username format shown for SMS authentication
sponsorBackLink:
type: string
description: Localized link text for returning to edit the sponsor request form
sponsorCancel:
type: string
description: Localized button label for canceling sponsor authentication
sponsorEmail:
type: string
description: Label for Sponsor Email
sponsorEmailError:
type: string
description: Localized error message shown when the sponsor email address is invalid
sponsorInfoApproved:
type: string
description: Localized status message prefix shown when a sponsor approves the request
sponsorInfoDenied:
type: string
description: Localized status message prefix shown when a sponsor denies the request
sponsorInfoPending:
type: string
description: Localized status message prefix shown after a sponsor notification is sent
sponsorName:
type: string
description: Label for Sponsor Name
sponsorNameError:
type: string
description: Localized error message shown when the sponsor name is missing
sponsorNotePending:
type: string
description: Localized additional status text shown while sponsor approval is pending
sponsorRequestAccess:
type: string
description: Submit button label request Wifi Access and notify sponsor about guest request
sponsorStatusApproved:
type: string
description: Text to display if sponsor approves request
sponsorStatusDenied:
type: string
description: Text to display when sponsor denies request
sponsorStatusPending:
type: string
description: Text to display if request is still pending
sponsorSubmit:
type: string
description: Submit button label to notify sponsor about guest request
sponsorsError:
type: string
description: Localized error message shown when no sponsor is selected
sponsorsFieldLabel:
type: string
description: Localized label for the sponsor selection field
tosAcceptLabel:
type: string
description: Prefix of the label of the link to go to tos
tosError:
type: string
description: Error message when tos not accepted
tosLink:
type: string
description: Label of the link to go to tos
tosText:
type: string
description: Text of the Terms of Service
description: Localized portal template strings for Croatian in Croatia
wlan_portal_template_setting_locale14:
title: wlan_portal_template_setting_locale14
type: object
properties:
authButtonAmazon:
type: string
description: Label for Amazon auth button
authButtonAzure:
type: string
description: Label for Azure auth button
authButtonEmail:
type: string
description: Label for Email auth button
authButtonFacebook:
type: string
description: Label for Facebook auth button
authButtonGoogle:
type: string
description: Label for Google auth button
authButtonMicrosoft:
type: string
description: Label for Microsoft auth button
authButtonPassphrase:
type: string
description: Label for passphrase auth button
authButtonSms:
type: string
description: Label for SMS auth button
authButtonSponsor:
type: string
description: Label for Sponsor auth button
authLabel:
type: string
description: Localized heading text displayed above portal authentication options
backLink:
type: string
description: Label of the link to go back to /logon
companyError:
type: string
description: Error message when company not provided
companyLabel:
type: string
description: Localized label displayed for the company input field
emailAccessDomainError:
type: string
description: Error message when a user has valid social login but doesn't match specified email domains.
emailCancel:
type: string
description: Label for cancel confirmation code submission using email auth
emailCodeCancel:
type: string
description: Localized link text for requesting help when the email access code was not received
emailCodeError:
type: string
description: Localized error message shown when the alternate email address for access-code delivery is invalid
emailCodeFieldLabel:
type: string
description: Localized label for the email access-code input field
emailCodeMessage:
type: string
description: Localized instructional text shown before entering the email access code
emailCodeSubmit:
type: string
description: Localized button label for submitting the email access code
emailCodeTitle:
type: string
description: Localized title shown on the email access-code entry page
emailError:
type: string
description: Error message when email not provided
emailFieldLabel:
type: string
description: Localized label for the email address input field
emailLabel:
type: string
description: Localized label displayed for the email input field
emailMessage:
type: string
description: Localized instructional text explaining email access-code delivery
emailSubmit:
type: string
description: Label for confirmation code submit button using email auth
emailTitle:
type: string
description: Title for the Email registration
field1Error:
type: string
description: Error message when field1 not provided
field1Label:
type: string
description: Localized label for custom field 1 input
field2Error:
type: string
description: Error message when field2 not provided
field2Label:
type: string
description: Localized label for custom field 2 input
field3Error:
type: string
description: Error message when field3 not provided
field3Label:
type: string
description: Localized label for custom field 3 input
field4Error:
type: string
description: Error message when field4 not provided
field4Label:
type: string
description: Localized label for custom field 4 input
marketingPolicyLink:
type: string
description: label of the link to go to /marketing_policy
marketingPolicyOptIn:
type: boolean
description: Whether marketing policy optin is enabled
marketingPolicyOptInLabel:
type: string
description: label for marketing optin
marketingPolicyOptInText:
type: string
description: Localized text of the marketing policy opt-in content
message:
type: string
description: Localized main message displayed on the guest portal sign-in page
nameError:
type: string
description: Error message when name not provided
nameLabel:
type: string
description: Localized label displayed for the name input field
optoutLabel:
type: string
description: Label for Do Not Store My Personal Information
pageTitle:
type: string
description: Localized browser or page title shown for the guest portal
passphraseCancel:
type: string
description: Label for the Passphrase cancel button
passphraseError:
type: string
description: Error message when invalid passphrase is provided
passphraseLabel:
type: string
description: Localized label for the passphrase input field
passphraseMessage:
type: string
description: Localized instructional text shown on the passphrase sign-in page
passphraseSubmit:
type: string
description: Label for the Passphrase submit button
passphraseTitle:
type: string
description: Title for passphrase details page
privacyPolicyAcceptLabel:
type: string
description: Prefix of the label of the link to go to Privacy Policy
privacyPolicyError:
type: string
description: Error message when Privacy Policy not accepted
privacyPolicyLink:
type: string
description: Label of the link to go to Privacy Policy
privacyPolicyText:
type: string
description: Text of the Privacy Policy
requiredFieldLabel:
type: string
description: Localized text used to mark a form field as required
signInLabel:
type: string
description: Label of the button to signin
smsCarrierDefault:
type: string
description: Localized default option text shown in the SMS carrier selector
smsCarrierError:
type: string
description: Localized error message shown when no mobile carrier is selected
smsCarrierFieldLabel:
type: string
description: Label for mobile carrier drop-down list
smsCodeCancel:
type: string
description: Label for cancel confirmation code submission
smsCodeError:
type: string
description: Error message when confirmation code is invalid
smsCodeFieldLabel:
type: string
description: Localized label for the SMS confirmation-code input field
smsCodeMessage:
type: string
description: Localized instructional text shown before entering the SMS access code
smsCodeSubmit:
type: string
description: Label for confirmation code submit button
smsCodeTitle:
type: string
description: Localized title shown on the SMS access-code entry page
smsCountryFieldLabel:
type: string
description: Localized label for the SMS country-code input field
smsCountryFormat:
type: string
description: Localized example country code format shown for SMS authentication
smsHaveAccessCode:
type: string
description: Label for checkbox to specify that the user has access code
smsMessageFormat:
type: string
description: Format of access code sms message. {{code}} and {{duration}} are placeholders and should be retained as is.
smsNumberCancel:
type: string
description: Label for canceling mobile details for SMS auth
smsNumberError:
type: string
description: Localized error message shown when the mobile number is invalid
smsNumberFieldLabel:
type: string
description: Label for field to provide mobile number
smsNumberFormat:
type: string
description: Localized example mobile number format shown for SMS authentication
smsNumberMessage:
type: string
description: Localized instructional text explaining SMS access-code delivery
smsNumberSubmit:
type: string
description: Label for submit button for code generation
smsNumberTitle:
type: string
description: Title for phone number details
smsUsernameFormat:
type: string
description: Localized example username format shown for SMS authentication
sponsorBackLink:
type: string
description: Localized link text for returning to edit the sponsor request form
sponsorCancel:
type: string
description: Localized button label for canceling sponsor authentication
sponsorEmail:
type: string
description: Label for Sponsor Email
sponsorEmailError:
type: string
description: Localized error message shown when the sponsor email address is invalid
sponsorInfoApproved:
type: string
description: Localized status message prefix shown when a sponsor approves the request
sponsorInfoDenied:
type: string
description: Localized status message prefix shown when a sponsor denies the request
sponsorInfoPending:
type: string
description: Localized status message prefix shown after a sponsor notification is sent
sponsorName:
type: string
description: Label for Sponsor Name
sponsorNameError:
type: string
description: Localized error message shown when the sponsor name is missing
sponsorNotePending:
type: string
description: Localized additional status text shown while sponsor approval is pending
sponsorRequestAccess:
type: string
description: Submit button label request Wifi Access and notify sponsor about guest request
sponsorStatusApproved:
type: string
description: Text to display if sponsor approves request
sponsorStatusDenied:
type: string
description: Text to display when sponsor denies request
sponsorStatusPending:
type: string
description: Text to display if request is still pending
sponsorSubmit:
type: string
description: Submit button label to notify sponsor about guest request
sponsorsError:
type: string
description: Localized error message shown when no sponsor is selected
sponsorsFieldLabel:
type: string
description: Localized label for the sponsor selection field
tosAcceptLabel:
type: string
description: Prefix of the label of the link to go to tos
tosError:
type: string
description: Error message when tos not accepted
tosLink:
type: string
description: Label of the link to go to tos
tosText:
type: string
description: Text of the Terms of Service
description: Localized portal template strings for Hungarian in Hungary
wlan_portal_template_setting_locale15:
title: wlan_portal_template_setting_locale15
type: object
properties:
authButtonAmazon:
type: string
description: Label for Amazon auth button
authButtonAzure:
type: string
description: Label for Azure auth button
authButtonEmail:
type: string
description: Label for Email auth button
authButtonFacebook:
type: string
description: Label for Facebook auth button
authButtonGoogle:
type: string
description: Label for Google auth button
authButtonMicrosoft:
type: string
description: Label for Microsoft auth button
authButtonPassphrase:
type: string
description: Label for passphrase auth button
authButtonSms:
type: string
description: Label for SMS auth button
authButtonSponsor:
type: string
description: Label for Sponsor auth button
authLabel:
type: string
description: Localized heading text displayed above portal authentication options
backLink:
type: string
description: Label of the link to go back to /logon
companyError:
type: string
description: Error message when company not provided
companyLabel:
type: string
description: Localized label displayed for the company input field
emailAccessDomainError:
type: string
description: Error message when a user has valid social login but doesn't match specified email domains.
emailCancel:
type: string
description: Label for cancel confirmation code submission using email auth
emailCodeCancel:
type: string
description: Localized link text for requesting help when the email access code was not received
emailCodeError:
type: string
description: Localized error message shown when the alternate email address for access-code delivery is invalid
emailCodeFieldLabel:
type: string
description: Localized label for the email access-code input field
emailCodeMessage:
type: string
description: Localized instructional text shown before entering the email access code
emailCodeSubmit:
type: string
description: Localized button label for submitting the email access code
emailCodeTitle:
type: string
description: Localized title shown on the email access-code entry page
emailError:
type: string
description: Error message when email not provided
emailFieldLabel:
type: string
description: Localized label for the email address input field
emailLabel:
type: string
description: Localized label displayed for the email input field
emailMessage:
type: string
description: Localized instructional text explaining email access-code delivery
emailSubmit:
type: string
description: Label for confirmation code submit button using email auth
emailTitle:
type: string
description: Title for the Email registration
field1Error:
type: string
description: Error message when field1 not provided
field1Label:
type: string
description: Localized label for custom field 1 input
field2Error:
type: string
description: Error message when field2 not provided
field2Label:
type: string
description: Localized label for custom field 2 input
field3Error:
type: string
description: Error message when field3 not provided
field3Label:
type: string
description: Localized label for custom field 3 input
field4Error:
type: string
description: Error message when field4 not provided
field4Label:
type: string
description: Localized label for custom field 4 input
marketingPolicyLink:
type: string
description: label of the link to go to /marketing_policy
marketingPolicyOptIn:
type: boolean
description: Whether marketing policy optin is enabled
marketingPolicyOptInLabel:
type: string
description: label for marketing optin
marketingPolicyOptInText:
type: string
description: Localized text of the marketing policy opt-in content
message:
type: string
description: Localized main message displayed on the guest portal sign-in page
nameError:
type: string
description: Error message when name not provided
nameLabel:
type: string
description: Localized label displayed for the name input field
optoutLabel:
type: string
description: Label for Do Not Store My Personal Information
pageTitle:
type: string
description: Localized browser or page title shown for the guest portal
passphraseCancel:
type: string
description: Label for the Passphrase cancel button
passphraseError:
type: string
description: Error message when invalid passphrase is provided
passphraseLabel:
type: string
description: Localized label for the passphrase input field
passphraseMessage:
type: string
description: Localized instructional text shown on the passphrase sign-in page
passphraseSubmit:
type: string
description: Label for the Passphrase submit button
passphraseTitle:
type: string
description: Title for passphrase details page
privacyPolicyAcceptLabel:
type: string
description: Prefix of the label of the link to go to Privacy Policy
privacyPolicyError:
type: string
description: Error message when Privacy Policy not accepted
privacyPolicyLink:
type: string
description: Label of the link to go to Privacy Policy
privacyPolicyText:
type: string
description: Text of the Privacy Policy
requiredFieldLabel:
type: string
description: Localized text used to mark a form field as required
signInLabel:
type: string
description: Label of the button to signin
smsCarrierDefault:
type: string
description: Localized default option text shown in the SMS carrier selector
smsCarrierError:
type: string
description: Localized error message shown when no mobile carrier is selected
smsCarrierFieldLabel:
type: string
description: Label for mobile carrier drop-down list
smsCodeCancel:
type: string
description: Label for cancel confirmation code submission
smsCodeError:
type: string
description: Error message when confirmation code is invalid
smsCodeFieldLabel:
type: string
description: Localized label for the SMS confirmation-code input field
smsCodeMessage:
type: string
description: Localized instructional text shown before entering the SMS access code
smsCodeSubmit:
type: string
description: Label for confirmation code submit button
smsCodeTitle:
type: string
description: Localized title shown on the SMS access-code entry page
smsCountryFieldLabel:
type: string
description: Localized label for the SMS country-code input field
smsCountryFormat:
type: string
description: Localized example country code format shown for SMS authentication
smsHaveAccessCode:
type: string
description: Label for checkbox to specify that the user has access code
smsMessageFormat:
type: string
description: Format of access code sms message. {{code}} and {{duration}} are placeholders and should be retained as is.
smsNumberCancel:
type: string
description: Label for canceling mobile details for SMS auth
smsNumberError:
type: string
description: Localized error message shown when the mobile number is invalid
smsNumberFieldLabel:
type: string
description: Label for field to provide mobile number
smsNumberFormat:
type: string
description: Localized example mobile number format shown for SMS authentication
smsNumberMessage:
type: string
description: Localized instructional text explaining SMS access-code delivery
smsNumberSubmit:
type: string
description: Label for submit button for code generation
smsNumberTitle:
type: string
description: Title for phone number details
smsUsernameFormat:
type: string
description: Localized example username format shown for SMS authentication
sponsorBackLink:
type: string
description: Localized link text for returning to edit the sponsor request form
sponsorCancel:
type: string
description: Localized button label for canceling sponsor authentication
sponsorEmail:
type: string
description: Label for Sponsor Email
sponsorEmailError:
type: string
description: Localized error message shown when the sponsor email address is invalid
sponsorInfoApproved:
type: string
description: Localized status message prefix shown when a sponsor approves the request
sponsorInfoDenied:
type: string
description: Localized status message prefix shown when a sponsor denies the request
sponsorInfoPending:
type: string
description: Localized status message prefix shown after a sponsor notification is sent
sponsorName:
type: string
description: Label for Sponsor Name
sponsorNameError:
type: string
description: Localized error message shown when the sponsor name is missing
sponsorNotePending:
type: string
description: Localized additional status text shown while sponsor approval is pending
sponsorRequestAccess:
type: string
description: Submit button label request Wifi Access and notify sponsor about guest request
sponsorStatusApproved:
type: string
description: Text to display if sponsor approves request
sponsorStatusDenied:
type: string
description: Text to display when sponsor denies request
sponsorStatusPending:
type: string
description: Text to display if request is still pending
sponsorSubmit:
type: string
description: Submit button label to notify sponsor about guest request
sponsorsError:
type: string
description: Localized error message shown when no sponsor is selected
sponsorsFieldLabel:
type: string
description: Localized label for the sponsor selection field
tosAcceptLabel:
type: string
description: Prefix of the label of the link to go to tos
tosError:
type: string
description: Error message when tos not accepted
tosLink:
type: string
description: Label of the link to go to tos
tosText:
type: string
description: Text of the Terms of Service
description: Localized portal template strings for Indonesian in Indonesia
wlan_portal_template_setting_locale16:
title: wlan_portal_template_setting_locale16
type: object
properties:
authButtonAmazon:
type: string
description: Label for Amazon auth button
authButtonAzure:
type: string
description: Label for Azure auth button
authButtonEmail:
type: string
description: Label for Email auth button
authButtonFacebook:
type: string
description: Label for Facebook auth button
authButtonGoogle:
type: string
description: Label for Google auth button
authButtonMicrosoft:
type: string
description: Label for Microsoft auth button
authButtonPassphrase:
type: string
description: Label for passphrase auth button
authButtonSms:
type: string
description: Label for SMS auth button
authButtonSponsor:
type: string
description: Label for Sponsor auth button
authLabel:
type: string
description: Localized heading text displayed above portal authentication options
backLink:
type: string
description: Label of the link to go back to /logon
companyError:
type: string
description: Error message when company not provided
companyLabel:
type: string
description: Localized label displayed for the company input field
emailAccessDomainError:
type: string
description: Error message when a user has valid social login but doesn't match specified email domains.
emailCancel:
type: string
description: Label for cancel confirmation code submission using email auth
emailCodeCancel:
type: string
description: Localized link text for requesting help when the email access code was not received
emailCodeError:
type: string
description: Localized error message shown when the alternate email address for access-code delivery is invalid
emailCodeFieldLabel:
type: string
description: Localized label for the email access-code input field
emailCodeMessage:
type: string
description: Localized instructional text shown before entering the email access code
emailCodeSubmit:
type: string
description: Localized button label for submitting the email access code
emailCodeTitle:
type: string
description: Localized title shown on the email access-code entry page
emailError:
type: string
description: Error message when email not provided
emailFieldLabel:
type: string
description: Localized label for the email address input field
emailLabel:
type: string
description: Localized label displayed for the email input field
emailMessage:
type: string
description: Localized instructional text explaining email access-code delivery
emailSubmit:
type: string
description: Label for confirmation code submit button using email auth
emailTitle:
type: string
description: Title for the Email registration
field1Error:
type: string
description: Error message when field1 not provided
field1Label:
type: string
description: Localized label for custom field 1 input
field2Error:
type: string
description: Error message when field2 not provided
field2Label:
type: string
description: Localized label for custom field 2 input
field3Error:
type: string
description: Error message when field3 not provided
field3Label:
type: string
description: Localized label for custom field 3 input
field4Error:
type: string
description: Error message when field4 not provided
field4Label:
type: string
description: Localized label for custom field 4 input
marketingPolicyLink:
type: string
description: label of the link to go to /marketing_policy
marketingPolicyOptIn:
type: boolean
description: Whether marketing policy optin is enabled
marketingPolicyOptInLabel:
type: string
description: label for marketing optin
marketingPolicyOptInText:
type: string
description: Localized text of the marketing policy opt-in content
message:
type: string
description: Localized main message displayed on the guest portal sign-in page
nameError:
type: string
description: Error message when name not provided
nameLabel:
type: string
description: Localized label displayed for the name input field
optoutLabel:
type: string
description: Label for Do Not Store My Personal Information
pageTitle:
type: string
description: Localized browser or page title shown for the guest portal
passphraseCancel:
type: string
description: Label for the Passphrase cancel button
passphraseError:
type: string
description: Error message when invalid passphrase is provided
passphraseLabel:
type: string
description: Localized label for the passphrase input field
passphraseMessage:
type: string
description: Localized instructional text shown on the passphrase sign-in page
passphraseSubmit:
type: string
description: Label for the Passphrase submit button
passphraseTitle:
type: string
description: Title for passphrase details page
privacyPolicyAcceptLabel:
type: string
description: Prefix of the label of the link to go to Privacy Policy
privacyPolicyError:
type: string
description: Error message when Privacy Policy not accepted
privacyPolicyLink:
type: string
description: Label of the link to go to Privacy Policy
privacyPolicyText:
type: string
description: Text of the Privacy Policy
requiredFieldLabel:
type: string
description: Localized text used to mark a form field as required
signInLabel:
type: string
description: Label of the button to signin
smsCarrierDefault:
type: string
description: Localized default option text shown in the SMS carrier selector
smsCarrierError:
type: string
description: Localized error message shown when no mobile carrier is selected
smsCarrierFieldLabel:
type: string
description: Label for mobile carrier drop-down list
smsCodeCancel:
type: string
description: Label for cancel confirmation code submission
smsCodeError:
type: string
description: Error message when confirmation code is invalid
smsCodeFieldLabel:
type: string
description: Localized label for the SMS confirmation-code input field
smsCodeMessage:
type: string
description: Localized instructional text shown before entering the SMS access code
smsCodeSubmit:
type: string
description: Label for confirmation code submit button
smsCodeTitle:
type: string
description: Localized title shown on the SMS access-code entry page
smsCountryFieldLabel:
type: string
description: Localized label for the SMS country-code input field
smsCountryFormat:
type: string
description: Localized example country code format shown for SMS authentication
smsHaveAccessCode:
type: string
description: Label for checkbox to specify that the user has access code
smsMessageFormat:
type: string
description: Format of access code sms message. {{code}} and {{duration}} are placeholders and should be retained as is.
smsNumberCancel:
type: string
description: Label for canceling mobile details for SMS auth
smsNumberError:
type: string
description: Localized error message shown when the mobile number is invalid
smsNumberFieldLabel:
type: string
description: Label for field to provide mobile number
smsNumberFormat:
type: string
description: Localized example mobile number format shown for SMS authentication
smsNumberMessage:
type: string
description: Localized instructional text explaining SMS access-code delivery
smsNumberSubmit:
type: string
description: Label for submit button for code generation
smsNumberTitle:
type: string
description: Title for phone number details
smsUsernameFormat:
type: string
description: Localized example username format shown for SMS authentication
sponsorBackLink:
type: string
description: Localized link text for returning to edit the sponsor request form
sponsorCancel:
type: string
description: Localized button label for canceling sponsor authentication
sponsorEmail:
type: string
description: Label for Sponsor Email
sponsorEmailError:
type: string
description: Localized error message shown when the sponsor email address is invalid
sponsorInfoApproved:
type: string
description: Localized status message prefix shown when a sponsor approves the request
sponsorInfoDenied:
type: string
description: Localized status message prefix shown when a sponsor denies the request
sponsorInfoPending:
type: string
description: Localized status message prefix shown after a sponsor notification is sent
sponsorName:
type: string
description: Label for Sponsor Name
sponsorNameError:
type: string
description: Localized error message shown when the sponsor name is missing
sponsorNotePending:
type: string
description: Localized additional status text shown while sponsor approval is pending
sponsorRequestAccess:
type: string
description: Submit button label request Wifi Access and notify sponsor about guest request
sponsorStatusApproved:
type: string
description: Text to display if sponsor approves request
sponsorStatusDenied:
type: string
description: Text to display when sponsor denies request
sponsorStatusPending:
type: string
description: Text to display if request is still pending
sponsorSubmit:
type: string
description: Submit button label to notify sponsor about guest request
sponsorsError:
type: string
description: Localized error message shown when no sponsor is selected
sponsorsFieldLabel:
type: string
description: Localized label for the sponsor selection field
tosAcceptLabel:
type: string
description: Prefix of the label of the link to go to tos
tosError:
type: string
description: Error message when tos not accepted
tosLink:
type: string
description: Label of the link to go to tos
tosText:
type: string
description: Text of the Terms of Service
description: Localized portal template strings for Italian in Italy
wlan_portal_template_setting_locale17:
title: wlan_portal_template_setting_locale17
type: object
properties:
authButtonAmazon:
type: string
description: Label for Amazon auth button
authButtonAzure:
type: string
description: Label for Azure auth button
authButtonEmail:
type: string
description: Label for Email auth button
authButtonFacebook:
type: string
description: Label for Facebook auth button
authButtonGoogle:
type: string
description: Label for Google auth button
authButtonMicrosoft:
type: string
description: Label for Microsoft auth button
authButtonPassphrase:
type: string
description: Label for passphrase auth button
authButtonSms:
type: string
description: Label for SMS auth button
authButtonSponsor:
type: string
description: Label for Sponsor auth button
authLabel:
type: string
description: Localized heading text displayed above portal authentication options
backLink:
type: string
description: Label of the link to go back to /logon
companyError:
type: string
description: Error message when company not provided
companyLabel:
type: string
description: Localized label displayed for the company input field
emailAccessDomainError:
type: string
description: Error message when a user has valid social login but doesn't match specified email domains.
emailCancel:
type: string
description: Label for cancel confirmation code submission using email auth
emailCodeCancel:
type: string
description: Localized link text for requesting help when the email access code was not received
emailCodeError:
type: string
description: Localized error message shown when the alternate email address for access-code delivery is invalid
emailCodeFieldLabel:
type: string
description: Localized label for the email access-code input field
emailCodeMessage:
type: string
description: Localized instructional text shown before entering the email access code
emailCodeSubmit:
type: string
description: Localized button label for submitting the email access code
emailCodeTitle:
type: string
description: Localized title shown on the email access-code entry page
emailError:
type: string
description: Error message when email not provided
emailFieldLabel:
type: string
description: Localized label for the email address input field
emailLabel:
type: string
description: Localized label displayed for the email input field
emailMessage:
type: string
description: Localized instructional text explaining email access-code delivery
emailSubmit:
type: string
description: Label for confirmation code submit button using email auth
emailTitle:
type: string
description: Title for the Email registration
field1Error:
type: string
description: Error message when field1 not provided
field1Label:
type: string
description: Localized label for custom field 1 input
field2Error:
type: string
description: Error message when field2 not provided
field2Label:
type: string
description: Localized label for custom field 2 input
field3Error:
type: string
description: Error message when field3 not provided
field3Label:
type: string
description: Localized label for custom field 3 input
field4Error:
type: string
description: Error message when field4 not provided
field4Label:
type: string
description: Localized label for custom field 4 input
marketingPolicyLink:
type: string
description: label of the link to go to /marketing_policy
marketingPolicyOptIn:
type: boolean
description: Whether marketing policy optin is enabled
marketingPolicyOptInLabel:
type: string
description: label for marketing optin
marketingPolicyOptInText:
type: string
description: Localized text of the marketing policy opt-in content
message:
type: string
description: Localized main message displayed on the guest portal sign-in page
nameError:
type: string
description: Error message when name not provided
nameLabel:
type: string
description: Localized label displayed for the name input field
optoutLabel:
type: string
description: Label for Do Not Store My Personal Information
pageTitle:
type: string
description: Localized browser or page title shown for the guest portal
passphraseCancel:
type: string
description: Label for the Passphrase cancel button
passphraseError:
type: string
description: Error message when invalid passphrase is provided
passphraseLabel:
type: string
description: Localized label for the passphrase input field
passphraseMessage:
type: string
description: Localized instructional text shown on the passphrase sign-in page
passphraseSubmit:
type: string
description: Label for the Passphrase submit button
passphraseTitle:
type: string
description: Title for passphrase details page
privacyPolicyAcceptLabel:
type: string
description: Prefix of the label of the link to go to Privacy Policy
privacyPolicyError:
type: string
description: Error message when Privacy Policy not accepted
privacyPolicyLink:
type: string
description: Label of the link to go to Privacy Policy
privacyPolicyText:
type: string
description: Text of the Privacy Policy
requiredFieldLabel:
type: string
description: Localized text used to mark a form field as required
signInLabel:
type: string
description: Label of the button to signin
smsCarrierDefault:
type: string
description: Localized default option text shown in the SMS carrier selector
smsCarrierError:
type: string
description: Localized error message shown when no mobile carrier is selected
smsCarrierFieldLabel:
type: string
description: Label for mobile carrier drop-down list
smsCodeCancel:
type: string
description: Label for cancel confirmation code submission
smsCodeError:
type: string
description: Error message when confirmation code is invalid
smsCodeFieldLabel:
type: string
description: Localized label for the SMS confirmation-code input field
smsCodeMessage:
type: string
description: Localized instructional text shown before entering the SMS access code
smsCodeSubmit:
type: string
description: Label for confirmation code submit button
smsCodeTitle:
type: string
description: Localized title shown on the SMS access-code entry page
smsCountryFieldLabel:
type: string
description: Localized label for the SMS country-code input field
smsCountryFormat:
type: string
description: Localized example country code format shown for SMS authentication
smsHaveAccessCode:
type: string
description: Label for checkbox to specify that the user has access code
smsMessageFormat:
type: string
description: Format of access code sms message. {{code}} and {{duration}} are placeholders and should be retained as is.
smsNumberCancel:
type: string
description: Label for canceling mobile details for SMS auth
smsNumberError:
type: string
description: Localized error message shown when the mobile number is invalid
smsNumberFieldLabel:
type: string
description: Label for field to provide mobile number
smsNumberFormat:
type: string
description: Localized example mobile number format shown for SMS authentication
smsNumberMessage:
type: string
description: Localized instructional text explaining SMS access-code delivery
smsNumberSubmit:
type: string
description: Label for submit button for code generation
smsNumberTitle:
type: string
description: Title for phone number details
smsUsernameFormat:
type: string
description: Localized example username format shown for SMS authentication
sponsorBackLink:
type: string
description: Localized link text for returning to edit the sponsor request form
sponsorCancel:
type: string
description: Localized button label for canceling sponsor authentication
sponsorEmail:
type: string
description: Label for Sponsor Email
sponsorEmailError:
type: string
description: Localized error message shown when the sponsor email address is invalid
sponsorInfoApproved:
type: string
description: Localized status message prefix shown when a sponsor approves the request
sponsorInfoDenied:
type: string
description: Localized status message prefix shown when a sponsor denies the request
sponsorInfoPending:
type: string
description: Localized status message prefix shown after a sponsor notification is sent
sponsorName:
type: string
description: Label for Sponsor Name
sponsorNameError:
type: string
description: Localized error message shown when the sponsor name is missing
sponsorNotePending:
type: string
description: Localized additional status text shown while sponsor approval is pending
sponsorRequestAccess:
type: string
description: Submit button label request Wifi Access and notify sponsor about guest request
sponsorStatusApproved:
type: string
description: Text to display if sponsor approves request
sponsorStatusDenied:
type: string
description: Text to display when sponsor denies request
sponsorStatusPending:
type: string
description: Text to display if request is still pending
sponsorSubmit:
type: string
description: Submit button label to notify sponsor about guest request
sponsorsError:
type: string
description: Localized error message shown when no sponsor is selected
sponsorsFieldLabel:
type: string
description: Localized label for the sponsor selection field
tosAcceptLabel:
type: string
description: Prefix of the label of the link to go to tos
tosError:
type: string
description: Error message when tos not accepted
tosLink:
type: string
description: Label of the link to go to tos
tosText:
type: string
description: Text of the Terms of Service
description: Localized portal template strings for Japanese in Japan
wlan_portal_template_setting_locale18:
title: wlan_portal_template_setting_locale18
type: object
properties:
authButtonAmazon:
type: string
description: Label for Amazon auth button
authButtonAzure:
type: string
description: Label for Azure auth button
authButtonEmail:
type: string
description: Label for Email auth button
authButtonFacebook:
type: string
description: Label for Facebook auth button
authButtonGoogle:
type: string
description: Label for Google auth button
authButtonMicrosoft:
type: string
description: Label for Microsoft auth button
authButtonPassphrase:
type: string
description: Label for passphrase auth button
authButtonSms:
type: string
description: Label for SMS auth button
authButtonSponsor:
type: string
description: Label for Sponsor auth button
authLabel:
type: string
description: Localized heading text displayed above portal authentication options
backLink:
type: string
description: Label of the link to go back to /logon
companyError:
type: string
description: Error message when company not provided
companyLabel:
type: string
description: Localized label displayed for the company input field
emailAccessDomainError:
type: string
description: Error message when a user has valid social login but doesn't match specified email domains.
emailCancel:
type: string
description: Label for cancel confirmation code submission using email auth
emailCodeCancel:
type: string
description: Localized link text for requesting help when the email access code was not received
emailCodeError:
type: string
description: Localized error message shown when the alternate email address for access-code delivery is invalid
emailCodeFieldLabel:
type: string
description: Localized label for the email access-code input field
emailCodeMessage:
type: string
description: Localized instructional text shown before entering the email access code
emailCodeSubmit:
type: string
description: Localized button label for submitting the email access code
emailCodeTitle:
type: string
description: Localized title shown on the email access-code entry page
emailError:
type: string
description: Error message when email not provided
emailFieldLabel:
type: string
description: Localized label for the email address input field
emailLabel:
type: string
description: Localized label displayed for the email input field
emailMessage:
type: string
description: Localized instructional text explaining email access-code delivery
emailSubmit:
type: string
description: Label for confirmation code submit button using email auth
emailTitle:
type: string
description: Title for the Email registration
field1Error:
type: string
description: Error message when field1 not provided
field1Label:
type: string
description: Localized label for custom field 1 input
field2Error:
type: string
description: Error message when field2 not provided
field2Label:
type: string
description: Localized label for custom field 2 input
field3Error:
type: string
description: Error message when field3 not provided
field3Label:
type: string
description: Localized label for custom field 3 input
field4Error:
type: string
description: Error message when field4 not provided
field4Label:
type: string
description: Localized label for custom field 4 input
marketingPolicyLink:
type: string
description: label of the link to go to /marketing_policy
marketingPolicyOptIn:
type: boolean
description: Whether marketing policy optin is enabled
marketingPolicyOptInLabel:
type: string
description: label for marketing optin
marketingPolicyOptInText:
type: string
description: Localized text of the marketing policy opt-in content
message:
type: string
description: Localized main message displayed on the guest portal sign-in page
nameError:
type: string
description: Error message when name not provided
nameLabel:
type: string
description: Localized label displayed for the name input field
optoutLabel:
type: string
description: Label for Do Not Store My Personal Information
pageTitle:
type: string
description: Localized browser or page title shown for the guest portal
passphraseCancel:
type: string
description: Label for the Passphrase cancel button
passphraseError:
type: string
description: Error message when invalid passphrase is provided
passphraseLabel:
type: string
description: Localized label for the passphrase input field
passphraseMessage:
type: string
description: Localized instructional text shown on the passphrase sign-in page
passphraseSubmit:
type: string
description: Label for the Passphrase submit button
passphraseTitle:
type: string
description: Title for passphrase details page
privacyPolicyAcceptLabel:
type: string
description: Prefix of the label of the link to go to Privacy Policy
privacyPolicyError:
type: string
description: Error message when Privacy Policy not accepted
privacyPolicyLink:
type: string
description: Label of the link to go to Privacy Policy
privacyPolicyText:
type: string
description: Text of the Privacy Policy
requiredFieldLabel:
type: string
description: Localized text used to mark a form field as required
signInLabel:
type: string
description: Label of the button to signin
smsCarrierDefault:
type: string
description: Localized default option text shown in the SMS carrier selector
smsCarrierError:
type: string
description: Localized error message shown when no mobile carrier is selected
smsCarrierFieldLabel:
type: string
description: Label for mobile carrier drop-down list
smsCodeCancel:
type: string
description: Label for cancel confirmation code submission
smsCodeError:
type: string
description: Error message when confirmation code is invalid
smsCodeFieldLabel:
type: string
description: Localized label for the SMS confirmation-code input field
smsCodeMessage:
type: string
description: Localized instructional text shown before entering the SMS access code
smsCodeSubmit:
type: string
description: Label for confirmation code submit button
smsCodeTitle:
type: string
description: Localized title shown on the SMS access-code entry page
smsCountryFieldLabel:
type: string
description: Localized label for the SMS country-code input field
smsCountryFormat:
type: string
description: Localized example country code format shown for SMS authentication
smsHaveAccessCode:
type: string
description: Label for checkbox to specify that the user has access code
smsMessageFormat:
type: string
description: Format of access code sms message. {{code}} and {{duration}} are placeholders and should be retained as is.
smsNumberCancel:
type: string
description: Label for canceling mobile details for SMS auth
smsNumberError:
type: string
description: Localized error message shown when the mobile number is invalid
smsNumberFieldLabel:
type: string
description: Label for field to provide mobile number
smsNumberFormat:
type: string
description: Localized example mobile number format shown for SMS authentication
smsNumberMessage:
type: string
description: Localized instructional text explaining SMS access-code delivery
smsNumberSubmit:
type: string
description: Label for submit button for code generation
smsNumberTitle:
type: string
description: Title for phone number details
smsUsernameFormat:
type: string
description: Localized example username format shown for SMS authentication
sponsorBackLink:
type: string
description: Localized link text for returning to edit the sponsor request form
sponsorCancel:
type: string
description: Localized button label for canceling sponsor authentication
sponsorEmail:
type: string
description: Label for Sponsor Email
sponsorEmailError:
type: string
description: Localized error message shown when the sponsor email address is invalid
sponsorInfoApproved:
type: string
description: Localized status message prefix shown when a sponsor approves the request
sponsorInfoDenied:
type: string
description: Localized status message prefix shown when a sponsor denies the request
sponsorInfoPending:
type: string
description: Localized status message prefix shown after a sponsor notification is sent
sponsorName:
type: string
description: Label for Sponsor Name
sponsorNameError:
type: string
description: Localized error message shown when the sponsor name is missing
sponsorNotePending:
type: string
description: Localized additional status text shown while sponsor approval is pending
sponsorRequestAccess:
type: string
description: Submit button label request Wifi Access and notify sponsor about guest request
sponsorStatusApproved:
type: string
description: Text to display if sponsor approves request
sponsorStatusDenied:
type: string
description: Text to display when sponsor denies request
sponsorStatusPending:
type: string
description: Text to display if request is still pending
sponsorSubmit:
type: string
description: Submit button label to notify sponsor about guest request
sponsorsError:
type: string
description: Localized error message shown when no sponsor is selected
sponsorsFieldLabel:
type: string
description: Localized label for the sponsor selection field
tosAcceptLabel:
type: string
description: Prefix of the label of the link to go to tos
tosError:
type: string
description: Error message when tos not accepted
tosLink:
type: string
description: Label of the link to go to tos
tosText:
type: string
description: Text of the Terms of Service
description: Localized portal template strings for Korean in Korea
wlan_portal_template_setting_locale19:
title: wlan_portal_template_setting_locale19
type: object
properties:
authButtonAmazon:
type: string
description: Label for Amazon auth button
authButtonAzure:
type: string
description: Label for Azure auth button
authButtonEmail:
type: string
description: Label for Email auth button
authButtonFacebook:
type: string
description: Label for Facebook auth button
authButtonGoogle:
type: string
description: Label for Google auth button
authButtonMicrosoft:
type: string
description: Label for Microsoft auth button
authButtonPassphrase:
type: string
description: Label for passphrase auth button
authButtonSms:
type: string
description: Label for SMS auth button
authButtonSponsor:
type: string
description: Label for Sponsor auth button
authLabel:
type: string
description: Localized heading text displayed above portal authentication options
backLink:
type: string
description: Label of the link to go back to /logon
companyError:
type: string
description: Error message when company not provided
companyLabel:
type: string
description: Localized label displayed for the company input field
emailAccessDomainError:
type: string
description: Error message when a user has valid social login but doesn't match specified email domains.
emailCancel:
type: string
description: Label for cancel confirmation code submission using email auth
emailCodeCancel:
type: string
description: Localized link text for requesting help when the email access code was not received
emailCodeError:
type: string
description: Localized error message shown when the alternate email address for access-code delivery is invalid
emailCodeFieldLabel:
type: string
description: Localized label for the email access-code input field
emailCodeMessage:
type: string
description: Localized instructional text shown before entering the email access code
emailCodeSubmit:
type: string
description: Localized button label for submitting the email access code
emailCodeTitle:
type: string
description: Localized title shown on the email access-code entry page
emailError:
type: string
description: Error message when email not provided
emailFieldLabel:
type: string
description: Localized label for the email address input field
emailLabel:
type: string
description: Localized label displayed for the email input field
emailMessage:
type: string
description: Localized instructional text explaining email access-code delivery
emailSubmit:
type: string
description: Label for confirmation code submit button using email auth
emailTitle:
type: string
description: Title for the Email registration
field1Error:
type: string
description: Error message when field1 not provided
field1Label:
type: string
description: Localized label for custom field 1 input
field2Error:
type: string
description: Error message when field2 not provided
field2Label:
type: string
description: Localized label for custom field 2 input
field3Error:
type: string
description: Error message when field3 not provided
field3Label:
type: string
description: Localized label for custom field 3 input
field4Error:
type: string
description: Error message when field4 not provided
field4Label:
type: string
description: Localized label for custom field 4 input
marketingPolicyLink:
type: string
description: label of the link to go to /marketing_policy
marketingPolicyOptIn:
type: boolean
description: Whether marketing policy optin is enabled
marketingPolicyOptInLabel:
type: string
description: label for marketing optin
marketingPolicyOptInText:
type: string
description: Localized text of the marketing policy opt-in content
message:
type: string
description: Localized main message displayed on the guest portal sign-in page
nameError:
type: string
description: Error message when name not provided
nameLabel:
type: string
description: Localized label displayed for the name input field
optoutLabel:
type: string
description: Label for Do Not Store My Personal Information
pageTitle:
type: string
description: Localized browser or page title shown for the guest portal
passphraseCancel:
type: string
description: Label for the Passphrase cancel button
passphraseError:
type: string
description: Error message when invalid passphrase is provided
passphraseLabel:
type: string
description: Localized label for the passphrase input field
passphraseMessage:
type: string
description: Localized instructional text shown on the passphrase sign-in page
passphraseSubmit:
type: string
description: Label for the Passphrase submit button
passphraseTitle:
type: string
description: Title for passphrase details page
privacyPolicyAcceptLabel:
type: string
description: Prefix of the label of the link to go to Privacy Policy
privacyPolicyError:
type: string
description: Error message when Privacy Policy not accepted
privacyPolicyLink:
type: string
description: Label of the link to go to Privacy Policy
privacyPolicyText:
type: string
description: Text of the Privacy Policy
requiredFieldLabel:
type: string
description: Localized text used to mark a form field as required
signInLabel:
type: string
description: Label of the button to signin
smsCarrierDefault:
type: string
description: Localized default option text shown in the SMS carrier selector
smsCarrierError:
type: string
description: Localized error message shown when no mobile carrier is selected
smsCarrierFieldLabel:
type: string
description: Label for mobile carrier drop-down list
smsCodeCancel:
type: string
description: Label for cancel confirmation code submission
smsCodeError:
type: string
description: Error message when confirmation code is invalid
smsCodeFieldLabel:
type: string
description: Localized label for the SMS confirmation-code input field
smsCodeMessage:
type: string
description: Localized instructional text shown before entering the SMS access code
smsCodeSubmit:
type: string
description: Label for confirmation code submit button
smsCodeTitle:
type: string
description: Localized title shown on the SMS access-code entry page
smsCountryFieldLabel:
type: string
description: Localized label for the SMS country-code input field
smsCountryFormat:
type: string
description: Localized example country code format shown for SMS authentication
smsHaveAccessCode:
type: string
description: Label for checkbox to specify that the user has access code
smsMessageFormat:
type: string
description: Format of access code sms message. {{code}} and {{duration}} are placeholders and should be retained as is.
smsNumberCancel:
type: string
description: Label for canceling mobile details for SMS auth
smsNumberError:
type: string
description: Localized error message shown when the mobile number is invalid
smsNumberFieldLabel:
type: string
description: Label for field to provide mobile number
smsNumberFormat:
type: string
description: Localized example mobile number format shown for SMS authentication
smsNumberMessage:
type: string
description: Localized instructional text explaining SMS access-code delivery
smsNumberSubmit:
type: string
description: Label for submit button for code generation
smsNumberTitle:
type: string
description: Title for phone number details
smsUsernameFormat:
type: string
description: Localized example username format shown for SMS authentication
sponsorBackLink:
type: string
description: Localized link text for returning to edit the sponsor request form
sponsorCancel:
type: string
description: Localized button label for canceling sponsor authentication
sponsorEmail:
type: string
description: Label for Sponsor Email
sponsorEmailError:
type: string
description: Localized error message shown when the sponsor email address is invalid
sponsorInfoApproved:
type: string
description: Localized status message prefix shown when a sponsor approves the request
sponsorInfoDenied:
type: string
description: Localized status message prefix shown when a sponsor denies the request
sponsorInfoPending:
type: string
description: Localized status message prefix shown after a sponsor notification is sent
sponsorName:
type: string
description: Label for Sponsor Name
sponsorNameError:
type: string
description: Localized error message shown when the sponsor name is missing
sponsorNotePending:
type: string
description: Localized additional status text shown while sponsor approval is pending
sponsorRequestAccess:
type: string
description: Submit button label request Wifi Access and notify sponsor about guest request
sponsorStatusApproved:
type: string
description: Text to display if sponsor approves request
sponsorStatusDenied:
type: string
description: Text to display when sponsor denies request
sponsorStatusPending:
type: string
description: Text to display if request is still pending
sponsorSubmit:
type: string
description: Submit button label to notify sponsor about guest request
sponsorsError:
type: string
description: Localized error message shown when no sponsor is selected
sponsorsFieldLabel:
type: string
description: Localized label for the sponsor selection field
tosAcceptLabel:
type: string
description: Prefix of the label of the link to go to tos
tosError:
type: string
description: Error message when tos not accepted
tosLink:
type: string
description: Label of the link to go to tos
tosText:
type: string
description: Text of the Terms of Service
description: Localized portal template strings for Malay in Malaysia
wlan_portal_template_setting_locale20:
title: wlan_portal_template_setting_locale20
type: object
properties:
authButtonAmazon:
type: string
description: Label for Amazon auth button
authButtonAzure:
type: string
description: Label for Azure auth button
authButtonEmail:
type: string
description: Label for Email auth button
authButtonFacebook:
type: string
description: Label for Facebook auth button
authButtonGoogle:
type: string
description: Label for Google auth button
authButtonMicrosoft:
type: string
description: Label for Microsoft auth button
authButtonPassphrase:
type: string
description: Label for passphrase auth button
authButtonSms:
type: string
description: Label for SMS auth button
authButtonSponsor:
type: string
description: Label for Sponsor auth button
authLabel:
type: string
description: Localized heading text displayed above portal authentication options
backLink:
type: string
description: Label of the link to go back to /logon
companyError:
type: string
description: Error message when company not provided
companyLabel:
type: string
description: Localized label displayed for the company input field
emailAccessDomainError:
type: string
description: Error message when a user has valid social login but doesn't match specified email domains.
emailCancel:
type: string
description: Label for cancel confirmation code submission using email auth
emailCodeCancel:
type: string
description: Localized link text for requesting help when the email access code was not received
emailCodeError:
type: string
description: Localized error message shown when the alternate email address for access-code delivery is invalid
emailCodeFieldLabel:
type: string
description: Localized label for the email access-code input field
emailCodeMessage:
type: string
description: Localized instructional text shown before entering the email access code
emailCodeSubmit:
type: string
description: Localized button label for submitting the email access code
emailCodeTitle:
type: string
description: Localized title shown on the email access-code entry page
emailError:
type: string
description: Error message when email not provided
emailFieldLabel:
type: string
description: Localized label for the email address input field
emailLabel:
type: string
description: Localized label displayed for the email input field
emailMessage:
type: string
description: Localized instructional text explaining email access-code delivery
emailSubmit:
type: string
description: Label for confirmation code submit button using email auth
emailTitle:
type: string
description: Title for the Email registration
field1Error:
type: string
description: Error message when field1 not provided
field1Label:
type: string
description: Localized label for custom field 1 input
field2Error:
type: string
description: Error message when field2 not provided
field2Label:
type: string
description: Localized label for custom field 2 input
field3Error:
type: string
description: Error message when field3 not provided
field3Label:
type: string
description: Localized label for custom field 3 input
field4Error:
type: string
description: Error message when field4 not provided
field4Label:
type: string
description: Localized label for custom field 4 input
marketingPolicyLink:
type: string
description: label of the link to go to /marketing_policy
marketingPolicyOptIn:
type: boolean
description: Whether marketing policy optin is enabled
marketingPolicyOptInLabel:
type: string
description: label for marketing optin
marketingPolicyOptInText:
type: string
description: Localized text of the marketing policy opt-in content
message:
type: string
description: Localized main message displayed on the guest portal sign-in page
nameError:
type: string
description: Error message when name not provided
nameLabel:
type: string
description: Localized label displayed for the name input field
optoutLabel:
type: string
description: Label for Do Not Store My Personal Information
pageTitle:
type: string
description: Localized browser or page title shown for the guest portal
passphraseCancel:
type: string
description: Label for the Passphrase cancel button
passphraseError:
type: string
description: Error message when invalid passphrase is provided
passphraseLabel:
type: string
description: Localized label for the passphrase input field
passphraseMessage:
type: string
description: Localized instructional text shown on the passphrase sign-in page
passphraseSubmit:
type: string
description: Label for the Passphrase submit button
passphraseTitle:
type: string
description: Title for passphrase details page
privacyPolicyAcceptLabel:
type: string
description: Prefix of the label of the link to go to Privacy Policy
privacyPolicyError:
type: string
description: Error message when Privacy Policy not accepted
privacyPolicyLink:
type: string
description: Label of the link to go to Privacy Policy
privacyPolicyText:
type: string
description: Text of the Privacy Policy
requiredFieldLabel:
type: string
description: Localized text used to mark a form field as required
signInLabel:
type: string
description: Label of the button to signin
smsCarrierDefault:
type: string
description: Localized default option text shown in the SMS carrier selector
smsCarrierError:
type: string
description: Localized error message shown when no mobile carrier is selected
smsCarrierFieldLabel:
type: string
description: Label for mobile carrier drop-down list
smsCodeCancel:
type: string
description: Label for cancel confirmation code submission
smsCodeError:
type: string
description: Error message when confirmation code is invalid
smsCodeFieldLabel:
type: string
description: Localized label for the SMS confirmation-code input field
smsCodeMessage:
type: string
description: Localized instructional text shown before entering the SMS access code
smsCodeSubmit:
type: string
description: Label for confirmation code submit button
smsCodeTitle:
type: string
description: Localized title shown on the SMS access-code entry page
smsCountryFieldLabel:
type: string
description: Localized label for the SMS country-code input field
smsCountryFormat:
type: string
description: Localized example country code format shown for SMS authentication
smsHaveAccessCode:
type: string
description: Label for checkbox to specify that the user has access code
smsMessageFormat:
type: string
description: Format of access code sms message. {{code}} and {{duration}} are placeholders and should be retained as is.
smsNumberCancel:
type: string
description: Label for canceling mobile details for SMS auth
smsNumberError:
type: string
description: Localized error message shown when the mobile number is invalid
smsNumberFieldLabel:
type: string
description: Label for field to provide mobile number
smsNumberFormat:
type: string
description: Localized example mobile number format shown for SMS authentication
smsNumberMessage:
type: string
description: Localized instructional text explaining SMS access-code delivery
smsNumberSubmit:
type: string
description: Label for submit button for code generation
smsNumberTitle:
type: string
description: Title for phone number details
smsUsernameFormat:
type: string
description: Localized example username format shown for SMS authentication
sponsorBackLink:
type: string
description: Localized link text for returning to edit the sponsor request form
sponsorCancel:
type: string
description: Localized button label for canceling sponsor authentication
sponsorEmail:
type: string
description: Label for Sponsor Email
sponsorEmailError:
type: string
description: Localized error message shown when the sponsor email address is invalid
sponsorInfoApproved:
type: string
description: Localized status message prefix shown when a sponsor approves the request
sponsorInfoDenied:
type: string
description: Localized status message prefix shown when a sponsor denies the request
sponsorInfoPending:
type: string
description: Localized status message prefix shown after a sponsor notification is sent
sponsorName:
type: string
description: Label for Sponsor Name
sponsorNameError:
type: string
description: Localized error message shown when the sponsor name is missing
sponsorNotePending:
type: string
description: Localized additional status text shown while sponsor approval is pending
sponsorRequestAccess:
type: string
description: Submit button label request Wifi Access and notify sponsor about guest request
sponsorStatusApproved:
type: string
description: Text to display if sponsor approves request
sponsorStatusDenied:
type: string
description: Text to display when sponsor denies request
sponsorStatusPending:
type: string
description: Text to display if request is still pending
sponsorSubmit:
type: string
description: Submit button label to notify sponsor about guest request
sponsorsError:
type: string
description: Localized error message shown when no sponsor is selected
sponsorsFieldLabel:
type: string
description: Localized label for the sponsor selection field
tosAcceptLabel:
type: string
description: Prefix of the label of the link to go to tos
tosError:
type: string
description: Error message when tos not accepted
tosLink:
type: string
description: Label of the link to go to tos
tosText:
type: string
description: Text of the Terms of Service
description: Localized portal template strings for Norwegian Bokmal in Norway
wlan_portal_template_setting_locale21:
title: wlan_portal_template_setting_locale21
type: object
properties:
authButtonAmazon:
type: string
description: Label for Amazon auth button
authButtonAzure:
type: string
description: Label for Azure auth button
authButtonEmail:
type: string
description: Label for Email auth button
authButtonFacebook:
type: string
description: Label for Facebook auth button
authButtonGoogle:
type: string
description: Label for Google auth button
authButtonMicrosoft:
type: string
description: Label for Microsoft auth button
authButtonPassphrase:
type: string
description: Label for passphrase auth button
authButtonSms:
type: string
description: Label for SMS auth button
authButtonSponsor:
type: string
description: Label for Sponsor auth button
authLabel:
type: string
description: Localized heading text displayed above portal authentication options
backLink:
type: string
description: Label of the link to go back to /logon
companyError:
type: string
description: Error message when company not provided
companyLabel:
type: string
description: Localized label displayed for the company input field
emailAccessDomainError:
type: string
description: Error message when a user has valid social login but doesn't match specified email domains.
emailCancel:
type: string
description: Label for cancel confirmation code submission using email auth
emailCodeCancel:
type: string
description: Localized link text for requesting help when the email access code was not received
emailCodeError:
type: string
description: Localized error message shown when the alternate email address for access-code delivery is invalid
emailCodeFieldLabel:
type: string
description: Localized label for the email access-code input field
emailCodeMessage:
type: string
description: Localized instructional text shown before entering the email access code
emailCodeSubmit:
type: string
description: Localized button label for submitting the email access code
emailCodeTitle:
type: string
description: Localized title shown on the email access-code entry page
emailError:
type: string
description: Error message when email not provided
emailFieldLabel:
type: string
description: Localized label for the email address input field
emailLabel:
type: string
description: Localized label displayed for the email input field
emailMessage:
type: string
description: Localized instructional text explaining email access-code delivery
emailSubmit:
type: string
description: Label for confirmation code submit button using email auth
emailTitle:
type: string
description: Title for the Email registration
field1Error:
type: string
description: Error message when field1 not provided
field1Label:
type: string
description: Localized label for custom field 1 input
field2Error:
type: string
description: Error message when field2 not provided
field2Label:
type: string
description: Localized label for custom field 2 input
field3Error:
type: string
description: Error message when field3 not provided
field3Label:
type: string
description: Localized label for custom field 3 input
field4Error:
type: string
description: Error message when field4 not provided
field4Label:
type: string
description: Localized label for custom field 4 input
marketingPolicyLink:
type: string
description: label of the link to go to /marketing_policy
marketingPolicyOptIn:
type: boolean
description: Whether marketing policy optin is enabled
marketingPolicyOptInLabel:
type: string
description: label for marketing optin
marketingPolicyOptInText:
type: string
description: Localized text of the marketing policy opt-in content
message:
type: string
description: Localized main message displayed on the guest portal sign-in page
nameError:
type: string
description: Error message when name not provided
nameLabel:
type: string
description: Localized label displayed for the name input field
optoutLabel:
type: string
description: Label for Do Not Store My Personal Information
pageTitle:
type: string
description: Localized browser or page title shown for the guest portal
passphraseCancel:
type: string
description: Label for the Passphrase cancel button
passphraseError:
type: string
description: Error message when invalid passphrase is provided
passphraseLabel:
type: string
description: Localized label for the passphrase input field
passphraseMessage:
type: string
description: Localized instructional text shown on the passphrase sign-in page
passphraseSubmit:
type: string
description: Label for the Passphrase submit button
passphraseTitle:
type: string
description: Title for passphrase details page
privacyPolicyAcceptLabel:
type: string
description: Prefix of the label of the link to go to Privacy Policy
privacyPolicyError:
type: string
description: Error message when Privacy Policy not accepted
privacyPolicyLink:
type: string
description: Label of the link to go to Privacy Policy
privacyPolicyText:
type: string
description: Text of the Privacy Policy
requiredFieldLabel:
type: string
description: Localized text used to mark a form field as required
signInLabel:
type: string
description: Label of the button to signin
smsCarrierDefault:
type: string
description: Localized default option text shown in the SMS carrier selector
smsCarrierError:
type: string
description: Localized error message shown when no mobile carrier is selected
smsCarrierFieldLabel:
type: string
description: Label for mobile carrier drop-down list
smsCodeCancel:
type: string
description: Label for cancel confirmation code submission
smsCodeError:
type: string
description: Error message when confirmation code is invalid
smsCodeFieldLabel:
type: string
description: Localized label for the SMS confirmation-code input field
smsCodeMessage:
type: string
description: Localized instructional text shown before entering the SMS access code
smsCodeSubmit:
type: string
description: Label for confirmation code submit button
smsCodeTitle:
type: string
description: Localized title shown on the SMS access-code entry page
smsCountryFieldLabel:
type: string
description: Localized label for the SMS country-code input field
smsCountryFormat:
type: string
description: Localized example country code format shown for SMS authentication
smsHaveAccessCode:
type: string
description: Label for checkbox to specify that the user has access code
smsMessageFormat:
type: string
description: Format of access code sms message. {{code}} and {{duration}} are placeholders and should be retained as is.
smsNumberCancel:
type: string
description: Label for canceling mobile details for SMS auth
smsNumberError:
type: string
description: Localized error message shown when the mobile number is invalid
smsNumberFieldLabel:
type: string
description: Label for field to provide mobile number
smsNumberFormat:
type: string
description: Localized example mobile number format shown for SMS authentication
smsNumberMessage:
type: string
description: Localized instructional text explaining SMS access-code delivery
smsNumberSubmit:
type: string
description: Label for submit button for code generation
smsNumberTitle:
type: string
description: Title for phone number details
smsUsernameFormat:
type: string
description: Localized example username format shown for SMS authentication
sponsorBackLink:
type: string
description: Localized link text for returning to edit the sponsor request form
sponsorCancel:
type: string
description: Localized button label for canceling sponsor authentication
sponsorEmail:
type: string
description: Label for Sponsor Email
sponsorEmailError:
type: string
description: Localized error message shown when the sponsor email address is invalid
sponsorInfoApproved:
type: string
description: Localized status message prefix shown when a sponsor approves the request
sponsorInfoDenied:
type: string
description: Localized status message prefix shown when a sponsor denies the request
sponsorInfoPending:
type: string
description: Localized status message prefix shown after a sponsor notification is sent
sponsorName:
type: string
description: Label for Sponsor Name
sponsorNameError:
type: string
description: Localized error message shown when the sponsor name is missing
sponsorNotePending:
type: string
description: Localized additional status text shown while sponsor approval is pending
sponsorRequestAccess:
type: string
description: Submit button label request Wifi Access and notify sponsor about guest request
sponsorStatusApproved:
type: string
description: Text to display if sponsor approves request
sponsorStatusDenied:
type: string
description: Text to display when sponsor denies request
sponsorStatusPending:
type: string
description: Text to display if request is still pending
sponsorSubmit:
type: string
description: Submit button label to notify sponsor about guest request
sponsorsError:
type: string
description: Localized error message shown when no sponsor is selected
sponsorsFieldLabel:
type: string
description: Localized label for the sponsor selection field
tosAcceptLabel:
type: string
description: Prefix of the label of the link to go to tos
tosError:
type: string
description: Error message when tos not accepted
tosLink:
type: string
description: Label of the link to go to tos
tosText:
type: string
description: Text of the Terms of Service
description: Localized portal template strings for Dutch in the Netherlands
wlan_portal_template_setting_locale22:
title: wlan_portal_template_setting_locale22
type: object
properties:
authButtonAmazon:
type: string
description: Label for Amazon auth button
authButtonAzure:
type: string
description: Label for Azure auth button
authButtonEmail:
type: string
description: Label for Email auth button
authButtonFacebook:
type: string
description: Label for Facebook auth button
authButtonGoogle:
type: string
description: Label for Google auth button
authButtonMicrosoft:
type: string
description: Label for Microsoft auth button
authButtonPassphrase:
type: string
description: Label for passphrase auth button
authButtonSms:
type: string
description: Label for SMS auth button
authButtonSponsor:
type: string
description: Label for Sponsor auth button
authLabel:
type: string
description: Localized heading text displayed above portal authentication options
backLink:
type: string
description: Label of the link to go back to /logon
companyError:
type: string
description: Error message when company not provided
companyLabel:
type: string
description: Localized label displayed for the company input field
emailAccessDomainError:
type: string
description: Error message when a user has valid social login but doesn't match specified email domains.
emailCancel:
type: string
description: Label for cancel confirmation code submission using email auth
emailCodeCancel:
type: string
description: Localized link text for requesting help when the email access code was not received
emailCodeError:
type: string
description: Localized error message shown when the alternate email address for access-code delivery is invalid
emailCodeFieldLabel:
type: string
description: Localized label for the email access-code input field
emailCodeMessage:
type: string
description: Localized instructional text shown before entering the email access code
emailCodeSubmit:
type: string
description: Localized button label for submitting the email access code
emailCodeTitle:
type: string
description: Localized title shown on the email access-code entry page
emailError:
type: string
description: Error message when email not provided
emailFieldLabel:
type: string
description: Localized label for the email address input field
emailLabel:
type: string
description: Localized label displayed for the email input field
emailMessage:
type: string
description: Localized instructional text explaining email access-code delivery
emailSubmit:
type: string
description: Label for confirmation code submit button using email auth
emailTitle:
type: string
description: Title for the Email registration
field1Error:
type: string
description: Error message when field1 not provided
field1Label:
type: string
description: Localized label for custom field 1 input
field2Error:
type: string
description: Error message when field2 not provided
field2Label:
type: string
description: Localized label for custom field 2 input
field3Error:
type: string
description: Error message when field3 not provided
field3Label:
type: string
description: Localized label for custom field 3 input
field4Error:
type: string
description: Error message when field4 not provided
field4Label:
type: string
description: Localized label for custom field 4 input
marketingPolicyLink:
type: string
description: label of the link to go to /marketing_policy
marketingPolicyOptIn:
type: boolean
description: Whether marketing policy optin is enabled
marketingPolicyOptInLabel:
type: string
description: label for marketing optin
marketingPolicyOptInText:
type: string
description: Localized text of the marketing policy opt-in content
message:
type: string
description: Localized main message displayed on the guest portal sign-in page
nameError:
type: string
description: Error message when name not provided
nameLabel:
type: string
description: Localized label displayed for the name input field
optoutLabel:
type: string
description: Label for Do Not Store My Personal Information
pageTitle:
type: string
description: Localized browser or page title shown for the guest portal
passphraseCancel:
type: string
description: Label for the Passphrase cancel button
passphraseError:
type: string
description: Error message when invalid passphrase is provided
passphraseLabel:
type: string
description: Localized label for the passphrase input field
passphraseMessage:
type: string
description: Localized instructional text shown on the passphrase sign-in page
passphraseSubmit:
type: string
description: Label for the Passphrase submit button
passphraseTitle:
type: string
description: Title for passphrase details page
privacyPolicyAcceptLabel:
type: string
description: Prefix of the label of the link to go to Privacy Policy
privacyPolicyError:
type: string
description: Error message when Privacy Policy not accepted
privacyPolicyLink:
type: string
description: Label of the link to go to Privacy Policy
privacyPolicyText:
type: string
description: Text of the Privacy Policy
requiredFieldLabel:
type: string
description: Localized text used to mark a form field as required
signInLabel:
type: string
description: Label of the button to signin
smsCarrierDefault:
type: string
description: Localized default option text shown in the SMS carrier selector
smsCarrierError:
type: string
description: Localized error message shown when no mobile carrier is selected
smsCarrierFieldLabel:
type: string
description: Label for mobile carrier drop-down list
smsCodeCancel:
type: string
description: Label for cancel confirmation code submission
smsCodeError:
type: string
description: Error message when confirmation code is invalid
smsCodeFieldLabel:
type: string
description: Localized label for the SMS confirmation-code input field
smsCodeMessage:
type: string
description: Localized instructional text shown before entering the SMS access code
smsCodeSubmit:
type: string
description: Label for confirmation code submit button
smsCodeTitle:
type: string
description: Localized title shown on the SMS access-code entry page
smsCountryFieldLabel:
type: string
description: Localized label for the SMS country-code input field
smsCountryFormat:
type: string
description: Localized example country code format shown for SMS authentication
smsHaveAccessCode:
type: string
description: Label for checkbox to specify that the user has access code
smsMessageFormat:
type: string
description: Format of access code sms message. {{code}} and {{duration}} are placeholders and should be retained as is.
smsNumberCancel:
type: string
description: Label for canceling mobile details for SMS auth
smsNumberError:
type: string
description: Localized error message shown when the mobile number is invalid
smsNumberFieldLabel:
type: string
description: Label for field to provide mobile number
smsNumberFormat:
type: string
description: Localized example mobile number format shown for SMS authentication
smsNumberMessage:
type: string
description: Localized instructional text explaining SMS access-code delivery
smsNumberSubmit:
type: string
description: Label for submit button for code generation
smsNumberTitle:
type: string
description: Title for phone number details
smsUsernameFormat:
type: string
description: Localized example username format shown for SMS authentication
sponsorBackLink:
type: string
description: Localized link text for returning to edit the sponsor request form
sponsorCancel:
type: string
description: Localized button label for canceling sponsor authentication
sponsorEmail:
type: string
description: Label for Sponsor Email
sponsorEmailError:
type: string
description: Localized error message shown when the sponsor email address is invalid
sponsorInfoApproved:
type: string
description: Localized status message prefix shown when a sponsor approves the request
sponsorInfoDenied:
type: string
description: Localized status message prefix shown when a sponsor denies the request
sponsorInfoPending:
type: string
description: Localized status message prefix shown after a sponsor notification is sent
sponsorName:
type: string
description: Label for Sponsor Name
sponsorNameError:
type: string
description: Localized error message shown when the sponsor name is missing
sponsorNotePending:
type: string
description: Localized additional status text shown while sponsor approval is pending
sponsorRequestAccess:
type: string
description: Submit button label request Wifi Access and notify sponsor about guest request
sponsorStatusApproved:
type: string
description: Text to display if sponsor approves request
sponsorStatusDenied:
type: string
description: Text to display when sponsor denies request
sponsorStatusPending:
type: string
description: Text to display if request is still pending
sponsorSubmit:
type: string
description: Submit button label to notify sponsor about guest request
sponsorsError:
type: string
description: Localized error message shown when no sponsor is selected
sponsorsFieldLabel:
type: string
description: Localized label for the sponsor selection field
tosAcceptLabel:
type: string
description: Prefix of the label of the link to go to tos
tosError:
type: string
description: Error message when tos not accepted
tosLink:
type: string
description: Label of the link to go to tos
tosText:
type: string
description: Text of the Terms of Service
description: Localized portal template strings for Polish in Poland
wlan_portal_template_setting_locale23:
title: wlan_portal_template_setting_locale23
type: object
properties:
authButtonAmazon:
type: string
description: Label for Amazon auth button
authButtonAzure:
type: string
description: Label for Azure auth button
authButtonEmail:
type: string
description: Label for Email auth button
authButtonFacebook:
type: string
description: Label for Facebook auth button
authButtonGoogle:
type: string
description: Label for Google auth button
authButtonMicrosoft:
type: string
description: Label for Microsoft auth button
authButtonPassphrase:
type: string
description: Label for passphrase auth button
authButtonSms:
type: string
description: Label for SMS auth button
authButtonSponsor:
type: string
description: Label for Sponsor auth button
authLabel:
type: string
description: Localized heading text displayed above portal authentication options
backLink:
type: string
description: Label of the link to go back to /logon
companyError:
type: string
description: Error message when company not provided
companyLabel:
type: string
description: Localized label displayed for the company input field
emailAccessDomainError:
type: string
description: Error message when a user has valid social login but doesn't match specified email domains.
emailCancel:
type: string
description: Label for cancel confirmation code submission using email auth
emailCodeCancel:
type: string
description: Localized link text for requesting help when the email access code was not received
emailCodeError:
type: string
description: Localized error message shown when the alternate email address for access-code delivery is invalid
emailCodeFieldLabel:
type: string
description: Localized label for the email access-code input field
emailCodeMessage:
type: string
description: Localized instructional text shown before entering the email access code
emailCodeSubmit:
type: string
description: Localized button label for submitting the email access code
emailCodeTitle:
type: string
description: Localized title shown on the email access-code entry page
emailError:
type: string
description: Error message when email not provided
emailFieldLabel:
type: string
description: Localized label for the email address input field
emailLabel:
type: string
description: Localized label displayed for the email input field
emailMessage:
type: string
description: Localized instructional text explaining email access-code delivery
emailSubmit:
type: string
description: Label for confirmation code submit button using email auth
emailTitle:
type: string
description: Title for the Email registration
field1Error:
type: string
description: Error message when field1 not provided
field1Label:
type: string
description: Localized label for custom field 1 input
field2Error:
type: string
description: Error message when field2 not provided
field2Label:
type: string
description: Localized label for custom field 2 input
field3Error:
type: string
description: Error message when field3 not provided
field3Label:
type: string
description: Localized label for custom field 3 input
field4Error:
type: string
description: Error message when field4 not provided
field4Label:
type: string
description: Localized label for custom field 4 input
marketingPolicyLink:
type: string
description: label of the link to go to /marketing_policy
marketingPolicyOptIn:
type: boolean
description: Whether marketing policy optin is enabled
marketingPolicyOptInLabel:
type: string
description: label for marketing optin
marketingPolicyOptInText:
type: string
description: Localized text of the marketing policy opt-in content
message:
type: string
description: Localized main message displayed on the guest portal sign-in page
nameError:
type: string
description: Error message when name not provided
nameLabel:
type: string
description: Localized label displayed for the name input field
optoutLabel:
type: string
description: Label for Do Not Store My Personal Information
pageTitle:
type: string
description: Localized browser or page title shown for the guest portal
passphraseCancel:
type: string
description: Label for the Passphrase cancel button
passphraseError:
type: string
description: Error message when invalid passphrase is provided
passphraseLabel:
type: string
description: Localized label for the passphrase input field
passphraseMessage:
type: string
description: Localized instructional text shown on the passphrase sign-in page
passphraseSubmit:
type: string
description: Label for the Passphrase submit button
passphraseTitle:
type: string
description: Title for passphrase details page
privacyPolicyAcceptLabel:
type: string
description: Prefix of the label of the link to go to Privacy Policy
privacyPolicyError:
type: string
description: Error message when Privacy Policy not accepted
privacyPolicyLink:
type: string
description: Label of the link to go to Privacy Policy
privacyPolicyText:
type: string
description: Text of the Privacy Policy
requiredFieldLabel:
type: string
description: Localized text used to mark a form field as required
signInLabel:
type: string
description: Label of the button to signin
smsCarrierDefault:
type: string
description: Localized default option text shown in the SMS carrier selector
smsCarrierError:
type: string
description: Localized error message shown when no mobile carrier is selected
smsCarrierFieldLabel:
type: string
description: Label for mobile carrier drop-down list
smsCodeCancel:
type: string
description: Label for cancel confirmation code submission
smsCodeError:
type: string
description: Error message when confirmation code is invalid
smsCodeFieldLabel:
type: string
description: Localized label for the SMS confirmation-code input field
smsCodeMessage:
type: string
description: Localized instructional text shown before entering the SMS access code
smsCodeSubmit:
type: string
description: Label for confirmation code submit button
smsCodeTitle:
type: string
description: Localized title shown on the SMS access-code entry page
smsCountryFieldLabel:
type: string
description: Localized label for the SMS country-code input field
smsCountryFormat:
type: string
description: Localized example country code format shown for SMS authentication
smsHaveAccessCode:
type: string
description: Label for checkbox to specify that the user has access code
smsMessageFormat:
type: string
description: Format of access code sms message. {{code}} and {{duration}} are placeholders and should be retained as is.
smsNumberCancel:
type: string
description: Label for canceling mobile details for SMS auth
smsNumberError:
type: string
description: Localized error message shown when the mobile number is invalid
smsNumberFieldLabel:
type: string
description: Label for field to provide mobile number
smsNumberFormat:
type: string
description: Localized example mobile number format shown for SMS authentication
smsNumberMessage:
type: string
description: Localized instructional text explaining SMS access-code delivery
smsNumberSubmit:
type: string
description: Label for submit button for code generation
smsNumberTitle:
type: string
description: Title for phone number details
smsUsernameFormat:
type: string
description: Localized example username format shown for SMS authentication
sponsorBackLink:
type: string
description: Localized link text for returning to edit the sponsor request form
sponsorCancel:
type: string
description: Localized button label for canceling sponsor authentication
sponsorEmail:
type: string
description: Label for Sponsor Email
sponsorEmailError:
type: string
description: Localized error message shown when the sponsor email address is invalid
sponsorInfoApproved:
type: string
description: Localized status message prefix shown when a sponsor approves the request
sponsorInfoDenied:
type: string
description: Localized status message prefix shown when a sponsor denies the request
sponsorInfoPending:
type: string
description: Localized status message prefix shown after a sponsor notification is sent
sponsorName:
type: string
description: Label for Sponsor Name
sponsorNameError:
type: string
description: Localized error message shown when the sponsor name is missing
sponsorNotePending:
type: string
description: Localized additional status text shown while sponsor approval is pending
sponsorRequestAccess:
type: string
description: Submit button label request Wifi Access and notify sponsor about guest request
sponsorStatusApproved:
type: string
description: Text to display if sponsor approves request
sponsorStatusDenied:
type: string
description: Text to display when sponsor denies request
sponsorStatusPending:
type: string
description: Text to display if request is still pending
sponsorSubmit:
type: string
description: Submit button label to notify sponsor about guest request
sponsorsError:
type: string
description: Localized error message shown when no sponsor is selected
sponsorsFieldLabel:
type: string
description: Localized label for the sponsor selection field
tosAcceptLabel:
type: string
description: Prefix of the label of the link to go to tos
tosError:
type: string
description: Error message when tos not accepted
tosLink:
type: string
description: Label of the link to go to tos
tosText:
type: string
description: Text of the Terms of Service
description: Localized portal template strings for Portuguese in Brazil
wlan_portal_template_setting_locale24:
title: wlan_portal_template_setting_locale24
type: object
properties:
authButtonAmazon:
type: string
description: Label for Amazon auth button
authButtonAzure:
type: string
description: Label for Azure auth button
authButtonEmail:
type: string
description: Label for Email auth button
authButtonFacebook:
type: string
description: Label for Facebook auth button
authButtonGoogle:
type: string
description: Label for Google auth button
authButtonMicrosoft:
type: string
description: Label for Microsoft auth button
authButtonPassphrase:
type: string
description: Label for passphrase auth button
authButtonSms:
type: string
description: Label for SMS auth button
authButtonSponsor:
type: string
description: Label for Sponsor auth button
authLabel:
type: string
description: Localized heading text displayed above portal authentication options
backLink:
type: string
description: Label of the link to go back to /logon
companyError:
type: string
description: Error message when company not provided
companyLabel:
type: string
description: Localized label displayed for the company input field
emailAccessDomainError:
type: string
description: Error message when a user has valid social login but doesn't match specified email domains.
emailCancel:
type: string
description: Label for cancel confirmation code submission using email auth
emailCodeCancel:
type: string
description: Localized link text for requesting help when the email access code was not received
emailCodeError:
type: string
description: Localized error message shown when the alternate email address for access-code delivery is invalid
emailCodeFieldLabel:
type: string
description: Localized label for the email access-code input field
emailCodeMessage:
type: string
description: Localized instructional text shown before entering the email access code
emailCodeSubmit:
type: string
description: Localized button label for submitting the email access code
emailCodeTitle:
type: string
description: Localized title shown on the email access-code entry page
emailError:
type: string
description: Error message when email not provided
emailFieldLabel:
type: string
description: Localized label for the email address input field
emailLabel:
type: string
description: Localized label displayed for the email input field
emailMessage:
type: string
description: Localized instructional text explaining email access-code delivery
emailSubmit:
type: string
description: Label for confirmation code submit button using email auth
emailTitle:
type: string
description: Title for the Email registration
field1Error:
type: string
description: Error message when field1 not provided
field1Label:
type: string
description: Localized label for custom field 1 input
field2Error:
type: string
description: Error message when field2 not provided
field2Label:
type: string
description: Localized label for custom field 2 input
field3Error:
type: string
description: Error message when field3 not provided
field3Label:
type: string
description: Localized label for custom field 3 input
field4Error:
type: string
description: Error message when field4 not provided
field4Label:
type: string
description: Localized label for custom field 4 input
marketingPolicyLink:
type: string
description: label of the link to go to /marketing_policy
marketingPolicyOptIn:
type: boolean
description: Whether marketing policy optin is enabled
marketingPolicyOptInLabel:
type: string
description: label for marketing optin
marketingPolicyOptInText:
type: string
description: Localized text of the marketing policy opt-in content
message:
type: string
description: Localized main message displayed on the guest portal sign-in page
nameError:
type: string
description: Error message when name not provided
nameLabel:
type: string
description: Localized label displayed for the name input field
optoutLabel:
type: string
description: Label for Do Not Store My Personal Information
pageTitle:
type: string
description: Localized browser or page title shown for the guest portal
passphraseCancel:
type: string
description: Label for the Passphrase cancel button
passphraseError:
type: string
description: Error message when invalid passphrase is provided
passphraseLabel:
type: string
description: Localized label for the passphrase input field
passphraseMessage:
type: string
description: Localized instructional text shown on the passphrase sign-in page
passphraseSubmit:
type: string
description: Label for the Passphrase submit button
passphraseTitle:
type: string
description: Title for passphrase details page
privacyPolicyAcceptLabel:
type: string
description: Prefix of the label of the link to go to Privacy Policy
privacyPolicyError:
type: string
description: Error message when Privacy Policy not accepted
privacyPolicyLink:
type: string
description: Label of the link to go to Privacy Policy
privacyPolicyText:
type: string
description: Text of the Privacy Policy
requiredFieldLabel:
type: string
description: Localized text used to mark a form field as required
signInLabel:
type: string
description: Label of the button to signin
smsCarrierDefault:
type: string
description: Localized default option text shown in the SMS carrier selector
smsCarrierError:
type: string
description: Localized error message shown when no mobile carrier is selected
smsCarrierFieldLabel:
type: string
description: Label for mobile carrier drop-down list
smsCodeCancel:
type: string
description: Label for cancel confirmation code submission
smsCodeError:
type: string
description: Error message when confirmation code is invalid
smsCodeFieldLabel:
type: string
description: Localized label for the SMS confirmation-code input field
smsCodeMessage:
type: string
description: Localized instructional text shown before entering the SMS access code
smsCodeSubmit:
type: string
description: Label for confirmation code submit button
smsCodeTitle:
type: string
description: Localized title shown on the SMS access-code entry page
smsCountryFieldLabel:
type: string
description: Localized label for the SMS country-code input field
smsCountryFormat:
type: string
description: Localized example country code format shown for SMS authentication
smsHaveAccessCode:
type: string
description: Label for checkbox to specify that the user has access code
smsMessageFormat:
type: string
description: Format of access code sms message. {{code}} and {{duration}} are placeholders and should be retained as is.
smsNumberCancel:
type: string
description: Label for canceling mobile details for SMS auth
smsNumberError:
type: string
description: Localized error message shown when the mobile number is invalid
smsNumberFieldLabel:
type: string
description: Label for field to provide mobile number
smsNumberFormat:
type: string
description: Localized example mobile number format shown for SMS authentication
smsNumberMessage:
type: string
description: Localized instructional text explaining SMS access-code delivery
smsNumberSubmit:
type: string
description: Label for submit button for code generation
smsNumberTitle:
type: string
description: Title for phone number details
smsUsernameFormat:
type: string
description: Localized example username format shown for SMS authentication
sponsorBackLink:
type: string
description: Localized link text for returning to edit the sponsor request form
sponsorCancel:
type: string
description: Localized button label for canceling sponsor authentication
sponsorEmail:
type: string
description: Label for Sponsor Email
sponsorEmailError:
type: string
description: Localized error message shown when the sponsor email address is invalid
sponsorInfoApproved:
type: string
description: Localized status message prefix shown when a sponsor approves the request
sponsorInfoDenied:
type: string
description: Localized status message prefix shown when a sponsor denies the request
sponsorInfoPending:
type: string
description: Localized status message prefix shown after a sponsor notification is sent
sponsorName:
type: string
description: Label for Sponsor Name
sponsorNameError:
type: string
description: Localized error message shown when the sponsor name is missing
sponsorNotePending:
type: string
description: Localized additional status text shown while sponsor approval is pending
sponsorRequestAccess:
type: string
description: Submit button label request Wifi Access and notify sponsor about guest request
sponsorStatusApproved:
type: string
description: Text to display if sponsor approves request
sponsorStatusDenied:
type: string
description: Text to display when sponsor denies request
sponsorStatusPending:
type: string
description: Text to display if request is still pending
sponsorSubmit:
type: string
description: Submit button label to notify sponsor about guest request
sponsorsError:
type: string
description: Localized error message shown when no sponsor is selected
sponsorsFieldLabel:
type: string
description: Localized label for the sponsor selection field
tosAcceptLabel:
type: string
description: Prefix of the label of the link to go to tos
tosError:
type: string
description: Error message when tos not accepted
tosLink:
type: string
description: Label of the link to go to tos
tosText:
type: string
description: Text of the Terms of Service
description: Localized portal template strings for Portuguese in Portugal
wlan_portal_template_setting_locale25:
title: wlan_portal_template_setting_locale25
type: object
properties:
authButtonAmazon:
type: string
description: Label for Amazon auth button
authButtonAzure:
type: string
description: Label for Azure auth button
authButtonEmail:
type: string
description: Label for Email auth button
authButtonFacebook:
type: string
description: Label for Facebook auth button
authButtonGoogle:
type: string
description: Label for Google auth button
authButtonMicrosoft:
type: string
description: Label for Microsoft auth button
authButtonPassphrase:
type: string
description: Label for passphrase auth button
authButtonSms:
type: string
description: Label for SMS auth button
authButtonSponsor:
type: string
description: Label for Sponsor auth button
authLabel:
type: string
description: Localized heading text displayed above portal authentication options
backLink:
type: string
description: Label of the link to go back to /logon
companyError:
type: string
description: Error message when company not provided
companyLabel:
type: string
description: Localized label displayed for the company input field
emailAccessDomainError:
type: string
description: Error message when a user has valid social login but doesn't match specified email domains.
emailCancel:
type: string
description: Label for cancel confirmation code submission using email auth
emailCodeCancel:
type: string
description: Localized link text for requesting help when the email access code was not received
emailCodeError:
type: string
description: Localized error message shown when the alternate email address for access-code delivery is invalid
emailCodeFieldLabel:
type: string
description: Localized label for the email access-code input field
emailCodeMessage:
type: string
description: Localized instructional text shown before entering the email access code
emailCodeSubmit:
type: string
description: Localized button label for submitting the email access code
emailCodeTitle:
type: string
description: Localized title shown on the email access-code entry page
emailError:
type: string
description: Error message when email not provided
emailFieldLabel:
type: string
description: Localized label for the email address input field
emailLabel:
type: string
description: Localized label displayed for the email input field
emailMessage:
type: string
description: Localized instructional text explaining email access-code delivery
emailSubmit:
type: string
description: Label for confirmation code submit button using email auth
emailTitle:
type: string
description: Title for the Email registration
field1Error:
type: string
description: Error message when field1 not provided
field1Label:
type: string
description: Localized label for custom field 1 input
field2Error:
type: string
description: Error message when field2 not provided
field2Label:
type: string
description: Localized label for custom field 2 input
field3Error:
type: string
description: Error message when field3 not provided
field3Label:
type: string
description: Localized label for custom field 3 input
field4Error:
type: string
description: Error message when field4 not provided
field4Label:
type: string
description: Localized label for custom field 4 input
marketingPolicyLink:
type: string
description: label of the link to go to /marketing_policy
marketingPolicyOptIn:
type: boolean
description: Whether marketing policy optin is enabled
marketingPolicyOptInLabel:
type: string
description: label for marketing optin
marketingPolicyOptInText:
type: string
description: Localized text of the marketing policy opt-in content
message:
type: string
description: Localized main message displayed on the guest portal sign-in page
nameError:
type: string
description: Error message when name not provided
nameLabel:
type: string
description: Localized label displayed for the name input field
optoutLabel:
type: string
description: Label for Do Not Store My Personal Information
pageTitle:
type: string
description: Localized browser or page title shown for the guest portal
passphraseCancel:
type: string
description: Label for the Passphrase cancel button
passphraseError:
type: string
description: Error message when invalid passphrase is provided
passphraseLabel:
type: string
description: Localized label for the passphrase input field
passphraseMessage:
type: string
description: Localized instructional text shown on the passphrase sign-in page
passphraseSubmit:
type: string
description: Label for the Passphrase submit button
passphraseTitle:
type: string
description: Title for passphrase details page
privacyPolicyAcceptLabel:
type: string
description: Prefix of the label of the link to go to Privacy Policy
privacyPolicyError:
type: string
description: Error message when Privacy Policy not accepted
privacyPolicyLink:
type: string
description: Label of the link to go to Privacy Policy
privacyPolicyText:
type: string
description: Text of the Privacy Policy
requiredFieldLabel:
type: string
description: Localized text used to mark a form field as required
signInLabel:
type: string
description: Label of the button to signin
smsCarrierDefault:
type: string
description: Localized default option text shown in the SMS carrier selector
smsCarrierError:
type: string
description: Localized error message shown when no mobile carrier is selected
smsCarrierFieldLabel:
type: string
description: Label for mobile carrier drop-down list
smsCodeCancel:
type: string
description: Label for cancel confirmation code submission
smsCodeError:
type: string
description: Error message when confirmation code is invalid
smsCodeFieldLabel:
type: string
description: Localized label for the SMS confirmation-code input field
smsCodeMessage:
type: string
description: Localized instructional text shown before entering the SMS access code
smsCodeSubmit:
type: string
description: Label for confirmation code submit button
smsCodeTitle:
type: string
description: Localized title shown on the SMS access-code entry page
smsCountryFieldLabel:
type: string
description: Localized label for the SMS country-code input field
smsCountryFormat:
type: string
description: Localized example country code format shown for SMS authentication
smsHaveAccessCode:
type: string
description: Label for checkbox to specify that the user has access code
smsMessageFormat:
type: string
description: Format of access code sms message. {{code}} and {{duration}} are placeholders and should be retained as is.
smsNumberCancel:
type: string
description: Label for canceling mobile details for SMS auth
smsNumberError:
type: string
description: Localized error message shown when the mobile number is invalid
smsNumberFieldLabel:
type: string
description: Label for field to provide mobile number
smsNumberFormat:
type: string
description: Localized example mobile number format shown for SMS authentication
smsNumberMessage:
type: string
description: Localized instructional text explaining SMS access-code delivery
smsNumberSubmit:
type: string
description: Label for submit button for code generation
smsNumberTitle:
type: string
description: Title for phone number details
smsUsernameFormat:
type: string
description: Localized example username format shown for SMS authentication
sponsorBackLink:
type: string
description: Localized link text for returning to edit the sponsor request form
sponsorCancel:
type: string
description: Localized button label for canceling sponsor authentication
sponsorEmail:
type: string
description: Label for Sponsor Email
sponsorEmailError:
type: string
description: Localized error message shown when the sponsor email address is invalid
sponsorInfoApproved:
type: string
description: Localized status message prefix shown when a sponsor approves the request
sponsorInfoDenied:
type: string
description: Localized status message prefix shown when a sponsor denies the request
sponsorInfoPending:
type: string
description: Localized status message prefix shown after a sponsor notification is sent
sponsorName:
type: string
description: Label for Sponsor Name
sponsorNameError:
type: string
description: Localized error message shown when the sponsor name is missing
sponsorNotePending:
type: string
description: Localized additional status text shown while sponsor approval is pending
sponsorRequestAccess:
type: string
description: Submit button label request Wifi Access and notify sponsor about guest request
sponsorStatusApproved:
type: string
description: Text to display if sponsor approves request
sponsorStatusDenied:
type: string
description: Text to display when sponsor denies request
sponsorStatusPending:
type: string
description: Text to display if request is still pending
sponsorSubmit:
type: string
description: Submit button label to notify sponsor about guest request
sponsorsError:
type: string
description: Localized error message shown when no sponsor is selected
sponsorsFieldLabel:
type: string
description: Localized label for the sponsor selection field
tosAcceptLabel:
type: string
description: Prefix of the label of the link to go to tos
tosError:
type: string
description: Error message when tos not accepted
tosLink:
type: string
description: Label of the link to go to tos
tosText:
type: string
description: Text of the Terms of Service
description: Localized portal template strings for Romanian in Romania
wlan_portal_template_setting_locale26:
title: wlan_portal_template_setting_locale26
type: object
properties:
authButtonAmazon:
type: string
description: Label for Amazon auth button
authButtonAzure:
type: string
description: Label for Azure auth button
authButtonEmail:
type: string
description: Label for Email auth button
authButtonFacebook:
type: string
description: Label for Facebook auth button
authButtonGoogle:
type: string
description: Label for Google auth button
authButtonMicrosoft:
type: string
description: Label for Microsoft auth button
authButtonPassphrase:
type: string
description: Label for passphrase auth button
authButtonSms:
type: string
description: Label for SMS auth button
authButtonSponsor:
type: string
description: Label for Sponsor auth button
authLabel:
type: string
description: Localized heading text displayed above portal authentication options
backLink:
type: string
description: Label of the link to go back to /logon
companyError:
type: string
description: Error message when company not provided
companyLabel:
type: string
description: Localized label displayed for the company input field
emailAccessDomainError:
type: string
description: Error message when a user has valid social login but doesn't match specified email domains.
emailCancel:
type: string
description: Label for cancel confirmation code submission using email auth
emailCodeCancel:
type: string
description: Localized link text for requesting help when the email access code was not received
emailCodeError:
type: string
description: Localized error message shown when the alternate email address for access-code delivery is invalid
emailCodeFieldLabel:
type: string
description: Localized label for the email access-code input field
emailCodeMessage:
type: string
description: Localized instructional text shown before entering the email access code
emailCodeSubmit:
type: string
description: Localized button label for submitting the email access code
emailCodeTitle:
type: string
description: Localized title shown on the email access-code entry page
emailError:
type: string
description: Error message when email not provided
emailFieldLabel:
type: string
description: Localized label for the email address input field
emailLabel:
type: string
description: Localized label displayed for the email input field
emailMessage:
type: string
description: Localized instructional text explaining email access-code delivery
emailSubmit:
type: string
description: Label for confirmation code submit button using email auth
emailTitle:
type: string
description: Title for the Email registration
field1Error:
type: string
description: Error message when field1 not provided
field1Label:
type: string
description: Localized label for custom field 1 input
field2Error:
type: string
description: Error message when field2 not provided
field2Label:
type: string
description: Localized label for custom field 2 input
field3Error:
type: string
description: Error message when field3 not provided
field3Label:
type: string
description: Localized label for custom field 3 input
field4Error:
type: string
description: Error message when field4 not provided
field4Label:
type: string
description: Localized label for custom field 4 input
marketingPolicyLink:
type: string
description: label of the link to go to /marketing_policy
marketingPolicyOptIn:
type: boolean
description: Whether marketing policy optin is enabled
marketingPolicyOptInLabel:
type: string
description: label for marketing optin
marketingPolicyOptInText:
type: string
description: Localized text of the marketing policy opt-in content
message:
type: string
description: Localized main message displayed on the guest portal sign-in page
nameError:
type: string
description: Error message when name not provided
nameLabel:
type: string
description: Localized label displayed for the name input field
optoutLabel:
type: string
description: Label for Do Not Store My Personal Information
pageTitle:
type: string
description: Localized browser or page title shown for the guest portal
passphraseCancel:
type: string
description: Label for the Passphrase cancel button
passphraseError:
type: string
description: Error message when invalid passphrase is provided
passphraseLabel:
type: string
description: Localized label for the passphrase input field
passphraseMessage:
type: string
description: Localized instructional text shown on the passphrase sign-in page
passphraseSubmit:
type: string
description: Label for the Passphrase submit button
passphraseTitle:
type: string
description: Title for passphrase details page
privacyPolicyAcceptLabel:
type: string
description: Prefix of the label of the link to go to Privacy Policy
privacyPolicyError:
type: string
description: Error message when Privacy Policy not accepted
privacyPolicyLink:
type: string
description: Label of the link to go to Privacy Policy
privacyPolicyText:
type: string
description: Text of the Privacy Policy
requiredFieldLabel:
type: string
description: Localized text used to mark a form field as required
signInLabel:
type: string
description: Label of the button to signin
smsCarrierDefault:
type: string
description: Localized default option text shown in the SMS carrier selector
smsCarrierError:
type: string
description: Localized error message shown when no mobile carrier is selected
smsCarrierFieldLabel:
type: string
description: Label for mobile carrier drop-down list
smsCodeCancel:
type: string
description: Label for cancel confirmation code submission
smsCodeError:
type: string
description: Error message when confirmation code is invalid
smsCodeFieldLabel:
type: string
description: Localized label for the SMS confirmation-code input field
smsCodeMessage:
type: string
description: Localized instructional text shown before entering the SMS access code
smsCodeSubmit:
type: string
description: Label for confirmation code submit button
smsCodeTitle:
type: string
description: Localized title shown on the SMS access-code entry page
smsCountryFieldLabel:
type: string
description: Localized label for the SMS country-code input field
smsCountryFormat:
type: string
description: Localized example country code format shown for SMS authentication
smsHaveAccessCode:
type: string
description: Label for checkbox to specify that the user has access code
smsMessageFormat:
type: string
description: Format of access code sms message. {{code}} and {{duration}} are placeholders and should be retained as is.
smsNumberCancel:
type: string
description: Label for canceling mobile details for SMS auth
smsNumberError:
type: string
description: Localized error message shown when the mobile number is invalid
smsNumberFieldLabel:
type: string
description: Label for field to provide mobile number
smsNumberFormat:
type: string
description: Localized example mobile number format shown for SMS authentication
smsNumberMessage:
type: string
description: Localized instructional text explaining SMS access-code delivery
smsNumberSubmit:
type: string
description: Label for submit button for code generation
smsNumberTitle:
type: string
description: Title for phone number details
smsUsernameFormat:
type: string
description: Localized example username format shown for SMS authentication
sponsorBackLink:
type: string
description: Localized link text for returning to edit the sponsor request form
sponsorCancel:
type: string
description: Localized button label for canceling sponsor authentication
sponsorEmail:
type: string
description: Label for Sponsor Email
sponsorEmailError:
type: string
description: Localized error message shown when the sponsor email address is invalid
sponsorInfoApproved:
type: string
description: Localized status message prefix shown when a sponsor approves the request
sponsorInfoDenied:
type: string
description: Localized status message prefix shown when a sponsor denies the request
sponsorInfoPending:
type: string
description: Localized status message prefix shown after a sponsor notification is sent
sponsorName:
type: string
description: Label for Sponsor Name
sponsorNameError:
type: string
description: Localized error message shown when the sponsor name is missing
sponsorNotePending:
type: string
description: Localized additional status text shown while sponsor approval is pending
sponsorRequestAccess:
type: string
description: Submit button label request Wifi Access and notify sponsor about guest request
sponsorStatusApproved:
type: string
description: Text to display if sponsor approves request
sponsorStatusDenied:
type: string
description: Text to display when sponsor denies request
sponsorStatusPending:
type: string
description: Text to display if request is still pending
sponsorSubmit:
type: string
description: Submit button label to notify sponsor about guest request
sponsorsError:
type: string
description: Localized error message shown when no sponsor is selected
sponsorsFieldLabel:
type: string
description: Localized label for the sponsor selection field
tosAcceptLabel:
type: string
description: Prefix of the label of the link to go to tos
tosError:
type: string
description: Error message when tos not accepted
tosLink:
type: string
description: Label of the link to go to tos
tosText:
type: string
description: Text of the Terms of Service
description: Localized portal template strings for Russian in Russia
wlan_portal_template_setting_locale27:
title: wlan_portal_template_setting_locale27
type: object
properties:
authButtonAmazon:
type: string
description: Label for Amazon auth button
authButtonAzure:
type: string
description: Label for Azure auth button
authButtonEmail:
type: string
description: Label for Email auth button
authButtonFacebook:
type: string
description: Label for Facebook auth button
authButtonGoogle:
type: string
description: Label for Google auth button
authButtonMicrosoft:
type: string
description: Label for Microsoft auth button
authButtonPassphrase:
type: string
description: Label for passphrase auth button
authButtonSms:
type: string
description: Label for SMS auth button
authButtonSponsor:
type: string
description: Label for Sponsor auth button
authLabel:
type: string
description: Localized heading text displayed above portal authentication options
backLink:
type: string
description: Label of the link to go back to /logon
companyError:
type: string
description: Error message when company not provided
companyLabel:
type: string
description: Localized label displayed for the company input field
emailAccessDomainError:
type: string
description: Error message when a user has valid social login but doesn't match specified email domains.
emailCancel:
type: string
description: Label for cancel confirmation code submission using email auth
emailCodeCancel:
type: string
description: Localized link text for requesting help when the email access code was not received
emailCodeError:
type: string
description: Localized error message shown when the alternate email address for access-code delivery is invalid
emailCodeFieldLabel:
type: string
description: Localized label for the email access-code input field
emailCodeMessage:
type: string
description: Localized instructional text shown before entering the email access code
emailCodeSubmit:
type: string
description: Localized button label for submitting the email access code
emailCodeTitle:
type: string
description: Localized title shown on the email access-code entry page
emailError:
type: string
description: Error message when email not provided
emailFieldLabel:
type: string
description: Localized label for the email address input field
emailLabel:
type: string
description: Localized label displayed for the email input field
emailMessage:
type: string
description: Localized instructional text explaining email access-code delivery
emailSubmit:
type: string
description: Label for confirmation code submit button using email auth
emailTitle:
type: string
description: Title for the Email registration
field1Error:
type: string
description: Error message when field1 not provided
field1Label:
type: string
description: Localized label for custom field 1 input
field2Error:
type: string
description: Error message when field2 not provided
field2Label:
type: string
description: Localized label for custom field 2 input
field3Error:
type: string
description: Error message when field3 not provided
field3Label:
type: string
description: Localized label for custom field 3 input
field4Error:
type: string
description: Error message when field4 not provided
field4Label:
type: string
description: Localized label for custom field 4 input
marketingPolicyLink:
type: string
description: label of the link to go to /marketing_policy
marketingPolicyOptIn:
type: boolean
description: Whether marketing policy optin is enabled
marketingPolicyOptInLabel:
type: string
description: label for marketing optin
marketingPolicyOptInText:
type: string
description: Localized text of the marketing policy opt-in content
message:
type: string
description: Localized main message displayed on the guest portal sign-in page
nameError:
type: string
description: Error message when name not provided
nameLabel:
type: string
description: Localized label displayed for the name input field
optoutLabel:
type: string
description: Label for Do Not Store My Personal Information
pageTitle:
type: string
description: Localized browser or page title shown for the guest portal
passphraseCancel:
type: string
description: Label for the Passphrase cancel button
passphraseError:
type: string
description: Error message when invalid passphrase is provided
passphraseLabel:
type: string
description: Localized label for the passphrase input field
passphraseMessage:
type: string
description: Localized instructional text shown on the passphrase sign-in page
passphraseSubmit:
type: string
description: Label for the Passphrase submit button
passphraseTitle:
type: string
description: Title for passphrase details page
privacyPolicyAcceptLabel:
type: string
description: Prefix of the label of the link to go to Privacy Policy
privacyPolicyError:
type: string
description: Error message when Privacy Policy not accepted
privacyPolicyLink:
type: string
description: Label of the link to go to Privacy Policy
privacyPolicyText:
type: string
description: Text of the Privacy Policy
requiredFieldLabel:
type: string
description: Localized text used to mark a form field as required
signInLabel:
type: string
description: Label of the button to signin
smsCarrierDefault:
type: string
description: Localized default option text shown in the SMS carrier selector
smsCarrierError:
type: string
description: Localized error message shown when no mobile carrier is selected
smsCarrierFieldLabel:
type: string
description: Label for mobile carrier drop-down list
smsCodeCancel:
type: string
description: Label for cancel confirmation code submission
smsCodeError:
type: string
description: Error message when confirmation code is invalid
smsCodeFieldLabel:
type: string
description: Localized label for the SMS confirmation-code input field
smsCodeMessage:
type: string
description: Localized instructional text shown before entering the SMS access code
smsCodeSubmit:
type: string
description: Label for confirmation code submit button
smsCodeTitle:
type: string
description: Localized title shown on the SMS access-code entry page
smsCountryFieldLabel:
type: string
description: Localized label for the SMS country-code input field
smsCountryFormat:
type: string
description: Localized example country code format shown for SMS authentication
smsHaveAccessCode:
type: string
description: Label for checkbox to specify that the user has access code
smsMessageFormat:
type: string
description: Format of access code sms message. {{code}} and {{duration}} are placeholders and should be retained as is.
smsNumberCancel:
type: string
description: Label for canceling mobile details for SMS auth
smsNumberError:
type: string
description: Localized error message shown when the mobile number is invalid
smsNumberFieldLabel:
type: string
description: Label for field to provide mobile number
smsNumberFormat:
type: string
description: Localized example mobile number format shown for SMS authentication
smsNumberMessage:
type: string
description: Localized instructional text explaining SMS access-code delivery
smsNumberSubmit:
type: string
description: Label for submit button for code generation
smsNumberTitle:
type: string
description: Title for phone number details
smsUsernameFormat:
type: string
description: Localized example username format shown for SMS authentication
sponsorBackLink:
type: string
description: Localized link text for returning to edit the sponsor request form
sponsorCancel:
type: string
description: Localized button label for canceling sponsor authentication
sponsorEmail:
type: string
description: Label for Sponsor Email
sponsorEmailError:
type: string
description: Localized error message shown when the sponsor email address is invalid
sponsorInfoApproved:
type: string
description: Localized status message prefix shown when a sponsor approves the request
sponsorInfoDenied:
type: string
description: Localized status message prefix shown when a sponsor denies the request
sponsorInfoPending:
type: string
description: Localized status message prefix shown after a sponsor notification is sent
sponsorName:
type: string
description: Label for Sponsor Name
sponsorNameError:
type: string
description: Localized error message shown when the sponsor name is missing
sponsorNotePending:
type: string
description: Localized additional status text shown while sponsor approval is pending
sponsorRequestAccess:
type: string
description: Submit button label request Wifi Access and notify sponsor about guest request
sponsorStatusApproved:
type: string
description: Text to display if sponsor approves request
sponsorStatusDenied:
type: string
description: Text to display when sponsor denies request
sponsorStatusPending:
type: string
description: Text to display if request is still pending
sponsorSubmit:
type: string
description: Submit button label to notify sponsor about guest request
sponsorsError:
type: string
description: Localized error message shown when no sponsor is selected
sponsorsFieldLabel:
type: string
description: Localized label for the sponsor selection field
tosAcceptLabel:
type: string
description: Prefix of the label of the link to go to tos
tosError:
type: string
description: Error message when tos not accepted
tosLink:
type: string
description: Label of the link to go to tos
tosText:
type: string
description: Text of the Terms of Service
description: Localized portal template strings for Slovak in Slovakia
wlan_portal_template_setting_locale28:
title: wlan_portal_template_setting_locale28
type: object
properties:
authButtonAmazon:
type: string
description: Label for Amazon auth button
authButtonAzure:
type: string
description: Label for Azure auth button
authButtonEmail:
type: string
description: Label for Email auth button
authButtonFacebook:
type: string
description: Label for Facebook auth button
authButtonGoogle:
type: string
description: Label for Google auth button
authButtonMicrosoft:
type: string
description: Label for Microsoft auth button
authButtonPassphrase:
type: string
description: Label for passphrase auth button
authButtonSms:
type: string
description: Label for SMS auth button
authButtonSponsor:
type: string
description: Label for Sponsor auth button
authLabel:
type: string
description: Localized heading text displayed above portal authentication options
backLink:
type: string
description: Label of the link to go back to /logon
companyError:
type: string
description: Error message when company not provided
companyLabel:
type: string
description: Localized label displayed for the company input field
emailAccessDomainError:
type: string
description: Error message when a user has valid social login but doesn't match specified email domains.
emailCancel:
type: string
description: Label for cancel confirmation code submission using email auth
emailCodeCancel:
type: string
description: Localized link text for requesting help when the email access code was not received
emailCodeError:
type: string
description: Localized error message shown when the alternate email address for access-code delivery is invalid
emailCodeFieldLabel:
type: string
description: Localized label for the email access-code input field
emailCodeMessage:
type: string
description: Localized instructional text shown before entering the email access code
emailCodeSubmit:
type: string
description: Localized button label for submitting the email access code
emailCodeTitle:
type: string
description: Localized title shown on the email access-code entry page
emailError:
type: string
description: Error message when email not provided
emailFieldLabel:
type: string
description: Localized label for the email address input field
emailLabel:
type: string
description: Localized label displayed for the email input field
emailMessage:
type: string
description: Localized instructional text explaining email access-code delivery
emailSubmit:
type: string
description: Label for confirmation code submit button using email auth
emailTitle:
type: string
description: Title for the Email registration
field1Error:
type: string
description: Error message when field1 not provided
field1Label:
type: string
description: Localized label for custom field 1 input
field2Error:
type: string
description: Error message when field2 not provided
field2Label:
type: string
description: Localized label for custom field 2 input
field3Error:
type: string
description: Error message when field3 not provided
field3Label:
type: string
description: Localized label for custom field 3 input
field4Error:
type: string
description: Error message when field4 not provided
field4Label:
type: string
description: Localized label for custom field 4 input
marketingPolicyLink:
type: string
description: label of the link to go to /marketing_policy
marketingPolicyOptIn:
type: boolean
description: Whether marketing policy optin is enabled
marketingPolicyOptInLabel:
type: string
description: label for marketing optin
marketingPolicyOptInText:
type: string
description: Localized text of the marketing policy opt-in content
message:
type: string
description: Localized main message displayed on the guest portal sign-in page
nameError:
type: string
description: Error message when name not provided
nameLabel:
type: string
description: Localized label displayed for the name input field
optoutLabel:
type: string
description: Label for Do Not Store My Personal Information
pageTitle:
type: string
description: Localized browser or page title shown for the guest portal
passphraseCancel:
type: string
description: Label for the Passphrase cancel button
passphraseError:
type: string
description: Error message when invalid passphrase is provided
passphraseLabel:
type: string
description: Localized label for the passphrase input field
passphraseMessage:
type: string
description: Localized instructional text shown on the passphrase sign-in page
passphraseSubmit:
type: string
description: Label for the Passphrase submit button
passphraseTitle:
type: string
description: Title for passphrase details page
privacyPolicyAcceptLabel:
type: string
description: Prefix of the label of the link to go to Privacy Policy
privacyPolicyError:
type: string
description: Error message when Privacy Policy not accepted
privacyPolicyLink:
type: string
description: Label of the link to go to Privacy Policy
privacyPolicyText:
type: string
description: Text of the Privacy Policy
requiredFieldLabel:
type: string
description: Localized text used to mark a form field as required
signInLabel:
type: string
description: Label of the button to signin
smsCarrierDefault:
type: string
description: Localized default option text shown in the SMS carrier selector
smsCarrierError:
type: string
description: Localized error message shown when no mobile carrier is selected
smsCarrierFieldLabel:
type: string
description: Label for mobile carrier drop-down list
smsCodeCancel:
type: string
description: Label for cancel confirmation code submission
smsCodeError:
type: string
description: Error message when confirmation code is invalid
smsCodeFieldLabel:
type: string
description: Localized label for the SMS confirmation-code input field
smsCodeMessage:
type: string
description: Localized instructional text shown before entering the SMS access code
smsCodeSubmit:
type: string
description: Label for confirmation code submit button
smsCodeTitle:
type: string
description: Localized title shown on the SMS access-code entry page
smsCountryFieldLabel:
type: string
description: Localized label for the SMS country-code input field
smsCountryFormat:
type: string
description: Localized example country code format shown for SMS authentication
smsHaveAccessCode:
type: string
description: Label for checkbox to specify that the user has access code
smsMessageFormat:
type: string
description: Format of access code sms message. {{code}} and {{duration}} are placeholders and should be retained as is.
smsNumberCancel:
type: string
description: Label for canceling mobile details for SMS auth
smsNumberError:
type: string
description: Localized error message shown when the mobile number is invalid
smsNumberFieldLabel:
type: string
description: Label for field to provide mobile number
smsNumberFormat:
type: string
description: Localized example mobile number format shown for SMS authentication
smsNumberMessage:
type: string
description: Localized instructional text explaining SMS access-code delivery
smsNumberSubmit:
type: string
description: Label for submit button for code generation
smsNumberTitle:
type: string
description: Title for phone number details
smsUsernameFormat:
type: string
description: Localized example username format shown for SMS authentication
sponsorBackLink:
type: string
description: Localized link text for returning to edit the sponsor request form
sponsorCancel:
type: string
description: Localized button label for canceling sponsor authentication
sponsorEmail:
type: string
description: Label for Sponsor Email
sponsorEmailError:
type: string
description: Localized error message shown when the sponsor email address is invalid
sponsorInfoApproved:
type: string
description: Localized status message prefix shown when a sponsor approves the request
sponsorInfoDenied:
type: string
description: Localized status message prefix shown when a sponsor denies the request
sponsorInfoPending:
type: string
description: Localized status message prefix shown after a sponsor notification is sent
sponsorName:
type: string
description: Label for Sponsor Name
sponsorNameError:
type: string
description: Localized error message shown when the sponsor name is missing
sponsorNotePending:
type: string
description: Localized additional status text shown while sponsor approval is pending
sponsorRequestAccess:
type: string
description: Submit button label request Wifi Access and notify sponsor about guest request
sponsorStatusApproved:
type: string
description: Text to display if sponsor approves request
sponsorStatusDenied:
type: string
description: Text to display when sponsor denies request
sponsorStatusPending:
type: string
description: Text to display if request is still pending
sponsorSubmit:
type: string
description: Submit button label to notify sponsor about guest request
sponsorsError:
type: string
description: Localized error message shown when no sponsor is selected
sponsorsFieldLabel:
type: string
description: Localized label for the sponsor selection field
tosAcceptLabel:
type: string
description: Prefix of the label of the link to go to tos
tosError:
type: string
description: Error message when tos not accepted
tosLink:
type: string
description: Label of the link to go to tos
tosText:
type: string
description: Text of the Terms of Service
description: Localized portal template strings for Swedish in Sweden
wlan_portal_template_setting_locale29:
title: wlan_portal_template_setting_locale29
type: object
properties:
authButtonAmazon:
type: string
description: Label for Amazon auth button
authButtonAzure:
type: string
description: Label for Azure auth button
authButtonEmail:
type: string
description: Label for Email auth button
authButtonFacebook:
type: string
description: Label for Facebook auth button
authButtonGoogle:
type: string
description: Label for Google auth button
authButtonMicrosoft:
type: string
description: Label for Microsoft auth button
authButtonPassphrase:
type: string
description: Label for passphrase auth button
authButtonSms:
type: string
description: Label for SMS auth button
authButtonSponsor:
type: string
description: Label for Sponsor auth button
authLabel:
type: string
description: Localized heading text displayed above portal authentication options
backLink:
type: string
description: Label of the link to go back to /logon
companyError:
type: string
description: Error message when company not provided
companyLabel:
type: string
description: Localized label displayed for the company input field
emailAccessDomainError:
type: string
description: Error message when a user has valid social login but doesn't match specified email domains.
emailCancel:
type: string
description: Label for cancel confirmation code submission using email auth
emailCodeCancel:
type: string
description: Localized link text for requesting help when the email access code was not received
emailCodeError:
type: string
description: Localized error message shown when the alternate email address for access-code delivery is invalid
emailCodeFieldLabel:
type: string
description: Localized label for the email access-code input field
emailCodeMessage:
type: string
description: Localized instructional text shown before entering the email access code
emailCodeSubmit:
type: string
description: Localized button label for submitting the email access code
emailCodeTitle:
type: string
description: Localized title shown on the email access-code entry page
emailError:
type: string
description: Error message when email not provided
emailFieldLabel:
type: string
description: Localized label for the email address input field
emailLabel:
type: string
description: Localized label displayed for the email input field
emailMessage:
type: string
description: Localized instructional text explaining email access-code delivery
emailSubmit:
type: string
description: Label for confirmation code submit button using email auth
emailTitle:
type: string
description: Title for the Email registration
field1Error:
type: string
description: Error message when field1 not provided
field1Label:
type: string
description: Localized label for custom field 1 input
field2Error:
type: string
description: Error message when field2 not provided
field2Label:
type: string
description: Localized label for custom field 2 input
field3Error:
type: string
description: Error message when field3 not provided
field3Label:
type: string
description: Localized label for custom field 3 input
field4Error:
type: string
description: Error message when field4 not provided
field4Label:
type: string
description: Localized label for custom field 4 input
marketingPolicyLink:
type: string
description: label of the link to go to /marketing_policy
marketingPolicyOptIn:
type: boolean
description: Whether marketing policy optin is enabled
marketingPolicyOptInLabel:
type: string
description: label for marketing optin
marketingPolicyOptInText:
type: string
description: Localized text of the marketing policy opt-in content
message:
type: string
description: Localized main message displayed on the guest portal sign-in page
nameError:
type: string
description: Error message when name not provided
nameLabel:
type: string
description: Localized label displayed for the name input field
optoutLabel:
type: string
description: Label for Do Not Store My Personal Information
pageTitle:
type: string
description: Localized browser or page title shown for the guest portal
passphraseCancel:
type: string
description: Label for the Passphrase cancel button
passphraseError:
type: string
description: Error message when invalid passphrase is provided
passphraseLabel:
type: string
description: Localized label for the passphrase input field
passphraseMessage:
type: string
description: Localized instructional text shown on the passphrase sign-in page
passphraseSubmit:
type: string
description: Label for the Passphrase submit button
passphraseTitle:
type: string
description: Title for passphrase details page
privacyPolicyAcceptLabel:
type: string
description: Prefix of the label of the link to go to Privacy Policy
privacyPolicyError:
type: string
description: Error message when Privacy Policy not accepted
privacyPolicyLink:
type: string
description: Label of the link to go to Privacy Policy
privacyPolicyText:
type: string
description: Text of the Privacy Policy
requiredFieldLabel:
type: string
description: Localized text used to mark a form field as required
signInLabel:
type: string
description: Label of the button to signin
smsCarrierDefault:
type: string
description: Localized default option text shown in the SMS carrier selector
smsCarrierError:
type: string
description: Localized error message shown when no mobile carrier is selected
smsCarrierFieldLabel:
type: string
description: Label for mobile carrier drop-down list
smsCodeCancel:
type: string
description: Label for cancel confirmation code submission
smsCodeError:
type: string
description: Error message when confirmation code is invalid
smsCodeFieldLabel:
type: string
description: Localized label for the SMS confirmation-code input field
smsCodeMessage:
type: string
description: Localized instructional text shown before entering the SMS access code
smsCodeSubmit:
type: string
description: Label for confirmation code submit button
smsCodeTitle:
type: string
description: Localized title shown on the SMS access-code entry page
smsCountryFieldLabel:
type: string
description: Localized label for the SMS country-code input field
smsCountryFormat:
type: string
description: Localized example country code format shown for SMS authentication
smsHaveAccessCode:
type: string
description: Label for checkbox to specify that the user has access code
smsMessageFormat:
type: string
description: Format of access code sms message. {{code}} and {{duration}} are placeholders and should be retained as is.
smsNumberCancel:
type: string
description: Label for canceling mobile details for SMS auth
smsNumberError:
type: string
description: Localized error message shown when the mobile number is invalid
smsNumberFieldLabel:
type: string
description: Label for field to provide mobile number
smsNumberFormat:
type: string
description: Localized example mobile number format shown for SMS authentication
smsNumberMessage:
type: string
description: Localized instructional text explaining SMS access-code delivery
smsNumberSubmit:
type: string
description: Label for submit button for code generation
smsNumberTitle:
type: string
description: Title for phone number details
smsUsernameFormat:
type: string
description: Localized example username format shown for SMS authentication
sponsorBackLink:
type: string
description: Localized link text for returning to edit the sponsor request form
sponsorCancel:
type: string
description: Localized button label for canceling sponsor authentication
sponsorEmail:
type: string
description: Label for Sponsor Email
sponsorEmailError:
type: string
description: Localized error message shown when the sponsor email address is invalid
sponsorInfoApproved:
type: string
description: Localized status message prefix shown when a sponsor approves the request
sponsorInfoDenied:
type: string
description: Localized status message prefix shown when a sponsor denies the request
sponsorInfoPending:
type: string
description: Localized status message prefix shown after a sponsor notification is sent
sponsorName:
type: string
description: Label for Sponsor Name
sponsorNameError:
type: string
description: Localized error message shown when the sponsor name is missing
sponsorNotePending:
type: string
description: Localized additional status text shown while sponsor approval is pending
sponsorRequestAccess:
type: string
description: Submit button label request Wifi Access and notify sponsor about guest request
sponsorStatusApproved:
type: string
description: Text to display if sponsor approves request
sponsorStatusDenied:
type: string
description: Text to display when sponsor denies request
sponsorStatusPending:
type: string
description: Text to display if request is still pending
sponsorSubmit:
type: string
description: Submit button label to notify sponsor about guest request
sponsorsError:
type: string
description: Localized error message shown when no sponsor is selected
sponsorsFieldLabel:
type: string
description: Localized label for the sponsor selection field
tosAcceptLabel:
type: string
description: Prefix of the label of the link to go to tos
tosError:
type: string
description: Error message when tos not accepted
tosLink:
type: string
description: Label of the link to go to tos
tosText:
type: string
description: Text of the Terms of Service
description: Localized portal template strings for Thai in Thailand
wlan_portal_template_setting_locale30:
title: wlan_portal_template_setting_locale30
type: object
properties:
authButtonAmazon:
type: string
description: Label for Amazon auth button
authButtonAzure:
type: string
description: Label for Azure auth button
authButtonEmail:
type: string
description: Label for Email auth button
authButtonFacebook:
type: string
description: Label for Facebook auth button
authButtonGoogle:
type: string
description: Label for Google auth button
authButtonMicrosoft:
type: string
description: Label for Microsoft auth button
authButtonPassphrase:
type: string
description: Label for passphrase auth button
authButtonSms:
type: string
description: Label for SMS auth button
authButtonSponsor:
type: string
description: Label for Sponsor auth button
authLabel:
type: string
description: Localized heading text displayed above portal authentication options
backLink:
type: string
description: Label of the link to go back to /logon
companyError:
type: string
description: Error message when company not provided
companyLabel:
type: string
description: Localized label displayed for the company input field
emailAccessDomainError:
type: string
description: Error message when a user has valid social login but doesn't match specified email domains.
emailCancel:
type: string
description: Label for cancel confirmation code submission using email auth
emailCodeCancel:
type: string
description: Localized link text for requesting help when the email access code was not received
emailCodeError:
type: string
description: Localized error message shown when the alternate email address for access-code delivery is invalid
emailCodeFieldLabel:
type: string
description: Localized label for the email access-code input field
emailCodeMessage:
type: string
description: Localized instructional text shown before entering the email access code
emailCodeSubmit:
type: string
description: Localized button label for submitting the email access code
emailCodeTitle:
type: string
description: Localized title shown on the email access-code entry page
emailError:
type: string
description: Error message when email not provided
emailFieldLabel:
type: string
description: Localized label for the email address input field
emailLabel:
type: string
description: Localized label displayed for the email input field
emailMessage:
type: string
description: Localized instructional text explaining email access-code delivery
emailSubmit:
type: string
description: Label for confirmation code submit button using email auth
emailTitle:
type: string
description: Title for the Email registration
field1Error:
type: string
description: Error message when field1 not provided
field1Label:
type: string
description: Localized label for custom field 1 input
field2Error:
type: string
description: Error message when field2 not provided
field2Label:
type: string
description: Localized label for custom field 2 input
field3Error:
type: string
description: Error message when field3 not provided
field3Label:
type: string
description: Localized label for custom field 3 input
field4Error:
type: string
description: Error message when field4 not provided
field4Label:
type: string
description: Localized label for custom field 4 input
marketingPolicyLink:
type: string
description: label of the link to go to /marketing_policy
marketingPolicyOptIn:
type: boolean
description: Whether marketing policy optin is enabled
marketingPolicyOptInLabel:
type: string
description: label for marketing optin
marketingPolicyOptInText:
type: string
description: Localized text of the marketing policy opt-in content
message:
type: string
description: Localized main message displayed on the guest portal sign-in page
nameError:
type: string
description: Error message when name not provided
nameLabel:
type: string
description: Localized label displayed for the name input field
optoutLabel:
type: string
description: Label for Do Not Store My Personal Information
pageTitle:
type: string
description: Localized browser or page title shown for the guest portal
passphraseCancel:
type: string
description: Label for the Passphrase cancel button
passphraseError:
type: string
description: Error message when invalid passphrase is provided
passphraseLabel:
type: string
description: Localized label for the passphrase input field
passphraseMessage:
type: string
description: Localized instructional text shown on the passphrase sign-in page
passphraseSubmit:
type: string
description: Label for the Passphrase submit button
passphraseTitle:
type: string
description: Title for passphrase details page
privacyPolicyAcceptLabel:
type: string
description: Prefix of the label of the link to go to Privacy Policy
privacyPolicyError:
type: string
description: Error message when Privacy Policy not accepted
privacyPolicyLink:
type: string
description: Label of the link to go to Privacy Policy
privacyPolicyText:
type: string
description: Text of the Privacy Policy
requiredFieldLabel:
type: string
description: Localized text used to mark a form field as required
signInLabel:
type: string
description: Label of the button to signin
smsCarrierDefault:
type: string
description: Localized default option text shown in the SMS carrier selector
smsCarrierError:
type: string
description: Localized error message shown when no mobile carrier is selected
smsCarrierFieldLabel:
type: string
description: Label for mobile carrier drop-down list
smsCodeCancel:
type: string
description: Label for cancel confirmation code submission
smsCodeError:
type: string
description: Error message when confirmation code is invalid
smsCodeFieldLabel:
type: string
description: Localized label for the SMS confirmation-code input field
smsCodeMessage:
type: string
description: Localized instructional text shown before entering the SMS access code
smsCodeSubmit:
type: string
description: Label for confirmation code submit button
smsCodeTitle:
type: string
description: Localized title shown on the SMS access-code entry page
smsCountryFieldLabel:
type: string
description: Localized label for the SMS country-code input field
smsCountryFormat:
type: string
description: Localized example country code format shown for SMS authentication
smsHaveAccessCode:
type: string
description: Label for checkbox to specify that the user has access code
smsMessageFormat:
type: string
description: Format of access code sms message. {{code}} and {{duration}} are placeholders and should be retained as is.
smsNumberCancel:
type: string
description: Label for canceling mobile details for SMS auth
smsNumberError:
type: string
description: Localized error message shown when the mobile number is invalid
smsNumberFieldLabel:
type: string
description: Label for field to provide mobile number
smsNumberFormat:
type: string
description: Localized example mobile number format shown for SMS authentication
smsNumberMessage:
type: string
description: Localized instructional text explaining SMS access-code delivery
smsNumberSubmit:
type: string
description: Label for submit button for code generation
smsNumberTitle:
type: string
description: Title for phone number details
smsUsernameFormat:
type: string
description: Localized example username format shown for SMS authentication
sponsorBackLink:
type: string
description: Localized link text for returning to edit the sponsor request form
sponsorCancel:
type: string
description: Localized button label for canceling sponsor authentication
sponsorEmail:
type: string
description: Label for Sponsor Email
sponsorEmailError:
type: string
description: Localized error message shown when the sponsor email address is invalid
sponsorInfoApproved:
type: string
description: Localized status message prefix shown when a sponsor approves the request
sponsorInfoDenied:
type: string
description: Localized status message prefix shown when a sponsor denies the request
sponsorInfoPending:
type: string
description: Localized status message prefix shown after a sponsor notification is sent
sponsorName:
type: string
description: Label for Sponsor Name
sponsorNameError:
type: string
description: Localized error message shown when the sponsor name is missing
sponsorNotePending:
type: string
description: Localized additional status text shown while sponsor approval is pending
sponsorRequestAccess:
type: string
description: Submit button label request Wifi Access and notify sponsor about guest request
sponsorStatusApproved:
type: string
description: Text to display if sponsor approves request
sponsorStatusDenied:
type: string
description: Text to display when sponsor denies request
sponsorStatusPending:
type: string
description: Text to display if request is still pending
sponsorSubmit:
type: string
description: Submit button label to notify sponsor about guest request
sponsorsError:
type: string
description: Localized error message shown when no sponsor is selected
sponsorsFieldLabel:
type: string
description: Localized label for the sponsor selection field
tosAcceptLabel:
type: string
description: Prefix of the label of the link to go to tos
tosError:
type: string
description: Error message when tos not accepted
tosLink:
type: string
description: Label of the link to go to tos
tosText:
type: string
description: Text of the Terms of Service
description: Localized portal template strings for Turkish in Turkey
wlan_portal_template_setting_locale31:
title: wlan_portal_template_setting_locale31
type: object
properties:
authButtonAmazon:
type: string
description: Label for Amazon auth button
authButtonAzure:
type: string
description: Label for Azure auth button
authButtonEmail:
type: string
description: Label for Email auth button
authButtonFacebook:
type: string
description: Label for Facebook auth button
authButtonGoogle:
type: string
description: Label for Google auth button
authButtonMicrosoft:
type: string
description: Label for Microsoft auth button
authButtonPassphrase:
type: string
description: Label for passphrase auth button
authButtonSms:
type: string
description: Label for SMS auth button
authButtonSponsor:
type: string
description: Label for Sponsor auth button
authLabel:
type: string
description: Localized heading text displayed above portal authentication options
backLink:
type: string
description: Label of the link to go back to /logon
companyError:
type: string
description: Error message when company not provided
companyLabel:
type: string
description: Localized label displayed for the company input field
emailAccessDomainError:
type: string
description: Error message when a user has valid social login but doesn't match specified email domains.
emailCancel:
type: string
description: Label for cancel confirmation code submission using email auth
emailCodeCancel:
type: string
description: Localized link text for requesting help when the email access code was not received
emailCodeError:
type: string
description: Localized error message shown when the alternate email address for access-code delivery is invalid
emailCodeFieldLabel:
type: string
description: Localized label for the email access-code input field
emailCodeMessage:
type: string
description: Localized instructional text shown before entering the email access code
emailCodeSubmit:
type: string
description: Localized button label for submitting the email access code
emailCodeTitle:
type: string
description: Localized title shown on the email access-code entry page
emailError:
type: string
description: Error message when email not provided
emailFieldLabel:
type: string
description: Localized label for the email address input field
emailLabel:
type: string
description: Localized label displayed for the email input field
emailMessage:
type: string
description: Localized instructional text explaining email access-code delivery
emailSubmit:
type: string
description: Label for confirmation code submit button using email auth
emailTitle:
type: string
description: Title for the Email registration
field1Error:
type: string
description: Error message when field1 not provided
field1Label:
type: string
description: Localized label for custom field 1 input
field2Error:
type: string
description: Error message when field2 not provided
field2Label:
type: string
description: Localized label for custom field 2 input
field3Error:
type: string
description: Error message when field3 not provided
field3Label:
type: string
description: Localized label for custom field 3 input
field4Error:
type: string
description: Error message when field4 not provided
field4Label:
type: string
description: Localized label for custom field 4 input
marketingPolicyLink:
type: string
description: label of the link to go to /marketing_policy
marketingPolicyOptIn:
type: boolean
description: Whether marketing policy optin is enabled
marketingPolicyOptInLabel:
type: string
description: label for marketing optin
marketingPolicyOptInText:
type: string
description: Localized text of the marketing policy opt-in content
message:
type: string
description: Localized main message displayed on the guest portal sign-in page
nameError:
type: string
description: Error message when name not provided
nameLabel:
type: string
description: Localized label displayed for the name input field
optoutLabel:
type: string
description: Label for Do Not Store My Personal Information
pageTitle:
type: string
description: Localized browser or page title shown for the guest portal
passphraseCancel:
type: string
description: Label for the Passphrase cancel button
passphraseError:
type: string
description: Error message when invalid passphrase is provided
passphraseLabel:
type: string
description: Localized label for the passphrase input field
passphraseMessage:
type: string
description: Localized instructional text shown on the passphrase sign-in page
passphraseSubmit:
type: string
description: Label for the Passphrase submit button
passphraseTitle:
type: string
description: Title for passphrase details page
privacyPolicyAcceptLabel:
type: string
description: Prefix of the label of the link to go to Privacy Policy
privacyPolicyError:
type: string
description: Error message when Privacy Policy not accepted
privacyPolicyLink:
type: string
description: Label of the link to go to Privacy Policy
privacyPolicyText:
type: string
description: Text of the Privacy Policy
requiredFieldLabel:
type: string
description: Localized text used to mark a form field as required
signInLabel:
type: string
description: Label of the button to signin
smsCarrierDefault:
type: string
description: Localized default option text shown in the SMS carrier selector
smsCarrierError:
type: string
description: Localized error message shown when no mobile carrier is selected
smsCarrierFieldLabel:
type: string
description: Label for mobile carrier drop-down list
smsCodeCancel:
type: string
description: Label for cancel confirmation code submission
smsCodeError:
type: string
description: Error message when confirmation code is invalid
smsCodeFieldLabel:
type: string
description: Localized label for the SMS confirmation-code input field
smsCodeMessage:
type: string
description: Localized instructional text shown before entering the SMS access code
smsCodeSubmit:
type: string
description: Label for confirmation code submit button
smsCodeTitle:
type: string
description: Localized title shown on the SMS access-code entry page
smsCountryFieldLabel:
type: string
description: Localized label for the SMS country-code input field
smsCountryFormat:
type: string
description: Localized example country code format shown for SMS authentication
smsHaveAccessCode:
type: string
description: Label for checkbox to specify that the user has access code
smsMessageFormat:
type: string
description: Format of access code sms message. {{code}} and {{duration}} are placeholders and should be retained as is.
smsNumberCancel:
type: string
description: Label for canceling mobile details for SMS auth
smsNumberError:
type: string
description: Localized error message shown when the mobile number is invalid
smsNumberFieldLabel:
type: string
description: Label for field to provide mobile number
smsNumberFormat:
type: string
description: Localized example mobile number format shown for SMS authentication
smsNumberMessage:
type: string
description: Localized instructional text explaining SMS access-code delivery
smsNumberSubmit:
type: string
description: Label for submit button for code generation
smsNumberTitle:
type: string
description: Title for phone number details
smsUsernameFormat:
type: string
description: Localized example username format shown for SMS authentication
sponsorBackLink:
type: string
description: Localized link text for returning to edit the sponsor request form
sponsorCancel:
type: string
description: Localized button label for canceling sponsor authentication
sponsorEmail:
type: string
description: Label for Sponsor Email
sponsorEmailError:
type: string
description: Localized error message shown when the sponsor email address is invalid
sponsorInfoApproved:
type: string
description: Localized status message prefix shown when a sponsor approves the request
sponsorInfoDenied:
type: string
description: Localized status message prefix shown when a sponsor denies the request
sponsorInfoPending:
type: string
description: Localized status message prefix shown after a sponsor notification is sent
sponsorName:
type: string
description: Label for Sponsor Name
sponsorNameError:
type: string
description: Localized error message shown when the sponsor name is missing
sponsorNotePending:
type: string
description: Localized additional status text shown while sponsor approval is pending
sponsorRequestAccess:
type: string
description: Submit button label request Wifi Access and notify sponsor about guest request
sponsorStatusApproved:
type: string
description: Text to display if sponsor approves request
sponsorStatusDenied:
type: string
description: Text to display when sponsor denies request
sponsorStatusPending:
type: string
description: Text to display if request is still pending
sponsorSubmit:
type: string
description: Submit button label to notify sponsor about guest request
sponsorsError:
type: string
description: Localized error message shown when no sponsor is selected
sponsorsFieldLabel:
type: string
description: Localized label for the sponsor selection field
tosAcceptLabel:
type: string
description: Prefix of the label of the link to go to tos
tosError:
type: string
description: Error message when tos not accepted
tosLink:
type: string
description: Label of the link to go to tos
tosText:
type: string
description: Text of the Terms of Service
description: Localized portal template strings for Ukrainian in Ukraine
wlan_portal_template_setting_locale32:
title: wlan_portal_template_setting_locale32
type: object
properties:
authButtonAmazon:
type: string
description: Label for Amazon auth button
authButtonAzure:
type: string
description: Label for Azure auth button
authButtonEmail:
type: string
description: Label for Email auth button
authButtonFacebook:
type: string
description: Label for Facebook auth button
authButtonGoogle:
type: string
description: Label for Google auth button
authButtonMicrosoft:
type: string
description: Label for Microsoft auth button
authButtonPassphrase:
type: string
description: Label for passphrase auth button
authButtonSms:
type: string
description: Label for SMS auth button
authButtonSponsor:
type: string
description: Label for Sponsor auth button
authLabel:
type: string
description: Localized heading text displayed above portal authentication options
backLink:
type: string
description: Label of the link to go back to /logon
companyError:
type: string
description: Error message when company not provided
companyLabel:
type: string
description: Localized label displayed for the company input field
emailAccessDomainError:
type: string
description: Error message when a user has valid social login but doesn't match specified email domains.
emailCancel:
type: string
description: Label for cancel confirmation code submission using email auth
emailCodeCancel:
type: string
description: Localized link text for requesting help when the email access code was not received
emailCodeError:
type: string
description: Localized error message shown when the alternate email address for access-code delivery is invalid
emailCodeFieldLabel:
type: string
description: Localized label for the email access-code input field
emailCodeMessage:
type: string
description: Localized instructional text shown before entering the email access code
emailCodeSubmit:
type: string
description: Localized button label for submitting the email access code
emailCodeTitle:
type: string
description: Localized title shown on the email access-code entry page
emailError:
type: string
description: Error message when email not provided
emailFieldLabel:
type: string
description: Localized label for the email address input field
emailLabel:
type: string
description: Localized label displayed for the email input field
emailMessage:
type: string
description: Localized instructional text explaining email access-code delivery
emailSubmit:
type: string
description: Label for confirmation code submit button using email auth
emailTitle:
type: string
description: Title for the Email registration
field1Error:
type: string
description: Error message when field1 not provided
field1Label:
type: string
description: Localized label for custom field 1 input
field2Error:
type: string
description: Error message when field2 not provided
field2Label:
type: string
description: Localized label for custom field 2 input
field3Error:
type: string
description: Error message when field3 not provided
field3Label:
type: string
description: Localized label for custom field 3 input
field4Error:
type: string
description: Error message when field4 not provided
field4Label:
type: string
description: Localized label for custom field 4 input
marketingPolicyLink:
type: string
description: label of the link to go to /marketing_policy
marketingPolicyOptIn:
type: boolean
description: Whether marketing policy optin is enabled
marketingPolicyOptInLabel:
type: string
description: label for marketing optin
marketingPolicyOptInText:
type: string
description: Localized text of the marketing policy opt-in content
message:
type: string
description: Localized main message displayed on the guest portal sign-in page
nameError:
type: string
description: Error message when name not provided
nameLabel:
type: string
description: Localized label displayed for the name input field
optoutLabel:
type: string
description: Label for Do Not Store My Personal Information
pageTitle:
type: string
description: Localized browser or page title shown for the guest portal
passphraseCancel:
type: string
description: Label for the Passphrase cancel button
passphraseError:
type: string
description: Error message when invalid passphrase is provided
passphraseLabel:
type: string
description: Localized label for the passphrase input field
passphraseMessage:
type: string
description: Localized instructional text shown on the passphrase sign-in page
passphraseSubmit:
type: string
description: Label for the Passphrase submit button
passphraseTitle:
type: string
description: Title for passphrase details page
privacyPolicyAcceptLabel:
type: string
description: Prefix of the label of the link to go to Privacy Policy
privacyPolicyError:
type: string
description: Error message when Privacy Policy not accepted
privacyPolicyLink:
type: string
description: Label of the link to go to Privacy Policy
privacyPolicyText:
type: string
description: Text of the Privacy Policy
requiredFieldLabel:
type: string
description: Localized text used to mark a form field as required
signInLabel:
type: string
description: Label of the button to signin
smsCarrierDefault:
type: string
description: Localized default option text shown in the SMS carrier selector
smsCarrierError:
type: string
description: Localized error message shown when no mobile carrier is selected
smsCarrierFieldLabel:
type: string
description: Label for mobile carrier drop-down list
smsCodeCancel:
type: string
description: Label for cancel confirmation code submission
smsCodeError:
type: string
description: Error message when confirmation code is invalid
smsCodeFieldLabel:
type: string
description: Localized label for the SMS confirmation-code input field
smsCodeMessage:
type: string
description: Localized instructional text shown before entering the SMS access code
smsCodeSubmit:
type: string
description: Label for confirmation code submit button
smsCodeTitle:
type: string
description: Localized title shown on the SMS access-code entry page
smsCountryFieldLabel:
type: string
description: Localized label for the SMS country-code input field
smsCountryFormat:
type: string
description: Localized example country code format shown for SMS authentication
smsHaveAccessCode:
type: string
description: Label for checkbox to specify that the user has access code
smsMessageFormat:
type: string
description: Format of access code sms message. {{code}} and {{duration}} are placeholders and should be retained as is.
smsNumberCancel:
type: string
description: Label for canceling mobile details for SMS auth
smsNumberError:
type: string
description: Localized error message shown when the mobile number is invalid
smsNumberFieldLabel:
type: string
description: Label for field to provide mobile number
smsNumberFormat:
type: string
description: Localized example mobile number format shown for SMS authentication
smsNumberMessage:
type: string
description: Localized instructional text explaining SMS access-code delivery
smsNumberSubmit:
type: string
description: Label for submit button for code generation
smsNumberTitle:
type: string
description: Title for phone number details
smsUsernameFormat:
type: string
description: Localized example username format shown for SMS authentication
sponsorBackLink:
type: string
description: Localized link text for returning to edit the sponsor request form
sponsorCancel:
type: string
description: Localized button label for canceling sponsor authentication
sponsorEmail:
type: string
description: Label for Sponsor Email
sponsorEmailError:
type: string
description: Localized error message shown when the sponsor email address is invalid
sponsorInfoApproved:
type: string
description: Localized status message prefix shown when a sponsor approves the request
sponsorInfoDenied:
type: string
description: Localized status message prefix shown when a sponsor denies the request
sponsorInfoPending:
type: string
description: Localized status message prefix shown after a sponsor notification is sent
sponsorName:
type: string
description: Label for Sponsor Name
sponsorNameError:
type: string
description: Localized error message shown when the sponsor name is missing
sponsorNotePending:
type: string
description: Localized additional status text shown while sponsor approval is pending
sponsorRequestAccess:
type: string
description: Submit button label request Wifi Access and notify sponsor about guest request
sponsorStatusApproved:
type: string
description: Text to display if sponsor approves request
sponsorStatusDenied:
type: string
description: Text to display when sponsor denies request
sponsorStatusPending:
type: string
description: Text to display if request is still pending
sponsorSubmit:
type: string
description: Submit button label to notify sponsor about guest request
sponsorsError:
type: string
description: Localized error message shown when no sponsor is selected
sponsorsFieldLabel:
type: string
description: Localized label for the sponsor selection field
tosAcceptLabel:
type: string
description: Prefix of the label of the link to go to tos
tosError:
type: string
description: Error message when tos not accepted
tosLink:
type: string
description: Label of the link to go to tos
tosText:
type: string
description: Text of the Terms of Service
description: Localized portal template strings for Vietnamese in Vietnam
wlan_portal_template_setting_locale33:
title: wlan_portal_template_setting_locale33
type: object
properties:
authButtonAmazon:
type: string
description: Label for Amazon auth button
authButtonAzure:
type: string
description: Label for Azure auth button
authButtonEmail:
type: string
description: Label for Email auth button
authButtonFacebook:
type: string
description: Label for Facebook auth button
authButtonGoogle:
type: string
description: Label for Google auth button
authButtonMicrosoft:
type: string
description: Label for Microsoft auth button
authButtonPassphrase:
type: string
description: Label for passphrase auth button
authButtonSms:
type: string
description: Label for SMS auth button
authButtonSponsor:
type: string
description: Label for Sponsor auth button
authLabel:
type: string
description: Localized heading text displayed above portal authentication options
backLink:
type: string
description: Label of the link to go back to /logon
companyError:
type: string
description: Error message when company not provided
companyLabel:
type: string
description: Localized label displayed for the company input field
emailAccessDomainError:
type: string
description: Error message when a user has valid social login but doesn't match specified email domains.
emailCancel:
type: string
description: Label for cancel confirmation code submission using email auth
emailCodeCancel:
type: string
description: Localized link text for requesting help when the email access code was not received
emailCodeError:
type: string
description: Localized error message shown when the alternate email address for access-code delivery is invalid
emailCodeFieldLabel:
type: string
description: Localized label for the email access-code input field
emailCodeMessage:
type: string
description: Localized instructional text shown before entering the email access code
emailCodeSubmit:
type: string
description: Localized button label for submitting the email access code
emailCodeTitle:
type: string
description: Localized title shown on the email access-code entry page
emailError:
type: string
description: Error message when email not provided
emailFieldLabel:
type: string
description: Localized label for the email address input field
emailLabel:
type: string
description: Localized label displayed for the email input field
emailMessage:
type: string
description: Localized instructional text explaining email access-code delivery
emailSubmit:
type: string
description: Label for confirmation code submit button using email auth
emailTitle:
type: string
description: Title for the Email registration
field1Error:
type: string
description: Error message when field1 not provided
field1Label:
type: string
description: Localized label for custom field 1 input
field2Error:
type: string
description: Error message when field2 not provided
field2Label:
type: string
description: Localized label for custom field 2 input
field3Error:
type: string
description: Error message when field3 not provided
field3Label:
type: string
description: Localized label for custom field 3 input
field4Error:
type: string
description: Error message when field4 not provided
field4Label:
type: string
description: Localized label for custom field 4 input
marketingPolicyLink:
type: string
description: label of the link to go to /marketing_policy
marketingPolicyOptIn:
type: boolean
description: Whether marketing policy optin is enabled
marketingPolicyOptInLabel:
type: string
description: label for marketing optin
marketingPolicyOptInText:
type: string
description: Localized text of the marketing policy opt-in content
message:
type: string
description: Localized main message displayed on the guest portal sign-in page
nameError:
type: string
description: Error message when name not provided
nameLabel:
type: string
description: Localized label displayed for the name input field
optoutLabel:
type: string
description: Label for Do Not Store My Personal Information
pageTitle:
type: string
description: Localized browser or page title shown for the guest portal
passphraseCancel:
type: string
description: Label for the Passphrase cancel button
passphraseError:
type: string
description: Error message when invalid passphrase is provided
passphraseLabel:
type: string
description: Localized label for the passphrase input field
passphraseMessage:
type: string
description: Localized instructional text shown on the passphrase sign-in page
passphraseSubmit:
type: string
description: Label for the Passphrase submit button
passphraseTitle:
type: string
description: Title for passphrase details page
privacyPolicyAcceptLabel:
type: string
description: Prefix of the label of the link to go to Privacy Policy
privacyPolicyError:
type: string
description: Error message when Privacy Policy not accepted
privacyPolicyLink:
type: string
description: Label of the link to go to Privacy Policy
privacyPolicyText:
type: string
description: Text of the Privacy Policy
requiredFieldLabel:
type: string
description: Localized text used to mark a form field as required
signInLabel:
type: string
description: Label of the button to signin
smsCarrierDefault:
type: string
description: Localized default option text shown in the SMS carrier selector
smsCarrierError:
type: string
description: Localized error message shown when no mobile carrier is selected
smsCarrierFieldLabel:
type: string
description: Label for mobile carrier drop-down list
smsCodeCancel:
type: string
description: Label for cancel confirmation code submission
smsCodeError:
type: string
description: Error message when confirmation code is invalid
smsCodeFieldLabel:
type: string
description: Localized label for the SMS confirmation-code input field
smsCodeMessage:
type: string
description: Localized instructional text shown before entering the SMS access code
smsCodeSubmit:
type: string
description: Label for confirmation code submit button
smsCodeTitle:
type: string
description: Localized title shown on the SMS access-code entry page
smsCountryFieldLabel:
type: string
description: Localized label for the SMS country-code input field
smsCountryFormat:
type: string
description: Localized example country code format shown for SMS authentication
smsHaveAccessCode:
type: string
description: Label for checkbox to specify that the user has access code
smsMessageFormat:
type: string
description: Format of access code sms message. {{code}} and {{duration}} are placeholders and should be retained as is.
smsNumberCancel:
type: string
description: Label for canceling mobile details for SMS auth
smsNumberError:
type: string
description: Localized error message shown when the mobile number is invalid
smsNumberFieldLabel:
type: string
description: Label for field to provide mobile number
smsNumberFormat:
type: string
description: Localized example mobile number format shown for SMS authentication
smsNumberMessage:
type: string
description: Localized instructional text explaining SMS access-code delivery
smsNumberSubmit:
type: string
description: Label for submit button for code generation
smsNumberTitle:
type: string
description: Title for phone number details
smsUsernameFormat:
type: string
description: Localized example username format shown for SMS authentication
sponsorBackLink:
type: string
description: Localized link text for returning to edit the sponsor request form
sponsorCancel:
type: string
description: Localized button label for canceling sponsor authentication
sponsorEmail:
type: string
description: Label for Sponsor Email
sponsorEmailError:
type: string
description: Localized error message shown when the sponsor email address is invalid
sponsorInfoApproved:
type: string
description: Localized status message prefix shown when a sponsor approves the request
sponsorInfoDenied:
type: string
description: Localized status message prefix shown when a sponsor denies the request
sponsorInfoPending:
type: string
description: Localized status message prefix shown after a sponsor notification is sent
sponsorName:
type: string
description: Label for Sponsor Name
sponsorNameError:
type: string
description: Localized error message shown when the sponsor name is missing
sponsorNotePending:
type: string
description: Localized additional status text shown while sponsor approval is pending
sponsorRequestAccess:
type: string
description: Submit button label request Wifi Access and notify sponsor about guest request
sponsorStatusApproved:
type: string
description: Text to display if sponsor approves request
sponsorStatusDenied:
type: string
description: Text to display when sponsor denies request
sponsorStatusPending:
type: string
description: Text to display if request is still pending
sponsorSubmit:
type: string
description: Submit button label to notify sponsor about guest request
sponsorsError:
type: string
description: Localized error message shown when no sponsor is selected
sponsorsFieldLabel:
type: string
description: Localized label for the sponsor selection field
tosAcceptLabel:
type: string
description: Prefix of the label of the link to go to tos
tosError:
type: string
description: Error message when tos not accepted
tosLink:
type: string
description: Label of the link to go to tos
tosText:
type: string
description: Text of the Terms of Service
description: Localized portal template strings for Simplified Chinese
wlan_portal_template_setting_locale34:
title: wlan_portal_template_setting_locale34
type: object
properties:
authButtonAmazon:
type: string
description: Label for Amazon auth button
authButtonAzure:
type: string
description: Label for Azure auth button
authButtonEmail:
type: string
description: Label for Email auth button
authButtonFacebook:
type: string
description: Label for Facebook auth button
authButtonGoogle:
type: string
description: Label for Google auth button
authButtonMicrosoft:
type: string
description: Label for Microsoft auth button
authButtonPassphrase:
type: string
description: Label for passphrase auth button
authButtonSms:
type: string
description: Label for SMS auth button
authButtonSponsor:
type: string
description: Label for Sponsor auth button
authLabel:
type: string
description: Localized heading text displayed above portal authentication options
backLink:
type: string
description: Label of the link to go back to /logon
companyError:
type: string
description: Error message when company not provided
companyLabel:
type: string
description: Localized label displayed for the company input field
emailAccessDomainError:
type: string
description: Error message when a user has valid social login but doesn't match specified email domains.
emailCancel:
type: string
description: Label for cancel confirmation code submission using email auth
emailCodeCancel:
type: string
description: Localized link text for requesting help when the email access code was not received
emailCodeError:
type: string
description: Localized error message shown when the alternate email address for access-code delivery is invalid
emailCodeFieldLabel:
type: string
description: Localized label for the email access-code input field
emailCodeMessage:
type: string
description: Localized instructional text shown before entering the email access code
emailCodeSubmit:
type: string
description: Localized button label for submitting the email access code
emailCodeTitle:
type: string
description: Localized title shown on the email access-code entry page
emailError:
type: string
description: Error message when email not provided
emailFieldLabel:
type: string
description: Localized label for the email address input field
emailLabel:
type: string
description: Localized label displayed for the email input field
emailMessage:
type: string
description: Localized instructional text explaining email access-code delivery
emailSubmit:
type: string
description: Label for confirmation code submit button using email auth
emailTitle:
type: string
description: Title for the Email registration
field1Error:
type: string
description: Error message when field1 not provided
field1Label:
type: string
description: Localized label for custom field 1 input
field2Error:
type: string
description: Error message when field2 not provided
field2Label:
type: string
description: Localized label for custom field 2 input
field3Error:
type: string
description: Error message when field3 not provided
field3Label:
type: string
description: Localized label for custom field 3 input
field4Error:
type: string
description: Error message when field4 not provided
field4Label:
type: string
description: Localized label for custom field 4 input
marketingPolicyLink:
type: string
description: label of the link to go to /marketing_policy
marketingPolicyOptIn:
type: boolean
description: Whether marketing policy optin is enabled
marketingPolicyOptInLabel:
type: string
description: label for marketing optin
marketingPolicyOptInText:
type: string
description: Localized text of the marketing policy opt-in content
message:
type: string
description: Localized main message displayed on the guest portal sign-in page
nameError:
type: string
description: Error message when name not provided
nameLabel:
type: string
description: Localized label displayed for the name input field
optoutLabel:
type: string
description: Label for Do Not Store My Personal Information
pageTitle:
type: string
description: Localized browser or page title shown for the guest portal
passphraseCancel:
type: string
description: Label for the Passphrase cancel button
passphraseError:
type: string
description: Error message when invalid passphrase is provided
passphraseLabel:
type: string
description: Localized label for the passphrase input field
passphraseMessage:
type: string
description: Localized instructional text shown on the passphrase sign-in page
passphraseSubmit:
type: string
description: Label for the Passphrase submit button
passphraseTitle:
type: string
description: Title for passphrase details page
privacyPolicyAcceptLabel:
type: string
description: Prefix of the label of the link to go to Privacy Policy
privacyPolicyError:
type: string
description: Error message when Privacy Policy not accepted
privacyPolicyLink:
type: string
description: Label of the link to go to Privacy Policy
privacyPolicyText:
type: string
description: Text of the Privacy Policy
requiredFieldLabel:
type: string
description: Localized text used to mark a form field as required
signInLabel:
type: string
description: Label of the button to signin
smsCarrierDefault:
type: string
description: Localized default option text shown in the SMS carrier selector
smsCarrierError:
type: string
description: Localized error message shown when no mobile carrier is selected
smsCarrierFieldLabel:
type: string
description: Label for mobile carrier drop-down list
smsCodeCancel:
type: string
description: Label for cancel confirmation code submission
smsCodeError:
type: string
description: Error message when confirmation code is invalid
smsCodeFieldLabel:
type: string
description: Localized label for the SMS confirmation-code input field
smsCodeMessage:
type: string
description: Localized instructional text shown before entering the SMS access code
smsCodeSubmit:
type: string
description: Label for confirmation code submit button
smsCodeTitle:
type: string
description: Localized title shown on the SMS access-code entry page
smsCountryFieldLabel:
type: string
description: Localized label for the SMS country-code input field
smsCountryFormat:
type: string
description: Localized example country code format shown for SMS authentication
smsHaveAccessCode:
type: string
description: Label for checkbox to specify that the user has access code
smsMessageFormat:
type: string
description: Format of access code sms message. {{code}} and {{duration}} are placeholders and should be retained as is.
smsNumberCancel:
type: string
description: Label for canceling mobile details for SMS auth
smsNumberError:
type: string
description: Localized error message shown when the mobile number is invalid
smsNumberFieldLabel:
type: string
description: Label for field to provide mobile number
smsNumberFormat:
type: string
description: Localized example mobile number format shown for SMS authentication
smsNumberMessage:
type: string
description: Localized instructional text explaining SMS access-code delivery
smsNumberSubmit:
type: string
description: Label for submit button for code generation
smsNumberTitle:
type: string
description: Title for phone number details
smsUsernameFormat:
type: string
description: Localized example username format shown for SMS authentication
sponsorBackLink:
type: string
description: Localized link text for returning to edit the sponsor request form
sponsorCancel:
type: string
description: Localized button label for canceling sponsor authentication
sponsorEmail:
type: string
description: Label for Sponsor Email
sponsorEmailError:
type: string
description: Localized error message shown when the sponsor email address is invalid
sponsorInfoApproved:
type: string
description: Localized status message prefix shown when a sponsor approves the request
sponsorInfoDenied:
type: string
description: Localized status message prefix shown when a sponsor denies the request
sponsorInfoPending:
type: string
description: Localized status message prefix shown after a sponsor notification is sent
sponsorName:
type: string
description: Label for Sponsor Name
sponsorNameError:
type: string
description: Localized error message shown when the sponsor name is missing
sponsorNotePending:
type: string
description: Localized additional status text shown while sponsor approval is pending
sponsorRequestAccess:
type: string
description: Submit button label request Wifi Access and notify sponsor about guest request
sponsorStatusApproved:
type: string
description: Text to display if sponsor approves request
sponsorStatusDenied:
type: string
description: Text to display when sponsor denies request
sponsorStatusPending:
type: string
description: Text to display if request is still pending
sponsorSubmit:
type: string
description: Submit button label to notify sponsor about guest request
sponsorsError:
type: string
description: Localized error message shown when no sponsor is selected
sponsorsFieldLabel:
type: string
description: Localized label for the sponsor selection field
tosAcceptLabel:
type: string
description: Prefix of the label of the link to go to tos
tosError:
type: string
description: Error message when tos not accepted
tosLink:
type: string
description: Label of the link to go to tos
tosText:
type: string
description: Text of the Terms of Service
description: Localized portal template strings for Traditional Chinese
wlan_portal_template_setting_locale36:
title: wlan_portal_template_setting_locale36
type: object
properties:
authButtonAmazon:
type: string
description: Label for Amazon auth button
authButtonAzure:
type: string
description: Label for Azure auth button
authButtonEmail:
type: string
description: Label for Email auth button
authButtonFacebook:
type: string
description: Label for Facebook auth button
authButtonGoogle:
type: string
description: Label for Google auth button
authButtonMicrosoft:
type: string
description: Label for Microsoft auth button
authButtonPassphrase:
type: string
description: Label for passphrase auth button
authButtonSms:
type: string
description: Label for SMS auth button
authButtonSponsor:
type: string
description: Label for Sponsor auth button
authLabel:
type: string
description: Localized heading text displayed above portal authentication options
backLink:
type: string
description: Label of the link to go back to /logon
companyError:
type: string
description: Error message when company not provided
companyLabel:
type: string
description: Localized label displayed for the company input field
emailAccessDomainError:
type: string
description: Error message when a user has valid social login but doesn't match specified email domains.
emailCancel:
type: string
description: Label for cancel confirmation code submission using email auth
emailCodeCancel:
type: string
description: Localized link text for requesting help when the email access code was not received
emailCodeError:
type: string
description: Localized error message shown when the alternate email address for access-code delivery is invalid
emailCodeFieldLabel:
type: string
description: Localized label for the email access-code input field
emailCodeMessage:
type: string
description: Localized instructional text shown before entering the email access code
emailCodeSubmit:
type: string
description: Localized button label for submitting the email access code
emailCodeTitle:
type: string
description: Localized title shown on the email access-code entry page
emailError:
type: string
description: Error message when email not provided
emailFieldLabel:
type: string
description: Localized label for the email address input field
emailLabel:
type: string
description: Localized label displayed for the email input field
emailMessage:
type: string
description: Localized instructional text explaining email access-code delivery
emailSubmit:
type: string
description: Label for confirmation code submit button using email auth
emailTitle:
type: string
description: Title for the Email registration
field1Error:
type: string
description: Error message when field1 not provided
field1Label:
type: string
description: Localized label for custom field 1 input
field2Error:
type: string
description: Error message when field2 not provided
field2Label:
type: string
description: Localized label for custom field 2 input
field3Error:
type: string
description: Error message when field3 not provided
field3Label:
type: string
description: Localized label for custom field 3 input
field4Error:
type: string
description: Error message when field4 not provided
field4Label:
type: string
description: Localized label for custom field 4 input
marketingPolicyLink:
type: string
description: label of the link to go to /marketing_policy
marketingPolicyOptIn:
type: boolean
description: Whether marketing policy optin is enabled
marketingPolicyOptInLabel:
type: string
description: label for marketing optin
marketingPolicyOptInText:
type: string
description: Localized text of the marketing policy opt-in content
message:
type: string
description: Localized main message displayed on the guest portal sign-in page
nameError:
type: string
description: Error message when name not provided
nameLabel:
type: string
description: Localized label displayed for the name input field
optoutLabel:
type: string
description: Label for Do Not Store My Personal Information
pageTitle:
type: string
description: Localized browser or page title shown for the guest portal
passphraseCancel:
type: string
description: Label for the Passphrase cancel button
passphraseError:
type: string
description: Error message when invalid passphrase is provided
passphraseLabel:
type: string
description: Localized label for the passphrase input field
passphraseMessage:
type: string
description: Localized instructional text shown on the passphrase sign-in page
passphraseSubmit:
type: string
description: Label for the Passphrase submit button
passphraseTitle:
type: string
description: Title for passphrase details page
privacyPolicyAcceptLabel:
type: string
description: Prefix of the label of the link to go to Privacy Policy
privacyPolicyError:
type: string
description: Error message when Privacy Policy not accepted
privacyPolicyLink:
type: string
description: Label of the link to go to Privacy Policy
privacyPolicyText:
type: string
description: Text of the Privacy Policy
requiredFieldLabel:
type: string
description: Localized text used to mark a form field as required
signInLabel:
type: string
description: Label of the button to signin
smsCarrierDefault:
type: string
description: Localized default option text shown in the SMS carrier selector
smsCarrierError:
type: string
description: Localized error message shown when no mobile carrier is selected
smsCarrierFieldLabel:
type: string
description: Label for mobile carrier drop-down list
smsCodeCancel:
type: string
description: Label for cancel confirmation code submission
smsCodeError:
type: string
description: Error message when confirmation code is invalid
smsCodeFieldLabel:
type: string
description: Localized label for the SMS confirmation-code input field
smsCodeMessage:
type: string
description: Localized instructional text shown before entering the SMS access code
smsCodeSubmit:
type: string
description: Label for confirmation code submit button
smsCodeTitle:
type: string
description: Localized title shown on the SMS access-code entry page
smsCountryFieldLabel:
type: string
description: Localized label for the SMS country-code input field
smsCountryFormat:
type: string
description: Localized example country code format shown for SMS authentication
smsHaveAccessCode:
type: string
description: Label for checkbox to specify that the user has access code
smsMessageFormat:
type: string
description: Format of access code sms message. {{code}} and {{duration}} are placeholders and should be retained as is.
smsNumberCancel:
type: string
description: Label for canceling mobile details for SMS auth
smsNumberError:
type: string
description: Localized error message shown when the mobile number is invalid
smsNumberFieldLabel:
type: string
description: Label for field to provide mobile number
smsNumberFormat:
type: string
description: Localized example mobile number format shown for SMS authentication
smsNumberMessage:
type: string
description: Localized instructional text explaining SMS access-code delivery
smsNumberSubmit:
type: string
description: Label for submit button for code generation
smsNumberTitle:
type: string
description: Title for phone number details
smsUsernameFormat:
type: string
description: Localized example username format shown for SMS authentication
sponsorBackLink:
type: string
description: Localized link text for returning to edit the sponsor request form
sponsorCancel:
type: string
description: Localized button label for canceling sponsor authentication
sponsorEmail:
type: string
description: Label for Sponsor Email
sponsorEmailError:
type: string
description: Localized error message shown when the sponsor email address is invalid
sponsorInfoApproved:
type: string
description: Localized status message prefix shown when a sponsor approves the request
sponsorInfoDenied:
type: string
description: Localized status message prefix shown when a sponsor denies the request
sponsorInfoPending:
type: string
description: Localized status message prefix shown after a sponsor notification is sent
sponsorName:
type: string
description: Label for Sponsor Name
sponsorNameError:
type: string
description: Localized error message shown when the sponsor name is missing
sponsorNotePending:
type: string
description: Localized additional status text shown while sponsor approval is pending
sponsorRequestAccess:
type: string
description: Submit button label request Wifi Access and notify sponsor about guest request
sponsorStatusApproved:
type: string
description: Text to display if sponsor approves request
sponsorStatusDenied:
type: string
description: Text to display when sponsor denies request
sponsorStatusPending:
type: string
description: Text to display if request is still pending
sponsorSubmit:
type: string
description: Submit button label to notify sponsor about guest request
sponsorsError:
type: string
description: Localized error message shown when no sponsor is selected
sponsorsFieldLabel:
type: string
description: Localized label for the sponsor selection field
tosAcceptLabel:
type: string
description: Prefix of the label of the link to go to tos
tosError:
type: string
description: Error message when tos not accepted
tosLink:
type: string
description: Label of the link to go to tos
tosText:
type: string
description: Text of the Terms of Service
description: Localized portal template strings for Arabic
wlan_portal_template_setting2:
title: wlan_portal_template_setting2
required:
- pageTitle
type: object
properties:
accessCodeAlternateEmail:
type: string
description: Link text for using an alternate email address during access-code login
default: Use alternate email address
alignment:
allOf:
- $ref: '#/components/schemas/portal_template_alignment3'
- description: 'Text and content alignment used by the guest portal template. enum: `center`, `left`, `right`.'
ar:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale36'
- description: Localized portal template strings for Arabic
authButtonAmazon:
type: string
description: Label for Amazon auth button
default: Sign in with Amazon
authButtonAzure:
type: string
description: Label for Azure auth button
default: Sign in with Azure
authButtonEmail:
type: string
description: Label for Email auth button
default: Sign in with Email
authButtonFacebook:
type: string
description: Label for Facebook auth button
default: Sign in with Facebook
authButtonGoogle:
type: string
description: Label for Google auth button
default: Sign in with Google
authButtonMicrosoft:
type: string
description: Label for Microsoft auth button
default: Sign in with Microsoft
authButtonPassphrase:
type: string
description: Label for passphrase auth button
default: Sign in with Passphrase
authButtonSms:
type: string
description: Label for SMS auth button
default: Sign in with Text Message
authButtonSponsor:
type: string
description: Label for Sponsor auth button
default: Sign in as Guest
authLabel:
type: string
description: Heading text displayed above portal authentication options
default: Connect to Wi-Fi with
backLink:
type: string
description: Label of the link to go back to /logon
ca-ES:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale1'
- description: Localized portal template strings for Catalan in Spain
color:
type: string
description: Primary color used by the portal template
default: '#1074bc'
colorDark:
type: string
description: Darker accent color used by the portal template
default: '#0b5183'
colorLight:
type: string
description: Lighter accent color used by the portal template
default: '#3589c6'
company:
type: boolean
description: Whether company field is required
default: false
companyError:
type: string
description: Error message when company not provided
default: Please provide your company name
companyLabel:
type: string
description: Label displayed for the company input field
default: Company
cs-CZ:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale2'
- description: Localized portal template strings for Czech in Czechia
da-DK:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale3'
- description: Localized portal template strings for Danish in Denmark
de-DE:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale4'
- description: Localized portal template strings for German in Germany
el-GR:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale5'
- description: Localized portal template strings for Greek in Greece
email:
type: boolean
description: Whether email field is required
default: false
emailAccessDomainError:
type: string
description: Error message when a user has valid social login but doesn't match specified email domains.
default: Email Access Domain Error
emailCancel:
type: string
description: Label for cancel confirmation code submission using email auth
default: Cancel
emailCodeCancel:
type: string
description: Link text for requesting help when the email access code was not received
default: I did not receive the code
emailCodeError:
type: string
description: Error message shown when the alternate email address for access-code delivery is invalid
default: Please provide valid alternate email
emailCodeFieldLabel:
type: string
description: Label for the email access-code input field
default: Access Code
emailCodeMessage:
type: string
description: Instructional text shown before entering the email access code
default: Enter the access number that was sent to your email address.
emailCodeSubmit:
type: string
description: Button label for submitting the email access code
default: Sign In
emailCodeTitle:
type: string
description: Title shown on the email access-code entry page
default: Access Code
emailError:
type: string
description: Error message when email not provided
default: Please provide valid email
emailFieldLabel:
type: string
description: Label for the email address input field
default: Enter your email address
emailLabel:
type: string
description: Label displayed for the email input field
default: Email
emailMessage:
type: string
description: Instructional text explaining email access-code delivery
default: We will email you an authentication code which you can use to connect to the Wi-Fi network.
emailSubmit:
type: string
description: Label for confirmation code submit button using email auth
default: Send Access Code
emailTitle:
type: string
description: Title for the Email registration
default: Sign in with Email
en-GB:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale6'
- description: Localized portal template strings for English in the United Kingdom
en-US:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale7'
- description: Localized portal template strings for English in the United States
es-ES:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale8'
- description: Localized portal template strings for Spanish in Spain
fi-FI:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale9'
- description: Localized portal template strings for Finnish in Finland
field1:
type: boolean
description: Whether to ask field1
default: false
field1Error:
type: string
description: Error message when field1 not provided
default: Please provide Custom Field 1
field1Label:
type: string
description: Label for custom field 1 input
default: Custom Field 1
field1Required:
type: boolean
description: Whether custom field 1 must be provided when the field is shown
field2:
type: boolean
description: Whether to ask field2
default: false
field2Error:
type: string
description: Error message when field2 not provided
default: Please provide Custom Field 2
field2Label:
type: string
description: Label for custom field 2 input
default: Custom Field 2
field2Required:
type: boolean
description: Whether custom field 2 must be provided when the field is shown
field3:
type: boolean
description: Whether to ask field3
default: false
field3Error:
type: string
description: Error message when field3 not provided
default: Please provide Custom Field 3
field3Label:
type: string
description: Label for custom field 3 input
default: Custom Field 3
field3Required:
type: boolean
description: Whether custom field 3 must be provided when the field is shown
field4:
type: boolean
description: Whether to ask field4
default: false
field4Error:
type: string
description: Error message when field4 not provided
default: Please provide Custom Field 4
field4Label:
type: string
description: Label for custom field 4 input
default: Custom Field 4
field4Required:
type: boolean
description: Whether custom field 4 must be provided when the field is shown
fr-FR:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale10'
- description: Localized portal template strings for French in France
he-IL:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale11'
- description: Localized portal template strings for Hebrew in Israel
hi-IN:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale12'
- description: Localized portal template strings for Hindi in India
hr-HR:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale13'
- description: Localized portal template strings for Croatian in Croatia
hu-HU:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale14'
- description: Localized portal template strings for Hungarian in Hungary
id-ID:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale15'
- description: Localized portal template strings for Indonesian in Indonesia
it-IT:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale16'
- description: Localized portal template strings for Italian in Italy
ja-JP:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale17'
- description: Localized portal template strings for Japanese in Japan
ko-KR:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale18'
- description: Localized portal template strings for Korean in Korea
logo:
type:
- string
- 'null'
description: Custom logo with `data:image/png;base64,` format, default null, uses Juniper Mist Logo. File size must be less than 100kB and image dimensions must be less than 500px x 200px (width x height).
examples:
- data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAZg…
logoHeight:
maximum: 200
minimum: 0
type: integer
description: Height of the logo, in px
contentEncoding: int32
examples:
- 123
logoWidth:
maximum: 500
minimum: 0
type: integer
description: Width of the logo, in px
contentEncoding: int32
examples:
- 408
marketingPolicyLink:
type: string
description: label of the link to go to /marketing_policy
default: Marketing Policy
marketingPolicyOptIn:
type: boolean
description: Whether marketing policy optin is enabled
default: false
marketingPolicyOptInLabel:
type: string
description: label for marketing optin
default: I wish to receive Marketing notifications
marketingPolicyOptInText:
type: string
description: Text of the marketing policy opt-in content
default: Marketing policy content
message:
type: string
description: Main message displayed on the guest portal sign-in page
default: Sign in to get online
ms-MY:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale19'
- description: Localized portal template strings for Malay in Malaysia
multiAuth:
type: boolean
description: Whether the portal presents multiple authentication methods
default: false
name:
type: boolean
description: Whether name field is required
default: false
nameError:
type: string
description: Error message when name not provided
default: Please provide your name
nameLabel:
type: string
description: Label displayed for the name input field
default: Name
nb-NO:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale20'
- description: Localized portal template strings for Norwegian Bokmal in Norway
nl-NL:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale21'
- description: Localized portal template strings for Dutch in the Netherlands
optOutDefault:
type: boolean
description: Default value for the `Do not store` checkbox
default: true
optout:
type: boolean
description: Whether to display Do Not Store My Personal Information
default: false
optoutLabel:
type: string
description: Label for Do Not Store My Personal Information
default: Do not store
pageTitle:
type: string
description: Browser or page title shown for the guest portal
passphraseCancel:
type: string
description: Label for the Passphrase cancel button
default: Cancel
passphraseError:
type: string
description: Error message when invalid passphrase is provided
default: Invalid Passphrase
passphraseLabel:
type: string
description: Label for the passphrase input field
default: Passphrase
passphraseMessage:
type: string
description: Instructional text shown on the passphrase sign-in page
default: Enter the secret passphrase to access the Wi-Fi network.
passphraseSubmit:
type: string
description: Label for the Passphrase submit button
default: Sign in
passphraseTitle:
type: string
description: Title for passphrase details page
default: Sign in with Passphrase
pl-PL:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale22'
- description: Localized portal template strings for Polish in Poland
poweredBy:
type: boolean
description: Whether to show \"Powered by Mist\"
default: true
privacy:
type: boolean
description: Whether to require the Privacy Term acceptance
default: false
privacyPolicyAcceptLabel:
type: string
description: Prefix of the label of the link to go to Privacy Policy
default: I accept the Privacy Terms
privacyPolicyError:
type: string
description: Error message when Privacy Policy not accepted
default: Please review and accept the Privacy Terms
privacyPolicyLink:
type: string
description: Label of the link to go to Privacy Policy
default: Privacy Terms
privacyPolicyText:
type: string
description: Text of the Privacy Policy
default: << provide your Privacy Terms here >>
pt-BR:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale23'
- description: Localized portal template strings for Portuguese in Brazil
pt-PT:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale24'
- description: Localized portal template strings for Portuguese in Portugal
requiredFieldLabel:
type: string
description: Text used to mark a form field as required
default: required
responsiveLayout:
type: boolean
description: Whether the portal template uses a responsive layout
default: true
ro-RO:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale25'
- description: Localized portal template strings for Romanian in Romania
ru-RU:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale26'
- description: Localized portal template strings for Russian in Russia
signInLabel:
type: string
description: Label of the button to signin
default: Sign In
sk-SK:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale27'
- description: Localized portal template strings for Slovak in Slovakia
smsCarrierDefault:
type: string
description: Default option text shown in the SMS carrier selector
default: Please Select
smsCarrierError:
type: string
description: Error message shown when no mobile carrier is selected
default: Please select a mobile carrier
smsCarrierFieldLabel:
type: string
description: Label for mobile carrier drop-down list
default: Mobile Carrier
smsCodeCancel:
type: string
description: Label for cancel confirmation code submission
default: I did not receive the code
smsCodeError:
type: string
description: Error message when confirmation code is invalid
default: Invalid Access Code
smsCodeFieldLabel:
type: string
description: Label for the SMS confirmation-code input field
default: Confirmation Code
smsCodeMessage:
type: string
description: Instructional text shown before entering the SMS access code
default: Enter the access number that was sent to your mobile number.
smsCodeSubmit:
type: string
description: Label for confirmation code submit button
default: Sign In
smsCodeTitle:
type: string
description: Title shown on the SMS access-code entry page
default: Access Code
smsCountryFieldLabel:
type: string
description: Label for the SMS country-code input field
default: Country Code
smsCountryFormat:
type: string
description: Example country code format shown for SMS authentication
default: '+1'
smsHaveAccessCode:
type: string
description: Label for checkbox to specify that the user has access code
default: I have an access code
smsIsTwilio:
type: boolean
description: Whether the SMS portal flow uses Twilio-specific behavior
default: false
smsMessageFormat:
type: string
description: Format of access code sms message. {{code}} and {{duration}} are placeholders and should be retained as is.
smsNumberCancel:
type: string
description: Label for canceling mobile details for SMS auth
default: Cancel
smsNumberError:
type: string
description: Error message shown when the mobile number is invalid
default: Invalid Mobile Number
smsNumberFieldLabel:
type: string
description: Label for field to provide mobile number
default: Mobile Number
smsNumberFormat:
type: string
description: Example mobile number format shown for SMS authentication
default: 2125551212 (digits only)
smsNumberMessage:
type: string
description: Instructional text explaining SMS access-code delivery
default: We will send an access code to your mobile number which you can use to connect to the Wi-Fi network. Message and data rates may apply.
smsNumberSubmit:
type: string
description: Label for submit button for code generation
default: Send Access Code
smsNumberTitle:
type: string
description: Title for phone number details
default: Sign in with Text Message
smsUsernameFormat:
type: string
description: Example username format shown for SMS authentication
default: username
smsValidityDuration:
maximum: 30
minimum: 1
type: integer
description: How long confirmation code should be considered valid (in minutes)
contentEncoding: int32
sponsorBackLink:
type: string
description: Link text for returning to edit the sponsor request form
default: Go back and edit request form
sponsorCancel:
type: string
description: Button label for canceling sponsor authentication
default: Cancel
sponsorEmail:
type: string
description: Label for Sponsor Email
default: Sponsor Email
sponsorEmailError:
type: string
description: Error message shown when the sponsor email address is invalid
default: Please provide valid sponsor email
sponsorEmailTemplate:
type: string
description: "HTML template to replace/override default sponsor email template \nSponsor Email Template supports following template variables:\n * `approve_url`: Renders URL to approve the request; optionally &minutes=N query param can be appended to change the Authorization period of the guest, where N is a valid integer denoting number of minutes a guest remains authorized\n * `deny_url`: Renders URL to reject the request\n * `guest_email`: Renders Email ID of the guest\n * `guest_name`: Renders Name of the guest\n * `field1`: Renders value of the Custom Field 1\n * `field2`: Renders value of the Custom Field 2\n * `sponsor_link_validity_duration`: Renders validity time of the request (i.e. Approve/Deny URL)\n * `auth_expire_minutes`: Renders Wlan-level configured Guest Authorization Expiration time period (in minutes), If not configured then default (1 day in minutes)"
sponsorInfoApproved:
type: string
description: Status message prefix shown when a sponsor approves the request
default: Your request was approved by
sponsorInfoDenied:
type: string
description: Status message prefix shown when a sponsor denies the request
default: Your request was denied by
sponsorInfoPending:
type: string
description: Status message prefix shown after a sponsor notification is sent
default: Your notification has been sent to
sponsorName:
type: string
description: Label for Sponsor Name
default: Sponsor Name
sponsorNameError:
type: string
description: Error message shown when the sponsor name is missing
default: Please provide sponsor name
sponsorNotePending:
type: string
description: Additional status text shown while sponsor approval is pending
default: Please wait for them to acknowledge.
sponsorRequestAccess:
type: string
description: Submit button label request Wifi Access and notify sponsor about guest request
default: Request Wi-Fi Access
sponsorStatusApproved:
type: string
description: Text to display if sponsor approves request
default: Your request was approved
sponsorStatusDenied:
type: string
description: Text to display when sponsor denies request
default: Your request was denied
sponsorStatusPending:
type: string
description: Text to display if request is still pending
default: Notification Sent
sponsorSubmit:
type: string
description: Submit button label to notify sponsor about guest request
default: Request Wi-Fi Access
sponsorsError:
type: string
description: Error message shown when no sponsor is selected
default: Please select a sponsor
sponsorsFieldLabel:
type: string
description: Label for the sponsor selection field
default: Sponsors
sv-SE:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale28'
- description: Localized portal template strings for Swedish in Sweden
th-TH:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale29'
- description: Localized portal template strings for Thai in Thailand
tos:
type: boolean
description: Whether the portal requires Terms of Service acceptance
default: true
tosAcceptLabel:
type: string
description: Prefix of the label of the link to go to tos
default: I accept the Terms of Service
tosError:
type: string
description: Error message when tos not accepted
default: Please review and accept the Terms of Service
tosLink:
type: string
description: Label of the link to go to tos
default: Terms of Service
tosText:
type: string
description: Text of the Terms of Service
default: << provide your Terms of Service here >>
tr-TR:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale30'
- description: Localized portal template strings for Turkish in Turkey
uk-UA:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale31'
- description: Localized portal template strings for Ukrainian in Ukraine
vi-VN:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale32'
- description: Localized portal template strings for Vietnamese in Vietnam
zh-Hans:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale33'
- description: Localized portal template strings for Simplified Chinese
zh-Hant:
allOf:
- $ref: '#/components/schemas/wlan_portal_template_setting_locale34'
- description: Localized portal template strings for Traditional Chinese
description: Template settings that define guest portal text, layout, and localization
wlan_portal2:
title: wlan_portal2
type: object
properties:
allow_wlan_id_roam:
type: boolean
description: Optional if `amazon_enabled`==`true`. Whether to allow guest to connect to other Guest WLANs (with different `WLAN.ssid`) of same org without reauthentication (disable random_mac for seamless roaming)
default: false
amazon_client_id:
type:
- string
- 'null'
description: Optional if `amazon_enabled`==`true`. Amazon OAuth2 client id. This is optional. If not provided, it will use a default one.
amazon_client_secret:
type:
- string
- 'null'
description: Optional if `amazon_enabled`==`true`. Amazon OAuth2 client secret. If amazon_client_id was provided, provide a corresponding value. Else leave blank.
contentEncoding: password
amazon_email_domains:
type: array
items:
type: string
description: Optional if `amazon_enabled`==`true`. Email domains allowed for Amazon-authenticated guest users. If null or empty, any authenticated Amazon email domain is allowed.
default: []
amazon_enabled:
type: boolean
description: Whether amazon is enabled as a login method
default: false
amazon_expire:
type:
- integer
- 'null'
description: Optional if `amazon_enabled`==`true`. Interval for which guest remains authorized using amazon auth (in minutes), if not provided, uses expire`
contentEncoding: int32
auth:
allOf:
- $ref: '#/components/schemas/wlan_portal_auth2'
- description: 'Guest portal login scheme used by the WLAN. enum: `amazon`, `azure`, `email`, `external`, `facebook`, `google`, `microsoft`, `multi`, `none`, `password`, `sms`, `sponsor`, `sso`.'
examples:
- none
azure_client_id:
type:
- string
- 'null'
description: Required if `azure_enabled`==`true`. Azure active directory app client id
azure_client_secret:
type:
- string
- 'null'
description: Required if `azure_enabled`==`true`. Azure active directory app client secret
contentEncoding: password
azure_enabled:
type: boolean
description: Whether Azure Active Directory is enabled as a login method
default: false
azure_expire:
type:
- integer
- 'null'
description: Interval for which guest remains authorized using azure auth (in minutes), if not provided, uses expire`
contentEncoding: int32
azure_tenant_id:
type:
- string
- 'null'
description: Required if `azure_enabled`==`true`. Azure active directory tenant id.
broadnet_password:
type: string
description: Required if `sms_provider`==`broadnet`. Password for the Broadnet SMS provider account
contentEncoding: password
examples:
- password
broadnet_sid:
type: string
description: Required if `sms_provider`==`broadnet`. SID for the Broadnet SMS provider account
examples:
- MIST
broadnet_user_id:
type: string
description: Required if `sms_provider`==`broadnet`. User ID for the Broadnet SMS provider account
examples:
- juniper
bypass_when_cloud_down:
type: boolean
description: Whether to bypass the guest portal when cloud not reachable (and apply the default policies)
default: false
clickatell_api_key:
type: string
description: Required if `sms_provider`==`clickatell`. API key for the Clickatell SMS provider account
cross_site:
type: boolean
description: Whether to allow guest to roam between WLANs (with same `WLAN.ssid`, regardless of variables) of different sites of same org without reauthentication (disable random_mac for seamless roaming)
default: false
email_enabled:
type: boolean
description: Whether email (access code verification) is enabled as a login method
default: false
enabled:
type: boolean
description: Whether guest portal is enabled
default: false
expire:
type: integer
description: How long to remain authorized, in minutes
contentEncoding: int32
default: 1440
examples:
- 1440
external_portal_url:
type: string
description: Required if `wlan_portal_auth`==`external`. External portal URL (e.g. https://host/url) where we can append our query parameters to
facebook_client_id:
type:
- string
- 'null'
description: Required if `facebook_enabled`==`true`. Facebook OAuth2 app id. This is optional. If not provided, it will use a default one.
facebook_client_secret:
type:
- string
- 'null'
description: Required if `facebook_enabled`==`true`. Facebook OAuth2 app secret. If facebook_client_id was provided, provide a corresponding value. Else leave blank.
contentEncoding: password
facebook_email_domains:
type: array
items:
type: string
description: Optional if `facebook_enabled`==`true`. Email domains allowed for Facebook-authenticated guest users. If null or empty, any authenticated Facebook email domain is allowed.
default: []
facebook_enabled:
type: boolean
description: Whether facebook is enabled as a login method
default: false
facebook_expire:
type:
- integer
- 'null'
description: Optional if `facebook_enabled`==`true`. Interval for which guest remains authorized using facebook auth (in minutes), if not provided, uses expire`
contentEncoding: int32
forward:
type: boolean
description: Whether to forward the user to another URL after authorized
default: false
forward_url:
type:
- string
- 'null'
description: URL to forward the user to
examples:
- https://abc.com/promotions
google_client_id:
type:
- string
- 'null'
description: Google OAuth2 app id. This is optional. If not provided, it will use a default one.
google_client_secret:
type:
- string
- 'null'
description: Optional if `google_enabled`==`true`. Google OAuth2 app secret. If google_client_id was provided, provide a corresponding value. Else leave blank.
contentEncoding: password
google_email_domains:
type: array
items:
type: string
description: Optional if `google_enabled`==`true`. Email domains allowed for Google-authenticated guest users. If null or empty, any authenticated Google email domain is allowed.
default: []
examples:
- - mydomain.edu
- mydomain.org
google_enabled:
type: boolean
description: Whether Google is enabled as login method
default: false
google_expire:
type:
- integer
- 'null'
description: Optional if `google_enabled`==`true`. Interval for which guest remains authorized using Google Auth (in minutes), if not provided, uses expire`
contentEncoding: int32
gupshup_password:
type: string
description: Required if `sms_provider`==`gupshup`. Password for the Gupshup SMS provider account
contentEncoding: password
gupshup_userid:
type: string
description: Required if `sms_provider`==`gupshup`. User ID for the Gupshup SMS provider account
microsoft_client_id:
type:
- string
- 'null'
description: Optional if `microsoft_enabled`==`true`. Microsoft 365 OAuth2 client id. This is optional. If not provided, it will use a default one.
microsoft_client_secret:
type:
- string
- 'null'
description: Optional if `microsoft_enabled`==`true`. Microsoft 365 OAuth2 client secret. If microsoft_client_id was provided, provide a corresponding value. Else leave blank.
contentEncoding: password
microsoft_email_domains:
type: array
items:
type: string
description: Optional if `microsoft_enabled`==`true`. Email domains allowed for Microsoft 365-authenticated guest users. If null or empty, any authenticated Microsoft 365 email domain is allowed.
default: []
microsoft_enabled:
type: boolean
description: Whether microsoft 365 is enabled as a login method
default: false
microsoft_expire:
type:
- integer
- 'null'
description: Optional if `microsoft_enabled`==`true`. Interval for which guest remains authorized using microsoft auth (in minutes), if not provided, uses expire`
contentEncoding: int32
passphrase_enabled:
type: boolean
description: Whether password is enabled
default: false
passphrase_expire:
type:
- integer
- 'null'
description: Optional if `passphrase_enabled`==`true`. Interval for which guest remains authorized using passphrase auth (in minutes), if not provided, uses `expire`
contentEncoding: int32
password:
type:
- string
- 'null'
description: Required if `passphrase_enabled`==`true`. Passphrase guests must enter when passphrase authentication is enabled
examples:
- let me in
predefined_sponsors_enabled:
type: boolean
description: Whether to show list of sponsor emails mentioned in `sponsors` object as a dropdown. If both `sponsor_notify_all` and `predefined_sponsors_enabled` are false, behavior is acc to `sponsor_email_domains`
default: true
predefined_sponsors_hide_email:
type: boolean
description: Whether to hide sponsor’s email from list of sponsors
default: false
privacy:
type: boolean
description: Whether to show the privacy policy in the WLAN guest portal
default: false
puzzel_password:
type: string
description: Required if `sms_provider`==`puzzel`. Password for the Puzzel SMS provider account
contentEncoding: password
puzzel_service_id:
type: string
description: Required if `sms_provider`==`puzzel`. Service ID for the Puzzel SMS provider account
puzzel_username:
type: string
description: Required if `sms_provider`==`puzzel`. Username for the Puzzel SMS provider account
smsMessageFormat:
type: string
description: Optional if `sms_enabled`==`true`. SMS Message format
default: Code {{code}} expires in {{duration}} minutes.
sms_enabled:
type: boolean
description: Whether sms is enabled as a login method
default: false
sms_expire:
type:
- integer
- 'null'
description: Optional if `sms_enabled`==`true`. Interval for which guest remains authorized using sms auth (in minutes), if not provided, uses expire`
contentEncoding: int32
sms_provider:
allOf:
- $ref: '#/components/schemas/wlan_portal_sms_provider2'
- description: 'Optional if `sms_enabled`==`true`. SMS provider used to deliver guest portal access codes. enum: `broadnet`, `clickatell`, `gupshup`, `manual`, `puzzel`, `telstra`, `twilio`, `smsglobal`.'
examples:
- twilio
smsglobal_api_key:
type: string
description: Required if `sms_provider`==`smsglobal`, Client API Key
smsglobal_api_secret:
type: string
description: Required if `sms_provider`==`smsglobal`, Client secret
contentEncoding: password
smsglobal_sender:
type: string
description: Optional sender's number or sender ID for SMSGlobal. If not provided, uses the default number associated with the account
sponsor_auto_approve:
type: boolean
description: Optional if `sponsor_enabled`==`true`. Whether to automatically approve guest and allow sponsor to revoke guest access, needs predefined_sponsors_enabled enabled and sponsor_notify_all disabled
default: false
sponsor_email_domains:
type: array
items:
type: string
description: Email domains allowed for sponsor email addresses. Required if `sponsor_enabled` is `true` and `sponsors` is empty.
examples:
- - reserved.net
- reserved.org
sponsor_enabled:
type: boolean
description: Whether sponsor is enabled
default: false
sponsor_expire:
type:
- integer
- 'null'
description: Optional if `sponsor_enabled`==`true`. Interval for which guest remains authorized using sponsor auth (in minutes), if not provided, uses expire`
contentEncoding: int32
sponsor_link_validity_duration:
anyOf:
- maximum: 60
minimum: 5
type: integer
contentEncoding: int32
default: 60
- type: string
description: Optional if `sponsor_enabled`==`true`. Validity duration, in minutes, for approve or deny links in sponsor emails. Valid values are 5 to 60.
sponsor_notify_all:
type: boolean
description: Optional if `sponsor_enabled`==`true`. whether to notify all sponsors that are mentioned in `sponsors` object. Both `sponsor_notify_all` and `predefined_sponsors_enabled` should be true in order to notify sponsors. If true, email sent to 10 sponsors in no particular order.
default: false
sponsor_status_notify:
type: boolean
description: Optional if `sponsor_enabled`==`true`. If enabled, guest will get email about sponsor's action (approve/deny)
default: false
sponsors:
oneOf:
- type: array
items:
type: string
- type: object
additionalProperties:
type: string
examples:
- sponsor1@company.com: FirstName1 LastName1
sponsor2@company.com: FirstName2 LastName2
description: Allowed sponsor email addresses and display names. Required if `sponsor_enabled` is `true` and `sponsor_email_domains` is empty.
sso_default_role:
type: string
description: Optional if `wlan_portal_auth`==`sso`, default role to assign if there’s no match. By default, an assertion is treated as invalid when there’s no role matched
sso_forced_role:
type: string
description: Optional if `wlan_portal_auth`==`sso`. Role assigned to authenticated users when guest SSO is used
sso_idp_cert:
type: string
description: Required if `wlan_portal_auth`==`sso`. IDP Cert (used to verify the signed response)
sso_idp_sign_algo:
allOf:
- $ref: '#/components/schemas/wlan_portal_idp_sign_algo2'
- description: 'Optional if `wlan_portal_auth`==`sso`. Signing algorithm used for SAML assertions from the identity provider. enum: `sha1`, `sha256`, `sha384`, `sha512`.'
sso_idp_sso_url:
type: string
description: Required if `wlan_portal_auth`==`sso`, IDP Single-Sign-On URL
sso_issuer:
type: string
description: Required if `wlan_portal_auth`==`sso`, IDP issuer URL
sso_nameid_format:
allOf:
- $ref: '#/components/schemas/wlan_portal_sso_nameid_format2'
- description: 'Optional if `wlan_portal_auth`==`sso`. SAML NameID format expected from the identity provider. enum: `email`, `unspecified`.'
telstra_client_id:
type: string
description: Required if `sms_provider`==`telstra`, Client ID provided by Telstra
telstra_client_secret:
type: string
description: Required if `sms_provider`==`telstra`, Client secret provided by Telstra
contentEncoding: password
twilio_auth_token:
type:
- string
- 'null'
description: Required if `sms_provider`==`twilio`, Auth token account with twilio account
contentEncoding: password
examples:
- af9dac44c344a875ab5d31cb7abcdefg
twilio_phone_number:
type:
- string
- 'null'
description: Required if `sms_provider`==`twilio`, Twilio phone number associated with the account. See example for accepted format.
examples:
- '+18548888888'
twilio_sid:
type:
- string
- 'null'
description: Required if `sms_provider`==`twilio`, Account SID provided by Twilio
examples:
- af9dac44c344a875ab5d31cb7abcdefg
description: Guest portal settings for this WLAN
wlan_qos_class2:
title: wlan_qos_class2
enum:
- background
- best_effort
- video
- voice
type: string
description: 'QoS traffic class applied when WLAN QoS override is enabled. enum: `background`, `best_effort`, `video`, `voice`.'
examples:
- best_effort
wlan_qos2:
title: wlan_qos2
type: object
properties:
class:
allOf:
- $ref: '#/components/schemas/wlan_qos_class2'
- description: 'QoS traffic class applied when WLAN QoS override is enabled. enum: `background`, `best_effort`, `video`, `voice`.'
examples:
- best_effort
overwrite:
type: boolean
description: Whether to overwrite QoS
default: false
description: Quality-of-service settings for WLAN client traffic
wlan_roam_mode2:
title: wlan_roam_mode2
enum:
- 11r
- NONE
- OKC
type: string
description: 'Fast roaming mode configured for this WLAN. enum: `11r`, `NONE`, `OKC`.'
examples:
- NONE
wlan_schedule2:
title: wlan_schedule2
type: object
properties:
enabled:
type: boolean
description: Whether the WLAN operating schedule is enabled
default: false
hours:
allOf:
- $ref: '#/components/schemas/hours2'
- description: Time ranges when the WLAN is scheduled to operate
description: Operating schedule controlling when this WLAN is active
wxlan_rule_action2:
title: wxlan_rule_action2
enum:
- allow
- block
type: string
description: Allow or block behavior applied by this WxLAN rule
examples:
- allow
wxlan_tag_match2:
title: wxlan_tag_match2
enum:
- ap_id
- app
- asset_mac
- client_mac
- hostname
- ip_range_subnet
- port
- psk_name
- psk_role
- radius_attr
- radius_class
- radius_group
- radius_username
- sdkclient_uuid
- wlan_id
type: string
description: 'Required if `type`==`match`; attribute compared against `values`. enum: `ap_id`, `app`, `asset_mac`, `client_mac`, `hostname`, `ip_range_subnet`, `port`, `psk_name`, `psk_role`, `radius_attr`, `radius_class`, `radius_group`, `radius_username`, `sdkclient_uuid`, `wlan_id`.'
wxlan_tag_operation2:
title: wxlan_tag_operation2
enum:
- in
- not_in
type: string
description: 'Required if `type`==`match`; whether `values` are inclusive or exclusive matches. enum: `in`, `not_in`.'
wxlan_tag_type2:
title: wxlan_tag_type2
enum:
- client
- match
- resource
- spec
- subnet
- vlan
type: string
description: 'Kind of WxLAN tag and how it is populated. enum: `client`, `match`, `resource`, `spec`, `subnet`, `vlan`.'
wxlan_tunnel_dmvpn2:
title: wxlan_tunnel_dmvpn2
type: object
properties:
enabled:
type: boolean
description: Whether DMVPN is enabled
default: false
holding_time:
type: integer
description: Optional; the holding time for NHRP ‘registration requests’ and ‘resolution replies’ sent from the Mist AP (in seconds); default 600
contentEncoding: int32
host_routes:
type: array
items:
type: string
description: IPv4 DMVPN peer host routes to which traffic is forwarded
description: Settings for Dynamic Multipoint VPN on this WxLAN tunnel
wxlan_tunnel_ipsec2:
title: wxlan_tunnel_ipsec2
required:
- psk
type: object
properties:
enabled:
type: boolean
description: Whether ipsec is enabled, requires DMVPN be enabled
default: false
psk:
type: string
description: Pre-shared key used for IPsec on this WxLAN tunnel
description: Security settings for IPsec on this WxLAN tunnel; requires DMVPN to be enabled
wxlan_tunnel_session_ethertype2:
title: wxlan_tunnel_session_ethertype2
enum:
- ethernet
- vlan
type: string
description: 'Frame type carried by this tunnel session. enum: `ethernet`, `vlan`.'
account_oauth_add:
oneOf:
- $ref: '#/components/schemas/account_jamf_config'
- $ref: '#/components/schemas/account_vmware_config'
- $ref: '#/components/schemas/account_mobicontrol_config'
- $ref: '#/components/schemas/account_zdx_config'
- $ref: '#/components/schemas/account_crowdstrike_config'
- $ref: '#/components/schemas/account_prisma_config'
- $ref: '#/components/schemas/account_sentinelone_config'
description: Account configuration payload for adding a supported OAuth-linked application
additional_vlan_ids:
anyOf:
- type: string
- type: array
items:
$ref: '#/components/schemas/vlan_id_with_variable'
description: List or Comma separated list of additional VLAN IDs (on the LAN side or from other WLANs) should we be forwarding bonjour queries/responses
additional_vlan_ids_array:
allOf:
- $ref: '#/components/schemas/vlan_id_with_variable'
- description: Additional VLAN IDs represented as an array
ap_switch_setting_port_vlan_id:
anyOf:
- maximum: 4094
minimum: 1
type: integer
contentEncoding: int32
- type: string
description: Native VLAN ID, optional
bgp_as:
anyOf:
- type: string
- maximum: 4294967294
minimum: 1
type: integer
contentEncoding: int32
description: BGP AS, value in range 1-4294967294. Can be a Variable (e.g. `{{bgp_as}}` )
examples:
- '65000'
bgp_local_as:
anyOf:
- type: string
- maximum: 4294967295
minimum: 1
type: integer
contentEncoding: int32
description: Required if `via`==`lan`, `via`==`tunnel` or `via`==`wan`. BGP AS, value in range 1-4294967295
examples:
- '65000'
capture_org:
oneOf:
- $ref: '#/components/schemas/capture_mxedge'
description: Packet capture request payload for organization-level captures
capture_site:
oneOf:
- $ref: '#/components/schemas/capture_client'
- $ref: '#/components/schemas/capture_gateway'
- $ref: '#/components/schemas/capture_new_assoc'
- $ref: '#/components/schemas/capture_radiotap'
- $ref: '#/components/schemas/capture_radiotapwired'
- $ref: '#/components/schemas/capture_scan'
- $ref: '#/components/schemas/capture_switch'
- $ref: '#/components/schemas/capture_wired'
- $ref: '#/components/schemas/capture_wireless'
description: Packet capture request payload for site-level captures
discriminator:
propertyName: type
mapping:
client: capture_client
gateway: capture_gateway
new_assoc: capture_new_assoc
radiotap: capture_radiotap
radiotap,wired: capture_radiotapwired
scan: capture_scan
switch: capture_switch
wired: capture_wired
wireless: capture_wireless
config_device:
oneOf:
- $ref: '#/components/schemas/device_ap'
- $ref: '#/components/schemas/device_switch'
- $ref: '#/components/schemas/device_gateway'
description: Device configuration object for an AP, switch, or gateway
discriminator:
propertyName: type
mapping:
ap: device_ap
gateway: device_gateway
switch: device_switch
config_devices:
allOf:
- $ref: '#/components/schemas/config_device'
- description: List of device configuration objects
const_device_model:
oneOf:
- $ref: '#/components/schemas/const_device_ap'
- $ref: '#/components/schemas/const_device_switch'
- $ref: '#/components/schemas/const_device_gateway'
description: Device model definition returned by the constants API
discriminator:
propertyName: type
mapping:
ap: const_device_ap
gateway: const_device_switch
switch: const_device_gateway
const_device_models:
allOf:
- $ref: '#/components/schemas/const_device_model'
- description: Device model definitions returned by the constants API
const_insight_metrics_property_example:
anyOf:
- type: integer
contentEncoding: int32
- type: number
- type: string
- type: boolean
- type: object
description: Example value for an insight metric property
const_insight_metrics_property_example_any_of1:
anyOf:
- type: array
items:
$ref: '#/components/schemas/const_insight_metrics_property_example'
- type: object
additionalProperties:
type: array
items:
$ref: '#/components/schemas/const_insight_metrics_property_example'
description: Example values for an insight metric property, as an array or keyed object
const_insight_metrics_property_examples:
allOf:
- $ref: '#/components/schemas/const_insight_metrics_property_example'
- description: List of example values for an insight metric property
const_insight_metrics_property_examples_object:
allOf:
- $ref: '#/components/schemas/const_insight_metrics_property_example'
- description: Object containing named fields, each with array of example values
deviceprofile:
oneOf:
- $ref: '#/components/schemas/deviceprofile_ap'
- $ref: '#/components/schemas/deviceprofile_gateway'
- $ref: '#/components/schemas/deviceprofile_switch'
description: Device profile configuration for an AP, switch, or gateway
discriminator:
propertyName: type
mapping:
ap: deviceprofile_ap
gateway: deviceprofile_gateway
switch: deviceprofile_switch
deviceprofiles:
allOf:
- $ref: '#/components/schemas/deviceprofile'
- description: List of device profile configurations
dscp:
anyOf:
- type: string
- maximum: 63
minimum: 0
type: integer
contentEncoding: int32
description: DSCP value range between 0 and 63
gateway_port_config_reth_idx:
anyOf:
- type: integer
contentEncoding: int32
- type: string
description: 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 all ports.
gateway_port_vlan_id_with_variable:
oneOf:
- type: string
- maximum: 4094
minimum: 1
type: integer
contentEncoding: int32
description: If WAN interface is on a VLAN. Can be the VLAN ID (i.e. "10") or a Variable (i.e. "{{myvar}}")
insight_metrics_results:
allOf:
- $ref: '#/components/schemas/insight_metrics_results_item'
- description: Results depends on the `metric` - some return numbers (e.g. bytes, ap-count), others return objects
insight_metrics_results_item:
anyOf:
- type: number
- type: object
description: Insight metric result item, returned either as a number or an object depending on the requested metric
mist_device:
oneOf:
- $ref: '#/components/schemas/device_ap'
- $ref: '#/components/schemas/device_switch'
- $ref: '#/components/schemas/device_gateway'
description: Mist-managed device object for an AP, switch, or gateway
discriminator:
propertyName: type
mapping:
ap: device_ap
gateway: device_gateway
switch: device_switch
mxedge_tunterm_igmp_snooping_config_vlan_ids:
anyOf:
- type: array
items:
maximum: 4096
minimum: 0
type: integer
contentEncoding: int32
- type: string
description: List of VLAN IDs where tunnel termination performs IGMP snooping
mxedge_tunterm_switch_config_vlan_ids:
allOf:
- $ref: '#/components/schemas/vlan_id_with_variable'
- description: Tagged VLAN IDs allowed on a tunnel termination switch port
nac_tag_gbp_tag:
anyOf:
- maximum: 65535
minimum: 1
type: integer
contentEncoding: int32
- type: string
description: If `type`==`gbp_tag`, GBP tag value returned by the NAC rule
next_hop_via:
oneOf:
- type: string
- type: array
items:
type: string
description: 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.
examples:
- 10.2.1.1
- >-
[
"10.2.1.1",
"10.2.1.2"
]
number_or_null:
oneOf:
- type: number
description: Numeric value or null
psk_vlan_id:
oneOf:
- type: string
- maximum: 4094
minimum: 1
type: integer
contentEncoding: int32
description: VLAN for this PSK key
radius_acct_port:
anyOf:
- maximum: 65545
minimum: 1
type: integer
contentEncoding: int32
- type: string
description: RADIUS Auth Port, value from 1 to 65535, default is 1813
radius_auth_port:
anyOf:
- maximum: 65545
minimum: 1
type: integer
contentEncoding: int32
- type: string
description: RADIUS Auth Port, value from 1 to 65535, default is 1812
radius_coa_port:
anyOf:
- maximum: 65545
minimum: 1
type: integer
contentEncoding: int32
- type: string
description: RADIUS CoA Port, value from 1 to 65535, default is 3799
radsec_idle_timeout:
anyOf:
- type: integer
contentEncoding: int32
default: 60
- type: string
description: RadSec idle timeout in seconds. Default is 60
remote_syslog_archive_files:
anyOf:
- type: string
- type: integer
contentEncoding: int32
description: Number of archived syslog files to retain
examples:
- '20'
remote_syslog_server_port:
anyOf:
- maximum: 65545
minimum: 1
type: integer
contentEncoding: int32
default: 514
- type: string
description: Syslog Service Port, value from 1 to 65535
response_device_metrics_results:
allOf:
- $ref: '#/components/schemas/response_device_metrics_results_items'
- description: Device metric result values aligned with the response timestamps
response_device_metrics_results_items:
oneOf:
- type: string
- type: integer
contentEncoding: int32
description: Device metric result value, returned as a string or integer
response_device_search_results:
allOf:
- $ref: '#/components/schemas/response_device_search_results_items'
- description: Device search records for APs, switches, or gateways
response_device_search_results_items:
oneOf:
- $ref: '#/components/schemas/ap_search'
- $ref: '#/components/schemas/switch_search'
- $ref: '#/components/schemas/gateway_search'
description: Device search record for an AP, switch, or gateway
response_org_site_sle:
oneOf:
- $ref: '#/components/schemas/org_site_sle_wifi'
- $ref: '#/components/schemas/org_site_wired_wifi'
- $ref: '#/components/schemas/org_site_wan_wifi'
description: Organization site SLE response for Wi-Fi, wired, or WAN
response_tunnel_search_item:
oneOf:
- $ref: '#/components/schemas/stats_mxtunnel'
- $ref: '#/components/schemas/stats_wan_tunnel'
description: Tunnel statistics record; shape depends on the requested tunnel type
response_tunnel_search_results:
allOf:
- $ref: '#/components/schemas/response_tunnel_search_item'
- description: Tunnel statistics records returned by search
routing_policy_local_preference:
anyOf:
- type: string
- maximum: 4294967295
minimum: 1
type: integer
contentEncoding: int32
description: Optional, for an import policy, local_preference can be changed, value in range 1-4294967294. Can be a Variable (e.g. `{{bgp_as}}`)
routing_policy_term_matching_as_path:
allOf:
- $ref: '#/components/schemas/bgp_as'
- description: BGP AS path values used as routing-policy match criteria
service_dscp:
oneOf:
- type: string
- maximum: 63
minimum: 0
type: integer
contentEncoding: int32
description: For SSR only, when `traffic_type`==`custom`. 0-63 or variable
service_max_jitter:
oneOf:
- type: string
- maximum: 2147483647
minimum: 0
type: integer
contentEncoding: int32
description: For SSR only, when `traffic_type`==`custom`, for uplink selection. 0-2147483647 or variable
service_max_latency:
oneOf:
- type: string
- maximum: 2147483647
minimum: 0
type: integer
contentEncoding: int32
description: For SSR only, when `traffic_type`==`custom`, for uplink selection. 0-2147483647 or variable
service_max_loss:
oneOf:
- type: string
- maximum: 100
minimum: 0
type: integer
contentEncoding: int32
description: For SSR only, when `traffic_type`==`custom`, for uplink selection. 0-100 or variable
sle_classifier_samples_degraded:
allOf:
- $ref: '#/components/schemas/number_or_null'
- description: Per-interval degraded SLE values for a classifier
sle_classifier_samples_total:
allOf:
- $ref: '#/components/schemas/number_or_null'
- description: Per-interval total SLE values for a classifier
sle_summary_sle_samples_degraded:
allOf:
- $ref: '#/components/schemas/number_or_null'
- description: Per-interval degraded SLE values for a summary
sle_summary_sle_samples_total:
allOf:
- $ref: '#/components/schemas/number_or_null'
- description: Per-interval total SLE values for a summary
sle_summary_sle_samples_value:
allOf:
- $ref: '#/components/schemas/number_or_null'
- description: Per-interval SLE score values for a summary
sponsor_link_validity_duration:
anyOf:
- maximum: 60
minimum: 5
type: integer
contentEncoding: int32
default: 60
- type: string
description: Optional if `sponsor_enabled`==`true`. How long to remain valid sponsored guest request approve/deny link received in email, in minutes. Value is between 5 and 60.
stats_client:
oneOf:
- $ref: '#/components/schemas/stats_wireless_client'
- $ref: '#/components/schemas/stats_wired_client'
description: Client statistics record for a wireless or wired client
stats_client_any_of:
allOf:
- $ref: '#/components/schemas/stats_client'
- description: Client statistics records returned by a stats response
stats_device:
oneOf:
- $ref: '#/components/schemas/stats_ap'
- $ref: '#/components/schemas/stats_switch'
- $ref: '#/components/schemas/stats_gateway'
description: Device statistics record for an AP, switch, or gateway
discriminator:
propertyName: type
mapping:
ap: stats_ap
gateway: stats_gateway
switch: stats_switch
stats_devices:
allOf:
- $ref: '#/components/schemas/stats_device'
- description: Device statistics records returned by a stats response
switch_bgp_config_hold_time:
oneOf:
- $ref: '#/components/schemas/switch_bgp_config_hold_time_zero'
- maximum: 65535
minimum: 3
type: integer
contentEncoding: int32
description: 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 valid. Must be 0 or a number in the range 3-65535.
switch_mgmt_mxedge_proxy_port:
anyOf:
- maximum: 65535
minimum: 1
type: integer
contentEncoding: int32
default: 2222
- type: string
description: Mist Edge port used to proxy the switch management traffic to the Mist Cloud. Value in range 1-65535
switch_ospf_config_reference_bandwidth:
anyOf:
- type: integer
contentEncoding: int32
- type: string
description: Reference bandwidth. Integer(100000) or String (10g)
examples:
- '100000'
switch_port_usage_mac_limit:
anyOf:
- maximum: 16383
minimum: 0
type: integer
contentEncoding: int32
default: 0
- type: string
description: 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_port_usage_mac_limit_overwrite:
anyOf:
- maximum: 16383
minimum: 0
type: integer
contentEncoding: int32
default: 0
- type: string
description: Max number of MAC addresses, default is 0 for unlimited, otherwise range is 1 to 16383 (upper bound constrained by platform)
switch_port_usage_mtu:
anyOf:
- maximum: 9216
minimum: 256
type: integer
contentEncoding: int32
- type: string
description: 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.
switch_port_usage_reauth_interval:
anyOf:
- maximum: 65535
minimum: 10
type: integer
contentEncoding: int32
default: 3600
- type: string
description: 'Only if `mode`!=`dynamic` and `port_auth`=`dot1x` reauthentication interval range (min: 10, max: 65535, default: 3600). Set to 0 to disable reauthentication (no-reauthentication).'
synthetictest_config_vlan_vlan_ids:
allOf:
- $ref: '#/components/schemas/vlan_id_with_variable'
- description: VLAN identifiers where deprecated VLAN-based synthetic probes run
synthetictest_device_vlan_id:
oneOf:
- type: string
- maximum: 4094
minimum: 1
type: integer
contentEncoding: int32
description: Required for AP. VLAN ID used by the synthetic test when the target device is an AP
tunterm_port_config_upstream_port_vlan_id:
oneOf:
- type: string
- maximum: 4094
minimum: 1
type: integer
contentEncoding: int32
description: Native VLAN ID for upstream ports
vlan_id_with_variable:
oneOf:
- type: string
- maximum: 4094
minimum: 1
type: integer
contentEncoding: int32
description: VLAN ID, either numeric or expressed as a template variable string
wayfinding_import_json:
oneOf:
- $ref: '#/components/schemas/map_jibestream'
- $ref: '#/components/schemas/map_micello'
description: Vendor wayfinding map metadata imported from Jibestream or Micello
wlan_dynamic_vlan_default_vlan_id:
oneOf:
- type: string
- maximum: 4094
minimum: 1
type: integer
contentEncoding: int32
default: 999
description: VLAN ID, VLAN range or variable to use when there’s no match from RADIUS
wlan_dynamic_vlan_default_vlan_id_deprecated:
oneOf:
- type: string
- maximum: 4094
minimum: 1
type: integer
contentEncoding: int32
default: 999
description: vlan_id to use when there’s no match from RADIUS
wlan_dynamic_vlan_default_vlan_ids:
allOf:
- $ref: '#/components/schemas/wlan_dynamic_vlan_default_vlan_id'
- description: Default VLAN ID(s) can be a number, a range of VLAN IDs, a variable or multiple numbers, ranges or variables as a VLAN pool. Default VLAN as a pool of VLANS requires 0.14.x or newer firmware
wlan_dynamic_vlan_local_vlan_ids:
allOf:
- $ref: '#/components/schemas/vlan_id_with_variable'
- description: VLAN_ids to be locally bridged
wlan_limit:
anyOf:
- maximum: 999000
minimum: 1
type: integer
contentEncoding: int32
- type: string
description: In kbps, value from 1 to 999000
wlan_portal_sponsors:
oneOf:
- type: array
items:
type: string
- type: object
additionalProperties:
type: string
examples:
- sponsor1@company.com: FirstName1 LastName1
sponsor2@company.com: FirstName2 LastName2
description: Object of allowed sponsors email with name. Required if `sponsor_enabled` is `true` and `sponsor_email_domains` is empty. Property key is the sponsor email, Property value is the sponsor name. List of email allowed for backward compatibility
wlan_vlan_id_with_variable:
oneOf:
- type: string
- maximum: 4094
minimum: 1
type: integer
contentEncoding: int32
description: WLAN VLAN ID, either numeric, a variable string, or null
wlan_vlan_ids:
oneOf:
- type: string
examples:
- 1,2
- type: array
items:
$ref: '#/components/schemas/vlan_id_with_variable'
examples:
- - 3
- 4
- 5
description: WLAN VLAN pool IDs represented as either a comma-separated string or a list
wlan_vlan_ids_list:
allOf:
- $ref: '#/components/schemas/vlan_id_with_variable'
- description: If `vlan_enabled`==`true` and `vlan_pooling`==`true`. List of VLAN IDs (comma separated) to be used in the VLAN Pool
wxlan_tag_vlan_id:
oneOf:
- type: string
- maximum: 4094
minimum: 1
type: integer
contentEncoding: int32
description: If `type`==`vlan_id`, VLAN ID or variable
examples:
- '1055'
securitySchemes:
apiToken:
type: apiKey
description: >-
Preferred authentication method for automation and integrations. Send the API token in the HTTP `Authorization` header.
**Format**:
`Authorization: Token {apitoken}`
**Notes**:
* An API token generated for a specific admin has the same privileges as that admin
* An API token is automatically removed if it is not used for more than 90 days
* SSO admins cannot generate admin API tokens. Use organization API tokens when scoped Org/Site privileges are needed.
name: Authorization
in: header
csrfToken:
type: apiKey
description: >-
Session-based authentication for browser or login/password flows. After a successful [Login]($e/Admins%20Login/login) request, Mist returns a `csrftoken` cookie. Send that value in the `X-CSRFToken` header on later API requests that use the login session.
**Format**:
```
X-CSRFToken: vwvBuq9qkqaKh7lu8tNc0gkvBfEaLAmx
```
For automation, API Token authentication is preferred.
name: X-CSRFToken
in: header
security:
- apiToken: []
- csrfToken: []
tags:
- name: Admins
description: >-
Admin API calls can be used to create, manage or authenticate Mist administrators.
To register administrators into an existing MSP account or Organization, please check: * [Invite Msp Admin]($e/MSPs%20Admins/inviteMspAdmin) * [Invite Org Admin]($e/Orgs%20Admins/inviteOrgAdmin)
- name: Admins Login
description: >-
Login Endpoints when using Login/Password authentication, with or without 2FA.
If the Login/Password authentication is successful, Mist will add a `csrftoken` cookie that must be added into the later API Requests (please see [csrfToken (Custom Header Signature)]($h/__auth_CsrfToken))
- name: Admins Logout
description: Logout Endpoints when using Login/Password authentication, with or without 2FA.
- name: Admins Recover Password
description: Endpoints used to trigger a password recovery and validate the token sent by email.
- name: Admins Lookup
description: Admin Lookup API Call is mainly used by Web UIs to know if a user must be redirected to an SSO URL for login.
- name: Admins Login - OAuth2
description: "A Mist account can be linked to OAuth2 providers:\n1. First, login with your Mist account\n2. Obtain the Authorization URL for Linking with [Get Oauth 2 Authorization Url for Login]($e/Admins%20Login%20-%20OAuth2/getOauth2AuthorizationUrlForLogin).\nAs OAuth2 flow goes through provider's UI and back with the authorization code, there are two ways to get it:\n * in JSON response, more usable for developers. Simply don\\'t specify the `forward` parameter when obtaining the authorization URL\n * as GET parameter, for UI where the user flow can be continued. Specify the landing page/url of your choice \n3. Obtain the authorization code by clicking / going through Authorization URL Link Mist Account against OAuth2 Provider by using the authorization code"
- name: Installer
description: "In a typical enterprise, a separate group of people, Installers, are responsible for install new devices. May it be a new installation (e.g. new stores), a replacement installation (e.g. replacing Cisco APs with Mist APs), or addition (e.g. adding new APs for better coverage). Instead of granting them Admin/Write privilege, it's more desirable to grant them minimum privileges to do the initial provisioning so they cannot read sensible information (e.g. PSK of a WLAN), or change configs of running APs.\nAt a high level, Installer APs try to achieve the following:\n1. identifying a device by MAC (that\\u2019\\ \ns what they see)\n2. they can only touch configurations of the devices they\\u2019\\\nre installing\n3. allow the following configurations: \n * name * site assignment \n * device profile assignment \n * map and location (x/y) assignment \n * claim (if not already in the inventory) \n * replace existing device with the device being installed\n\n**Grace Period**\n\nGrace period provides a dynamic way to limit what devices / sites installer can work on. Generally installers work on recent deployments - bringing up new sites, add newly claimed devices to new / existing sites. They make mistakes, too, and may need to further tweak some of the parameters. Default grace period is 7 days and can be set from 1 day to 365 days."
- name: MSPs
description: MSP (Managed Service Provider) contains multiple Organizations.
- name: MSPs Admins
description: An MSP Admin refers to a user who has access to the Juniper Mist managed service provider (MSP) portal and is responsible for managing and administering the network operations of multiple customer organizations and sites.
- name: Orgs SecIntel Profiles
description: Sky ATP Secintel Profile
- name: Sites SecIntel Profiles
description: Sky ATP Secintel Profile
- name: MSPs Inventory
description: API Calls to locate a device across all the Organizations attached to the MSP account.
- name: MSPs Logo
description: Manage the Mist portal logo at the MSP level. This logo will be displayed instead of the Juniper Mist Logo for all the Organizations attached to this MSP account.
- name: MSPs Logs
description: >-
Audit Logs are records of activities initiated by users, providing a history of actions such as accessing, creating, updating, or deleting resources or components at the MSP level.
These logs allow superusers and network administrators to track and maintain a record of user actions, including who performed specific actions and when.
Audit logs are useful for monitoring user activity, investigating security breaches, ensuring compliance with regulations, and tracing configuration changes in a network.
They can be filtered and analyzed to view specific information and granular-level details of each event.
- name: MSPs Licenses
description: >-
Licenses are a type of service or access that customers can purchase for various features or services offered by a company.
Subscriptions can have different statuses, such as active, expired, exceeded, or trial, depending on their validity and usage. The status of a subscription determines whether it is currently active and valid, has expired, has exceeded the allowed usage limit, or is in a trial period.
Licenses can be activated using an activation code, and the activation process confirms the inputted code and activates the subscription.
Licenses can be managed at the MSP level for organization attached to an MSP account, or directly at the [Organization level]($h/Orgs%20Licenses/_overview)
- name: MSPs Marvis
description: >-
Marvis is an AI-driven, interactive virtual network assistant that streamlines network operations, simplifies troubleshooting, and provides an enhanced user experience.
It offers real-time network visibility, comprehensive insights, and automation customized for your network.
Marvis can proactively identify issues, interpret their impact, determine root causes, and recommend fixes.
It consists of components such as Marvis Actions, Marvis Minis, Conversational Assistant, Marvis Client, and Marvis Query Language.
Marvis API Calls at the MSP level can be used to quickly detect network issues on all the Organizations attached to the MSP account.
- name: MSPs Org Groups
description: >-
Org Groups a way to group Organizations together based on certain criteria.
They can be used for easier management and organization of multiple organizations within the MSP portal.
- name: MSPs Orgs
description: >-
An organization usually represents a customer - which has inventories, licenses.
An Organization can contain multiple sites. A site usually represents a deployment at the same location (a campus, an office).
- name: MSPs SLEs
description: >-
SLEs, or Service-Level Expectations, are metrics used to monitor and report on the user experience of a Wireless, Wired or Wan network.
They are generated through data science and machine learning algorithms and provide insights into various aspects of the network, such as coverage, capacity, connectivity, and performance.
Mist SLEs help identify when users do not have sufficient network quality, when they face issues with connecting or roaming between access points, and when there are problems on the wired network.
SLEs API Calls at the MSP level can be used to retrieve the SLEs summary for each Organization attached to the MSP account.
- name: MSPs SSO Roles
description: >-
MSP SSO roles refer to the different functions assigned to users within a Single Sign-On (SSO) system.
These roles determine the tasks and actions that users can perform within the SSO system. There are typically predefined roles and custom roles in an SSO system.
Roles in SSO provide a well-defined separation of responsibility and visibility, allowing for granular-level access control on SSO objects.
- name: MSPs SSO
description: >-
MSP SSO, or Single Sign-On, is a method of authentication that allows users to securely log in to multiple applications and websites with a single set of login credentials.
It involves integrating the MSP portal with an Identity Provider (IdP) using the Security Assertion Markup Language (SAML) framework.
This enables users to authenticate themselves through their corporate IdP, eliminating the need to remember separate passwords or enter credentials each time they access the MSP portal.
- name: MSPs Tickets
description: >-
Support tickets are a means for users to seek assistance and resolve issues they encounter with a product or service.
They allow users to communicate their problems or questions to the Juniper Mist support team, who can then provide guidance, troubleshooting, or solutions.
Support tickets typically include information such as the type of issue, relevant details, and any necessary attachments.
Support Tickets API Calls at the MSP level can be used to retrieve the tickets for each Organization attached to the MSP account.
- name: Orgs
description: An organization usually represents a customer - which has inventories, licenses. An Organization can contain multiple sites. A site usually represents a deployment at the same location (a campus, an office).
- name: Orgs Admins
description: >-
An org admin, or organization administrator, is a user with administrative privileges within a specific organization. They have the authority to manage and oversee the operations and settings of that organization's portal.
The different types of access levels for an org admin include:
* Super User: This role has full access to the MSP portal and all tenant organizations. A super user can manage other administrators and has the highest level of privileges.
* Network Admin: A network admin has limited access to the MSP portal. They can be granted access to all organizations or specific organizations, with access to limited features in the organizations' portals. They are responsible for monitoring, verifying, and troubleshooting the network within their assigned organizations.
* Observer: An observer has view-only access to limited features in the MSP portal. They can be granted access to all organizations or specific organizations, with view-only access to limited features in the organizations' portals. Observers monitor events in the network and bring any issues to the attention of the network administrator for resolution.
* Installer: An installer can be granted access to all organizations or specific organizations, with only the ability to install access points for these organizations. They are responsible for setting up and installing access points in the network.
* Helpdesk: A helpdesk user can be granted access to all organizations or specific organizations, with only helpdesk monitoring and workflow capabilities for these organizations. They assist with monitoring and resolving issues reported by users within the organization.
These different access levels allow org admins to perform their specific roles and responsibilities within the MSP portal while ensuring appropriate access and security measures are in place.
- name: Orgs Alarms
description: Alarms are triggered based on certain events. Alarms could be configured using an Alarm Template.
- name: Orgs Alarm Templates
description: >-
An Alarm Template is a set of Alarm Rules that could be applied to
one or more sites (while each site can only pick one Alarm Template), or to the
whole org.
Once created, the Alarm template must be assigned with the `alarmtemplate_id` attribute to one of the following
* the whole org with the [Update Org]($e/Orgs/updateOrg) API Call
* one or multiple sites with the [Update Site Info]($e/Sites/updateSiteInfo) API Call
- name: Orgs AP Templates
description: >-
AP Templates are defining Wi-Fi and AP settings that can be assigned to Access Points based on different types of rules.
AP Templates must be assigned to one or multiple sites to be used.
- name: Orgs API Tokens
description: >-
Org API token is a unique identifier used by an application to authenticate and access a service's API.
These tokens are used to authenticate requests made to the API server and ensure secure access to the API.
They are not bound to any specific user and provide access to the organization as a whole.
Organization tokens support different privileges and can only be used for the specific organization they are generated for.
Rate limiting is done on an individual token basis, so if one token reaches its rate limit, it does not impact other tokens.
- name: Orgs Assets
description: >-
An Asset refers to any equipment or item that is being tracked and monitored using Bluetooth Low Energy (BLE) beacon tags.
This requires the Asset Visibility subscription.
- name: Orgs Asset Filters
description: >-
An Asset Filter is a feature that allows users to define specific criteria or conditions to filter and display only certain assets based on their attributes or properties.
This requires the Asset Visibility subscription.
- name: Orgs Cert
description: >-
API Calls to manage Organization Certificates.
The certificates can be used bu Access Assurance, during the SSO/SAML Authentication, ...
- name: Orgs Antivirus Profiles
description: "Antivirus profiles are used to define the content to scan for any malware and the action to be taken when malware is detected. \nThese profiles can be assigned to Content Security policies to scan Web, file transfer, and e-mail traffic. \nThe profiles help in ensuring that the network is protected from malicious content by specifying fallback options and notification methods when malware is detected or when the antivirus system experiences errors.\n\n\nKey Features of Antivirus Profiles:\n\n* Content Scanning: Defines the content to scan for malware.\n* Action on Detection: Specifies the action to be taken when malware is detected.\n* Fallback Options: Configures actions to be taken when the antivirus system encounters errors.\n* Notification Options: Sets up methods to notify users when a fallback occurs or a virus is detected."
- name: Orgs Clients - Marvis
description: >-
Marvis Invites can be generated for (and belongs to) an Org. They can be generated by an Admin of an Org and can be revoked at anytime.
Marvis Clients are devices that have the Marvis Android Client installed on them and are connected to a Juniper Mist AP.
They provide detailed data and telemetry about the client's wireless connection, including information about roaming behavior, connection type, and wireless properties.
- name: Orgs Marvis Invites
description: >-
Marvis Clients are devices that have the Marvis Android Client installed on them and are connected to a Juniper Mist AP.
They provide detailed data and telemetry about the client's wireless connection, including information about roaming behavior, connection type, and wireless properties.
- name: Orgs Clients - NAC
description: NAC Clients are devices connected to the network and authenticated by Juniper Mist Access Assurance.
- name: Orgs Clients - Wan
description: WAN Clients are devices connected to a Juniper SRX or SSX gateway monitor or managed by Mist
- name: Orgs Clients - Wired
description: Wired Clients are Wired devices connected to a Juniper switch monitored or managed by Mist.
- name: Orgs Clients - Wireless
description: Wireless Clients are Wi-Fi devices connected to a Juniper Mist Access Point.
- name: Orgs Clients - SDK
description: >-
SDK Clients are devices that have installed an application using the Mist Software Development Kit (SDK).
These clients can provide specific data and information that is not available without the installation of the SDK application.
- name: Orgs Integration Cradlepoint
description: >-
The integration between Mist and Cradlepoint allows users to utilize Cradlepoint 5G cellular adapters with Juniper's wired, wireless, and SD-WAN solutions driven by Mist AI.
With this integration, users can manage Cradlepoint devices from the Mist portal, including onboarding, assigning devices to a site, and viewing device inventory details. It also provides visibility into the health, SLE, and insights of Cradlepoint devices.
Additionally, the integration enables users to leverage Marvis, Juniper's virtual network assistant, to receive proactive recommendations and self-driving network actions. This integration enhances the client-to-cloud user experience by providing insights into branch WAN adapters, helping network admins reduce Mean Time to Identify (MTTI).
- name: Orgs CRL
description: >-
CRLs, or Certificate Revocation Lists, are time-stamped lists that identify digital certificates that have been invalidated before their expiration date. They include information about the reasons for revocation and the entities that issued the certificates.
CRLs are used to prevent the usage of compromised digital certificates and signatures.
- name: Orgs Device Profiles
description: >-
While Templates / RF Templates / Network Templates / Gateway Templates provides powerful ways to control how a Device\'s configuration is derived for a Site. There are cases where you\'d like another level of control at the Org Level.
A Device Profile contains a subset of Device\'s configurations you\'d like a device to have. It will be merged at runtime when we\'re provisioning an AP.
- name: Orgs Devices
description: Devices are any Network device managed or monitored by Juniper Mist. It can be * Wireless Access Points * Juniper Switch (EX, QFX) * Juniper WAN Gateway (SRX, SSR) * Mist Edges * Other or 3rd party devices, like Cradlepoint Devices
- name: Orgs Devices - SSR
description: API Calls specific to SSR devices
- name: Orgs Devices - AOSCX
description: API Calls specific to AOS-CX (Aruba Operating System - CX) devices
- name: Orgs Devices - EdgeConnect
description: API Calls specific to EdgeConnect devices
- name: Orgs EVPN Topologies
description: >-
EVPN allows an alternative but more efficient LAN architecture utilizing VxLAN / MP-BGP - separating control plane (MAC / IP Learning) from forwarding plane.
In our implementation, following the steps to deploy EVPN topologies in a Site
- name: Orgs Integration Juniper
description: The Juniper Integration can be used to synchronize Juniper Support Insights (JSI) information.
- name: Orgs Devices - Others
description: API Call for 3rd party devices
- name: Orgs Integration Zscaler
description: >-
In Zscaler UI:
1. add Partner Integration at https://admin.zscalerbeta.net/#administration/partner-integration
2. Add Partner Administrator Role at https://admin.zscalerbeta.net/#administration/role-management - Name: Mist - Access: Full
3. add Partner Admin at https://admin.zscalerbeta.net/#administration/admin-management with - Login ID: john - email: john@abc.com
4. Find the cloud name for ZIA https://help.zscaler.com/zia/what-my-cloud-name-zia
- name: Orgs SCEP
- name: Orgs Gateway Templates
description: >-
Gateway Template is applied to a site for gateway(s) in a site.
When Templates are not used, Site Setting holds settings for multiple device types and they can differ to set device_type specific configs, use this whatever is defined under `gateway` will overwrite/shadow the one at root-level
- name: Orgs Guests
description: Guests are users who are accessing the wi-fi network as a temporary or non-permanent visitor.
- name: Orgs IDP Profiles
description: >-
An IDP profile is a set of predefined rules and actions that determine how the Intrusion Detection and Prevention (IDP) system handles network traffic.
It allows you to selectively enforce attack detection and prevention techniques on your network. The profile includes a set of IDP signatures and rules recommended by Juniper Networks, and each attack type and severity has a specific action associated with it, such as closing the TCP connection, dropping the packet, or sending an alert.
The IDP profile can be applied to an application policy to monitor and analyze network events for signs of incidents, violations, or threats to security policies.
- name: Orgs Inventory
description: The Org Inventory allows administrators to view and manage all devices registered (claimed) to the Organization.
- name: Orgs Integration JSE
description: >-
JSE stands for Juniper Secure Edge and it is a feature within the Mist UI that allows customers to configure Secure Cloud Connectors.
With JSE, users can establish a tunnel via IPSec protocol and use application policy and traffic steering to send traffic from a WAN edge device to JSE. Mist also provides insights and telemetry for the secure edge connection, which is helpful for troubleshooting and monitoring data.
- name: Orgs Advanced Anti Malware Profiles
description: >-
The "Advanced Anti-Malware" feature in Sky ATP is a comprehensive security solution that leverages multiple techniques to detect and prevent malware attacks. Here are the key components of this feature:
* **Flow-Based Antivirus Policy**: The policy checks inbound and outbound traffic to stop malware, quarantine infected systems, prevent data exfiltration, and disrupt lateral movement.
* **Machine Learning-Based Threat Detection**: Sky ATP uses machine learning to identify zero-day threats and detect malware that traditional antivirus software might miss.
* **Integration with SRX Series Firewalls**: The SRX Series firewalls integrate with Sky ATP to block known malicious file downloads and outbound Command and Control (C&C) traffic. This integration ensures that malware is quickly identified and dropped before it can infect a host.
* **Real-Time Threat Intelligence**: Sky ATP distributes third-party threat intelligence feeds to all ATP-subscribed SRX firewalls for immediate action, reducing the attack surface.
These components collectively provide a robust and automated threat detection and remediation solution, simplifying cybersecurity infrastructure and processes for organizations.
For more details, you can refer to the Juniper documentation on advanced anti-malware policy configuration.
- name: Orgs Integration SkyATP
description: "Sky Advanced Threat Prevention (Sky ATP) is a cloud-based security designed to detect and mitigate advanced threats in real-time, ensuring the security and integrity of your network. \nThe integration of Sky ATP with Mist is a strategic move to enhance the security posture of wireless networks by leveraging the capabilities of both solutions.\n\n\nThe integration of Sky ATP with Mist enhances the security of wireless networks by providing real-time threat alerts and mitigation capabilities. Here are the key benefits of this integration:\n\n* Enhanced Security: Adds another layer of security to the robust mechanisms already in place within the Mist WLAN platform. It leverages artificial intelligence (AI) for tighter security, lower operational costs, and optimized user experience.\n* Real-Time Threat Detection: Quickly identifies devices on the network that are infected with malware and takes appropriate actions. This ensures that security risks are assessed and mitigated promptly when users and devices are connected to wireless networks.\n* Improved Device Tracking: Allows for better tracking of client hosts as Mist supplies client MAC addresses to Juniper ATP Cloud. This information is crucial for identifying and mitigating threats.\n* Streamlined Security Events: Threat alerts detected by Juniper SRX Series Firewalls and ATP Cloud are automatically streamed to Mist, enabling administrators to quickly assess security risks and take appropriate actions such as quarantine or enforce security policies."
- name: Orgs JSI
description: "Juniper Support Insight is a free service provided to all Mist customers.\nYou can adopt your devices via a few lines CLI commands. Allowing you to \n* get some basic information about the adopted devices \n* web shell into device (write privilege required) \\n* upgrade (write privilege required)"
- name: Orgs Licenses
description: >-
Licenses are a type of service or access that customers can purchase for various features or services offered by a company.
Subscriptions can have different statuses, such as active, expired, exceeded, or trial, depending on their validity and usage. The status of a subscription determines whether it is currently active and valid, has expired, has exceeded the allowed usage limit, or is in a trial period.
Licenses can be activated using an activation code, and the activation process confirms the inputted code and activates the subscription.
- name: Orgs Linked Applications
description: "Linked Application are Third party applications linked to the Mist Organization. \nThis is usually using OAuth2.0 or API integrations for a Cloud-to-Cloud Communication."
- name: Orgs Logs
description: >-
Audit Logs are records of activities initiated by users, providing a history of actions such as accessing, creating, updating, or deleting resources or components at the Org level.
These logs allow superusers and network administrators to track and maintain a record of user actions, including who performed specific actions and when.
Audit logs are useful for monitoring user activity, investigating security breaches, ensuring compliance with regulations, and tracing configuration changes in a network.
They can be filtered and analyzed to view specific information and granular-level details of each event.
- name: Orgs Marvis
description: >-
Marvis is an AI-driven, interactive virtual network assistant that streamlines network operations, simplifies troubleshooting, and provides an enhanced user experience.
It offers real-time network visibility, comprehensive insights, and automation customized for your network.
Marvis can proactively identify issues, interpret their impact, determine root causes, and recommend fixes.
It consists of components such as Marvis Actions, Marvis Minis, Conversational Assistant, Marvis Client, and Marvis Query Language.
- name: Orgs Maps
description: These API Calls to import Site Maps at the Org level
- name: Orgs MxClusters
description: A Mist Edge Cluster (MxCluster) is a group of Juniper Mist Edge devices that are configured to work together in order to provide high availability and load balancing for the tunneling of traffic from access points (APs). The cluster can consist of a single edge device or multiple edge devices.
- name: Orgs MxEdges
description: A Mist Edge (MxEdge) is a physical or virtual appliance that is deployed in a network to provide centralized data path for user traffic or as a RADIUS Proxy, which was traditionally performed by legacy wireless controllers. It keeps all the control and management functions in the Mist Cloud, offering a microservices architecture to the campus.
- name: Orgs MxTunnels
description: >-
A Mist Tunnel (MxTunnel) is a configuration object that allows for the tunneling of user VLANs from the Access Points (APs) to a central point on the network.
It specifies the VLAN IDs that need to be tunneled and assigns the tunnel to a primary or secondary mist edge cluster. The mist tunnel also includes settings for tunnel fail over, auto-preemption, and other parameters related to tunnel termination services.
- name: Orgs NAC IDP
description: The NAC IDP allows users to integrate with various Identity Providers (IDPs) to enhance authentication and access control. Admins can configure identity providers such as microsoft EntraID, okta workforce identity cloud, and google workspace idp.
- name: Sites NAC Fingerprints
description: The NAC IDP allows users to integrate with various Identity Providers (IDPs) to enhance authentication and access control. Admins can configure identity providers such as microsoft EntraID, okta workforce identity cloud, and google workspace idp.
- name: Orgs NAC Tags
description: >-
NAC Tags are the building blocks to compose nacrules.
They can either appear in the "matching" / "not_matching" sections of a nacrule, in which case they play the role of classifiers, or they could appear in the "apply_tags" section of the of a nacrule, in which case they influence the result.
When the "type" field of nactag is "match", it can be used as the classifier of a nacrule.
- "match" field specifies the attribute name and "values" field specifies the list of attribute values to match on.
- When multiple values are specified, its treated as an OR condition between those values. This behavior can be changed by setting "match_all" field to "true", in which case it is treated as an AND condition between those values.
- By default, exact match is performed.
This behavior can be changed as follows:
- Adding `-` at the beginning will perform suffix match (ex: -staff will match foo-staff and bar-staff)
- Adding `-` at the end will perform prefix match (ex: foo- will match foo-staff and foo-interns)
- Adding `!` at both ends will perform substring match (ex: printer will match hp-printer-bldg1, brother-printer-lab)
- Adding `!` at the beginning will perform negation of the match (ex: !ssid-guest will match any string that is not ssid-guest)
- Note: when negation should be used along with suffix/substring operation, ! should always precede \* (ex: !guest will match any string that is not ending with guest)
When the "type" field of nactag is NOT "match", it can be used as the result of a nacrule. "type" field identifies the action to take and the corresponding field would provide any associated parameters to that action. When the "type" field of nactag is NOT "match" and is any of the result type also supported by usermac table(`vlan`), "allow_usermac_override" field can be set to true to allow the override by usermac result
- name: Orgs NAC Portals
description: "NAC Portals are for onboard Wireless and Wired client with 802.1X\n\nThe NAC Portal is a web-based interface that allows users to authenticate and\ngain access to the network. It is typically used for guest access or for devices\nthat do not have a pre-configured certificate for 802.1X authentication.\n\nIt can also be used to provision certificates for devices that require them with the Mist Application.\n\n\n### NAC-Based External Guest Portal Authorization / How to implement a External Guest Portal\n\n#### Context\n\nIn the guest portal flow, context such as SSID, guest MAC, AP MAC is required to unique identify the guest, if it's already authorized (e.g. roam to another AP), and used to instruct the AP to stop redirecting/blocking the user traffic\n\n#### Redirect\n\nGuest Device (or CNA in MacOS/iOS term) will be redirected to, e.g. “?ap_mac=5c5b35001234&ssid=Guest&…”\n\n| Name | Type | Description |\n |------|------|-------------|\n | ap_mac | string | AP's MAC address |\n | site_id | string | Site ID |\n | device_mac | string | Device's MAC address (the device that blocks the traffic) |\n | ssid | string | for wireless |\n | port_name | string | for wired (e.g. eth0, ge-0/0/13) |\n | client_mac | string | Client's MAC address |\n \n\n#### Authorize\n\nOnce the guest has gone through your portal flow, authorize them by redirect the user to\n\n```\nGET https://url_generated_by_portal_authorize_url?jwt=\n```\n\nThis can be generated by\n\n```python\nimport jwt\n\nsecret = \"EIfPMOykI3lMlDdNPub2WcbqT6dNOtWwmYHAd6bY\" # from portal_authorize_jwt_secret above \npayload = {\n # for wireless\n \"ap_mac\": \"5c5b35001234\",\n \"wlan_id\": \"be22bba7-8e22-e1cf-5185-b880816fe2cf\", # only for _wireless_ captive portal\n \"client_mac\": \"d58f6bb4c9d8\",\n\n # for wired\n \"device_mac\": \"5c5b35001234\",\n \"port_name\": \"eth0\", # only for _wired_ captive portal\"\n \"client_mac\": \"d58f6bb4c9d8\",\n\n # common\n # how long should we authorize this session\n \"minutes\": 480, \n \"expires\": 1768587994, # alternatively\n # instead of the original URL the user is trying to go to, redirect the user to this URL \n \"forward\": \"http://www.mist.com\",\n # for testing: if authorize_only=true and authorization is successful, 200 OK will be returned instead of 302 Redirect the user to the `forward` URL\n \"authorize_only\": False\n}\n\nencoded_jwt = jwt.encode(payload, secret, algorithm='HS256')\n```\n"
- name: Orgs NAC CRL
description: "By default, Mist is automatically retrieving the PKI CRL by using the CRL Distribution Point provided by Certification Authority.\n\n\nIn case this information is not provided, or the CRL is not publicly available (i.e. Mist cannot get access to it), these API Calls can \nbe used to manually upload and manage the PKI CRL into the Mist Organization."
- name: Orgs Stats
description: API Calls to retrieve statistics about the Mist Org and related items
- name: Orgs Stats - Assets
description: API Calls to retrieve statistics about the Assets at the Org level
- name: Orgs Stats - BGP Peers
description: API Calls to retrieve statistics about the BGP Peers (WAN Assurance)
- name: Orgs Stats - Devices
description: >-
API Calls to retrieve statistics about the Mist Managed and Monitored Devices at the Org level
By default, the API call only returns a subset of the available fields. Additional fields can be requested by adding the query parameter `fields=` and the list of fields, or `fields=*` to retrieve all the available fields.
- name: Orgs Stats - Marvis Clients
description: API Calls to retrieve statistics about Marvis Clients at the Org level
- name: Orgs Stats - MxEdges
description: API Calls to retrieve statistics about the Mist Edges at the Org level
- name: Orgs Stats - Ospf
description: API Calls to retrieve statistics about OSPF peers at the Org level
- name: Orgs Stats - Other Devices
description: API Calls to retrieve statistics about the Other/3rd party devices at the Org level
- name: Orgs Stats - Ports
description: API Calls to retrieve statistics about the Wired Ports at the Org level
- name: Orgs Stats - Sites
description: API Calls to retrieve statistics about the Organization Sites
- name: Orgs Stats - Tunnels
description: API Calls to retrieve statistics about the Mist Tunnels at the Org level
- name: Orgs Stats - VPN Peers
description: API Calls to retrieve statistics about the VPN Peers (WAN Assurance)
- name: Orgs NAC Rules
description: >-
The NAC Rules (or Auth Policies) are a set of rules that devices and users must fulfill in order to gain access to the network and use network resources.
Juniper Mist Access Assurance evaluates authentication requests based on the specified policy conditions. If a user or device satisfies the conditions, Mist Access Assurance applies actions that either allow or deny access to the user or device.
These actions can also apply attributes such as VLAN and role to the allowed users. Mist Access Assurance uses "NAC Tags" (or Auth Policy Labels) as the policy matching criteria and as a policy action for allowed users. NAC Tags can be managed with the [Orgs NAC Tags API Calls]($h/Orgs%20NAC%20Tags/_overview)
- name: Orgs Network Templates
description: >-
A Network Template is a configuration template that allows for the consistent and standardized configuration of switches across an organization's network infrastructure.
It includes settings such as RADIUS and ntp servers, shared elements like iot or corporate networks, and port profiles for specific devices.
Switch templates can be applied at the site level, and they make the initial setup of switches easy and adaptable to specific site or switch settings.
- name: Orgs Networks
description: A Network refers to a group or segment of users that are defined for use across the entire organization.
- name: Orgs Premium Analytics
description: >-
Premium Analytics is an advanced, cloud-based analytics service offered by Juniper Mist. It provides end-to-end network observability and allows users to gain unique insights into networking and location based on Juniper Mist data sets and optional third-party data sets.
Premium Analytics stores data for up to 13 months, extending the observability of historical data beyond the 30 days available with the standard Juniper Mist analytics service. It supports features such as network, engagement, and occupancy analytics, and offers the ability to customize reports and filter data based on various parameters.
- name: Orgs Psks
description: >-
A multi PSK (Pre-Shared Key) is a feature that allows the use of multiple PSKs for securing network connections.
It provides a simple and comprehensive way to onboard client devices without relying on client MAC addresses.
Each psk has its own key name, which can be used for user-level accountability, key rotation, and visibility in the management platform. It supports the creation, rotation, and auto-expiration of PSKs, and allows vlan assignment and role assignment for dynamic per-user policies.
Multi PSKs create virtual broadcast domains and can be used for end-user onboarding via authenticated sso login.
Mist supports three methods of Org PSKs lookup: * local * RADIUS * cloud
- name: Orgs Psk Portals
description: >-
PSK Self-Service Portals are for
1. **Wi-Fi users** who want to connect to a WLAN with personal PSK, they're told to connect to a URL where they can login (likely through company\u2019s SSO) and get the Wi-Fi Name / Passphrase - required input fields name, email so we can generate PSK
2. **PSK Admins** (they don't have access to normal Network Admin Portal)
When a PSK portal is created, an unique URL will be generated (e.g. https://psk.mist.com/xxxxxx)
- name: Orgs Reports
description: API Calls to manage organization-level reports, such as E911 AP BSSID report exports.
- name: Orgs RF Templates
description: >-
Rf Templates are a feature in Juniper Mist wireless assurance that allow for uniform radio configurations to be applied across all sites in an organization.
These templates can be customized to include model-specific exceptions and settings for different use cases.
RF Templates enable the management of radio bands, channel width, transmission power, and ap antenna gain.
They provide a centralized way to configure and apply these settings to all access points within an organization.
- name: Orgs SDK Invites
description: SDK Invites can be generated for (and belongs to) an Org. They can be generated by an Admin of an Org and can be revoked at anytime.
- name: Orgs SDK Templates
- name: Orgs Security Policies
description: "Security Policy is designed to audit / catch discrepancies between\n\"what's intended to be running\" versus \"what's actually running\" in a network. \n\nMany big organizations have separated Security and IT team (for good reasons). Each site can be assigned a security policy.\n Whenever an AP is provisioned, the configuration will be checked against the security policy.\n Any violations will be flagged in [Device Config History]($e/Sites%20Devices/searchSiteDeviceConfigHistory) where you can search for the when and where the violation occurs."
- name: Orgs Services
description: >-
A Service refers to the applications that network users will connect to. These applications represent traffic destinations and are essential for defining network policies and security configurations.
Applications can be defined manually in the Juniper Mist cloud portal. They can be categorized as: * Custom Applications: Defined using IP prefixes, protocols, and port ranges. * Predefined Applications: Selected from a list of common applications (e.g., Social Media, Microsoft Teams). * URL Categories: Used to define applications based on specific URLs.
- name: Orgs Service Policies
description: >-
Services Policies are a security policy that defines who can access applications, they are used to control access to applications and ensure proper traffic management within a network.
It determines the source network or users that are allowed or denied access to specific applications or destinations.
The policy also includes options such as traffic steering profiles, which define the paths that the traffic should follow.
Service policies can be defined at the organization level or within a wan edge template or hub profile.
- name: Orgs Setting
description: API Calls to manage the Mist Organization Settings
- name: Orgs Sitegroups
description: Site groups are a group of sites under the same Org. It's many-to-many mapping to sites
- name: Orgs Sites
description: >-
API Calls to Create or Get the Organization Sites.
Use the [Site Settings](https://www.juniper.net/documentation/us/en/software/mist/api/http/api/sites/setting/overview) to configure or update the Site information.
- name: Orgs Site Templates
description: >-
Site templates are pre-configured sets of attributes and settings that can be applied to one or more sites in a Mist Organization.
These templates allow for quick and consistent configuration of sites by grouping common attributes together.
They can include settings such as Auto-Upgrade features, wan edge configurations, switch configurations and other network parameters.
By applying a site template, the same configuration can be easily replicated across multiple sites, simplifying network management and ensuring consistency.
- name: Orgs SLEs
description: >-
Org SLEs, or Service-Level Expectations, are metrics used to monitor and report on the user experience of a Wireless, Wired or Wan network.
They are generated through data science and machine learning algorithms and provide insights into various aspects of the network, such as coverage, capacity, connectivity, and performance.
Mist SLEs help identify when users do not have sufficient network quality, when they face issues with connecting or roaming between access points, and when there are problems on the wired network.
- name: Orgs SSO Roles
description: >-
SSO roles refer to the different functions assigned to users within a Single Sign-On (SSO) system.
These roles determine the tasks and actions that users can perform within the SSO system. There are typically predefined roles and custom roles in an SSO system.
Roles in SSO provide a well-defined separation of responsibility and visibility, allowing for granular-level access control on SSO objects.
- name: Orgs SSO
description: >-
Org SSO, or Single Sign-On, is a method of authentication that allows users to securely log in to multiple applications and websites with a single set of login credentials.
It involves integrating the Org portal with an Identity Provider (IdP) using the Security Assertion Markup Language (SAML) framework.
This enables users to authenticate themselves through their corporate IdP, eliminating the need to remember separate passwords or enter credentials each time they access the Org portal.
- name: Orgs WLAN Templates
description: "A WLAN template is a collection of WLAN policies, Tunneling Policies, and WxLAN policies. \nIt is used for creating and managing WLAN configurations at an organizational level. \n\n\nWLAN templates allow for modular and scalable configuration by grouping together the settings for multiple SSIDs. \nThese templates can be applied to specific sites, site groups, or the entire organization, making it easier to manage and automate configuration across multiple locations. \n\n\nWLAN templates are especially useful for organizations with multiple sites or plans for future expansion."
- name: Orgs Tickets
description: >-
Support tickets are a means for users to seek assistance and resolve issues they encounter with a product or service.
They allow users to communicate their problems or questions to the Juniper Mist support team, who can then provide guidance, troubleshooting, or solutions.
Support tickets typically include information such as the type of issue, relevant details, and any necessary attachments.
- name: Orgs User MACs
description: >-
NAC User MACs (Endpoints) provide a database of endpoints identified by their MAC addresses. They can be used assign each endpoint with various attributes, such as name, VLAN, role and client label. Once an endpoint is labeled, the label name can be used to create [NAC Tags]($h/Orgs%20NAC%20Tags/_overview) as match criteria.
[NAC Tags]($h/Orgs%20NAC%20Tags/_overview) can be used to create Tags regrouping one or multiple endpoint MAC addresses, but the use of the User MACs provides additional features:
* possibility to assign specific attributes, like a Name, a RADIUS Group, a VLAN ID, ...
* possibility to assign one or multiple Tags (Labels) to a User MAC
* improved management for large list of MAC addresses
- name: Orgs Vars
description: Vars endpoints are used to retrieve the list of Site Variables across all the Sites.
- name: Orgs VPNs
description: "VPNs endpoints are used to create the WAN Assurance Overlay configuration between a Hub and one\nor multiple WAN Edge Gateways.\n\n\nWhen configuring the Hub and Spokes from the Mist UI, the UI is automatically creating or updating\nthe VPNs objects based on the configuration. \nWhen the configuration is directly done with the APIs, the VPN object must be manually managed."
- name: Orgs Webhooks
description: >-
An Org Webhook is a configuration that allows real-time events and data from the Org to be pushed to a provided url.
It enables the collection of information about various topics such as device events, alarms, and audits updates at the org level.
The Webhook can be set up and customized using the Mist API, allowing users to receive and analyze specific data from a particular site.
- name: Orgs Wlans
description: >-
An Org Wlan is a wireless local area network that is configured at the Org level and applied to a WLAN template.
It allows for the creation and management of wireless network settings, such as SSIDs (service set identifiers), authentication settings, VLAN configurations, etc...
Org WLANs are created and managed at the org level and can only be referenced and used within the WLAN Templates.
- name: Orgs WxRules
description: >-
ORg WxRules are a set of rules, restrictions, and settings that can be applied to WLANs within a specific WLAN Template.
These policies determine how the devices and traffic are treated by the network and can be used to control access, define VLANs, and apply labels to users and resources.
- name: Orgs WxTags
description: >-
Wxtags are tags or groups that can be created and used within the Org.
They are used to classify users and resources and can be applied to Access Points, WLAN configurations or WxRules within that site.
Org WxTags are created and managed at the org level and can only be referenced and used within the org level configuration.
- name: Orgs WxTunnels
description: >-
A WxLan Tunnel (WxTunnel) are used to create a secure connection between Juniper Mist Access Points and third-party VPN concentrators using protocols such as L2TPv3 or dmvpn.
These tunnels allow for the aggregation of ethernet interfaces on access points, support dynamic or static tunnels, and provide options for IPSec encryption.
- name: Sites Spectrum Analysis
description: The Spectrum Analysis feature provides insights into the radio frequency environment, helping to identify interference and optimize wireless network performance. It allows users to monitor and analyze the spectrum usage in their vicinity.
- name: Sites
description: A site represents a project, a deployment. For MSP, it can be as small as a coffee shop or a five-star 600-room hotel. A site contains a set of Maps, Wlans, Policies, Zones.
- name: Sites Alarms
description: Alarms are triggered based on certain events. Alarms could be configured using an [Orgs Alarm Template]($h/Orgs%20Alarm%20Templates/_overview).
- name: Sites AP Templates
description: >-
AP Templates are defining Wi-Fi and AP settings that can be assigned to Access Points based on different types of rules.
Site AP Templates are created and managed at the site level and can only be referenced and used within that particular site.
- name: Sites Applications
description: Applications contains a list of applications users are interested in monitoring / routing / policing
- name: Sites Anomaly
- name: Sites Auto Map Assignment
description: Auto Map Assignment allows devices to be automatically assigned to maps based on their location data. These API calls can be used to manage, apply, and clear auto map assignments for devices at the site level.
- name: Sites Asset Filters
description: >-
An Asset Filter is a feature that allows users to define specific criteria or conditions to filter and display only certain assets based on their attributes or properties.
Site Asset Filters are created and managed at the site level and can only be referenced and used within that particular site.
This requires the Asset Visibility subscription.
- name: Sites Assets
description: >-
An Asset refers to any equipment or item that is being tracked and monitored using Bluetooth Low Energy (BLE) beacon tags.
This requires the Asset Visibility subscription.
- name: Sites Beacons
- name: Sites Clients - NAC
description: NAC Clients are devices connected to the network and authenticated by Juniper Mist Access Assurance.
- name: Sites Clients - Wan
description: WAN Clients are devices connected to a Juniper SRX or SSX gateway monitor or managed by Mist
- name: Sites Clients - Wired
description: Wired Clients are Wired devices connected to a Juniper switch monitored or managed by Mist.
- name: Sites Clients - Wireless
description: Wireless Clients are Wi-Fi devices connected to a Juniper Mist Access Point.
- name: Sites Devices
description: >-
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 specific
Device > Device Profile > RFTemplate (for AP only) > DeviceType-specific Template > Site Template > Site Setting
- name: Sites Devices - Wireless
description: API Calls specific to the Mist Access Points
- name: Sites Devices - Others
description: API Call for 3rd party devices
- name: Sites Devices - Wired
description: API Calls specific to the Juniper Switches managed by Mist
- name: Sites Devices - Wired - Virtual Chassis
description: API Calls specific to the Juniper Switches Virtual Chassis managed by Mist
- name: Sites Devices - WAN Cluster
description: API Calls specific to manage (form/delete) the SRX/SSR Clusters
- name: Sites Device Profiles
description: The API Endpoints for the Device Profiles at the site level can be used to get the site derived networks, meaning the org level configuration with the site variables resolved..
- name: Orgs Events
description: Orgs Events are all the system level changes at the org level
- name: Sites Events
description: >-
Site events are issues or incidents that affect site-assigned access points (aps) and radius, dhcp, and dns servers.
They can be investigated and monitored using the insights dashboard in the juniper mist portal. the dashboard provides a summary of site events, including information about the impacted devices and contributing events.
Site events can be categorized as resolved or acknowledged, and additional details can be accessed by clicking on the event.
- name: Sites EVPN Topologies
description: >-
EVPN allows an alternative but more efficient LAN architecture utilizing VxLAN / MP-BGP - separating control plane (MAC / IP Learning) from forwarding plane.
In our implementation, following the steps to deploy EVPN topologies in a Site
- name: Sites Gateway Templates
description: The API Endpoints for the Gateway Templates at the site level can be used to get the site derived networks, meaning the org level configuration with the site variables resolved..
- name: Sites IDP Profiles
description: The API Endpoints for the IDP Profiles at the site level can be used to get the site derived profiles, meaning the org level configuration with the site variables resolved..
- name: Sites Advanced Anti Malware Profiles
description: The API Endpoints for the Advanced Anti Malware Profiles at the site level can be used to get the site derived profiles, meaning the org level configuration with the site variables resolved..
- name: Sites Antivirus Profiles
description: The API Endpoints for the Antivirus Profiles at the site level can be used to get the site derived profiles, meaning the org level configuration with the site variables resolved..
- name: Sites Guests
description: Guests are users who are accessing the wi-fi network as a temporary or non-permanent visitor.
- name: Sites Insights
description: >-
Insights is a feature that provides an overview of network experience across the entire site, access points, or clients.
It offers useful information about current conditions, such as telemetry data from wired switches, edge devices, wireless clients, access points, network applications, and bluetooth low energy (ble) tags.
These insights can be used to correct issues, make changes, and ensure a good network experience for users.
- name: Sites JSE
description: >-
JSE stands for Juniper Secure Edge and it is a feature within the Mist UI that allows customers to configure Secure Cloud Connectors.
With JSE, users can establish a tunnel via IPSec protocol and use application policy and traffic steering to send traffic from a WAN edge device to JSE. Mist also provides insights and telemetry for the secure edge connection, which is helpful for troubleshooting and monitoring data.
- name: Sites Licenses
description: The API Endpoints for the Licenses at the site level can be used to get license usages for a specific site.
- name: Sites Location
description: The Location Diagnostics allows users to retrieve and analyze coverage and performance data for mist access points (aps) and devices.
- name: Sites Maps
description: >-
A Site Map is a visual representation of the layout and structure of a location, such as a building or campus.
It includes accurate information about the placement, positions, heights, and orientations of Juniper Mist Access Points (APs) and other devices in the deployment.
The floorplan is an essential component of location services as it enables the location engine to generate accurate location estimates for client devices, assets, and users at the site.
- name: Sites Maps - Auto-placement
description: "### AP Auto-Placement\nAP Auto-Placement is a feature in Juniper Mist wireless assurance that automatically determines and sets the positions of Access Points (APs) on a floorplan.\n\nIt saves time and simplifies the deployment process by eliminating the need for manual placement. \n\nThe autoplacement algorithm calculates the most probable location for each AP based on factors such as signal strength and coverage requirements. \n\nThe confidence level of the autoplacement is indicated by colors, with green representing high certainty, orange indicating medium certainty, and red suggesting low certainty. \nIn cases where aps are isolated or cannot communicate with nearby aps, they cannot be placed automatically and must be [manually positioned on the floorplan]($e/Sites%20Devices/updateSiteDevice). \n\nAfter the autoplacement process is complete, the results can be evaluated and accepted of rejected with the API Call [Confirm Site AP Localization Data]($e/Sites%20Maps%20-%20Auto-placement/confirmSiteApLocalizationData)\n\n\n### AP Auto-Orientation\nAp Auto-Orientation is a feature in juniper mist wireless assurance that allows users to check and correct the orientation of Access Points (APs) on a floorplan. \n\nThis feature is supported by specific ap models and requires a firmware dependency of version 0.14.28310 or higher and does not require a maintenance window and can be used after performing autoplacement. \n\nTo use auto-orientation, physically install the APs, claim or adopt them into the Juniper Mist organization, place them on the floorplan, and perform auto-placement, then trigger the [Start Site Ap Auto Orientation API call]($e/Sites%20Maps%20-%20Auto-placement/startSiteApAutoOrientation)\n\nAfter 24 hours, the rotation in degrees of the AP(s) will be updated. users can accept or deny the changes made by the auto-orientation feature with the API Call [Confirm Site AP Localization Data]($e/Sites%20Maps%20-%20Auto-placement/confirmSiteApLocalizationData)."
- name: Sites Maps - Auto-Zone
description: The auto zones service is a map parsing service that uses map image data to suggest spaces to designate as location zones.
- name: Sites Map Stacks
description: Map Stacks are a way to group multiple maps together within a site, typically representing different floors or levels in a building. Map Stacks help organize and manage floorplans for multi-story buildings or complex deployments.
- name: Sites Marvis Configs
description: Marvis Config Actions are config changes injected by Marvis into network devices. These actions can be searched, counted, deleted, and given feedback.
- name: Sites MxEdges
description: >-
MxEdges (Mist Edges) at the site level are deployed to tunnel traffic at each site due to network constraints or security concerns.
They can be assigned to a specific site and configured to provide tunneling and RADIUS proxy services for the access points (APs) in that site.
These Mist Edges allow for the extension of user vlans from the corporate network to the aps, and they support features such as auto preemption for failover, dual tunneling to different mist edge clusters, and anchor tunnels for traffic routing to dmz areas.
- name: Sites Network Templates
description: The API Endpoints for the Network Templates at the site level can be used to get the site derived networks, meaning the org level configuration with the site variables resolved.
- name: Sites Networks
description: The API Endpoints for the Networks at the site level can be used to get the site derived networks, meaning the org level configuration with the site variables resolved.
- name: Sites Psks
description: >-
A multi PSK (Pre-Shared Key) is a feature that allows the use of multiple PSKs for securing network connections.
It provides a simple and comprehensive way to onboard client devices without relying on client MAC addresses.
Each psk has its own key name, which can be used for user-level accountability, key rotation, and visibility in the management platform. It supports the creation, rotation, and auto-expiration of psks, and allows vlan assignment and role assignment for dynamic per-user policies.
Multi PSKs create virtual broadcast domains and can be used for end-user onboarding via authenticated sso login.
Mist supports two methods of Site PSKs lookup: * local * radius
- name: Sites RF Templates
description: The API Endpoints for the RF Templates at the site level can be used to get the site derived configuration, meaning the org level configuration with the site variables resolved..
- name: Sites Rfdiags
description: >-
Rf Diags is a feature in Juniper Mist location services that allows users to replay recorded sessions of the RF (radio frequency) environment.
It enables users to gain an understanding of current issues, troubleshoot problems, and review recordings for further analysis or to share with customer support.
- name: Sites Rogues
description: >-
Rogues are unauthorized wireless access points that are installed on a network without authorization.
They can be connected to the LAN via an ethernet cable, similar to a pc, and are typically set up by individuals with malicious intent or by employees trying to cover a dead spot with their own wi-fi hotspot.
- name: Sites RRM
description: >-
RRM, or Radio Resource Management, is a tool used by large multi-site organizations to efficiently manage their RF spectrum.
It involves making decisions on channel and power settings for access points (APs) based on factors such as user experience, client count, client usage, and interference.
Mist RRM uses a reinforcement learning-based feedback model to monitor the impact of changes in channel and power settings on the capacity and performance of the wireless network. It adapts dynamically to changing conditions throughout the day and aims to optimize wireless coverage and capacity across a site.
- name: Sites RSSI Zones
description: RSSI Zones are zones based on the RSSI (Received Signal Strength Indicator, i.e. the power of the signal received by the Access Points from the Wireless Clients).
- name: Sites Services
description: >-
A Service represents an a traffic destination or an application that network users connect to. They are associated with users and networks and are used in application policies to permit or deny access.
Services are defined at the [Org level]($e/Orgs%20Services/createOrgService).
The Site level endpoints can be used to get the site services statistics or the derived services, meaning the merge between the site level configuration and the org level configuration.
- name: Sites Service Policies
description: The API Endpoints for the Service Policies at the site level can be used to get the site derived configuration, meaning the merge between the site level configuration and the org level configuration.
- name: Sites Setting
description: >-
Site settings refer to the configuration and management of of site within a Mist Organization.
These settings include access point settings, firmware upgrade schedules, and various features such as location services, occupancy analytics, and engagement analytics.
- name: Sites Site Templates
description: The API Endpoints for the Site Templates at the site level can be used to get the site derived configuration, meaning the org level configuration with the site variables resolved..
- name: Sites Skyatp
description: >-
SkyATP is a cloud-based solution that provides advanced threat protection for network security.
It allows security analysts to update their defense against new attack techniques in real-time and distribute threat intelligence quickly.
SkyATP inspects network traffic and blocks devices that have downloaded malware or accessed command and control servers. It also offers configuration and troubleshooting capabilities for administrators.
- name: Sites SLEs
description: >-
Site SLEs, or Service-Level Expectations, are metrics used to monitor and report on the user experience of a Wireless, Wired or Wan network.
They are generated through data science and machine learning algorithms and provide insights into various aspects of the network, such as coverage, capacity, connectivity, and performance.
Mist SLEs help identify when users do not have sufficient network quality, when they face issues with connecting or roaming between access points, and when there are problems on the wired network.
- name: Sites Synthetic Tests
description: >-
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.
- name: Sites UI Settings
description: The Site UI Settings are used to configure the site Network and Analytics reports
- name: Orgs UI Settings
description: The Org UI Settings are used to configure the MArvis dashboards
- name: Sites vBeacons
description: >-
A vBeacon is a virtual beacon that is created and configured on a floorplan and are configured with a name and message
It is a Mist patented technology that provides proximity-related notifications to users on a mobile app using the Mist SDK.
vBeacons allow users to receive notifications when their device is within the proximity of the beacon, based on the power transmitted. When a user goes near the location of a vbeacon, a notification is sent to the application with the configured message.
- name: Sites VPNs
description: API Calls to retrieve the list of Org VPNs configuration available for the Site
- name: Sites WAN Usages
description: API Calls to retrieve WAN Assurance statistics about the WAN Usage
- name: Sites Webhooks
description: >-
A Site Webhook is a configuration that allows real-time events and data from a specific site to be pushed to a provided url.
It enables the collection of information about various topics such as device events, alarms, audits, client sessions and location updates at the site level.
The Webhook can be set up and customized using the Mist API, allowing users to receive and analyze specific data from a particular site.
- name: Sites Wlans
description: >-
A Site Wlan is a wireless local area network that is configured and applied to a specific site within an organization.
It allows for the creation and management of wireless network settings, such as SSIDs (service set identifiers), authentication settings, VLAN configurations, etc... for a particular site.
Site Wlans are created and managed at the site level and can only be referenced and used within that particular site.
- name: Sites WxRules
description: >-
Site WxRules are a set of rules, restrictions, and settings that can be applied to WLANs within a specific site.
These policies determine how the devices and traffic are treated by the network and can be used to control access, define VLANs, and apply labels to users and resources.
Site WxRules are created and managed at the site level and are applied after the site-level WxRules.
- name: Sites WxTags
description: >-
Wxtags are tags or groups that can be created and used within a specific site.
They are used to classify users and resources and can be applied to Access Points, WLAN configurations or WxRules within that site.
Site WxTags are created and managed at the site level and can only be referenced and used within that particular site.
- name: Sites WxTunnels
description: >-
A WxLan Tunnel (WxTunnel) are used to create a secure connection between Juniper Mist Access Points and third-party VPN concentrators using protocols such as L2TPv3 or dmvpn.
These tunnels allow for the aggregation of ethernet interfaces on access points, support dynamic or static tunnels, and provide options for IPSec encryption.
- name: Sites Zones
description: >-
A Zone is a custom area defined by a user on a floor plan.
Zones can be used for capturing entry and exit events of clients, assets, and sdk clients, providing insights such as wait time and the number of devices in a particular zone.
Zone notifications can be accessed using sdk notification callbacks.
Zones are useful for data collection specific to areas on the floor plan.
- name: Sites Stats
description: The stats are providing access to raw data about a specific type of entities.
- name: Sites Stats - Apps
description: API Calls to retrieve the stats of the Applications used on side
- name: Sites Stats - Assets
- name: Sites Stats - Beacons
- name: Sites Stats - BGP Peers
description: API Calls to retrieve BGP Peers statistics of the Site Wen Edge Gateways at the Site level
- name: Sites Stats - Calls
description: API Calls to retrieve the stats of the calls (Zoom/Teams) detected by Mist
- name: Sites Stats - Clients Wireless
description: API Calls to retrieve the stats of the wireless clients detected (connected or not connected) on this site.
- name: Sites Stats - Clients SDK
description: >-
SDK Clients are devices that have installed an application using the Mist Software Development Kit (SDK).
These clients can provide specific data and information that is not available without the installation of the SDK application.
- name: Sites Stats - Devices
description: API Calls to retrieve statistics about the Mist Managed and Monitored Devices at the Site level
- name: Sites Stats - MxEdges
description: API Calls to retrieve statistics about the Mist Edges at the Site level
- name: Sites Stats - Ospf
description: API Calls to retrieve statistics about OSPF peers at the Site level
- name: Sites Stats - Ports
description: API Calls to retrieve statistics about the Wired Ports at the Site level
- name: Sites Stats - WxRules
description: API Calls to retrieve WxRules statistics for the current Site
- name: Sites Stats - Zones
description: API Calls to retrieve Zones statistics for the current Site
- name: Sites Stats - Discovered Switches
description: API Calls to retrieve statistics about the Discovered Switches at the Site level
- name: Sites Stats - IoT Endpoints
description: API Calls to retrieve IoT Endpoint statistics for the current Site
- name: Constants Definitions
description: API Calls to retrieve constant values that can be used in different parts of the configuration
- name: Constants Events
description: API Calls to retrieve the definitions of the Mist events. These definitions are providing example of the Webhook payloads
- name: Constants Models
description: API Calls to retrieve the list of Hardware Models and their features
- name: Self Account
description: API calls related to the currently connected user account.
- name: Self API Token
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.
**Notes:**
* an API token generated for a specific admin has the same privilege as the user
* an API token will be automatically removed if not used for > 90 days
* SSO admins cannot generate these API tokens. Refer [Org level API tokens]($e/Orgs%20API%20Tokens/createOrgApiToken) which can have privileges of a specific Org/Site for more information.
- name: Self OAuth2
description: >-
A Mist account can be linked to OAuth2 providers:
1. First, login with your Mist account
2. Obtain the Authorization URL for Linking
3. Obtain the authorization code by clicking / going through Authorization URL
4. Link Mist Account against OAuth2 Provider by using the authorization code
- name: Self MFA
description: API calls related to Two Factor Authentication for the currently connected user account.
- name: Self Alarms
description: API calls related to the alarm subscriptions for the currently connected user account.
- name: Self Audit Logs
description: API calls related to the audit logs subscriptions for the currently connected user account.
- name: Utilities Common
description: >-
API Calls to use Devices Troubleshooting tools.
Some API Calls can be used with any type of devices (Access Points, Switches and Gateways), and some others may be limited to some types of devices (e.g. "Junos Only")
- name: Utilities WAN
description: API Calls to use Devices Troubleshooting tools specific to WAN Assurance
- name: Utilities LAN
description: API Calls to use Devices Troubleshooting tools specific to Wired Assurance
- name: Utilities Wi-Fi
description: API Calls to use Devices Troubleshooting tools specific to Wireless Assurance
- name: Utilities PCAPs
description: API Calls to start, stop or managed Packet Captures at the device level
- name: Utilities Location
description: API Calls to use Devices Troubleshooting tools specific to Asset Tracking and User Management
- name: Utilities MxEdge
description: API Calls to use Devices Troubleshooting tools specific to Mx Edges
- name: Utilities Upgrade
description: API Calls used to manage device upgrades for a single device, at the site level or at the organization level.